テーブル関数ADMIN_TASK_STATUS

ADMIN_TASK_STATUS 関数は、管理タスク・スケジューラー・タスク・リストに定義されたタスクごとに 1 行が指定された表を戻します。各行は、前回実行されたときのそのタスクの状況を示します。

オプションで、max-history パラメーターを指定した場合、この関数は、タスクの実行ごとにデータ行を返します (返される実行状況の最大行数は、max-history の値で指定)。実行されていないタスクについては、この関数は NULL 状況を示すデータ行を返します。

許可

この関数を呼び出すユーザーには、MONITOR1 特権が必要です。

スキーマは DSNADM です。

最大履歴: タスクごとに返す実行状況の最大数を指定します。最新の実行状況が返されます。
このパラメーターを NULL に設定すると、使用可能なすべてのタスクの実行状況が返されます。このパラメーターを 1 に設定すると、最後に実行されたタスクの状況のみが返されます。この場合、このオプションを指定しないのと同じ結果になります。これは、タイプ INTEGER の入力パラメーターです。

この関数の結果は、以下の表に示された形式の表です。

表 1. ADMIN_TASK_STATUS の結果表の形式
列名	データ・タイプ	Contains
TASK_NAME	VARCHAR(128)	実行済み、実行中、またはバイパスされたタスクの名前が含まれています。
状況	VARCHAR(10)	タスク状況を示す、以下の値のいずれかを含みます。実行していますこのタスクは現在実行中です。完了タスクは実行を終了しました。非同期タスク (JCL ジョブ) の場合、この列には、ジョブが実行のサブミットをされると常に COMPLETED が含まれています。それ以外の場合、この列には、タスクの実行が完了した場合にのみ COMPLETED が含まれます。 NOTRUN このタスクは、スケジューリングされた呼び出し時刻には実行されませんでした。 MSG 列には、タスクが実行されなかった理由を示すエラーまたは警告メッセージが含まれています。 UNKNOWN このタスクの実行中に、スケジューラーがシャットダウンされました。スケジューラーは再開されましたが、この中断されたタスクの実行状況を認識できません。
NUM_ INVOCATIONS	INTEGER	管理タスク・スケジューラーがタスクの実行を試行した回数が入ります。タスクが現在実行中の場合は、現在の回も含まれます。この列の値は、タスクが正常に実行されたかどうかは示しません。
START_ TIMESTAMP	TIMESTAMP	STATUS 列に COMPLETED、RUNNING、または UNKNOWN が含まれている場合は、タスクが開始された時刻が含まれています。それ以外の場合は、この列には、タスクが開始するはずであったが開始できなかった時刻が含まれています。
END_ TIMESTAMP	TIMESTAMP	タスクの実行が完了した時刻が含まれています。
JOB_ID	CHAR(8)	管理タスク・スケジューラーによってサブミットされた JCL ジョブに割り当てられたジョブ ID が入ります。この列には、タスクがストアード・プロシージャーの場合、または STATUS 列に COMPLETED が含まれていない場合には、NULL が含まれています。
MAXRC	INTEGER	JCL ジョブのサブミットからの最も大きな戻りコードが含まれています。タスクが同期の場合、この列の値は、ジョブの実行の終了時に戻される戻りコードに変更されます。このカラムは、タスクがストアドプロシージャである場合、STATUSカラムにCOMPLETEDが含まれていない場合、または同期タスクが終了し、 JES3 で z/OS® 1.7 またはそれ以前のシステムで実行された場合、NULLに設定されます。
完了_ タイプ	INTEGER	管理タスク・スケジューラーがサブミットした JCL ジョブの完了タイプを示す、以下のいずれかの値が入ります。 0 完了情報なし 1 ジョブは正常終了した 2 ジョブは完了コードで終了した 3 ジョブに JCL エラーがある 4 ジョブはキャンセルされた 5 ジョブは異常終了した 6 ジョブの処理中にコンバーターが異常終了した 7 ジョブはセキュリティー検査に失敗した 8 ジョブはメモリーの終わり (end-of-memory) により失敗しました。この列には、タスクがストアド・プロシージャである場合、STATUS列にCOMPLETEDが含まれていない場合、またはJCLジョブが JES3 で z/OS 1.7 以前のシステムで実行された場合にNULLが含まれます。
SYSTEM_ ABENDCD	INTEGER	管理タスク・スケジューラーによってサブミットされて、失敗した JCL ジョブが戻したシステム異常終了コードが入ります。この列には、タスクがストアド・プロシージャである場合、STATUS列にCOMPLETEDが含まれていない場合、またはJCLジョブが JES3 で z/OS 1.7 以前のシステムで実行された場合にNULLが含まれます。
USER_ABENDCD	INTEGER	管理タスク・スケジューラーによってサブミットされて、失敗した JCL ジョブが戻したユーザー異常終了コードが入ります。この列には、タスクがストアド・プロシージャである場合、STATUS列にCOMPLETEDが含まれていない場合、またはJCLジョブが JES3 で z/OS 1.7 以前のシステムで実行された場合にNULLが含まれます。
MSG	VARCHAR(128)	タスクが最後に実行されたときのエラーまたは警告メッセージが含まれています。
SQLCODE	INTEGER	ストアード・プロシージャーが管理タスク・スケジューラーによって呼び出されたときに、Db2によって設定された SQLCODE が入ります。この列に NULL が入るのは、タスクが JCL ジョブの場合、あるいは STATUS 列が COMPLETED を含んでいない場合です。
SQLSTATE	CHAR(5)	管理タスクスケジューラによってストアドプロシージャが呼び出された際に、 Db2 によって設定されたSQLSTATEが含まれます。この列に NULL が入るのは、タスクが JCL ジョブの場合、あるいは STATUS 列が COMPLETED を含んでいない場合です。
SQLERRP	VARCHAR(8)	管理タスクスケジューラによってストアドプロシージャが呼び出された際に、 Db2 によって設定されたSQLERRPが含まれます。この列に NULL が入るのは、タスクが JCL ジョブの場合、あるいは STATUS 列が COMPLETED を含んでいない場合です。
SQLERRMC	VARCHAR(70)	管理タスクスケジューラによってストアドプロシージャが呼び出された際に、 Db2 によって設定されたSQLERRMCが含まれます。この列に NULL が入るのは、タスクが JCL ジョブの場合、あるいは STATUS 列が COMPLETED を含んでいない場合です。
DB2_SSID	VARCHAR(4)	タスクを実行した、または実行すべきであった管理タスクスケジューラに関連する Db2 サブシステムIDが含まれています。
USERID	VARCHAR(128)	このタスクを実行したユーザー ID が含まれています。

例 1: 実行されたすべてのタスクに関する状況情報を管理タスク・スケジューラー・タスク・リストで検索します。

   SELECT *
     FROM TABLE (DSNADM.ADMIN_TASK_STATUS()) AS T;