System Options under z/OS

INSERT= System Option: z/OS

Used when SAS starts, inserts the specified value at the beginning of the specified system option.

Default:	none
Valid in:	configuration file, SAS invocation
Category:	Environment Control: ENVFILES
PROC OPTIONS GROUP=	ENVFILES
z/OS specifics:	all

Syntax
Details
See Also

Syntax

INSERT=(system-option=new-option-value)

system-option: can be CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, or SASSCRIPT
new-option-value: is the new value that you want to insert at the beginning of the current value of system-option.

Details

If you specify the CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, or SASSCRIPT system option more than once, then the last specification is the one that SAS uses. If you want to add additional values to the beginning of the value that is already specified by one of these options, then you must use the INSERT system option to add the new value. For example, if your config file contains the following option specification:

sasautos='prefix.prod.sasautos'

and you enter the following SASRX command,

sasrx -sasautos 'prefix.test.sasautos'

then the only location where SAS will look for autocall macros is 'prefix.test.sasautos'. The output of PROC OPTIONS will show 'prefix.test.sasautos' as the value of the SASAUTOS option.

If you want SAS to look in both locations for autocall macros, then you must use the following INSERT option:

sasrx -insert=(sasautos='prefix.test.sasautos')

PROC OPTIONS then shows the following value for the SASAUTOS option:

('prefix.test.sasautos' 'prefix.prod.sasautos')

If the original value of system-option or new-option-value is enclosed in parentheses, then the resulting option value is merged into one pair of parentheses. For example,

SASAUTOS=(.a.sasautos .b.sasautos) 
INSERT=(sasautos=(.c.sasautos .d.sasautos))

sets the value of the SASAUTOS option to

(.c.sasautos .d.sasautos .a.sasautos .b.sasautos)