MQCMD_INQUIRE_CHANNEL_STATUS (查询通道状态) 响应
"查询通道状态" (MQCMD_INQUIRE_CHANNEL_STATUS) PCF 命令的响应由后跟多个结构的响应头组成。
ChannelName结构
ChannelDisposition结构 (仅适用于 z/OS® ) ,ChannelInstanceType结构ChannelStatus结构 (在其 ChannelInstanceType 参数的值为 MQOT_SAVED_CHANNEL 的 z/OS 通道上除外)。- ChannelType 结构
- ConnectionName 结构
- RemoteApplTag 结构
- RemoteQMgrName 结构
- StopRequested 结构
- XmitQName 结构
在 z/OS上,在 IBM® MQ 9.3.0之前,如果 BytesSent 或 BytesReceived 的值超过 999999999 ,那么会对其进行换行。
在所有平台上,从 IBM MQ 9.3.0开始,如果 BuffersSent 或 BytesReceived 的值超过 999999999 ,那么会将其换行。
- 始终返回:
,
ChannelDispositionChannelInstanceType,ChannelName,ChannelStatus,ChannelType,ConnectionName,RemoteApplTag,RemoteQMgrName,StopRequested,SubState,XmitQName- 如果请求,返回:
Batches,BatchSize,BatchSizeIndicator,BuffersReceived,BuffersSent,BytesReceived,BytesSent,ChannelMonitoring,ChannelStartDate,ChannelStartTime,CompressionRate,CompressionTime,CurrentLUWID,CurrentMsgs,CurrentSequenceNumber,CurrentSharingConversations,ExitTime,HeaderCompression,HeartbeatInterval,InDoubtStatus,KeepAliveInterval,LastLUWID,LastMsgDate,LastMsgTime,LastSequenceNumber,LocalAddress,LongRetriesLeft,MaxMsgLength,MaxSharingConversations,MCAJobName,MCAStatus,MCAUserIdentifier,MessageCompression,Msgs,MsgsAvailable,NetTime,NonPersistentMsgSpeed,QMgrName,RemoteVersion,RemoteProduct,SecurityProtocol,ShortRetriesLeft,SSLCertRemoteIssuerName,SSLCertUserId,SSLKeyResetDate,SSLKeyResets,SSLKeyResetTime,SSLShortPeerName,XQTime
响应数据
- 批处理 (MQCFIN)
- 已完成的批处理数 (参数标识:MQIACH_批处理)。
- BatchSize (MQCFIN)
- 协商的批处理大小 (参数标识 :MQIACH_BATCH_SIZE)。
- BatchSizeIndicator (MQCFIL)
- 批处理中消息数的指示符 (参数标识 :MQIACH_BATCH_SIZE_INDICATOR)。 按以下顺序返回两个值:
![[UNIX、Linux、Windows、IBM i]](ngmulti.gif)
- 基于长期活动的数值。
- 基于短期近期活动的值。
![[z/OS]](ngzos.gif)
- 基于短期近期活动的值。
- 基于较长时间段内的活动的值。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
- BuffersReceived (MQCFIN)
- 接收的缓冲区数 (参数标识 :MQIACH_BUFFERS_RCVD)。
- BuffersSent (MQCFIN)
- 发送的缓冲区数 (参数标识 :MQIACH_BUFFERS_SENT)。
- BytesReceived (MQCFIN)
- 接收的字节数 (参数标识 :MQIACH_BYTES_RCVD)。
- BytesSent (MQCFIN)
- 发送的字节数 (参数标识 :MQIACH_BYTES_SENT)。
ChannelDisposition (MQCFIN)- 通道处置 (参数标识 :MQIACH_CHANNEL_DISP)。 此参数仅在 z/OS上有效。值可以是以下任意值:
- MQCHLD_PRIVATE
- 专用通道的状态信息。
- MQCHLD_SHARED
- 共享通道的状态信息。
- mqchld_fixshared
- 与特定队列管理器绑定的共享通道的状态信息。
- ChannelInstanceType (MQCFIN)
- 通道实例类型 (参数标识 :MQIACH_CHANNEL_INSTANCE_TYPE)。值可以是以下任意值:
- mqot_current_channel
- 当前通道状态。
- mqot_saved_channel
- 已保存通道状态。
mqot_short_channel- 短通道状态,仅在 z/OS上。
- ChannelMonitoring (MQCFIN)
- 通道的当前监视数据收集级别 (参数标识 :MQIA_MONITORING_CHANNEL)。值可以是以下任意值:
- MQMON_OFF
- 已禁用对通道的监视。
- MQMON_LOW
- 数据收集率低。
- MQMON_MEDIUM
- 数据收集的中等速率。
- MQMON_HIGH
- 数据收集率高。
- ChannelName (MQCFST)
- 通道名称 (参数标识 :MQCACH_CHANNEL_NAME)。
字符串的最大长度为 MQ_CHANNEL_NAME_LENGTH。
- ChannelStartDate (MQCFST)
- 日期通道已启动,格式为
yyyy-mm-dd(参数标识 :MQCACH_CHANNEL_START_DATE)。字符串的最大长度为 MQ_CHANNEL_DATE_LENGTH。
- ChannelStartTime (MQCFST)
- 时间通道已启动,格式为
hh.mm.ss(参数标识 :MQCACH_CHANNEL_START_TIME)。字符串的最大长度为 MQ_CHANNEL_TIME_LENGTH。
ChannelStatistics (MQCFIN)- 指定是否收集通道的统计数据 (参数标识:
MQIA_STATISTICS_CHANNEL)。值可以是:MQMON_OFF- 已关闭统计信息数据收集。
MQMON_LOW- 开启了统计信息数据收集,数据收集比率较低。
MQMON_MEDIUM- 开启统计信息数据收集,数据收集比率适中。
MQMON_HIGH- 开启了统计信息数据收集,数据收集的比率很高。
在 z/OS 系统上,启用此参数会直接开启统计信息数据收集,而不考虑您选择的值。 指定 LOW、MEDIUM 或 HIGH 对您的结果没有差别。 必须启用此参数才能收集通道记帐记录。
此参数仅在 z/OS上有效。
- ChannelStatus (MQCFIN)
- 通道状态 (参数标识 :MQIACH_CHANNEL_STATUS)。通道状态定义了以下值:
- MQCHS_绑定
- 渠道正在与合作伙伴协商。
- 正在启动MQCHS_STAR丁
- 通道正在等待变为活动状态。
- MQCHS_RUNNING
- 通道正在传输或等待消息。
- MQCHS_暂停
- 通道已暂停。
- MQCHS_正在停止
- 通道正在停止。
- MQCHS_RE试用
- 通道正在重新尝试建立连接。
- MQCHS_停止
- 通道已停止。
- MQCHS_请求
- 请求者通道正在请求连接。
- MQCHS_交换机
- 通道正在切换传输队列。
- MQCHS_初始化
- 通道正在初始化。
- ChannelType (MQCFIN)
- 通道类型 (参数标识 :MQIACH_CHANNEL_TYPE)。值可以是以下任意值:
- MQCHT_SENDER
- 发送方。
- MQCHT_SERVER
- 服务器。
- MQCHT_RECEIVER
- 接收器。
- mqcht_requester
- 请求者。
- MQCHT_SVRCONN
- 服务器连接 (供客户机使用)。
- MQCHT_CLNTCONN
- 客户机连接。
- MQCHT_CLUSRCVR
- 集群接收方。
- MQCHT_CLUSSDR
- 集群发送方。
- CompressionRate (MQCFIL)
- 达到的压缩率显示为最接近的百分比 (参数标识 :MQIACH_COMPRESSION_RATE)。 按以下顺序返回两个值:
![[UNIX、Linux、Windows、IBM i]](ngmulti.gif)
- 基于长期活动的数值。
- 基于短期近期活动的值。
![[z/OS]](ngzos.gif)
- 基于短期近期活动的值。
- 基于较长时间段内的活动的值。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
- CompressionTime (MQCFIL)
- 压缩或解压期间每条消息所耗用的时间量 (以微秒为单位) (参数标识 :MQIACH_COMPRESSION_TIME)。 按以下顺序返回两个值:
![[UNIX、Linux、Windows、IBM i]](ngmulti.gif)
- 基于长期活动的数值。
- 基于短期近期活动的值。
![[z/OS]](ngzos.gif)
- 基于短期近期活动的值。
- 基于较长时间段内的活动的值。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
- ConnectionName (MQCFST)
- 连接名称 (参数标识 :MQCACH_CONNECTION_NAME)。
在 多平台上,字符串的最大长度为 264。
在 z/OS 上,字符串的最大长度为 48。 - CurrentLUWID (MQCFST)
- 不确定批处理的逻辑工作单元标识 (参数标识 :MQCACH_CURRENT_LUWID)。
对于发送或接收通道,逻辑工作单元标识与当前批处理有关。
对于发送通道,当通道处于不确定状态时,它是不确定批处理的 LUWID。
已知时,将使用下一个批处理的 LUWID 对其进行更新。
最大长度为 MQ_LUWID_LENGTH。
- CurrentMsgs (MQCFIN)
- 不确定消息数 (参数标识 :MQIACH_CURRENT_MSGS)。
对于发送通道,此参数是当前批处理中已发送的消息数。 它会随着每条消息的发送而递增,当通道变为不确定时,它是处于不确定状态的消息数。
对于接收通道,它是当前批次中已接收的消息数。 每接收一条消息,它就加一。
在落实此批次时,发送通道和接收通道的这个值都复位为零。
- CurrentSequenceNumber (MQCFIN)
- 不确定批处理中最后一条消息的序号 (参数标识 :MQIACH_CURRENT_SEQ_NUMBER)。
对于发送通道,此参数是发送的最后一条消息的消息序号。 将在发送每条消息时更新此消息,并且当通道变为不确定时,此消息是不确定批处理中最后一条消息的消息序号。
对于接收通道,它是上一个接收的消息的消息序号。 每接收一条消息,就更新此值。
- CurrentSharingConversations (MQCFIN)
- 此通道实例上当前处于活动状态的对话数 (参数标识 :MQIACH_CURRENT_SHARING_CONVS)。
仅对 TCP/IP 服务器连接通道返回此参数。
值为零表示通道实例正在 IBM WebSphere® MQ 7.0之前的方式下运行,有关:- 管理员停止-停顿
- 正在发出脉动信号
- 提前读取
- 客户机异步耗用
- ExitTime (MQCFIL)
- 指示每条消息执行用户出口所花费的时间 (参数标识 :MQIACH_EXIT_TIME_INDICATOR)。 每条消息处理用户出口所耗用的时间量 (以微秒为单位)。 其中,每个消息执行多个出口,该值是单个消息的所有用户出口时间的总和。 按以下顺序返回两个值:
![[UNIX、Linux、Windows、IBM i]](ngmulti.gif)
- 基于长期活动的数值。
- 基于短期近期活动的值。
![[z/OS]](ngzos.gif)
- 基于短期近期活动的值。
- 基于较长时间段内的活动的值。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
- HeaderCompression (MQC一场)
- 是否压缩通道发送的头数据 (参数标识 :MQIACH_HDR_COMPRESSION)。 会返回两个值:
- 为此通道协商的缺省头数据压缩值。
- 用于所发送的最后消息的头数据压缩值。 在发送通道消息出口处,头数据压缩值可被改变。 如果未发送任何消息,那么第二个值为 MQCOMPRESS_NOT_AVAILABLE。
值可以是:
- MQCOMPRESS_NONE
- 不执行头数据压缩。 MQCOMPRESS_NONE 是缺省值。
- mqcompress_system
- 执行头数据压缩。
- mqcompress_not_available
- 通道未发送任何消息。
- HeartbeatInterval (MQCFIN)
- 脉动信号间隔 (参数标识 :MQIACH_HB_INTERVAL)。
- InDoubtStatus (MQCFIN)
- 通道当前是否处于不确定状态 (参数标识 :MQIACH_INDOUBT-status)。
仅当发送消息通道代理程序正在等待已成功接收到的一批消息的确认时,发送通道才处于不确定状态。 在所有其他时间 (包括发送消息的时间段) ,但在请求应答之前,都没有疑问。
接收通道从未处于不确定状态。
值可以是以下任意值:- mqchids_not_indoubt
- 通道未处于不确定状态。
- mqchids_indoubt
- 通道处于不确定状态。
- KeepAliveInterval(MQCFIN)
- KeepAlive 时间间隔 (参数标识 :MQIACH_KEEP_ALIVE_INTERVAL)。 此参数仅在 z/OS上有效。
- LastLUWID (MQCFST)
- 上次落实的批处理的逻辑工作单元标识 (参数标识 :MQCACH_LAST_LUWID)。
最大长度为 MQ_LUWID_LENGTH。
- LastMsgDate (MQCFST)
- 发送最后一条消息或处理 MQI 调用的日期,格式为
yyyy-mm-dd(参数标识 :MQCACH_LAST_MSG_DATE)。字符串的最大长度为 MQ_CHANNEL_DATE_LENGTH。
- LastMsgTime (MQCFST)
- 上次发送消息或处理 MQI 调用的时间,格式为
hh.mm.ss(参数标识 :MQCACH_LAST_MSG_TIME)。字符串的最大长度为 MQ_CHANNEL_TIME_LENGTH。
- LastSequenceNumber (MQCFIN)
- 上次落实批处理中最后一条消息的序号 (参数标识 :MQIACH_LAST_SEQ_NUMBER)。
- LocalAddress (MQCFST)
- 通道的本地通信地址 (参数标识 :MQCACH_LOCAL_ADDRESS)。
字符串的最大长度为 MQ_LOCAL_ADDRESS_LENGTH。
- LongRetriesLeft (MQCFIN)
- 剩余的长时间重试尝试次数 (参数标识 :MQIACH_LONG_REPES_LEFT)。
- MaxMsgLength (MQCFIN)
- 最大消息长度 (参数标识 :MQIACH_MAX_MSG_LENGTH)。 此参数仅在 z/OS上有效。
- MaxSharingConversations (MQCFIN)
- 此通道实例上允许的最大对话数。 (参数标识 :MQIACH_MAX_SHARING_CONVS)
仅对 TCP/IP 服务器连接通道返回此参数。
值为零表示通道实例正在 IBM WebSphere MQ 7.0之前的方式下运行,有关:- 管理员停止-停顿
- 正在发出脉动信号
- 提前读取
- 客户机异步耗用
- MCAJobName (MQCFST)
- MCA 作业的名称 (参数标识 :MQCACH_MCA_JOB_NAME)。
字符串的最大长度为 MQ_MCA_JOB_NAME_LENGTH。
- MCA状态(MQCFIN)
- MCA 状态 (参数标识 :MQIACH_MCA_STATUS)。值可以是以下任意值:
- MQMCAS_STOPPED
- 消息通道代理程序已停止。
- MQMCAS_正在运行
- 消息通道代理程序正在运行。
- MCAUserIdentifier (MQCFST)
- MCA 使用的用户标识 (参数标识 :MQCACH_MCA_USER_ID)。
此参数仅适用于服务器连接通道、接收方通道、请求方通道和集群接收方通道。
字符串的最大长度为 MQ_MCA_USER_ID_LENGTH。
- MessageCompression (MQCFIL)
- 是否压缩通道发送的消息数据 (参数标识 :MQIACH_MSG_COMPRESSION)。 会返回两个值:
- 为此通道协商的缺省消息数据压缩值。
- 用于所发送的最后消息的消息数据压缩值。 在发送通道消息出口处,会更改消息数据压缩值。 如果未发送任何消息,那么第二个值为 MQCOMPRESS_NOT_AVAILABLE。
值可以是:
- MQCOMPRESS_NONE
- 不执行消息数据压缩。 MQCOMPRESS_NONE 是缺省值。
- MQCOMPRESS_RLE
- 使用运行长度编码执行消息数据压缩。
- mqcompress_zlibfast
- 使用速度优先的 ZLIB 编码来执行消息数据压缩。
- mqcompress_zlibhigh
- 使用具有压缩优先级的 ZLIB 编码来执行消息数据压缩。
- mqcompress_not_available
- 通道未发送任何消息。
- 消息数 (MQCFIN)
- 发送或接收的消息数或处理的 MQI 调用数 (参数标识 :MQIACH_MSGS)。
- MsgsAvailable (MQCFIN)
- 可用消息数 (参数标识 :MQIACH_XMITQ_MSGS_AVAILABLE)。 在传输队列中排队的消息数,此传输队列可用于通道以进行 MQGET 操作。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
此参数仅适用于集群发送方通道。
- NetTime (MQCFIL)
- 网络操作时间的指示符 (参数标识 :MQIACH_NETWORK_TIME_INDICATOR)。 将请求发送到通道的远程端并接收响应的时间量 (以微秒为单位)。 此时间仅衡量此类操作的网络时间。 按以下顺序返回两个值:
![[UNIX、Linux、Windows、IBM i]](ngmulti.gif)
- 基于长期活动的数值。
- 基于短期近期活动的值。
![[z/OS]](ngzos.gif)
- 基于短期近期活动的值。
- 基于较长时间段内的活动的值。
如果没有可用的度量,那么将返回值 MQMON_NOT_AVAILABLE。
- NonPersistentMsgSpeed (MQCFIN)
- 发送非持久消息的速度 (参数标识 :MQIACH_NPM_SPEED)。值可以是以下任意值:
- MQNPMS_NORMAL
- 正常速度。
- MQNPMS_快速
- 速度很快。
- QMgrName (MQCFST)
- 拥有通道实例的队列管理器的名称 (参数标识 :MQCA_Q_MGR_NAME)。 此参数仅在 z/OS上有效。
字符串的最大长度为 MQ_Q_MGR_NAME_LENGTH。
- RemoteApplTag (MQCFST)
- 远程伙伴应用程序名称。 此参数是通道远程端的客户机应用程序的名称。 此参数仅适用于服务器连接通道 (参数标识 :MQCACH_REMOTE_APPL_TAG)。
- RemoteProduct (MQCFST)
- 远程伙伴产品标识。 此参数是在通道远程端运行的 IBM MQ 代码的产品标识 (参数标识 :MQCACH_REMOTE_PRODUCT)。下表中显示了可能的值:
表 1. 产品标识值 产品标识 描述 MQMM 队列管理器 (非 z/OS 平台) MQMV z/OS 上的队列管理器 MQCC IBM MQ C 客户机 MQNM IBM MQ .NET 完全受管客户机 MQJB IBM MQ 用于 Java 的类 MQJM IBM MQ Classes for JMS (正常方式) MQJN IBM MQ Classes for JMS (迁移方式) MQJU MQI 的通用 Java 接口 MQXC XMS 客户机 C/C++(正常模式) MQXD XMS 客户机 C/C++(迁移模式) MQXN XMS 客户机 .NET (正常方式) MQXM XMS 客户机 .NET (迁移方式) MQXU IBM MQ .NET XMS 客户机 (unmanaged/XA) MQNU IBM MQ .NET 非受管客户机 - RemoteVersion (MQCFST)
- 远程伙伴版本。 此参数是在通道远程端运行的 IBM MQ 代码的版本 (参数标识 :MQCACH_REMOTE_VERSION)。远程版本显示为 VVRRMMFF,其中
- VV
- 版本
- RR
- 发行版
- MM
- 维护级别
- FF
- 修订级别
- RemoteQMgrName (MQCFST)
- 远程队列管理器或队列共享组的名称 (参数标识 :MQCA_REMOTE_Q_MGR_NAME)。
- ShortRetriesLeft (MQCFIN)
- 剩余的短重试尝试次数 (参数标识 :MQIACH_SHORT_REPES_LEFT)。
- SecurityProtocol (MQCFIN)
- 定义当前正在使用的安全协议 (参数标识 :MQIACH_SECURITY_PROTOCOL)。
- SSLCertRemoteIssuerName (MQCFST)
- 远程证书发放者的完整专有名称。 颁发者是颁发证书的认证中心 (参数标识 :MQCACH_SSL_CERT_ISSUER_NAME)。
字符串的最大长度为 MQ_SHORT_DNAME_LENGTH。
- SSLCertUserId (MQCFST)
- 与远程证书关联的本地用户标识 (参数标识 :MQCACH_SSL_CERT_USER_ID)。
此参数仅在 z/OS上有效。
字符串的最大长度为 MQ_USER_ID_LENGTH。
- SSLCipherSpecification (MQCFST)
- 连接正在使用的 CipherSpec (参数标识 :MQCACH_SSL_CIPHER_SPEC)。
- SSLKeyResetDate (MQCFST)
- 上次成功重置 TLS 密钥的日期,格式为
yyyy-mm-dd(参数标识 :MQCACH_SSL_KEY_RESET_DATE)。字符串的最大长度为 MQ_DATE_LENGTH。
- SSLKeyResets (MQCFIN)
- TLS 密钥重置 (参数标识 :MQIACH_SSL_KEY_RESETS)。
自通道启动以来,针对此通道实例成功发生的 TLS 密钥重置次数。 如果启用了 TLS 密钥协商,那么每当执行密钥重置时,计数将递增。
- SSLKeyResetTime (MQCFST)
- 上次成功重置 TLS 密钥的时间,格式为
hh.mm.ss(参数标识 :MQCACH_SSL_KEY_RESET_TIME)。字符串的最大长度为 MQ_TIME_LENGTH。
- SSLShortPeerName (MQCFST)
- 通道另一端的对等队列管理器或客户机的专有名称 (参数标识 :MQCACH_SSL_SHORT_PEER_NAME)。
最大长度为 MQ_SHORT_DNAME_LENGTH ,因此将截断较长的专有名称。
- StopRequested (MQCFIN)
- 用户停止请求是否未完成 (参数标识 :MQIACH_STOP_REQUESTED)。值可以是以下任意值:
- mqchsr_stop_not_requested
- 未接收到用户停止请求。
- 已请求 MQCHSR_STOP_REQUESTED
- 已接收到用户停止请求。
- SubState (MQCFIN)
- 通道正在执行的当前操作 (参数标识 :MQIACH_CHANNEL_SUBSTATE)。值可以是以下任意值:
- mqchsstate_chadexit
- 正在运行通道自动定义出口。
- MQCHSSTATE_正在压缩
- 正在压缩或解压缩数据。
- mqchsstate_end_of_batch
- 批处理结束。
- MQCHSSTATE_HAND震动
- TLS 握手。
- MQCHSSTATE_HEART跳动
- 和搭档一起打心跳
- mqchsstate_in_mqget
- 正在执行 MQGET。
- mqchsstate_in_mqi_call
- 执行除 MQPUT 或 MQGET 以外的 IBM MQ API 调用。
- mqchsstate_in_mqput
- 正在执行 MQPUT。
- mqchsstate_mrexit
- 正在运行重试出口。
- mqchsstate_msgexit
- 正在运行消息出口。
- mqchsstate_name_server
- 名称服务器请求。
- MQCHSSTATE_NET_CONNEC丁
- 网络连接。
- mqchsstate_other
- 未定义状态。
- mqchsstate_rcvexit
- 正在运行接收出口。
- MQCHSSTATE_正在接收
- 网络接收。
- mqchsstate_resynching
- 正在与合作伙伴再同步。
- mqchsstate_scyexit
- 正在运行安全出口。
- mqchsstate_sendexit
- 正在运行发送出口。
- MQCHSSTATE_正在发送
- 网络发送。
- MQCHSSTATE_SERI正在进行序列化
- 对队列管理器访问进行序列化。
- XmitQName (MQCFST)
- 传输队列名称 (参数标识 :MQCACH_XMIT_Q_NAME)。
字符串的最大长度为 MQ_Q_NAME_LENGTH。
- XQ时间(MQCFIL)
- 此参数仅适用于发送方,服务器和集群发送方通道。
MQSECPROT_SSLV30
MQSECPROT_TLSV13