CopyOptions (MQLONG)
This describes which type of messages the property should be copied into. This is an output only field for recognized IBM MQ defined properties; IBM MQ sets the appropriate value.
When a queue manager receives a message containing an IBM MQ defined property that the queue manager recognizes as being incorrect, the queue manager corrects the value of the CopyOptions field.
We can specify one or more of these options. To specify more than one option, either add the values together (do not add the same constant more than once), or combine the values using the bitwise OR operation (if the programming language supports bit operations).
- MQCOPY_FORWARD
- This property is copied into a message being forwarded.
- MQCOPY_PUBLISH
- This property is copied into the message received by a subscriber when a message is being published.
- MQCOPY_REPLY
- This property is copied into a reply message.
- MQCOPY_REPORT
- This property is copied into a report message.
- MQCOPY_ALL
- This property is copied into all types of subsequent messages.
Default option: The following option can be specified to supply the default set of copy options:
- MQCOPY_DEFAULT
- This property is copied into a message being forwarded, into a report message, or into a message received by a subscriber when a message is being published.
This is equivalent to specifying the combination of options MQCOPY_FORWARD, plus MQCOPY_REPORT, plus MQCOPY_PUBLISH.
If none of the options that are described previously is required, use the following option:
- MQCOPY_NONE
- Use this value to indicate that no other copy options are specified; programmatically no relationship exists between this property and subsequent messages. This is always returned for message descriptor properties.
This is an input/output field to the MQSETMP call and an output field from the MQINQMP call. The initial value of this field is MQCOPY_DEFAULT.
Parent topic: Fields for MQPD