CLEANUP System Option

For an out-of-resource condition, specifies whether to perform an automatic cleanup or a user-specified cleanup.

Valid in:	Configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category:	Environment control: Error handling
PROC OPTIONS GROUP=	ERRORHANDLING
Note:	This option can be restricted by a site administrator. For more information, see Restricted Options.
See:	CLEANUP System Option under UNIX, Windows

Syntax

Details

Syntax

CLEANUP | NOCLEANUP

Syntax Description

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 resources that are not visible to the user (for example, cache memory) and resources 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 dialog box is not displayed, and no intervention is required by the user. When CLEANUP is in effect and a disk-full condition occurs, a dialog box 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 dialog box appears that allows the user to choose how to proceed.

Details

This table lists the dialog box choices:

Dialog Box 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 dialog box. This selection only applies to the current cleanup request, not to the entire SAS session.
Continuous clean up	performs automatic, continuous cleanup. 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 cleanup request and to the remainder of the SAS session.

Some operating environments might also include these choices in the dialog box:

Dialog Box Choice	Action
Execute X command	enables the user to erase files and perform other cleanup operations.
Do nothing	halts the cleanup request and returns to the SAS session. This selection only applies to the current cleanup request, not to the entire SAS session.

If an out-of-resource condition cannot be resolved, the dialog box 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.