APPEND= System Option

Appends a value to the existing value of the specified system option.
Valid in: Configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Note: This option cannot be restricted by a site administrator. For more information, see Restricted Options.
See: For the syntax to use in your operating environment when you start SAS, see the documentation for your operating environment:

APPEND System Option: UNIX in SAS Companion for UNIX Environments

APPEND System Option: Windows in SAS Companion for Windows

APPEND= System Option: z/OS in SAS Companion for z/OS
Syntax
Details
Comparisons
Example
See Also

Syntax

APPEND=(system-option-1 =argument-1 <system-option-n =argument-n>)

Syntax Description

system-option
can be AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, SASSCRIPT, or SET.
Note:Some of these options are available only when SAS starts. These options can be specified in the APPEND= option only when the APPEND= option is specified in a configuration file or a SAS command.
argument
specifies a new value that you want to append to the current value of system-option.
argument can be any value that could be specified for system-option if system-option is set using the OPTIONS statement.

Details

If you specify a new value for the AUTOEXEC, CMPLIB, FMTSEARCH, SASHELP, MAPS, MSG, SASAUTOS, SASSCRIPT, or SET system options, the new value replaces the value of the option. Instead of replacing the value, you can use the APPEND= system option to append a new value to the current value of the option.
For a list of system options that the APPEND= system option and the INSERT= system option support, including the system options that can be used when SAS starts, submit the following OPTIONS procedure:
proc options listinsertappend;
run;

Comparisons

The APPEND= system option adds a new value to the end of the current value of the AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASSCRIPT, or SET system options. The INSERT= system option adds a new value as the first value of one of these system options.

Example

The following table shows the results of adding a value to the end of the FMTSEARCH= option value:
Current FMTSEARCH= Value
Value of APPEND= System Option
New FMTSEARCH= Value
(WORK LIBRARY)
(fmtsearch=(abc def))
(WORK LIBRARY ABC DEF)

See Also

Changing an Option Value by Using the INSERT and APPEND System Options
System Options:
INSERT= System Option
INSERT System Option: UNIX in SAS Companion for UNIX Environments
INSERT System Option: Windows in SAS Companion for Windows
INSERT= System Option: z/OS in SAS Companion for z/OS
Copyright © SAS Institute Inc. All rights reserved.