求IBM.WMQ.PCF库的.NET官方文档及版本支持，用于MQ监控开发

一、官方文档与版本支持说明 #

• IBM.WMQ.PCF属于IBM MQ .NET客户端组件的一部分，官方没有单独的类文档，相关内容统一整合在对应MQ版本的**.NET开发指南**中，包含API参考、使用示例及版本兼容说明。
• 版本支持：针对.NET Framework 4.6.1，需搭配MQ 9.0及以上版本的客户端（MQ 9.0开始正式支持.NET Framework 4.6+）；更早的MQ客户端版本可能存在兼容性问题。
• 弃用状态：目前IBM官方未宣布IBM.WMQ.PCF的弃用计划，但MQ 9.2及以上版本主推MQ REST API/Admin REST API做监控管理，PCF仍保留对传统场景的支持。

二、基于PCF实现MQ监控的可行方案 #

你需要的队列管理器、队列、监听器、通道信息，均可通过PCF命令获取：

• 队列管理器：使用MQC.MFMT_INQUIRE_Q_MGR命令，可获取名称、运行状态、版本等基础信息。
• 队列：使用MQC.MFMT_INQUIRE_Q命令，支持通配符匹配队列，可获取队列类型、当前深度、最大深度、状态等数据。
• 监听器：使用MQC.MFMT_INQUIRE_LISTENER命令，可查询监听器名称、监听端口、协议、运行状态等。
• 通道：使用MQC.MFMT_INQUIRE_CHANNEL命令，按通道类型查询，可获取通道名称、类型、连接状态、关联传输队列等信息。

核心代码示例（简化版） #

// 初始化PCF客户端连接指定队列管理器
var pcfAgent = new PCFMessageAgent("TARGET_QMGR_NAME");

// 构造查询所有队列的请求
var inquireQueueMsg = new PCFMessage(MQC.MFMT_INQUIRE_Q);
inquireQueueMsg.AddParameter(MQC.MQCA_Q_NAME, "*");

// 发送请求并接收响应
PCFMessage[] responses = pcfAgent.Send(inquireQueueMsg);

// 解析响应数据
foreach (var resp in responses)
{
    string queueName = resp.GetStringParameterValue(MQC.MQCA_Q_NAME);
    int currentDepth = resp.GetIntParameterValue(MQC.MQIA_CURRENT_Q_DEPTH);
    // 按需解析其他字段（如队列状态、最大深度等）
}

// 断开连接
pcfAgent.Disconnect();

三、关键注意事项 #

• 确保MQ客户端版本与目标队列管理器版本兼容，避免因版本差异导致命令不支持。
• 运行客户端的账号需拥有目标队列管理器的查询权限（如inq权限），否则会返回权限错误。
• 跨多MQ服务器监控时，需为每个队列管理器单独创建PCFMessageAgent实例并建立连接。

内容的提问来源于stack exchange，提问作者Sandhiya