WebSphere 変数の作成、編集、および削除

使用できますWebSphere®製品構成ファイルに含まれる文字列データ型属性の設定を提供する変数。

事前処理

アプリケーションが直接アクセスできないためWebSphere変数を定義すると、WebSphereアプリケーション内の変数に「不明な変数」などのエラー メッセージが返されます。 アプリケーション内から WebSphere 変数を参照する必要がある場合は、そのアプリケーションに以下のメソッドを組み込んで、WebSphere 変数を使用するストリングを拡張します。
問題の回避: WebSphere 変数を展開するには、管理特権が必要です。
private String expandVariable(String s) throws
javax.management.JMException {  
com.ibm.websphere.management.AdminService as = 
com.ibm.websphere.management.AdminServiceFactory.getAdminService 
();  

String server = as.getProcessName();  

java.util.Set result = as.queryNames(new javax.management.ObjectName("*:*,type=AdminOperations,process=" 
+ server), null);  

return (String)as.invoke((javax.management.ObjectName) 
result.iterator().next(),"expandVariable",new Object[] 
{"${"+s+"}"}, new String[] {"java.lang.String"});
また、スクリプト・コマンドを使用して WebSphere 変数を拡張する場合は、スクリプト・ファイルに次のコード行を組み込むことができます。
  • Jacl を使用:
    set mbean [$AdminControl completeObjectName WebSphere:*,type=AdminOperations]
$AdminControl invoke $mbean expandVariable {{"${APP_INSTALL_ROOT}"}}
  • Jython を使用:
    AdminOperations = AdminControl.completeObjectName('WebSphere:*,type=AdminOperations')
print AdminControl.invoke(AdminOperations, 'expandVariable', '${APP_INSTALL_ROOT}')

このタスクの概要

WebSphere 変数は通常、ファイル・パスを指定するために使用されます。 のWebSphere変数設定変数とそれらを使用する製品コンポーネントの指定に関する詳細情報を提供します。

WebSphere 変数は、以下のものを構成するためにも使用されます。
  • JAVA_HOME、APP_INSTALL_ROOT などの製品のパス名。
  • 特定のセル全体またはクラスター全体のカスタマイズ値を構成します。
  • [z/OS]ロケーション・サービス
  • [z/OS]環境変数

WebSphere 変数の有効範囲のメカニズムでは、サーバー・レベルの他に、ノード・レベル、クラスター・レベル、またはセル・レベルで変数を定義することができます。 このメカニズムでは、設定を各サーバーごとに個別に指定する代わりに、ノード、クラスター、またはセル内のすべてのサーバーに関して設定を指定することができます。

新しい変数の定義、 既存の変数の変更、または既存の変数の削除を行うには、 必要に応じて、以下のステップを実行します。

手順

  1. 管理コンソールで、 「環境」> WebSphere 変数」 をクリックします。
  2. 使用可能な有効範囲のリストから、 変数の有効範囲を選択します。

    新しい変数を作成する場合は、 選択した有効範囲で作成されます。 複数のレベルで同じ変数を定義する場合、 より細かい定義が、より高レベルの設定をオーバーライドします。 例えば、 同じ変数をセル・レベルとノード・レベルで指定すると、 ノード・レベルの設定が、セル・レベルの設定をオーバーライドします。

    有効範囲の変数は、特に データ・ソース・オブジェクトのテストの際に重要です。 変数の有効範囲は、データ・ソースがテスト接続に失敗しても実 行時には成功したり、テストで成功しても実行時に失敗したりする原因になることがあります。

  3. 変数を作成、変更、または削除します。

    • 新しい変数を作成します。

      1. 「新規」をクリックします。
      2. 名前、値、および変数の説明 (オプション) を指定します。

        置換に対応する WebSphere 変数を作成できます。 例えば、次のように入力したとします。${<variable name>}「名前」 フィールドの値<variable name>新しい WebSphere 変数の名前になります。 例えば、次のように入力するとします。${JAVA_HOME}変数の名前として、作成される WebSphere 変数の名前は Java™ ホーム・ディレクトリーです。

        [z/OS]WebSphere 変数を使用して、デーモン構成を変更できます。 サーバー・カスタム・プロパティーをデーモン・タグに付加することにより、 デーモン固有の変数を指定できます。 以下を入力します。DAEMON_<server custom property>「名前」 フィールドに入力します。 例えば、次のように入力したとします。DAEMON_ras_trace_outputlocationの中に名前フィールドとSYSOUTの中に価値フィールドを使用すると、特定のデーモンのトレース出力を SYSPRINT に送信できます。

    • 既存の変数の設定を変更します。
      1. 変更する変数の名前をクリックします。

        [z/OS]アプリケーションサーバーはWebSphere Application Server独自の目的のための内部変数。 変数が内部変数であることを示す接頭部は、以下のとおりです。WAS_DAEMON_<server custom property>,WAS_DAEMON_ONLY_<server custom property>およびWAS_SERVER_ONLY_<server custom property>これらのタグを持つ変数は、ユーザーが使用するためのものではありません。 これらはサーバー・ランタイムが使用するために排他的に予約されています。 これらの変数を変更すると予期しないエラーが発生することがあります。

      2. コンテンツを変更する価値観分野。

        の価値観製品のインストール時に既に定義されている一部の変数のフィールドは読み取り専用です。これらの変数に指定されている値を変更すると、製品の処理エラーが発生する可能性があるためです。

    • 既存の変数を削除します。
      1. 削除する変数を選択します。
      2. 「削除」をクリックします。
  4. 「OK」をクリックします。
  5. 変更を確認します。

    変数を作成した場合は、環境>WebSphere変数管理コンソールのナビゲーションで、選択したスコープの変数のリストに変数が表示されていることを確認します。

    管理コンソールは、タイプ ・エラーを検出しません。 変数は、誤って参照された場合には、 無視されます。

    変数を削除した場合は、選択したスコープの変数のリストから変数が削除されたことを確認します。

  6. 構成を保存します。
  7. 対象のサーバーを停止し、再度サーバーを始動して 変数の構成変更を有効にします。

    行った変更がノードに影響する場合は、 そのノード上のすべてのサーバーを停止して、再始動する必要があります。 同様に、行った変更がセルに影響する場合は、 そのセル内のすべてのサーバーを停止して、再始動する必要があります。