Home
Response data
- Batches (MQCFIN)
- Number of completed batches (parameter identifier: MQIACH_BATCHES).
- BatchSize (MQCFIN)
- Negotiated batch size (parameter identifier: MQIACH_BATCH_SIZE).
- BatchSizeIndicator (MQCFIL)
- Indicator of the number of messages in a batch (parameter identifier: MQIACH_BATCH_SIZE_INDICATOR). Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- BuffersReceived (MQCFIN)
- Number of buffers received (parameter identifier: MQIACH_BUFFERS_RCVD).
- BuffersSent (MQCFIN)
- Number of buffers sent (parameter identifier: MQIACH_BUFFERS_SENT).
- BytesReceived (MQCFIN)
- Number of bytes received (parameter identifier: MQIACH_BYTES_RCVD).
- BytesSent (MQCFIN)
- Number of bytes sent (parameter identifier: MQIACH_BYTES_SENT).
- ChannelDisposition (MQCFIN)
- Channel disposition (parameter identifier: MQIACH_CHANNEL_DISP). This parameter is valid only on z/OS.
The value can be:
- MQCHLD_ALL
- Status information for private channels.
In a shared queue environment where the command is being executed on the queue manager where it was issued, or if ChannelInstanceType has a value of MQOT_CURRENT_CHANNEL, this option also displays the requested status information for shared channels.
- MQCHLD_PRIVATE
- Status information for private channels.
- MQCHLD_SHARED
- Status information for shared channels.
- ChannelInstanceType (MQCFIN)
- Channel instance type (parameter identifier: MQIACH_CHANNEL_INSTANCE_TYPE).
The value can be:
- MQOT_CURRENT_CHANNEL
- Current channel status.
- MQOT_SAVED_CHANNEL
- Saved channel status.
- MQOT_SHORT_CHANNEL
- Short channel status, only on z/OS.
- ChannelMonitoring (MQCFIN)
- Current level of monitoring data collection for the channel (parameter identifier: MQIACH_MONITORING_CHANNEL).
The value can be:
- MQMON_OFF
- Monitoring for the channel is switched off.
- MQMON_LOW
- Low rate of data collection.
- MQMON_MEDIUM
- Medium rate of data collection.
- MQMON_HIGH
- High rate of data collection.
- ChannelName (MQCFST)
- Channel name (parameter identifier: MQCACH_CHANNEL_NAME).
The maximum length of the string is MQ_CHANNEL_NAME_LENGTH.
- ChannelStartDate (MQCFST)
- Date 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 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_BINDING
- Channel is negotiating with the partner.
- MQCHS_STARTING
- Channel is waiting to become active.
- MQCHS_RUNNING
- Channel is transferring or waiting for messages.
- MQCHS_PAUSED
- Channel is paused.
- MQCHS_STOPPING
- Channel is in process of stopping.
- MQCHS_RETRYING
- Channel is reattempting to establish connection.
- MQCHS_STOPPED
- Channel is stopped.
- MQCHS_REQUESTING
- Requester channel is requesting connection.
- MQCHS_INITIALIZING
- Channel is initializing.
- ChannelType (MQCFIN)
- Channel type (parameter identifier: MQIACH_CHANNEL_TYPE).
The value can be:
- MQCHT_SENDER
- Sender.
- MQCHT_SERVER
- Server.
- MQCHT_RECEIVER
- Receiver.
- MQCHT_REQUESTER
- Requester.
- MQCHT_SVRCONN
- Server-connection (for use by clients).
- MQCHT_CLNTCONN
- Client connection.
- MQCHT_CLUSRCVR
- Cluster-receiver.
- MQCHT_CLUSSDR
- Cluster-sender.
- CompressionRate (MQCFIL)
- The compression rate achieved displayed to the nearest percentage (parameter identifier: MQIACH_COMPRESSION_RATE). Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- CompressionTime (MQCFIL)
- The amount of time per message, displayed in microseconds, spent during compression or decompression (parameter identifier: MQIACH_COMPRESSION_TIME). Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- ConnectionName (MQCFST)
- Connection name (parameter identifier: MQCACH_CONNECTION_NAME).
The maximum length of the string is MQ_CONN_NAME_LENGTH.
- CurrentLUWID (MQCFST)
- Logical unit of work identifier for in-doubt batch (parameter identifier: MQCACH_CURRENT_LUWID).
The logical unit of work identifier associated with the current batch, for a sending or a receiving channel.
For a sending channel, when the channel is in-doubt it is the LUWID of the in-doubt batch.
It is updated with the LUWID of the next batch when this is known.
The maximum length is MQ_LUWID_LENGTH.
- CurrentMsgs (MQCFIN)
- Number of messages in-doubt (parameter identifier: MQIACH_CURRENT_MSGS).
For a sending channel, this is the number of messages that have been sent in the current batch. It is incremented as each message is sent, and when the channel becomes in-doubt it is the number of messages that are in-doubt.
For a receiving channel, it is the number of messages that have been received in the current batch. It is incremented as each message is received.
The value is reset to zero, for both sending and receiving channels, when the batch is committed.
- CurrentSequenceNumber (MQCFIN)
- Sequence number of last message in in-doubt batch (parameter identifier: MQIACH_CURRENT_SEQ_NUMBER).
For a sending channel, this is the message sequence number of the last message sent. It is updated as each message is sent, and when the channel becomes in-doubt it is the message sequence number of the last message in the in-doubt batch.
For a receiving channel, it is the message sequence number of the last message that was received. It is updated as each message is received.
- ExitTime (MQCFIL)
- Indicator of the time taken executing user exits per message (parameter identifier: MQIACH_EXIT_TIME_INDICATOR). Amount of time, in microseconds, spent processing user exits per message. Where more than one exit is executed per message, the value is the sum of all the user exit times for a single message. Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- HeaderCompression (MQCFIL)
- Whether the header data sent by the channel is compressed (parameter identifier: MQIACH_HDR_COMPRESSION). Two values are returned:
- The default header data compression value negotiated for this channel.
- The header data compression value used for the last message sent. The header data compression value can be altered in a sending channels message exit. If no message has been sent, the second value is MQCOMPRESS_NOT_AVAILABLE.
The values can be:
- MQCOMPRESS_NONE
- No header data compression is performed. This is the default value.
- MQCOMPRESS_SYSTEM
- Header data compression is performed.
- MQCOMPRESS_NOT_AVAILABLE
- No message has been sent by the channel.
- HeartbeatInterval (MQCFIN)
- Heartbeat interval (parameter identifier: MQIACH_HB_INTERVAL).
- InDoubtStatus (MQCFIN)
- Whether the channel is currently in doubt (parameter identifier: MQIACH_INDOUBT_STATUS).
A sending channel is only in doubt while the sending Message Channel Agent is waiting for an acknowledgment that a batch of messages, which it has sent, has been successfully received. It is not in doubt at all other times, including the period during which messages are being sent, but before an acknowledgment has been requested.
A receiving channel is never in doubt.
The value can be:
- MQCHIDS_NOT_INDOUBT
- Channel is not in-doubt.
- MQCHIDS_INDOUBT
- Channel is in-doubt.
- KeepAliveInterval (MQCFIN)
- KeepAlive interval (parameter identifier: MQIACH_KEEP_ALIVE_INTERVAL). This parameter is valid only on z/OS.
- LastLUWID (MQCFST)
- Logical unit of work identifier for last committed batch (parameter identifier: MQCACH_LAST_LUWID).
The maximum length is MQ_LUWID_LENGTH.
- LastMsgDate (MQCFST)
- Date last message was sent, or 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 last message was sent, or 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.
- LastSequenceNumber (MQCFIN)
- Sequence number of last message in last committed batch (parameter identifier: MQIACH_LAST_SEQ_NUMBER).
- LocalAddress (MQCFST)
- Local communications address for the channel (parameter identifier: MQCACH_LOCAL_ADDRESS).
The maximum length of the string is MQ_LOCAL_ADDRESS_LENGTH.
- LongRetriesLeft (MQCFIN)
- Number of long retry attempts remaining (parameter identifier: MQIACH_LONG_RETRIES_LEFT).
- MaxMsgLength (MQCFIN)
- Maximum message length (parameter identifier: MQIACH_MAX_MSG_LENGTH). This parameter is valid only on z/OS.
- MCAJobName (MQCFST)
- Name of MCA job (parameter identifier: MQCACH_MCA_JOB_NAME).
The maximum length of the string is MQ_MCA_JOB_NAME_LENGTH.
- MCAStatus (MQCFIN)
- MCA status (parameter identifier: MQIACH_MCA_STATUS).
The value can be:
- MQMCAS_STOPPED
- Message channel agent stopped.
- MQMCAS_RUNNING
- Message channel agent running.
- MCAUserIdentifier (MQCFST)
- The user ID used by the MCA (parameter identifier: MQCACH_MCA_USER_ID).
This parameter applies only to server-connection, receiver, requester, and cluster-receiver channels.
The maximum length of the string is MQ_MCA_USER_ID_LENGTH.
- MessageCompression (MQCFIL)
- Whether the header data sent by the channel is compressed (parameter identifier: MQIACH_MSG_COMPRESSION). Two values are returned:
- The default message data compression value negotiated for this channel.
- The message data compression value used for the last message sent. The message data compression value can be altered in a sending channels message exit. If no message has been sent, the second value is MQCOMPRESS_NOT_AVAILABLE.
The values can be:
- MQCOMPRESS_NONE
- No message data compression is performed. This is the default value.
- MQCOMPRESS_RLE
- Message data compression is performed using run-length encoding.
- MQCOMPRESS_ZLIBFAST
- Message data compression is performed using ZLIB encoding with speed prioritized.
- MQCOMPRESS_ZLIBHIGH
- Message data compression is performed using ZLIB encoding with compression prioritized.
- MQCOMPRESS_NOT_AVAILABLE
- No message has been sent by the channel.
- Msgs (MQCFIN)
- Number of messages sent or received, or number of MQI calls handled (parameter identifier: MQIACH_MSGS).
- MsgsAvailable (MQCFIN)
- Number of messages available (parameter identifier: MQIACH_XMITQ_MSGS_AVAILABLE). Number of messages queued on the transmission queue available to the channel for MQGETs.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- NetTime (MQCFIL)
- Indicator of the time of a network operation (parameter identifier: MQIACH_NETWORK_TIME_INDICATOR). Amount of time, in microseconds, to send a request to the remote end of the channel and receive a response. Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
- NonPersistentMsgSpeed (MQCFIN)
- Speed at which nonpersistent messages are to be sent (parameter identifier: MQIACH_NPM_SPEED).
The value can be:
- MQNPMS_NORMAL
- Normal speed.
- MQNPMS_FAST
- Fast speed.
- QMgrName (MQCFST)
- Name of the queue manager that owns the channel instance (parameter identifier: MQCA_Q_MGR_NAME). This parameter is valid only on z/OS.
The maximum length of the string is MQ_Q_MGR_NAME_LENGTH.
- RemoteApplTag (MQCFST)
- Name of the remote queue manager, or queue-sharing group (parameter identifier: MQCACH_REMOTE_APPL_TAG).
The remote partner application name. This is the name of the client application at the remote end of the channel. This parameter applies only to server-connection channels.
- RemoteQMgrName (MQCFST)
- Name of the remote queue manager, or queue-sharing group (parameter identifier: MQCA_REMOTE_Q_MGR_NAME).
- ShortRetriesLeft (MQCFIN)
- Number of short retry attempts remaining (parameter identifier: MQIACH_SHORT_RETRIES_LEFT).
- SSLCertRemoteIssuerName (MQCFST)
- The full Distinguished Name of the issuer of the remote certificate. The issuer is the Certificate Authority that issued the certificate (parameter identifier: MQCACH_SSL_CERT_ISSUER_NAME).
The maximum length of the string is MQ_SHORT_DNAME_LENGTH.
- SSLCertUserId (MQCFST)
- The local user ID associated with the remote certificate (parameter identifier: MQCACH_SSL_CERT_USER_ID).
This parameter is valid only on z/OS.
The maximum length of the string is MQ_USER_ID_LENGTH.
- SSLKeyResetDate (MQCFST)
- Date of the previous successful SSL secret key reset, in the form yyyy-mm-dd (parameter identifier: MQCACH_SSL_KEY_RESET_DATE).
The maximum length of the string is MQ_DATE_LENGTH.
- SSLKeyResets (MQCFIN)
- SSL secret key resets (parameter identifier: MQIACH_SSL_KEY_RESETS).
The number of successful SSL secret key resets that have occurred for this channel instance since the channel started. If SSL secret key negotiation is enabled, the count is incremented whenever a secret key reset is performed.
- SSLKeyResetTime (MQCFST)
- Time of the previous successful SSL secret key reset, in the form hh.mm.ss (parameter identifier: MQCACH_SSL_KEY_RESET_TIME).
The maximum length of the string is MQ_TIME_LENGTH.
- SSLShortPeerName (MQCFST)
- Distinguished Name of the peer queue manager or client at the other end of the channel (parameter identifier: MQCACH_SSL_SHORT_PEER_NAME).
The maximum length is MQ_SHORT_DNAME_LENGTH. This limit might mean that exceptionally long Distinguished Names are truncated.
- StopRequested (MQCFIN)
- Whether user stop request is outstanding (parameter identifier: MQIACH_STOP_REQUESTED).
The value can be:
- MQCHSR_STOP_NOT_REQUESTED
- User stop request has not been received.
- MQCHSR_STOP_REQUESTED
- User stop request has been received.
- SubState (MQCFIN)
- Current action being performed by the channel (parameter identifier: MQIACH_CHANNEL_SUBSTATE).
The value can be:
- MQCHSSTATE_CHADEXIT
- Running channel auto-definition exit.
- MQCHSSTATE_COMPRESSING
- Compressing or decompressing data.
- MQCHSSTATE_END_OF_BATCH
- End of batch processing.
- MQCHSSTATE_HANDSHAKING
- SSL handshaking.
- MQCHSSTATE_HEARTBEATING
- Heartbeating with partner.
- MQCHSSTATE_IN_MQGET
- Performing MQGET.
- MQCHSSTATE_IN_MQI_CALL
- Executing an MQ API call, other than an MQPUT or MQGET.
- MQCHSSTATE_IN_MQPUT
- Performing MQPUT.
- MQCHSSTATE_MREXIT
- Running retry exit.
- MQCHSSTATE_MSGEXIT
- Running message exit.
- MQCHSSTATE_NAME_SERVER
- Nameserver request.
- MQCHSSTATE_NET_CONNECTING
- Network connect.
- MQCHSSTATE_OTHER
- Undefined state.
- MQCHSSTATE_RCVEXIT
- Running receive exit.
- MQCHSSTATE_RECEIVING
- Network receive.
- MQCHSSTATE_RESYNCHING
- Resynching with partner.
- MQCHSSTATE_SCYEXIT
- Running security exit.
- MQCHSSTATE_SENDEXIT
- Running send exit.
- MQCHSSTATE_SENDING
- Network send.
- MQCHSSTATE_SERIALIZING
- Serialized on queue manager access.
- XmitQName (MQCFST)
- Transmission queue name (parameter identifier: MQCACH_XMIT_Q_NAME).
The maximum length of the string is MQ_Q_NAME_LENGTH.
- XQTime (MQCFIL)
- Transmission queue time indicator (parameter identifier: MQIACH_XMITQ_TIME_INDICATOR). The time, in microseconds, that messages remained on the transmission queue before being retrieved. The time is measured from when the message is put onto the transmission queue until it is retrieved to be sent on the channel and, therefore, includes any interval caused by a delay in the putting application.
Two values are returned:
- A value based on recent activity over a short period of time.
- A value based on activity over a longer period of time.
Where no measurement is available, the value MQMON_NOT_AVAILABLE is returned.
Parent topic:
Inquire Channel Status (Response)
pc12480_
Home