modifyWMQActivationSpec 命令

使用 modifyWMQActivationSpec 命令来更改 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()

用途

使用 modifyWMQActivationSpec 命令来修改发布此命令的范围所定义的 WebSphere MQ 消息传递提供程序激活规范。

注: 您不能更改激活规范的类型。例如,您不能创建激活规范,此时您手动输入所有配置信息,然后修改此信息以使用 CCDT。
对于基于 CCDT 的激活规范,您不能修改以下参数:
  • qmgrName
  • qmgrHostname
  • qmgrPortNumber
  • qmgrSrvconnChannel
  • transportChain
  • wmqTransportType
对于通用激活规范,您不能修改任何以下参数:
  • ccdtUrl
  • ccdtQmgrName

目标对象

特定作用域上的 WebSphere MQ 消息传递提供程序激活规范。

必需参数

此命令的参数与那些用于创建 WebSphere MQ 消息传递提供程序激活规范的参数完全相同。

可选参数

此命令的参数与那些用于创建 WebSphere MQ 消息传递提供程序激活规范的参数完全相同。

注: 如果在未指定 -connectionNameList 参数的情况下指定了 -qmgrHostname-qmgrPortNumber 参数,那么将假定不得再使用连接名称列表与 WebSphere MQ 进行连接,而应该改为使用指定的主机名和端口号信息。因此,-connectionNameList 参数设置为空。

请注意在 -customProperties 参数上的此命令的行为。

-customProperties
此参数指定要传递到 WebSphere MQ 消息传递提供程序激活规范实现的定制属性。通常,定制属性用于设置并非直接通过 WebSphere 管理接口受支持的激活规范属性。
将使用名称和值表步骤参数指定每个定制属性。因为这些步骤都是表步骤,所以两个参数的顺序是固定的,因此必须始终先指定名称,然后指定值:
  • 使用 Jython:[name value]
  • 使用 Jacl:{name value}

例如,-WAS_EndpointInitialState 是可以与 -customProperties 参数配合使用的定制属性。-WAS_EndpointInitialState 的值必须是 ACTIVEINACTIVE-WAS_EndpointInitialState 确定注册端点时是否激活端点。如果此参数设置为 ACTIVE,那么在消息驱动的 Bean 使用该激活规范与 JMS 目标进行连接时,将立即使用来自该目标的消息。

对于通过 J2CMessageEndpoint MBean 进行的后续激活或取消激活,应该忽略此参数。

使用以下规则,将新的“名称 - 值”对添加到定制属性的现有集合中:
  • 如果现有属性集不包含(作为修改命令一部分所提供的)具有相同名称的属性,那么所提供的属性将添加至定制属性集,除非定制属性没有指定的值(当忽略定制属性时)。
  • 如果现有属性集包含(作为修改命令一部分所提供的)具有相同名称的属性,那么修改命令还将指定属性值,并且提供的值将替换现有的值。
  • 如果现有属性集包含与修改命令中所提供属性同名的属性,但该修改命令未指定该属性的值,那么会从现有定制属性集中删除同名属性。

示例

  • 使用 Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01")
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    
    wsadmin>AdminTask.listWMQActivationSpecs("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)")
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
    
    
    wsadmin>AdminTask.modifyWMQActivationSpec("spec1(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|resources.xml#J2CActivationSpec_1098737234986)", 
    ["-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic"]) 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
  • 使用 Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    
    wsadmin>$AdminTask listWMQActivationSpecs
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
    
    
    wsadmin>$AdminTask modifyWMQActivationSpec
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986) 
    {-destinationJndiName jms/topics/t5 -destinationType javax.jms.Topic} 
    spec1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CActivationSpec_1098737234986)
  • 以下示例通过使用 Jython 激活 WAS_EndpointInitialState 定制属性来修改激活规范:
    wsadmin>AdminConfig.getid("/Node:myNode01")
    'myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)'
    wsadmin>wsadmin>AdminTask.listWMQActivationSpecs("myNode01(cells/myCell01/nodes/myNode01|node.xml#Node_1)")
    'newas(cells/myCell01/nodes/myNode01|resources.xml#J2CActivationSpec_1298546034140)'
    wsadmin>AdminTask.modifyWMQActivationSpec("newas(cells/myCell01/nodes/myNode01|resources.xml
    #J2CActivationSpec_1298546034140)", '-customProperties [[WAS_EndpointInitialState ACTIVE]]')

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



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