Previous Page | Next Page

SAS System Options

STEPCHKPTLIB= System Option



Specifies the libref of the library where checkpoint-restart data is saved.
Valid in: configuration file, SAS invocation
Category: Environment control: Error handling
Requirement: can be used only in batch mode
PROC OPTIONS GROUP= ERRORHANDLING

Syntax
Syntax Description
Details
See Also

Syntax

STEPCHKPTLIB=libref


Syntax Description

libref

specifies the libref that identifies the library where the checkpoint-restart data is saved.

Default: Work
Requirement: The LIBNAME statement that identifies the checkpoint-restart library must use the BASE engine and be the first statement in the batch program.

Details

When the STEPCHKPT system option is specified, checkpoint-restart data for batch programs is saved in the libref that is specified in the STEPCHKPTLIB= system option. If no libref is specified, SAS uses the Work library to save checkpoint data. The LIBNAME statement that defines the libref must be the first statement in the batch program.

If the Work library is used to save checkpoint data, the NOWORKTERM and NOWORKINIT system options must be specified so that the checkpoint-restart data is available when the batch program is resubmitted. These two options ensure that the Work library is saved when SAS ends and is restored when SAS starts. If the NOWORKTERM option is not specified, the Work library is deleted at the end of the SAS session and the checkpoint-restart data is lost. If the NOWORKINIT option is not specified, a new Work library is created when SAS starts, and again the checkpoint-restart data is lost.

The STEPCHKPTLIB= option must be specified for any SAS session that accesses checkpoint-restart data that is not saved to the Work library.


See Also

System Options:

STEPCHKPT System Option

STEPRESTART System Option

WORKINIT System Option

WORKTERM System Option

Statement:

CHECKPOINT EXECUTE_ALWAYS Statement

Restarting Batch Programs in SAS Language Reference: Concepts

Previous Page | Next Page | Top of Page