modifyWMQConnectionFactory 命令
使用 modifyWMQConnectionFactory 命令来更改 WebSphere® MQ 消息传递提供程序连接工厂的某些参数。
要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin 脚本编制客户机是从 Qshell 运行的。有关更多信息,请参阅“配置 Qshell 以运行 WebSphere Application Server 脚本”主题。
此命令仅适用于 WebSphere Application Server V7 和更高版本的应用程序服务器。请不要对先前版本使用此命令。
要获取可用的 IBM MQ 消息传递提供程序管理命令的列表以及每个命令的简短描述,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('WMQAdminCommands')
要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
在使用这些命令之后,保存对主配置所做的更改。例如,使用以下命令:
AdminConfig.save()
用途
使用 modifyWMQConnectionFactory 命令来修改在发布该命令的范围内所定义的 WebSphere MQ 消息传递提供程序连接工厂。
注: 当修改 WebSphere MQ 消息传递提供程序连接工厂时,在 mappingAlias 和 containerAuthAlias 参数之间存在一个交互。
如果指定 containerAuthAlias 参数但是未指定 mappingAlias 参数,那么将发生此交互。
在此种情况下,mappingAlias 参数将自动设置为 DefaultPrincipleMapping 值。
目标对象
特定作用域上的 WebSphere MQ 消息传递提供程序连接工厂。
必需参数
此命令的参数与那些用于创建 WebSphere MQ 消息传递提供程序连接工厂的参数相同。
可选参数
此命令的参数与那些用于创建 WebSphere MQ 消息传递提供程序连接工厂的参数相同。
注: 如果在未指定
-connectionNameList 参数的情况下指定了 -qmgrHostname 或
-qmgrPortNumber 参数,那么将假定不得再使用连接名称列表与
WebSphere MQ 进行连接,而应该改为使用指定的主机名和端口号信息。因此,-connectionNameList
参数设置为空。
请注意在 -customProperties 参数上的此命令的行为。
- -customProperties
- 此参数将对传递至 WebSphere MQ 消息传递提供程序连接工厂的定制属性进行指定。通常情况下,定制属性用于设置连接工厂的属性,该连接工厂不直接通过 WebSphere 管理接口受到支持。将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
- 使用 Jython:[name value]
- 使用 Jacl:{name value}
使用以下规则,将新的“名称 - 值”对添加到定制属性的现有集合中:- 如果现有属性集不包含(作为修改命令一部分所提供的)具有相同名称的属性,那么所提供的属性将添加至定制属性集,除非定制属性没有指定的值(当忽略定制属性时)。
- 如果现有属性集包含(作为修改命令一部分所提供的)具有相同名称的属性,那么修改命令还将指定属性值,并且提供的值将替换现有的值。
- 如果现有属性集包含(作为修改命令一部分所提供的)具有相同名称的属性,但是修改命令不指定属性值,那么具有同一名称的属性将从现有定制属性集中删除。
示例
- 使用 Jython:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01") 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>AdminTask.listWMQConnectionFactories("9994GKCNode01(cells/ 9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)") cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) wsadmin>AdminTask.modifyWMQConnectionFactory("cf1(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#MQConnectionFactory_1098737234986)", ["-description 'My new description'"]) cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986)
- 使用 Jacl:
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask listWMQConnectionFactories 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) wsadmin>$AdminTask modifyWMQConnectionFactory cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986) {-description "My new description"} cf1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# MQConnectionFactory_1098737234986)