Using the CHKP call
CHKP
call to invoke AR/CTL checkpoint/restart support to initiate an application program checkpoint. The checkpoint routine may not take an actual checkpoint, depending on the action taken by the checkpoint pacing routines and/or checkpoint exits. The application program can check an optional user-designated status code returned to the checkpoint PCB to determine whether an actual checkpoint occurred.The CHKP
call includes the checkpoint ID to identify a specific checkpoint. The CHKP
call also identifies one to seven areas of program storage for AR/CTL to save during the CHKP
call and to restore, if necessary, during the XRST
call.
Note
The application program should save the same user areas in the CHKP
call as the areas it uses in the XRST
call. Saving different areas is not recommended. If the application program saves different areas, it must ensure that AR/CTL restores these fields during restart by matching them on the XRST
call. Saving areas of varying lengths in different CHKP
calls is not a valid coding practice.
The application program should issue the CHKP
call at the end of an application program’s logical UOW. The application program also should issue the CHKP
call immediately after the XRST
call and at the end of an update job step before termination.
Issuing the CHKP
call at the end of an update job step is especially important if the application program is using both IMS and DB2. If the application program does not issue this final CHKP
call and a failure occurs after the program terminated but before the job step ended, it is possible for DB2 to commit the data before DL/I commits the data. The DB2 data would be out of sync with the DL/I changes. Issue a CHKP
call at the end of any update job step to coordinate the commit of the outstanding UOW for IMS and DB2. If the job step uses checkpoint pacing, BMC Software recommends that the program ensure the checkpoint is not bypassed by using the AR/CTL common checkpoint call with the force option or by using a checkpoint user exit routine.
CURSOR WITH HOLD Option | AR/CTL does not change the cursor to use the If the application program is using
|
---|
Comments
Log in or register to comment.