从Microfocus Enterprise Server连接主机MQ管理器的配置求助

一、主机端本地队列适配Microfocus配置 #

先明确你使用的主机队列类型（CICS TDQ/TSQ、MQ队列或VSAM队列），不同类型适配方式略有差异：

• CICS TDQ/TSQ适配：
  1. 主机端需保证队列的记录长度、临时/永久类型与Microfocus ES侧完全一致，否则会出现消息截断或队列无法识别的问题
  2. 主机CICS必须开启Bridge服务，配置好TCP/IP端口（默认1435），并开放ES服务器的IP访问权限
  3. 在ES的CICS区域中，通过DEFINE TDQ命令创建远程队列映射，指定REMOTESYSTEM为主机CICS的系统标识，REMOTEQUEUE为主机端的队列名
• MQ队列适配：
  1. 主机MQ队列管理器需配置SVRCONN通道，允许ES的MQ客户端发起连接
  2. ES侧安装MQ客户端，修改mqclient.ini文件指向主机MQ队列管理器的IP和端口，随后在ES中定义MQ队列别名关联主机队列

二、XAR事务资源配置核心注意点 #

针对你已配置的XAR，以下几个字段容易踩坑：

• Resource Name：必须与主机端事务资源的标识完全匹配（比如MQ队列管理器名、CICS系统名），字符差异会导致连接失败
• XAR Library Path：需指向Microfocus自带的XAR驱动（Linux为libmfxa.so，Windows为mfxa.dll），路径错误会引发事务初始化失败
• Transaction Timeout：该值要与主机端的事务超时时间对齐，避免主机仍在处理时ES侧提前超时回滚，造成数据不一致
• Recovery Options：务必开启Enable Recovery，同时指定日志目录，否则事务异常后无法恢复，易导致数据丢失

三、Listener配置关键参数说明 #

Listener是对接主机队列的入口，这些参数需谨慎设置：

• Listener Type：根据队列类型选择，比如对接CICS TDQ选CICS Bridge Listener，对接MQ选MQ Listener
• Connection Parameters：主机IP、端口需填写准确，认证用的用户名密码必须是主机端已授权的账号，否则会被拦截
• Message Processing Mode：存/取数据双向交互场景选Request-Reply，单向读消息场景选One-Way
• Error Handling：设置合理的重试次数和间隔，避免网络波动导致消息处理失败；同时配置死信队列，处理失败的消息会自动转入，便于后续排查

四、服务器与客户端联动配置 #

• Microfocus ES服务器端：
  1. 用cicscp -v list resources命令验证队列、XAR、Listener配置是否加载成功，未加载则重启CICS区域
  2. 将客户端用户加入CICSUSER组，避免客户端连接时被权限拦截
• 客户端：
  1. 使用Microfocus提供的API（比如EXEC CICS调用、MQI接口）编写程序，连接参数需与ES侧Listener的配置完全一致
  2. 测试时先运行简单的存/取消息用例，验证连通性和数据一致性

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