Using AR/CTL-format checkpoint/restart calls1

This topic describes the how to code AR/CTL-format checkpoint/restart calls and structures in a PL/I application program.

For more information, see Using-AR-CTL-format-checkpoint-restart-calls.

Call format

The following example shows the AR/CTL checkpoint/restart call:

CALL ARCfunc (parmcount, parmlist...);

Call parameters

The following parameters are valid on the AR/CTL checkpoint/restart call:

ARCfunc	Required. The name of the AR/CTL module to handle the call.
parmcount	Required. The address of a 4-byte field that contains the number of parameters in this call, not counting the parmcount parameter.
parmlist	Required. A list of parameters that the application program passes to AR/CTL with the call. The parameters to include in the list depend on the call.

Define the user areas to save in the checkpoint call as part of a structure. The beginning of each user area must be in the same structure as the end of that user area. The length field must be declared as a 31-byte fixed binary field, as shown in the following example:

DCL 1 WORKAREA
3 ULENGTH FIXED BIN(31) INIT(500)

Restart ID area

The following is an example of the restart ID area code:

DCL 1 XRST_AREA,
2 XRST_ID CHAR(8),
2 XRST_PD CHAR(4);

Checkpoint ARB

The following is an example of the checkpoint ARB code:

DCL 1 ARCARB,
     2 ARCARB-TYPE CHAR(8) INIT('$ARCARB '),
     2 FUNC-CODE   CHAR(8) INIT('        '),
     2 UNUSED      CHAR(8) INIT('        '),
     2 STATUS-CODE CHAR(2) INIT(' '),
     2 UNUSED      CHAR(2) INIT(' '),
     2 UNUSED      CHAR(4);

Using AR/CTL-format checkpoint/restart calls1

On this page