RLSE command (X'C802')
Use the distributed data management (DDM) architecture RLSE command to release any database locks that are held by the application.
Format
Parameters
- DSSHDR
- The 6-byte header that contains information about the data stream structure (DSS).
- LL
- The length specified as a 2-byte binary integer. This length includes LL and CP.
- CP
- X'C802', the 2-byte codepoint of the RLSE command.
- PCBNAME
A required parameter that specifies the PCB name that uniquely identifies the query made by a DL/I call. The PCB name is specified as a character string. The value is initially sent with the original OPNQRY command. The same value must subsequently be sent in commands such as CNTQRY, CLSQRY, and RLSE for proper correlation with the original OPNQRY call. The codepoint for the PCBNAME parameter is X'C907'.
Chained command objects
No command objects are chained to the RLSE command.
Positive reply messages
In response to the RLSE command, the IMS target DDM server returns to the source server the following positive reply message:
- RLSERM (X'CA03')
- The Release Locks Reply Message indicates to the requester that an RLSE command has completed normally.
Chained reply data objects
No reply data objects are returned in response to the RLSE command.
Error reply messages
In response to the RLSE command, the IMS target DDM server can return to the source DDM server the following error reply messages:
| Codepoint of reply message | Name of reply message | Meaning of reply message |
|---|---|---|
| X'121C' | CMDATHRM | Not authorized to command |
| X'1232' | AGNPRMRM | Permanent agent error |
| X'1233' | RSCLMTRM | Resource limits reached |
| X'124C' | SYNTAXRM | Data stream syntax error |
| X'1250' | CMDNSPRM | Command not supported |
| X'1251' | PRMNSPRM | Parameter not supported |
| X'1252' | VALNSPRM | Parameter value not supported |
| X'1254' | CMDCHKRM | Command check reply message |
| X'125F' | TRGNSPRM | Target not supported |