ROLS call
The Roll Back to SETS (ROLS) call is used
to back out to a processing point set by a prior SETS or SETU call.
For more information on the ROLS call,
see the topic "Maintaining Database Integrity" in IMS Version 15.4 Application Programming.
Format
| Call Name | DB/DC | DBCTL | DCCTL | DB Batch | TM Batch |
|---|---|---|---|---|---|
| ROLS | X | X | X | X | X |
Parameters
- db pcb
- Specifies the DB PCB for the call. This parameter is an input and output parameter.
- i/o pcb
- Specifies the I/O PCB for the call. 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, or the name of a DB PCB.
- 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 the I/O area has the same format as the I/O area supplied
on the
SETScall. This parameter is an output parameter. - token
- Specifies the area in your program that contains a 4-byte identifier. This parameter is an input parameter.
Usage
When you use the Roll
Back to SETS (ROLS) call to back out to a processing
point set by a prior SETS or SETU,
the ROLS enables you to continue processing or to
back out to the prior commit point and place the input message on
the suspend queue for later processing.
Issuing a ROLS call
for a DB PCB can result in the user abend code 3303.
Restrictions
For function shipping in the CICS® environment, the local and remote CICS must both be DBCTL.
The ROLS call is not valid when
the PSB contains a DEDB or MSDB PCB, or when the call is made to a DB2® database.