APPEND= System Option: z/OS

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

Syntax

APPEND=(system-option=appended-value)

Required Arguments

system-option
can be AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, or SASSCRIPT.
Note: You can submit proc options listinsertappend; to produce a complete list of options that can be appended.
appended-value
is the new value that you want to append to 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 APPEND system option if you want to add additional values to the end of the value that is already specified for the following 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.more.sasautos'
then the only location where SAS looks for autocall macros is 'prefix.more.sasautos'. The output of PROC OPTIONS shows 'prefix.more.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 APPEND option:
sasrx -append=(sasautos='prefix.more.sasautos')
PROC OPTIONS then shows the following value for the SASAUTOS option:
('prefix.prod.sasautos' 'prefix.more.sasautos')
If the original value of system-option or appended-value is enclosed in parentheses, then the resulting option value is merged into one pair of parentheses. For example,
SASAUTOS=(.a.sasautos .b.sasautos)
APPEND=(sasautos=(.c.sasautos .d.sasautos))
sets the value of the SASAUTOS option to
(.a.sasautos .b.sasautos .c.sasautos .d.sasautos)