+

Search Tips | Advanced Search

Channel Auto-definition Error

Event name: Channel Auto-definition Error.
Reason code in MQCFH: MQRC_CHANNEL_AUTO_DEF_ERROR (2234, X'8BA').
Automatic channel definition failed.
Event description: This condition is detected when the automatic definition of a channel fails; this may be because an error occurred during the definition process, or because the channel automatic-definition exit inhibited the definition. Additional information indicating the reason for the failure is returned in the event message.
Event type: Channel.
Platforms: All, except IBM MQ for z/OS .
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.

    ChannelName

    Description: Name of the channel for which the auto-definiton has failed.
    Identifier: MQCACH_CHANNEL_NAME.
    Data type: MQCFST.
    Maximum length: MQ_CHANNEL_NAME_LENGTH.
    Returned: Always.

    ChannelType

    Description: Channel Type. This specifies the type of channel for which the auto-definition has failed.
    Identifier: MQIACH_CHANNEL_TYPE.
    Data type: MQCFIN.
    Values:

      MQCHT_RECEIVER
      Receiver.

      MQCHT_SVRCONN
      Server-connection (for use by clients).

      MQCHT_CLUSSDR
      Cluster-sender.

    Returned: Always.

    ErrorIdentifier

    Description: Identifier of the cause of the error. This contains either the reason code (MQRC_* or MQRCCF_*) resulting from the channel definition attempt or the value MQRCCF_SUPPRESSED_BY_EXIT if the attempt to create the definition was disallowed by the exit.
    Identifier: MQIACF_ERROR_IDENTIFIER.
    Data type: MQCFIN.
    Returned: Always.

    ConnectionName

    Description: Name of the partner attempting to establish connection.
    Identifier: MQCACH_CONNECTION_NAME.
    Data type: MQCFST.
    Maximum length: MQ_CONN_NAME_LENGTH.
    Returned: Always.

    AuxErrorDataInt1

    Description: Auxiliary error data. This contains the value returned by the exit in the Feedback field of the MQCXP to indicate why the auto definition has been disallowed.
    Identifier: MQIACF_AUX_ERROR_DATA_INT_1.
    Data type: MQCFIN.
    Returned: Only if ErrorIdentifier contains MQRCCF_SUPPRESSED_BY_EXIT.

Parent topic: Event message descriptions

Last updated: 2020-10-04