佇列狀態屬性
佇列和存取佇列之控點的狀態屬性。
每一個屬性都有一個簡要說明,來說明該屬性顯示的資訊。本表亦列出 DISPLAY QSTATUS 指令的對等 MQSC 參數。如需 MQSC 指令的相關資訊,請參閱 IBM® MQ 線上產品說明文件中的 Script (MQSC) 指令。
| 屬性 | 意義 | MQSC 參數 |
|---|---|---|
| 佇列名稱 | 佇列的名稱。 | |
| 現行佇列深度 | 目前在佇列上的訊息數。 | CURDEPTH |
| 開啟輸入計數 | 這是目前連接至佇列以從佇列取得訊息的應用程式數。 | IPPROCS |
| 開啟輸出計數 | 這是目前連接至佇列以將訊息放到佇列中的應用程式數。 | OPPROCS |
| 未確定的訊息 | 這指出該佇列是否有擱置任何未確定的變更(放置和取得)。如果有未確定的變更處於擱置中,此值為數字,對應於擱置中未確定的訊息數(1、2、3、4、5 等)。如果沒有未確定的變更處於擱置中,此值為否。 針對 z/OS® 共用佇列,此值只適用於產生回覆的佇列管理程式。此值並不適用於佇列共用群組中的所有佇列管理程式。 |
UNCOM |
| 媒體回復日誌範圍名稱 | 佇列要執行媒體回復所需的最舊日誌範圍的名稱。 | MEDIALOG |
| 監視佇列 | 佇列的媒體回復所需要的日誌範圍或異動日誌接收端。在使用循環式記載的佇列管理程式上,此屬性不包含值。此屬性僅適用於 UNIX、Linux 及 Windows。 | MONQ |
| 佇列時間 | 訊息放置到佇列上與遭到破壞性讀取兩者之間的間隔(微秒)。最大可顯示值為 999 999
999;如果間隔超過此值,畫面上會顯示 999 999 999。此間隔是測量從訊息放置在佇列上之後,到它被應用程式破壞性擷取為止的時間,並且包含下列時間:
如果 z/OS 佇列的處置方式為共用,則所顯示的值僅適用於在此佇列管理程式上收集的測量。 |
QTIME |
| 最舊訊息經歷時間 | 佇列上的最舊訊息的經歷時間,以秒為單位。 | MSGAGE |
| 最後放置日期 | 自啟動佇列管理程式之後將最後訊息放置到佇列上的日期。若沒有可用的放置日期(可能是因為自啟動佇列管理程式之後沒有訊息放置到佇列上),則此值會顯示為空白。 如果 z/OS 佇列的處置方式為共用,則所顯示的值僅適用於在此佇列管理程式上收集的測量。 |
LPUTDATE |
| 最後放置時間 | 自啟動佇列管理程式之後將最後訊息放置到佇列上的時間。若沒有可用的放置時間,可能是因為自啟動佇列管理程式之後沒有訊息放置到佇列上,則此值會顯示為空白。 如果 z/OS 佇列的處置方式為共用,則所顯示的值僅適用於在此佇列管理程式上收集的測量。 |
LPUTTIME |
| 最後取得日期 | 自啟動佇列管理程式之後從佇列中擷取最後訊息的日期。正在瀏覽的訊息不算擷取的訊息。若沒有可用的取得日期,可能是因為自啟動佇列管理程式之後沒有從佇列中擷取任何訊息,則此值會顯示為空白。 如果 z/OS 佇列的處置方式為共用,則所顯示的值僅適用於在此佇列管理程式上收集的測量。 |
LGETDATE |
| 最後取得時間 | 自啟動佇列管理程式之後從佇列中擷取最後訊息的時間。正在瀏覽的訊息不算擷取的訊息。若沒有可用的取得時間,可能是因為自啟動佇列管理程式之後沒有從佇列中擷取任何訊息,則此值會顯示為空白。 如果 z/OS 佇列的處置方式為共用,則所顯示的值僅適用於在此佇列管理程式上收集的測量。 |
LGETTIME |
佇列控點狀態物件
下表列出佇列控點狀態屬性,這些屬性顯示在「佇列狀態」對話框的第二個表格中。
| 屬性 | 意義 | MQSC 參數 |
|---|---|---|
| 佇列名稱 | 佇列的名稱。 | |
| 應用程式名稱 | 包含連線至佇列管理程式的應用程式標籤的字串。它是下列其中一項:
|
APPLTAG |
| 程序 ID | 開啟佇列的處理程序的 ID。此屬性不適用於 HP Integrity NonStop Server 及 z/OS。 |
PID |
| 執行緒 ID | 已開啟佇列之應用程式程序內的執行緒 ID。星號表示這個佇列已經利用共用連線來開啟。此屬性不適用於 HP Integrity NonStop Server 及 z/OS。 |
TID |
| 應用程式類型 | 指出連線到佇列管理程式的應用程式類型的字串。批次表示使用批次連線的應用程式;RRSBATCH 表示使用批次連線的 RRS 協調型應用程式;CICS 表示 CICS 交易;IMS 表示 IMS 交易;CHINIT 表示通道起始程式;系統表示佇列管理程式;使用者表示使用者應用程式。 | APPLTYPE |
| 應用程式說明 | 包含應用程式(已知連接至佇列管理程式)說明的字串。如果佇列管理程式無法辨識該應用程式,則所傳回的說明為空白。應用程式說明可過濾(例如,利用 WHERE 子句),以允許管理者只顯示某些連線。 | APPLDESC |
| 瀏覽存取權 | 這指出控點是否提供對佇列的瀏覽存取權。如果控點有提供瀏覽存取權,此值為是;如果控點沒有提供瀏覽存取權,此值為否。 | BROWSE |
| 查詢存取權 | 這指出控點是否提供對佇列的查詢存取權。如果控點有提供查詢存取權,此值為是;如果控點沒有提供查詢存取權,此值為否。 | INQUIRE |
| 輸入存取權 | 這指出控點是否提供對佇列的輸入存取權。否表示佇列未開啟供輸入;共用表示佇列已開啟供共用輸入;專用表示佇列已開啟供專用輸入。 | INPUT |
| 輸出存取權 | 這指出控點是否提供對佇列的輸出存取權。如果控點有提供輸出存取權,此值為是;如果控點沒有提供輸出存取權,此值為否。 | OUTPUT |
| 設定存取權 | 這指出控點是否提供對佇列的集合存取權。如果控點有提供設定存取權,此值為是;如果控點沒有提供設定存取權,此值為否。 | SET |
| 使用者 ID | 與控點相關聯的使用者 ID。 | USERID |
| 通道名稱 | 擁有控點之通道名稱。如果沒有與控點相關聯的通道,則此值為空白。只有當控點屬於通道起始程式時,才會顯示這個值。 | CHANNEL |
| 連線名稱 | 與擁有控點之通道相關聯的連線名稱。如果沒有與控點相關聯的通道,則此值為空白。只有當控點屬於通道起始程式時,才會顯示這個值。 | CONNAME |
| 工作單元類型 | 佇列管理程式所看見的回復單元類型。它是下列其中一項: CICS(僅限 z/OS)、 XA、 RRS(僅限 z/OS)、 IMS(僅限 z/OS)、 佇列管理程式。 |
URTYPE |
| 佇列管理程式工作單元 ID | 佇列管理程式所指派的回復單元。這是 8 個位元組的交易 ID,其會顯示為 16 個十六進位字元。 在 z/OS 上,這是 8 個位元組的日誌 RBA,其會顯示為 16 個十六進位字元。 |
QMURID |
| 非同步狀態 | 這個物件控點上非同步消費端的狀態。有五個可能的值: 作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,且連線控點已啟動,因此能夠繼續使用非同步訊息。 非作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,但是連線控點尚未啟動、已停止或是已暫停,因此目前無法繼續使用非同步訊息。已暫停:非同步使用回呼已暫停,因此目前無法對這個物件控點繼續使用非同步訊息。這可能是因為應用程式已對這個物件控點發出具有 Operation MQOP_SUSPEND 的 MQCB 呼叫,或是因為系統已將它暫停。如果在暫停使用非同步訊息的過程中,系統已將它暫停,則會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。這會在傳給回呼函數的 MQCBC 結構原因欄位中報告。為了能繼續使用非同步訊息,應用程式必須發出 MQCB 呼叫,並將 Operation 參數設為 MQOP_RESUME。 暫時暫停:系統已暫時暫停非同步使用回呼,因此目前無法對這個物件控點繼續使用非同步訊息。在暫停使用非同步訊息的過程中,系統會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。這會在傳給回呼函數的 MQCBC 結構原因欄位中報告。當暫時狀況已解決,系統回復使用非同步訊息時,會再度呼叫回呼函數。無:尚未對這個控點發出 MQCB 呼叫,因此未對這個控點配置使用非同步訊息。這是預設值。 |
ASTATE |
| 外部工作單元 ID | 與連線相關聯的外部回復單元 ID。它是外部同步點協調程式已知的回復 ID。其格式由工作單位類型屬性的值決定。 | URID |
位址空間 ID |
由應用程式名稱屬性所識別之應用程式的 4 字元位址空間 ID。它會區分應用程式名稱的重複值。只有當擁有佇列的佇列管理程式在 z/OS 上執行,且應用程式類型屬性的值不是系統時,才會顯示此值。 |
ASID |
指定程式區塊名稱 |
與執行中 IMS 交易相關聯的指定程式區塊 (PSB) 的 8 字元名稱(僅限 z/OS)。您可以使用指定程式區塊名稱和指定程式表格 ID 屬性,來清除使用 IMS 指令的交易。只有當應用程式類型屬性具有 IMS 值時,才會顯示值。 |
PSBNAME |
指定程式表格 ID |
已連線的 IMS 區域的 4 字元 IMS 指定程式表格 (PST) 區域 ID(僅限 z/OS)。只有當應用程式類型屬性具有 IMS 值時,才會顯示值。 |
PSTID |
CICS 交易 ID |
4 字元 CICS 交易 ID(僅限 z/OS)。只有當應用程式類型屬性具有 CICS 值時,才會顯示值。 |
TRANSID |
針對 ![[IBM i]](./ngibmi.gif)
參考