CHKP (basic) call

A basic Checkpoint (CHKP) call is used for recovery purposes.

The ODBA interface does not support this call.

Format

Read syntax diagramSkip visual syntax diagramCHKPi/o pcbaibi/o area
Call Name DB/DC DBCTL DCCTL DB Batch TM Batch
CHKP X X X X X

Parameters

i/o pcb
Specifies the I/O PCB for the call. A basic CHKP call must refer to the I/O PCB. This parameter is an input and output parameter.
aib
Specifies the AIB for the call. This parameter is an input and output parameter. These fields must be initialized in the AIB:
AIBID
Eye catcher. This 8-byte field must contain DFSAIBbb.
AIBLEN
AIB lengths. This field must contain the actual length of the AIB that the application program obtained.
AIBRSNM1
Resource name. This 8-byte, left-justified field must contain the PCB name, IOPCBbbb.
AIBOALEN
I/O area length. This field must contain the length of the I/O area specified in the call list.
i/o area
Specifies your program's I/O area that contains the 8-byte checkpoint ID. This parameter is an input parameter. If the program is an MPP or a message-driven BMP, the CHKP call implicitly returns the next input message to this I/O area. Therefore, the area must be large enough to hold the longest returned message.

Usage

Basic CHKP commits the changes your program has made to the database and establishes places in your program from which you can restart your program, if it terminates abnormally.

Restrictions

This command causes a loss of database position at the time the command is issued. Position must be reestablished by a GU command or other method of establishing position.