[AIX Solaris HP-UX Linux Windows][z/OS]

スクリプトによる SCA コンポジットの参照およびサービスの JMS バインディングの編集 (非推奨)

Service Component Architecture (SCA) コンポジットの参照およびサービスに対する Java™ Message Service (JMS) バインディングを更新できます。 ビジネス・レベル・アプリケーションの構成単位を編集するスクリプトを使用します。 スクリプトでは、binding.jms エレメントのリソースおよび応答リソースの設定を編集します。

事前処理

既存の JMS リソースを使用する SCA コンポジットは、ビジネス・レベル・アプリケーションでの構成単位にする必要があります。 参照上の JMS バインディングの設定を編集するには、コンポジットで JMS バインディングに参照が定義されている必要があります。 同様に、サービスの JMS バインディングの設定を編集するには、その JMS バインディングのサービスがコンポジットで定義されている必要があります。

このタスクについて

JMS バインディングを使用する SCA コンポジットのデプロイメントの後、Java Naming and Directory Interface (JNDI) 名を指定する、JMS バインディングのリソースまたは応答リソースの設定を編集できます。

表 1. 編集可能な設定editCompUnitオプションパラメータ。 JMS バインディング・リソースの編集を可能にするパラメーターを持つ editCompUnit コマンドを実行します。
editCompUnit パラメーター 編集可能な設定値
-ReferenceJMSBindingResources
  • destinationJNDIName
  • connectionFactoryJNDIName
-ServiceJMSBindingResources
  • destinationJNDIName
  • activationSpecJNDIName
-ReferenceJMSBindingResponseResources
  • responseDestinationJNDIName
  • responseConnectionFactoryJNDIName
-ServiceJMSBindingResponseResources
  • responseDestinationJNDIName
  • responseConnectionFactoryJNDIName

editCompUnit コマンドで使用される JMS リソースが存在する必要があります。 この製品では、構成単位の編集時に JMS リソースが動的に作成されません。

手順

  1. wsadmin スクリプト ツールを起動します。
  2. SCA コンポジット構成単位の参照リソースについて JMS バインディングを編集します。

    editCompUnit コマンドに -ReferenceJMSBindingResources オプション・パラメーターを指定して実行し、JMS バインディングで定義されているリソース・エレメントの設定を編集します。 このコマンドには、-blaID、-cuID、および -ReferenceJMSBindingResources の 3 つのパラメーターがあり、タイプはすべてストリングです。

    Jython を使用:
    AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResources 
[[componentName/referenceName destinationJNDIName connectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')
    Jacl を使用:
    $AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResources 
componentName/referenceName destinationJNDIName connectionFactoryJNDIName
 .* .* .* .* .* .* .*}
    表2.editCompUnitと-ReferenceJMSBindingResourcesコマンド要素。 -ReferenceJMSBindingResources を指定した editCompUnit コマンドを実行して、JMS バインディング参照リソースを編集します。
    変数 説明
    $ 変数名を値で置換する Jacl 演算子です。
    AdminTask wsadmin ツールで管理コマンドを実行するためのオブジェクトです。
    editCompUnit AdminTask コマンドです。
    myBLA SCA ビジネス・レベル・アプリケーションの構成 ID です。
    myCompUnit SCA コンポジット構成単位の構成 ID です。
    -ReferenceJMSBindingResources JMS バインディングで定義されている参照リソースを更新する、editCompUnit のオプション・コマンド・パラメーターです。
    componentName/referenceName JMS バインディングで定義される参照の名前です。

    コンポーネント名、スラッシュ (/)、参照名の形式を使用します。
    destinationJNDIName JMS バインディングの接続先の宛先の JNDI 名です。
    connectionFactoryJNDIName JMS バインディングで要求メッセージの処理に使用される接続ファクトリーの JNDI 名です。
    .* バインディング設定のデフォルト値のワイルドカード・ストリングです。 編集できない設定に対して「.*」を指定します。
  3. SCA コンポジット構成単位のサービス・リソースについて JMS バインディングを編集します。

    editCompUnit コマンドに -ServiceJMSBindingResources オプション・パラメーターを指定して実行し、JMS バインディングで定義されているリソース・エレメントの設定を編集します。 このコマンドには、-blaID、-cuID、-ServiceJMSBindingResources という 3 つのパラメーターがあり、それらの型はすべてストリングです。

    Jython を使用:
    AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResources 
[[componentName/serviceName destinationJNDIName activationSpecJNDIName
 .* .* .* .* .* .* .*]]]')
    Jacl を使用:
    $AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResources 
componentName/serviceName destinationJNDIName activationSpecJNDIName
 .* .* .* .* .* .* .*}
    表3.editCompUnitと-ServiceJMSBindingResourcesコマンド要素。 -ServiceJMSBindingResources を指定した editCompUnit コマンドを実行して、JMS バインディング・サービス・リソースを編集します。
    変数 説明
    $ 変数名を値で置換する Jacl 演算子です。
    AdminTask wsadmin ツールで管理コマンドを実行するためのオブジェクトです。
    editCompUnit AdminTask コマンドです。
    myBLA SCA ビジネス・レベル・アプリケーションの構成 ID です。
    myCompUnit SCA コンポジット構成単位の構成 ID です。
    -ServiceJMSBindingResources はeditCompUnit JMSバインディングで定義されているサービスリソースを更新するためのオプションのコマンドパラメータ
    componentName/serviceName JMS バインディングで定義されるサービスの名前です。

    コンポーネント名、スラッシュ (/)、最後にサービス名というフォーマットを使用します。
    destinationJNDIName JMS バインディングの接続先の宛先の JNDI 名です。
    activationSpecJNDIName JMSバインディングがJMS宛先に接続してリクエストメッセージを処理するために使用するアクティベーション仕様のJNDI名です。
    .* バインディング設定のデフォルト値のワイルドカード・ストリングです。 編集できない設定に対して「.*」を指定します。
  4. SCA コンポジット構成単位の参照応答リソースについて JMS バインディングを編集します。

    -ReferenceJMSBindingResponseResources オプション・パラメーターを指定した editCompUnit コマンドを使用して、JMS バインディングに定義されているリソース・エレメントの設定を編集します。 このコマンドには、-blaID、-cuID、-ReferenceJMSBindingResponseResources という 3 つのパラメーターがあり、それらの型はすべてストリングです。

    Jython を使用:
    AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResponseResources 
[[componentName/referenceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')
    Jacl を使用:
    $AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ReferenceJMSBindingResponseResources 
componentName/referenceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*}
    表4.editCompUnitと-ReferenceJMSBindingResponseResourcesコマンド要素。 -ReferenceJMSBindingResponseResources を指定した editCompUnit コマンドを実行して、JMS バインディング参照応答リソースを編集します。
    変数 説明
    $ 変数名を値で置換する Jacl 演算子です。
    AdminTask wsadmin ツールで管理コマンドを実行するためのオブジェクトです。
    editCompUnit AdminTask コマンドです。
    myBLA SCA ビジネス・レベル・アプリケーションの構成 ID です。
    myCompUnit SCA コンポジット構成単位の構成 ID です。
    -ReferenceJMSBindingResponseResources JMS バインディングで定義されている参照応答リソースを更新する、editCompUnit のオプション・コマンド・パラメーターです。
    componentName/referenceName JMS バインディングで定義される参照の名前です。

    コンポーネント名、スラッシュ (/)、参照名の形式を使用します。
    responseDestinationJNDIName JMS バインディングの接続先の宛先の JNDI 名です。
    responseConnectionFactoryJNDIName JMS バインディングで要求メッセージの処理に使用される接続ファクトリーの JNDI 名です。
    .* バインディング設定のデフォルト値のワイルドカード・ストリングです。 編集できない設定に対して「.*」を指定します。
  5. SCA コンポジット構成単位のサービス応答リソースについて JMS バインディングを編集します。

    -ServiceJMSBindingResponseResources オプション・パラメーターを指定した editCompUnit コマンドを使用して、JMS バインディングに定義されているリソース・エレメントの設定を編集します。 このコマンドには -blaID、-cuID、および -ServiceJMSBindingResponseResources の 3 つのパラメーターがあり、タイプはすべてストリングです。

    Jython を使用:
    AdminTask.editCompUnit('[-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResponseResources 
[[componentName/serviceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*]]]')
    Jacl を使用:
    $AdminTask editCompUnit {-blaID myBLA -cuID myCompUnit -ServiceJMSBindingResponseResources 
componentName/serviceName responseDestinationJNDIName responseConnectionFactoryJNDIName
 .* .* .* .* .* .* .*}
    表5.editCompUnitと-ServiceJMSBindingResponseResourcesコマンド要素。 -ServiceJMSBindingResponseResources を指定した editCompUnit コマンドを実行し、JMS バインディング・サービス応答リソースを編集します。
    変数 説明
    $ 変数名を値で置換する Jacl 演算子です。
    AdminTask wsadmin ツールで管理コマンドを実行するためのオブジェクトです。
    editCompUnit AdminTask コマンドです。
    myBLA SCA ビジネス・レベル・アプリケーションの構成 ID です。
    myCompUnit SCA コンポジット構成単位の構成 ID です。
    -ServiceJMSBindingResponseResources JMS バインディングで定義されているサービス応答リソースを更新する、editCompUnit のオプション・コマンド・パラメーターです。
    serviceName JMS バインディングで定義されるサービスの名前です。

    コンポーネント名、スラッシュ (/)、最後にサービス名というフォーマットを使用します。
    responseDestinationJNDIName JMS バインディングの接続先の宛先の JNDI 名です。
    responseConnectionFactoryJNDIName JMS バインディングで要求メッセージの処理に使用される接続ファクトリーの JNDI 名です。
    .* バインディング設定のデフォルト値のワイルドカード・ストリングです。 編集できない設定に対して「.*」を指定します。

結果

editCompUnit コマンドの実行後、SCA コンポジットの JMS バインディングに定義されている参照またはサービスに関する情報が表示されます。

例

MyJMSComposite 構成単位が myBLA ビジネス・レベル・アプリケーションにインストールされているとします。 editCompUnit コマンドを実行して、JMS バインディング・リソースまたは応答リソースを更新します。

設定のデフォルト値を指定するには、.* を使用します。 このステップで各属性に .* をプレースホルダーとして含めます。 例えば、ステップは -ReferenceJMSBindingResources[[...]] です。 ステップの最初の属性は、componentName/service-referenceName であり、データ行を示します。 ステップの 2 番目の属性は、編集可能な宛先 JNDI 名です。 ステップの 3 番目の属性は、編集可能な接続ファクトリ JNDI 名またはアクティベーション仕様 JNDI 名です。 残り 7 つの属性は、値を指定しない限り、.* 値です。

  • Jython を使用して参照リソースの更新:
    AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ReferenceJMSBindingResources [[MyJMSBinding/myJMSService myDest myCF .* .* .* .* .* .* .*]]]')
  • Jython を使用してサービス リソースを更新します。
    AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ServiceJMSBindingResources [[MyJMSBinding/myJMSService myDest myAS .* .* .* .* .* .* .*]]]')
  • Jython を使用した参照応答リソースの更新:
    AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ReferenceJMSBindingResponseResources [[MyJMSBinding/myJMSService .* myCF .* .* .* .* .* .* .*]]]')
  • Jython を使用したサービス応答リソースの更新:
    AdminTask.editCompUnit('[-blaID WebSphere:blaname=myBLA -cuID WebSphere:cuname=MyJMSComposite 
-ServiceJMSBindingResponseResources [[MyJMSBinding/myJMSService .* myCF .* .* .* .* .* .* .*]]]')

editCompUnit コマンドを実行すると、エレメントの設定が更新され、構成単位の構成 ID (WebSphere:cuname=MyJMSComposite など) が戻されます。

次の作業

JMS バインディングの参照およびサービスを表示して、バインディング設定が期待されたとおりであることを確認します。