Options (MQLONG)
Callback descriptor structure - Options field
Any
one, or all, of the following can be specified. If more than one option
is required the values can be:
- Added together (do not add the same constant more than once), or
- Combined using the bitwise OR operation (if the programming language supports bit operations).
- MQCBDO_FAIL_IF_QUIESCING
- The MQCB call fails if the queue manager is in the quiescing state.
On z/OS®, this option also forces the MQCB call to fail if the connection (for a CICS® or IMS application) is in the quiescing state.
Specify MQGMO_FAIL_IF_QUIESCING, in the MQGMO options passed on the MQCB call, to cause notification to message consumers when they are quiescing.
Control options: The following options control whether the callback function is called,
without a message, when the state of the consumer changes:
- MQCBDO_REGISTER_CALL
- The callback function is invoked with call type MQCBCT_REGISTER_CALL.
- MQCBDO_START_CALL
- The callback function is invoked with call type MQCBCT_START_CALL.
- MQCBDO_STOP_CALL
- The callback function is invoked with call type MQCBCT_STOP_CALL.
- MQCBDO_DEREGISTER_CALL
- The callback function is invoked with call type MQCBCT_DEREGISTER_CALL.
- MQCBDO_EVENT_CALL
- The callback function is invoked with call type MQCBCT_EVENT_CALL.
- MQCBDO_MC_EVENT_CALL
- The callback function is invoked with call type MQCBCT__MC_EVENT_CALL.
Default option: If you do not need any of the options
described, use the following option:
- MQCBDO_NONE
- Use this value to indicate that no other options
have been specified; all options assume their default values.
MQCBDO_NONE is defined to aid program documentation; it is not intended that this option be used with any other, but as its value is zero, such use cannot be detected.
This is an input field. The initial value of the Options field
is MQCBDO_NONE.