Using the XRST call
XRST
call to invoke AR/CTL checkpoint/restart support and to enable AR/CTL data services. This call results in a normal start, cold start, or restart environment, depending on the AR/CTL restart determination routines.Warning
If an application program uses checkpoint/restart support or any AR/CTL data services, it must issue the restart call once as the first call and before any data set open processing.
When the application program issues the XRST
call, AR/CTL repositions the database and GSAM files. If the application program is using DB2 but does not use the Automatic DB2 Cursor Repositioning processing option, the application program must reposition the DB2 tables by using the key information in a data area saved in the CHKP
call.
Note
The XRST
call must specify user areas identical to those specified in the CHKP
calls.
Call format | The following example shows the XRST call in COBOL:
|
---|
Call Parameters | The following parameters are valid on the XRST call
| ||||||||
---|---|---|---|---|---|---|---|---|---|
userarea-1 | Required. The name of the first data area to save in the checkpoint record. It is usually a structure name. | ||||||||
userlen-n, userarea-n | Optional. The address of the length and the name of the next data area to save in the checkpoint record. Provide a pair of userlen-n and userarea-n parameters for each defined data area you want to restore. You can identify a maximum of seven data areas. | ||||||||
Status codes | AR/CTL does not issue any status codes for this call. |
Comments
Log in or register to comment.