DestEnvOffset (MQLONG)

This field specifies the offset of the destination environment data from the start of the MQRMH structure. Destination environment data can be specified by the creator of the reference message, if that data is known to the creator. For example, on Windows the destination environment data might be the directory path of the object where the bulk data is to be stored. However, if the creator does not know the destination environment data, it is the responsibility of the user-supplied message exit to determine any environment information needed.

The length of the destination environment data is given by DestEnvLength ; if this length is zero, there is no destination environment data, and DestEnvOffset is ignored. If present, the destination environment data must reside completely within StrucLength bytes from the start of the structure.

Applications must not assume that the destination environment data is contiguous with any of the data addressed by the SrcEnvOffset, SrcNameOffset, and DestNameOffset fields.

The initial value of this field is 0.