PutMsgRecOffset (MQLONG)
This is the offset in bytes of the first MQPMR put message
record from the start of the MQPMO structure. The offset can be positive or
negative. PutMsgRecOffset
is used only when the message
is being put to a distribution list. The field is ignored if RecsPresent
is zero.
- Message identifier
- Correlation identifier
- Group identifier
- Feedback value
- Accounting token
You do not need to specify all these properties, but whatever subset you choose, specify the fields in the correct order. See the description of the MQPMR structure for further details.
Usually, there must be as many put message records as there are object records specified by MQOD when the distribution list is opened; each put message record supplies the message properties for the queue identified by the corresponding object record. Queues in the distribution list that fail to open must still have put message records allocated for them at the appropriate positions in the array, although the message properties are ignored in this case.
The number of put message records can differ from the number of object
records. If there are fewer put message records than object records, the message
properties for the destinations that do not have put message records are taken
from the corresponding fields in the message descriptor MQMD. If there are
more put message records than object records, the excess are not used (although
it must still be possible to access them). Put message records are optional,
but if they are supplied there must be RecsPresent
of
them.
Provide the put message records in a similar way to the object records
in MQOD, either by specifying an offset in PutMsgRecOffset
,
or by specifying an address in PutMsgRecPtr
; for details
of how to do this, see the ObjectRecOffset
field described
in MQOD - Object descriptor.
No more than one of PutMsgRecOffset
and PutMsgRecPtr
can be used; the call fails with reason code MQRC_PUT_MSG_RECORDS_ERROR
if both are nonzero.
This is an input field. The initial value of this field is 0. This field
is ignored if Version
is less than MQPMO_VERSION_2.