File Manager バッチ・ジョブの JCL 構文

バッチ・ジョブで File Manager 機能を使用するには、次のステートメントを使用します。//stepname EXEC PGM=FILEMGR

デフォルトでは、レポート出力はSYSPRINTに書き込まれます。出力の一部は、以下のddnamesに代わりに指示することができます。

FMNROPT
File Manager アクティブなオプション
FMNRPRM
$$FILEM コマンド・パラメーターおよび戻りコード
FMNRPRC
SYSIN から読み取られた REXX プロシージャー・ステートメント
FMNREPT
コマンド・レポートおよび戻りコード
FMNRSUM
TALLY サマリーレポート
FMNMLST
$FILEM パラメーターに代わる方法
FMNMLST DD には、次の File Manager 機能への入力として使用されるメンバーを指定するための、$$FILEM パラメーター MEMBLIST または CPYMBR (DSC) に代わる方法が用意されています。
図 1. Syntax

1 + , MEMBER
1 C'-lowcase_mem'
1 X'-hex_memname'
1 +  ( MEMBER(1) )
1 C'-lowcase_mem'
1 X'-hex_memname'
注:
  • 小文字または印刷不能文字を含むメンバー名
    • CPYMBR、MEMBER、MEMSTART、MEMEND、または MEMOUT キーワードで指定されたメンバー名は、小文字または印刷不能文字を含む場合があります。
    • 小文字または大/小文字混合文字を含むメンバー名を指定するには、文字リテラル形式として、引用符で囲まれた名前の前に文字 C を付けて使用します。例えば、C'aBc' のように指定します。
    • 印刷不能文字を含むメンバー名を指定するには、16 進リテラル形式として、引用符で囲まれた名前の前に文字 X を付けて使用します。例えば、X'81C283' のように指定します。マスク文字 (その 16 進値) がストリング内に含まれることがあります。

次の例では、FMNMLST でメンバーを指定しています。

MEMBER1                                                 Single member name
MEMBER1, MEMBER2                                          Multiple members per line
MEMBER1 (NEWMEMX), MEMBER2 (NEWMWMY)                      DSC multiple members being renamed
C'MEMlower                                                Member contains lower case character
X'D4C4D40000'                                             Member contains non displayable characters

JCL に FMNPRINT が存在する場合には、SYSPRINT の代わりに使用されます。JCL に FMNIN が存在する場合には、SYSIN の代わりに使用されます。

さらに、そのバッチ・ジョブに含まれる File Manager 機能によっては、STEPLIB ステートメントまたは他の DD ステートメントが必要になる場合もあります。

File Manager 制御ステートメントをコーディングするときには、以下のことを行う必要があります。
  • それぞれの制御ステートメントを 1-7 桁目の $$FILEM で開始し、その後の 8 桁目にブランクを続け、さらにコマンド名とその後に最初のパラメーター (もしあれば) を続けます。
  • パラメーターとその値を、等号で分離して、指定します。次のようになります。
    PARAMETER=value
  • 各パラメーター (最後のパラメーターを除いて) の直後にコンマを置きます。

アスタリスク (*) で始まるコメント・ステートメントも使用することができます。

制御ステートメントを次の行に続ける場合、最初の行はコンマで終わり、次の行は $$FILEM およびブランクで始めます。

1 行に収まらないパラメーターを続ける場合、継続文字は使用しないでください。代わりに、パラメーターを複数の行に分割し、各部分をアポストロフィで囲みます。例:
$$FILEM DSNIN='u/test/this is a regular HFS file ',
$$FILEM 'that has a v',
$$FILEM 'ery long name'
注:
  1. 制御ステートメントに関数名のみが含まれる場合、関数名とコンマの間にスペースを入れる必要があります。
  2. FCH (検索/変更) ユーティリティーで FIND および CHANGE コマンドを続けるには、最初の行はコンマで終わります (継続行に $$FILEM は入りません)。
  3. バッチで処理オプションを変更する場合、またはオプションをインストール・デフォルトにリセットする場合、SET 機能を使用します。
HEX 形式では、以下の例は、DSP File Manager 機能を使用して 20 件のデータ・セットのレコード (キー値 0001000 を持つレコードから始まる) を印刷するバッチ・ジョブを示しています。
//jobcard
//ABC EXEC PGM=FILEMGR
//SYSPRINT DD SYSOUT=*
//SYSIN  DD *
$$FILEM DSP DSNIN='FMNUSER.TEST.KSDS1',
$$FILEM FORMAT=HEX,KEY=000100,NLRECS=20
/*