Summary of System Options for Windows

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

Options Not Applicable to the Windows Environment

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.

ACCESSIBILITY System Option

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

Syntax

-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.

Details

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.

ALTLOG System Option

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

Syntax

-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.

Details

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.

ALTPRINT System Option

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

Syntax

-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.

Details

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.

AUTHSERVER System Option

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

Syntax

-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.

Details

The AUTHSERVER system option specifies which servers to search to validate user logins.

Comparisons

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.

AUTOEXEC System Option

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

Syntax

-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.

Details

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.

AWSCONTROL System Option

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

Syntax

-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.

Details

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.

AWSDEF System Option

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

Syntax

-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.

Details

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.

AWSMENU System Option

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

Syntax

-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.

Details

The AWSMENU system option is intended for use by SAS/AF programmers to customize the interface of their applications.

AWSMENUMERGE System Option

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

Syntax

-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.

Details

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.

AWSTITLE System Option

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

Syntax

-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.

Details

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.

BUFNO System Option

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

Syntax

-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.

Details

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

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

Syntax

-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.

Details

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.

CATCACHE System Option

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

Syntax

-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.

Details

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.

CLEANUP System Option

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

Syntax

-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.

Details

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.

COMDEF System Option

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

Syntax

-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.

Details

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.

CONFIG System Option

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

Syntax

-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.

Details

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.

DBCS System Option

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

DBCSLANG System Option

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

DBCSTYPE System Option

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

DEVICE System Option

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

Syntax

-DEVICE device-driver-name

DEVICE= device-driver-name

device-driver-name

specifies the name of a device driver for graphics output.

Details

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.

ECHO System Option

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

Syntax

-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.

Details

Messages that result from errors in the autoexec file are printed in the SAS log regardless of how the ECHO system option is set.

Example

For example, you can specify the following:

 -echo "SAS System under Windows         is initializing."

The message appears in the LOG window as SAS initializes.

EMAILDLG System Option

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

Syntax

-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.

Details

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.

EMAILSYS System Option

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

Syntax

-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.

Details

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.

ENCODING System Option

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

ENGINE System Option

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

Syntax

-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.

Details

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.

ENHANCEDEDITOR System Option

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

Syntax

-ENHANCEDEDITOR -NOENHANCEDEDITOR

ENHANCEDEDITOR

specifies to enable the Enhanced Editor during SAS invocation.

NOENHANCEDEDITOR

specifies not to enable the Enhanced Editor during SAS invocation.

Details

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.

FILTERLIST System Option

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

Syntax

-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.

Details

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.

FONT System Option

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

Syntax

-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.

Details

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.

FONTALIAS System Option

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

Syntax

-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.

Details

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

Example

The system option -fontalias "Times" "Courier New" tells SAS to use Courier New wherever the Times SAS font is requested .

FONTSLOC System Option

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

Syntax

-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.

Details

The directory must be a valid Windows pathname.

FORMCHAR System Option

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

Syntax

-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.

Details

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.

FULLSTIMER 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

Syntax

-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.

Details

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

Comparisons

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.

GISMAPS System Option

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

Syntax

-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.

HELPINDEX System Option

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

Syntax

-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.

Details

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

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

Syntax

-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.

Details

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")

HELPREGISTER System Option

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

Syntax

-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.

Details

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.

Examples

Example 1: HTML Pages and URLs

 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

Example 2: HTML Help Files (.CHM)

 sas -helpregister ''My CHM file'' \server\share\HelpStuff.chm .      ''InternalFile.htm''  sas -helpregister ''SAS Windows Companion'' host.chm .      ''/host.hlp/chostfutil.htm''

Example 3: WinHelp Files (.HLP)

 sas -helpregister ''A WinHelp File'' c:\somefile.hlp      ''simply an .hlp file''  sas -helpregister ''WinHelp with a Topic'' c:\somefile.hlp .      ''My Topic''

HELPTOC System Option

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

Syntax

-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.

Details

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 .

HOSTPRINT System Option

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

Syntax

-HOSTPRINT -NOHOSTPRINT

HOSTPRINT NOHOSTPRINT

HOSTPRINT

specifies to use Windows printing. This is the default.

NOHOSTPRINT

specifies to use SAS forms for printing.

Details

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.

ICON System Option

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

Syntax

-ICON -NOICON

ICON NOICON

ICON

specifies to minimize the main SAS window immediately.

NOICON

restores the main SAS window immediately.

Details

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

INITSTMT System Option

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

Syntax

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.

JREOPTIONS System Option

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

Syntax

-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.

Details

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.

Examples

-jreoptions (-verbose)

  -jreoptions (-Djava.class.path= "c:\my   java\classes\myclasses.jar";c:\java2\classes2\classes2.jar   -oss600k)

LINESIZE System Option

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

Syntax

-LINESIZE n MIN MAX

LINESIZE= n MIN MAX

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.

Details

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.

LOADMEMSIZE 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

Syntax

-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.

Details

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.

LOCALE System Option

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

LOG System Option

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

Syntax

-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.

Details

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.

MAPS System Option

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

Syntax

-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.

MAXMEMQUERY System Option

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

Syntax

-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.

Details

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.

MEMBLKSZ System Option

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

Syntax

-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.

Details

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.

MEMCACHE System Option

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

Syntax

-MEMCACHE 0 1 4

MEMCACHE= 0 1 4

specifies memory cache is off.

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.

specifies memory cache is on. Memory is used as a SAS file cache.

Details

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.

MEMLIB System Option

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

Syntax

-MEMLIB -NOMEMLIB

MEMLIB

specifies to use memory for the Work libraries.

NOMEMLIB

specifies not to use memory.

Details

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.

MEMMAXSZ System Option

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

Syntax

-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.

Details

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.

MEMSIZE System Option

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

Syntax

-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.

Details

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.

MSG System Option

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

Syntax

-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.

Details

The MSG system option specifies the name of the library for SAS error messages.

MSGCASE System Option

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

Syntax

-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.

Details

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.

MSYMTABMAX System Option

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

Syntax

-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.

Details

After the MSYMTABMAX value is reached, SAS writes any additional macro variables to disk.

MVARSIZE System Option

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

Syntax

-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.

Details

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.

NEWS System Option

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

Syntax

-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.

Details

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.

NLSCOMPATMODE System Option

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

NUMKEYS System Option

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

Syntax

-NUMKEYS number-of-keys

number-of-keys

specifies the number of active keyboard function keys.

Details

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.

Example

If you specify the following system option, SAS displays 10 function keys in the KEYS window:

 -numkeys 10

NUMMOUSEKEYS System Option

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

Syntax

-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.

Details

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.

OBS System Option

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

Syntax

-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.

PAGENO System Option

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

Syntax

-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.

Details

The PAGENO system option specifies a beginning page number for the next page of output that SAS produces.

PAGESIZE System Option

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

Syntax

-PAGESIZE n MIN MAX

PAGESIZE= n MIN MAX

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.

Details

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.

PAPERTYPE System Option

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

Syntax

-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.

Details

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.

PATH System Option

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

Syntax

-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.

Details

You can specify multiple PATH system options to define a search order.

PFKEY System Option

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

Syntax

-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.

Details

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..

PRINT System Option

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

Syntax

-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.

Details

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.

PRTABORTDLGS System Option

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

Syntax

-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.

Details

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.

PRTPERSISTDEFAULT System Option

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

Syntax

-PRTPERSISTDEFAULT -NOPRTPERSISTDEFAULT

PRTPERSISTDEFAULT

specifies to use the same destination printer from SAS session to SAS session.

NOPRTPERSISTDEFAULT

specifies to use the default printer.

Details

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.

PRTSETFORMS System Option

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

Syntax

-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.

Details

Use the NOPRTSETFORMS system option to suppress the Use Forms check box in the Print Setup dialog box.

REALMEMSIZE System Option

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

Syntax

-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.

Details

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.

REGISTER System Option

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

Syntax

-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.

Details

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.

RESOURCESLOC System Option

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

Syntax

-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.

Details

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.

RSASUSER System Option

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

Syntax

-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.

Details

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.

RTRACE System Option

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

Syntax

-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.

Details

Use the RTRACE and the RTRACELOC system options to create a file that lists the resources SAS uses.

RTRACELOC System Option

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

Syntax

-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.

Details

You can use the RTRACELOC and the RTRACE system options to determine which resources SAS uses.

S System Option

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

Syntax

-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.

Details

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

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

Syntax

-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

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.

Details

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.

SASAUTOS System Option

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

Syntax

-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.

Details

The SASAUTOS system option specifies the SAS autocall macro library or libraries.

SASCONTROL System Option

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

Syntax

-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.

Details

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.

SASHELP System Option

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

Syntax

-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.

Details

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.

SASINITIALFOLDER System Option

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

Syntax

-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.

Details

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.

SASUSER System Option

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

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.

Details

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.

SCROLLBARFLASH System Option

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

Syntax

-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.

Details

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 .

SET System Option

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

Syntax

-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.

Details

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.

SGIO System Option

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

Syntax

-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.

Details

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.

SLEEPWINDOW System Option

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

Syntax

-SLEEPWINDOW -NOSLEEPWINDOW

SLEEPWINDOW

specifies to display the SLEEP window.

NOSLEEPWINDOW

specifies not to display the SLEEP window.

Details

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.

SORTANOM System Option

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

Syntax

-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.

SORTCUT System Option

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

Syntax

-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.

Details

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

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

Syntax

-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.

Details

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

SORTDEV System Option

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

Syntax

-SORTDEV " pathname "

SORTDEV =" pathname "

" pathname "

specifies a valid Windows pathname.

Details

The SORTDEV option specifies an alternative pathname for temporary files created by the SyncSort utility. The pathname must be enclosed in quotation marks.

SORTPARM System Option

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

Syntax

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.

Details

See the SyncSort for Windows documentation for a description of SyncSort- parameters .

SORTPGM System Option

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

Syntax

-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.

SORTSIZE System Option

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

Syntax

-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.

Details

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.

SPLASH System Option

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

Syntax

-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.

Details

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

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

Syntax

-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.

Details

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.

SSLCERTISS System Option

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

Syntax

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.

Details

The SSLCERTISS option is used with the SSLCERTSERIAL option to uniquely identify a digital certificate from the Microsoft certificate store.

SSLCERTSERIAL System Option

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

Syntax

SSLCERTSERIAL serial-number

serial-number

specifies the serial number of the digital certificate that should be used by SSL.

Details

The SSLCERTSERIAL options is used with SSLCERTISS option to uniquely identify a digital certificate from the Microsoft certificate store.

SSLCERTSUBJ System Option

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

Syntax

SSLCERTSUBJ subject-name

subject-name

specifies the subject name of the digital certificate that SSL should use.

Details

The subject name of the digital certificate is used to search for a digital certificate from the Microsoft certificate store.

SSLCLIENTAUTH System Option

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

Syntax

-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.

Details

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.

SSLCRLCHECK System Option

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

Syntax

-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.

Details

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 .

STIMEFMT System Option

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

Syntax

-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 .

Details

The STIMEFMT system option specifies the format to use to display STIMER output as either seconds , minutes:seconds , or hours:minutes:seconds .

STIMER System Option

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

Syntax

-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.

Details

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.

Comparisons

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.

SYSGUIFONT System Option

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

Syntax

-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.

Details

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.

SYSIN System Option

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

Syntax

-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.

Details

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.

SYSPARM System Option

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

Syntax

-SYSPARM < > characters < >

SYSPARM=< > characters < >

characters

writes the character string in all uppercase.

characters

preserves the case of the character string.

Details

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.

SYSPRINT System Option

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

Syntax

-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.

Details

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.

SYSPRINTFONT System Option

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

Syntax

-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.

Details

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.

Examples

Example 1: Specifying a Font to the Default Printer

This example specifies to use the 12-point SAS Monospace font on the default printer:

 -sysprintfont ("SAS Monospace" 12)

Example 2: Specifying a Font to a Named Printer

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:")

TOOLDEF System Option

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

Syntax

-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.

Details

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.

UPRINTMENUSWITCH System Option

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

Syntax

-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.

Details

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.

USER System Option

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

Syntax

-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.

Details

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 ).

USERICON System Option

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

Syntax

-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.

Details

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.

Example

The following USERICON system option specifies 10 icons that are stored in C:\MYSTUFF\MYICONS.DLL:

 -usericon c:\mystuff\myicons.dll 10

VERBOSE System Option

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

Syntax

-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.

Details

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.

WEBUI System Option

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

Syntax

-WEBUI -NOWEBUI

WEBUI

specifies to enable web enhancements.

NOWEBUI

specifies to disable web enhancements.

Details

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.

WINDOWSMENU System Option

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

Syntax

-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.

Details

The WINDOWSMENU system option is valid only if the NOAWSMENUMERGE system option is specified.

WORK System Option

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

Syntax

-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.

Details

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.

XCMD System Option

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

Syntax

-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.

Details

The XCMD allows the X command to be active in the current SAS session.

XMIN System Option

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

Syntax

-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.

Details

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.

XSYNC System Option

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

Syntax

-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.

Details

The value of the XSYNC system option affects the execution of the following:

X statement
X command
CALL SYSTEM routine
%SYSEXEC statement.

XWAIT System Option

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

Syntax

-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.

Details

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.

Summary of System Options for Windows