createSIBWMQServer 命令

使用 createSIBWMQServer 命令在单元作用域中创建新的 WebSphere® MQ 服务器。

可以使用 wsadmin 工具 (如本主题中所述) 或使用管理控制台 (如创建 WebSphere MQ 服务器定义中所述) 来创建新的 WebSphere MQ 服务器。

要运行该命令，请使用 wsadmin 脚本编制客户机的 AdminTask 对象。

[IBM i] [IBM i] wsadmin 脚本编制客户机从 Qshell 运行。

为服务集成总线的命令提供了命令行帮助：

要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简短描述，请在 wsadmin 提示符处输入以下命令：
print AdminTask.help('SIBAdminCommands')
要获取特定命令的概述帮助，请在 wsadmin 提示符下输入以下命令：
print AdminTask.help('command_name')

使用该命令后，使用以下命令将更改保存到主配置。

AdminConfig.save()

用途

WebSphere MQ 服务器表示 WebSphere MQ 队列管理器或 (对于 WebSphere MQ for z/OS) 队列共享组。此命令在单元作用域中创建新的 WebSphere MQ 服务器，并使用提供的值来填充其参数。

注: 创建 WebSphere MQ 服务器时，了解 -name 和 -serverName 参数的重要性非常重要。例如，如果 WebSphere Application Server 管理创建了名为 My European area server 的 WebSphere MQ 服务器对象，该对象使用 serverName QM1表示 WebSphere MQ 队列管理器。然后， WebSphere Application Server 管理可以创建另一个名为 My UK country server的 WebSphere MQ 服务器对象，该对象还表示与 serverName QM1相同的 WebSphere MQ 队列管理器。

目标对象

WebSphere Application Server 单元。

必需参数

-name

WebSphere MQ 服务器的名称。此值仅用于管理目的，并且可以由管理员确定。该名称仅在 WebSphere Application Server 管理中有意义，并且在单元级别必须唯一。无缺省值。此参数不能修改。

-serverName

队列管理器或队列共享组的名称。此值是标识队列管理器或队列共享组的名称，由 WebSphere MQ 管理分配给该 WebSphere MQ 对象。 WebSphere Application Server 管理员必须始终使用 WebSphere MQ 管理分配的名称。

-host

在与队列管理器或队列共享组进行通信时要连接的主机。此值是此 WebSphere MQ 服务器所表示的队列管理器或队列共享组的主机名或 IP 地址。此值是字符串，它必须是下列其中一项：

符号主机名
IPv4 地址
IPv6 地址

-transportChain

与 WebSphere MQ建立连接时要使用的通道框架出站传输链。如果未指定此选项，那么将使用缺省值 OutboundBasicWMQClient。

条件参数

无

可选参数

可选的主机，端口，通道和认证别名属性一起指定此 WebSphere MQ 服务器的连接访问路径，用于在服务集成中运行的消息传递应用程序。有关更多信息，请参阅 WebSphere MQ 服务器: 连接和认证。

-port

此 WebSphere MQ 服务器表示侦听的队列管理器或队列共享组的 TCP/IP 端口号。缺省值为 1414。

-channel

连接到此 WebSphere MQ 服务器所代表的队列管理器或队列共享组时要使用的 WebSphere MQ 客户机通道名称。此值是由 WebSphere MQ 管理分配给 WebSphere MQ 对象的名称，并且必须始终由 WebSphere Application Server 管理使用。缺省值为 SYSTEM.DEF.SVRCONN。

-description

WebSphere MQ 服务器的简短描述。此值仅用于管理。

-securityAuthAlias

连接到队列管理器或队列共享组时要使用的认证别名。请勿将此参数与发现认证别名混淆。

-trustUserIds

确定服务集成总线是否将从 WebSphere MQ 消息中接收的用户标识与消息一起传递。应用程序用户标识始终是通过 jsAppUserId RFH2 值设置的。如果不存在此用户标识（由于 RFH2 头未包含键/值对，或者由于消息未带有 RFH2 头），那么不会设置此字段。如果将此值设置为 FALSE，那么将使用 WebSphere MQ 服务器名称覆盖用户标识。此参数有两个可能的值：

TRUE: 用户标识将传播至消息。
FALSE: 用户标识将不会传播至消息。

缺省值为 True。

-allowDiscovery

确定是否执行 WebSphere MQ 资源的自动发现。此参数有两个可能的值：

TRUE: 使用自动发现功能。
FALSE: 不使用自动发现功能。

缺省值为 True。

-discoveryAuthAlias

在与队列管理器或队列共享组建立资源发现连接时使用的认证别名。请勿将此值与安全性认证别名混淆。

-replyToQueue

执行资源发现操作时使用的应答队列。此值是 WebSphere MQ 管理分配给 WebSphere MQ 对象的名称，并且必须是临时动态队列的模型队列的名称。 WebSphere Application Server 管理员必须始终使用 WebSphere MQ 管理分配的名称。缺省值为 SYSTEM.DEFAULT.MODEL.QUEUE。

-type

确定 WebSphere MQ 服务器对象是队列管理器还是队列共享组，如 WebSphere Application Server 管理所确定。此参数有两个可能的值：

MQ_QUEUE_MANAGER: WebSphere MQ 服务器表示队列管理器。如果选择此值，那么资源发现过程将检索属于队列管理器的队列名。
MQ_QUEUE_SHARING_GROUP: WebSphere 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}