Inquire Channel Status (Response) (AMQP)
The response to the Inquire Channel Status (MQCMD_INQUIRE_CHANNEL_STATUS) command consists of the response header followed by the ChannelName structure and the requested combination of attribute parameter structures.
One PCF response message is generated for each channel instance found that matches the criteria that are specified on the command.
If the ClientIdentifier parameter is not specified, the output of the Inquire Channel Status command is a summary of statuses of all clients that are connected to the channel. One PCF response message is returned per channel.
- Always returned:
- ChannelName, ChannelStatus, ChannelType,
If the ClientIdentifier parameter is specified, separate PCF response messages are returned for each client connection. The ClientIdentifier parameter might be a wildcard, in which the status for all clients that match the ClientIdentifier string is returned.
- Always returned:
- ChannelName, ChannelStatus, ChannelType, ClientIdentifier
- Returned if requested:
- ChannelStartDate, ChannelStartTime, ClientUser, ConnectionName, Connections, KeepAliveInterval, LastMsgDate, LastMsgTime, MCAUser, MsgsReceived, MsgsSent, Protocol
Response data
- ChannelName (MQCFST)
- Channel name (parameter identifier: MQCACH_CHANNEL_NAME).
The maximum length of the string is MQ_CHANNEL_NAME_LENGTH.
- ChannelStartDate (MQCFST)
- Date on which the channel started, in the form yyyy-mm-dd (parameter
identifier: MQCACH_CHANNEL_START_DATE).
The maximum length of the string is MQ_CHANNEL_DATE_LENGTH.
- ChannelStartTime (MQCFST)
- Time at which the channel started, in the form hh.mm.ss (parameter identifier:
MQCACH_CHANNEL_START_TIME).
The maximum length of the string is MQ_CHANNEL_TIME_LENGTH.
- ChannelStatus (MQCFIN)
- Channel status (parameter identifier: MQIACH_CHANNEL_STATUS). The value can be:
- MQCHS_DISCONNECTED
- Channel is disconnected.
- MQCHS_RUNNING
- Channel is transferring or waiting for messages.
- ChannelType (MQCFIN)
- Channel type (parameter identifier: MQIACH_CHANNEL_TYPE). The value must be:
- MQCHT_AMQP
- AMQP
- ClientUser (MQCFST)
- Client Id of the client (parameter identifier: MQCACH_CLIENT_USER_ID).
The maximum length of the string is MQ_CLIENT_USER_ID_LENGTH.
- ConnectionName (MQCFST)
- Connection name (parameter identifier: MQCACH_CONNECTION_NAME).
The maximum length of the string is MQ_CONN_NAME_LENGTH.
- Connections (MQCFIN)
- Current number of AMQP connections connected to this channel (parameter identifier: MQIACF_NAME_LENGTH).
- KeepAliveInterval (MQCFIN)
- Keep alive interval (parameter identifier: MQIACH_KEEP_ALIVE_INTERVAL).
The interval in milliseconds after which the client is disconnected because of inactivity.
- LastMsgDate (MQCFST)
- Date on which the last message was sent, or the MQI call was handled, in the form
yyyy-mm-dd (parameter identifier: MQCACH_LAST_MSG_DATE).
The maximum length of the string is MQ_CHANNEL_DATE_LENGTH.
- LastMsgTime (MQCFST)
- Time at which the last message was sent, or the MQI call was handled, in the form
hh.mm.ss (parameter identifier: MQCACH_LAST_MSG_TIME).
The maximum length of the string is MQ_CHANNEL_TIME_LENGTH.
- MCAUser (MQCFST)
- Message channel agent user identifier (parameter identifier: MQCACH_MCA_USER_ID).
The maximum length of the MCA user identifier is MQ_MCA_USER_ID_LENGTH.
- MsgsReceived (MQCFIN64)
- Number of messages received by the client since it last connected (parameter identifier: MQIACH_MSGS_RECEIVED or MQIACH_MSGS_RCVD).
- MsgsSent (MQCFIN64)
- Number of messages sent by the client since it last connected (parameter identifier: MQIACH_MSGS_SENT).
- Protocol (MQCFST)
- AMQP protocol supported by this channel (parameter identifier: MQIACH_PROTOCOL). The value
will be:
- MQPROTO_AMQP
- AMQP
Parent topic: Definitions of the Programmable Command Formats