如何在RPGLE中通过MQSETMP API为MQ RFH2属性名添加前缀

你遇到的现象是IBM MQ的属性前缀校验规则导致的，未在MQ队列管理器注册的自定义顶层前缀会被判定为无效属性直接丢弃，没有有效可保留的属性时MQ就不会生成RFH2头，也不会返回接口错误。

以下是两种可行的解决方案：

方案一：使用MQ原生支持的用户属性前缀（无额外配置，推荐） #

IBM MQ默认预留了usr.作为所有用户自定义属性的顶层前缀，不需要修改任何队列管理器配置即可直接使用：

• 把你需要设置的属性名从ctx.Property1调整为usr.ctx.Property1
• 保持原有MQCRTMH、MQSETMP、MQPUT调用逻辑不变即可，生成的RFH2头会自动将这部分属性放在文件夹下，WRKMQMQ可以正常查询到全部属性

方案二：注册自定义顶层前缀（需修改队列管理器配置） #

如果你必须使用ctx.作为顶层前缀，需要先在队列管理器中完成前缀注册：

1. 先确认队列管理器属性控制配置已开启：
   运行MQSC命令：ALTER QMGR PROPCTL(ALL)
   确保没有设置PROPCTL(NONE)关闭属性保留能力
2. 注册自定义ctx前缀：
   运行MQSC命令：DEFINE PROPERTY(ctx) ALLOCATOR(USER) CONTEXT(APPLICATION) VALIDATION(NO)
   该配置表示ctx.开头的属性为用户自定义业务属性，不需要做格式校验
3. 配置完成后再调用原有API设置ctx.Property1属性，即可正常生成带属性的RFH2消息

注意事项 #

• 调用MQPUT时需确保消息描述符的Format字段设置为MQFMT_RF_HEADER_2
• MQPUT的选项参数不要添加MQPMO_NO_PROPERTIES，该参数会强制丢弃所有消息属性，不会生成RFH2头
• 创建消息句柄MQCRTMH时不要设置MQMH_OPTIONS_FORBID_EMBEDDED_COPY这类限制属性序列化的选项

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