OUTPUT_QUEUE_ENTRIES_BASIC ビュー

OUTPUT_QUEUE_ENTRIES_BASIC ビューは、すべての出力待ち行列内の各スプール・ファイルについて 1 行を返します。このビューは、DETAILED_INFO => 'NO' が指定された QSYS2.OUTPUT_QUEUE_ENTRIES テーブル関数を使用します。

スキーマは QSYS2 です。

呼び出し元が以下を備えている場合、スプール・ファイルに対して行が返されます。

出力待ち行列ライブラリーに対する実行権限、かつ
- 出力待ち行列オブジェクトに対する読み取り権限、または
- *JOBCTL 特殊権限、かつ出力待ち行列に OPRCTL(*YES) が設定されている、または
- *SPLCTL特殊権限

OUTPUT_QUEUE_ENTRIES_BASIC ビューを照会するときに最適なパフォーマンスを実現するために、特定の出力待ち行列ライブラリーまたは出力待ち行列を調べることに関心がある場合には、WHERE 節の使用をお勧めします。通常、OUTPUT_QUEUE_ENTRIES_BASIC のほうが、OUTPUT_QUEUE_ENTRIES よりパフォーマンスは優れます。 OUTPUT_QUEUE_ENTRIES_BASIC に、照会が必要とする列が含まれない場合にのみ、OUTPUT_QUEUE_ENTRIES を使用してください。

次の表はビュー内の列を説明したものです。システム名は OUTQ_INFOB です。スキーマは QSYS2 です。

表 1. OUTPUT_QUEUE_ENTRIES_BASIC ビュー
列名	システム列名	データ・タイプ	説明
OUTPUT_QUEUE_NAME	OUTQ	VARCHAR(10)	スプール・ファイルを含む出力待ち行列の名前。
OUTPUT_QUEUE_LIBRARY_NAME	OUTQLIB	VARCHAR(10)	出力待ち行列が入っているライブラリーの名前。
CREATE_TIMESTAMP	CREATED	TIMESTAMP	ファイルが作成されたときのタイム・スタンプ。
SPOOLED_FILE_NAME	SPOOLNAME	VARCHAR(10)	ファイルが作成されたときにユーザー・プログラムによって指定されたファイル名、またはこのファイルを作成するのに使用された装置ファイルの名前。
USER_NAME	USER_NAME	VARCHAR(10)	ファイルを作成したユーザー・プロファイルの名前。
USER_DATA	USER_DATA	VARCHAR(10) NULL 可能	このファイルを記述するユーザー指定データ。ユーザー指定データが存在しない場合は、NULL が入ります。
STATUS	STATUS	VARCHAR(15)	スプール・ファイルの状況。 CLOSED ファイルはプログラムによって完全に処理されましたが、SCHEDULE(*JOBEND) が指定されており、ファイルを作成したジョブがまだ終了していません。 DEFERRED ファイルの印刷は据え置かれています。削除ファイルは削除されています。 HELD ファイルは保留中です。 MESSAGE WAITING このファイルには、応答または処置を必要とするメッセージがあります。 OPEN ファイルは完全には処理されていないため、書き出しプログラムが選択できる状態にありません。 PENDING このファイルは印刷のために保留中です。 PRINTING このファイルは印刷装置に完全に送信されましたが、印刷完了状況が戻されていません。 READY ファイルは書き出し可能な状態です。保存ファイルは印刷されて保存されました。このファイルは、解放されるまで保存されます。 SENDING このファイルは送信中であるか、またはリモート・システムに送信されました。 WRITING このファイルは、現在、書き出しプログラムによって作成中です。
SIZE	SIZE	INTEGER	スプール・ファイルのサイズ (キロバイト)。
TOTAL_PAGES	PAGES	INTEGER	ファイルの合計ページ数。
COPIES	COPIES	SMALLINT	印刷するコピーの残数。
FORM_TYPE	FORM_TYPE	VARCHAR(10)	このファイルを印刷するために印刷装置にロードする必要がある用紙のタイプ。
JOB_NAME	JOB_NAME	VARCHAR(28)	ファイルを作成した修飾ジョブ名。
DEVICE_TYPE	DEVTYPE	VARCHAR(10)	ファイルを表すために使用されたデータ・ストリームのタイプ。 AFPDS 拡張機能表示データ・ストリーム AFPDSLINE AFPDS データと 1403 行データの混合 IPDS 高機能印刷装置データ・ストリーム LINE 1403 行データ SCS システム・ネットワーク体系 (SNA) 文字ストリーム USERASCII ASCII データ
OUTPUT_PRIORITY	OUTPTY	SMALLINT	スプール・ファイルの優先順位。
FILE_NUMBER	FILENUM	INTEGER	指定したファイルのスプール・ファイル番号。
SYSTEM	SYSTEM	VARCHAR(8)	スプール・ファイルを作成したジョブが実行されたシステムの名前。

例

QEZJOBLOG 出力待ち行列内に入っている、最大で 100 個のスプール・ファイルを検索します。

SELECT * FROM QSYS2.OUTPUT_QUEUE_ENTRIES_BASIC
  WHERE OUTPUT_QUEUE_NAME = 'QEZJOBLOG'
  ORDER BY SIZE DESC
  FETCH FIRST 100 ROWS ONLY

SPOOL 記憶域の上位利用者 10 名を見つけます。

SELECT USER_NAME, SUM(SIZE) AS TOTAL_SPOOL_SPACE
  FROM QSYS2.OUTPUT_QUEUE_ENTRIES_BASIC
  WHERE USER_NAME NOT LIKE 'Q%'
  GROUP BY USER_NAME
  ORDER BY TOTAL_SPOOL_SPACE DESC LIMIT 10;