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, except WebSphere MQ for z/OS if CICS is used for distributed queue management. Client connections on WebSphere MQ for z/OS, or MQSeries Version 5 products do not produce this event.
Event queue: SYSTEM.ADMIN.CHANNEL.EVENT.

Note:
MQSeries for Windows V2.1 does not define the channel event queue for you, so the default action is not to generate channel events. This is because, once you have defined a channel event queue, you cannot stop channel event messages being generated. If you want WebSphere MQ to generate channel events, define the channel event queue yourself using the name SYSTEM.ADMIN.CHANNEL.EVENT.

 

Event data

QMgrName

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

ReasonQualifier

Description: Identifier that qualifies the reason code.
Identifier: MQIACF_REASON_QUALIFIER.
Datatype: 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.
Datatype: 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 the section "Distributed queuing message codes" in the WebSphere MQ for z/OS Messages and Codes book.

  • For other platforms, 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 the WebSphere MQ Messages book for a description of these error messages.

Identifier: MQIACF_ERROR_IDENTIFIER.
Datatype: 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.
Datatype: 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.
Datatype: 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.
Datatype: 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.
Datatype: 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.
Datatype: MQCFST.
Returned: Always.

XmitQName

Description: Transmission queue name.
Identifier: MQCACH_XMIT_Q_NAME.
Datatype: 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.
Datatype: MQCFST.
Maximum length: MQ_CONN_NAME_LENGTH.
Returned: Only for commands that do not contain a generic name.


 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.