ExitResponse2 (MQLONG)

This field specifies the secondary response from the exit.

This field is set to zero on entry to the exit routine. It can be set by the exit to provide further information to the IBM MQ channel functions. It is not used by the auto-definition exit.

The exit can set one or more of the following values. If more than one is required, the values are added. Combinations that are not valid are noted; other combinations are allowed.

    MQXR2_PUT_WITH_DEF_ACTION
    Put with default action.

    This value is set by the channel message exit of the receiver. It indicates that the message is to be put with the default action of the MCA, that is either the default user ID of the MCA, or the context UserIdentifier in the MQMD (message descriptor) of the message.

    The value is zero, which corresponds to the initial value set when the exit is invoked. The constant is provided for documentation purposes.

    MQXR2_PUT_WITH_DEF_USERID
    Put with default user identifier.

    This value can only be set by the channel message exit of the receiver. It indicates that the message is to be put with the default user identifier of the MCA.

    MQXR2_PUT_WITH_MSG_USERID
    Put with user identifier of the message.

    This value can only be set by the channel message exit of the receiver. It indicates that the message is to be put with the context UserIdentifier in the MQMD (message descriptor) of the message (this might have been modified by the exit).

Only one of MQXR2_PUT_WITH_DEF_ACTION, MQXR2_PUT_WITH_DEF_USERID, and MQXR2_PUT_WITH_MSG_USERID should be set.

    MQXR2_USE_AGENT_BUFFER
    Use agent buffer.

    This value indicates that any data to be passed on is in AgentBuffer, not ExitBufferAddr.

    The value is zero, which corresponds to the initial value set when the exit is invoked. The constant is provided for documentation purposes.

    MQXR2_USE_EXIT_BUFFER
    Use exit buffer.

    This value indicates that any data to be passed on is in ExitBufferAddr, not AgentBuffer.

Only one of MQXR2_USE_AGENT_BUFFER and MQXR2_USE_EXIT_BUFFER should be set.

    MQXR2_DEFAULT_CONTINUATION
    Default continuation. Continuation with the next exit in the chain depends on the response from the last exit invoked:

    • If MQXCC_SUPPRESS_FUNCTION or MQXCC_CLOSE_CHANNEL are returned, no further exits in the chain are called.
    • Otherwise, the next exit in the chain is invoked.

    MQXR2_CONTINUE_CHAIN
    Continue with the next exit.

    MQXR2_SUPPRESS_CHAIN
    Skip remaining exits in chain.

This is an input/output field to the exit.

Parent topic: Fields