LABELCHKPT System Option

Specifies whether checkpoint-restart data for labeled code sections is to be recorded for batch programs.
Valid in: Configuration file, SAS invocation
Category: Environment control: Error handling
PROC OPTIONS GROUP= ERRORHANDLING
Restrictions: The LABELCHKPT system option can be specified only if the STEPCHKPT system option is not specified when SAS starts.

Checkpoint mode is not valid for batch programs that contain the DM statement, which submits commands to SAS. If checkpoint mode is enabled and SAS encounters a DM statement, checkpoint mode is disabled, the checkpoint catalog entry is deleted, and a warning is written to the SAS log.

Requirement: This option can be used only in batch mode.
Note: This option can be restricted by a site administrator. For more information, see Restricted Options.

Syntax

Syntax Description

LABELCHKPT
enables checkpoint mode for labeled code sections, which specifies to record checkpoint-restart data.
NOLABELCHKPT
disables checkpoint mode for labeled code sections, which specifies not to record checkpoint-restart data. This is the default.

Details

Using the LABELCHKPT system option puts SAS in checkpoint mode for SAS programs that run in batch. Each time a label is encountered, SAS records data in a checkpoint-restart library. If a program terminates without completing, the program can be resubmitted, beginning at the labeled code section that was executing when the program terminated.
To ensure that the checkpoint-restart data is accurate, specify the ERRORCHECK STRICT option and set the ERRORABEND option. By setting these options, SAS terminates for most errors.
SAS can run in checkpoint-restart mode either for labeled code sections or for DATA and PROC steps, but not both.

Comparisons

The LABELCHKPT system option enables checkpoint mode for labeled code sections in batch programs that terminate before completing. Execution resumes at the labeled code section that was executing when the failure occurred.
The STEPCHKPT system option enables checkpoint mode for DATA and PROC steps in batch programs that terminate before completing. Execution resumes with the DATA or PROC step that was executing when the failure occurred.