RecsPresent (MQLONG)
This
is the number of MQPMR put message records or MQRR response records
that have been provided by the application. This number can be greater
than zero only if the message is being put to a distribution list.
Put message records and response records are optional; the application
need not provide any records, or it can choose to provide records
of only one type. However, if the application provides records of
both types, it must provide RecsPresent
records
of each type.
The value of RecsPresent
need
not be the same as the number of destinations in the distribution
list. If too many records are provided, the excess are not used; if
too few records are provided, default values are used for the message
properties for those destinations that do not have put message records
(see PutMsgRecOffset
).
If RecsPresent
is
less than zero, or is greater than zero but the message is not being
put to a distribution list, the call fails with reason code MQRC_RECS_PRESENT_ERROR.
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.