Chapter Contents

Previous

Next
LOADLIST=

LOADLIST=



Specifies whether to print to the specified file the information about images that the SAS System has loaded into memory

Language element: system option
Default: none
Valid in: configuration file, SAS invocation, OPTIONS statement, System Options window, VMS_SAS_OPTIONS DCL symbol
OpenVMS specifics: All aspects are host-specific


Syntax
Details
See Also

Syntax

LOADLIST=file-specification
NOLOADLIST

LOADLIST=file-specification
identifies an external file where the information is printed. The value for file-specification can be either a pathname or a logical name.

Note:   When you use LOADLIST= in an OPTIONS statement, you must enclose file-specification in double quotation marks. When you use LOADLIST= during SAS invocation or in a configuration file, do not use quotation marks.  [cautionend]

NOLOADLIST
specifies to not print any information. This is the default.


Details

The LOADLIST= system option helps you identify images that should be either moved to your local node or installed on your system in order to improve performance. Each time an image is loaded into memory, its name is added to the list. The images that appear most often in the list are likely candidates for performance enhancements.

The following is a partial list of a typical LOADLIST file:

IMAGE         SIZE        UNLOADABLE      LOAD COUNT
SASDEAP1      1536           YES                  1
SASMSG       10240           YES                  1
SASXKERN    346112           NO                   1
SASDS       226816           NO                   1
SASDS       226816           NO                   1
SASDS       226816           NO                   1
SASDS       226816           NO                   1
Each entry consists of the following:
IMAGE
is the image that was loaded from the SAS library.

SIZE
is the size of the image, in bytes.

UNLOADABLE
indicates whether the image is available for unloading.

LOAD COUNT
indicates how many times the image was requested for loading. This is a usage count for the image.

CAUTION:
Each new OpenVMS process opens its own version of the external file that LOADLIST writes to, so version limits can cause a loss of LOADLIST information.   [cautionend]
Every time an image is requested, SAS writes another entry to the LOADLIST file. If an image is requested but is already in memory, you will see another entry for the image, but the LOAD COUNT number remains the same. The LOAD COUNT number is always 1, indicating that it is physically loaded only once during the SAS session.

See Also


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.