GMRL (10-digit signed integer)

Length of message data returned (bytes).

This is an output field that is set by the queue manager to the length in bytes of the message data returned by the MQGET call in the BUFFER parameter. If the queue manager does not support this capability, GMRL is set to the value RLUNDF.

When messages are converted between encodings or character sets, the message data can sometimes change size. On return from the MQGET call:

• If GMRL is not RLUNDF, the number of bytes of message data returned is given by GMRL.

• If GMRL has the value RLUNDF, the number of bytes of message data returned is usually given by the smaller of BUFLEN and DATLEN, but can be less than this if the MQGET call completes with reason code RC2079. If this happens, the insignificant bytes in the BUFFER parameter are set to nulls.

The following special value is defined:

RLUNDF

Length of returned data not defined.

The initial value of this field is RLUNDF. This field is ignored if GMVER is less than GMVER3.