OUTPUT_QUEUE_ENTRIES 視圖

OUTPUT_QUEUE_ENTRIES 視圖會針對每個輸出佇列中的每個排存檔傳回一列。此視圖搭配使用 QSYS2.OUTPUT_QUEUE_ENTRIES 表格函數與 DETAILED_INFO => 'YES'。

授權: 呼叫者必須具有:

對輸出佇列檔案庫及
- 對輸出佇列物件的 *READ 權限，或
- *SPLCTL 特殊權限，或
- *JOBCTL 特殊權限及輸出佇列以 OPRCTL (*YES) 定義。

若要在查詢 OUTPUT_QUEUE_ENTRIES 視圖時達到最佳效能，如果您有興趣檢查特定的輸出佇列檔案庫或輸出佇列，建議使用 WHERE 子句。 OUTPUT_QUEUE_ENTRIES_BASIC 的執行效能通常比 OUTPUT_QUEUE_ENTRIES 好很多。只有在 OUTPUT_QUEUE_ENTRIES_BASIC 不包括查詢所需的直欄時，才應該使用 OUTPUT_QUEUE_ENTRIES。

下表說明視圖中的直欄。系統名稱是 OUTQ_INFO。綱目為 QSYS2。

表 1. OUTPUT_QUEUE_ENTRIES 視圖
直欄名稱	系統直欄名稱	資料類型	說明
OUTPUT_QUEUE_NAME	OUTQ	VARCHAR (10)	包含排存檔的輸出佇列名稱。
OUTPUT_QUEUE_LIBRARY_NAME	OUTQLIB	VARCHAR (10)	包含輸出佇列的檔案庫名稱。
建立時間戳記	CREATED	TIMESTAM	建立檔案時的時間戳記。
排存檔案名稱	SPOOLNAME	VARCHAR (10)	建立檔案時由使用者程式指定的檔名，或用來建立此檔案的裝置檔案名稱。
USER_NAME	USER_NAME	VARCHAR (10)	產生檔案的使用者設定檔名稱。
USER_DATA	USER_DATA	VARCHAR (10) 可為空值	說明此檔案的使用者指定資料。如果沒有使用者指定的資料，則包含空值。
狀態	狀態	VARCHAR (15)	排存檔的狀態。 CLOSED 程式已完全處理檔案，但已指定 SCHEDULE (*JOBEND) ，且產生檔案的工作尚未完成。 DEFERRED 已延遲列印檔案。 DELETED 已刪除檔案。 HELD 已保留檔案。訊息等待中此檔案具有需要回覆或採取動作的訊息。已開啟檔案尚未完全處理，且尚未備妥可供寫出器選取。擱置中檔案擱置列印。列印檔案已完全傳送至印表機，但未傳回列印完成狀態。備妥可以寫入檔案。儲存已列印檔案，然後儲存。此檔案會保持儲存狀態，直到釋放為止。 SENDING 檔案正在傳送或已傳送至遠端系統。寫入中寫出器目前正在產生此檔案。
SIZE	SIZE	INTEGER	排存檔的大小 (以 KB 為單位)。
總頁數	頁面	INTEGER	檔案中的頁面總數。
COPIES	COPIES	SMALLINT	要列印的剩餘份數。
格式類型	格式類型	VARCHAR (10)	應載入印表機以列印此檔案的表單類型。
JOB_NAME	JOB_NAME	VARCHAR (28)	產生檔案的完整工作名稱。
裝置類型	DEVTYPE	VARCHAR (10)	用來代表檔案的資料串流類型。 AFPDS Advanced Function Presentation 資料串流 AFPDSLINE AFPDS 資料與 1403 行資料混合 IPDS 智慧型印表機資料串流 LINE 1403 行資料 SCS 系統網路架構 (SNA) 字元串流 USERASCII ASCII資料
輸出優先順序	OUTPTY	SMALLINT	排存檔的優先順序。
檔案號碼	FILENUM	INTEGER	指定檔案的排存檔號碼。
SYSTEM	SYSTEM	VARCHAR (8)	建立排存檔之工作執行所在的系統名稱。
ACCOUNTING_CODE	ACGCDE	VARCHAR (15)	系統指派的 ID ，用來記錄用來寫入此檔案的資源。
EXPIRATION_DATE	EXPDATE	DATE 可為空值	「刪除過期排存檔 (DLTEXPSPLF)」指令可從系統中移除檔案的日期。如果檔案不會到期，則包含空值。
儲存之後寫入	SAVEAFTER	VARCHAR (4)	指出此檔案在寫入之後是否要儲存。 NO 檔案在寫入之後會被刪除。 YES 檔案在寫入之後會設為儲存狀態。
TOTAL_RECORDS	總計 rcds	INTEGER	印表機檔案中的記錄總數。由於回覆查詢訊息 CPA4072， TOTAL_RECORDS 可能大於 MAXIMUM_RECORDS。如果排存檔資料串流不是 AFPDS、AFPDSLINE 或 *LINE ，或如果檔案已開啟，則包含空值。
MAXIMUM_RECORDS	MAXRCDS	INTEGER	開啟檔案時，檔案中容許的記錄數上限。如果沒有上限，則包含空值。
頁面長度	PAGELEN	INTEGER	排存檔所使用的頁面長度 (以每頁行數為單位)。
LINES_PER_INCH	LPI	DECIMAL (5, 1)	印表機檔案中定義的每垂直英吋行數。
PAGE_WIDTH	寬度	INTEGER	排存檔所使用的頁面寬度 (以每一列印行的字元數為單位)。
CHARACTERS_PER_INCH	CPI	DECIMAL (5, 1)	印表機檔案中定義的每水平英吋字元數。
列印清晰度	FIDELITY	VARCHAR (8)	列印時執行的一種錯誤處理常式。 ABSOLUTE 只有在可以完全依照資料串流中的指定來列印檔案時，才會列印檔案。 CONTENT 列印會置換資料串流中的錯誤，並根據內文清晰度以印表機最佳品質繼續列印。
PAGE_ROTATION	旋轉	VARCHAR (5)	頁面上文字的旋轉度，與表單載入印表機的方向有關。 AUTO 不論列印品質為何，如果輸出太大而無法適合表單，則會自動執行電腦輸出縮減。 DEVD 作業系統傳送裝置預設旋轉值給印表機。頁面旋轉取決於印表機的規格。 *COR 針對表單 13.2 英吋寬 ( 11.0 英吋長) 所建立的輸出已調整為在表單 11.0 英吋寬 ( 8.5 英吋長) 上列印。
PRINT_BOTH_SIDES	BOTHSIDES	VARCHAR (7)	列印資訊的方法。 FORMDF 檔案使用使用者指定的格式定義。此值僅用於 LINE、AFPDS 及 AFPDSLINE 印表機裝置類型檔案。 NO 頁面上的列印僅在一端。 YES 列印位於頁面的兩側，每一頁的頂端兩側都相同。 *TUMBLE 列印位於兩側，其中一個列印頁面的頂端與另一個列印頁面的頂端位於另一個列印頁面的相對端。
FILE_AVAILABLE	$url.8	VARCHAR (8)	此檔案變成可供輸出裝置處理的時間。 IMMED 一旦開啟檔案，即可使用該檔案。 FILEEND 一旦關閉檔案，即可使用該檔案。 *JOBEND 當擁有檔案的工作完成時，即可使用檔案。
STARTING_PAGE	STARTPAGE	VARCHAR (10)	檔案開始列印的頁面。可包含下列特殊值: *ENDPAGE 列印從最後一頁開始。
ENDING_PAGE	ENDPAGE	VARCHAR (10)	要結束檔案列印的頁面。可包含下列特殊值: *END 列印以最後一頁結束。
DEVICE_FILE_LIBRARY	DEVLIB	VARCHAR (10)	包含裝置檔案的檔案庫名稱。
DEVICE_FILE_NAME	DEVFILE	VARCHAR (10)	用來建立排存檔的裝置檔案名稱。
USER_DEFINED_DATA	USRDFNDTA	BINARY (255)	由使用者定義的資料，供處理排存檔的使用者應用程式或使用者指定程式使用。當沒有使用者定義資料時包含空值。
PROGRAM_THAT_OPENED_ FILE_LIBRARY	LIBOPEN	VARCHAR (10) 可為空值	包含開啟檔案之程式的檔案庫名稱。當程式不明時包含空值。
PROGRAM_THAT_OPENED_ 檔案 _ 名稱	PGMOPEN	VARCHAR (10) 可為空值	開啟排存檔的程式名稱。當程式不明時包含空值。
FORM_DEFINITION_LIBRARY	FORMLIB	VARCHAR (10) 可為空值	包含表單定義的檔案庫名稱。如果 FORM_DEFINITION_NAME 是特殊值或未指定此排存檔的格式定義，則包含空值。
FORM_DEFINITION_NAME	FORMNAME	VARCHAR (10) 可為空值	用於此列印要求的格式定義名稱。可包含下列其中一個特殊值: DEVD 將使用印表機裝置說明中的格式定義。 INLINE 將使用排存檔資料串流中定義的格式定義。 *INLINED 將使用排存檔資料串流中定義的格式定義。如果找不到格式定義，則會使用印表機裝置說明中的格式定義。 F1DFLT 將使用排存檔資料串流中定義的格式定義。未指定此排存檔的格式定義時包含空值。
PAGE_DEFINITION_LIBRARY	PAGELIB	VARCHAR (10) 可為空值	包含頁面定義的檔案庫名稱。包含 LINE 或 AFPDSLINE 印表機裝置類型檔案的空值。
頁面 _ 定義 _ 名稱	PageName	VARCHAR (10) 可為空值	要用於檔案的頁面定義名稱。包含 LINE 或 AFPDSLINE 印表機裝置類型檔案的空值。
FRONT_OVERLAY_LIBRARY	FRONTLIB	VARCHAR (10) 可為空值	包含正面套版的檔案庫名稱。可以包含下列其中一個特殊值: CURLIB 在前端套版中搜尋現行磁帶庫。 LIBL 檔案庫清單是用來尋找前端套印格式。當 FRONT_OVERLAY_NAME 是 *NONE 時包含空值。
FRONT_OVERLAY_NAME	FRONTNAME	VARCHAR (10)	前端套版的名稱。可包含下列特殊值: *NONE 檔案不使用正面套版。
BACK_OVERLAY_LIBRARY	BACKLIB	VARCHAR (10) 可為空值	包含後端套版的檔案庫名稱。當 BACK_OVERLAY_NAME 是特殊值時包含空值。
BACK_OVERLAY_NAME	BACKNAME	VARCHAR (10)	後端套版的名稱。可包含下列特殊值: FRONTOVL 後套版與前套版相同。 NONE 檔案不使用正面套版。
CHARACTER_SET_LIBRARY	CHRSETLIB	VARCHAR (10) 可為空值	包含字型集物件的檔案庫名稱。可以包含下列其中一個特殊值: CURLIB 搜尋現行檔案庫中的字型集物件。 LIBL 使用檔案庫清單來尋找字型集物件。當 CHARACTER_SET_NAME 為 *FONT 時包含空值。
CHARACTER_SET_NAME	CHRSETNAME	VARCHAR (10)	用來列印此檔案的字型集物件名稱。可包含下列特殊值: *FONT 使用在字型參數上指定的資訊，而非字集和字碼頁。
CODE_PAGE_LIBRARY	CODELIB	VARCHAR (10) 可為空值	包含用來列印此排存檔之字碼頁的檔案庫名稱。可以包含下列其中一個特殊值: CURLIB 在現行檔案庫中搜尋字碼頁名稱。 LIBL 檔案庫清單是用來尋找字碼頁名稱。未指定此排存檔的字碼頁時包含空值。
CODE_PAGE_NAME	CODENAME	VARCHAR (10) 可為空值	用來列印此排存檔的字碼頁名稱。未指定此排存檔的字碼頁時包含空值。
CHARACTER_SET_POINTSIZE	CHARSIZE	DECIMAL (5, 1) 可為空值	應該列印此檔案的字元 (由 CHARACTER_SET 定義) 的點大小。如果字集沒有字型大小，則包含空值。
CODED_FONT_LIBRARY	FONTLIB	VARCHAR (10) 可為空值	包含用來列印此排存檔之編碼字型的檔案庫名稱。可以包含下列其中一個特殊值: CURLIB 在現行檔案庫中搜尋編碼字型。 LIBL 該檔案庫清單是用來尋找寫碼字型組。 CODED_FONT_NAME 為 *FNTCHRSET 時包含空值。
CODED_FONT_NAME	FONTNAME	VARCHAR (10)	用來列印此排存檔的編碼字型名稱。可包含下列特殊值: *FNTCHRSET 使用的值是字集名稱和檔案庫名稱以及字碼頁名稱和檔案庫名稱欄位上指定的值。
CODED_FONT_POINTSIZE	FONTSIZE	DECIMAL (5, 1) 可為空值	應該列印此檔案的字元 (由 CODED_FONT 定義) 的點大小。如果編碼字型沒有字型大小，則包含空值。
MULTIBYTE_DATA	多位元組	VARCHAR (10)	檔案是否可以包含雙位元組字集 (DBCS) 資料及/或 Unicode 資料。值為 YES 及 NO。
DBCS_CODED_FONT_LIBRARY	DBCSLIB	VARCHAR (10) 可為空值	包含 DBCS 編碼字型的檔案庫名稱。可以包含下列其中一個特殊值: CURLIB 在現行檔案庫中搜尋 DBCS 編碼字型。 LIBL 使用檔案庫清單來尋找 DBCS 編碼字型。當 DBCS_CODED_FONT_NAME 為 *SYSVAL 時包含空值。
DBCS_CODED_FONT_NAME	DBCSNAME	VARCHAR (10)	在配置為 AFP (YES) 的印表機上，用來列印 DBCS 編碼資料的 DBCS 編碼字型名稱。可包含下列特殊值: SYSVAL 使用系統值中指定的 DBCS 編碼字型。
DBCS_CODED_FONT_POINTSIZE	DBCSSIZE	DECIMAL (5, 1) 可為空值	應該列印此檔案的 DCBS 字元 (由 DBCS_CODED_FONT 定義) 的點大小。如果 DBCS 編碼字型沒有字型大小，則包含空值。

範例

對於具有最大檔案數的輸出佇列，請執行「刪除過期排存檔 (DLTEXPSPLF)」CL 指令來決定要刪除的資料 KB 數。

WITH MOSTFILES(OUTQ_LIB, OUTQ_NAME) AS (
  SELECT OUTPUT_QUEUE_LIBRARY_NAME, OUTPUT_QUEUE_NAME
    FROM QSYS2.OUTPUT_QUEUE_INFO
      ORDER BY NUMBER_OF_FILES DESC
        LIMIT 1
)
SELECT SUM(SIZE) AS KB_TO_CLEAR
  FROM MOSTFILES, QSYS2.OUTPUT_QUEUE_ENTRIES
    WHERE OUTPUT_QUEUE_LIBRARY_NAME = OUTQ_LIB  AND
          OUTPUT_QUEUE_NAME         = OUTQ_NAME AND
          EXPIRATION_DATE IS NOT NULL           AND
          EXPIRATION_DATE < CURRENT DATE;