XMS .NET 受管对象的属性映射

要使 XMS .NET 应用程序能够使用 IBM® MQ JMS WebSphere® Application Server 连接工厂和目标对象定义,必须将从这些定义中检索到的属性映射到可以在 XMS 连接工厂和目标上设置的相应 XMS 属性。

例如,要创建具有从 IBM MQ JMS 连接工厂检索的属性的 XMS 连接工厂,必须在这两者之间映射这些属性。

将自动执行所有属性映射。

表 1 演示了连接工厂和目标的一些最常见属性之间的映射。 此表中显示的属性只是一小部分示例,并非所有这些属性都适用于所有连接类型和服务器。
表 1. 连接工厂和目标属性的名称映射示例
IBM MQ JMS 属性名 XMS 属性名 WebSphere Application Server service integration bus 属性名
PERSISTENCE (PER) XMSC_DELIVERY_MODE  
EXPIRY (EXP) XMSC_TIME_TO_LIVE
PRIORITY (PRI) XMSC_PRIORITY
  XMSC_WPM_HOST_NAME serverName
XMSC_WPM_BUS_NAME busName
XMSC_WPM_TOPIC_SPACE topicName
注: 表 2 中显示的属性适用于 JMS 以及 XMS .NET
表 2. XMS .NET 属性
属性 对象类型
CF QCF TCF 队列 Topic
APPLICATIONNAME Y Y Y 不适用 不适用
ASYNCEXCEPTION Y Y Y 不适用 不适用
CCDTURL Y Y Y 不适用 不适用
CHANNEL Y Y Y 不适用 不适用
CONNECTIONNAMELIST Y Y Y 不适用 不适用
CLIENTRECONNECTOPTIONS Y Y Y 不适用 不适用
CLIENTRECONNECTTIMEOUT Y Y Y 不适用 不适用
CLIENTID 不适用 Y 不适用 不适用 不适用
COMPHDR 1 Y 不适用 Y 不适用 不适用
COMPMSG 1 Y Y Y 不适用 不适用
CONNOPT 1 Y Y Y 不适用 不适用
CONNTAG 1 Y Y Y 不适用 不适用
描述 1 不适用 Y 不适用 Y Y
到期 1 不适用 不适用 不适用 Y Y
FAILIFQUIESCE Y Y Y Y Y
HOSTNAME 不适用 Y 不适用 不适用 不适用
LOCALADDRESS 不适用 Y 不适用 不适用 不适用
PERSISTENCE 不适用 不适用 不适用 Y Y
PORT 不适用 Y 不适用 不适用 不适用
PRIORITY 1 不适用 不适用 不适用 Y Y
PROVIDERVERSION 1 不适用 Y 不适用 不适用 不适用
QMANAGER Y Y Y Y 不适用
队列 1 不适用 不适用 不适用 Y 不适用
SHARECONVALLOWED Y Y Y 不适用 不适用
TOPIC 1 不适用 不适用 不适用 不适用 Y
传输 1 不适用 Y 不适用 不适用 不适用
注:
[MQ 9.2.4 2021 年 11 月]

OutboundSNI 属性

IBM MQ 9.2.4 开始,您可以设置 XMSC_WMQ_OUTBOUND_SNI 属性,该属性用于设置应用程序中的 OutboundSNI 属性。

XMSC_WMQ_OUTBOUND_SNI_PROPERTY 采用以下值:
  • XMSC_WMQ_OUTBOUND_SNI_CHANNEL,映射到“CHANNEL”
  • XMSC_WMQ_OUTBOUND_SNI_HOSTNAME,映射到“HOSTNAME”
  • XMSC_WMQ_OUTBOUND_SNI_ASTERISK,映射到“*”
此外,您可以使用 MQOUTBOUND_SNI 环境变量来设置 OutboundSNI 属性,该变量采用以下值:
  • 通道
  • 主机名
  • *
注: 如果未设置特定值,那么此属性缺省为 XMSC_WMQ_OUTBOUND_SNI_CHANNEL。
在受管节点中设置 OutboundSNI 属性的优先顺序如下所示:
  1. 应用程序级别属性
  2. 环境变量

对于非受管节点中的 OutboundSNI 属性,仅支持 mqclient.ini