CLSQRY command (X'2005')
The distributed data management (DDM) Architecture CLSQRY command closes a query that was opened previously by an OPNQRY call.
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'2005', the 2-byte codepoint of the CLSQRY 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'.
Usage
Use the DDM command CLSQRY (close a query) to close a query that was opened previously by an OPNQRY call.
Chained command objects
No command objects can be chained to the CLSQRY command.
Error reply messages
If errors occur during the processing of the CLSQRY 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'1245' | PRCCNVRM | Conversational protocol error |
| 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 |