[z/OS]

z/OS 上の MFT の環境変数

z/OS® UNIX System Services (z/OS UNIX) 環境から直接コマンドを実行する場合、または独自の JCL スクリプトを実行する場合は、カスタマイズと構成の後に、 Managed File Transferによって提供される構成スクリプトと管理スクリプトを実行する前に、いくつかの環境変数を設定する必要があります。 これらの変数は、スクリプトの呼び出し元のユーザーごとおよび環境ごとに設定しなければなりません。

他の製品との競合を避けるために、ホーム・ディレクトリー内に.wmqftercスクリプトを作成することを選択できます。 その後、.wmqftercスクリプトが各Managed File Transferスクリプトによって呼び出され、スクリプトを使用して、Managed File Transferのカスタム環境設定を提供することができます。

さらに、オプションの環境変数 BFG_WTO もあり、この変数は JCL からエージェントを実行する際にオペレーター・ログにメッセージを送信するために設定できます。

表 1. 必須の z/OS 環境変数
環境変数 値
BFG_JAVA_HOME Java インストールの場所。 Java対応レベルについては、「 IBM® MQシステム要件を参照のこと。
BFG_DATA Managed File Transfer for z/OSのデータ・ディレクトリーの場所。 これは DATA_DIRへのパスです。
STEPLIB 以下の IBM MQ データ・セットを含める必要があります。
  • SCSQAUTH
  • SCSQANLE
  • SCSQLOAD
z/OSシステム上でデータベースロガーコンポーネントを実行する場合、STEPLIBは、以下の'Db2®データセットも示す順序で含める必要があります：
  • SDSNEXIT
  • SDSNLOD2
  • SDSNLOAD
Managed File Transferの環境変数を正しく構成する.profileの例を以下に示します:

STEPLIB=MQM.V920.SCSQAUTH:MQM.V920.SCSQANLE:MQM.V920.SCSQLOAD
PATH=/u/fteuser/bin:/u/fteuser/J7.0/bin:/bin:/usr/bin:/u/fteuser/extras/bin:/bin:$PATH
BFG_JAVA_HOME=/u/fteuser/J7.0
BFG_DATA=/u/fteuser/DATA_DIR
export PATH STEPLIB BFG_JAVA_HOME BFG_DATA
重要: LIBPATH 環境変数は、 z/OS UNIX 環境から fte* コマンドを呼び出すときに不要になったため、既存の .wmqfterc スクリプトから削除する必要があります。

また、必要に応じて、以下の環境変数を設定することもできます。

表 2. オプションの z/OS 環境変数
環境変数 値
BFG_WTO 以下のいずれかの値を指定すると、BFG_WTO が使用可能になります。
  • YES
  • ON
  • はい
以下のいずれかの値を指定すると、BFG_WTO が使用不可になります。 これらの値は、大文字と小文字を区別しない。
  • NULL
  • NO
  • OFF
  • FALSE

z/OS のロギングを使用可能にします。 この環境変数は、デフォルトでは使用不可になります。

エージェントのイベント・ログに書き込まれるメッセージは、z/OS のオペレーター・ログ機能にも書き込まれます。これにより、JCL からエージェントを実行した際に、自動化製品のアクセスがより簡単に行えます。 宛先コードは「プログラマー情報」(11) で、記述子コードは「通知」(12) です。
BFG_GROUP_NAME

mqmファイル・グループは、通常、Managed File Transfer構成データ・ファイルおよびコマンドに関連付けられています。 したがって、mqmグループのメンバーであるすべてのユーザーが、Managed File Transfer構成にアクセスして変更を加えることができます。 詳しくは、IBM MQのMFTファイルのシステム許可を参照してください。

z/OS システムで、ファイル・グループは z/OS UNIXファイル・システム・エンティティーであり、mqmファイル・グループは必ずしも定義されている必要はありません。 BFG_GROUP_NAME 環境変数を使用して、 Managed File Transfer 構成データ・ファイル用に代替の既存の z/OS UNIX ファイル・システム・グループを定義できます。 例えば、 z/OS UNIX シェル・プロンプトで次のように入力します。
export BFG_GROUP_NAME=FTEGB
これは、現行の z/OS UNIX セッションでそれ以降に作成されるすべての構成ファイルに関連付けられるグループ FTEGB を定義します。

BFG_GROUP_NAME は、ブランク値に設定することも、削除することもできます。