![[z/OS]](ngzos.gif)
z/OS JCL 変数
置換値、JCL 変数、および構成プロパティーを BFGCUSTM スクリプト内で使用できます。
以下の表に、 MFT コマンド PDSE ライブラリー・データ・セット内の BFGCUSTM JCL スクリプトの置換値をリストします。 BFGCUSTM ジョブを実行依頼する前に、これらの置換値を適切な値に置き換える必要があります。
| 置換変数 | 値 |
|---|---|
| ++library++ | 収容 MFT コマンド PDSE ライブラリーのデータ・セット名。 |
| ++bfg_java_home++ | Java インストールの場所。 |
| ++mq_path++ | IBM® MQ for z/OS® UNIX System Services Components ディレクトリーへのパス。 例えば、/mqm/V9R2M0などです。 これは、MFTのインストールへの絶対パス(例えば、 /mqm/V9R2M0/mqft)を指定するために使用されます。 |
以下の表では、 MFT コマンド PDSE ライブラリー・データ・セット ([Variables] セクション内) にある、BFGCUSTM JCL スクリプトの BFGSTDIN DD ステートメントの環境変数について説明します。 BFGCUSTM ジョブを実行依頼する前に、置換値 (2 つの正符号 ++ で囲まれた値) で指定されたすべての変数を適切な値に置き換える必要があります。
| 環境変数 | 値 |
|---|---|
| LIBRARY | 収容 MFT コマンド PDSE ライブラリーのデータ・セット名。 |
| TMPDIR | 一時ファイル用の z/OS UNIX System Services ディレクトリー。 |
| BFG_PROD | IBM MQ for z/OS UNIX System Services Componentsディレクトリーの下mqftにあるディレクトリーの絶対パス;例:/mqm/V9R2M0/mqft。 |
| BFG_DATA | z/OSの Managed File Transfer のデータ・ディレクトリーの場所。これは、 DATA_DIRへのパスです。 |
| BFG_JAVA_HOME | Java インストールの場所。 |
| BFG_JVM_PROPERTIES | オプション。 BFG_JVM_PROPERTIES 環境変数の値を設定します。 これらのプロパティーは、Java 仮想マシンに引き渡されます。 |
| BFG_GROUP_NAME | 通常、mqm ファイル・グループは、 MFT 構成データ・ファイルおよびコマンドに関連付けられます。 したがって、mqm グループのメンバーであるすべてのユーザーは、 MFT 構成にアクセスして変更を加えることができます。 詳しくは、ファイルのシステム許可IBM MQのMFTを参照してください。 z/OS システムの場合、ファイル・グループは z/OS UNIX System Services (z/OS UNIX) ファイル・システム・エンティティーであり、mqm ファイル・グループは必ずしも定義されません。 BFG_GROUP_NAME 環境変数を使用すると、 MFT 構成データ・ファイルの z/OS UNIX ファイル・システム・グループを関連付けることができます。 例えば、 z/OS UNIX シェル・プロンプトでは、以下を使用します。
BFG_GROUP_NAME は、ブランク値に設定することも、削除することもできます。 注: 初めて BFGCUSTM を実行するときに、 MFT 構成を複数のユーザー ID で使用する場合は、必要なすべてのユーザー ID でアクセス可能なグループに BFG_GROUP_NAME を設定することが重要です。 BFGCUSTM を再実行する場合は、BFG_GROUP_NAME を変更してはなりません (変更しない場合は、BFG_DATA によって参照されるディレクトリー内のすべてのファイルおよびディレクトリーに対する z/OS UNIX グループ・ファイル許可も、新しい BFG_GROUP_NAME 設定を反映するように変更する必要があります)。
|
| BFG_WTO | BFG_WTO に YES、ON、または TRUE を設定すると、z/OS ロギングが使用可能になります。 これにより、エージェントのイベント・ログに書き込まれるメッセージが z/OS オペレーター・ログ機能にも書き込まれるかどうかを制御できるため、JCL からエージェントを実行した場合に自動化製品へのアクセスがより簡単になります。 宛先コードは「プログラマー情報」(11) で、記述子コードは「通知」(12) です。 |
| SERVICE_TYPE | MFT コマンド・ライブラリーがエージェント用かロガー用かを指定します。 有効な値は AGENT または LOGGER です。 |
| 名前 | SERVICE_TYPE 値に対するエージェントまたはロガーの名前。 |
| QMGR | SERVICE_TYPE 値に対するエージェントまたはロガーに関連付けられたローカル・キュー・マネージャーの名前。 |
| OUTPUT_CLASS | SYSOUT データ・セットの出力クラス。 デフォルトは * であり、この場合はジョブ・ステートメントからの MSGCLASS パラメーターと同じ出力クラスを要求します。 |
| MQ_PATH | IBM MQ for z/OS UNIX コンポーネント・ディレクトリーへのパス。 |
| MQ_HLQ | IBM MQ データ・セットの高位修飾子。 |
| MQ_LANG | 必要な言語。 |
| DB2_HLQ | オプション。 Db2® データ・セットの高位修飾子。 |
| JOBCARD1 | JCL コマンド・ジョブのヘッダー行 1。 |
| JOBCARD2 | JCL コマンド・ジョブのヘッダー行 2。 |
| JOBCARD3 | JCL コマンド・ジョブのヘッダー行 3。 |
| ADMIN_JOB1 | admin ジョブのヘッダー行 1。 |
| ADMIN_JOB2 | admin ジョブのヘッダー行 2。 |
| ADMIN_JOB3 | admin ジョブのヘッダー行 3。 |
| FTE_CONFIG | マイグレーション用の既存の MFT 構成。 マイグレーションが必要ない場合には、ブランク値に設定します。 |
| CREDENTIAL_PATH | マイグレーションのための資格情報ファイルへのパス(/u/user1/agent3など)。 マイグレーション・コマンド BFGAGMG および BFGLGMG JCL スクリプトでのみ必要です。 マイグレーションが必要ない場合には、ブランク値に設定します。 以下にも注意してください。 |
| DB_PROPS_PATH | マイグレーションの対象となるデータベース・ロガー・プロパティー・ファイルを指定します。 このオプションが必要なのは、プロパティー・ファイルでデフォルトの名前とパス: config_directory/coordination_qmgr/databaselogger.propertiesが使用されていない場合のみです。 マイグレーションが必要ない場合には、ブランク値に設定します。 |
以下の表では、 MFT コマンド PDSE ライブラリー・データ・セット内の BFGCUSTM JCL スクリプトの BFGSTDIN DD ステートメントの必須の MFT 構成プロパティーについて説明します。 BFGCUSTM ジョブを実行依頼する前に、置換値 (2 つの正符号 ++ で囲まれた値) で指定されたプロパティーを、適切な非ブランク値に置き換える必要があります。 これらのプロパティーは、 MFT 構成プロパティーのオーバーライドを定義します。 ご使用の環境に合わせてエージェントまたはロガーをカスタマイズするために、エージェントおよびロガーのプロパティーを追加することができます。 すべてのプロパティーのリストについては、 構成プロパティー・ファイルを参照してください。
| Property | 値 |
|---|---|
| coordinationQMgr | エージェントまたはロガーが関連付けられる構成のための調整キュー・マネージャーの名前。 |
| coordinationQMgrHost | オプション。 調整キュー・マネージャーが実行されるシステムのホスト名。 このプロパティーの値をブランクのままにした場合、バインディング・モードでの接続が想定されます。 |
| coordinationQMgrPort | オプション。 調整キュー・マネージャーが listen するポート番号。 このパラメーターは、coordinationQMgrHost プロパティーにも非ブランクの値を指定している場合にのみ使用されます。 |
| coordinationQMgrChannel | オプション。 調整キュー・マネージャーへの接続に使用するチャネル。 このパラメーターは、coordinationQMgrHost プロパティーにも非ブランクの値を指定している場合にのみ使用されます。 |
| connectionQMgr | エージェントまたはロガーが関連付けられる構成のためのコマンド・キュー・マネージャーの名前。 |
| connectionQMgrHost | オプション。 コマンド・キュー・マネージャーが実行されるシステムのホスト名。 このプロパティーの値をブランクのままにした場合、バインディング・モードでの接続が想定されます。 |
| connectionQMgrPort | オプション。 コマンド・キュー・マネージャーが listen するポート番号。 このパラメーターは、connectionQMgrHost プロパティーにも非ブランクの値を指定している場合にのみ使用されます。 |
| connectionQMgrChannel | オプション。 コマンド・キュー・マネージャーへの接続に使用するチャネル。 このパラメーターは、connectionQMgrHost プロパティーにも非ブランクの値を指定している場合にのみ使用されます。 |