Options (MQLONG)

Delete message property options structure - Options field

Location options: The following options relate to the relative location of the property compared to the property cursor.

MQDMPO_DEL_FIRST

Deletes the first property that matches the specified name.

MQDMPO_DEL_PROP_UNDER_CURSOR

Deletes the property pointed to by the property cursor; that is the property that was last inquired by using either the MQIMPO_INQ_FIRST or the MQIMPO_INQ_NEXT option.

The property cursor is reset when the message handle is reused. It is also reset when the message handle is specified in the MsgHandle field of the MQGMO structure on an MQGET call, or MQPMO structure on an MQPUT call.

If this option is used when the property cursor has not yet been established, the call fails with completion code MQCC_FAILED and reason MQRC_PROPERTY_NOT_AVAILABLE. If the property pointed to by the property cursor has already been deleted, the call also fails with completion code MQCC_FAILED and reason MQRC_PROPERTY_NOT_AVAILABLE.

If neither of thees options is required, the following option can be used:

MQDMPO_NONE

No options specified.

This field is always an input field. The initial value of this field is MQDMPO_DEL_FIRST.

Parent topic: Fields for MQDMPO