STEPCHKPTLIB= System Option: z/OS

Specifies the libref of the library where checkpoint-restart data is saved.

Valid in:	Configuration file, SAS invocation
Category:	Environment control: Error handling
PROC OPTIONS GROUP=	ERRORHANDLING
Default:	WORK
Requirement:	Can be used only in batch mode

Syntax

Details

Overview of the STEPCHKPTLIB= System Option

Setting Up and Executing Checkpoint Mode and Restart Mode

Syntax

STEPCHKPTLIB=libref

Required Argument

libref: specifies the libref that identifies the library where the checkpoint-restart data is saved. The LIBNAME statement that identifies the checkpoint-restart library must use the BASE engine and be the first statement in the batch program.

Details

Overview of the STEPCHKPTLIB= System Option

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, then 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.

Setting Up and Executing Checkpoint Mode and Restart Mode

To set up checkpoint mode and restart mode, make the following modification to your batch program:

Add the CHECKPOINT EXECUTE_ALWAYS statement before any DATA and PROC steps that you want to execute each time the batch program is submitted.
Add the LIBNAME statement that defines the checkpoint-restart libref as the first statement in the batch program if your checkpoint-restart library is a user-defined library. If you use the WORK library as your checkpoint library, no LIBNAME statement is necessary.

Note: You can use a ddname instead of a libref.