MFBSI 構成ファイル

スケジューラー構成を簡単化するために、所定の Enterprise Server と Mainframe Subsystem Support に対する MFBSIJCL コマンド ライン パラメーターのほとんどを構成ファイルに格納することができます。構成ファイルにパラメーターを格納するということは、場合によっては、コマンド ラインで MFBSIJCL を実行するのに必要な唯一のパラメーターが JCL メンバー名であるということも意味します。

デフォルトでは、構成ファイルは、mfbsi.cfg という名前で、MFBSI_DIR 環境変数によって指定された場所に配置されます。デフォルトの場所およびファイル名は、必要に応じて、CFG=... コマンド ライン パラメーターで、または MFBSI_CFG 環境変数の値を設定することで変更できます。

mfbsi.cfg_model という名前の構成ファイルのテンプレートが <install-directory>\etc フォルダー に用意されています。

そのディレクトリには、IDCAMS を呼び出す単純な JCL ファイル rc08.jcl も含まれています。初期のテストで、この JCL を MFBSI とともに使用できます。

mfbsi.cfg ファイルの形式

  • 行の位置 1 にあるアスタリスク (*) またはセミコロン (;) はコメントを示します。ファイルに定義されたパラメーターを有効にするには、コメント記号を削除し、パラメーターに適切な値を指定します。
  • ファイル内の空白行は無視されます。
  • パラメーター名では大文字と小文字は区別されません。
  • 「キーワード」パラメーターの値では大文字と小文字が区別されます。その他のパラメーター値でも、特に UNIX および Linux プラットフォームでのディレクトリ拡張では、大文字と小文字が区別されることがあります。
  • パラメーターが構成ファイルとコマンド ラインの両方で定義された場合は、コマンド ライン定義が優先されます。
  • いくつかの特殊なパラメーターは、構成ファイルからのみ使用可能であり、コマンド ラインから直接使用することはできません。
  • MFBSIJCL コマンド ラインでアクセス コード -j または -x を使用する場合は、mfbsi.cfg 内の構成パラメーター JCL-Submit および JCL-Ext の値は無視されます。

構成ファイルを使用する場合、mfbsijcl に対して最低限指定する必要があるコマンド ラインの実行パラメーターは、拡張子の有無にかかわらず、サブミットする JCL ファイルの名前です。この場合、mfbsi.cfg で次のパラメーターを指定します。

  • ES-Server=...- エンタープライズ サーバー リージョンにアクセスする方法を指定します (-r、-l、または -sTCP を使用)
  • JCL-Submit=...- -j/-xJCLpathLocation
  • JCL-Ext =… - JCL ファイルを参照するために使用する拡張子 (コマンド ライン パラメーターで指定されていない場合)
  • SJobID=JobNo|StdOut|JCL
  • JESYSMSG。JCL JESSYSMSG 実行ログを取得する必要がある場合
  • REGION=… - カスタム MFBSI_DIR を使用する場合のターゲット リージョン名

テンプレート構成ファイルには、使用可能な以下のパラメーターのリストが含まれています。

Mainframe Subsystem Support を使用するエンタープライズ サーバーにアクセスし、その名前および場所を指定する場合:

ES-Server=-rES-JCL

ES-Server=-sTCP:10.1.1.101:32793

ES-Server=-sTCP:HostName:32793

ES-Server=-lES-SERV

JCL ファイル (-x または -j) をサブミットし、JCL メンバー ディレクトリのパスを指定する場合:

JCL-Submit=-jPathToJCLfile

JCL-Submit=-xPathToJCLfile

注:
  • 空白文字を含むディレクトリ名には二重引用符を使用しないでください。
  • PathToJCLfile では、環境変数への参照を 1 つ以上使用できます。この場合、環境変数に $ をプレフィックスとして付ける必要があります。たとえば、JCL-Submit=-x$SEE_JCL_BASE/$JCL_PDS のように指定します。
  • 環境変数 SEE_JCL_BASE および JCL_PDS はそれぞれの値で置き換えられます。

カスタム MFBSI_DIR 設定 (MFBSI_DIR パスの最後の部分でリージョン名が指定されていない) を使用する場合:

REGION=RegionName- RegionName は、ターゲット エンタープライズ サーバー リージョン名です。

コマンド ラインで指定した JCL メンバー名に追加する JCL ファイル拡張子を指定する場合:

JCL-Ext=jcl

デフォルトは「何も追加しない」です。拡張子の前にピリオド (".") を指定しないでください。

アラートを発行するまでの起動タイムアウト (秒単位) を指定する場合:

StartupTimeout=300

アラートを発行するまでの実行タイムアウト (秒単位) を指定する場合:

RunTimeout=600

アラート バック経過時間 (秒単位) を指定する場合:

AlertBackTimeout=600

エンタープライズ サーバーが停止し、ジョブがまだ実行を待っているときに、MFBSIJCL の実行を停止しないようにする場合:

ES-SHUTDOWN-JWAIT=CONTINUE - これはオプションですが、推奨されます。

SjobID.log ファイルに書き込まれた JESYSMSG ログをエンタープライズ サーバーから要求するには、次を使用します。

JESYSMSG

エンタープライズ サーバーから JESYSMSG ログを要求し、StdOut に書き込む場合:

JESYSMSG=StdOut

MFBSI jobLog ファイルの名前を割り当てる場合:

SJobID=JobNo - エンタープライズ サーバーによって割り当てられたジョブ番号の使用

SJobID=JCL - JCL メンバー名の使用

SJobID=StdOut - MFBSI ジョブ実行ログを標準出力 (StdOut) に書き込みます

サブミットの前のユーザー出口モジュールの実行を要求するには、次を使用します。

JCLExit=pgmName

JCLExitID=IdentString - 実行するアクションを決定するためにサブミットの前のユーザー出口モジュールに渡される関連文字列 (最大 32 文字)

MFBSIJCL の実行を終了する直前に終了ユーザー出口を呼び出す場合:

TerminateExit=pgmName

デフォルトでは、ジョブの終了を待機している MFBSIJCL プロセスに対してソフト強制終了を実行すると、Enterprise Server のジョブも終了前にキャンセルされます。

プロセスがソフト強制終了されたときにジョブを強制終了しないようにするには、次のパラメーターを使用します。

ES_JOB_KILL=NO

デフォルトでは、ES_JOB_KILL=YES と見なされます。

デフォルト (JES2) 以外の JCL ファイルのタイプを指定する場合:

JCLType=VSE

JCLType=JES2

JCLType=JES3

MSS セキュリティが設定されている場合にユーザー ID を指定場合 (オプション):

UserID=myUser

MSS セキュリティが設定されている場合にパスワードを指定する場合 (オプション):

Password=myPwd

MSS セキュリティが設定されている場合にセキュリティ グループを指定する場合 (オプション):

SGroup=securityGroup

シンボリック パラメーターの置換および Control-M AutoEdit 機能の使用:

注:
  • JCL パラメーターを使用する場合は、これらのパラメーターを使用する必要があります。
  • 置換は SkelProcessType で要求されます。

Control-M AutoEdit 機能にアクセスせずにパラメーターを置換するには、次を使用します。

SkelProcessType=MFBSI

Control-M AutoEdit 機能の特定の処理を有効にするには、次を使用します。

SkelProcessType=CONTROL-M または SkelProcessType=MFBSICTM

MFBSIJCL コマンド ラインでパラメーターが指定されていない場合でもパラメーターを置換する場合 (DATE、DAY などのシステム パラメーターの置換が可能) (オプション):

AutoEdit

1 つまたは 2 つの文字を置換するパラメーター置換プレフィックスを指定する場合 (オプション):

SUBST-Prefix=parameterValue

デフォルト値は、%%: SUBST-Prefix=%% です。

週が始まる曜日を指定する場合 (オプション):

StartOfWeek=Sunday|Monday

デフォルト値は、Monday です。

BY REFERENCE または BY CONTENT で置換された JCL を強制的にサブミットする場合 (CASSUB –x) (オプション):

CASSUB-CTM=BYREF|CONTENT

CASSUB... –j ... がデフォルトでは使用されます (CONTENT)。

ネイティブ コマンドの代わりに CASSUB/CASOUT の API 呼び出しの使用を指定し、それらのために新しいプロセスを作成せずに済むようにする場合 (オプション):

CASAPI

ジョブが異常終了した場合に MFBSIJCL によって返される OS コードを指定する場合:

  • SYS-ABEND-RC=nnn - システムによる異常終了
  • USR-ABEND-RC=nnn - ユーザーによる異常終了
  • RTS-ABEND-RC=nnn - ランタイム システムによる異常終了

Enterprise Server でジョブの状態をチェックするために MFBSIJCL によって使用されるデフォルトの遅延は、次のとおりです。

  • 「Job Started」の各チェックまでに 2 秒
  • 「Job Conluded」の各チェックまでに 10 秒

次の 2 つのパラメーターを使用して、これらの遅延を構成できます。

  • JOBSTART-LOOKUP-FREQ=nn|AUTO
  • JOBEND-LOOKUP-FREQ=nn|AUTO

詳細は次のとおりです。

  1. nn は、最小値 1、最大値 60 (秒) の数値を指定します。
  2. AUTO - MFBSIJCL によってルックアップの頻度が自動的に最適化されます。

    AUTO を使用する場合、MFBSIJCL では、3 分間に 1 秒の初期頻度が使用され、その後にデフォルト値が復元されます。

これらのパラメーターを使用すると、Enterprise Server JCL でレポートされるジョブの実行時間と比べて、MFBSIJCL のオーバーヘッド経過時間が大幅に短縮されます。これは、頻繁に実行される短期実行のジョブがある場合に主に効果があります。

MSS/JCL で終了ジョブを完了するために許容される最大遅延 (分単位) を指定する場合 (オプション):

EMX-Timeout=nn

デフォルト値は 6 分です。

MFDEBUG

mfbsijcl 実行の詳細なトレース ログを生成します。Micro Focus サポートから求められた場合に使用します。これは本番環境では推奨されません。