Hitachi

uCosminexus Batch Job Execution Server 使用の手引（Windows(R)用）

DD要素（ファイルの定義）

〈このページの構成〉

形式

[CHARS="文字セットイメージ名[,文字セットイメージ名]…"]
[CMT="注釈"]
[COPIES="複写回数"]
[COPYG="グループ複写回数"]
[DEST="SYSOUT出力先識別子"]
[DISP="[ {NEW|RNW|OLD|SHR|MOD} ][,{DELETE|KEEP|PASS} ][,{DELETE|KEEP} ]"]
[DSN=
   "{一時ファイル識別名
   |一時ISAMファイル識別名
   |世代データ群パス名（相対世代番号）
   |ファイルパス名
   |ディレクトリパス名
   |*[.ステップ名[.プロシジャステップ名]].DD名
   }"]
[FCB="FCB名"]
[FCDFLT="デフォルト機能キャラクタイメージ名"]
[FORMS="書式番号"]
[FTYPE="{1|2}"]
[GAIJI1="レベル１外字名称"]
[HOLD="{YES|NO}"]
[ISKEY="キー長,キー位置[,{C|I|L|F|D}]"]
[ISRECFM="{F|V}"]
[ISRECL="レコード長[,最小レコード長]"]
[KEEP="{YES|NO}"]
[MODE="{AN|K}"]
NAME="DD名"
[OPTCDJ="{YES|NO}"]
[OVERC="適用枚数[,適用枚数]…"]
[OVERLAY="書式オーバレイ情報のイメージ名[,書式オーバレイ情報のイメージ名]…"]
[RECFM="{A|M|N}"]
[RENAME="環境変数名"]
[SAMF="{YES|NO}"]
[SYSOUT="{クラス名|*}"]
[TYPE="{DATA|DUMMY|FILE|TEMP|TEMPISAM|GDG|LIB|SYSOUT|DIR}"]

ページの先頭へ

機能

ジョブまたはジョブステップで使用するファイルを定義する。

ページの先頭へ

属性

CHARS="文字セットイメージ名[,文字セットイメージ名]…"〜＜記号名称＞((1〜4文字))

PDEで使用する文字セットイメージ名を指定する。

コンマで区切って4個まで指定できる。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

CMT="注釈"〜＜任意文字列＞((1〜255))

任意の文字列を指定する。Prinfina MANAGER SPでセパレータなどに利用されるが，この場合は前後の空白は削除される。

COPIES="複写回数"〜＜符号なし整数＞((1〜255))

PDEで使用するSYSOUTデータファイルの複写回数を指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

COPYG="グループ複写回数"〜＜符号なし整数＞((1〜255))

PDEで使用するSYSOUTデータファイルをプリンタに出力する場合のグループ複写回数を指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

DEST="SYSOUT出力先識別子"〜＜記号名称＞((1〜31文字))

PDEで使用するSYSOUTデータファイルの出力先を識別するための出力先識別子を指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

DISP="[ {NEW｜RNW｜OLD｜SHR｜MOD} ][,{DELETE｜KEEP｜PASS} ][,{DELETE｜KEEP} ]"

ファイルの状態および後処理に関する情報を指定する。DISP属性の省略値については，「3.4.2　ファイルの状態と後処理」を参照のこと。なお，排他/共用制御の詳細については，「3.10　ジョブ単位のファイルおよびディレクトリに対する排他/共用制御機能」を参照のこと。

第1パラメータ

ジョブステップ実行直前のファイルの状態を表す。

  • NEW

    ファイルが該当するジョブステップ中で利用する。ジョブステップ開始前に0バイトのファイルを作成する。この作成時，DSN属性値に指定したファイルがある場合は，エラーとなりジョブは終了する。

  • RNW

    ジョブステップ実行前にDSN属性値に指定したファイルがすでにある場合，該当するジョブを異常終了としないでそのファイルを新しく作成し直す。DSN属性値に指定されたファイルがあるときは，ファイルをいったん削除し，再度ファイルを生成する。DSN属性値に指定したファイルがないときは，ファイルを生成する。

    ディレクトリに対して指定した場合，ジョブ実行時にエラーとなって，ジョブが終了する。

  • OLD

    ファイルが該当するジョブステップ以前にすでにある場合，ほかのジョブとファイルを排他するときに指定する。ファイル排他が適用されていない場合や適用できないTYPE属性値の場合は，SHRパラメータ指定と同じになる。ジョブステップ開始前にファイルパスの存在の有無を確認するかどうかは，DD_EXISTCHECK_COBOLパラメータ，またはDD_EXISTCHECKパラメータの指定に従う。これらのパラメータの詳細については，「8.　設定ファイル」の「DD_EXISTCHECK_COBOL（DD要素に指定したファイルパスの存在確認要否を実施するための定義）」または「DD_EXISTCHECK（DD要素に指定したファイルパスの存在確認要否を実施するための定義）」を参照のこと。

  • SHR

    ファイルが該当するジョブステップ以前にすでにある場合，ほかのジョブとファイルを共用するときに指定する。ジョブステップ開始前にファイルパスの存在の有無を確認するかどうかは，DD_EXISTCHECK_COBOLパラメータ，またはDD_EXISTCHECKパラメータの指定に従う。これらのパラメータの詳細については，「8.　設定ファイル」の「DD_EXISTCHECK_COBOL（DD要素に指定したファイルパスの存在確認要否を実施するための定義）」または「DD_EXISTCHECK（DD要素に指定したファイルパスの存在確認要否を実施するための定義）」を参照のこと。

  • MOD

    ファイルが該当するジョブステップ以前にすでにある場合，ファイル操作ユティリティまたはCOBOLプログラムがファイルに対して追加書きするときに指定する。

    ファイルが該当するジョブステップ以前にない場合は，DISPMOD_NOFILEパラメータの指定に従う。詳細については，「8.　設定ファイル」の「DISPMOD_NOFILE（DD要素のDISP属性にMODを指定したファイルが存在しない場合の処理の定義）」を参照のこと。

    EXEC要素のLANG属性がCOBOLであり，かつDD要素のTYPE属性の値がFILE，TEMP，もしくはGDG（既存世代指定）である場合だけ使用できる。その他の値の場合は，次のとおり動作する。

    ・DD要素のTYPE属性の値がLIBの場合は，SHRパラメータが指定されたものとして動作する。

    ・DD要素のTYPE属性の値がTEMPISAMの場合は，MODとして動作するが，書き込み動作はユーザプログラムに依存する。

    ・DD要素のTYPE属性の値がDIRの場合は，ジョブ定義XMLファイル解析エラーとなる。

第2パラメータ

ジョブステップが正常終了した場合のファイルの後処理を指定する。

  • DELETE

    該当するジョブステップ終了後にファイルを削除する。

  • KEEP

    該当するジョブステップ終了後にファイルを保存する。ただし，ファイルを作成したジョブステップが異常終了した場合，第3パラメータにDELETEを指定していれば削除する。

  • PASS

    一時ファイルおよび一時ISAMファイルでだけ使用できる。

    ジョブステップでファイルを使用したあと，該当するファイルを後続ジョブステップで利用できるようにすること（パスすること）を指示する。

    このパラメータで指定したファイルを受け取れるのは，後続ジョブステップ中のどれか1回だけである。したがって，受け取ったあと，さらにこれを後続ジョブステップにパスする場合は，そのつどDISP属性値でPASSパラメータを指定する必要がある。

    このパラメータを指定した場合，第3パラメータに指定したパラメータに関係なくジョブステップ終了時（異常終了時も含む），該当するファイルをパスする。

第3パラメータ

ジョブステップが異常終了した場合のファイルの後処理を指定する。

第3パラメータは，第2パラメータ中のPASSパラメータを除いたものである。各パラメータの意味については，「第2パラメータ」を参照のこと。

DSN=

"{一時ファイル識別名

｜一時ISAMファイル識別名

｜世代データ群パス名（相対世代番号）

｜ファイルパス名

｜ディレクトリパス名

｜*[.ステップ名[.プロシジャステップ名]].DD名

}"

ファイルの名称を指定する。

設定ファイルのDSN_USE_ENVパラメータにYESを指定している場合，この属性に環境変数を指定できる。環境変数の指定方法と指定できる環境変数については，「3.4.7(5)　DSN属性への環境変数指定機能」を参照のこと。

  • 一時ファイル識別名〜＜パス名＞((1〜247文字))

    TYPE属性値にTEMPを指定した場合，一時ファイルの識別名を指定する。実際のファイル名は，システムでユニークな名称を与える。ディレクトリ区切り文字の"\"を含めた文字列を指定した場合，最後のディレクトリ区切り文字"\"より後ろの文字列を一時ファイル識別名と判断する。

  • 一時ISAMファイル識別名〜＜パス名＞((1〜247文字))

    TYPE属性値にTEMPISAMを指定した場合，一時ISAMファイルの識別名を指定する。実際のファイル名は，システムでユニークな名称を与える。ディレクトリ区切り文字の"\"を含めた文字列を指定した場合，最後のディレクトリ区切り文字"\"より後ろの文字列を一時ISAMファイル識別名と判断する。

  • 世代データ群パス名（相対世代番号）〜＜パス名＞((1〜247文字))

    TYPE属性値にGDGを指定した場合，世代データ群のパス名と世代ファイルの相対世代番号を指定する。各世代ファイルに対して，次に示すユニークなファイルパス名を与える。

世代データ群パス名.Gmmmm※

注※　mmmmは世代番号を表す0001〜9999の整数である。

相対世代番号は，0または符号を付けた1〜255の整数で指定する。ただし，0には符号を付けない。すでにある世代ファイルを参照する場合，最近作った世代ファイルに対して相対世代番号0を指定し，世代が古くなるに従い，相対世代番号を「−1，−2，−3，…」と指定する。

また，新しく世代ファイルを作成する場合には，相対世代番号を作成順に「+1，+2，+3，…」と指定する。同一世代ファイルに対しては，同一ジョブ中で同じ相対世代番号を指定する。

  • ファイルパス名〜＜パス名＞((1〜247文字))

    TYPE属性値にFILEを指定した場合，ファイルのパス名を指定する。

  • ディレクトリパス名〜＜パス名＞((1〜247文字))

    TYPE属性値にLIBを指定した場合，ジョブから実行するコマンドとプログラムを格納したディレクトリのパス名を指定する。

    TYPE属性値にDIRを指定した場合，ディレクトリのパス名を指定する。

  • *[.ステップ名[.プロシジャステップ名]].DD名

    ステップ名〜＜記号名称＞((1〜31文字))

    プロシジャステップ名〜＜記号名称＞((1〜31文字))

    *[.ステップ名[.プロシジャステップ名]].DD名で示すDD要素のDSN属性値を複写するように指定する。DD要素のTYPE属性値と，複写元DD要素のTYPE属性値はFILEにする必要がある。どちらか一方，または両方がFILEでない場合はエラーとなる。

FCB="FCB名"〜＜記号名称＞((1〜4文字))

PDEで使用するFCB名を指定する。

この属性を省略した場合，JOBPARM要素のFCB属性が有効となる。JOBPARM要素のFCB属性を省略した場合は，SysoutClassパラメータの指定値が有効になる。

FCDFLT="デフォルト機能キャラクタイメージ名"〜＜記号名称＞((1〜4文字))

PDEで使用するデフォルト機能キャラクタイメージ名を指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

FORMS="書式番号"〜＜記号名称＞((1〜4文字))

PDEで使用する書式番号を指定する。

この属性を省略した場合，JOBPARM要素のFORMS属性が有効となり，JOBPARM要素のFORMS属性を省略した場合は，SysoutClassパラメータの指定値が有効となる。

FTYPE〜{1｜2}

SYSOUTデータファイルのファイル形式を指定する。

この指定を省略した場合，SysoutClassパラメータの指定値が有効になる。

この指定は，JOBLOG，SYSMSG，XML，STDOUT，およびSTDERRには無効であり，これらのファイルはテキストファイルとして処理される。

  • 1：PDEファイル形式1

    テキストファイルなどの任意のファイル形式

  • 2：PDEファイル形式2

    COBOL2002でPDEによる書式，行制御印刷を行うファイル形式

GAIJI1 レベル１外字名称〜＜記号名称＞((1〜4文字))

PDEで使用する外字名称を指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

HOLD="{YES｜NO}"

ジョブ実行後，SYSOUTデータファイルを即時印刷するか，または出力保留をし，あとから印刷するかどうかを指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

  • YES

    出力保留にして，即時印刷しない。

  • NO

    出力保留にしないで，即時印刷する。

ISKEY="キー長,キー位置[,{C｜I｜L｜F｜D}]"

TYPE属性にTEMPISAMを指定して一時ISAMファイルを作成する場合に，一時ISAMファイルのキー長，相対キー位置，およびキー属性を指定する。

なお，キー位置とキー長の合計はISRECL属性で指定するレコード長または最小レコード長以下にする必要がある。

  • キー長

    キー属性に応じて，次に示すように指定する。

    C（文字型）の場合：1〜255の範囲

    I（2バイト整数型）の場合：2

    L（4バイト整数型）の場合：4

    F（計算機浮動型）の場合：4

    D（計算機倍長型）の場合：8

  • キー位置

    ISRECFM属性で指定するレコード種別に応じて，次に示すように指定する。

    ISRECFM="F"の場合：0〜（ISRECL属性で指定するレコード長−1）の範囲

    ISRECFM="V"の場合：0〜（ISRECL属性で指定する最小レコード長−1）の範囲

  • {C｜I｜L｜F｜D}

    キー属性を次に示すどれかのパラメータで指定する。

    C：文字型

    I：2バイト整数型

    L：4バイト整数型

    F：計算機浮動型

    D：計算機倍長型

ISRECFM="{F｜V}"

TYPE属性にTEMPISAMを指定して一時ISAMファイルを作成する場合に，一時ISAMファイルのレコード種別を指定する。

  • F

    レコード種別が順編成固定長であることを示す。

  • V

    レコード種別が可変長であることを示す。

ISRECL="レコード長[,最小レコード長]"

TYPE属性にTEMPISAMを指定して一時ISAMファイルを作成する場合に，一時ISAMファイルのレコード長を指定する。

また，ISRECFM属性にVを指定した場合は，最小レコード長も指定する必要がある。

なお，ISRECFM属性にFを指定した場合は，最小レコード長を指定しないこと。指定した場合は，ジョブ定義XMLファイルの解析時にエラーとなる。レコード長または最小レコード長は次に示す範囲で指定する。

  • レコード長

    1〜65,503の範囲で指定する。

  • 最小レコード長

    1〜65,503の範囲で指定する。

    なお，最小レコード長≦レコード長にする必要がある。

KEEP="{YES｜NO}"

スプールジョブを出力後保存するかどうかを指定する。この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

  • YES

    スプールジョブ転送後，スプールジョブをスプールから削除しない（SYSOUTデータファイルを出力後保存属性にする）。

  • NO

    スプールジョブ転送後，スプールジョブをスプールから削除する（SYSOUTデータファイルを出力後保存属性にしない）。

MODE="{AN｜K}"

PDEで使用するプリンタモードを指定する。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

  • AN

    ノンインパクトモード

  • K

    漢字プリンタモード

NAME="DD名"〜＜環境変数名＞((1〜31文字))

ジョブステップ内で，DD要素やDD要素で割り当てたファイルを識別する識別名を指定する。このDD名の先頭に文字列を付けた名称の環境変数に，割り当てたファイルのパス名を格納する。

付ける文字列はEXEC要素のプログラムがCOBOLの場合は"CBL_"となり，COBOL以外の場合は"DDN_"となる。

DD名にJOBLIBを指定した場合は，DSN属性値に指定した文字列を，PATH環境変数に追加する。追加した文字列は，ジョブ全体で有効となる。この場合，DD要素は，JOB要素内のSTEP要素外に指定する必要がある。また，TYPE属性値はLIBにする必要がある。

DD名にSTEPLIBを指定した場合は，DSN属性値に指定した文字列を，PATH環境変数に追加する。追加した文字列は，ステップ内でだけ有効となる（次のステップでは，PATH環境変数から除く）。この場合，DD要素はSTEP要素内に指定する必要がある。また，TYPE属性値はLIBにする必要がある。

OPTCDJ="{YES｜NO}"

PDEで，行単位にフォントと文字ピッチを切り替える文字配列テーブルを変更するかどうかを指定する。

  • YES

    行単位に使用する文字配列テーブルを変更する。

  • NO

    行単位に使用する文字配列テーブルを変更しない。

OVERC="適用枚数[,適用枚数]…"〜＜符号なし整数＞((1〜255))

PDEで使用する書式オーバレイの適用枚数を指定する。

コンマで区切って8個まで指定できる。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

OVERLAY="書式オーバレイ情報のイメージ名[,書式オーバレイ情報のイメージ名]…"〜＜記号名称＞((1〜4文字))

PDEで使用する書式オーバレイ情報のイメージ名を指定する。

コンマで区切って8個まで指定できる。

VOS3から移行したCOBOLプログラムにAPPLY FORMS-OVERLAY指定がある場合，書式オーバレイ名をここで指定することで書式オーバレイ印刷ができる。ただし，ページごとの切り替えはできない。

この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

RECFM="{A｜M｜N}"

PDEで使用する出力データに指定しているプリンタ制御文字の種別を指定する。この属性を省略した場合，SysoutClassパラメータの指定値が有効になる。

  • A

    ANSI制御文字

  • M

    機械制御文字

  • N

    制御文字なし（ASCII制御文字）

RENAME="環境変数名"〜＜環境変数名＞((1〜31文字))

割り当てられたファイルのパス名を格納する環境変数名を変更する。この属性を省略した場合，環境変数名は，NAME属性で指定したDD名の先頭に"DDN_"または"CBL_"を付けた名称になる。

この属性は，COBOL2002の特殊なDD名称など，環境変数を"DDN_"または"CBL_"で開始しない名称にする必要がある場合に使用する。

RENAME属性に関する注意事項については，「3.4.7(4)　環境変数名を任意の名称に設定する方法」を参照のこと。

SAMF="{YES｜NO}"

ジョブ定義XMLファイルに記述したSYSINデータを，ジョブコントローラがCOBOLプログラムに渡す場合のデータの形式を指定する。

この属性を省略した場合，設定ファイルのDD_SAMFパラメータの指定値が有効になる。

この属性は，TYPE属性に"DATA"が指定されていて，かつ同一ステップのEXEC要素のLANG属性に"COBOL"が指定されている場合にだけ指定できる。それ以外の場合は，ジョブ定義XMLファイルの解析エラーとなり，ジョブを実行しないで終了する。

  • YES

    COBOLが順編成固定長ファイルとしてSYSINデータを入力する場合に，"YES"を指定する。ジョブコントローラは，SYSINデータをレコード長80バイトの順編成固定長ファイルに変換し，COBOLプログラムに渡す。1行が改行を除いて81バイト以上であり，81バイト目以降に空白以外の文字がある場合，ジョブ定義XMLファイルの解析エラーとなり，ジョブを実行しないで終了する。

  • NO

    COBOLがテキスト編成ファイルとしてSYSINデータを入力する場合に，"NO"を指定する。ジョブコントローラは，ジョブ定義XMLファイルに記述したSYSINデータを変更しないで，COBOLプログラムに渡す。

SYSOUT="{クラス名｜*}"

SYSOUTデータファイルの出力に関する情報を指定する。

  • クラス名〜＜記号名称＞((1〜31文字))

    出力クラス名を指定する。このクラス名は，あらかじめ設定ファイルに定義しておく必要がある。

  • *

    ジョブ要素で指定したMSGCLASS属性の出力クラス名と同じクラスを割り当てる。ジョブ要素でMSGCLASS属性を指定していない場合は，設定ファイルのMSGCLASS_DEFAULTパラメータで指定したクラスを割り当てる。

TYPE="{DATA｜DUMMY｜FILE｜TEMP｜TEMPISAM｜GDG｜LIB｜SYSOUT｜DIR}"

割り当てるファイル種別を指定する。

この属性を省略した場合，SYSOUT属性を指定していればTYPE="SYSOUT"が仮定され，SYSOUT属性を指定していなければTYPE="FILE"が仮定される。

  • DATA

    DD要素の内容に，ジョブステッププログラムへの入力データがある。

  • DUMMY

    TYPE="TEMP"と同等であり，一時ファイルを割り当てる。

  • FILE

    恒久ファイルを割り当てる。

  • TEMP

    一時ファイルを割り当てる。

  • TEMPISAM

    一時ISAMファイルを割り当てる。

  • GDG

    世代ファイルを割り当てる。

  • LIB

    JOBLIB/STEPLIBを割り当てる。

  • SYSOUT

    SYSOUTデータファイルを割り当てる。

  • DIR

    ディレクトリを割り当てる。

ページの先頭へ

内容

TYPE属性値に"DATA"を指定した場合，SYSINデータ（ジョブステッププログラムへの入力データをインライン記述したもの）をこの要素の内容に指定する。複数行からの構成または＜や"や＆の文字が含まれている場合は，記述するデータは<![CDATA[!と!]]>で囲んで指定する。記述するデータの詳細については，「3.8　SYSINデータの読み込み」を参照のこと。

ページの先頭へ

注意事項

ページの先頭へ

使用例

1枚目にだけ書式オーバレイモジュール「FOPA」を使用し出力する場合の使用例を次に示す。

<DD NAME="EXA2" TYPE="SYSOUT" SYSOUT="*" OVERLAY="FOPA" OVERC="1"/>

ページの先頭へ

商品名称に関する表示

All Rights Reserved. Copyright (C) 2009, 2023, Hitachi, Ltd.