CLEANUP

CLEANUP

Specifies how to handle an out-of-resource condition

Valid in: configuration file, SAS invocation, OPTIONS statement, Systems Options window

Category: Environment control: Error handling

PROC OPTIONS GROUP= ERRORHANDLING

Syntax
Syntax Description
Details

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

When CLEANUP is in effect and an out-of-resource condition occurs (except for a disk-full condition), a requestor window is not displayed, and no intervention is required by the user. When CLEANUP is in effect and a disk-full condition occurs, a requester window displays that allows the user to decide how to proceed.

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, windows) are not automatically cleaned up. Instead, a requester window appears that allows the user to choose how to proceed.

Details

This table lists the requester window choices:

Requester Window Choice Action

Free windows clears all windows not essential for execution.

Clear paste buffers deletes paste buffer contents.

Deassign inactive librefs prompts user for librefs to delete.

Delete definitions of all SAS macros and macro variables deletes all macro definitions and variables.

Delete SAS files allows user to select files to delete.

Clear Log window erases Log window contents.

Clear Output window erases Output window contents.

Clear Program Editor window erases Program Editor window contents.

Clear source spooling/DMS recall buffers erases recall buffers.

More items to clean up displays a list of other resources that can be cleaned up.

Clean up everything cleans up all other options that are shown on the requestor window. This selection only applies to the current clean-up request, not to the entire SAS session.

Continuous clean up performs automatic, continuous clean-up. When continuous clean up is selected, SAS cleans up as many resources as possible in order to continue execution, and it ceases to display the requester window. Selecting continuous clean-up has the same effect as specifying CLEANUP. This selection applies to the current clean-up request and to the remainder of the SAS session.

Requester Window Choice	Action
Free windows	clears all windows not essential for execution.
Clear paste buffers	deletes paste buffer contents.
Deassign inactive librefs	prompts user for librefs to delete.
Delete definitions of all SAS macros and macro variables	deletes all macro definitions and variables.
Delete SAS files	allows user to select files to delete.
Clear Log window	erases Log window contents.
Clear Output window	erases Output window contents.
Clear Program Editor window	erases Program Editor window contents.
Clear source spooling/DMS recall buffers	erases recall buffers.
More items to clean up	displays a list of other resources that can be cleaned up.
Clean up everything	cleans up all other options that are shown on the requestor window. This selection only applies to the current clean-up request, not to the entire SAS session.
Continuous clean up	performs automatic, continuous clean-up. When continuous clean up is selected, SAS cleans up as many resources as possible in order to continue execution, and it ceases to display the requester window. Selecting continuous clean-up has the same effect as specifying CLEANUP. This selection applies to the current clean-up request and to the remainder of the SAS session.

Operating Environment Information: Some operating environments may also include these choices in the requester window:

Requester Window Choice Action

Execute X command enables the user to erase files and perform other clean-up operations.

Do nothing halts the clean-up request and returns to the SAS session. This selection only applies to the current clean-up request, not to the entire SAS session.

If an out-of-resource condition cannot be resolved, the requester window continues to display. In that case, see the SAS documentation for your operating environment for instructions on terminating the SAS session.

When running in modes other than a windowing environment, the operation of CLEANUP depends on your operating environment. For details, see the SAS documentation for your operating environment. [cautionend]

Chapter Contents
Previous
Next
Top of Page

Valid in:	configuration file, SAS invocation, OPTIONS statement, Systems Options window
Category:	Environment control: Error handling
PROC OPTIONS GROUP=	ERRORHANDLING

Requester Window Choice	Action
Execute X command	enables the user to erase files and perform other clean-up operations.
Do nothing	halts the clean-up request and returns to the SAS session. This selection only applies to the current clean-up request, not to the entire SAS session.

CLEANUP

Syntax

Syntax Description