44
PROC OPTIONS
GROUP=
SASFILES, PERFORMANCE
Default:
1
Windows
specifics:
Default value
See:
“BUFNO= System Option” in SAS System Options: Reference
Syntax
-BUFNO n | nK | nM | nG | hexX | MIN | MAX
BUFNO= n | nK | nM | nG | hexX | MIN | MAX
System Arguments
n | nK | nM | nG
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 nM option or specify MAX.
hexX
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.
See Also
• “BUFSIZE System Option: Windows” on page 506
• “Optimizing System Performance” in SAS Language Reference: Concepts
BUFNO System Option: Windows
505
44
BUFSIZE System Option: Windows
Specifies the permanent buffer page size for output SAS data sets.
Valid in:
configuration file, SAS invocation, OPTIONS statement, SAS System Options
window
Category:
Files: SAS Files
PROC OPTIONS
GROUP=
SASFILES, PERFORMANCE
Default:
0
Windows
specifics:
Valid values for n
See:
“BUFNO= System Option” in SAS System Options: Reference
Syntax
-BUFSIZE n | nK | nM | nG | hexX | MAX
BUFSIZE=n | nK | nM | nG | hexX | MAX
Required Arguments
n | nK | nM | nG
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.
hexX
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.
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 select a value depending on the size of the observation.
Experienced users might 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.
See Also
“BUFNO System Option: Windows” on page 504
506
Chapter 22 • SAS System Options under Windows
45
CATCACHE System Option: Windows
Specifies the number of SAS catalogs to keep open.
Valid in:
configuration file, SAS invocation
Category:
Files: SAS Files
PROC OPTIONS
GROUP=
SASFILES
Default:
0
Windows
specifics:
Valid values for n
See:
“CATCACHE= System Option” in SAS System Options: Reference
Syntax
-CATCACHE n | nK | MIN | MAX
Required Arguments
n | nK
specifies the number of open-file descriptors to keep in cache memory in multiples
of 1 (n) or 1,024 (nK). 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: Windows
Specifies how to handle an out-of-resource condition.
Valid in:
configuration file, SAS invocation, OPTIONS statement, SAS System Options
window
Category:
Environment Control: Error Handling
CLEANUP System Option: Windows
507
50
PROC OPTIONS
GROUP=
ERRORHANDLING
Default:
CLEANUP
Windows
specifics:
behavior when running in batch mode
See:
“CLEANUP System Option” in SAS System Options: Reference
Syntax
-CLEANUP | -NOCLEANUP
CLEANUP | NOCLEANUP
Required Arguments
CLEANUP
specifies that during the entire session, SAS attempts to perform automatic,
continuous cleanup of resources that are not essential for execution. Nonessential
resources include those resources that are not visible to the user (for example, cache
memory) and 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: Windows
Specifies the location where the SAS Command window is displayed.
Valid in:
configuration file, SAS invocation
Category:
Environment Control: Display
PROC OPTIONS
GROUP=
ENVDISPLAY
Default:
BOTTOM CENTER
508
Chapter 22 • SAS System Options under Windows
40
Windows
specifics:
all
Syntax
-COMDEF TOP | CENTER | BOTTOM
<LEFT | CENTER | RIGHT>
Syntax Description
TOP | CENTER | BOTTOM
specifies the vertical position of the Command window. The default value is
BOTTOM.
LEFT | CENTER | RIGHT
specifies the horizontal position of the 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 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.
See Also
• “Setting Session Preferences ” on page 68
• “Using the Command Bar to Issue Commands” on page 51
CONFIG System Option: Windows
Specifies the configuration file that is used when initializing or overriding the values of SAS system options.
Valid in:
configuration file, SAS invocation
Category:
System Administration: Installation
PROC OPTIONS
GROUP=
INSTALL
Default:
!sasroot\SASV9.CFG
Windows
specifics:
all
Syntax
-CONFIG file-specification
CONFIG System Option: Windows
509
46
Required Argument
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 that you choose.
See Also
“SAS Configuration Files ” on page 25
DEVICE System Option: Windows
Specifies a device driver for graphics output for SAS/GRAPH software.
Valid in:
configuration file, SAS invocation, OPTIONS statement, SAS System Options
window
Category:
Graphics: Driver Settings
PROC OPTIONS
GROUP=
GRAPHICS
Alias:
-DEV
Default:
none
Windows
specifics:
Valid values for device-driver-name; default value
See:
“DEVICE= System Option” in SAS/GRAPH: Reference
Syntax
-DEVICE device-driver-name
DEVICE= device-driver-name
Required Argument
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;
510
Chapter 22 • SAS System Options under Windows
Documents you may be interested
Documents you may be interested