modifyWMQConnectionFactory 命令

使用 modifyWMQConnectionFactory 命令来更改 WebSphere® MQ 消息传递提供程序连接工厂的某些参数。

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

[IBM i]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 消息传递提供程序连接工厂时,在 mappingAliascontainerAuthAlias 参数之间存在一个交互。 如果指定 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)

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rmj_wmq_jmscf_modify
文件名:rmj_wmq_jmscf_modify.html