modifySIBWMQServer 命令
使用 modifySIBWMQServer 命令来修改 IBM MQ 服务器。
可按本主题中所述使用 wsadmin 工具修改 IBM MQ 服务器,或按修改 IBM MQ 服务器定义中所述使用管理控制台进行修改。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
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 队列管理器,那么该管理员可创建另一个名为“My UK Country Server”且也表示同一队列管理器的 IBM MQ 服务器。
目标对象
所选 IBM MQ 服务器。
必需参数
- -name
- IBM MQ 服务器的名称。此名称是在创建 IBM MQ 服务器定义时指定的。
条件参数
无
可选参数
- -serverName
- 队列管理器或队列共享组的名称。这是用于标识队列管理器或队列共享组的名称。此值是 IBM MQ 管理分配给 IBM MQ 资源的名称。管理员始终使用 IBM MQ 管理分配的名称。
- -host
- host 属性的新值。此值是主机的名称或 IP 地址,与该主机的连接在与此
IBM MQ 服务器所表示的队列管理器或队列共享组通信时建立。此值是字符串,它必须是下列其中一项:
- 符号主机名
- IPv4 地址
- IPv6 地址
- -bindingsMode
- bindingsMode 属性的新值。此值确定连接到队列管理器或队列共享组时是否使用绑定传输方式连接。仅当应用程序服务器与队列管理器在同一节点上,但即使同一节点上有多个队列管理器也只允许连接到单个队列管理器时,才有可能进行绑定方式连接。此参数有两个可能的值:
- TRUE
- 在绑定方式可用时使用此方式。如果选择此选项,但绑定方式不可用,那么连接机制将缺省为客户机传输方式。
- FALSE
- 始终使用客户机方式。
- -port
- IBM MQ port 属性的新值。此值是此 IBM MQ 服务器所代表的队列管理器或队列共享组侦听的 TCP/IP 端口号。缺省值是 1414。
- -channel
- IBM MQ channel 属性的新值。此值是连接到此 IBM MQ 服务器所代表的队列管理器或队列共享组时要使用的 IBM MQ 客户机通道名。此名称是 IBM MQ 管理分配给 IBM MQ 对象的名称,WebSphere Application Server 管理员必须始终使用此名称。缺省值为 SYSTEM.DEF.SVRCONN。
- -description
- description 属性的新值。此值是 IBM MQ 服务器的简要描述,并且仅用于管理。
- -securityAuthAlias
- securityAuthorizationAlias 属性的新值。此值是连接到队列管理器或队列共享组时要使用的认证别名。此参数与发现认证别名不同。
- -transportChain
- transportChain 属性的新值。此值是与 IBM MQ 建立连接时要使用的出站传输链。缺省值为 OutboundBasicWMQClient。
- -trustUserIds
- trustUserIds 属性的新值。确定在来自
IBM MQ
的消息中接收的用户标识是否传播到消息(即,是否在服务集成总线中使用作为消息数据一部分接收的用户标识)。应用程序用户标识始终是通过
jsAppUserId RFH2 值设置的。如果不存在此用户标识(由于
RFH2 头未包含键/值对,或者由于消息未带有 RFH2 头),那么不会设置此字段。如果将此值设置为 FALSE,那么用户标识将被
IBM MQ 服务器名称覆盖。此参数有两个可能的值:
- TRUE
- 用户标识将传播至消息。
- FALSE
- 用户标识将不会传播至消息。
- -allowDiscovery
- allowDiscovery 属性的新值。此值确定是否自动发现
IBM MQ 资源。此参数有两个可能的值:
- TRUE
- 启用自动资源发现功能。
- FALSE
- 禁用自动资源发现功能。
- -discoveryAuthAlias
- discoveryAuthAlias 属性的新值。此值是与队列管理器或队列共享组建立资源发现连接时使用的认证别名,它与安全性认证别名参数不同。
- -replyToQueue
- replyToQueue 属性的新值。此值是用于发现资源的应答队列的名称,它是 IBM MQ 管理分配给 IBM MQ 对象的名称,并且必须是临时动态队列的模型队列名。WebSphere Application Server 管理与 IBM MQ MQ 管理必须始终使用一致的名称。缺省值为 SYSTEM.DEFAULT.MODEL.QUEUE。
示例
- 使用 Jython:
wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM", "-allowDiscovery", "false"] )
- 使用 Jacl:
wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM" -allowDiscovery false}