ENDQRYRM reply message (X'220B')

The distributed data management (DDM) architecture ENDQRYRM (end of query) reply message indicates that the query processing is terminated and the query or result set is closed.

The query cannot be resumed with the CNTQRY command or closed with the CLSQRY command.

Format

Read syntax diagramSkip visual syntax diagramDSSHDRLLCPRDBNAMSRVDGN SVRCODOUTAIBDBPCB

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'220B', the 2-byte codepoint of the ENDQRYRM reply message.
RDBNAM

Codepoint X'2110'. The IMS PSB name that identifies the target database.

SRVDGN

An optional parameter (X'1153') that contains server diagnostic information. The data portion is a string with a maximum length of 32,767 bytes. The string can be any information the server sends to aid in problem diagnosis. For more information about SRVDGN, see DRDA, Version 4, Volume 3: Distributed Data Management (DDM) Architecture, which is available from The Open Group at www.opengroup.org.

SVRCOD
A required parameter (X'1149') that contains the severity code. SVRCOD consists of a 2-byte length field (LL), a 2-byte codepoint (CP), and the data. The data is a 2-byte binary value. The following list describes the possible 2-byte values:
0
INFO – Information only severity code
4
WARNING – Warning severity code
8
ERROR – Error severity code
16
SEVERE – Severe error severity code
32
ACCDMG – Access damage severity code
64
PRMDMG – Permanent damage severity code
128
SESDMG – Session damage severity code
OUTAIBDBPCB

A required parameter (X'CC02') that contains the AIB and DBPCB data sent from the target to the source.

Usage

The ENDQRYRM reply message is required to be chained to an OPNQRYRM reply message in the following situations:
  • In response to a GU, GN, or batch RETRIEVE call, when no data is returned. The aibdbpcbStream data required by the client is contained in this object.
  • In response to a batch RETRIEVE call when the QRYDTA object contains the last row of the data that satisfies the query, which indicates to the source server that ODBM received a GE/GB status code on the last GN call, and no CNTQRY should be sent.