![変更の開始](./delta.gif)
TRACKED_JOB_INFO テーブル関数
TRACKED_JOB_INFO テーブル関数は、要求されたジョブに関する情報を返します。 この情報を使用して、ジョブを再実行依頼することができます。 一部の情報は, SBMJOB CL コマンドで提供することができます。 その他の情報は CHGJOB CL コマンドで提供することができます。
権限: 呼び出し側は *JOBCTL 特殊権限を持っている必要があります。
- ノード名フィルター (node-name-filter)
- 結果に含まれるジョブ・トラッキング・ファイル内のノード名を含むストリング。 このパラメーターを省略すると、すべてのノードの情報が戻されます。
- iasp-name-フィルター
- 結果に組み込まれるジョブ・トラッキング・ファイル内のジョブ待ち行列独立 ASP 名を含むストリング。 特殊値 *SYSBAS を入れることができます。 このパラメーターを省略すると、すべての ASP の情報が戻されます。
- ジョブ待ち行列ライブラリー・フィルター
- 結果に組み込まれるジョブ・トラッキング・ファイル内のジョブ待ち行列ライブラリー名を含むストリング。 このパラメーターを省略すると、すべての追跡対象ジョブ・キュー・ライブラリーの情報が戻されます。
- ジョブ・キュー・フィルター
- 結果に組み込まれるジョブ・トラッキング・ファイル内のジョブ・キュー名を含むストリング。 このパラメーターを省略すると、すべての追跡対象ジョブ・キュー・キューの情報が返されます。
この関数の結果は、以下の表に示された形式の行を含むテーブルです。 列はすべて NULL 可能です。
列名 | データ・タイプ | 説明 |
---|---|---|
node_name | VARCHAR(8) | 追跡対象のジョブ・キューが配置されている IBM® i 区画の名前。 |
QUALIFIED_JOB_NAME | VARCHAR(28) | ジョブの修飾名。 |
JOB_NAME | VARCHAR(10) | ジョブの名前。 |
JOB_USER | VARCHAR(10) | ジョブのユーザー・プロファイル。 |
JOB_NUMBER | VARCHAR(6) | ジョブの番号 |
COMMAND_OR_REQUEST_DATA (コマンドまたは要求データ) | VARCHAR (20000) 型 | ジョブが実行されるコマンド、またはジョブのメッセージ待ち行列に項目として入れられる要求データ。 ジョブのコマンドまたは要求データが設定されていない場合は、NULL 値が入ります。 |
JOB_ENTERED_SYSTEM_TIME | TIMESTAMP(0) | ジョブがシステムに入力されたときのタイム・スタンプ。 |
JOB_ACTIVE_TIME | TIMESTAMP(0) | ジョブが開始されたときのタイム・スタンプ。 ジョブが開始されていない場合は、NULL 値が入ります。 |
JOB_END_TIME | TIMESTAMP(0) | ジョブが終了したときのタイム・スタンプ。 ジョブが終了していない場合は、NULL 値が入ります。 |
JOB_QUEUE_ASP_NAME | VARCHAR(10) | ジョブ待ち行列が入っている ASP 装置名。 |
JOB_QUEUE_LIBRARY | VARCHAR(10) | ジョブ待ち行列を含んでいるライブラリーの名前。 |
JOB_QUEUE | VARCHAR(10) | 投入されたジョブのジョブ待ち行列の名前。 |
JOB_DESCRIPTION_LIBRARY | VARCHAR(10) | ジョブ記述を含んでいるライブラリーの名前。 |
JOB_DESCRIPTION | VARCHAR(10) | このジョブに使用されたジョブ記述の名前。 |
JOB_END_SEVERITY | INTEGER | ジョブが終了したときの戻りコード。 ジョブが終了していない場合は、NULL 値が入ります。 |
プロセス・ユニットの時間 | BIGINT | ジョブによって使用された処理装置時間の長さ (ミリ秒単位)。 ジョブが終了していない場合は、NULL 値が入ります。 |
JOB_QUEUE_PRIORITY | INTEGER | 同じジョブ待ち行列上の他のジョブと比較されたジョブのスケジューリング優先順位です。 最高優先順位は0で,最低の優先順位は9です。 |
PRINTER_DEVICE_NAME | VARCHAR(10) | このジョブからの出力を印刷するために使用される印刷装置。 |
OUTPUT_QUEUE_LIBRARY | VARCHAR(10) | 省略時の出力待ち行列が入っているライブラリーの名前。 OUTPUT_QUEUE に特殊値が含まれている場合は、NULL 値が入ります。 |
OUTPUT_QUEUE | VARCHAR(10) | このジョブによって作成されるスプール出力に使用される省略時の出力待ち行列の名前。 デフォルトの出力待ち行列は、出力待ち行列に *JOB を指定しているスプール印刷出力ファイル専用です。 特殊値 *DEV を入れることができます。 |
OUTPUT_QUEUE_PRIORITY | INTEGER | このジョブが作成するスプール出力ファイルの出力優先順位。 最高優先順位は 0 で、最低優先順位は 9 です。 |
JOB_ACCOUNTING_CODE | VARCHAR(15) | ジョブ・アカウンティングがアクティブな場合、ジョブに関するリソース使用情報を収集するためにシステムによってジョブに割り当てられる ID。 |
RUN_PRIORITY | INTEGER | 同時に活動状態になっている他のジョブおよびスレッドと比較して, ジョブまたはスレッドが処理装置を獲得するために競合する優先順位。 実行優先順位の範囲は 1 (最高の優先順位) から 99 (最低の優先順位) までです。 ジョブの実行優先順位が設定されていない場合は、NULL 値が入ります。 |
PRINT_TEXT | VARCHAR (30) | ジョブの印刷出力の各ページの終わりに印刷されるテキスト行。 |
ROUTING_DATA | VARCHAR(80) | 経路指定ステップで開始するプログラムを識別する経路指定項目を判別するために使用される経路指定データ。 次の特殊値を含めることができます。
|
ライブラリーの CURRENT_LIBRARY | VARCHAR(10) | 現行ライブラリー。 次の特殊値を含めることができます。
|
システム・ライブラリー・リスト・カウント | INTEGER | ライブラリー・リストのシステム部分にあるライブラリーの数。 |
システム・ライブラリー・リスト | VARCHAR (165) 型 | ライブラリー・リストのシステム部分。 リストは、11 文字の項目の配列です。 各項目に、10 文字の名前とそれに続く 1 つのブランクが含まれます。 ジョブの実行依頼時に指定されたシステム・ライブラリー・リストが空の場合は、NULL 値が入ります。 |
ユーザー・ライブラリー・リスト・カウント | INTEGER | ライブラリー・リストのユーザー部分にあるライブラリーの数。 |
ユーザー・ライブラリー・リスト | VARCHAR(2750) | ライブラリー・リストのユーザー部分。 リストは、11 文字の項目の配列です。 各項目に、10 文字の名前とそれに続く 1 つのブランクが含まれます。 ジョブの実行依頼時にユーザー・ライブラリー・リストが指定されなかった場合、または指定されたライブラリー・リストが空であった場合は、NULL 値が入ります。 |
ジョブ・グループの ITIAL_JOB_ASP_GROUP | VARCHAR(10) | 投入されたジョブの初期スレッドの補助記憶域プール (ASP) グループ名の初期設定。 次の特殊値を含めることができます。
|
MESSAGE_LOGGING_LEVEL | INTEGER | ログに記録される情報のタイプ。
|
MESSAGE_LOGGING_SEVERITY | INTEGER | ジョブ・ログに記録されるエラー・メッセージを決定するために,ロギング・レベルと一緒に使用される重大度レベル。 値の範囲は、0 から 99 です。 |
MESSAGE_LOGGING_TEXT | VARCHAR(7) | ロギング・レベルとロギング重大度に従ってメッセージがログに記録されるとき、ジョブ・ログに書き込まれるメッセージ・テキストのレベル。
|
LOG_CL_PROGRAM_COMMANDS | VARCHAR(4) | 実行される CL プログラムのコマンドをログに記録するかどうかを指定します。
|
JOB_LOG_OUTPUT | VARCHAR(10) | ジョブの完了時にジョブ・ログが作成される方法を指定します。
|
MAXIMUM_JOB_MESSAGE_QUEUE_SIZE | INTEGER | ジョブ・メッセージ待ち行列に許可される最大サイズ (メガバイト数)。 範囲は 2 から 64 です。 |
JOB_MESSAGE_QUEUE_FULL_ACTION | VARCHAR(8) | メッセージ待ち行列が満杯の時にとる処置。
|
INQUIRY_MESSAGE_REPLY | VARCHAR(8) | ジョブが照会メッセージに応答する方法を指定します。
|
HOLD_ON_JOB_QUEUE | VARCHAR(4) | このジョブが保留状況のジョブ待ち行列上にあるかどうか。
|
BREAK_MESSAGE | VARCHAR(10) | このジョブが中断メッセージを処理する方法を指定します。
ジョブの中断メッセージが設定されていない場合は、NULL 値が入ります。 |
STATUS_MESSAGE | VARCHAR(10) | このジョブの状況メッセージを表示するかどうかを指定します。
ジョブの状況メッセージが設定されていない場合は、NULL 値が入ります。 |
DDM_CONVERSATION | VARCHAR(5) | 分散データ管理機能 (DDM) プロトコルを使用する接続が使用されていないとき、それらの接続をアクティブなままにするかどうかを指定します。 この接続には、APPC 会話、アクティブ TCP/IP 接続、および 仮想 OptiConnect 接続が含まれます。
ジョブの DDM 会話が設定されていない場合は、NULL 値が入ります。 |
JOB_SCHEDULED_TIME | TIMESTAMP(0) | ジョブがアクティブになるようにスケジュールされたタイム・スタンプ。 これがスケジュール済みジョブでない場合は、NULL 値が入ります。 |
JOB_DATE | VARCHAR(10) | ジョブに割り当てられた日付 (*ISO 形式)。 ジョブ日付は、ユーザーによって変更されない限り、ジョブの期間中は同じ日付のままです。 次の特殊値が入ることもあります。
ジョブに日付が割り当てられていない場合は、NULL 値が入ります。 |
DATE_FORMAT | CHAR(4) | このジョブに使用された日付形式。
ジョブの日付形式が設定されていない場合は、NULL 値が入ります。 |
DATE_SEPARATOR | CHAR(1) | このジョブに使用された日付区切り記号。 ジョブの日付区切り記号が設定されていない場合は、NULL 値が入ります。 |
TIME_SEPARATOR | CHAR(1) | このジョブに使用された時刻区切り記号。 ジョブの時刻区切り記号が設定されていない場合は、NULL 値が入ります。 |
JOB_SWITCHES | CHAR(8) | このジョブによって使用されるジョブ・スイッチの現在の設定値。 |
許可されたジョブの書き込み | VARCHAR(4) | 投入されるジョブを「投入済みジョブの処理」パネルに表示できるかどうかを指定します。
|
修飾された実行依頼ジョブ名 | VARCHAR(28) | 実行依頼者のジョブの修飾ジョブ名。 |
SUBMITTER_JOB_NAME | VARCHAR(10) | 実行依頼者のジョブのジョブ名。 |
ジョブ・ユーザーの BMITTER_JOB_USER | VARCHAR(10) | 実行依頼者のジョブのユーザー名。 |
実行依頼者のジョブ番号 | VARCHAR(6) | 実行依頼者のジョブの番号。 |
JOBEND_MESSAGE_QUEUE_LIBRARY (ジョブ終了メッセージ・キュー・ライブラリー) | VARCHAR(10) | JOBEND_MESSAGE_QUEUE を含むライブラリーの名前。 JOBEND_MESSAGE_QUEUE に特殊値が含まれている場合は、NULL 値が入ります。 |
JOBEND_MESSAGE_QUEUE (ジョブ終了メッセージ・キュー) | VARCHAR(10) | 投入されたジョブの実行が完了した時に完了メッセージが送られるメッセージ待ち行列。 次の特殊値を含めることができます。
|
TIME_SLICE | INTEGER | このジョブ内および他のジョブ内の他のスレッドに実行の機会が与えられる前に、このジョブ内の各スレッドに与えられる最大プロセッサー時間 (ミリ秒単位)。 十分な量の処理を行うためにこのジョブ中のスレッドによって必要とされる時間数は、タイム・スライスによって設定されます。 タイム・スライスの終わりに,記憶域プール内で他のスレッドが活動状態になることができるように,スレッドは非活動状態になる可能性があります。 値の範囲は、8 から 9999999 です。 ジョブのタイム・スライス値が設定されていない場合は、NULL 値が入ります。 |
許可されたパージ | VARCHAR(4) | タイム・スライスの終わりに達した時,あるいは長時間待ちに入った時(例えばワークステーション・ユーザーの応答を待っている時)にジョブを主記憶域から取り出して,
補助記憶域に入れることが適格であるかどうかを指定します。
ジョブのパージ設定が設定されていない場合は、NULL 値が入ります。 |
DEFAULT_WAIT | INTEGER | ジョブ中のスレッドが資源を獲得するためにシステム命令 (LOCK マシン・インターフェース (MI) 命令など) を待機するデフォルト最大時間 (秒数)。 ジョブのデフォルト待ち時間が設定されていない場合は、NULL 値が入ります。 |
PRINT_KEY_FORMAT | VARCHAR(10) | ページ印刷キーを押した時に,枠および見出し情報を印刷するかどうかを指定します。
ジョブの印刷キー形式が設定されていない場合は、NULL 値が入ります。 |
SORT_SEQUENCE_LIBRARY | VARCHAR(10) | 分類順序テーブルを含んでいるライブラリーの名前。 SORT_SEQUENCE が特殊値である場合は、NULL 値が入ります。 |
SORT_SEQUENCE | VARCHAR(10) | このジョブに関連付けられている分類順序テーブルの名前。 次の特殊値を含めることができます。
|
LANGUAGE_ID | CHAR(3) | このジョブと対応する言語ID。 |
COUNTRY_ID | CHAR(2) | このジョブと関連した国または領域のID。 |
CCSID | INTEGER | このジョブに使用されるコード化文字セット ID (CCSID)。 |
COPY_ENVIRONMENT_VARIABLES | VARCHAR(4) | ジョブ投入からの環境変数を新しいジョブにコピーするかどうかを指定します。
|
ALLOW_MULTIPLE_THREADS | VARCHAR(4) | このジョブが複数ユーザー・スレッドを許可するかどうかを示します。 この属性によって,オペレーティング・システムがジョブの中でシステム・スレッドを作成することが妨げられることはありません。
|
DECIMAL_FORMAT | VARCHAR(6) | このジョブに使用された 10 進数形式。
ジョブの 10 進形式が設定されていない場合は、NULL 値が入ります。 |
CHARACTER_IDENTIFIER_CONTROL | VARCHAR(9) | ジョブの文字 ID 制御。 この属性は,表示装置ファイル,印刷装置ファイル,
およびパネル・グループに対して行われるCCSID変換のタイプを制御します。 この属性を使用するには、事前に表示装置ファイル、印刷出力ファイル、およびパネル・グループの作成コマンド、変更コマンド、またはオーバーライド・コマンドの CHRID コマンド・パラメーターに *CHRIDCTL 特殊値を指定する必要があります。
ジョブの文字 ID 制御が設定されていない場合は、NULL 値が入ります。 |
SPOOLED_FILE_ACTION | VARCHAR(7) | ジョブが通常のアクティビティーを完了した後、ジョブ・インターフェースからスプール・ファイルへのアクセスがあるかどうかを指定します。
|
最大処理時間が許可されました | INTEGER | ジョブが使用できる最大処理装置時間 (ミリ秒数)。 ジョブが複数の経路指定ステップから構成されている場合、これは現在の経路指定ステップで使用できる最大処理装置時間です。 最大時間を超えた場合には,ジョブは保留されます。 ジョブの最大処理装置時間が設定されていない場合は、NULL 値が入ります。 |
MAXIMUM_TEMPORARY_STORAGE_ALLOWED | INTEGER | ジョブが使用できる補助記憶域の最大量 (メガバイト数)。 ジョブに複数のルーティング・ステップがある場合には,これはルーティング・ステップが使用できる最大一時記憶域となります。 この一時記憶域は,プログラム自体に必要な記憶域,およびルーティング・ステップをサポートするために使用される暗黙に作成された内部システム・オブジェクトに必要な記憶域として使用されます。 (QTEMPライブラリー内のオブジェクトの記憶域は含まれません。) 最大一時記憶域を超えた場合には,ジョブは保留されます。 これは,ユーザー・プロファイルによって制御される永続記憶域の使用には適用されません。 ジョブの最大補助記憶域が設定されていない場合は、NULL 値が入ります。 |
プロセッサー・リソースの優先度 | VARCHAR(10) | システムに対して同時マルチスレッド化 (SMT) が有効になっている場合、ディスパッチされたときのジョブの相対的な重要度が、ディスパッチされた他のジョブと比較されます。
ジョブのプロセッサー・リソース優先順位が設定されていない場合は、NULL 値が入ります。 |
ステップの再 ING_STEP | INTEGER | 固有の番号。 追跡対象のジョブに対して TFRJOB が実行されると、新しいジョブ・レコードに対してより大きい数値が生成されます。 |
内部ジョブ ID (INTERNAL_JOB_IDENTIFIER) | BINARY(16) | 内部ジョブ ID。 |
例
- ライブラリー JQLIB 内のジョブ待ち行列 MYJOBQ について完了していないジョブについて, ジョブ待ち行列トラッキング・テーブル内のすべての項目を表示します。
SELECT * FROM TABLE(QSYS2.TRACKED_JOB_INFO(JOB_QUEUE_LIBRARY_FILTER => 'JQLIB', JOB_QUEUE_FILTER => 'MYJOBQ')) WHERE JOB_END_TIME IS NULL;
![変更の終わり](./deltaend.gif)