INSERT= System Option: z/OS

Inserts the specified value at the beginning of the specified system option.
Valid in: Configuration file, SAS invocation, OPTIONS statement, Options window
Category: Environment Control: ENVFILES
PROC OPTIONS GROUP= ENVFILES
Default: None
z/OS specifics: SAS invocation syntax

Syntax

INSERT=(system-option=inserted-value)

Required Arguments

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

Details

If you specify a SAS system option more than once, then the last specification of the option is the one that SAS uses. You must use the INSERT system option to add additional values to the beginning of the value that is already specified for the following system options:
AUTOEXEC HELPLOC SASAUTOS
CMPLIB MAPS SASHELP
FMTSEARCH MSG SASSCRIPT
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 looks for autocall macros is 'prefix.test.sasautos'. The output of PROC OPTIONS shows '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 inserted-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)