2.4 ファイル管理機能
2.4.4 ファイルのNetCOBOL連携機能
2.4.6.2 世代番号
世代ファイルの設計
世代ファイルを使用した運用を考慮して、世代ファイル情報の設計を行います。
世代ファイルの設計については、“Interstage Job Workload Server セットアップガイド“の“世代ファイルの設計”を参照してください。
世代ファイルの登録
世代ファイルを使用するには、バッチ実行基盤のセットアップで、世代ファイルの属性情報（“世代ファイル情報”と呼びます）を登録す る必要があります。
世代ファイル情報の登録については、“Interstage Job Workload Server セットアップガイド”の“世代ファイル情報の登録”を参照してく ださい。
世代ファイルの使用
ジョブで使用するには、バッチジョブ定義の資源定義に、世代ファイル名と、アクセスしたい世代（“世代番号”と呼びます）を指定しま す。
バッチアプリケーションは、資源名を指定して、任意の世代のファイルへアクセスすることができます。
ファイルの世代管理機能で世代を管理できるファイルは非一時ファイルだけです。一時ファイルの世代を管理することはできません。
・ 絶対世代番号は、0～9999の値です。
・ 絶対世代番号は、世代がファイルの世代管理機能に登録された順番に1ずつ加算されます。
・ ジョブで新規に作成する世代ファイルを絶対世代番号で指定することはできません。
相対世代番号および絶対世代番号の指定と実際のファイル名は、以下の対応関係になります。
世代ファイル名が“fileA”で、最新世代の実際のファイル名が“fileA.G0002”の場合 世代 相対世代
番号
絶対世代 番号
説明 実際のファイル名
作成済 みの世 代
-2 0 2世代前の作成済みファイル fileA.G0000 -1 1 1世代前の作成済みファイル fileA.G0001 0 2 最新世代の作成済みファイル fileA.G0002 新しい
世代
+1 指定不可 新しく作成する1世代目のファイル fileA.G0003 +2 指定不可 同じジョブステップで作成する2世代目のファイ
ル
fileA.G0004
・ 絶対世代番号は、9999を超えた場合には0に戻ります。この場合、同一の絶対世代番号を持つ世代ファイルおよび世代情報が存 在した場合は、その世代ファイルおよび世代情報を消去してから作成します。
2.4.6.3 世代ファイルの作成
世代ファイルを作成する方法には以下があります。
新規に世代を作成する
ジョブステップで新規に世代を作成する場合は、以下を資源定義に指定します。
・ 相対世代番号に“+1”を指定します。
・ 資源定義の[資源の作成・使用方法]には、[新規ファイルを作成する]を指定してください。
過去に作成した世代のファイルを作成し直す
過去に作成した世代のファイルを作成し直す場合は、以下のどちらかを資源定義に指定します。
・ 相対世代番号に負の整数（-1、-2、…）を指定します。
・ 過去に作成した世代の絶対世代番号を指定します。
・ 相対世代番号は、ジョブステップの開始時点で最新の世代が“0”になります。
・ 資源定義の[資源の作成・使用方法]には、[ファイルが存在した場合はそのまま使用する]を指定してください。
既存の世代ファイルの更新は、資源定義の[ファイルがすでに存在する場合はそのまま使用する]または[既存ファイルを更新する]と、
[世代番号]の[相対世代番号]または[絶対世代番号]を指定して行ってください。
2世代以上の世代を作成する
1つのジョブステップ内で1つの世代ファイルに対して新規に複数の世代（N世代）を作成する場合は、世代を作成する順に以下を指 定します。
・ 各資源定義の相対世代番号に正の整数（+1、+2、…、+N）を指定します。
・ 相対世代番号は、ジョブステップの開始時点で最新の世代が“0”になります。
・ 資源定義の[資源の作成・使用方法]には、[新規ファイルを作成する]を指定してください。
・ 正の相対世代番号の指定（+1、+2、…）は、ジョブステップ内で“+1”から開始して、連続した番号を指定する必要があります。
・ 番号が連続しない場合は、バッチジョブ定義登録時またはジョブ実行時にエラーになります。
・ ジョブステップで新規に世代を作成する場合、以下の条件でジョブ開始時にエラーになります。
１つのジョブステッ プで作成する世代
数
相対世代番 号の指定位
置
資源定義の [正常終了時 の後処理]の
指定
ジョブの実 行
説明
1 +1 [削除] 正常 途中世代の抜けは発生しないため、
エラーにはなりません。
N（2以上） +(N-1) [削除] 異常 途中世代の抜けが発生し、世代番号
が連続しないため、ジョブ開始時にエ ラーになります。
+N [削除] 正常 一番大きい相対世代番号の世代を削 除する場合には、途中世代の抜けは 発生しないためエラーにはなりませ ん。
世代ファイルの確定
ファイルの世代管理機能は、新規に世代を作成するジョブステップの終了時に世代を登録し、ジョブステップ単位で世代ファイルの世 代番号を確定します。
世代番号（新規の世代ファイル）は、以下の条件で確定します。
・ 新規に世代を作成するジョブステップで、各世代のファイルが正常に割当てられていること。かつ、
・ ジョブステップの終了時に、当該ジョブステップで新規作成された世代ファイルが保存されること。
・ 世代番号が確定した世代ファイルに対して追加で書き込みなどの更新を行っても、世代番号はカウントされません。
・ 世代番号の確定と、ジョブまたはジョブステップの実行結果は対応していません。
たとえば、ジョブステップで世代ファイルを新規に作成して削除した場合は、ジョブステップが正常終了しても、世代番号はカウント されません。
・ 世代ファイルを新規に作成するジョブステップが異常終了した場合は、世代番号はカウントされません。この場合、作成された世 代ファイルは、資源定義の[資源の後処理]の[ジョブステップが異常終了した場合]の指定に従って処理されます。
・ ジョブステップで使用する世代ファイルの後処理は、資源定義の[資源の後処理]の指定に従って処理します。ファイルの世代管理 機能上の世代の管理情報は、ジョブステップで世代ファイルを削除した場合でも削除されません。
2.4.6.4 世代ファイルの参照
世代ファイルを参照する方法には以下があります。
最新の世代を参照する
最新世代のファイルを作成する場合は、以下のどちらかを資源定義で指定します。
・ 相対世代番号で“0”を指定します。
・ 最新の世代を絶対世代番号で指定します。
過去に作成した世代のファイルを参照する
過去に作成した世代のファイルを作成し直す場合は、以下のどちらかを資源定義で指定します。
・ 相対世代番号で負の整数（-1、-2、…）を指定します。
・ 過去に作成した世代を絶対世代番号で指定します。
資源定義の[世代番号]に、管理対象外の世代を指定した場合や、相対世代番号の値を、最大世代数を超えて指定した場合は、ジョ ブ実行時にジョブステップ開始の時点でエラーになります。
資源定義の[資源の作成・使用方法]には、[既存のファイルを参照する]を指定してください。
2.4.6.5 世代ファイルとその他のファイル管理機能について
世代ファイルとその他のファイル管理機能との関係を説明します。
世代ファイルのファイルの排他
世代ファイルを使用する場合、各世代の実際のファイル単位ではなく、世代ファイル単位（ディレクトリ名＋世代ファイル名）に対して ファイルの排他制御を行います。
排他の獲得と解除は、非世代ファイルと同じ契機です。排他の解除はジョブが使用する世代ファイルのバッチジョブ定義の[資源の後 処理]の指定に基づいて行います。
世代ファイル名と同一名の非世代ファイルは指定できません。世代ファイル名と同一名の非世代ファイルを指定した場合、ジョブ実行 時にエラーになります。
世代ファイルのファイルの割当て
通常のファイルと同様に、資源定義の指定に基づいて各世代のファイル単位に行います。
世代ファイルの事前容量チェック
通常のファイルと同様に、資源定義の指定に基づいて各世代のファイル単位に事前容量チェックを行います。
ファイルパスの論理化機能
コマンドで論理ディレクトリ名を使用して世代ファイルを指定する場合、コマンド実行時に有効となっている論理ディレクトリ定義に基づ いて世代ファイルのディレクトリを置き換えます。
btfwaddgenfileinfコマンドで論理ディレクトリ名を使用して世代ファイルを登録した場合、世代ファイルのディレクトリは、コマンド実行時
に有効となっている論理ディレクトリ定義に基づいて決定します。
btfwaddgenfileinfコマンドで論理ディレクトリ名を使用して世代ファイルを登録した後に論理ディレクトリ定義を更新して、世代ファイル
登録時に使用した論理ディレクトリ名に関する情報を変更した場合は、ジョブ実行時にファイルが存在しないエラーになる場合があり ます。