INSERT System Option: Windows

Used when SAS starts, inserts the specified value at the beginning of the specified system option.
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
PROC OPTIONS GROUP= ENVFILES
Default: none
Windows specifics: SAS invocation syntax

Syntax

-INSERT system-option argument

Required Arguments

system-option
can be AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASSCRIPT, SASAUTOS, SASHELP or SET.
argument
specifies a new pathname or an environment setting that you want to insert at the front of the current value of system-option. The following example shows that a library is being inserted before the FMTSEARCH option:
-set APFMTLIB “SASEnvironment/SASFormats”
-insert fmtsearch APFMTLIB

Details

By default, if you specify the AUTOEXEC, CMPLIB, FMTSEARCH, HELPLOC, MAPS, MSG, SASSCRIPT, SASAUTOS, SASHELP, or SET system option more than one time, the last specification is the one that SAS uses. If you want to insert additional pathnames in front of the search paths that have already been specified by one of these options, you must use the INSERT or APPEND system options to append the new pathname. For example, if you entered the following SAS command, the only location that SAS will look for help files is c:\app2\help, and the output of PROC OPTIONS will only show c:\app2\help:
sas -helploc “c:\app2\help”
If you want SAS to look in both the current path for help files and in c:\app2\help and if you want SAS to search c:\app2\help first, then you can append the new location to the value of the HELPLOC option using the INSERT option:
sas -insert helploc “c:\app2\help”
If your current path for help files is !sasroot\nls\en\help, then for the value of the HELPLOC option, PROC OPTIONS will now show
(“c:\app2\help” “!sasroot\nls\en\help”)

See Also

APPEND= System Option in SAS System Options: Reference
INSERT= System Option in SAS System Options: Reference