ジョブの実行

最も一般的な方法であり、FILEパラメータに割り当てるデータセット名が与えられている場合です。OpenFrameのデータセット割り当てモジュールを呼び出してデータセットを割り当てます。また、アプリケーションがこのデータセットを使用できるように、割り当ての結果をアプリケーションの環境に渡します。

FD文にSOUTパラメータが指定されたデータセットです。SYSOUTデータセットは、ジョブ・スプールにジョブの実行結果として作成される出力データを保存するために作成されます。

FD文のFILEパラメータが指定されていないSYSOUTデータセット以外のデータセットは一時データセットです。この場合、tjclrunは一時データセットに一意の名前を付与します。一時データセットは、ジョブの実行フェーズで作成され、ジョブの終了時に削除されます。

tjclrunは、ユーザーが指定した一時データセット以外にも、内部的にくつかの一時データセットを使用します。以下の入力ストリーム・データセットの処理もその一例です。

PRGLIB FDは、tjclrunがEX文に指定されたバッチ・アプリケーションを検索するPDS(ライブラリ・パス)を指定します。PRGLIB FDは、ジョブ・ステップのEX文の次に位置し、ジョブ・ステップで呼び出すプログラムを検索するPDS(ライブラリ)を指定します。FD文の連結(CF)機能を使用して、複数のPDSからプログラムを検索するように指定できます。

PRGLIB FDが指定されていない場合は、OpenFrame環境設定のtjclrunサブジェクトのSYSLIBセクションに指定されたパスから実行するバッチ・プログラムを検索します。

STEPCAT FDは、ジョブ・ステップで使用するデータセット・カタログを指定します。FD文の連結(CF)機能を使用して複数のデータセット・カタログを指定できます。

STEPCAT FDは、ジョブ・ステップのEX文の次に位置し、そのジョブ・ステップで使用するデータセット・カタログを指定します。STEPCATが指定されていない場合は、OpenFrameシステムのマスター・カタログが使用されます。STEPCATが指定された場合でも、指定されたカタログにデータセットがカタロギングされていない場合は、マスター・カタログでデータセットについてのカタログ情報を検索します。

最初にサブミットする際のJCLファイルです。ジョブ・スプールのほとんどのファイルは、tjclrunによって作成されますが、INPJCLは、TJESのSUBMITOR(obmjmsvr)がジョブのサブミットを処理するときにジョブ・スプールに事前に作成します。その内容は、ユーザーがサブミットしたJCLファイルの内容と同じです。

tjclrunが実行するジョブ・ストリームが含まれているJCLファイルです。EXPJCLは、tjclrunが使用するために、TJESのSUBMITOR(obmjmsvr)がジョブのサブミットを処理する際にジョブ・スプールに作成したファイルであり、INPJCLでXSPマクロ処理を行った後のファイルです。

INPJCLに以下の形式で記述されている入力ストリーム・データセットを、tjclrunが内部的に使用するためにジョブ・スプールに作成する一時データセットです。

以下は、入力ストリーム・データセットを設定する例です。

上記の例の場合、INSDSETはline1、line2、…​、lineNをデータ内容とする一時データセットです。FDを使用するジョブ・ステップで作成され、そのジョブ・ステップの終了時に削除されます。このような動作をINSDSET SHUNTと呼びます。

tjclrunがEXPJCLを解析した結果の解析ツリーをテキスト形式で出力した内容が含まれるファイルです。問題を分析する際に参考データとして使用されます。

tjclrunの終了時に、tjclrunを実行したランナー・スロットが対応するジョブ・スプールに記録するデータセットです。実行されたジョブに関する基本的な情報やジョブの実行でレポートされた統計情報およびジョブ・ステップに関する情報などが含まれています。

SYSMSGは、tjclrunのメッセージ・ログです。ジョブの実行時に必要なサブステップの進行状況や重要な結果メッセージだけではなく、ジョブの処理時に発生したエラー・メッセージなどが含まれます。ジョブが異常終了した場合は、原因を分析するためにSYSMSGの内容を確認する必要があります。

SYSMSGの内容は、tjclrunがジョブ・ステップを実行した順に従って詳細や動作が発生した時間順に記録されます。

SYSMSGに出力される内容は以下のとおりです。

SYSOUTデータセットは、FD文にSOUTパラメータが指定されている場合を指します。SYSOUTデータセットは、他のデータセットと違ってジョブ・スプールに保存され、一般的に出力データを保存します。

以下は、SYSOUTデータセットを設定した例です。

上記のジョブ・スプールのデータセットは、TJESがジョブを効率的に実行するために使用しますが、SYSOUTデータセットは、ユーザーがバッチ・プログラムのために要求したデータセットとして、ジョブ・スプールに保存されるように特別に指定したデータセットです。SYSOUTデータセットは、1つのジョブやジョブ・ステップで複数指定できます。上記例では、SYSOUT、RPTOUT、RPTERRがSYSOUTデータセットです。

SYSOUTデータセットの内容は、ユーザーが指定したバッチ・プログラムで出力する内容です。TJESは、SYSOUTデータセットに他の情報を追加および削除しません。バッチ・プログラムでSYSOUTデータセットの使用が終了すると、TJESは、SYSOUTデータセットの出力クラスに応じてユーザーが出力した内容をプリンターや画面に出力するプロセスを管理します。

tjclrunがジョブの実行を開始および終了したことをTJESにレポートします。ジョブ終了のレポートには、ジョブの実行が正常に終了したかどうかを示す終了状態と終了コードが含まれます。

TJESは、tjclrunが実行しているジョブをSUSPEND/RESUME/STOPさせることができます。tjclrunは、要求されたジョブ制御を実行した後、ジョブの状態をTJESにレポートします。

tjclrunは、ジョブを実行する前にそのジョブで使用されるデータセットのロックを要求します。

tjclrunは、ロックを要求したデータセットが他のジョブによってすでにロックされ、使用されている場合、ジョブを処理せずにロックが成功するまで待機します。そのとき、問題の原因となるジョブとロック要求を待っているデータセットをTJESにレポートします。管理者は、レポート情報を検討して、複数のジョブ間でデータセットが共有され、ジョブの処理が遅延される問題を解決することができます。

tjclrunは、ジョブを構成する各ジョブ・ステップ処理の開始と終了をTJESにレポートしています。

STEP STARTは、現在実行中のジョブ・ステップのパス(ジョブ・ストリームでのロケーション)情報と、ジョブ・ステップのタイプ(PGMまたはPROC)などをレポートします。また、STEP FINISHは、ジョブ・ステップの終了状態、終了コード、実行時間などをレポートします。

tjclrunは、ジョブ・ステップに指定されたバッチ・プログラムを呼び出す前に、バッチ・プログラムが使用するデータセットを事前に割り当てます(割り当てられるデータセットはJCLのDD文によって指定されます)。

データセットの割り当て情報は、OpenFrameシステムにおいて非常に重要な情報であるため、tjclrunによって割り当てられたddnameとデータセット名は、ジョブ・スプールのSYSMSGとOpenFrame_HOME/log/sysディレクトリのdsalcログに記録されます。

バッチ・プログラムによって使用および変更されたデータセットの入出力情報が反映します。

tjclrunは、バッチ・プログラムの実行中に行われたデータセットの入出力統計情報をTJESに定期的にレポートします。管理者(ユーザー)は、特定のデータセットに対してジョブ・ステップごとに実行された読み書きを監視することができます。