OUTPUT_QUEUE_ENTRIES テーブル関数
OUTPUT_QUEUE_ENTRIES テーブル関数は、出力待ち行列内の各スプール・ファイルに対して 1 行を返します。
>>-OUTPUT_QUEUE_ENTRIES--(--+----------------+--outq-lib--,-----> '-OUTQ_LIB-- => -' >--+-----------------+--outq-name-------------------------------> '-OUTQ_NAME-- => -' >--+----------------------------------------------+------------>< '-,--+---------------------+--detailed-info--)-' '-DETAILED_INFO-- => -'
スキーマは QSYS2 です。
この関数を呼び出すには、呼び出し元は以下を備えている必要があります。
- 出力待ち行列オブジェクトに対する読み取り権限、または
- *JOBCTL 特殊権限、かつ出力待ち行列に OPRCTL(*YES) が設定されている、または
- *SPLCTL特殊権限
- outq-lib
- outq-name が入っているライブラリーの名前を識別する文字またはグラフィック・ストリング式。このパラメーターがブランクの場合、デフォルトの *LIBL が使用されます。
- outq-name
- 出力待ち行列の名前を識別する文字またはグラフィック・ストリング式。
- detailed-info
- 返す情報のタイプを識別する文字またはグラフィック・ストリング式。
- *YES
- 出力待ち行列で使用可能なすべての情報が戻されます。
- *NO
- 出力待ち行列の一般情報のみが返されます。 これは、ACCOUNTING_CODE 列の前の列にある情報です。これはデフォルト値。
この関数の結果は、以下の表に示された形式の行を含むテーブルです。列はすべて NULL 可能です。
列名 | データ・タイプ | 説明 |
---|---|---|
CREATE_TIMESTAMP | TIMESTAMP | ファイルが作成されたときのタイム・スタンプ。 |
SPOOLED_FILE_NAME | VARCHAR(10) | ファイルが作成されたときにユーザー・プログラムによって指定されたファイル名、またはこのファイルを作成するのに使用された装置ファイルの名前。 |
USER_NAME | VARCHAR(10) | ファイルを作成したユーザー・プロファイルの名前。 |
USER_DATA | VARCHAR(10) | このファイルを記述するユーザー指定データ。ユーザー指定データが存在しない場合は、NULL が入ります。 |
STATUS | VARCHAR(15) | スプール・ファイルの状況。
|
SIZE | INTEGER | スプール・ファイルのサイズ (キロバイト)。 |
TOTAL_PAGES | INTEGER | ファイルの合計ページ数。 |
COPIES | SMALLINT | 印刷するコピーの残数。 |
FORM_TYPE | VARCHAR(10) | このファイルを印刷するために印刷装置にロードする必要がある用紙のタイプ。 |
JOB_NAME | VARCHAR(28) | ファイルを作成した修飾ジョブ名。 |
DEVICE_TYPE | VARCHAR(10) | ファイルを表すために使用されたデータ・ストリームのタイプ。
|
OUTPUT_PRIORITY | SMALLINT | スプール・ファイルの優先順位。 |
FILE_NUMBER | INTEGER | 指定したファイルのスプール・ファイル番号。 |
SYSTEM | VARCHAR(8) | スプール・ファイルを作成したジョブが実行されたシステムの名前。 |
DETAILED_INFO パラメーターが *YES の場合、以下の列の値が返されます。それ以外の場合、これらの列には NULL 値が入ります。 | ||
ACCOUNTING_CODE | VARCHAR(15) | このファイルの書き出しに使用された資源を記録するためにシステムによって割り当てられた ID。 |
EXPIRATION_DATE | DATE | ファイルが満了スプール・ファイルの削除 (DLTEXPSPLF) コマンドによるシステムからの除去に適格になる日付。ファイルの有効期限がない場合は、NULL 値が入ります。 |
SAVE_AFTER_WRITE | VARCHAR(4) | このファイルが書き出し後に保存されるかどうかを示します。
|
PAGE_LENGTH | INTEGER | スプール・ファイルで使用されているページの長さ (1 ページ当たりの行数)。 |
LINES_PER_INCH | DECIMAL(5,1) | 印刷出力ファイルに定義されている縦方向のインチ当たりの行数。 |
PAGE_WIDTH | INTEGER | スプール・ファイルで使用されているページ幅 (印刷行当たりの文字数)。 |
CHARACTERS_PER_INCH | DECIMAL(5,1) | 印刷出力ファイルに定義されている、横方向のインチ当たりの文字数。 |
PRINT_FIDELITY | VARCHAR(8) | 印刷時に実行されるエラー処理の種類。
|
PAGE_ROTATION | VARCHAR(5) | 用紙が印刷装置にロードされる方向を基準とした、ページ上のテキストの回転角度。
|
PRINT_BOTH_SIDES | VARCHAR(7) | 情報の印刷の仕方。
|
FILE_AVAILABLE | VARCHAR(8) | このファイルが処理のために出力装置に対して使用可能となる時点。
|
STARTING_PAGE | VARCHAR(10) | ファイルの印刷を開始するページ。次の特殊値を含めることができます。
|
ENDING_PAGE | VARCHAR(10) | ファイルの印刷を終了するページ。次の特殊値を含めることができます。
|
DEVICE_FILE_LIBRARY | VARCHAR(10) | 装置ファイルが入っているライブラリーの名前。 |
DEVICE_FILE_NAME | VARCHAR(10) | スプール・ファイルを作成するのに使用される装置ファイルの名前。 |
PROGRAM_THAT_OPENED_FILE_LIBRARY | VARCHAR(10) | ファイルをオープンしたプログラムが入っているライブラリーの名前。プログラムが不明である場合、NULL が入ります。 |
PROGRAM_THAT_OPENED_FILE_NAME | VARCHAR(10) | スプール・ファイルをオープンしたプログラムの名前。プログラムが不明である場合、NULL が入ります。 |
FORM_DEFINITION_LIBRARY | VARCHAR(10) | 書式定義が入っているライブラリーの名前。FORM_DEFINITION_NAME が特殊値である場合、またはこのスプール・ファイルの書式定義が指定されていない場合は、NULL が入ります。 |
FORM_DEFINITION_NAME | VARCHAR(10) | この印刷要求に使用する書式定義の名前。次の特殊値のいずれかが含まれることがあります。
|
PAGE_DEFINITION_LIBRARY | VARCHAR(10) | ページ定義が入っているライブラリーの名前。*LINE または *AFPDSLINE 印刷装置タイプ・ファイルの場合は、NULL 値が入ります。 |
PAGE_DEFINITION_NAME | VARCHAR(10) | ファイルに使用するページ定義の名前。*LINE または *AFPDSLINE 印刷装置タイプ・ファイルの場合は、NULL 値が入ります。 |
FRONT_OVERLAY_LIBRARY | VARCHAR(10) | 前面オーバーレイが入っているライブラリーの名前。次の特殊値のいずれかが含まれることがあります。
|
FRONT_OVERLAY_NAME | VARCHAR(10) | 前面オーバーレイの名前。
次の特殊値を含めることができます。
|
BACK_OVERLAY_LIBRARY | VARCHAR(10) | 背面オーバーレイが入っているライブラリーの名前。BACK_OVERLAY_NAME が特殊値の場合は、NULL が入ります。 |
BACK_OVERLAY_NAME | VARCHAR(10) | 背面オーバーレイの名前。次の特殊値を含めることができます。
|
CHARACTER_SET_LIBRARY | VARCHAR(10) | フォント文字セット・オブジェクトを含むライブラリーの名前。次の特殊値のいずれかが含まれることがあります。
|
CHARACTER_SET_NAME | VARCHAR(10) | このファイルを印刷するために使用されるフォント文字セット・オブジェクトの名前。次の特殊値を含めることができます。
|
CODE_PAGE_LIBRARY | VARCHAR(10) | このスプール・ファイルを印刷するために使用されるコード・ページが入っているライブラリーの名前。次の特殊値のいずれかが含まれることがあります。
|
CODE_PAGE_NAME | VARCHAR(10) | このスプール・ファイルを印刷するために使用されるコード・ページの名前。このスプール・ファイルにコード・ページが指定されていない場合は、NULL が入ります。 |
CHARACTER_SET_POINTSIZE | DECIMAL(5,1) | このファイルの文字を印刷するポイント・サイズ。文字セットにポイント・サイズが設定されていない場合は、NULL が入ります。 |
CODED_FONT_LIBRARY | VARCHAR(10) | このスプール・ファイルを印刷するために使用されるコード化フォントが入っているライブラリーの名前。次の特殊値のいずれかが含まれることがあります。
|
CODED_FONT_NAME | VARCHAR(10) | このスプール・ファイルを印刷するために使用されるコード化フォントの名前。次の特殊値を含めることができます。
|
CODED_FONT_POINTSIZE | DECIMAL(5,1) | このファイルの文字を印刷するポイント・サイズ。コード化フォントにポイント・サイズが設定されていない場合は、NULL が入ります。 |
MULTIBYTE_DATA | VARCHAR(10) | ファイルに 2 バイト文字セット (DBCS) データを含めることができるのか、Unicode データを含めることができるのか、それともその両方を含めることができるのか。値は *YES と *NO です。 |
DBCS_CODED_FONT_LIBRARY | VARCHAR(10) | DBCS コード化フォントが入っているライブラリーの名前。次の特殊値のいずれかが含まれることがあります。
|
DBCS_CODED_FONT_NAME | VARCHAR(10) | AFP(*YES)として構成された印刷装置
で DBCS コード化データを印刷するために使用される DBCS コード化フォントの名前。次の特殊値を含めることができます。
|
DBCS_CODED_FONT_POINTSIZE | DECIMAL(5,1) | このファイルの DBCS 文字を印刷するポイント・サイズ。DBCS コード化フォントにポイント・サイズが設定されていない場合は、NULL が入ります。 |
例
QEZJOBLOG 出力待ち行列内に入っている、最大で 100 個のスプール・ファイルを検索します。詳細情報は不要であるため、*NO を指定して追加処理を回避します。
SELECT *
FROM TABLE(QSYS2.OUTPUT_QUEUE_ENTRIES('*LIBL', 'QEZJOBLOG', '*NO')) A
ORDER BY SIZE DESC
FETCH FIRST 100 ROWS ONLY