Channel Stopped

Event name: Channel Stopped.
Reason code in MQCFH: MQRC_CHANNEL_STOPPED (2283, X'8EB').
Channel stopped.
Event description: This is issued when a channel instance stops. It will only be issued if the channel instance previously issued a channel started event.
Event type: Channel.
Platforms: All. Client connections do not produce this event.
Event queue: SYSTEM.ADMIN.CHANNEL.EVENT.


Event data

    QMgrName

    Description: Name of the queue manager generating the event.
    Identifier: MQCA_Q_MGR_NAME.
    Data type: MQCFST.
    Maximum length: MQ_Q_MGR_NAME_LENGTH.
    Returned: Always.

    ReasonQualifier

    Description: Identifier that qualifies the reason code.
    Identifier: MQIACF_REASON_QUALIFIER.
    Data type: MQCFIN.
    Values:

      MQRQ_CHANNEL_STOPPED_OK
      Channel has been closed with either a zero return code or a warning return code.

      MQRQ_CHANNEL_STOPPED_ERROR
      Channel has been closed but there is an error reported and the channel is not in stopped or retry state.

      MQRQ_CHANNEL_STOPPED_RETRY
      Channel has been closed and it is in retry state.

      MQRQ_CHANNEL_STOPPED_DISABLED
      Channel has been closed and it is in a stopped state.

    Returned: Always.

    ChannelName

    Description: Channel name.
    Identifier: MQCACH_CHANNEL_NAME.
    Data type: MQCFST.
    Maximum length: MQ_CHANNEL_NAME_LENGTH.
    Returned: Always.

    ErrorIdentifier

    Description: Identifier of the cause of the error. If a channel is stopped due to an error, this is the code that identifies the error. If the event message is because of a channel stop failure, the following fields are set:
    1. ReasonQualifier, containing the value MQRQ_CHANNEL_STOPPED_ERROR
    2. ErrorIdentifier, containing the code number of an error message that describes the error
    3. AuxErrorDataInt1, containing error message integer insert 1
    4. AuxErrorDataInt2, containing error message integer insert 2
    5. AuxErrorDataStr1, containing error message string insert 1
    6. AuxErrorDataStr2, containing error message string insert 2
    7. AuxErrorDataStr3, containing error message string insert 3

    The meanings of the error message inserts depend on the code number of the error message. Details of error-message code numbers and the inserts for specific platforms can be found as follows:

    • For z/OS, see Distributed queuing message codes.
    • For Multiplatforms, the last four digits of ErrorIdentifier when displayed in hexadecimal notation indicate the decimal code number of the error message.

      For example, if ErrorIdentifier has the value X'xxxxyyyy', the message code of the error message explaining the error is AMQyyyy. See IBM MQ messages on Multiplatforms for a description of these error messages.

    Identifier: MQIACF_ERROR_IDENTIFIER.
    Data type: MQCFIN.
    Returned: Always.

    AuxErrorDataInt1

    Description: First integer of auxiliary error data for channel errors. If a channel is stopped due to an error, this is the first integer parameter that qualifies the error. This information is for use by IBM service personnel; include it in any problem report that you submit to IBM regarding this event message.
    Identifier: MQIACF_AUX_ERROR_DATA_INT_1.
    Data type: MQCFIN.
    Returned: Always.

    AuxErrorDataInt2

    Description: Second integer of auxiliary error data for channel errors. If a channel is stopped due to an error, this is the second integer parameter that qualifies the error. This information is for use by IBM service personnel; include it in any problem report that you submit to IBM regarding this event message.
    Identifier: MQIACF_AUX_ERROR_DATA_INT_2.
    Data type: MQCFIN.
    Returned: Always.

    AuxErrorDataStr1

    Description: First string of auxiliary error data for channel errors. If a channel is stopped due to an error, this is the first string parameter that qualifies the error. This information is for use by IBM service personnel; include it in any problem report that you submit to IBM regarding this event message.
    Identifier: MQCACF_AUX_ERROR_DATA_STR_1.
    Data type: MQCFST.
    Returned: Always.

    AuxErrorDataStr2

    Description: Second string of auxiliary error data for channel errors. If a channel is stopped due to an error, this is the second string parameter that qualifies the error. This information is for use by IBM service personnel; include it in any problem report that you submit to IBM regarding this event message.
    Identifier: MQCACF_AUX_ERROR_DATA_STR_2.
    Data type: MQCFST.
    Returned: Always.

    AuxErrorDataStr3

    Description: Third string of auxiliary error data for channel errors. If a channel is stopped due to an error, this is the third string parameter that qualifies the error. This information is for use by IBM service personnel; include it in any problem report that you submit to IBM regarding this event message.
    Identifier: MQCACF_AUX_ERROR_DATA_STR_3.
    Data type: MQCFST.
    Returned: Always.

    XmitQName

    Description: Transmission queue name.
    Identifier: MQCACH_XMIT_Q_NAME.
    Data type: MQCFST.
    Maximum length: MQ_Q_NAME_LENGTH.
    Returned: For sender, server, cluster-sender, and cluster-receiver channels only.

    ConnectionName

    Description: If the channel has successfully established a TCP connection, this is the Internet address. Otherwise it is the contents of the ConnectionName field in the channel definition.
    Identifier: MQCACH_CONNECTION_NAME.
    Data type: MQCFST or MQCFSL.
    Maximum length: MQ_CONN_NAME_LENGTH.
    Returned: Only for commands that do not contain a generic name.

Parent topic: Event message descriptions