Options (MQLONG)

Callback descriptor structure - Options 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).

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.

See CallType for further details about these call types. Default option: If we 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.