OUTPUT_QUEUE_ENTRIES_BASIC ビュー

オンライン編集

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

許可: 呼び出し側は以下を備えている必要があります。

出力待ち行列ライブラリーに対する *EXECUTE 権限および
- 出力待ち行列オブジェクトに対する *READ 権限、または
- *SPLCTL 特殊権限、または
- *JOBCTL 特殊権限および出力待ち行列は OPRCTL (*YES) で定義されます。

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	作成済み	TIMESTAMP	ファイルが作成されたときのタイム・スタンプ。
SPOOLED_FILE_NAME	SPOOLNAME	VARCHAR(10)	ファイルが作成されたときにユーザー・プログラムによって指定されたファイル名、またはこのファイルを作成するのに使用された装置ファイルの名前。
USER_NAME	USER_NAME	VARCHAR(10)	ファイルを作成したユーザー・プロファイルの名前。
USER_DATA	USER_DATA	VARCHAR(10) ヌル可能	このファイルを記述するユーザー指定データ。ユーザー指定データが存在しない場合は、NULL が入ります。
状況	状況	VARCHAR(15)	スプール・ファイルの状況。 CLOSED ファイルはプログラムによって完全に処理されましたが、SCHEDULE(*JOBEND) が指定されており、ファイルを作成したジョブがまだ終了していません。 DEFERRED ファイルの印刷は据え置かれています。 DELETED ファイルは削除されています。 HELD ファイルは保留中です。 MESSAGE WAITING このファイルには、応答または処置を必要とするメッセージがあります。 OPEN ファイルは完全には処理されていないため、書き出しプログラムが選択できる状態にありません。 PENDING このファイルは印刷のために保留中です。 PRINTING このファイルは印刷装置に完全に送信されましたが、印刷完了状況が戻されていません。 READY ファイルは書き出し可能な状態です。保存ファイルは印刷されて保存されました。このファイルは、解放されるまで保存されます。 SENDING このファイルは送信中であるか、またはリモート・システムに送信されました。 WRITING このファイルは、現在、書き出しプログラムによって作成中です。
サイズ	サイズ	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;