createSIBWMQServer 命令
使用 createSIBWMQServer 命令在单元范围内创建新的 IBM MQ 服务器。
可按本主题中所述使用 wsadmin 工具创建新的 IBM MQ 服务器,或按创建 IBM MQ 服务器定义中所述使用管理控制台进行创建。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
![[IBM i]](../images/iseries.gif)
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
IBM MQ 服务器表示 IBM MQ 队列管理器或(对于 IBM MQ for z/OS)队列共享组。此命令在单元作用域内创建新的 IBM MQ 服务器,并使用提供的值来填充其参数。
注: 创建 IBM MQ
服务器时,应了解 -name 和 -serverName 参数的重要性。例如,WebSphere Application Server
管理员创建了一个名为“My
European area server”的 IBM MQ 服务器对象,该对象表示
serverName 为 QM1 的 IBM MQ 队列管理器。然后,WebSphere Application Server
管理员可创建另一个名为“My UK country server”的 IBM MQ 服务器对象,该对象也表示 serverName 为
QM1 的同一 IBM MQ 队列管理器。
目标对象
WebSphere Application Server 单元。
必需参数
- -name
- IBM MQ 服务器的名称。此值仅用于管理目的,并且可以由管理员确定。此名称只有在 WebSphere Application Server 管理中才有意义,并且在单元级别必须唯一。没有缺省值。此参数不能修改。
- -serverName
- 队列管理器或队列共享组的名称。此值是用于标识队列管理器或队列共享组的名称,并且是由 IBM MQ 管理为该 IBM MQ 对象分配的。WebSphere Application Server 管理员必须始终使用 IBM MQ 管理分配的名称。
- -host
- 在与队列管理器或队列共享组进行通信时要连接的主机。此值是此 IBM MQ
服务器所代表的队列管理器或队列共享组的主机名或 IP 地址。此值是字符串,它必须是下列其中一项:
- 符号主机名
- IPv4 地址
- IPv6 地址
- -transportChain
- 在与 IBM MQ建立连接时要使用的通道框架出站传输链。如果未指定此选项,那么将使用缺省值 OutboundBasicWMQClient。
条件参数
无
可选参数
可选的主机、端口、通道和认证别名属性共同为服务集成中运行的消息传递应用程序指定此 IBM MQ 服务器的连接访问路径。有关更多信息,请参阅 IBM MQ 服务器:连接和认证。
- -port
- 此 IBM MQ 服务器所代表的队列管理器或队列共享组所侦听的 TCP/IP 端口号。缺省值是 1414。
- -channel
- 连接到此 IBM MQ 服务器所代表的队列管理器或队列共享组时要使用的 IBM MQ 客户机通道名。此值是 IBM MQ 管理分配给 IBM MQ 对象的名称,WebSphere Application Server 管理必须始终使用此名称。缺省值为 SYSTEM.DEF.SVRCONN。
- -description
- IBM MQ 服务器的简要描述。此值仅用于管理。
- -securityAuthAlias
- 连接到队列管理器或队列共享组时要使用的认证别名。请勿将此参数与发现认证别名混淆。
- -trustUserIds
- 确定是否将在消息(来自IBM MQ)中接收到的用户标识与服务集成总线发送的消息一起传递。应用程序用户标识始终是通过
jsAppUserId RFH2 值设置的。如果不存在此用户标识(由于
RFH2 头未包含键/值对,或者由于消息未带有 RFH2 头),那么不会设置此字段。如果将此值设置为 FALSE,那么用户标识将被
IBM MQ 服务器名称覆盖。此参数有两个可能的值:
- TRUE
- 用户标识将传播至消息。
- FALSE
- 用户标识将不会传播至消息。
- -allowDiscovery
- 确定是否自动发现 IBM MQ 资源。此参数有两个可能的值:
- TRUE
- 使用自动发现功能。
- FALSE
- 不使用自动发现功能。
- -discoveryAuthAlias
- 在与队列管理器或队列共享组建立资源发现连接时使用的认证别名。请勿将此值与安全性认证别名混淆。
- -replyToQueue
- 执行资源发现操作时使用的应答队列。此值是 IBM MQ 管理为 IBM MQ 对象分配的名称,它必须是临时动态队列的模型队列名。WebSphere Application Server 管理员必须始终使用 IBM MQ 管理分配的名称。 缺省值为 SYSTEM.DEFAULT.MODEL.QUEUE。
- -type
- 确定 IBM MQ 服务器对象是队列管理器还是队列共享组,这是由 WebSphere Application Server 管理确定的。此参数有两个可能的值:
- MQ_QUEUE_MANAGER
- IBM MQ 服务器表示队列管理器。如果选择此值,那么资源发现过程将检索属于队列管理器的队列名。
- MQ_QUEUE_SHARING_GROUP
- IBM MQ 服务器表示队列共享组。如果选择此值,那么资源发现过程将检索属于队列共享组的队列名。
- -bindingsMode
- 确定连接到队列管理器或队列共享组时是否使用绑定传输方式连接。仅当应用程序服务器与队列管理器在同一节点上时,才能使用绑定方式连接。在绑定方式下,即使同一节点上有多个队列管理器,也只能连接到单个队列管理器。此参数有两个可能的值:
- TRUE
- 在绑定方式可用时使用此方式。如果选择此选项,但绑定方式不可用,那么连接机制将缺省为客户机传输方式。
- FALSE
- 始终使用客户机方式。
示例
- 使用 Jython:
wsadmin>AdminTask.createSIBWMQServer(["-name", "Finance dept QM", "-serverName", "FDQM", "-type", "MQ_QUEUE_MANAGER", "-bindingsMode", "true", "-host", "findep01.ibm.com", "-port", 1414, "-transportChain", "OutboundSecureWMQClient"]) - 使用 Jacl:
wsadmin>$AdminTask createSIBWMQServer {-name "Finance dept QM" -serverName FDQM -type MQ_QUEUE_MANAGER -bindingsMode true -host findep01.ibm.com -port 1414 -transportChain OutboundSecureWMQClient}
参考主题