DataLogicalLength (MQLONG)

The DataLogicalLength field specifies the length of the bulk data referenced by the MQRMH structure.

If the bulk data is actually present in the message, the data begins at an offset of StrucLength bytes from the start of the MQRMH structure. The length of the entire message minus StrucLength gives the length of the bulk data present.

If data is present in the message, DataLogicalLength specifies the amount of that data that is relevant. The normal case is for DataLogicalLength to have the same value as the length of data present in the message.

If the MQRMH structure represents the remaining data in the object (starting from the specified logical offset), we can use the value zero for DataLogicalLength, provided that the bulk data is not actually present in the message.

If no data is present, the end of MQRMH coincides with the end of the message.

The initial value of this field is 0.

Parent topic: Fields for MQRMH