QGETN FM header format

The following table shows the format of the QGETN FM header.

Table 1. QGETN FM header format
Byte Bits Name Contents
0   FMHL Length
1 0 FMHC  
1-7 FMHT Type: B'0000110'
2-3   FMH6CMD Command Code: X'0A10'
4   FMH6MOD Modifier
0 FMH6LNSZ B'0' 1-Byte Length Fields
1-7   Reserved
5   FMH6FXCT

Length of Fixed-Length Parameters
(=X'01')
6   QORG Type of paging request X'00' Queue organization not specified. This form is valid for both OLP and non-OLP output.
X'01'
Sequential.1
X'02'
Near.1
X'03'
Hierarchic. Not supported by IMS.
X'04' to X'FF'
Reserved.
7-m1   QNAME

Q from which pages are retrieved.
Specifies a message ID
(ATTDQN/SCDDQN)2
m+1-n   QTRNSZ

Size of maximum record to be returned
(binary). Ignored by IMS if sent.
Notes:
  1. If QORG is specified, the QORG specified on the resulting QXFR FM header sent by IMS must match it. Otherwise, an error message is sent and the output message is returned to the message queue for retransmission.
  2. The QNAME (message identifier) is required on each page request for scheduled demand-paged output and is optional for synchronous demand-paged output. If the QNAME parameter is present, it must match the ATTDQN/SCDDQN parameter in the ATTACH FM header sent by IMS. If QNAME is not specified for synchronous demand-paged output, IMS assumes it to be the same as the ATTDQN parameter name. If the QNAME parameter does not match the ATTDQN/SCDDQN parameter, an error message is sent and the output message is returned to the message queue for retransmission.