パラメーター値の変数

多くのパラメーター値は、オプションで変数を参照できます。

IBM Z® Monitoring Configuration Manager は、PARMGEN と同じ変数をサポートします。

ヒント: 変数を使用する代わりに、LPAR 固有の RTEDEF メンバーを使用することを検討してください。

変数と LPAR 固有の RTEDEF メンバーの比較.

変数を使用すると、LPAR で異なるパラメーター値が必要なさまざまな LPAR に対して、構成プロファイル・メンバーを再利用できます。

ただし、変数を使用すると、ランタイム環境の開始タスクに先行ステップが追加されます。 このステップにより、変数値が解決されます。 追加の処理により、ランタイム環境の開始が遅延します。

モニター構成マネージャーによって導入された LPAR 固有の RTEDEF メンバーは、LPAR 固有のパラメーター値に変数を使用する代わりになります。

変数の代わりに LPAR 固有の RTEDEF メンバーを使用すると、開始タスクから変数解決の先行ステップが除去されます。

変数の代わりに LPAR 固有の RTEDEF メンバーを使用すると、開始タスクが単純化され、ランタイム環境の開始が速くなります。

変数の使用

変数を使用するには、RTE_SYSV_SYSVAR_FLAG パラメーターを Y に設定する必要があります。

変数は、パラメーターと同様に、名前と値のペアを使用して定義され、 RTEDEF ライブラリーのメンバーに保管されます。

以下の例では、変数を指定せずに、RTE_TCP_PORT_NUM という名前のパラメーターをリテラル値 1918 に設定しています。

RTE_TCP_PORT_NUM 1918
以下の例では、パラメーターを変数 RTE_PORT の値に設定しています。
RTE_TCP_PORT_NUM &RTE_PORT.

シスプレックスに ZOS1 と ZOS2 という 2 つの LPAR が含まれているとします。 一般的に、これらの LPAR には類似したランタイム環境構成があります。 ただし、ZOS1 ではモニター・サーバーがポート 1918 を listen するのに対して、ZOS2 ではモニター・サーバーがポート 1919 を listen するようにします。

LPAR ZOS1 の変数構成プロファイル・メンバー VAR$ZOS1 内で、RTE_PORT 変数を 1918 に設定します。

RTE_PORT 1918

VAR$ZOS2 で、RTE_PORT を 1919 に設定します。

RTE_PORT 1919

変数を定義する RTEDEF メンバー

以下の表の「LPAR」列で、 「現行」 は、 GENERATE アクションが実行される LPAR を意味します。

表 1. RTEDEF 変数を定義するメンバー、およびそれらが適用される LPAR
メンバー名 LPAR 説明
VAR$GLOB すべて 変数構成プロファイル。
VAR$lpar 現行 LPAR 固有の変数構成プロファイル。

変数が VAR$GLOB と VAR$lparの両方で定義されている場合は、 VAR$lpar の値が使用されます。

固有の変数名

Configuration Managerは、変数を使用した実行時環境（パラメータ RTE_SYSV_SYSVAR_FLAG は Y に設定）をサポートしていますが、パラメータ値がパラメータ自体と同じ名前の変数である場合はサポートしていません。

例えば、Configuration Managerでは、以下のパラメータ設定は許可されていません
RTE_USS_RTEDIR &RTE_USS_RTEDIR
この場合、次の例のように、変数名に接頭辞 MY_ を追加して、パラメータ名と異なる変数名に変更する必要があります
RTE_USS_RTEDIR &MY_RTE_USS_RTEDIR

PARMGENから移行された変数

Configuration Manager とは異なり、PARMGENでは、割り当てられるパラメータと同じ変数名を使用することができます。 PARMGEN パラメータ定義に同じ名前の設定が存在する場合は、Configuration Manager で使用するために変数名を変更する必要があります。

MIGRATE アクションを使用してPARMGENから Configuration Managerに構成設定を移行する場合、 MIGRATE アクションは、以下のように、そのような互換性のない設定を自動的に修正します
  • 30文字以下の変数名については、 MIGRATE アクションは、以下の接尾辞を名前に追加して変数名を変更します。 _R
    例えば、PARMGENでは、メンバー WCONFIG(rte_name) で定義されている以下のパラメータ設定が可能です
    RTE_USS_RTEDIR &RTE_USS_RTEDIR
    変数の値は、 GBL_USER_JCL(rte_name) メンバに以下のように設定されています
    RTE_USS_RTEDIR "value"
    PARMGENから構成マネージャーに構成設定がインポートされると、 MIGRATE アクションにより、変数名が次のように変更されます
    • メンバー RTEDEF(rte_name):
      RTE_USS_RTEDIR &RTE_USS_RTEDIR_R
    • メンバー RTEDEF(VAR$GLOB):
      RTE_USS_RTEDIR_R "value"
  • 変数名が31文字の場合、 MIGRATE アクションは次の接尾辞のみを追加します。 _
  • 変数名が32文字（最大長）の場合、 MIGRATE アクションは、 RTEDEF(VAR$GLOB) メンバーに警告付きのコメントを追加するだけです。変数名を変更する必要があることを示します。
注： MIGRATE アクションのデフォルトの命名規則で提供された名前以外の名前に変数名を変更する場合は、 MIGRATE アクションを実行する前または後に、手動で変数名を変更する必要があります。