CHKP (basic) call
A basic Checkpoint (CHKP) call is used for recovery
purposes.
The ODBA interface does not support this call.
Format
| 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
CHKPcall 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
CHKPcall 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.
