INSERT= System Option

Inserts the specified value as the first value of the specified system option.
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Option 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 when you start SAS, see the documentation for your operating environment:

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
Syntax
Details
Comparisons
Example
See Also

Syntax

INSERT=(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 INSERT= option only when the INSERT= option is specified in a configuration file or a SAS command.
argument
specifies a new value that you want as the first 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, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, SASSCRIPT, or SET system options, the new value replaces the value of the option. Instead of replacing the value, you can use the INSERT= system option to add an additional value to the option as the first value of the option.
For a list of system options that the INSERT= system option and the APPEND= 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 INSERT= system option adds a new value to the beginning of the current value of the AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASAUTOS, SASHELP, SASSCRIPT, or SET system options. The APPEND= system option adds a new value to the end of one of these system options.

Example

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

See Also

Changing an Option Value by Using the INSERT and APPEND System Options
System Options:
APPEND= System Option
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
Copyright © SAS Institute Inc. All rights reserved.