Table 22.1 on page 471 lists all the system options available to SAS users under the Windows operating environment. Many of these options have no system-dependent behavior and are described completely in SAS Language Reference: Dictionary . Others are available only under Windows and are completely described here. Some system options are described here and in SAS Language Reference: Dictionary .
Note: Some system options in SAS Language Reference: Dictionary indicate that the system option may have additional operating environment information and to refer to the SAS documentation for your operating environment. If such a system option is not described in SAS Companion for Windows , the system option is to be used as described in SAS Language Reference: Dictionary .
Use the following legend to determine where to find more information on a system option:
ACC | indicates that the option is described in SAS/ACCESS for Relational Databases: Reference |
COMP | indicates that the option is completely described in this section. Some options are not applicable to the Windows operating environment; these options are listed in Options Not Applicable to the Windows Environment on page 482. |
CONN | indicates that the option is described in SAS/CONNECT User s Guide |
DQ | indicates that the option is described in SAS Data Quality Server: Reference |
IT | indicates that the option is described in the documentation for Integration Technologies, either with the Integration Technologies software or on the SAS web site. |
LR | indicates that the option is not described here but is described in the system options portion of SAS Language Reference: Dictionary . |
MACRO | indicates that the option is described in SAS Macro Language: Reference |
METH | indicates that the option is described in Communications Access Methods for SAS/CONNECT and SAS/SHARE |
NLS | indicates that the option is described in SAS National Language Support (NLS): User s Guide |
SHR | indicates that the option is described in SAS/SHARE User s Guide |
SPDE | indicates that the option is described in SAS Scalable Performance Data Engine: Reference |
The following SAS system options, which may described in the system options portion of SAS Language Reference: Dictionary , are not applicable to the Windows operating environment:
DMS
DMSEXP
DOCLOC
FSDEVICE
OPLIST
SORTNAME
TAPECLOSE.
Enables the accessibility features on the Customize Tools dialog box
Default: STANDARD
Valid in: configuration file, SAS invocation
Category: Input control: Data processing
PROC OPTIONS GROUP = INPUTCONTROL
Windows specifics: all
-ACCESSIBILITY STANDARD EXTENDED
STANDARD
specifies that the standard Customize Tools dialog box and Properties dialog boxes are enabled.
EXTENDED
specifies that the accessibility features are enabled in the Customize Tools dialog box and for some Properties dialog boxes.
When the ACCESSIBILITY option is set to EXTENDED, the Customize Tools Custom tabbed page and some SAS Properties dialog boxes are modified for accessibility.
The Customize tab contains two additional buttons , File Menu and Edit Menu . These menu buttons enable accessibility to the commands that are available using the toolbar buttons.
The tabs in these dialog boxes are buttons in order to enable some of the SAS Properties dialog boxes for accessibility. Using the Ctrl + Page Up and Ctrl + Page Down keys, you can access all parts of these Properties dialog boxes.
When this system option is set to EXTENDED, you can toggle between the overstrike cursor and the insert cursor. The insert cursor is the default since some accessibility utilities expect the insert cursor.
Accessibility Features in SAS under Windows on page 74
Specifies an alternate SAS log
Default: NOALTLOG
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: destination must resolve to a valid Windows path or filename
-ALTLOG destination
-NOALTLOG
ALTLOG destination
specifies the destination for a copy of the SAS log. The destination argument can be a valid Windows pathname or filename (including device names ) or an environment variable associated with a pathname. If you specify only a pathname, the copy is placed in a file in the specified directory, with a name of filename .LOG, where filename is the name of your SAS job. If you are running SAS interactively and specify only a pathname, the log is written to a file named SAS.LOG within that path.
NOALTLOG
suppresses the creation of a copy of the SAS log.
The ALTLOG system option specifies a destination to which a copy of the SAS log is written. Use the ALTLOG system option to capture log output for printing.
To send the SAS log to a printer other than the default printer, use a valid Windows printer name for the destination value.
Note: ALTLOG replaces the following system options from earlier versions of SAS: LDISK, LPRINT, and LTYPE.
Routing Procedure Output and the SAS Log to a File on page 182
Specifies an alternate SAS procedure output file
Default: NOALTPRINT
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: destination must resolve to a valid Windows pathname or filename
-ALTPRINT destination
-NOALTPRINT
ALTPRINT destination
specifies the destination for a copy of the SAS procedure output file. The destination argument can be a valid Windows pathname or filename (including device names) or an environment variable associated with a pathname. If you specify only a pathname, the copy is placed in a file in the specified directory, with a name of filename .LST, where filename is the name of your SAS job. If you are running SAS interactively and specify only a pathname, the filename is SAS.
NOALTPRINT
does not create a copy of the SAS procedure output file.
The ALTPRINT system option specifies a destination to which a copy of the SAS procedure output file is written. Use the ALTPRINT system option to capture procedure output for printing.
To send the procedure output to a printer other than the default printer, use a valid Windows printer name for the destination value.
Note: ALTPRINT replaces the following system options form earlier versions of SAS: PDISK, PPRINT, and PTYPE.
Routing Procedure Output and the SAS Log to a File on page 182
Printing on page 166
Specifies the authentication domain server to search for secure server logins
Default: local and trusted servers
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Initialization and operation
PROC OPTIONS GROUP= EXECMODES
Windows specifics: all
-AUTHSERVER <" " domain-name . >
AUTHSERVER <" " domain-name . >
""
specifies to search the local server first, and then search trusted servers for a valid user login.
domain-name
specifies a specific domain-name to search for a valid user login. Single quotation-marks are required.
.
specifies to search only the local server for a valid user login. Single quotation-marks are required.
The AUTHSERVER system option specifies which servers to search to validate user logins.
You use the AUTHSERVER system option to specify a single authentication domain. You use the AUTHPROVIDERDOMAIN system option to specify multiple authentication providers and the associated domains.
AUTHPROVIDERDOMAIN System Option in SAS Language Reference: Dictionary
Specifies an alternate SAS autoexec file
Default: AUTOEXEC.SAS, if the file is available; otherwise , none
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: file-specification must be a valid Windows filename
-AUTOEXEC file-specification
-NOAUTOEXEC
AUTOEXEC file-specification
specifies the SAS autoexec file to be used instead of the default AUTOEXEC.SAS file. The file-specification argument can be a valid Windows filename or an environment variable associated with a pathname. For more information on the SAS autoexec file, see SAS Autoexec File on page 18.
NOAUTOEXEC
indicates that no SAS autoexec file is processed , even if one exists.
The AUTOEXEC system option specifies the autoexec file. The autoexec file contains SAS statements that are executed automatically when you invoke SAS or when you start another SAS process. The autoexec file can contain any valid SAS statements. For example, you can include LIBNAME statements for SAS data libraries you access routinely in SAS sessions.
If no AUTOEXEC.SAS file is found, the default value for this option is NOAUTOEXEC.
SAS Autoexec File on page 18
Specifies whether the main SAS window includes a title bar, a system/control menu, and minimize/maximize buttons
Default: TITLE SYSTEMMENU MINMAX
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-AWSCONTROL <TITLE NOTITLE><SYSTEMMENU NOSYSTEMMENU><MINMAX NOMINMAX>
AWSCONTROL= <TITLE NOTITLE><SYSTEMMENU NOSYSTEMMENU><MINMAX NOMINMAX>
AWSCONTROL
specifies to display the title bar, the system menu, and the minimize and maximize buttons on the main SAS window.
TITLE NOTITLE
specifies whether or not to display the title bar on the main SAS window. If NOTITLE is specified, the system menu and the minimize and maximize buttons are automatically omitted as well.
SYSTEMMENU NOSYSTEMMENU
specifies whether or not to display the system menu on the title bar of the main SAS window. If NOSYSTEMMENU is specified, the minimize and maximize buttons are also omitted.
MINMAX NOMINMAX
specifies whether or not to display the minimize and maximize buttons on the title bar of the main SAS window.
The AWSCONTROL system option controls only the main SAS window, not the windows that are contained inside the main SAS window. The SASCONTROL system option controls those SAS process windows.
This system option is intended for use by SAS/AF programmers to customize the interface of their applications.
SASCONTROL System Option on page 545
Specifies the location and dimensions of the main SAS window when SAS initializes
Default: 80% of the display height and width
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-AWSDEF row-percent-position column-percent-position height-percent width-percent
AWSDEF= row-percent-position column-percent-position height-percent width-percent
row-percent-position and column-percent-position
specify screen percentages that control the position of the upper-left corner of the main SAS window. For example, if you specify 50 for each of these, the upper-left corner of the SAS window is positioned in the center of your display.
The valid range of values for these parameters is 0 through 95.
height-percent and width-percent
specify screen percentages that control the size of the main SAS window. For example, if you specify 100 for each of these, the SAS window occupies your entire display. If you specify 50 for each of these, the SAS window occupies half of your display.
The valid range of values for these parameters is 40 through 100.
The AWSDEF system option specifies the location and dimensions of the main SAS window when SAS initializes. For an example of how to use the AWSDEF system option, see Changing the Size and Placement of the Main SAS Window on page 64.
Specifies whether to display the menu bar in the main SAS window
Default: AWSMENU
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-AWSMENU -NOAWSMENU
AWSMENU NOAWSMENU
AWSMENU
specifies to display the menu bar in the main SAS window.
NOAWSMENU
specifies to omit the menu bar in the main SAS window.
The AWSMENU system option is intended for use by SAS/AF programmers to customize the interface of their applications.
Specifies whether to embed menu items that are specific to Windows in the main menus
Default: AWSMENUMERGE
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-AWSMENUMERGE -NOAWSMENUMERGE
AWSMENUMERGE NOAWSMENUMERGE
AWSMENUMERGE
specifies to embed the menu items that are specific to Windows.
NOAWSMENUMERGE
specifies to not embed the menu items that are specific to Windows.
The AWSMENUMERGE system option determines whether the menu items that are specific to the Windows operating environment are included in the main SAS window menus.
This system option is used by SAS/AF programmers to customize the interface of their applications. If SAS is started in batch mode, SAS sets this system option to NOAWSMENUMERGE.
WINDOWSMENU System Option on page 573
Replaces the default text in the main SAS title bar
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-AWSTITLE title-text
title-text
specifies the text that appears in the title bar of the main SAS window. The text must be enclosed in either single or double quotation marks.
The AWSTITLE system option allows you to replace the default text in the title bar of the main SAS window with the title that you specify.
This system option is intended for use by SAS/AF programmers to customize the interface of their applications.
Specifies the number of buffers to be allocated for processing SAS data sets
Default: 1
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES, PERFORMANCE
Windows specifics: Default value
See: BUFNO System Option in SAS Language Reference: Dictionary
-BUFNO n n K n M n G hex X MIN MAX
BUFNO= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the number of buffers in multiples of 1 (bytes); 1,024 (kilobytes); 1,048,576 (megabytes); or 1,073,741,824 (gigabytes). You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 buffers, a value of .782k specifies 801 buffers, and a value of 3m specifies 3,145,728 buffers.
For values greater than 1G, use the n M option or specify MAX.
hex X
specifies the number of buffers as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx specifies 45 buffers.
MIN
sets the number of buffers to 0, and requires SAS to use the default value of 1.
MAX
sets the number of buffers to 2,147,483,647.
The number of buffers is not a permanent attribute of the data set; it is valid only for the current SAS session or job.
BUFNO= applies to SAS data sets that are opened for input, output, or update.
Using BUFNO= can improve execution time by limiting the number of input/output operations that are required for a particular SAS data set. The improvement in execution time, however, comes at the expense of increased memory consumption.
Under Windows, the maximum number of buffers that you can allocate is determined by the amount of memory available. To request that SAS allocate the number of buffers based on the number of pages for the data set, use the SASFILE statement.
BUFSIZE System Option on page 491
SASFILE Statement in SAS Language Reference: Dictionary .
The chapter on optimizing system performance in SAS Language Reference: Concepts .
Specifies the permanent buffer page size for output SAS data sets
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES, PERFORMANCE
Windows specifics: Valid values for n
See: BUFSIZE System Option in SAS Language Reference: Dictionary
-BUFSIZE n n K n M n G hex X MIN MAX
BUFSIZE= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the buffer page size in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes), and 1,073,741,824 (gigabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the buffer page size as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the buffer page size to 45 bytes.
MIN
sets the buffer page size to -2,147,483,648 and requires SAS to use a default value. Under Windows, the default value is 0. The minimum number is -2,147,483,648.
MAX
sets the buffer page size to 2,147,483,647 bytes.
The BUFSIZE system option enables you to specify the permanent buffer page size for output SAS data sets. Under Windows, the value can range from 512 bytes to 2,147,483,647 bytes. Using the default value of 0 optimizes the buffer page size by enabling the engine to pick a value depending on the size of the observation.
Experienced users may want to vary the value of the BUFSIZE system option if you are trying to maximize memory usage or the number of observations per page.
BUFNO System Option on page 490
The chapter about optimizing system performance in SAS Language Reference: Concepts .
Specifies the number of SAS catalogs to keep open
Default:
Valid in: configuration file, SAS invocation
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Windows specifics: Valid values for n
See: CATCACHE System Option in SAS Language Reference: Dictionary
-CATCACHE n n K MIN MAX
n n K
specifies the number of open-file descriptors to keep in cache memory in multiples of 1( n ) or 1,024 ( n K). You can specify decimal values for the number of kilobytes. For example, a value of 8 specifies 8 open-file descriptors, a value of .782k specifies 801 open-file descriptors, and a value of 3k specifies 3,072 open-file descriptors.
If n > 0, SAS places up to that number of open-file descriptors in cache memory instead of closing the catalogs.
MIN
sets the number of open-file descriptors that are kept in cache memory to 0.
MAX
sets the number of open-file descriptors that are kept in cache memory to 32,767.
By using the CATCACHE system option to specify the number of SAS catalogs to keep open, you can avoid the repeated opening and closing of the same catalogs.
If SAS is running on a z/OS server and the MINSTG system option is in effect, SAS sets the value of CATCACHE to 0.
The chapter about optimizing system performance in SAS Language Reference: Concepts .
Specifies how to handle an out-of-resource condition
Default: CLEANUP
Valid in: configuration fie, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Error handling
PROC OPTIONS GROUP= ERRORHANDLING
Windows specifics: behavior when running in batch mode
See: CLEANUP System Option in SAS Language Reference: Dictionary
-CLEANUP -NOCLEANUP
CLEANUP NOCLEANUP
CLEANUP
specifies that during the entire session, SAS attempts to perform automatic, continuous clean-up of resources that are not essential for execution. Nonessential resources include those that are not visible to the user (for example, cache memory) and those that are visible to the user (for example, the KEYS windows).
CLEANUP does not prompt you for any out-of-resource condition except for out-of-disk-space conditions. If you do not want to be prompted for out-of-disk-space conditions, use the CLEANUP option in conjunction with the NOTERMINAL option.
NOCLEANUP
specifies that SAS allow the user to choose how to handle an out-of-resource condition. When NOCLEANUP is in effect and SAS cannot execute because of a lack of resources, SAS automatically attempts to clean up resources that are not visible to the user (for example, cache memory). However, resources that are visible to the user (for example, the KEYS windows) are not automatically cleaned up. Instead, SAS prompts you before attempting to regain resources.
The CLEANUP system option indicates whether you are prompted with a menu of items to clean up when SAS encounters an out-of-resource condition.
If you specify NOCLEANUP and are prompted for input, you can select Continuous on every menu except the out-of-disk-space menu. If you choose Continuous , the CLEANUP option is turned on and you are not prompted again in out-of-resource conditions, unless SAS runs out of disk space.
Specifies the location where the SAS Command window is displayed
Default: BOTTOM CENTER
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-COMDEF TOP CENTER BOTTOM
<LEFT CENTER RIGHT>
TOP CENTER BOTTOM
specifies the vertical position of the SAS Command window. The default value is BOTTOM.
LEFT CENTER RIGHT
specifies the horizontal position of the SAS Command window. The default value is CENTER.
You must specify a vertical position first. You do not have to specify a horizontal position, but if you omit it, CENTER is used.
Note: The SAS Command window is positioned with respect to your entire display, not to the main SAS window. Also, the COMDEF system option applies only when the command bar is not docked to the main SAS window.
Setting Session Preferences on page 57
Using the Command Bar to Issue Commands on page 39
Specifies an alternative SAS configuration file
Default: ! sasroot \SASV9.CFG
Valid in: configuration file, SAS invocation
Category: System administration: Installation
PROC OPTIONS GROUP= INSTALL
Windows specifics: all
-CONFIG file-specification
file-specification
specifies the filename of the SAS configuration file that you want to use, or a Windows environment variable that resolves to a valid filename. The file-specification must be a valid Windows filename. If file-specification contains spaces, it must be enclosed in quotation marks.
The CONFIG system option specifies the complete filename of your configuration file. This file contains SAS options that are executed automatically whenever SAS is invoked. SAS supplies a default configuration file, but you can create your own configuration file and store it in a location you choose.
SAS Configuration Files on page 13
Determines whether to process text as encoded in a double-byte character set or as a single-byte character set encoding method
Default: NODBCS
Valid in: configuration file, SAS invocation
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: all
See: DBCS System Option in SAS National Language Support (NLS): User s Guide
Specifies a double-byte character set ( DBCS ) language
Default: NONE
Valid in: configuration file, SAS invocation
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: valid values
See: DBCSLANG System Option in SAS National Language Support (NLS): User s Guide
Specifies a double-byte character set ( DBCS ) encoding method
Default PCIBM
Valid in: configuration file, SAS invocation
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: Valid values
See: DBCSTYPE System Option in SAS National Language Support (NLS): User s Guide
Specifies a device driver for graphics output for SAS/GRAPH software
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Alias: -DEV
Category: Graphics: Driver settings
PROC OPTIONS GROUP= GRAPHICS
Windows specifics: Valid values for device-driver-name ; default value
See: DEVICE System Option in SAS Language Reference: Dictionary
-DEVICE device-driver-name
DEVICE= device-driver-name
device-driver-name
specifies the name of a device driver for graphics output.
To see the list of device drivers that are available under Windows, you can use the GDEVICE procedure. If you are using the SAS windowing environment, submit the following statements:
proc gdevice catalog=sashelp.devices; run; quit;
If you want to write the device list to the SAS log, submit the following statements:
proc gdevice catalog=sashelp.devices nofs; list _all_; run; quit;
Your site might have defined additional device catalogs referenced by the GDEVICE0 libref. See your SAS Support Consultant for more information.
GDEVICE Procedure in SAS/GRAPH Reference, Volumes 1 and 2
Specifies a message to be echoed to the SAS log while initializing SAS
Default: NOECHO
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: all
-ECHO message -NOECHO
ECHO message
specifies the text of the message to be echoed to the SAS log. The text must be enclosed in single or double quotation marks if the message is more than one word. Otherwise, quotation marks are not needed.
NOECHO
specifies that no messages are to be echoed to the SAS log.
Messages that result from errors in the autoexec file are printed in the SAS log regardless of how the ECHO system option is set.
For example, you can specify the following:
-echo "SAS System under Windows is initializing."
The message appears in the LOG window as SAS initializes.
ECHOAUTO System Option in SAS Language Reference: Dictionary
Specifies whether to use the native e-mail dialog provided by your e-mail application or the e-mail dialog provided by SAS
Default: NATIVE
Valid in: configuration file, SAS invocation
Category: Environment control: Email
PROC OPTIONS GROUP= EMAIL
Windows specifics: all
-EMAILDLG NATIVE SAS
NATIVE
specifies to use the e-mail dialog box provided by your e-mail system vendor. You can use the native dialog box with SAS only if the e-mail system supports the MAPI interface.
SAS
specifies to use the e-mail dialog box provided by SAS.
The EMAILDLG system option specifies whether to use the native e-mail interactive dialog box provided by your e-mail application or the e-mail interface provided by SAS. SAS uses the native dialog box by default.
Sending E-Mail Using SAS on page 40
Specifies which e-mail interface to use
Default: MAPI
Valid in: configuration file, SAS invocation
Category: Environment control: Email
PROC OPTIONS GROUP= EMAIL
Windows specifics: all
-EMAILSYS MAPI VIM SMTP
MAPI
specifies to use the Messaging Application Program Interface (MAPI) electronic mail interface. This is the default value.
VIM
specifies to use the Vendor Independent Mail (VIM) electronic mail interface.
SMTP
specifies to use the Simple Mail Transfer Protocol email interface.
SAS supports three types of electronic mail interfaces: MAPI (such as Microsoft Exchange), Vendor Independent Mail (VIM ”such as Lotus, cc:Mail) and SMTP. The default value is MAPI. If you specify SMTP, you must also specify and configure the EMAILHOST and EMAILPORT system options. SMTP is available only when you are sending e-mail programatically. SMTP is not available using either your e-mail program native dialog box or the SAS e-mail dialog box.
Sending E-Mail Using SAS on page 40
From SAS Language Reference: Dictionary
EMAILID System Option
EMAILPW System Option
EMAILAUTHPROTOCOL System Option
The SMTP E-mail Interface in SAS Language Reference: Concepts
Specifies the default character-set encoding for the SAS session
Default: wlatin1 if DBCS is not active; none if DBCS is active
Valid in: configuration file, SAS invocation
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: Valid values
See: ENCODING= System Option in SAS National Language Support (NLS): User s Guide
Specifies the default access method to use for SAS libraries
Default V9
Valid in: configuration file, SAS invocation
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Window specifics: valid values
-ENGINE engine-name
engine-name
can be one of the following under Windows:
BASE V9
specifies the default SAS engine for SAS System 9 and SAS 9.1 files.
BMDP
specifies the engine for BMDP data files.
OSIRIS
specifies the engine for OSIRIS data files.
SPSS
specifies the engine for SPSS data files.
V8
specifies the SAS engine all Version 8 files.
V7
specifies the SAS engine for all Version 7 files.
V6
specifies the default engine for Releases 6.08 - 6.12. The V6 engine is supported only in 32 “bit operating environments.
V604
specifies the default engine for Release 6.04 and Release 6.03.
XML
specifies the default engine for XML files.
XPORT
specifies the transport engine.
The default engine is used when a SAS data library points to an empty directory or a new file. For information about SAS/SHARE and SAS/ACCESS engines, see their respective documentation.
Types of Library Engines on page 123
SAS Language Reference: Concepts
SAS/ACCESS for Relational Databases: Reference
Communications Access Methods for SAS/CONNECT and SAS/SHARE
Specifies whether to enable the Enhanced Editor during SAS invocation
Default: ENHANCEDEDITOR
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-ENHANCEDEDITOR -NOENHANCEDEDITOR
ENHANCEDEDITOR
specifies to enable the Enhanced Editor during SAS invocation.
NOENHANCEDEDITOR
specifies not to enable the Enhanced Editor during SAS invocation.
By default, the Enhanced Editor is enabled when you start SAS. If you do not want the Enhanced Editor enabled when you start SAS, use the NOENHANCEDEDITOR system option.
WEDIT Command on page 360
Specifies an alternative set of file filter specifications to use for the Open and Save As dialog boxes
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-FILTERLIST filter1 filter2 ... filter-n
filter1...filter n
specifies one or more strings of text separated by a and enclosed in double quotation marks, such as *.Bob s work SAS*.* Note that you can specify long filename extensions that include spaces and single quotation marks.
All filters in the FILTERLIST are added to the application specified filter list displayed in the Files of type box in the Open dialog box and in the Save as type box in the Save As dialog box. The first filter in the FILTERLIST becomes the default filter. The FILTERLIST must be enclosed in double quotation marks.
DLGOPEN Command on page 334
DLGSAVE Command on page 340
Specifies a font to use for SAS windows
Default: Sasfont 8
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-FONT font-name <BOLD NORMAL><REGULAR ITALIC>< font-size >< character-set >
FONT= font-name <BOLD NORMAL><REGULAR ITALIC>< font-size >< character-set >
font-name
specifies the name of the font for text in the SAS windowing environment. This must be a valid font name (for example, SAS Monospace or Courier ). The font-name argument must be enclosed in double quotation marks. This is a required argument.
BOLD NORMAL
specifies the weight of the font. The default is NORMAL.
REGULAR ITALIC
specifies the style of the font. The default is REGULAR.
font-size
specifies the font size to use for printing. This must be an integer from 1 to 7200, inclusive. If you omit this argument, SAS uses the last selected size unless there is no previous size, in which case 8 is used.
character-set
specifies the character set to use. The default is Western . Some possible valid values are Western, Central European, Cyrillic, Greek, Turkish, Arabic, Baltic, and Thai. If the font does not support the specified character set, the default character set is used. If the default character set is not supported by the font, the font s default character set is used.
Valid font names are shown in the Fonts folder. To open the Font folder, type font in the Run dialog box. For example, you can use the following option with the SAS command:
-font "sas monospace bold" 12
SAS displays output best with a monospace (fixed-pitch) font. If you use a proportional (variable pitch) font, text may display incorrectly. If you specify a point-size that is not valid for a font, SAS uses the closest point size for the font you specify.
SYSGUIFONT System Option on page 564
SYSPRINTFONT System Option on page 567
Assigns a Windows font to one of the SAS fonts
Default: varies (see table in Details on page 503)
Valid in: configuration file, SAS invocation
Category: Graphics: Driver settings
PROC OPTIONS GROUP= GRAPHICS
Windows specifics: all
-FONTALIAS SAS-font host-specific-font
SAS-font
specifies the SAS font you want to replace. The name of the font must be enclosed in double quotation marks.
host-specific-font
specifies the Windows font that you want to assign. The name of the font must be enclosed in double quotation marks.
Use the FONTALIAS system option for each font that you want to override.
The default font aliases for Windows are as follows :
SAS font | Windows font |
---|---|
Times Times | New Roman |
Helvetica | Arial |
Courier | Courier New |
Symbol | Symbol |
Script | Script |
AvantGarde | Arial |
Bookman | Times New Roman |
Schoolbook | Times New Roman |
Palatino | Times New Roman |
Dingbats | Symbol |
The system option -fontalias "Times" "Courier New" tells SAS to use Courier New wherever the Times SAS font is requested .
Specifies the directory location of the files that contain the SAS fonts that are loaded during the SAS session
Default: ! sasroot \ core \resource
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
See: FONTSLOC System Option in SAS Language Reference: Dictionary
-FONTSLOC directory-specification
directory-specification
specifies the directory that contains the SAS fonts that are loaded during the SAS session. If directory-specification contains spaces, it must be enclosed in quotation marks.
The directory must be a valid Windows pathname.
Specifies the default output formatting characters
Default: (see the SAS configuration file)
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: Procedure output
PROC OPTIONS GROUP= LISTCONTROL
Windows specifics: Valid values for formatting-characters
See: FORMCHAR System Option in SAS Language Reference: Dictionary
-FORMCHAR formatting-characters
FORMCHAR= formatting-characters
formatting-characters
specifies any string or list of strings of characters up to 64 bytes long. If fewer than 64 bytes are specified, the string is padded with blanks on the right. The character string must be enclosed in double quotation marks.
Formatting characters are used to construct tabular output outlines and dividers for various procedures, such as the CALENDAR, FREQ, and TABULATE procedures. If you omit formatting characters as an option in the procedure, the default specifications given in the FORMCHAR= system option are used. Note that you can also specify a hexadecimal character constant as a formatting character. When you use a hex constant with this option, SAS interprets the value of the hex constant as appropriate for the Windows environment.
The configuration file shipped with SAS contains two FORMCHAR system option specifications, with one of them commented out. The default FORMCHAR uses the characters in the SAS Monospace and Sasfont fonts. If you use a code page other than the standard code pages, comment out the FORMCHAR system option that shipped with SAS and use the other FORMCHAR system option.
Generates memory usage and image usage statistics for each task SAS completes
Default: NOFULLSTIMER
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: all
-FULLSTIMER -NOFULLSTIMER
FULLSTIMER NOFULLSTIMER
FULLSTIMER
specifies that SAS write to the SAS log a complete list of computer resources that were used for each step and for the entire SAS session.
NOFULLSTIMER
specifies that SAS not write a complete list of computer resources to the SAS log. This is the default.
The FULLSTIMER system option specifies whether all the performance statistics of your computer system that are available to SAS are written to the SAS log. Data about I/O, memory, and CPU time is available.
This system option gives you time-elapsed statistics if you have not turned off the STIMER option. If you turn off the STIMER option, the FULLSTIMER option does not generate time statistics.
If you need statistics on tasks such as the SAS windowing environment (statistics for the windowing environment are available only when SAS terminates), you should use the ALTLOG System Option on page 483 to specify the destination for a copy of the SAS log. If you specify the FULLSTIMER system option before you end your SAS session, you can view statistics for the SAS windowing environment at the destination that you specified.
Some statistics will not be calculated accurately unless the FULLSTIMER system option is specified at start-up time.
The following is an example of the statistics that the SAS log displays when the FULLSTIMER option is on:
NOTE: There were 5 observations read from the data set MYSAS.DEPART1. NOTE: PROCEDURE PRINT used (Total process time): real time 0.96 seconds user cpu time 0.01 seconds system cpu time 0.15 seconds Memory 83k
The FULLSTIMER system option specifies whether all of the available performance statistics are written to the SAS log. The STIMER system option specifies whether time-elapsed statistics for DATA steps or PROC steps are written to the SAS log.
STIMER System Option on page 563
The section optimizing system performance in SAS Language Reference: Concepts .
Specifies the location of the SAS data library that contains U.S. Census Tract maps supplied by SAS/GIS
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Graphics: Driver settings
PROC OPTIONS GROUP= GRAPHICS
Windows specifics: Valid values for library-specification and path-to-library
See: GISMAPS System Option in SAS Language Reference: Dictionary
-GISMAPS library-specification path-to-library
GISMAPS= library-specification path-to-library
library-specification path-to-library
specifies either a library or a physical path to a library that contains U.S. Census Tract maps supplied by SAS/GIS. path-to-library must be a valid Windows pathname. If the pathname contains spaces, enclose the pathname in quotation marks.
Specifies one or more index files to be used by SAS Help and Documentation
Default: /help/common.hlp/index.txt, /help/common.hlp/keywords.htm, common.hhk
Valid in: configuration file, SAS invocation
Category: Environment control: Help
PROC OPTIONS GROUP= HELP
Windows specifics: HTML-HELP-index-pathname
-HELPINDEX <(> " index-pathname-1 " < " index-pathname-2 " " index-pathname-n ")>
index-pathname
specifies the partial pathname for the index that is to be used by SAS Help and Documentation. index-pathname must be a valid Windows pathname. Pathname must be enclosed in quotation marks. When you specify more than one pathname, separate the pathnames with a space and enclose the list of pathnames in parentheses.
The index-pathname can be any or all of the following:
/help/ applet-index-filename
specifies the partial pathname of the index file that is to be used by the SAS Help and Documentation Java applet under a UNIX environment. applet-index-filename must have a file extension of .txt, and it must reside in a path that is specified by the HELPLOC system option. The default is /help/common.hlp/index.txt.
See the default index file for the format that is required for an index file.
/help/ accessible-index-filename
specifies the partial pathname of an accessible index file that is to be used by SAS Help and Documentation under UNIX, OpenVMS, or z/OS environments. An accessible index file is an HTML file that can be used by Web browsers. accessible-index-filename must have a file extension of .htm and it must reside in a path that is specified by the HELPLOC system option. The default pathname is / help/common.hlp/keywords.htm.
See the default index file for the format that is required for an index file.
HTML-Help-index-pathname
specifies the pathname of the Microsoft HTML Help index that is to be used by SAS Help and Documentation under Windows environments. The default pathname is common.hhk. For information about creating an index for Microsoft HTML Help, see your Microsoft HTML Help documentation.
Use the HELPINDEX option if you have a customized index that you want to use instead of the index that SAS supplies. If you use one configuration file to start SAS under more than one operating environment, you can specify all of the partial pathnames in the HELPINDEX option.The order of the pathnames is not important, although only one pathname of each type can be specified.
When the HELPINDEX option specifies a pathname for UNIX, OpenVMS, or z/OS operating environments, SAS determines the complete path by replacing /help/ in the partial pathname with the pathname that is specified in the HELPLOC option. If the HELPLOC option contains more than one pathname, each path is searched for the specified index.
For example, when the value of HELPINDEX is /help/common.hlp/myindex.htm and the value of HELPLOC is /u/myhome/myhelp , the complete path to the index is / u/myhome/myhelp/common.hlp/myindex.htm .
HELPLOC System Option on page 508
Specifies the location of Help files that are used to view SAS Help and Documentation using Microsoft HTML Help
Default: ( !MYSASFILES\classdoc ! sasroot \nls\en\help ! sasroot \core\help )
Valid in: configuration file, SAS invocation
Category: Environment control: Help
PROC OPTIONS GROUP= HELP
Windows specifics: valid values for pathname
-HELPLOC <(> " pathname-1 " <" pathname-2 " " pathname-n ")>
pathname
specifies one or more directory pathnames in which SAS Help and Documentation files are located. Pathname must be a valid Windows pathname that contains the installed Microsoft HTML Help files. Pathnames must be enclosed in quotation marks. When more than one pathname is specified, use parentheses around the list of pathnames.
Specifying a value for the HELPLOC system option causes SAS to insert that value at the start of a concatenated list of values. This enables you to access the help for your site without losing access to SAS Help and Documentation.
The default folders !MYSASFILES\classdoc and ! sasroot \core\help are used for SAS/ AF application Help and SAS Help and Documentation, respectively.
Example The following command contains two specifications of HELPLOC:
sas -helploc "c:\app1\help" -helploc "c:\app2\help"
The value of the system option is of the following form:
("c:\app2\help" "c:\app1\help" "! sasuser \classdoc" "! sasroot \nls\en\help" "! sasroot \core\help")
Registers help files to access from the main SAS window Help menu
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Help
PROC OPTIONS GROUP= HELP
Windows specifics: all
-HELPREGISTER menu string help file location < help string > < topic ><CHM HLP HTML>
" menu string "
is the text string that appears in the Help menu.
help file location
specifies the folder and the filename in which the help file is located. The help file location can be omitted if the file resides in a folder that is specified by the HELPLOC system option. The help file location may be truncated with ! sasroot . If help file location includes blank spaces, it must be enclosed in quotation marks.
help string
is the text that appears in the status line when a user places the mouse over the menu string .
topic
is the topic within the help file that displays when you select menu string from SAS help menu. For HTML files, the topic is the anchor (preceded with #) within the document. For CHM files, the topic is the page within the CHM file. For HLP files, topic is the keyword in the file for which WinHelp searches. If topic includes blank spaces, it must be enclosed in quotation marks.
CHM
specifies an HtmlHelp CHM file on the local system or network.
HLP
specifies a WinHelp file on the local system or network.
HTML
specifies an HTML file on the local file system or network, or a valid URL.
Use the HELPREGISTER system option to add up to 20 help files that you would like available from the main SAS window Help menu. All strings containing spaces must be enclosed in double quotation marks. Optional arguments may be omitted by replacing them with a single period (.) or empty double quotation marks ( ) . If no further argument is necessary, no place-holder is required.
To add multiple Help files to the Help menu, use multiple HELPREGISTER system options either in the configuration file or at the command prompt when you start SAS.
sas -helpregister ''SAS Institute Inc'' http://www.sas.com ''SAS's homepage on the web'' . html sas -helpregister ''Local HTML Doc'' c:\mypage.htm ''My own help'' middle
sas -helpregister ''My CHM file'' \server\share\HelpStuff.chm . ''InternalFile.htm'' sas -helpregister ''SAS Windows Companion'' host.chm . ''/host.hlp/chostfutil.htm''
sas -helpregister ''A WinHelp File'' c:\somefile.hlp ''simply an .hlp file'' sas -helpregister ''WinHelp with a Topic'' c:\somefile.hlp . ''My Topic''
Adding Help to the Help Menu on page 64
Specifies the table of contents files to be used by SAS Help and Documentation
Default: /help/helpnav.hlp/config.txt /help/common.hlp/toc.htm common.hhc
Valid in: configuration file, SAS invocation
Category: Environment control: Help
PROC OPTIONS GROUP= HELP
Windows specifics: HTML-Help-TOC-pathname
-HELPTOC <(> " TOC-pathname-1 " < " TOC-pathname-2 " " TOC-pathname-3 ")>
TOC-pathname
specifies a partial pathname for the table of contents that is to be used by SAS Help and Documentation. The TOC-pathname must be a valid Windows pathname. Pathnames must be enclosed in quotation marks. When more than one pathname is specified, use parentheses around the list of pathnames.
The TOC-pathname can be any or all of the following:
/help/ applet-TOC-filename
specifies the partial pathname of the table of contents file that is to be used by the SAS Help and Documentation Java applet under a UNIX environment. applet-TOC-filename must have a file extension of .txt, and it must reside in a path that is specified by the HELPLOC system option. The default is /help/helpnav.hlp/config.txt.
See the default table of contents file for the format that is required for an index file.
/help/ accessible-TOC-filename
specifies the partial pathname of an accessible table of contents file that is to be used by SAS Help and Documentation under UNIX, OpenVMS, or z/OS environments. An accessible table of contents file is an HTML file that can be used by Web browsers. accessible-TOC-filename must have a file extension of .htm and it must reside in a path that is specified by the HELPLOC system option. The default pathname is /help/common.hlp/toc.htm.
See the default table of contents file for the format that is required for a table of contents.
HTML-Help-TOC-pathname
specifies the complete pathname to the Microsoft HTML Help table of contents that is to be used by SAS Help and Documentation in Windows environments. The default pathname is common.hhc. For information about creating an index for Microsoft HTML Help, see your Microsoft HTML Help documentation.
Use the HELPTOC option if you have a customized table of contents that you want to use instead of the table of contents supplied by SAS. If you use one configuration file to start SAS under more than one operating environment, you can specify all of the partial pathnames in the HELPTOC option. The order of the pathnames is not important, although only one pathname of each type can be specified.
When the HELPTOC option specifies the pathname for UNIX, OpenVMS, and z/OS operating environments, SAS determines the complete path by replacing /help/ in the partial pathname with the pathname that is specified in the HELPLOC option. If the HELPLOC option contains more than one pathname, each path is searched for the table of contents.
For example, when HELPTOC is /help/common.hlp/mytoc.htm and the value of HELPLOC is /u/myhome/myhelp , the complete path to the table of contents is /u/ myhome/myhelp/common.hlp/mytoc.htm .
HELPLOC System Option on page 508
Specifies that the Windows Print Manager is to be used for printing
Default: HOSTPRINT
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: Procedure output
PROC OPTIONS GROUP= LISTCONTROL
Windows specifics: all
-HOSTPRINT -NOHOSTPRINT
HOSTPRINT NOHOSTPRINT
HOSTPRINT
specifies to use Windows printing. This is the default.
NOHOSTPRINT
specifies to use SAS forms for printing.
Use the NOHOSTPRINT option to use forms for printing in a batch SAS session. When you specify NOHOSTPRINT, the Use Forms check box is selected in the Print Setup dialog box, and SAS uses the linesize, pagesize, and font values that are specified in your SAS form.
Setting Print Options to Use Forms on page 175
Minimizes the SAS window
Default: NOICON
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Option window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-ICON -NOICON
ICON NOICON
ICON
specifies to minimize the main SAS window immediately.
NOICON
restores the main SAS window immediately.
If you put the ICON system option in the SAS command or the SAS configuration file, SAS is minimized upon initialization. If you submit the ICON system option in an OPTIONS statement, SAS is immediately minimized. This is equivalent to clicking on the minimize button.
This system option is especially useful for obtaining a minimized SAS session as soon as you start Windows. For example, the ICON system option could be specified in the SAS command as follows:
c:\sas\sas.exe -icon
Specifies a SAS statement to be executed after any statements in the autoexec file and before any statements from the SYSIN= file
Valid in: configuration file, SAS invocation
Alias: IS
Category: Environment control: Initialization and operation
PROC OPTIONS GROUP= EXECMODES
Windows specifics: statement must end a DATA or PROC step if you use the Enhanced Editor
See: INITSTMT= System Option in SAS Language Reference: Dictionary
INITSTMT statement
statement
specifies any SAS statement or statements. The value of statement must end a DATA or PROC step if you use the Enhanced Editor.
Identifies Java Runtime Environment (JRE) options for SAS
Default: -Djava.security.policy=< pathname \ filename > -Dsas.jre=(private public) -Dsas.jre.home=! sasroot \ pathname -Djava.ext.dirs= pathname \ filename
Valid in: configuration file, SAS invocation
Category: Environment control: Initialization and operation
PROC OPTIONS GROUP EXECMODES
Windows specifics: all
-JREOPTIONS (- JRE-option-1 <- JRE-option-n >)
JREOPTIONS (- JRE-option-1 <- JRE-option-n >)
- JRE-option
specifies one or more Java Runtime Environment options. JRE options must begin with a hyphen ( - ). Use a space to separate multiple JRE options. Valid values for JRE-option depend on your installation s Java Runtime Environment. For information about JRE options, see your installation s Java documentation.
The set of JRE-options must be enclosed in parentheses. If you specify multiple JREOPTIONS system options, SAS appends JRE-options to JRE-options that are currently defined. Incorrect JRE-options are ignored. To define the classpath, use the Djava.class.path option.
-jreoptions (-verbose)
-jreoptions (-Djava.class.path= "c:\my java\classes\myclasses.jar";c:\java2\classes2\classes2.jar -oss600k)
Specifies the line size of SAS Log and Output windows
Default: Varies depending on display settings
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: SAS log and procedure output
PROC OPTIONS GROUP= LOG_LISTCONTROL
Windows specifics: Default value
See: LINESIZE System Optionin SAS Language Reference: Dictionary
-LINESIZE n MIN MAX
LINESIZE= n MIN MAX
n
specifies the line size in characters. Valid values range between 64 and 256.
MIN
sets the line size to 64 characters.
MAX
sets the line size to 256 characters.
The default values are based on the printer resolution and printer font so that generated reports print correctly.
CAUTION:
Modifying print options by using the Windows printing dialog boxes can change the values of SAS printing system options, which might cause unpredictable output. If you set printing options using SAS system options such as LINESIZE and PAGESIZE, and then use the Windows printing dialog boxes to set printing options. The SAS system options are set to the values that are specified in the Windows print dialog boxes.
PAGESIZE System Option on page 530
In the SAS Language Reference: Dictionary :
ORIENTATION System Option
PAGESIZE System Option
Specifies a suggested amount of memory needed for executable programs loaded by SAS
Default:
Valid in: configuration file, SAS invocation
Category: System administration: Memory
PROC OPTIONS GROUP= MEMORY
Windows specifics: all
-LOADMEMSIZE n n K n M n G hex X MIN MAX
n n K n M n G
specifies the memory size in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes), and 1,073,741,842 (gigabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the amount of memory as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
MIN
specifies 0 bytes, which indicates that there is no limit on the total amount of memory that can be used.
MAX
specifies that the maximum amount of memory for executable programs is limited only by the amount of memory available.
When LOADMEMSIZE is set to 0, the memory that is used for executable programs that are loaded by SAS is limited only by the amount of system memory available. If LOADMEMSIZE is set to 1, executable programs are purged from memory when they are no longer in use.
For values of two or greater, SAS first checks the amount of memory that is available for SAS executable programs. If the total amount of memory that is available is greater than the value of LOADMEMSIZE, SAS purges the SAS loaded executable programs that are not in use until the memory that is used is less than the value of the LOADMEMSIZE option, or until there are no other SAS loaded executable programs that can be purged. If all executable programs have been purged and more memory is needed, additional system memory is used as long as it is available.
Specifies the locale of the SAS session
Default: English
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: all
See: LOCALE= System Option in SAS National Language Support (NLS): User s Guide
Controls the creation of the SAS log file for batch mode
Default: filename .LOG in batch mode, where filename is the name of your SAS job
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: destination must be a valid Windows filename
-LOG destination -NOLOG
LOG destination
specifies the destination for the SAS log. The destination argument can be a valid Windows pathname or filename (including device names such as LPT1) or an environment variable that is associated with a pathname. If you specify only a pathname, the log file is created in the specified directory with the default name of filename .LOG, where filename is the name of your SAS job.
NOLOG
routes each log message to a message box, where one message is displayed per message box.
The LOG system option specifies a destination to which the SAS log is written when executing SAS programs in batch mode.
This system option is valid only in batch mode.
When you are running SAS interactively, the log is sent to the LOG window; in batch mode, it is sent to a file named filename .LOG that is located in the current SAS directory, where filename is the name of your SAS job. You can use the LOG system option to specify an alternate destination.
To disable the display of the SAS log, use the NOTERMINAL system option.
When SAS is started with the OBJECTSERVER and NOTERMINAL system options and no log is specified, SAS discards all log messages.
TERMINAL System Option in SAS Language Reference: Dictionary
Specifies the name of the SAS library that holds the SAS/GRAPH map data sets
Default: ! sasroot \maps
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Graphics: Driver settings
PROC OPTIONS GROUP= GRAPHICS
Windows specifics: default value and location-of-maps must resolve to a valid Windows pathname
See: MAPS System Option in SAS Language Reference: Dictionary
-MAPS location-of-maps
MAPS= location-of-maps
location-of-maps
specifies a libref, a valid Windows pathname, or an environment variable associated with a pathname. Remember that a pathname is only to the directory or subdirectory level. If the pathname contains spaces, enclose the pathname in quotation marks.
Specifies the limit on the maximum amount of memory that is allocated for procedures
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: System administration: Memory
PROC OPTIONS GROUP= MEMORY
Windows specifics: all
-MAXMEMQUERY n n K n M n G hex X MIN MAX
MAXMEMQUERY= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the limit in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes), and 1,073,741,842 (gigabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the amount of memory as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
MIN
sets the amount of memory to the minimum setting, which is 0 bytes. This indicates that there is no limit on the total amount of memory that can be used by each procedure.
MAX
sets the amount of memory to the maximum setting, which is 2,147,483,647 bytes.
Some SAS procedures attempt to allocate the maximum amount of the memory that is possible, up to the amount specified by the MEMSIZE option. If this amount of memory is not available, SAS attempts to use paging. If the amount of page space is less than the value of MEMSIZE, SAS generates an error message. The MAXMEMQUERY option specifies the maximum amount of memory that SAS can request at one time. If your system has small system paging devices, you may want to lower the value of MAXMEMQUERY.
Specifies the memory block size for memory-based libraries for Windows operating environments, excluding Windows NT
Default: 16 MB
Valid in: configuration file, SAS invocation
Category: System administration: Memory
PROC OPTIONS GROUP MEMORY
Windows specifics: all
-MEMBLKSZ n n K n M n G n T hex X
n n K n M n G n T
specifies the memory block size in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); 1,073,741,824 (gigabytes); and 1,099,511,627,776 (terabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, gigabytes, or terabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the memory block size as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the memory block size to 45 bytes.
Beginning with Windows 2000, multiple processes can be run simultaneously in memory. The value of the MEMBLKSZ system option is the amount of memory that is initially allocated. Additional memory can be allocated in the same memory allocation size that is specified in the MEMBLKSZ option, up to the amount of memory that is specified in the MEMMAXSZ option. For example, if MEMBLKSZ is 2M, additional memory can be allocated in 2M blocks.
When memory-based libraries are using extended memory, this value is also used to determine the amount of the process address space that is used to access the extended memory.
Note: This option is ignored in Windows NT operating environments.
Note: Specifying a value that is too large could adversely affect performance.
Beginning with Windows 2000, specifying a value that is too large could adversely affect overall system performance. Try different values for the MEMBLKSZ option to determine the value that gives the best system performance.
If you are using extended memory in 32-bit environments, then specifying a value that is too large could adversely affect SAS performance. A smaller value may be optimal. A good starting point is 64K; however, try different values for the MEMBLKSZ option to determine the value that gives the best SAS performance.
Memory-Based Libraries on page 199
MEMMAXSZ System Option on page 522
Specifies to use the memory-based libraries as a SAS file cache
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Windows specifics: all
-MEMCACHE 0 1 4
MEMCACHE= 0 1 4
specifies memory cache is off.
1
specifies not to add any new files to the cache. Reads and writes to files already in the cache continue as if MEMCACHE is on.
4
specifies memory cache is on. Memory is used as a SAS file cache.
When the MEMCACHE system option is 4 or 1, SAS file cache places data in memory as it is processed. This data is then available for future references by SAS. Files in the cache are kept until SAS is shut down, caching is terminated , or more space is required for new files. Memory is reclaimed on a least recently used basis. Cached data is written to permanent storage. You can control which SAS libraries use the cache by using the MEMCACHE system option in the OPTIONS statement. Memory usage can be monitored using the performance tools.
Memory-Based Libraries on page 199
MEMLIB System Option on page 521
Specifies to process the Work library as a memory-based library
Default: NOMEMLIB
Valid in: configuration file, SAS invocation
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Windows specifics: all
-MEMLIB -NOMEMLIB
MEMLIB
specifies to use memory for the Work libraries.
NOMEMLIB
specifies not to use memory.
When the MEMLIB system option is specified, the Work library is processed in memory. Files are kept in memory until SAS is terminated or the files are deleted. You can monitor memory usage by using the performance tools.
Memory-Based Libraries on page 199
LIBNAME Statement on page 456
MEMCACHE System Option on page 520
Performance Tools on page 226
Specifies the maximum amount of memory to allocate for using memory-based libraries in Windows operating environments, excluding Windows NT
Default: 2G
Valid in: configuration file, SAS invocation
Category: System administration: Memory
PROC OPTIONS GROUP= MEMORY
Windows specifics: all
-MEMMAXSZ n n K n M n G n T hex X
n n K n M n G n T
specifies the amount of memory to allocate in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); 1,073,741,824 (gigabytes); and 1,099,511,627,776 (terabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, gigabytes, or terabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the amount of memory to allocate as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
The MEMMAXSZ system option specifies the total amount of memory that SAS can use for memory-based libraries. You can monitor the memory by using the performance tools.
Note: This option is ignored in Windows NT operating environments.
CAUTION:
Specifying a value that is too large may adversely affect overall system performance. Try different values for the MEMMAXSZ option to determine the value that gives the best system performance.
Memory-Based Libraries on page 199
MEMBLKSZ System Option on page 519
MEMCACHE System Option on page 520
MEMLIB System Option on page 521
Specifies a limit on the total amount of memory SAS uses at any one time
Default:
Valid in: configuration file, SAS invocation
Category: System administration: Memory
PROC OPTIONS GROUP= MEMORY
Windows specifics: valid values
-MEMSIZE n n K n M n G hex X MIN MAX
n n K n M n G
specifies the limit in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes), and 1,073,741,824 (gigabytes), respectively. The value of n can be a decimal value. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes. Under 32 “bit operating environments, the largest value that you can specify is 4294967295 (4G “1).
hex X
specifies the limit as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the limit to 45 bytes.
MIN
specifies to set the limit to 0. A value of zero indicates there is no limit except the operating system limit.
MAX
specifies to set the limit to the largest possible setting.
The operating system may use additional amounts of memory. The memory used by SAS includes virtual memory and is therefore not limited to RAM. If MEMSIZE is set to a value that is too low and could cause performance problems, the value of MEMSIZE is determined by SAS.
For optimal performance, use the default value of 0 for MEMSIZE.
Specifies the library that contains SAS error messages
Default: ! sasroot \core\sasmsg
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for library-specification
-MSG library-specification
library-specification
can be a Windows logical name (including search strings) or pathname. Do not include a filename. If the pathname contains spaces, you must enclose the pathname in quotation marks.
The MSG system option specifies the name of the library for SAS error messages.
Specifies whether notes, warnings, and error messages that are generated by SAS are displayed in uppercase characters
Default: NOMSGCASE
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: all
-MSGCASE -NOMSGCASE
MSGCASE
specifies that messages are displayed in uppercase characters.
NOMSGCASE
specifies that messages can include uppercase and lowercase characters. This is the default.
The MSGCASE system option specifies whether or not messages from the message file are uppercased before they are written out. The setting of the MSGCASE option does not affect user-generated messages and source lines.
Specifies the maximum amount of memory available to the macro variable symbol table(s)
Default: 4194304 bytes (4 MB)
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Macro: SAS macro
PROC OPTIONS GROUP= MACRO
Windows specifics: Default value
See: MSYMTABMAX System Option in SAS Macro Language: Reference
-MSYMTABMAX n n K n M n G n T hex X MIN MAX
MSYMTABMAX= n n K n M n G n T hex X MIN MAX
n n K n M n G n T
specifies the amount of memory that is available in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); 1,072,741,824 (gigabytes); and 1,099,511,627,776 (terabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, gigabytes, or terabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the amount of memory that is available as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
MIN
sets the amount of memory that is available to the minimum setting, which is 0. This causes all macro variables to be written to disk.
MAX
sets the amount of memory that is available to the maximum setting.
After the MSYMTABMAX value is reached, SAS writes any additional macro variables to disk.
Specifies the maximum size for in-memory macro variables
Default: 4096 bytes
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Macro: SAS macro
PROC OPTIONS GROUP= MACRO
Windows specifics: Default value
See: MVARSIZE System Option in SAS Macro Language: Reference
-MVARSIZE n n K hex X MIN MAX
MVARSIZE= n n K hex X MIN MAX
n n K
specifies the maximum macro variable size in multiples of 1 or 1,024 (kilobytes), respectively. You can specify decimal values for the number of kilobytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3k specifies 3,072 bytes.
hex X
specifies the maximum macro variable size as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the maximum macro variable size to 45 bytes.
MIN
sets the macro variable size to the minimum setting, which is 0 bytes. This causes all macro variables to be written to disk.
MAX
sets the macro variable size to the maximum setting, which is 65,534 bytes.
The MVARSIZE system option specifies the maximum size for macro variables that are stored in memory. If the size of the macro variable is larger than the maximum value that is specified, variables are written out to disk.
The value of the MVARSIZE system option can affect system performance. Before you specify the value for production jobs, run tests to determine the optimum value.
Specifies a file that contains messages to be written to the SAS log
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for file-specification
See: NEWS System Option in SAS Language Reference: Dictionary
-NEWS file-specification
file-specification
specifies an external file. The value for file-specification can be a valid Windows pathname or shortcut name. If the pathname contains spaces, you must enclose the pathname in quotation marks.
The NEWS file can contain information for users, including news items about SAS. The contents of the NEWS file are displayed in the SAS log immediately after the SAS header.
Provides national language compatibility with previous releases of SAS
Default: NONLSCOMPATMODE
Valid in: configuration file, SAS invocation
Category: Environment control: Language control
PROC OPTIONS GROUP= LANGUAGECONTROL
Windows specifics: all
See: NLSCOMPATMODE System Option in SAS National Language Support (NLS): User s Guide
Controls the number of available function keys
Default: number of function keys on the keyboard
Valid in: configuration file, SAS invocation
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: all
-NUMKEYS number-of-keys
number-of-keys
specifies the number of active keyboard function keys.
When SAS initializes, it queries your machine to determine the number of keyboard function keys. You can override this setting by specifying a different value with the NUMKEYS system option.
If you specify the following system option, SAS displays 10 function keys in the KEYS window:
-numkeys 10
Specifies the number of mouse buttons SAS displays in the KEYS window
Default: 3 buttons
Valid in: configuration file, SAS invocation
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: all
-NUMMOUSEKEYS number-of-buttons
number-of-buttons
specifies the number of mouse buttons, ranging from 0 to 3. If number-of-buttons is 0 or 1, the KEYS windows lists no mouse buttons (because the left, and in this case the only, mouse button is reserved by SAS). If number-of-buttons is 2, the KEYS window lists the right mouse button (RMB), as well as Ctrl + right mouse button and Shift + right mouse button. If number-of-buttons is 3, the KEYS window lists both the right mouse button and the middle mouse button.
Unless you specify the NUMMOUSEKEYS system option, SAS assumes that three mouse buttons are available. If you have a one- or two-button mouse and want the KEYS window to reflect this, specify the NUMMOUSEKEYS system option in your SAS configuration file.
Specifies when to stop processing observations or records
Default: MAX
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Windows specifics: Valid range
See: OBS System Option in SAS Language Reference: Dictionary
-OBS n n K n M n G n T hex X MIN MAX
OBS= n n K n M n G n T hex X MIN MAX
n n K n M n G n T
specifies a number to indicate when to stop processing, with n being an integer. Using one of the letter notations results in multiplying the integer by a specific value. That is, specifying K (kilo) multiplies the integer by 1,024, M (mega) multiplies by 1,048,576, G (giga) multiplies by 1,073,741,824, T (tera) multiplies by 1,099,511,627,776. You can specify a decimal value for n when it is used to specify a K, M, G, or T value. For example, a value of 20 specifies 20 observations or records, a value of .782k specifies 801 observations or records, and a value of 3m specifies 3,145,728 observations or records.
hex X
specifies a number to indicate when to stop processing as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the hexadecimal value F8 must be specified as 0F8X in order to specify the decimal equivalent of 248. The value 2dx specifies the decimal equivalent of 45.
MIN
sets the number to indicate when to stop processing to 0.
MAX
sets the number to indicate when to stop processing to 2,147,483,647. On 64 “bit systems, MAX is 9,223,372,036,854,775,807. MAX is the default.
Resets the page number
Default: 1
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: Procedure output
PROC OPTIONS GROUP= LISTCONTROL
Windows specifics: Valid values for n ; syntax
See: PAGENO System Option in SAS Language Reference: Dictionary
-PAGENO n n K n M n G hex X MIN MAX
PAGENO= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the page number in multiples of 1( n ); 1,024 ( n K); 1,048,576 ( n M); and 1,073,741,824 ( n G), respectively. You can specify a decimal value for n when it is used to specify a K, M, G, or T value. For example, a value of 8 sets the page number to 8, a value of .782k sets the page number to 801, and a value of 3k sets the page number to 3,072.
hex X
specifies the page number as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the page number to 45.
MIN
sets the page number to the minimum number, which is 1.
MAX
sets the page number to the maximum number, which is 2,147,483,647.
The PAGENO system option specifies a beginning page number for the next page of output that SAS produces.
Specifies the number of lines that compose a page of SAS output
Default: Varies depending on your display settings
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: SAS log and procedure output
PROC OPTIONS GROUP= LOG_LISTCONTROL
Windows specifics: Default value
See: PAGESIZE System Option in SAS Language Reference: Dictionary
-PAGESIZE n MIN MAX
PAGESIZE= n MIN MAX
n
specifies the number of lines that compose a page.
MIN
sets the number of lines that compose a page to the minimum setting, which is 15.
MAX
sets the number of lines that compose a page to the maximum setting, which is 32,767.
Under Windows, the default values are based on the printer resolution and printer font so that generated reports print correctly.
CAUTION:
Modifying print options by using the Windows printing dialog boxes might change the values of SAS printing system options, which might cause unpredictable output. If you set printing options using SAS system options such as LINESIZE and PAGESIZE, and then use the Windows printing dialogs to set printing options, the SAS system options are set to the values that are specified in the Windows print dialog boxes.
LINESIZE System Option on page 515
Specifies to a printer the type of paper to use for printing
Default: PLAIN
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: ODS printing
PROC OPTIONS GROUP= ODSPRINT
Windows specifics: valid values
See: PAPERTYPE= System Option in SAS Language Reference: Dictionary
-PAPERTYPE PLAIN STANDARD GLOSSY TRANSPARENCY
printer-defined-value
PAPERTYPE= PLAIN STANDARD GLOSSY TRANSPARENCY
printer-defined-value
PLAIN
specifies to use plain paper.
STANDARD
specifies to use the standard paper for the printer.
GLOSSY
specifies to use glossy paper.
TRANSPARENCY
specifies to use transparent paper.
printer-definded-value
specifies a paper type that is defined by the printer.
See your printer documentation for the paper types that your printer can use.
Operating Environment Information: for Windows NT Users: The PAPERTYPE system option is not supported under Windows NT.
Specifies one or more search paths for SAS executable files
Default: ! sasroot \core\sasexe
Valid in: configuration file, SAS invocation
Category: System administration: Installation
PROC OPTIONS GROUP= INSTALL
Windows specifics: all
-PATH <(>" directory-specification-1 " <" directory-specification-n ")>
directory-specification
specifies the path to search. The value directory-specification must be a valid Windows pathname or an environment variable associated with a pathname. If the pathname contains spaces, it must be enclosed in quotation marks. If you specify more than one directory-specification , enclose the list of directory-specification in parentheses.
You can specify multiple PATH system options to define a search order.
Enables you to map your function keys to the mainframe primary, alternate, or SAA keys
Default: WIN
Valid in: configuration file, SAS invocation
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: all
-PFKEY PRIMARY ALTERNATE SAA WIN
PRIMARY
maps F1 through F12 to the mainframe primary settings for PF1 through PF12 and Shift + F1 through Shift + F12 to PF13 through PF24. The right mouse button (RMB) is mapped to MB2. If you have only 10 function keys, F11, F12, Shift + F11, and Shift + F12 are not available and are not shown in the KEYS window.
Following are the primary mainframe key definitions:
PC Key | Mainframe Definition | Key | Mainframe Definition |
---|---|---|---|
F1 | mark | Shift + F1 | help |
F2 | smark | Shift + F2 | zoom |
F3 | unmark | Shift + F3 | zoom off; submit |
F4 | cut | Shift + F4 | pgm; recall |
F5 | paste | Shift + F5 | rfind |
F6 | store | Shift + F6 | rchange |
F7 | prevwind | Shift + F7 | backward |
F8 | next | Shift + FF8 | forward |
F9 | pmenu | Shift + F9 | output |
F10 | command | Shift + F10 | left |
F11 | keys | Shift + F11 | right |
F12 | undo | Shift + F12 | home |
RMB | zoom off; submit |
ALTERNATE
maps F1 through F12 to the alternate mainframe key settings. That is, F1 through F12 maps to PF13 through PF24. The result is that F1 through F12 are equivalent to Shift + F1 through Sift + F F12. The right mouse button (RMB) is mapped to MB2. If you have only 10 function keys, F11 and F12 are unavailable and are not shown in the KEYS window. F13 through F24 are mapped to F1 through F12 if your keyboard has only 12 function keys instead of 24.
Following are the alternate mainframe key definitions:
PC Key | Mainframe Definition | Key | Mainframe Definition |
---|---|---|---|
F1 | help | F7 | backward |
F2 | zoom | F8 | forward |
F3 | zoom off; submit | F9 | output |
F4 | pgm; recall | F10 | left |
F5 | rfind | F11 | right |
F6 | rchange | F12 | home |
RMB | zoom off; submit |
SAA
maps F1 through F12 to the IBM SAA values for CUAPF1 through CUAPF12 and Shift + F1 through Shift + F12 to CUAPF13 through CUAPF24. The right mouse button (RMB) is mapped to MB2. If you have only 10 function keys, F11, F12, Shift + F11, and Shift + F12 are unavailable and are not shown in the KEYS window.
Note: SAA stands for System Application Architecture, which is a framework for application development and is used across IBM systems. CUA (Common User Access) is a part of SAA that defines the user interface and components that should be identical across applications.
Following are the IBM SAA key definitions:
PC Key | Mainframe Definition | Key | Mainframe Definition |
---|---|---|---|
F1 | help | Shift + F1 | cut |
F2 | keys | Shift + F2 | paste |
F3 | zoom off; submit | Shift + F3 | store |
F4 | home | Shift + F4 | mark |
F5 | pgm; recall | Shift + F5 | unmark |
F6 | zoom | Shift + F6 | smark |
F7 | backward | Shift + F7 | left |
F8 | forward | Shift + F8 | right |
F9 | prevcmd | Shift + F9 | rfind |
F10 | pmenu | Shift + F10 | rchange |
F11 | command | Shift + F11 | undo |
F12 | cancel | Shift + F12 | next |
RMB | zoom off; submit |
WIN
specifies to use the default key definitions for SAS under Windows. WIN is the default.
Use the PFKEY system option when you do not want the default key definitions for SAS under Windows but instead want to use other key mappings (for example, the mappings used by SAS under z/OS).
Note that the function key values shown in the previous key map tables are for the Base SAS windows only. Other windowing SAS products, such as SAS/AF software, have other key definitions.
If you do not specify the PFKEY system option, or if you specify an invalid value, SAS loads the default Windows key definitions. For a list of key definitions, open the KEYS window by typing keys in the command bar..
Controls the creation of the SAS procedure output file for batch mode
Default: filename .LST in batch mode, where filename is the name of your SAS job
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: all
-PRINT destination -NOPRINT
PRINT destination
specifies the destination for the SAS procedure output file. The destination argument can be a valid Windows pathname or filename (including device names) or an environment variable associated with a pathname. If you specify a pathname and it contains spaces, it must be enclosed in quotation marks. If you specify only a pathname, the procedure output file is created in the specified directory, with the default name of filename .LST, where filename is the name of your SAS job.
NOPRINT
suppresses the creation of the SAS procedure output file.
The PRINT system option specifies the destination to which SAS output is written when executing SAS programs in modes other than the interactive windowing environment.
The PRINT system option is valid only in batch mode.
When SAS is running interactively, the procedure output file is sent to the OUTPUT window; when SAS is running in batch mode, output is sent to a file named filename .LST, where filename is the name of your SAS job. You can use the PRINT option to specify an alternate destination.
Specifies when to display the Print Abort dialog box
Default BOTH
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-PRTABORTDLGS BOTH NEITHER FILE PRINTER
PRTABORTDLGS = BOTH NEITHER FILE PRINTER
BOTH
specifies to display the Print Abort dialog box when you are printing either to a file or to the printer.
NEITHER
specifies not to display the Print Abort dialog box when you are printing either to a file or to the printer.
FILE
specifies to display the Print Abort dialog box only when you are printing to a file.
PRINTER
specifies to display the Print Abort dialog box only when you are printing to the printer.
The Print Abort dialog box appears only while SAS is spooling a print job to its destination. Use the NEITHER value to suppress the Print Abort dialog box.
Canceling a Print Job on page 179
Specifies to use the same destination printer from SAS session to SAS session
Default: NOPRTPERSISTDEFAULT
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: ODS printing
PROC OPTIONS GROUP= ODSPRINT
Windows specifics: all
-PRTPERSISTDEFAULT -NOPRTPERSISTDEFAULT
PRTPERSISTDEFAULT
specifies to use the same destination printer from SAS session to SAS session.
NOPRTPERSISTDEFAULT
specifies to use the default printer.
Typically, when you start SAS, SAS sets the value of the SYSPRINT system option (which specifies the destination printer) to be the Windows default printer. When you start SAS by using the PRTPERSISTDEFAULT system option, SAS sets the value of the SYSPRINT system option to be the destination printer of the last SAS session that was started by using PRTPERSISTDEFAULT.
To use the same destination printer from SAS session to SAS session, you must use the PRTPERSISTDEFAULT system option each time that you start SAS. If you start SAS by using both the SYSPRINT system option and PRTPERSISTDEFAULT system option, the destination printer is the value that is specified by the SYSPRINT system option.
SYSPRINT System Option on page 566
Printing on page 166
Specifies whether to include the Use Forms check box in the Print Setup dialog box
Default: PRTSETFORMS
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-PRTSETFORMS -NOPRTSETFORMS
PRTSETFORMS NOPRTSETFORMS
PRTSETFORMS
specifies to include the Use Forms check box in the Print Setup dialog box.
NOPRTSETFORMS
specifies to exclude the Use Forms check box from the Print Setup dialog box.
Use the NOPRTSETFORMS system option to suppress the Use Forms check box in the Print Setup dialog box.
Using SAS Print Forms on page 175
Indicates the amount of virtual memory SAS can expect to allocate
Default:
Valid in: configuration file, SAS invocation
Category: System administration: Memory
PROC OPTIONS GROUP= MEMORY
Windows specifics: valid values
-REALMEMSIZE n n K n M n G hex X MIN MAX
n n K n M n G
specifies the amount of memory to reserve in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); and 1,073,741,824 (gigabytes), respectively. The value of n can be a decimal value. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes. Under 32-bit operating environments, the largest value that you can specify is 4294967295 (4G “1).
hex X
specifies the amount of memory as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
MIN
specifies a value of 0 which indicates that the memory usage is determined by SAS when SAS starts.
MAX
specifies to set the memory size to the largest permissible value.
Use the REALMEMSIZE system option to optimize the performance of SAS procedures that alter their algorithms and memory usage. Setting the value of REALMEMSIZE too low or too high may result in less than optimal performance.
Adds an application to the Tools menu in the main SAS window
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-REGISTER menu-name command < working-directory >
menu-name
specifies the name you want to appear in the menu. The menu-name must be enclosed in quotation marks.
command
specifies the command you want to execute. The command argument can either be a .EXE, .COM, or .BAT file, or it can be an operating environment command such as the DIR command. The command must be enclosed in quotation marks.
working-directory
specifies the working directory to use for the application. This argument is optional. Read your application s documentation to see if the application requires a working directory specification. The working-directory must be enclosed in quotation marks.
You can add up to eight commands to the Tools pull-down menu in the main SAS window. If your menu name or command does not include blanks or special characters, you can omit the quotes. For more information about adding commands to the list, see Adding Applications to the Tools Menu on page 64.
Specifies a directory location of the files that contain SAS resources
Default: ! sasroot \core\resource
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-RESOURCESLOC <(> directory-specification-1 < directory-specification-n )> "."
directory-specification
specifies a directory location of the files that contain SAS resources. If directory-specification contains spaces, it must be enclosed in quotation marks. If you specify more than one directory-specification , enclose the list in parenthesis.
"."
specifies that the current working folder is to be the default directory for the location of the files that contain SAS resources.
SAS resources are dynamic link libraries that contain icons, strings, and fonts that are used by SAS. The types of files that reside in the RESOURCESLOC directory are font files (.fon, .ttf) and dynamic link libraries (.dll).
You can specify multiple RESOURCESLOC options to define a search order.
Controls whether members of the Sasuser data library can be opened for update or for read-only access
Default: NORSASUSER
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Network considerations
See: RSASUSER System Option in SAS Language Reference: Dictionary
-RSASUSER -NORSASUSER
RSASUSER
limits access to the Sasuser data library to read-only access in environments where all users share the Sasuser library.
NORSASUSER
enables a user to open a file in the Sasuser library for update access, thus preventing users from sharing members of the Sasuser data library. Update access to the Sasuser library requires exclusive rights to the data library member. NORSASUSER is the default value.
Specifying RSASUSER enables a group of users to share Sasuser data library members by enabling all users to have read-only access to members. For example, if RSASUSER is in effect, each user can open the Sasuser.Profile catalog for read-only access, enabling other users to concurrently read from the Profile catalog. However, no user can write information out to the Profile catalog; you receive an error message if you try to do so.
Specifying RSASUSER in a SAS session affects only that session s access to files. To enable a group of users to share members in the Sasuser data library, the system administrator should set RSASUSER in the network version of the SAS configuration file, which is shared by all users who share the Sasuser data library.
If you specify RSASUSER but no Profile catalog exists in the Sasuser data library, the Profile catalog is created in the Work data library.
Whether the RSASUSER system option is useful depends on how SAS is being used. While the RSASUSER system option is extremely useful when users must share information (such as the Profile catalog) stored in the Sasuser data library, it is not useful if these same users are using SAS/ASSIST software. SAS/ASSIST software requires update access to the Sasuser data library.
Generates a list of the file resources used in a given SAS session
Default: NONE
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: all
-RTRACE ALL NONE
ALL
specifies to list all the file resources used in a given SAS session.
NONE
specifies not to list the file resources.
Use the RTRACE and the RTRACELOC system options to create a file that lists the resources SAS uses.
RTRACELOC System Option on page 541
Specifies the name of the file to which the file resource tracking system writes its output
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: all
-RTRACELOC filename pathname \ filename
filename pathname \ filename
specifies a valid Windows filename or a pathname and a filename in which to store the file resource information. If the filename or the pathname contains spaces, enclose the name in quotation marks. If pathname is not specified, the file resource information is stored in the current directory.
You can use the RTRACELOC and the RTRACE system options to determine which resources SAS uses.
RTRACE System Option on page 541
Specifies the length of statements on each line of source statements and the length of data on the line following a DATALINES statement
Default: 0 (no length restrictions)
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: Maximum line length
See: S System Option in SAS Language Reference: Dictionary
-S n n K n M n G n T hex X MIN MAX
S= n n K n M n G n T hex X MIN MAX
n n K n M n G n T
specifies the length of statements and data in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); 1,072,741,824 (gigabytes); and 1,099,511,627,776 (terabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, gigabytes, or terabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the length of statements and data as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the length of statements and data to 45 bytes.
MIN
sets the length of statements and data to be 0, and requires SAS to use a default value.
MAX
sets the length of statements and data to the maximum, which under Windows is 2,147,483,647.
The S system option specifies the length of statements, exclusive of sequence numbers, on each line of SAS source statements and the length of data, exclusive of sequence numbers , on lines following a DATALINES statement.
The default value of 0 enables SAS to read a file with any line length up to MAX.
S2 System Option on page 543
Specifies the length of secondary source statements
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: Valid values for n ; syntax
See: S2 System Option in SAS Language Reference: Dictionary
-S2 S n n K n M n G hex X MIN MAX
S2=S n n K n M n G hex X MIN MAX
S
uses the current value of the S system option to compute the record length of text that comes from an %INCLUDE statement, an autoexec file, or an autocall macro file.
n n K n M n G
specifies the value by which to compute the record length of text that comes from an %INCLUDE statement, an autoexec file, or an autocall macro file. Specifies this value in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); and 1,073,741,824 (gigabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the value as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx specifies 45 bytes.
MIN
uses the value of 0, indicating no length restriction.
MAX
uses the value of 2,147,483,647.
The S2 system option operates exactly like the S system option, except that the S2 system option controls input from only an %INCLUDE statement, an autoexec file, or an autocall macro file.
S System Option on page 542
Specifies the autocall macro library
Default: SASAUTOS
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Files
Macro: SAS macro
PROC OPTIONS GROUP= ENVFILES
MACRO
Windows specifics: Valid values for library-specification
See: SASAUTOS System Option in SAS Language Reference: Dictionary
-SASAUTOS <(>" library-specification-1 " <" library-specification-n ")>
SASAUTOS=<(>" library-specification-1 " <" library-specification-n ")>
" library-specification-1 " " library-specification-n "
specifies one or more valid Windows pathnames or environment variables that are associated with pathnames. Remember that a pathname is only to the directory or subdirectory level. Windows pathnames must be enclosed in quotation marks if you are using the OPTIONS statement or if the pathname contains spaces. If you specify only one library specification, the parentheses are optional. The value for library-specification must resolve to a valid Windows pathname.
The SASAUTOS system option specifies the SAS autocall macro library or libraries.
SASAUTOS System Option on page 584
SAS Macro Language: Reference
Specifies whether the SAS application windows include system/control menus and minimize/ maximize buttons
Default: SYSTEMMENU MINMAX
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SASCONTROL SYSTEMMENU NOSYSTEMMENU <MINMAX NOMINMAX>
-SASCONTROL <SYSTEMMENU NOSYSTEMMENU> MINMAX NOMINMAX
SASCONTROL=SYSTEMMENU NOSYSTEMMENU <MINMAX NOMINMAX>
SASCONTROL=<SYSTEMMENU NOSYSTEMMENU> MINMAX NOMINMAX
SYSTEMMENU
specifies to display the system/control menu in the windows that are contained in the main SAS window.
NOSYSTEMMENU
specifies to omit the system/control menu and the minimize, maximize, and close buttons from the title bar in the windows that are contained in the main SAS window.
MINMAX
specifies to display the minimize and maximize buttons in the windows that are contained in the main SAS window.
NOMINMAX
specifies to omit the minimize and maximize buttons from the windows that are contained in the main SAS window.
The SASCONTROL system option affects the windows contained inside the main SAS window, but not the main SAS window itself (which is controlled by the AWSCONTROL system option).
The SASCONTROL system option is intended for use by SAS/AF programmers to customize the interface of their applications.
AWSCONTROL System Option on page 486
Specifies the directory or directories to be searched for SAS default forms, device lists, dictionaries, and other entries in the Sashelp catalog
Default: ! sasroot \ SAS product \sashelp, ! sascfg \sascfg
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for library-specification
See: SASHELP System Option in SAS Language Reference: Dictionary
-SASHELP (" library-specification-1 " <" library-specification-n ")>
library-specification-1 library-specification-n
specifies one or more valid Windows pathnames or environment variables that are associated with pathnames. Remember that a pathname applies only to the directory or subdirectory level. The value for library-specification must resolve to a valid Windows pathname. If the pathname contains spaces, it must be enclosed in quotation marks.
The SASHELP system option is set during the installation process and normally is not changed after installation.
Note that products and their corresponding files can be split across multiple drives and directories. The library-specification argument can be a Windows pathname or an environment variable associated with a pathname.
Changes the working folder and the default folders for the Open and Save As dialog boxes to the specified folder after SAS initialization is complete
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: all
-SASINITIALFOLDER newfolder
newfolder
specifies the path to the current working folder and the default folders for the Open and Save As dialog boxes. If newfolder contains spaces, it must be enclosed in quotation marks.
SAS determines the locations for AUTOEXEC or INITSTMT files before the SASINITIALFOLDER system option is processed. To ensure that SAS can determine the location of these files, place them in a folder other than the folder that is specified by the SASINITIALFOLDER system option.
If you do not specify the SASINITIALFOLDER system option, the current working folder and the default folders for the Open and Save As dialog boxes are set to the Sasuser folder.
Changing the SAS Current Folder on page 37
Specifies the name of the Sasuser library
Default: c:\WINNT\Profiles\ username \Personal\ for Windows NT
c:\Documents and Settings\ username \My Documents\ for Windows 2000, Windows XP, and Windows Server 2003
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for library-specification ; syntax
-SASUSER ( library-specification-1 < library-specification-n >)
library-specification-1 library-specification-n
specifies one or more valid Windows pathnames or environment variables that are associated with pathnames for a SAS data library. Remember that a pathname applies only to the directory or subdirectory level. If you list only one library specification, the parentheses are optional. The value for library-specification must resolve to a valid Windows pathname.
The SASUSER system option specifies the SAS data library that contains a user s profile catalog. The default value for SASUSER is defined in the SAS configuration file, which you can change when you install SAS. If you do not use the SASUSER system option when you invoke SAS (either in the configuration file or as part of the SAS command), the Sasuser data library is set to be equal to the Work data library, which is temporary.
Profile Catalog on page 19
Using the Sasuser Data Library on page 133
Specifies whether to allow the mouse or keyboard to focus on a scroll bar
Default: NOSCROLLBARFLASH
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SCROLLBARFLASH -NOSCROLLBARFLASH
SCROLLBARFLASH NOSCROLLBARFLASH
SCROLLBARFLASH
specifies to enable mouse and keyboard focus on the scroll bars.
NOSCROLLBARFLASH
specifies to disable mouse and keyboard focus on the scroll bars.
Under certain conditions, the cursor may flash if you select a scroll bar using the mouse or the keyboard. You can turn off the flashing cursor using the NOSCROLLBARFLASH system option. You can also use the Preferences dialog box Advanced page to disable the flashing cursor by selecting Disable scroll bar focus .
Setting Session Preferences on page 57
Defines a SAS environment variable
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Values intended to represent files or paths must be valid under Windows
-SET SAS-variable " value " (" value-1 " <" value-n ">)
SET= SAS-variable " value " (" value-1 " <" value-n ">)
SAS-variable
specifies the environment variable to define.
value
specifies the value or set of values to assign to the environment variable. If value is a pathname that contain spaces, enclose value in quotation marks.
This is analogous to defining a Windows environment variable with the Windows SET command. One way to use the SET system option is to set up environment variables that represent commonly used external files. For example, the following code defines an environment variable for the sample source library:
-set sampsrc (!sasroot\base\sample !sasroot\stat\sample !sasroot\graph\sample)
When you refer to SAMPSRC as a library name during your SAS session, SAS automatically assigns the library with the directories listed. Note that ! sasroot is also a SAS environment variable that represents the root directory of your SAS installation, and is typically assigned in the SAS configuration file.
Environment variables can only be used as a libref if you use the SET system option at SAS invocation and not in an OPTIONS statement.
If you specify SET on the command line when you start SAS, the variable will be set only for that SAS session. To set an environment variable for repeated use, either add the SET system option to your configuration file or create a Windows environment variable.
Note: The words AUX, CON, NUL, LPT1 - LPT9, COM1 - COM9, and PRN are reserved words under Windows. Do not use CON or NUL as environment variable names.
Assigning SAS Libraries Using Environment Variables on page 128
Using Environment Variables on page 148
Activates the Scatter/Gather I/O feature
Default: NOSGIO
Valid in: configuration file, SAS invocation
Category: Files: SAS Files
PROC OPTIONS GROUP= SASFILES
Windows specifics: all
-SGIO -NOSGIO
SGIO
specifies to activate the scatter “read / gather “write feature. The scatter “read / gather “write feature remains active until your SAS session ends.
NOSGIO
specifies not to activate the scatter-read/gather-write feature.
The SGIO system option greatly improves I/O performance for SAS I/O files (data sets, catalogs, indexes, utility files, and other I/O files) when the PC has a large amount of RAM. Scatter-read / gather-write bypasses intermediate buffer transfers between memory and disk.
When SGIO is active, SAS uses the number of buffers that are specified by the BUFNO system option to transfer data between disk and RAM. I/O performance usually improves as the value for the BUFNO increases . Try different values of the BUFNO system option to tune each SAS job or DATA step.
The scatter-read / gather-write feature is active only for SAS I/O files that
contain a 4K-multiple pagesize (for example, 4096 or 8192) on 32 “bit systems
contain a 8K-multiple pagesize (for example, 8192 or 16384) on 64-bit systems
were not created by using Version 6 of SAS
are accessed sequentially.
If an I/O file does not meet these criteria, SGIO is inactive for that file even though the SGIO option is specified.
To use the SGIO system option on Windows NT, you must install Service Pack 4.
BUFNO System Option on page 490
SAS Features That Optimize Performance on page 205
Enables or disables the SLEEP window
Default: SLEEPWINDOW
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SLEEPWINDOW -NOSLEEPWINDOW
SLEEPWINDOW
specifies to display the SLEEP window.
NOSLEEPWINDOW
specifies not to display the SLEEP window.
The SLEEP window appears when the SLEEP function or the WAKEUP function suspends the execution of a DATA step. The SLEEP window displays the time that remains before the DATA step begins running.
SLEEP Function on page 409
WAKEUP Function on page 411
Specifies certain options for the SyncSort utility
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort : Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
-SORTANOM option(s)
SORTANOM= option(s)
option(s)
can be one or more of the following:
b
tells SyncSort to run in multi-call mode instead of single-call mode.
t
prints statistics about the sorting process in the SAS log.
v
prints all of the commands that are passed to the SyncSort utility in the SAS log.
Passing Options to SyncSort on page 438
The documentation for SyncSort for Windows
Specifies the number of observations above which SyncSort is used instead of the SAS sort program
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
-SORTCUT n n K n M n G hex X MIN MAX
SORTCUT= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the number of observations in multiples of 1 ( n ); 1,024 ( n K); 1,048,576 ( n M); and 1,073,741,824 ( n G), respectively. You can specify decimal values for n when it is used to specify a K, M, or G value. For example, a value of 8 specifies 8 observations, a value of .782k specifies 801 observations, and a value of 3m specifies 3,145,728 observations.
hex X
specifies the number of observations as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx specifies 45 observations.
MIN
specifies 0 observations.
MAX
specifies 2,147,483,647 observations.
When you specify SORTPGM=BEST and SAS determines that the database sort utility is not to be used, SAS uses the value of the SORTCUT and SORTCUTP options to determine whether to use SyncSort or the SAS sort. If the data set to be sorted is larger than the number of bytes (or kilobytes or megabytes) that you specify with SORTCUTP, SyncSort is used instead of the SAS sort program. The value that you specify must be less than or equal to 2,147,483,647 bytes. If both SORTCUT and SORTCUTP are either not defined or are set to 0, the SAS sort is used. If you specify both options and either condition is true, SAS uses SyncSort.
SORTCUTP System Option on page 553
SORTPGM System Option on page 555
Sorting Based on Size or Observations on page 437
Specifies the number of bytes above which SyncSort is used instead of the SAS sort program
Default:
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
-SORTCUTP n n K n M n G hex X MIN MAX
SORTCUTP= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the number of bytes in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); and 1,073,741,824 (gigabytes), respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the number of bytes as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx specifies 45 bytes.
MIN
specifies 0 bytes.
MAX
specifies 2,147,483,647 bytes.
When you specify SORTPGM=BEST and SAS determines that the database sort utility is not to be used, SAS uses the value of the SORTCUTP and SORTCUT options to determine whether to use SyncSort or the SAS sort. If the data set to be sorted is larger than the number of bytes (or kilobytes or megabytes) that you specify with SORTCUTP, SyncSort is used instead of the SAS sort program. The value that you specify must be less than or equal to 2,147,483,647 bytes. If both SORTCUTP and SORTCUT are either not defined or are set to 0, the SAS sort is used. If you specify both options and either condition is true, SAS uses SyncSort.
The following equation computes the number of bytes to be sorted:
number of bytes= ((length-of-obs) + (length-of-all-keys)) * number-of-obs
SORTPGM System Option on page 555
SORTCUT System Option on page 552
Sorting Based on Size or Observations on page 437
Specifies the pathname used for temporary files created by the SyncSort utility
Default: same location as -WORK, which is set in the configuration file
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
-SORTDEV " pathname "
SORTDEV =" pathname "
" pathname "
specifies a valid Windows pathname.
The SORTDEV option specifies an alternative pathname for temporary files created by the SyncSort utility. The pathname must be enclosed in quotation marks.
WORK System Option on page 574
Passing Parameters to SyncSort on page 438
Specifies parameters for the SyncSort utility
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
SORTPARM=" SyncSort-parameters "
-SORTPARM " SyncSort-parameters "
SyncSort-parameters
specifies any parameters that you want to pass to the SyncSort utility. Enclose SyncSort- parameters in quotation marks.
See the SyncSort for Windows documentation for a description of SyncSort- parameters .
Specifies the sort utility that is used in the SORT procedure
Default: BEST
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
PROC OPTIONS GROUP= SORT
Windows specifics: all
-SORTPGM SAS BEST HOST
SORTPGM = SAS BEST HOST
SAS
tells SAS to sort by using the SAS sort routine.
BEST
tells SAS to determine the best sort routine to sort the data: a database sort, the SAS sort, or SyncSort. When SAS determines that the sort is not to be done by the database, SAS looks at the values for both SORTCUT and SORTCUTP. If they both are set to zero, the SAS sort is used. If both options are set and either condition is met, SAS uses the SyncSort routine.
HOST
tells SAS to sort by using SyncSort for Windows.
SORT Procedure on page 435
SORTCUT System Option on page 552
SORTCUTP System Option on page 553
Limits the amount of memory available to the SORT procedure
Default: MAX
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Sort: Procedure options
System administration: Memory
PROC OPTIONS GROUP= MEMORY
SORT
Windows specifics: Default value
See: SORTSIZE System Option in SAS Language Reference: Dictionary
-SORTSIZE n n K n M n G hex X MIN MAX
SORTSIZE= n n K n M n G hex X MIN MAX
n n K n M n G
specifies the amount of memory in multiples of 1; 1,024 (kilobytes); 1,048,576 (megabytes); and 1,073,741,824 (gigabytes) respectively. You can specify decimal values for the number of kilobytes, megabytes, or gigabytes. For example, a value of 8 specifies 8 bytes, a value of .782k specifies 801 bytes, and a value of 3m specifies 3,145,728 bytes.
hex X
specifies the amount of memory as a hexadecimal value. You must specify the value beginning with a number (0 “9), followed by an X. For example, the value 2dx sets the amount of memory to 45 bytes.
MIN
specifies the minimum amount of memory available.
MAX
specifies the maximum amount of memory available.
By default, this option is set to the maximum amount of memory available. The SORTSIZE system option can reduce the amount of swapping SAS must do to sort the data set. If PROC SORT needs more memory than you specify, it creates a temporary utility file in your Saswork directory in which to store the data. The SORT procedure s algorithm can swap unneeded data more efficiently than Windows can.
SORT Procedure on page 435
Improving Performance of the SORT Procedure on page 206
Specifies whether to display the splash screen (logo screen) when SAS starts
Default: SPLASH
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SPLASH -NOSPLASH
-SPLASH ON -SPLASH OFF
SPLASH or SPLASH ON
specifies to display the logo screen when SAS initiates.
NOSPLASH or SPLASH OFF
specifies to not display the logo screen when SAS initiates.
The SPLASH system option displays the SAS logo screen when SAS initiates.
You can specify a custom splash screen to display with the SPLASHLOC system option.
SPLASHLOC System Option on page 558
Specifies the location of the splash screen bitmap that appears when SAS starts
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SPLASHLOC DLL-name < res-number > BMP-filename
DLL-name
specifies the dynamic link library (DLL) where your customized logo and copyright screen reside.
res-number
specifies the resource number connected with the dynamic link library (DLL) name.
BMP-filename
specifies the path and name of a stand-alone Windows bitmap (BMP) file to use as a splash screen.
You can create a bitmap resource (a customized logo and copyright screen) and build it into a dynamic link library (DLL). The DLL that you use must be 32-bit if you are running a 32 “bit version of SAS or it must be 64 “bit if you are running a 64 “bit version of SAS (that is, created using the libraries from the Microsoft Platform SDK). If you specify a DLL-name without a resource number ( res-number ), the default resource number is 1.
Alternatively, you can specify the path and name of a stand-alone Windows bitmap (BMP) file to use as a splash screen. The path must be a valid Windows pathname. If the pathname contains spaces, it must be enclosed in quotation marks.
Specifies the name of the issuer of the digital certificate that Secure Sockets Layer ( SSL ) should use
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Networking and encryption
PROC OPTIONS Group= COMMUNICATIONS
Windows specifics: all
SSLCERTISS issuer-of-digital-certificate
issuer-of-digital-certificate
specifies the name of the issuer of the digital certificate that should be used by SSL.
The SSLCERTISS option is used with the SSLCERTSERIAL option to uniquely identify a digital certificate from the Microsoft certificate store.
SSLCERTSERIAL System Option on page 559
SSLCERTSUBJ System Option on page 560
SSLCRLCHECK System Option on page 562
SSLCLIENTAUTH System Option on page 561
Appendix 3, Using SSL under Windows, on page 605
SAS/CONNECT User s Guide
Specifies the serial number of the digital certificate that Secure Sockets Layer (SSL) should use
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Networking and encryption
PROC OPTIONS Group= COMMUNICATIONS
Windows specifics: all
SSLCERTSERIAL serial-number
serial-number
specifies the serial number of the digital certificate that should be used by SSL.
The SSLCERTSERIAL options is used with SSLCERTISS option to uniquely identify a digital certificate from the Microsoft certificate store.
SSLCERTISS System Option on page 559
SSLCERTSUBJ System Option on page 560
SSLCLIENTAUTH System Option on page 561
SSLCRLCHECK System Option on page 562
Appendix 3, Using SSL under Windows, on page 605
SAS/CONNECT User s Guide
Specifies the subject name of the digital certificate that SSL should use
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Networking and encryption
PROC OPTIONS Group= COMMUNICATIONS
Windows specifics: all
SSLCERTSUBJ subject-name
subject-name
specifies the subject name of the digital certificate that SSL should use.
The subject name of the digital certificate is used to search for a digital certificate from the Microsoft certificate store.
SSLCERTISS System Option on page 559
SSLCERTSERIAL System Option on page 559
SSLCLIENTAUTH System Option on page 561
SSLCRLCHECK System Option on page 562
Appendix 3, Using SSL under Windows, on page 605
SAS/CONNECT User s Guide
Specifies whether a server should perform client authentication
Default: NOSSLCLIENTAUTH
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Networking and encryption
PROC OPTIONS GROUP= COMMUNICATIONS
Windows specifics: all
-SSLCLIENTAUTH -NOSSLCLIENTAUTH
SSLCLIENTAUTH NOSSLCLIENTAUTH
SSLCLIENTAUTH
specifies that the server should require SSL to provide client authentication.
NOSSLCLIENTAUTH
specifies that the server should not require SSL to provide client authentication.
Server authentication is always performed, but the SSLCLIENTAUTH option enables a user to control client authentication. This option is meaningful only when used on a server.
SSLCERTISS System Option on page 559
SSLCERTSERIAL System Option on page 559
SSLCERTSUBJ System Option on page 560
SSLCRLCHECK System Option on page 562
Appendix 3, Using SSL under Windows, on page 605
SAS/CONNECT User s Guide
Specifies whether Certificate Revocation Lists ( CRLs ) are checked when a digital certificate is validated
Default: NOSSLCRLCHECK
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Networking and encryption
PROC OPTIONS Group= COMMUNICATIONS
Windows specifics: all
-SSLCRLCHECK -NOSSLCRLCHECK
SSLCRLCHECK NOSSLCRLCHECK
SSLCRLCHECK NOSSLCRLCHECK
specifies that Certificate Revocation Lists are checked when digital certificates are validated.
NOSSLCRLCHECK
specifies that Certificate Revocation Lists are not checked when digital certificates are validated.
Certificate Revocation Lists (CRLs) are published by Certificate Authorities (CAs) and contain a list of revoked digital certificates. The list contains only the revoked digital certificates that were issued by that particular certificate authority. This option is relevant for servers only if client authentication is used. Because clients always check server digital certificates, this option is always relevant for clients .
SSLCERTISS System Option on page 559
SSLCERTSERIAL System Option on page 559
SSLCERTSUBJ System Option on page 560
SSLCLIENTAUTH System Option on page 561
Appendix 3, Using SSL under Windows, on page 605
SAS/CONNECT User s Guide
Specifies the format to use for displaying the time on STIMER output
Default: M
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: all
-STIMEFMT S M H SECONDS MINUTES HOURS
STIMEFMT=S M H SECONDS MINUTES HOURS
S, SECONDS
specifies that SAS software display the STIMER output as seconds .
M, MINUTES
specifies that SAS software display the STIMER output as minutes:seconds
H, HOURS
specifies that SAS software display the STIMER output as hours:minutes:seconds .
The STIMEFMT system option specifies the format to use to display STIMER output as either seconds , minutes:seconds , or hours:minutes:seconds .
Specifies whether to display time-elapsed statistics after each DATA step and procedure
Default: STIMER
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: Reported statistics
-STIMER -NOSTIMER
STIMER NOSTIMER
STIMER
specifies to write the statistics. When STIMER is in effect, SAS writes to the SAS log a list of computer resources used for each step and the entire SAS session.
NOSTIMER
specifies not to write performance statistics to the SAS log.
The STIMER system option prints to the SAS log the amount of time it took for SAS to complete a DATA step or procedure task.
The STIMER system option specifies whether a subset of all the performance statistics of your operating environment that are available to SAS are written to the SAS log. The FULLSTIMER system option specifies whether all of the available performance statistics are written to the SAS log.
FULLSTIMER System Option on page 505
The chapter on optimizing system performance in SAS Language Reference: Concepts .
Specifies a font to use for the button text and the descriptive text
Default: depends upon display settings
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-SYSGUIFONT " font-name " < font-size >
" font-name "
specifies the name of the font for text in screen and dialog box text elements. This must be a valid font name (for example, Times New Roman or Courier ) that matches the name of the font as it is installed on your system. The font-name must be enclosed in double quotation marks. This is a required argument.
font-size
specifies the font size to use for the window text. If you omit font-size , SAS uses the default.
The SYSGUIFONT system option controls the font size of the text for screen text and dialog box text elements. Use the FONT system option to change the fonts for the window contents. You might need to maximize the SAS window in order to allow space for large fonts to be readable.
FONT System Option on page 502
Selecting Fonts on page 57
Specifies a batch mode source file
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for file-specification
-SYSIN file-specification -NOSYSIN
SYSIN file-specification
specifies to start SAS and submit the file in batch mode. The value of file-specification must be a valid Windows filename.
NOSYSIN
specifies to start SAS in batch mode, but do not submit any files. This is useful for testing your SAS autoexec file; after your autoexec file is processed, SAS exits.
The SYSIN system option specifies a file containing a SAS program. This option indicates to SAS that you are executing in noninteractive mode and can be specified only in the SAS invocation.
Specifies a character string that can be passed to SAS programs
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values and syntax for characters
See: SYSPARM System Option in SAS Language Reference: Dictionary
-SYSPARM < > characters < >
SYSPARM=< > characters < >
characters
writes the character string in all uppercase.
characters
preserves the case of the character string.
The SYSPARM system option specifies a character string that can be passed to SAS programs.
The character string specified can be accessed in a SAS DATA step by the SYSPARM() function or anywhere in a SAS program by using the automatic macro variable referenced by &SYSPARM.
Specifies a destination printer for printing SAS output
Default: Default system printer
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: Procedure output
PROC OPTIONS GROUP= LISTCONTROL
Windows specifics: all
-SYSPRINT printer-name < destination >
SYSPRINT= printer-name < destination >
printer-name
specifies the name of the printer as it is installed under Windows (for example, Charlie s HP LaserJet ). You can find the list of installed printers on your system by selecting the Printers item in the Windows Control Panel. The printer-name must be enclosed in double quotation marks.
destination
optionally specifies a file name to write the print file to disk. If specified, then all printer output generated by SAS is routed to this file, overwriting any existing file with the same name. Even though the output is not sent directly to a printer, it is still formatted using the printer driver associated with printer-name . The destination must be enclosed in double quotation marks.
The SYSPRINT system option specifies the destination of a printer where you want to print your SAS output.
If you select a different printer by using the Print Setup dialog box, the value of the SYSPRINT system option (shown by PROC OPTIONS) reflects that selection.
If you do not specify the SYSPRINT system option or the PRTPERSISTDEFAULT system option, the printer-name and destination arguments use the default system printer value.
If PRTPERSISTDEFAULT is specified when SAS starts, the value of SYSPRINT persists from SAS session to SAS session. If both SYSPRINT and PRTPERSISTDEFAULT are specified when SAS starts, the value of SYSPRINT is the printer specified by SYSPRINT.
CAUTION:
Modifying print options by using the Windows printing dialog boxes may change the values of SAS printing system options If you set printing options using SAS system options such as SYSPRINT, and then use the Windows printing dialogs to set printing options, the SAS system options are set to the values specified in the Windows print dialog boxes.
Printing on page 166
PRTPERSISTDEFAULT System Option on page 536
SYSPRINTFONT System Option on page 567
Sets the font to use when SAS is printing to the current default printer
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Log and procedure output control: Procedure output
PROC OPTIONS GROUP= LISTCONTROL
Windows specifics: all
See: SYSPRINTFONT System Option in SAS Language Reference: Dictionary
-SYSPRINTFONT ( font-name <BOLD NORMAL><REGULAR ITALIC>< character-set >< point-size > <NAMED printer-name DEFAULT ALL>)
SYSPRINTFONT= font-name <BOLD NORMAL><REGULAR ITALIC>< character-set >< point-size > <NAMED printer-name DEFAULT ALL>
font-name
specifies the name of the font to use for printing. This must be a valid font name (for example, SAS Monospace or Courier ) that matches the name of the font as it is installed on your system. The font-name must be enclosed in double quotation marks. This is a required argument.
BOLD NORMAL
specifies the weight of the font. The default is NORMAL.
REGULAR ITALIC
specifies the style of the font. The default is REGULAR.
character-set
specifies the character set to use for printing. The default is Windows . Valid values are Western, Central European, Cyrillic, Greek, Turkish, Arabic, Baltic, and Thai. If the font does not support the specified character set, the default character set is used. If the default character set is not supported by the font, the font s default character set is used.
point-size
specifies the point size to use for printing. This must be an integer from 1 to 7200, inclusive. If you omit this argument, SAS uses 10 points.
NAMED printer-name
updates the font information for the named printer in the Sasuser.Profile2 catalog. The printer name must exactly match the name shown in the Print Setup dialog box (except that the printer name is not case sensitive). The printer-name must be enclosed in double quotation marks. This keyword is optional.
DEFAULT
specifies the default font information for the printer used by the -SYSPRINT system option in the Sasuser.Profile2 catalog.
ALL
updates the font information for all installed printers in the Sasuser.Profile2 catalog. This keyword is optional.
The SYSPRINTFONT system option sets the font to use when SAS is printing to the current default printer (which might be specified in the SYSPRINT system option) or to the printer identified with the optional keywords NAMED or ALL. This information is stored in the Sasuser.Profile2 catalog.
Enclose the SYSPRINTFONT option arguments in parenthesis when you specify the option in a configuration file, on the command line, or in the SAS System Options window. Parenthesis are not required if you specify the SYSPRINTFONT system option in the OPTIONS statement.
If you use SYSPRINTFONT with either the DEFAULT or no keyword and later use the SYSPRINT system option or the Print Setup dialog box to change the current default printer, then the font used with the current default printer will be
The font specified in Sasuser.Profile2 for the given printer, if any.
The font specified with SYSPRINTFONT, if the specified font exists on the printer.
If there is no font defined for the printer in Sasuser.Profile2, and SYSPRINTFONT doesn t specify a valid font for the printer, and the current display font is scalable, then SAS will use the display font to print.
If the current display font is not scalable, SAS will use 10-point SAS Monospace.
If the SAS Monospace font is not available, SAS will use the printer s default font to print.
This example specifies to use the 12-point SAS Monospace font on the default printer:
-sysprintfont ("SAS Monospace" 12)
This example specifies to use 10-point Courier New on the printer named HP LaserJet IIIsi Postscript, attached to LPT1:. Note that the name given for the printer is how it appears in the Print Setup dialog box in SAS:
-sysprintfont ("Courier New" named "HP LaserJet IIIsi Postscript on LPT1:")
SYSPRINT System Option on page 566
Specifies the Toolbox display location
Default: TOP RIGHT
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-TOOLDEF TOP CENTER BOTTOM <LEFT CENTER RIGHT>
TOP CENTER BOTTOM
specifies the vertical position of the Toolbox. The default value is TOP.
LEFT CENTER RIGHT
specifies the horizontal position of the Toolbox. The default value is RIGHT.
The TOOLDEF system option specifies where the Toolbox is located within your display when it is viewable.
You must specify a vertical position first. You do not have to specify a horizontal position, but if you omit it, RIGHT is used.
Note: The Toolbox is positioned with respect to your entire display, not to the main SAS window. This option has no effect if you are using the tool bar instead of the Toolbox.
Customizing a Toolbar on page 67
Using the Toolbar to Issue Commands on page 39
Enables the universal print commands in the File menu
Default: NOUPRINTMENUSWITCH
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: ODS printing
PROC OPTIONS GROUP= ODSPRINT
Windows specifics: all
-UPRINTMENUSWITCH -NOUPRINTMENUSWITCH
UPRINTMENUSWITCH
specifies that the print commands in the File menu invoke the Universal Printing dialog boxes.
NOUPRINTMENUSWITCH
specifies that the print commands in the File menu will invoke the Windows dialog boxes.
To enable the Universal Printing menus and dialog boxes, you must specify both the UNIVERSALPRINT system option and the UPRINTMENUSWITCH system option when you start SAS. Specifying the UPRINTMENUSWITCH option without specifying the UNIVERSALPRINT option will not invoke the Universal Printing menus and dialog boxes.
Introduction to Printing in SAS within the Windows Environment on page 166
Specifies the name of the default permanent SAS data library
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for library-specification
See: USER System Option in SAS Language Reference: Dictionary
-USER library-specification
USER= library-specification
library-specification
specifies the default libref, an environment variable, or Windows pathname in which to store data sets that are created during a SAS session. Remember that a pathname is only to the directory or subdirectory level. The value of library-specification must resolve to a valid Windows pathname.
When you specify the USER system option, any data set that you create with a one-level name will be permanently stored in the specified library. If you want to create a temporary data set, use a two-level name for the data set, with the first part being Work (for example, work.tempdata ).
Specifies the pathname of the resource file associated with your user-defined icon
Default: none
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-USERICON icon-resource-filename number-of-icons
icon-resource-filename
specifies the fully qualified Windows pathname of the resource file associated with your user-defined icons. If the pathname contains spaces, it must be enclosed in quotation marks.
number-of-icons
specifies the maximum number of icons stored in the resource file that you specified.
The USERICON system option specifies the fully qualified Windows pathname of the resource file associated with your icons, along with the maximum number of icons stored in the resource file that you specified.
The icon resource file must be compiled using the Win32 Software Development Kit (SDK). For more information, refer to the SDK documentation. User-defined icons can be incorporated into applications developed with SAS/AF or SAS/EIS software.
The following USERICON system option specifies 10 icons that are stored in C:\MYSTUFF\MYICONS.DLL:
-usericon c:\mystuff\myicons.dll 10
Controls whether SAS writes the settings of all the system options specified in the configuration file to either the terminal or the batch log
Default: NOVERBOSE
Valid in: configuration file, SAS invocation
Category: Log and procedure output control: SAS log
PROC OPTIONS GROUP= LOGCONTROL
Windows specifics: Amount of information reported
-VERBOSE -NOVERBOSE
VERBOSE
specifies to write the settings of the system options to the log.
NOVERBOSE
specifies not to write the settings of the system options to the log. This is the default.
The VERBOSE system option writes the settings of SAS system options that were set at SAS invocation either on the command line or as part of the configuration file. If you invoke SAS at a terminal, the settings are displayed at the terminal. If you invoke SAS as a part of a batch job, the settings are written to the batch log. You cannot change the settings of the SAS system options with the VERBOSE system option.
The VERBOSE system option is a good error diagnostic tool. If you receive an error message when you invoke SAS, you can use this option to see if you have an error in your system option specifications.
Specifies to enable web enhancements
Default: NOWEBUI
Valid in: configuration file, SAS invocation
Category: Input control: Data processing
PROC OPTIONS GROUP= INPUTCONTROL
Windows specifics: all
-WEBUI -NOWEBUI
WEBUI
specifies to enable web enhancements.
NOWEBUI
specifies to disable web enhancements.
If you have installed Microsoft Internet Explorer 5.0 (IE) or later and specify the WEBUI system option, certain windows, such as the SAS Explorer window, work like an IE Web page where pointing to an object with the mouse selects the object and a single mouse-click invokes the object s default action.
To select a range of objects, press and hold down the SHIFT key, and point to the first and last objects in the group.
To select multiple items, press and hold down the CTRL key, and point to individual items in the group.
Specifies to include or suppress the Window menu in windows that display menus
Default: NOWINDOWSMENU
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-WINDOWSMENU -NOWINDOWSMENU
WINDOWSMENU NOWINDOWSMENU
WINDOWSMENU
specifies to include the Window menu in the main menu if the NOAWSMENUMERGE system option is specified.
NOWINDOWSMENU
specifies to suppress the Window menu in the main menu if the NOAWSMENUMERGE system option is specified.
The WINDOWSMENU system option is valid only if the NOAWSMENUMERGE system option is specified.
AWSMENUMERGE System Option on page 488
Specifies the pathname for the directory containing the Work data library
Default: !TEMP\SAS Temporary Files
Valid in: configuration file, SAS invocation
Category: Environment control: Files
PROC OPTIONS GROUP= ENVFILES
Windows specifics: Valid values for library-specification
See: WORK System Option in SAS Language Reference: Dictionary
-WORK library-specification
library-specification
specifies an environment variable or a Windows pathname. Remember that a pathname is only to the directory or subdirectory level. The value of library-specification must resolve to a valid Windows pathname. The library-specification must be enclosed in double quotation marks.
The default SAS configuration file creates the Work data library in a folder named SAS Temporary Files located in your system s designated temporary area (as specified by the TEMP environment variable).
SAS creates a subdirectory called TD nnnnn for each SAS process under the directory you specify in the WORK option, where nnnnn is a unique number.
Work Data Library on page 21
Specifies that the X command is valid in the current SAS session
Default: XCMD
Valid in: configuration file, SAS invocation
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-XCMD -NOXCMD
“XCMD ON “XCMD OFF
XCMD or XCMD ON
specifies to allow the X command to be valid in the current SAS session.
NOXCMD or XCMD OFF
specifies not to allow the X command to be valid in the current SAS session.
The XCMD allows the X command to be active in the current SAS session.
X Command on page 372
Specifies to open the application specified in the X command in a minimized state or in the
default active state.
Default: NOXMIN
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-XMIN -NOXMIN
XMIN NOXMIN
XMIN
specifies to start the application specified in the X command in a minimized state.
NOXMIN
specifies to start the application specified in the X command in the default active state.
The XMIN system option allows you to open an application specified in the X command in a minimized state or in the default active state.
Controls whether an X command or statement executes synchronously or asynchronously
Default: XSYNC
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-XSYNC -NOXSYNC
XSYNC NOXSYNC
XSYNC
specifies that the operating system command execute synchronously with your SAS session. That is, control is not returned to SAS until the command has completed. You cannot return to your SAS session until the process spawned by the X command or statement is closed. This is the default.
NOXSYNC
specifies that the operating system command execute asynchronously with your SAS session. That is, control is returned immediately to SAS and the command continues executing without interfering with your SAS session. With NOXSYNC in effect, you can execute an X command or X statement and return to your SAS session without closing the process spawned by the X command or X statement.
The value of the XSYNC system option affects the execution of the following:
X statement
X command
CALL SYSTEM routine
%SYSEXEC statement.
Running Windows or MS-DOS Commands from within SAS on page 25
XWAIT System Option on page 577
X Statement on page 462
X Command on page 372
CALL SYSTEM Routine on page 387
Macro Statements on page 583
Specifies whether you have to type EXIT at the DOS prompt before the DOS shell closes
Default: XWAIT
Valid in: configuration file, SAS invocation, OPTIONS statement
Category: Environment control: Display
PROC OPTIONS GROUP= ENVDISPLAY
Windows specifics: all
-XWAIT -NOXWAIT
XWAIT NOXWAIT
XWAIT
specifies that you must type EXIT to return to your SAS session. This is the default.
NOXWAIT
specifies that the command processor automatically returns to the SAS session after the specified command is executed. You do not have to type EXIT.
The XWAIT system option does not affect Windows applications, such as Excel. It only applies to applications that execute in a Command Prompt window.
The XWAIT system option affects the Command Prompt window started by any of the following:
X statement
X command
CALL SYSTEM routine
%SYSEXEC statement.
Running Windows or MS-DOS Commands from within SAS on page 25
XSYNC System Option on page 576
X Statement on page 462
X Command on page 372
CALL SYSTEM Routine on page 387
Macro Statements on page 583