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);

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments