SrcEnvOffset (MQLONG)

This field specifies the offset of the source environment data from the start of the MQRMH structure. Source 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 source environment data might be the directory path of the object containing the bulk data. However, if the creator does not know the source environment data, the user-supplied message exit must determine any environment information needed.

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

Applications must not assume that the environment data starts immediately after the last fixed field in the structure or that it is contiguous with any of the data addressed by the SrcNameOffset, DestEnvOffset, and DestNameOffset fields.

The initial value of this field is 0.