modifyWMQActivationSpec コマンド

modifyWMQActivationSpec コマンドを使用して、WebSphere® MQ メッセージング・プロバイダーのアクティベーション・スペックの特定パラメーターを変更します。

コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。

[IBM i]wsadmin スクリプト・クライアントは、Qshell から実行されます。 詳しくは、『WebSphere Application Server スクリプトを実行するための Qshell の構成』のトピックを参照してください。

このコマンドは、WebSphere Application Server バージョン 7 以降のアプリケーション・サーバーで使用した場合にのみ有効です。 これより前のバージョンでは使用しないでください。

使用可能な 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 メッセージング・プロバイダーのアクティベーション・スペックの作成に使用するパラメーターと同じです。

注: -qmgrHostname パラメーター または -qmgrPortNumber パラメーターのいずれかを 指定し、-connectionNameList パラメーターを指定しない場合は、 今後 WebSphere MQ への接続に 接続名リストを使用せず、代わりに指定のホスト名およびポート番号の情報を 使用すると想定されます。この結果、-connectionNameList パラメーターは ブランクに設定されます。

-customProperties パラメーターに関するこのコマンドの動作に注意してください。

-customProperties
このパラメーターは、WebSphere MQ メッセージング・プロバイダーのアクティベーション・スペック実装に渡されるカスタム・プロパティーを指定します。 通常、カスタム・プロパティーは、WebSphere 管理インターフェースで直接的にはサポートされないアクティベーション・スペックの属性を設定するために使用します。
各カスタム・プロパティーは、name および value テーブル・ステップ・パラメーターを使用して指定します。 これらはテーブル・ステップであるため、2 つのパラメーターの順序は固定であり、必ず name を最初に、value を 2 番目に指定する必要があります。
  • Jython の場合: [name value]
  • Jacl の場合: {name value}

例えば、-WAS_EndpointInitialState-customProperties パラメーターと一緒に使用できるカスタム・プロパティーです。 -WAS_EndpointInitialState の値は ACTIVE または INACTIVE である必要があります。-WAS_EndpointInitialState は、エンドポイントが登録されるときに、そのエンドポイントをアクティブ化するかどうかを決定します。 アクティブ化するようにこのパラメーターを設定すると、メッセージ駆動型 Bean が宛先と接続するためにこのアクティベーション・スペックが使用されるとすぐに、 その JMS 宛先からメッセージ消費が開始します。

このパラメーターは、J2CMessageEndpoint MBean を介した後続のアクティブ化または非アクティブ化では無視する必要があります。

新しい名前と値のペアが、次のルールを使用してカスタム・プロパティーの既存のセットに追加されます。
  • 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていない場合は、カスタム・プロパティーに値が指定されていないため無視される場合を除き、カスタム・プロパティー・セットに指定のプロパティーが追加されます。
  • 既存のプロパティー・セットに、modify コマンドの一部として指定されているプロパティーと同じ名前のプロパティーが含まれていて、modify コマンドにそのプロパティーの値も指定されている場合は、既存の値が指定の値によって置き換えられます。
  • プロパティーの既存のセットに、変更コマンドの一部として提供されるものと同じ名前のプロパティーが含まれているものの、変更コマンドがそのプロパティーの値を指定していない場合、同じ名前のプロパティーはカスタム・プロパティーの既存のセットから削除されます。

  • 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