ジョブの実行

tjclrunは、ジョブの実行中にJCLファイルを複数回解析します。

JOB文が含まれたINPJCLファイルを解析して順に実行します。そのとき、JCLプロシージャが呼び出されると、そのJCLプロシージャを解析して実行します。プロシージャの実行が終了したら、INPJCLの実行を続行します。

tjclrunは、ジョブの実行中に解析が必要なJCLプロシージャをJCLLIB文に指定されたJCLライブラリ（ライブラリ、PDS）から検索します。

また、JOBPARMコマンドのPROCLIBパラメータに指定されたddnameに該当するJCLライブラリからも、JCLプロシージャまたはINCLUDE JCLを検索します。これらのJCLライブラリから解析対象が見つからなかった場合は、最後にデフォルト・ディレクトリのSYS1.PROCLIBから検索します。このディレクトリからも見つからなかった場合は、ジョブを異常終了(FLUSH状態)で処理します。

INCLUDE文でインクルードするJCLも、上述したJCLLIB文またはJOBPARMコマンドのPROCLIBパラメータに指定されたJCLライブラリから検索します。

入力ストリーム・プロシージャは、そのプロシージャを呼び出すINPJCLにプロシージャの内容が定義されています。入力ストリーム・プロシージャはそのプロシージャが定義されているINPJCLでのみ呼び出すことができます。

カタログ・プロシージャは、JCLプロシージャをメンバーとして持つJCLライブラリに登録されているJCLプロシージャです。カタログ・プロシージャを呼び出す場合は、JCLライブラリに登録されているメンバー名をプロシージャに指定します。PROCLIBは頻繁に使用されるJCLプロシージャを集めたJCLライブラリです。カタログ・プロシージャは異なる複数のJCLから呼び出すことができます。

最も一般的なデータセットであり、割り当てるデータセット名がDSNAMEパラメータで指定された場合です。OpenFrameのデータセット割り当てモジュールを呼び出してデータセットを割り当てし、アプリケーションがそのデータセットを使用できるように、割り当て結果をアプリケーションに渡します。

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

DD文のDSNAMEパラメータで指定されたデータセット名が「&&」で始まるか、またはDSNAMEパラメータが指定されていないSYSOUTデータセット以外のデータセットは一時データセットです。tjclrunは、内部的に一時データセットに一意の名前を与えます。一時データセットは、ジョブの実行時に生成され、ジョブが終了すると削除されます。

tjclrunは、ユーザーが指定した一時データセット以外にも、いくつかの内部用の一時データセットを使用しています。以下はその例です。

現行のジョブ・ステップにが指定されている場合、tjclrunはSYSIN DD文に指定されたデータセットの内容を読み込んで、tjclrunが実行したバッチ・アプリケーションのstdinに渡します。つまり、アプリケーションはSYSIN DDによって割り当てられたデータセットの内容をstdinから読み込むことができます。

現行のジョブ・ステップにSYSOUT DDまたはSYSPRINT DDが存在する場合、tjclrunが呼び出すバッチ・プログラムの代わりに、このDDが指定するデータセットを解放します。また、バッチ・プログラムがstdoutまたはstderrで出力する内容を読み込んで、バッチ・プログラムに代わってSYSOUT DDまたはSYSPRINT DDによって割り当てられたデータセットに出力します。これは、OpenFrameのデータセットI/O関数を使用せず、stdoutまたはstderrに直接メッセージを出力するほとんどのアプリケーションを、JCLで問題なく実行できるようにするためです。

SYSOUT DDとSYSPRINT DDは同様の意味で取り扱います。2つのDDが両方存在する場合は、常にSYSOUT DDを使用し、SYSPRINT DDは使用しません。

JOBLIB DDとSTEPLIB DDは、tjclrunがEXEC PGM=pgmnameに指定されたバッチ・アプリケーションを検索するPDSデータセット(ライブラリ・パス)を指定します。

JOBLIB DDは、STEPLIB DDのないジョブ・ステップで使用されます。JOBLIB DDとSTEPLIB DDのいずれも指定していない場合は、OpenFrame環境設定のtjclrunサブジェクトのSYSLIBセクションに設定された場所から実行するバッチ・プログラムを検索します。

JOBCAT DDとSTEPCAT DDは、ジョブやジョブ・ステップで使用するデータセット・カタログを指定します。両方ともDD文の連結(concatenation)機能を利用して複数のデータセット・カタログが指定できます。

JOBCATとSTEPCATが両方指定されている場合は、STEPCATが使用されます。JOBCATのみ指定されたジョブ・ステップでは、JOBCATが使用されます。JOBCATとSTEPCATのいずれも指定されていない場合は、OpenFrameシステムのマスター・カタログが使用されます。

JOBCATやSTEPCATが指定されている場合でも、指定されたカタログにデータセットがカタロギングされていない場合は、マスター・カタログからデータセットのカタログ情報を検索します。

tjclrunが実行するジョブ・ストリームが含まれているJCLファイルです。

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

tjclrunがジョブを実行する際、カタログ・プロシージャを処理するときに使用したカタログ・プロシージャの内容を保存するスプール・データセットです。

1つのジョブが複数のカタログ・プロシージャを呼び出すことができるため、CATPROCにはジョブが使用した複数のカタログ・プロシージャの内容が保存されます。これらのカタログ・プロシージャは、tjclrunによって実行された順にCATPROCに保存され、カタログ・プロシージャが呼び出されたジョブ・ステップを示すメッセージが各プロシージャの先頭に追加されます。

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

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

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

一時データセットのレコード長は、OpenFrame環境設定のtjclrunサブジェクトのSYSLIBセクションのINSDSET_LRECLキーの設定に従います。この値は、1から4096まで指定することが可能であり、未指定時のデフォルト値は80です。入力ストリームがレコードの長さより小さい場合はスペースで埋められ、大きい場合は余分な部分が捨てられます。

tjclrunがINPJCL、INSPROC、およびカタログ・プロシージャを解析した結果であるパース・ツリーのテキスト形式で出力したファイルです。問題を分析する際に使用されます。

tjclrunを実行したランナー・スロットがtjclrunの終了時に該当のジョブ・スプールに記録するデータセットです。実行されたジョブの基本情報とジョブの実行時にレポートされたさまざまな統計情報、そしてジョブ・ステップに関する情報が含まれます。また、TJESシステムにとって重要なジョブ実行に関連する要約情報も含まれています。

SYSMSGは、tjclrunの主要メッセージ・ログです。SYSMSGには、ジョブの実行に必要な下位レベルの進行状況や重要な結果メッセージだけでなく、ジョブの処理時に発生したエラー・メッセージも保存されます。

ジョブの実行が異常終了した場合は、原因を分析するために最初にSYSMSGの内容を検討します。SYSMSGの内容は、tjclrunがジョブ・ステップを実行した順に時間順で表示されます。

以下は、SYSMSGに表示される内容です。

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

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

上述した他のジョブ・スプールのデータセットは、TJESがジョブを効率的に実行するために使用するデータセットであるのに対し、SYSOUTデータセットは、ユーザーがバッチ・プログラムのために特別に指定してジョブ・スプールに保存させたデータセットであると考えられます。

SYSOUTデータセットは、1つのジョブまたはジョブ・ステップ内で複数指定することができます。上記の例では、SYSOUT、RPTOUT、RPTERRがSYSOUTデータセットに該当します。SYSOUT データセットの内容は、ユーザーが指定したバッチ・プログラムによって出力されたデータです。

TJESは、SYSOUTデータセットに対して、それ以外の情報を追加・変更することはありません。バッチ・プログラムがSYSOUTデータセットの使用を終了すると、TJESはそのデータセットに指定されたOUTPUT CLASSに従って、出力された内容を後でプリンターや画面に出力する処理を管理するだけです。

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に定期的にレポートします。管理者(ユーザー)は、特定のデータセットに対してジョブ・ステップごとに実行された読み書きを監視することができます。

再開するジョブ・ステップを指定します。アスタリスク(*)は最初のジョブまたはプロシージャ・ステップを表します。stepnameはジョブ・ステップ名、stepname.procstepnameはジョブ・ステップのプロシージャ・ステップを表します。