DATA_QUEUE_INFO 視圖

線上編輯

DATA_QUEUE_INFO 視圖會針對每個資料佇列傳回一列。

傳回的資訊類似於透過「擷取資料佇列說明 (QMHQRDQD)」提供的資訊 API。

授權: 呼叫者必須具有:
  • 對包含資料佇列之檔案庫的 *EXECUTE 權限，以及
  • 資料佇列的 *OBJOPR 及 *READ 權限。

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

表 1. DATA_QUEUE_INFO 視圖
直欄名稱 系統直欄名稱 資料類型 說明
資料佇列 _ 檔案庫 DTAQ_LIB VARCHAR (10) 包含資料佇列的檔案庫。
DATA_QUEUE_NAME DTAQ VARCHAR (10) 資料佇列的名稱。
DATA_QUEUE_TYPE DTAQ_TYPE VARCHAR (8) 這將設為下列其中一個值:
DDM
資料佇列是 DDM 資料佇列。
標準
資料佇列是標準資料佇列。
MAXIMUM_MESSAGE_LENGTH MSG_LENGTH INTEGER
可為空值
 訊息容許的長度上限。 這是在 CRTDTAQ 指令上以 MAXLEN 關鍵字指定的值。

包含 DDM 資料佇列的空值。
順序 順序 VARCHAR (5)
可為空值
 可從佇列中移除訊息的順序。
FIFO
先進先出
循序
循序
LIFO
後進先出

包含 DDM 資料佇列的空值。
金鑰長度 金鑰長度 INTEGER
可為空值
 索引資料佇列的訊息參照索引長度 (以位元組為單位)。 值為 1 到 256。

如果這不是索引佇列或 DDM 資料佇列，則包含空值。
INCLUDE_SENDER_ID SENDER_ID VARCHAR (3)
可為空值
 指出是否建立佇列以將傳送端 ID 併入已傳送的訊息。
否
將資料傳送至資料佇列時，不包括傳送端 ID。
是
將資料傳送至資料佇列時包括傳送端 ID。

包含 DDM 資料佇列的空值。
現行訊息 CUR_MSGS INTEGER
可為空值
 目前在資料佇列上的訊息數目。

包含 DDM 資料佇列的空值。
MAXIMUM_MESSAGES MAX_MSGS INTEGER
可為空值
 適合資料佇列的訊息數目上限。

包含 DDM 資料佇列的空值。
SPECIFIED_MAXIMUM_MESSAGES SPEC_MAX INTEGER
可為空值
 在 CRTDTAQ 指令的 SIZE 關鍵字上設定的訊息數上限。 可包含下列特殊值:
-1
已對資料佇列大小指定 *MAX16MB 。
-2
已針對資料佇列大小指定 *MAX2GB 。

包含 DDM 資料佇列的空值。
INITIAL_MESSAGE_ALLOCATION INIT_ALOC INTEGER
可為空值
 在建立資料佇列或自動收回資料佇列時，將適合配置給資料佇列之儲存體的訊息數。

包含 DDM 資料佇列的空值。
CURRENT_MESSAGE_ALLOCATION CUR_ALOC INTEGER
可為空值
 在資料佇列延伸之前，將放入資料佇列中的項目數。 當佇列延伸時，會配置額外的儲存體給佇列。 資料佇列可以延伸，直到達到容許的項目數上限值為止。

包含 DDM 資料佇列的空值。
FORCE FORCE VARCHAR (3)
可為空值
 傳送或接收登錄時，是否將資料佇列強制至輔助儲存體。
否
在傳送或接收登錄之後，不會強制資料佇列至輔助儲存體。
是
在傳送或接收登錄之後，資料佇列會強制至輔助儲存體。

包含 DDM 資料佇列的空值。
自動收回 收回 VARCHAR (3)
可為空值
 當佇列是空的時，資料佇列是否已收回配置給佇列的儲存體數量。
否
未收回儲存體。
是
當佇列是空的時，會收回儲存體。 配置的儲存體數量將設為起始項目數。

包含 DDM 資料佇列的空值。
LAST_RECLAIM_TIMESTAMP RECLAIM_TS TIMESTAM
可為空值
 完成前次自動收回的日期和時間。

包含 DDM 資料佇列的空值，或當標準資料佇列未發生收回時。
ENFORCE_DATA_QUEUE_LOCKS DTAQ_LOCKS VARCHAR (3)
可為空值
 識別 IBM®提供的資料佇列作業是否將對資料佇列施行鎖定。 無法在「建立資料佇列 (CRTDTAQ)」CL 指令上指定此屬性。 建立資料佇列時，預設值是忽略鎖定。 可以使用「配置物件 (ALCOBJ) CL 指令」來鎖定資料佇列。 當施行鎖定時，由於所有資料佇列作業所執行的額外鎖定，效能可能會降低。
否
IBM提供的資料佇列作業會忽略資料佇列上的鎖定。
是
資料佇列上的鎖定由 IBM提供的資料佇列作業強制執行。

包含 DDM 資料佇列的空值。
文字說明 TEXT VARCHAR (50)
可為空值
 資料佇列的文字說明。

如果沒有文字說明，則包含空值。
REMOTE_DATA_QUEUE_LIBRARY RMT_DTAQL VARCHAR (10)
可為空值
 目標系統上遠端資料佇列的檔案庫名稱。 這是在 CRTDTAQ 指令的 RMTDTAQ 參數上指定的資料佇列名稱。 可包含下列特殊值:
*CURLIB
將使用現行檔案庫來尋找資料佇列。
*LIBL
將使用檔案庫清單來尋找資料佇列。

包含標準資料佇列的空值。
REMOTE_DATA_QUEUE RMT_DTAQ VARCHAR (10)
可為空值
 目標系統上遠端資料佇列的名稱。 這是在 CRTDTAQ 指令的 RMTDTAQ 參數上指定的資料佇列名稱。

包含標準資料佇列的空值。
遠端位置 遠端 LOC VARCHAR (8)
可為空值
 與此物件搭配使用的遠端位置名稱。 這是在 CRTDTAQ 指令的 RMTLOCNAME 參數上指定的名稱。 可包含下列特殊值:
*RDB
使用關聯式資料庫登錄名稱欄位中從關聯式資料庫登錄傳回的遠端位置資訊來決定遠端系統。

包含標準資料佇列的空值。
RELATIONAL_DATABASE_NAME RDBNAME VARCHAR (18)
可為空值
 識別目標系統或目標 ASP 群組的關聯式資料庫登錄名稱。 這是在 CRTDTAQ 指令的 RDB 參數上指定的名稱。

包含非 RDB 類型 DDM 資料佇列之標準資料佇列或資料佇列的空值。
應用程式 _ 裝置說明 APPC_DEVD VARCHAR (10)
可為空值
 與此 DDM 資料佇列一起使用之來源系統上 APPC 裝置說明的名稱。 這是在 CRTDTAQ 指令的 DEV 參數上指定的名稱。 可包含下列特殊值:
*LOC
會採用與遠端位置相關的裝置。

包含標準資料佇列及 RDB 類型 DDM 資料佇列的空值。
位置位置 LOCAL_LOC VARCHAR (8)
可為空值
 本端位置的名稱。 這是在 CRTDTAQ 指令的 LCLLOCNAME 參數上指定的名稱。 可包含下列特殊值:
*LOC
會採用與遠端位置相關的裝置。
*NETATR
使用指定在系統網路屬性中的LCLLOCNAME值。

包含標準資料佇列及 RDB 類型 DDM 資料佇列的空值。
模式 模式 VARCHAR (8)
可為空值
 與遠端位置名稱一起使用以與目標系統通訊的模式名稱。 這是在 CRTDTAQ 指令的 MODE 參數上指定的名稱。 可包含下列特殊值:
*NETATR
使用系統網路屬性中指定的模式名稱。

包含標準資料佇列及 RDB 類型 DDM 資料佇列的空值。
REMOTE_NETWORK_ID REMOTE_NET VARCHAR (8)
可為空值
 遠端位置用來與目標系統通訊的遠端網路 ID。 這是在 CRTDTAQ 指令的 RMTNETID 參數上指定的名稱。 可包含下列特殊值:
*LOC
使用與遠端位置相關的遠端網路ID。
*NETATR
使用系統網路屬性中指定的遠端網路 ID 值。
*NONE
未使用任何遠端網路ID。

包含標準資料佇列及 RDB 類型 DDM 資料佇列的空值。

範例

在 TESTLIB 中尋找目前在資料佇列 DQ1 中的訊息數。
SELECT CURRENT_MESSAGES FROM QSYS2.DATA_QUEUE_INFO 
   WHERE DATA_QUEUE_LIBRARY = 'TESTLIB' AND DATA_QUEUE_NAME = 'DQ1';