B.2.2.2 ステップ情報の出力形式

Interstage Job Workload Server 運用ガイド

付録B ジョブログ

> B.2 出力情報

> B.2.2 バッチジョブ定義情報

B.2.2.2 ステップ情報の出力形式

ステップ情報には、以下の情報を出力します。

基本／実行条件／バッチアプリケーション定義の情報
資源定義の情報

■出力形式

◆基本／実行条件／バッチアプリケーション定義の情報

基本／実行条件／バッチアプリケーション定義の情報の出力形式を以下に示します。

出力形式の説明

出力情報名	出力内容の詳細
ジョブステップ名	ジョブステップ名です。以下のように出力します。出力情報の指定値が「通常表示」の場合ジョブステップ名または、プロシジャ呼出しステップ名を出力出力情報の指定値が「詳細表示」の場合ジョブステップ名を出力プロシジャから展開したジョブステップについては、“プロシジャ呼出しステップ名.ジョブステップ名”を出力 “[ジョブ情報]-[ステップ]”にて表示した項番を合わせて出力します。
ジョブステップの実行条件	先行ジョブステップが異常終了した場合の、当該ジョブステップ実行条件です。以下のいずれかで出力します。先行ジョブステップがすべて正常終了した場合だけ実行します (normal) 先行ジョブステップの終了状態に関わらず実行します (any) 先行ジョブステップが1個でも異常終了した場合だけ実行します (abort)
ジョブステップの迂回条件	ジョブステップの迂回条件です。以下の形式で出力します。 “先行ジョブステップ名：先行プロシジャ内ステップ名：条件式” 先行プロシジャ内のジョブステップ名が指定されていない場合は、以下を出力します。 "(no specification)" 条件式は、以下のいずれかの形式で出力します。比較値1 = jobstep completion code 比較値1 <= jobstep completion code 比較値1 <= jobstep completion code <= 比較値2 比較値1 < jobstep completion code 比較値1 < jobstep completion code < 比較値2 比較値1 >= jobstep completion code 比較値1 > jobstep completion code 比較値1 != jobstep completion code 迂回条件が指定されていない場合は、“SKIP CONDITION”も含め出力しません。
アプリケーションの種別	ジョブステップとして実行するアプリケーションの種別です。以下のいずれかで出力します。 COBOL UTILITY 資源の獲得・回収だけ (NO OPERATION) 本項目は対象のステップがジョブステップの場合だけ出力します。
サーバアプリケーション名	COBOLのサーバアプリケーション名です。本項目は、対象のステップがジョブステップであり、かつアプリケーションの種別が"COBOL"の場合だけ出力します。その他の場合は、"SERVER APPLICATION NAME :"も含め出力しません。
パラメタ(COBOL)	COBOLアプリケーションへ渡すパラメタです。以下の形式で出力します。 “データ型パラメタ値” データ型は、以下のいずれかを出力します。 PIC S9(データ長) PIC 9(データ長) PIC X(データ長) 本項目は、対象のステップがジョブステップであり、かつアプリケーションの種別が "COBOL"の場合だけ出力します。その他の場合は、"PARAMETER" も含め出力しません。また、アプリケーションへ渡すパラメタが指定されていない場合は、"PARAMETER"も含め出力しません。
環境変数	アプリケーションへ渡す環境変数です。以下の形式で出力します。 “変数名 = 変数値” 本項目は対象のステップがジョブステップの場合だけ出力します。また、アプリケーションへ渡す環境変数が指定されていない場合は、"ENVIRONMENT"も含め出力しません。
ステップ定義のコメント	ステップ定義のコメントです。ステップ定義のコメントが定義されている場合だけ出力します。それ以外の場合は、"STEP COMMENT"も含め出力しません。
実行ファイル名	ユーティリティまたはコマンドの実行ファイル名です。本項目は、対象のステップがジョブステップであり、かつアプリケーションの種別が"UTILITY"の場合だけ出力します。その他の場合は、"EXECUTE FILE NAME :"も含め出力しません。
パラメタ(コマンド）	ユーティリティアプリケーションへ渡すパラメタです。本項目は、対象のステップがジョブステップであり、かつアプリケーションの種別が"UTILITY"の場合だけ出力します。その他の場合は、"PARAMETER"も含め出力しません。また、アプリケーションへ渡すパラメタが指定されていない場合は、"PARAMETER"も含め出力しません。
置換えパラメタ	プロシジャ定義に渡す置換えパラメタです。以下の形式で出力します。 “置換えパラメタ = 値” 置換えパラメタが設定されていない場合は、"REPLACEABLE PARAMETER"も含め出力しません。本項目は対象のステップがプロシジャ呼出しステップの場合だけ出力します。
プロシジャ定義名	プロシジャ呼出しステップで、呼出すプロシジャ定義名を出力します。本項目は対象のステップがプロシジャ呼出しステップの場合だけ出力します。
プロシジャ情報のヘッダ	プロシジャ情報のヘッダです。ヘッダとして"- PROCEDURE INFORMATION -"を出力し、以降にプロシジャ情報(プロシジャ定義名、置換えパラメタの初期値、プロシジャ定義のコメント)を出力します。プロシジャ情報は対象のステップがプロシジャ呼出しステップ、かつ出力モードが詳細の場合だけ出力します。それ以外の場合、プロシジャ情報のヘッダも含めて、プロシジャ情報は出力しません。
置換えパラメタの初期値	プロシジャ定義内の置換えパラメタの初期値です。以下の形式で出力します。 “置換えパラメタ = 値” 置換えパラメタが設定されていない場合は、"REPLACEABLE INIT PARAMETER"も含め出力しません。本項目は対象のステップがプロシジャ呼出しステップ、かつ出力モードが詳細の場合だけ出力します。
プロシジャ定義のコメント	プロシジャ定義のコメントです。本項目は対象のステップがプロシジャ呼出しステップ、かつ出力モードが詳細の場合だけ出力します。ただし、プロシジャ定義のコメントが定義されていない場合には、"PROCEDURE COMMENT"も含め出力しません。

基本／実行条件／バッチアプリケーション定義の情報に出力される情報や、各機能については、“Interstage Job Workload Server バッチ開発ガイド”の“ジョブステップ定義”を参照してください。

◆資源定義の情報

資源定義の情報の出力形式を以下に示します。

出力形式の説明

出力情報名	出力内容の詳細
資源名	ジョブステップとして実行するアプリケーションが使用する資源名です。本項目は対象のステップがジョブステップの場合だけ出力します。資源が指定されていない場合は、資源定義の情報は各項目の題名も含め出力しません。
資源の種別	資源の種別です。以下のいずれかを出力します。ファイル (file) 一時ファイル (temporary file) 先行ジョブステップの資源 (substep)
格納先ディレクトリ名	ファイルの格納先ディレクトリ名です。本項目は、資源の種別が“ファイル (file)”、または“一時ファイル (temporary file)”の場合だけ出力します。その他の場合は、"DIRECTORY NAME :”も含め出力しません。
ファイル名	ファイル名です。本項目は、資源の種別が“ファイル (file)”の場合だけ出力します。その他の場合は、"FILE NAME :"も含め出力しません。
先行ジョブステップ名	先行ジョブステップ名または先行プロシジャ呼出しステップ名です。本項目は、資源の種別が“先行ジョブステップの資源 (substep)”の場合だけ出力します。その他の場合は、"REFERSTEP NAME :"も含め出力しません。
プロシジャ内ステップ名	先行プロシジャ呼出しステップで呼出したプロシジャの、プロシジャ内ステップ名です。本項目は、資源の種別が“先行ジョブステップの資源 (substep)”で、かつ先行プロシジャ内ステップが指定されている場合だけ出力します。その他の場合は、"JOBSTEP NAME IN SUBSTEP :"も含め出力しません。
先行ジョブステップの資源名	先行ジョブステップまたは先行プロシジャ呼出しステップで定義した資源名です。本項目は、資源の種別が“先行ジョブステップの資源 (substep)”の場合だけ出力します。その他の場合は、"REFER RESOURCE NAME :"も含め出力しません。
作成・使用方法の情報	ファイルの作成・使用方法の情報です。以下のいずれかを出力します。 “new(0KByte/0KByte,reuse)” 新規（ファイルが存在した場合はそのまま使用します） “new(0KByte/0KByte,error)” 新規（ファイルが存在した場合はエラーとします） “old(exclusive)” 既存（排他） “old(share)” 既存（共用）
正常終了時の資源の後処理	ジョブステップが正常終了した場合の資源の後処理の情報です。以下のいずれかを出力します。削除 (delete) 保持 (keep) 後続ジョブステップへ渡す (pass)
異常終了時の資源の後処理	ジョブステップが異常終了した場合の資源の後処理の情報です。以下のいずれかを出力します。削除 (delete) 保持 (keep)
データの書込み同期を取る	ステップの終了時にファイル内のデータの書込み同期を取るかの情報です。以下を出力します。データの書込み同期を取りません (off)
資源定義のコメント	資源定義のコメントです。資源定義のコメントが定義されている場合だけ出力します。それ以外の場合は、"RESOURCE COMMENT"も含め出力しません。

資源定義の情報に出力される情報や、各機能については、“Interstage Job Workload Server バッチ開発ガイド”の“ジョブステップ定義”を参照してください。

◆出力例

通常表示の場合

-- STEP INFORMATION --
1. step0
EXECUTE CONDITION : normal
SKIP CONDITION
        skipstep0 : skipsubstep0 : 1 = jobstep completion code
        skipstep1 : skipsubstep1 : 1 <= jobstep completion code
        skipstep2 : skipsubstep2 : 1 <= jobstep completion code <= 2
        skipstep3 : skipsubstep3 : 1 < jobstep completion code
        skipstep4 : skipsubstep4 : 1 < jobstep completion code < 2
        skipstep5 : skipsubstep5 : 1 >= jobstep completion code
        skipstep6 : skipsubstep6 : 1 > jobstep completion code
        skipstep7 : skipsubstep7 : 1 != jobstep completion code
BATCH APPLICATION
    TYPE : COBOL
    SERVER APPLICATION NAME : apl
    PARAMETER
        PIC S9(1) paramvalue0
        PIC 9(1) paramvalue1
        PIC X(1) paramvalue2
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}
STEP COMMENT
        step0 confirms products in stock.
       history : 2006/04/01 y.ishida - parameter add
RESOURCE
[RSC0]
    TYPE : temporary file
    DIRECTORY NAME : DIR
    ALLOCATION : new(0KByte/0KByte,reuse)
    OPERATION OF POST PROCESS NORMAL END : delete
    OPERATION OF POST PROCESS ABNORMAL END : delete
    SYNCHRONIZATION : off
    RESOURCE COMMENT
　　　　RSC0 is work file01.
[RSC1]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : keep
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC2]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC3]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : old(exclusive)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC4]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : old(share)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC5]
    TYPE : substep
    REFERSTEP NAME : step
    JOBSTEP NAME IN SUBSTEP : substep
    REFER RESOURCE NAME : refrsc
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : delete
    OPERATION OF POST PROCESS ABNORMAL END : delete
    SYNCHRONIZATION : off

2. step1
EXECUTE CONDITION : abort
BATCH APPLICATION
    TYPE : UTILITY
    EXECUTE FILE NAME : execfile
    PARAMETER
        utyparam${AAA}
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}

3. step2
EXECUTE CONDITION : any
BATCH APPLICATION
    TYPE : NO OPERATION

4. proccallstep
REPLACEABLE PARAMETER
        symbol0 = value
        symbol1 = value
PROCEDURE DEFINITION NAME : proc
EXECUTE CONDITION : normal
SKIP CONDITION
        skipstep0 : skipsubstep0 : 1 = jobstep completion code
        skipstep1 : skipsubstep1 : 1 <= jobstep completion code
        skipstep2 : skipsubstep2 : 1 <= jobstep completion code <= 2
        skipstep3 : skipsubstep3 : 1 < jobstep completion code
        skipstep4 : skipsubstep4 : 1 < jobstep completion code < 2
        skipstep5 : skipsubstep5 : 1 >= jobstep completion code
        skipstep6 : skipsubstep6 : 1 > jobstep completion code
        skipstep7 : skipsubstep7 : 1 != jobstep completion code
STEP COMMENT
        This step calls procedure.
        history : 2006/04/04 y.satou - proccallstep add

詳細表示の場合

-- STEP INFORMATION --
1. step0
EXECUTE CONDITION : normal
SKIP CONDITION
        skipstep0 : skipsubstep0 : 1 = jobstep completion code
        skipstep1 : skipsubstep1 : 1 <= jobstep completion code
        skipstep2 : skipsubstep2 : 1 <= jobstep completion code <= 2
        skipstep3 : skipsubstep3 : 1 < jobstep completion code
        skipstep4 : skipsubstep4 : 1 < jobstep completion code < 2
        skipstep5 : skipsubstep5 : 1 >= jobstep completion code
        skipstep6 : skipsubstep6 : 1 > jobstep completion code
        skipstep7 : skipsubstep7 : 1 != jobstep completion code
BATCH APPLICATION
    TYPE : COBOL
    SERVER APPLICATION NAME : apl
    PARAMETER
        PIC S9(1) paramvalue0
        PIC 9(1) paramvalue1
        PIC X(1) paramvalue2
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}
STEP COMMENT
        step0 confirms products in stock.
        history : 2006/04/01 y.ishida - parameter add
RESOURCE
[RSC0]
    TYPE : temporary file
    DIRECTORY NAME : DIR
    ALLOCATION : new(0KByte/0KByte,reuse)
    OPERATION OF POST PROCESS NORMAL END : delete
    OPERATION OF POST PROCESS ABNORMAL END : delete
    SYNCHRONIZATION : off
    RESOURCE COMMENT
　　　　RSC0 is work file01.
[RSC1]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : keep
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC2]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC3]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : old(exclusive)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC4]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : old(share)
    OPERATION OF POST PROCESS NORMAL END : pass
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off
[RSC5]
    TYPE : substep
    REFERSTEP NAME : step
    JOBSTEP NAME IN SUBSTEP : substep
    REFER RESOURCE NAME : refrsc
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : delete
    OPERATION OF POST PROCESS ABNORMAL END : delete
    SYNCHRONIZATION : off

2. step1
EXECUTE CONDITION : abort
BATCH APPLICATION
    TYPE : UTILITY
    EXECUTE FILE NAME : execfile
    PARAMETER
        utyparam${AAA}
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}

3. step2
EXECUTE CONDITION : any
BATCH APPLICATION
    TYPE : NO OPERATION

4. proccallstep
REPLACEABLE PARAMETER
        symbol0 = value
        symbol1 = value
PROCEDURE DEFINITION NAME : proc
EXECUTE CONDITION : normal
SKIP CONDITION
        skipstep0 : skipsubstep0 : 1 = jobstep completion code
        skipstep1 : skipsubstep1 : 1 <= jobstep completion code
        skipstep2 : skipsubstep2 : 1 <= jobstep completion code <= 2
        skipstep3 : skipsubstep3 : 1 < jobstep completion code
        skipstep4 : skipsubstep4 : 1 < jobstep completion code < 2
        skipstep5 : skipsubstep5 : 1 >= jobstep completion code
        skipstep6 : skipsubstep6 : 1 > jobstep completion code
        skipstep7 : skipsubstep7 : 1 != jobstep completion code 
STEP COMMENT
        This step calls procedure.
        history : 2006/04/04 y.satou - proccallstep add
- PROCEDURE INFORMATION -
PROCEDURE DEFINITION NAME : proc
REPLACEABLE INIT PARAMETER
        symbol0 = value
        symbol1 = value
PROCEDURE COMMENT
        proc performs batch data conversion from order data.

4-1. proccallstep.pstep0
EXECUTE CONDITION : normal
SKIP CONDITION
        skipstep0 : skipsubstep0 : 1 = jobstep completion code
        skipstep1 : skipsubstep1 : 1 <= jobstep completion code
        skipstep2 : skipsubstep2 : 1 <= jobstep completion code <= 2
        skipstep3 : skipsubstep3 : 1 < jobstep completion code
        skipstep4 : skipsubstep4 : 1 < jobstep completion code < 2
        skipstep5 : skipsubstep5 : 1 >= jobstep completion code
        skipstep6 : skipsubstep6 : 1 > jobstep completion code
        skipstep7 : skipsubstep7 : 1 != jobstep completion code
BATCH APPLICATION
    TYPE : COBOL
    SERVER APPLICATION NAME : apl
    PARAMETER
        PIC S9(1) paramvalue0
        PIC 9(1) paramvalue1
        PIC X(1) paramvalue2
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}
STEP COMMENT
        pstep0 calculates order volume from order data.
RESOURCE
[RSC0]
    TYPE : temporary file
    DIRECTORY NAME : DIR
    ALLOCATION : new(0KByte/0KByte,reuse)
    OPERATION OF POST PROCESS NORMAL END : delete
    OPERATION OF POST PROCESS ABNORMAL END : delete
    SYNCHRONIZATION : off
    RESOURCE COMMENT
        RSC0 is work file.
[RSC1]
    TYPE : file
    DIRECTORY NAME : DIR
    FILE NAME : file
    ALLOCATION : new(0KByte/0KByte,error)
    OPERATION OF POST PROCESS NORMAL END : keep
    OPERATION OF POST PROCESS ABNORMAL END : keep
    SYNCHRONIZATION : off

4-2. proccallstep.pstep1
EXECUTE CONDITION : abort
BATCH APPLICATION
    TYPE : UTILITY
    EXECUTE FILE NAME : execfile
    PARAMETER
        utyparam${AAA}
    ENVIRONMENT
        symbol0 = value${BBB}
        symbol1 = value${BBB}

4-3. proccallstep.pstep2
EXECUTE CONDITION : any
BATCH APPLICATION
    TYPE : NO OPERATION