Using the XRST call
XRSTcall 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.
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
XRST call must specify user areas identical to those specified in the
The following example shows the XRST call in COBOL:
The following parameters are valid on the XRST call
Required. The name of the first data area to save in the checkpoint record. It is usually a structure name.
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.
AR/CTL does not issue any status codes for this call.
Log in or register to comment.