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:

ReasonQualifier, containing the value MQRQ_CHANNEL_STOPPED_ERROR
ErrorIdentifier, containing the code number of an error message that describes the error
AuxErrorDataInt1, containing error message integer insert 1
AuxErrorDataInt2, containing error message integer insert 2
AuxErrorDataStr1, containing error message string insert 1
AuxErrorDataStr2, containing error message string insert 2
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 platforms other than z/OS, 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 AMQ messages 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.