MQPMRF_* values" /> PutMsgRecFields (MQLONG)
Home

 

PutMsgRecFields (MQLONG)

This field contains flags that indicate which MQPMR fields are present in the put message records provided by the application. Use PutMsgRecFields only when the message is being put to a distribution list. The field is ignored if RecsPresent is zero, or both PutMsgRecOffset and PutMsgRecPtr are zero.

For fields that are present, the queue manager uses for each destination the values from the fields in the corresponding put message record. For fields that are absent, the queue manager uses the values from the MQMD structure.

Use one or more of the following flags to indicate which fields are present in the put message records:

MQPMRF_MSG_ID

Message-identifier field is present.

MQPMRF_CORREL_ID

Correlation-identifier field is present.

MQPMRF_GROUP_ID

Group-identifier field is present.

MQPMRF_FEEDBACK

Feedback field is present.

MQPMRF_ACCOUNTING_TOKEN

Accounting-token field is present.

If you specify this flag, specify either MQPMO_SET_IDENTITY_CONTEXT or MQPMO_SET_ALL_CONTEXT in the Options field; if this condition is not satisfied, the call fails with reason code MQRC_PMO_RECORD_FLAGS_ERROR.

If no MQPMR fields are present, the following can be specified:

MQPMRF_NONE

No put-message record fields are present.

If this value is specified, either RecsPresent must be zero, or both PutMsgRecOffset and PutMsgRecPtr must be zero.

MQPMRF_NONE is defined to aid program documentation. It is not intended that this constant be used with any other, but as its value is zero, such use cannot be detected.

If PutMsgRecFields contains flags that are not valid, or put message records are provided but PutMsgRecFields has the value MQPMRF_NONE, the call fails with reason code MQRC_PMO_RECORD_FLAGS_ERROR.

This is an input field. The initial value of this field is MQPMRF_NONE. This field is ignored if Vis less than MQPMO_VERSION_2.



 

Home