Chapter 30: The OPTIONS Procedure


Overview: OPTIONS Procedure

What Does the OPTIONS Procedure Do?

The OPTIONS procedure lists the current settings of SAS system options. The results are displayed in the SAS log.

SAS system options control how the SAS System formats output, handles files, processes data sets, interacts with the operating environment, and does other tasks that are not specific to a single SAS program or data set. You can change the settings of

  • SAS system options

  • in the SAS command

  • in a configuration or autoexec file

  • in the SAS OPTIONS statement

  • by using the OPTLOAD and OPTSAVE procedures

  • through the SAS System Options window

  • in other ways, depending on your operating environment. See the companion for your operating environment for details.

For information about SAS system options, see the section on SAS system options in SAS Language Reference: Dictionary .

What Types of Output Does PROC OPTIONS Produce?

The log that results from running PROC OPTIONS can show both the portable and host system options, their settings, and short descriptions.

The following example shows a partial log that displays the settings of portable options.

 proc options;  run; 
Output 30.1: Log Showing a Partial Listing of SAS System Options
start example
 Portable Options:   APPLETLOC=(system-specific pathname)                     Location of Java applets   ARMAGENT =        ARM Agent to use to collect ARM records   ARMLOC=ARMLOC.LOG Identify location where ARM records are to be written   ARMSUBSYS=(ARM_NONE)                     Enable/Disable ARMing of SAS subsystems   NOASYNCHIO        Do not enable asynchronous input/output   AUTOSAVELOC=      Identifies the location where program editor contents are                     auto saved   NOAUTOSIGNON      SAS/CONNECT remote submit will not automatically attempt                     to SIGNON   NOBATCH           Do not use the batch set of default values for SAS system                     options   BINDING=DEFAULT   Controls the binding edge for duplexed output   BOTTOMMARGIN=0.000                     Bottom margin for printed output   BUFNO=1           Number of buffers for each SAS data set   BUFSIZE=0         Size of buffer for page of SAS data set   BYERR             Set the error flag if a null data set is input to the SORT                     procedure   BYLINE            Print the by-line at the beginning of each by-group   BYSORTED R        equire SAS data set observations to be sorted for BY                     processing   NOCAPS            Do not translate source input to uppercase   NOCARDIMAGE       Do not process SAS source and data lines as 80-byte records   CATCACHE=0        Number of SAS catalogs to keep in cache memory   CBUFNO=0          Number of buffers to use for each SAS catalog   CENTER            Center SAS procedure output   NOCHARCODE        Do not use character combinations as substitute for                     special characters not on the keyboard   CLEANUP           Attempt recovery from out-of-resources condition   NOCMDMAC          Do not support command-style macros   CPMLIB=           Identify previously compiled libraries of CMP subroutines                     to use when linking   CMPOPT=(NOEXTRAMATH NOMISSCHECK NOPRECISE NOGUARDCHECK)              Enable SAS compiler performance optimizations   NOCOLLATE         Do not collate multiple copies of printed output   COLORPRINTING     Print in color if printer supports color   COMAMID=TCP       Specifies the communication access method to be used for                     SAS distributed products   COMPRESS=NO       Specifies whether to compress observations in output SAS                     data sets 
end example
 

To view the setting of a particular option, you can use the option parameter on PROC OPTIONS. The following example shows a log that PROC OPTIONS produces for a single SAS system option.

 options pagesize=60;  proc options option=pagesize;  run; 
Output 30.2: The Setting of a Single SAS System Option
start example
 25  options pagesize=60;  26  proc options option=pagesize;  27  run;     SAS (r) Proprietary Software Release XXX  PAGESIZE=60      Number of lines printed per page of output 
end example
 

Displaying the Settings of a Group of Options

You can display the settings of a group of SAS system options that have a specific functionality, such as error handling, by using the GROUP= option.

 proc options group=errorhandling;  run; 
Output 30.3: Sample Output Using the GROUP= Option
start example
 6   proc options group=errorhandling;  7   run;     SAS (r) Proprietary Software Release XXX   BYERR             Set the error flag if a null data set is input to the SORT                     procedure   CLEANUP           Attempt recovery from out-of-resources condition   NODMSSYNCHK       Do not enable syntax check, in windowing mode, for a                     submitted statement block   DSNFERR           Generate error when SAS data set not found condition occurs   NOERRORABEND      Do not abend on error conditions   NOERRORBYABEND    Do not abend on By-group error condition   ERRORCHECK=NORMAL Level of special error processing to be performed   ERRORS=20         Maximum number of observations for which complete error                     messages are printed   FMTERR            Treat missing format or informat as an error   QUOTELENMAX       Enable warning for quoted string length max   VNFERR            Treat variable not found on _NULL_ SAS data set as an error 
end example
 

The following table lists the values that are available when you use the GROUP= option with PROC OPTIONS.

Values for Use with GROUP=

COMMUNICATIONS

GRAPHICS

MACRO

DATAQUALITY

HELP

MEMORY

EMAIL

INPUTCONTROL

META

ENVDISPLAY

INSTALL

ODSPRINT

ENVFILES

LANGUAGECONTROL

PERFORMANCE

ERRORHANDLING

LISTCONTROL

SASFILES

EXECMODES

LOG_LISTCONTROL

SORT

EXTFILES

LOGCONTROL

 

The following table lists operating environment “specific values that might be available when you use the GROUP= option with PROC OPTIONS.

Possible Operating Environment “Specific Values for Use with GROUP=

ADABAS

IDMS

ORACLE

DATACOM

IMS

REXX

DB2

ISPF

 

Operating Environment Information: Refer to the SAS documentation for your operating environment for more information about these host-specific options.




Base SAS 9.1.3 Procedures Guide (Vol. 1)
Base SAS 9.1 Procedures Guide, Volumes 1, 2, 3 and 4
ISBN: 1590472047
EAN: 2147483647
Year: 2004
Pages: 260

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net