應用程式連線內容
應用程式連線內容顯示在「應用程式連線內容」對話框中。 您不能編輯任何這些內容的值。
下列表格列出應用程式連線的所有內容:
每一個內容都有其意義的簡要說明。 這些表格也提供了 DISPLAY CONN 指令同等的 MQSC 參數。 如需 MQSC 指令的相關資訊,請參閱 IBM Documentation中的 使用 MQSC 指令管理 IBM® MQ 。
「一般」頁面
下表列出「應用程式連線內容」對話框之一般頁面上的內容。
內容 | 意義 | MQSC 參數 |
---|---|---|
應用程式名稱 | 包含連線至佇列管理程式的應用程式標籤的字串。 它是下列其中一項:z/OS® 批次工作名稱、TSO USERID、CICS® APPLID、IMS 區域名稱、通道起始程式工作名稱、OS/400® 工作名稱、Linux® 或 AIX® 處理程序(Windows 處理程序)。 應用程式名稱代表已連線至佇列管理程式的處理程序或工作的名稱。 如果這個程序或工作是透過通道來連接,則應用程式名稱代表遠端程序或工作,而非本端通道程序或工作名稱。 | APPLTAG |
應用程式類型 | 指出連線到佇列管理程式的應用程式類型的字串。 Batch 表示使用批次連線的應用程式;RRSBATCH 表示使用批次連線的 RRS 協調應用程式;CICS 表示 CICS 交易;IMS 表示 IMS 交易;CHINIT 表示通道起始程式;System 表示佇列管理程式;User 表示使用者應用程式。 |
APPLTYPE |
處理程序 ID | 開啟佇列的處理程序的 ID。 此內容在 z/OS上無效。 | PID |
執行緒 ID | 已開啟佇列之應用程式程序內的執行緒 ID。 星號表示這個佇列已經利用共用連線來開啟。 此內容在 z/OS上無效。 | TID |
使用者 ID | 與控點相關聯的使用者 ID。 | USERID |
選項 | 這些是目前由這個應用程式連線使用的連線選項。 | CONNOPTS |
通道名稱 | 擁有控點之通道名稱。 如果沒有與控點相關聯的通道,則此值為空白。 只有當控點屬於通道起始程式時,才會顯示這個值。 | CHANNEL |
連線名稱 | 與擁有控點之通道相關聯的連線名稱。 如果沒有與控點相關聯的通道,則此值為空白。 只有當控點屬於通道起始程式時,才會顯示這個值。 | CONNAME |
PSB 名稱 | 這是與執行中的 IMS 交易關聯的程式規格區塊 (PSB) 的名稱(8 個字元)。 | PSBNAME |
連線 ID | 這是 24 位元組唯一連線 ID,可讓 IBM MQ 可靠地識別應用程式。 當應用程式第一次連接佇列管理程式時,佇列管理程式就會設定連線 ID。 | CONN 和 EXTCONN |
「工作單元」頁面
下表列出「應用程式連線內容」對話框之工作單元 頁面上的內容。 工作單元頁面會顯示與選定連線關聯之工作單元可用的資訊。
內容 | 意義 | MQSC 參數 |
---|---|---|
工作單元類型 | 佇列管理程式所看見的回復單元類型。 它是下列其中一項:CICS (僅限 z/OS);XA ;RRS (僅限 z/OS);IMS (僅限 z/OS);Queue manager 。 |
URTYPE |
工作單元啟動日期 | 這是與連線關聯的交易啟動的日期。 | UOWSTDA |
工作單元啟動時間 | 這是與連線關聯的交易啟動的時間。 | UOWSTTI |
原始工作單元 ID | 回復單元 ID,由起始端指派。 這是個 8 個位元組的值。 | NID |
原始名稱 | 這識別執行緒的起始端,但是當應用程式類型內容設為 RRSBATCH 除外,在這個情況下,這個值會被省略。 | NID |
日誌範圍名稱 | 這是與這個連線關聯之交易第一次寫入的日誌範圍檔案名稱。 | UOWLOG |
第一次日誌存取日期 | 這是與連線關聯的交易第一次寫入日誌的日期。 | UOWLOGDA |
第一次日誌存取時間 | 這是與連線關聯的交易第一次寫入日誌的時間。 | UOWLOGTI |
工作單元狀態 | 工作單元的狀態。 None 表示沒有工作單元;Active 表示工作單元處於作用中;Prepared 表示工作單元正在進行確定;Unresolved 表示工作單元處於兩階段確定作業的第二階段,IBM MQ 代表其保留資源,需要外部介入來解決它。 這可能只是啟動回復協調程式(如:CICS、IMS 或 RRS),也可能需要較複雜的作業,如:使用 RESOLVE INDOUBT 指令。 Unresolved 值只能在 z/OS 上出現。 |
UOWSTATE |
佇列管理程式工作單元 ID | 佇列管理程式所指派的回復單元。 在 z/OS 上,這是 8 個位元組的日誌 RBA,而在其他平台上,這是 8 個位元組的交易 ID,其會顯示為 16 個十六進位字元。 | QMURID |
外部工作單元 ID | 與連線相關聯的外部回復單元 ID。 它是外部同步點協調程式已知的回復 ID。 其格式由 UOW
type 內容的值決定。 |
EXTURID |
非同步狀態 | 這個物件控點上非同步消費端的狀態。 有五個可能的值: 作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,且連線控點已啟動,因此能夠繼續使用非同步訊息。 非作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,但是連線控點尚未啟動、已停止或是已暫停,因此目前無法繼續使用非同步訊息。已暫停:非同步使用回呼已暫停,因此目前無法對這個物件控點繼續使用非同步訊息。 這可能是因為應用程式已對這個物件控點發出具有 Operation MQOP_SUSPEND 的 MQCB 呼叫,或是因為系統已將它暫停。 如果在暫停使用非同步訊息的過程中,系統已將它暫停,則會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。 這會報告在傳給回呼函數之 MQCBC 結構的原因欄位中。 為了能繼續使用非同步訊息,應用程式必須發出 MQCB 呼叫,並將 Operation 參數設為 MQOP_RESUME。 |
ASTATE |
暫時暫停:系統已暫停非同步使用回呼,因此目前無法對這個物件控點繼續使用非同步訊息。 在暫停使用非同步訊息的過程中,系統會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。 這會報告在傳給回呼函數之 MQCBC 結構的原因欄位中。 當暫時狀況已解決,系統回復使用非同步訊息時,會再度呼叫回呼函數。 無:尚未對這個控點發出 MQCB 呼叫,因此未對這個控點配置使用非同步訊息。 這是預設值。 |
||
回復單元處置方式 | (只適用於 z/OS)這個參數會用來過濾傳回的連線清單。 有三個選項可供選擇:
|
URDISP |
「控點」頁面
下表列出「應用程式連線內容」對話框之控點頁面上的內容。 控點頁面會顯示已開啟選定應用程式之物件的相關資訊。
內容 | 意義 | MQSC 參數 |
---|---|---|
連線 ID | 這是 24 位元組唯一連線 ID,可讓 IBM MQ 可靠地識別應用程式。 當應用程式第一次連接佇列管理程式時,佇列管理程式就會設定連線 ID。 | CONN 和 EXTCONN |
物件名稱 | 這是已開啟連線的物件名稱。 | OBJNAME |
物件類型 | 這是連線已開啟的物件類型;例如 Queue 、Channel 、Storage
Class 。 |
OBJTYPE |
開啟選項 | 這些是連線用來開啟物件的選項。
|
OPENOPTS |
|
||
QSG 性質 | 唯讀。 物件的佇列共用群組處置方式。 Queue
manager 表示物件定義只適用於管理它的佇列管理程式;Group 表示物件定義儲存在共用儲存庫中,且佇列共用群組中的每一個佇列管理程式都有定義副本;Copy 表示物件定義是佇列管理程式在共用儲存庫中的定義副本;Shared 表示物件定義儲存在佇列共用群組的連結機能中,且可供佇列共用群組中的所有佇列管理程式使用。 |
QSGDISP |
控點狀態 | 控點的現行狀態。 作用中表示來自這個連線的 API 呼叫目前正對這個物件進行中。 如果物件是個佇列,當 MQGET WAIT 呼叫進行時,就會產生這個狀況。 如果有未完成的 MQGET 信號,這本身並不表示控點在作用中。 非作用中表示沒有來自這個連線的 API 呼叫目前針對這個物件進行中。 如果物件是個佇列,當沒有 MQGET WAIT 呼叫進行時,就會產生這個狀況。 | HSTATE |
主題字串 | 已解析的主題字串。 這個參數與具有 OBJTYPE(TOPIC) 的控點相關。 如果是任何其他物件類型,這個參數會是空白。 | TOPICSTR |
訂閱名稱 | 應用程式與控點關聯的唯一訂閱名稱。 這個參數只與主題的訂閱控點相關。 並非所有訂閱都有訂閱名稱。 | SUBNAME |
訂閱 ID | 訂閱的內部長期唯一 ID。 這個參數只與主題的訂閱控點相關。 並非所有訂閱都會顯示在 DISPLAY CONN 中;其只會顯示已開啟現行控點的訂閱。 您可以使用 DISPLAY SUB 指令來查看所有訂閱。 | SUBID |
目的地佇列管理程式 | 發佈給這個訂閱的訊息目的地佇列管理程式。 這個參數只與主題的訂閱控點相關。 如果 DEST 是在本端佇列管理程式上管理的佇列,則這個參數會包含本端佇列管理程式名稱。 如果 DEST 是在遠端佇列管理程式上管理的佇列,則這個參數會包含遠端佇列管理程式的名稱。 | DESTQMGR |
目的地名稱 | 發佈給這個訂閱之訊息的目的地佇列。 這個參數只與主題的訂閱控點相關。 | DEST |
非同步狀態 | 這個物件控點上非同步消費端的狀態。 有五個可能的值: 作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,且連線控點已啟動,因此能夠繼續使用非同步訊息。 非作用中:MQCB 呼叫已設定一個回呼的函數來非同步處理訊息,但是連線控點尚未啟動、已停止或是已暫停,因此目前無法繼續使用非同步訊息。已暫停:非同步使用回呼已暫停,因此目前無法對這個物件控點繼續使用非同步訊息。 這可能是因為應用程式已對這個物件控點發出具有 Operation MQOP_SUSPEND 的 MQCB 呼叫,或是因為系統已將它暫停。 如果在暫停使用非同步訊息的過程中,系統已將它暫停,則會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。 這會報告在傳給回呼函數之 MQCBC 結構的原因欄位中。 為了能繼續使用非同步訊息,應用程式必須發出 MQCB 呼叫,並將 Operation 參數設為 MQOP_RESUME。 |
ASTATE |
暫時暫停:系統已暫時暫停非同步使用回呼,因此目前無法對這個物件控點繼續使用非同步訊息。 在暫停使用非同步訊息的過程中,系統會呼叫回呼函數,並提供原因碼來說明導致暫停的問題。 這會報告在傳給回呼函數之 MQCBC 結構的原因欄位中。 當暫時狀況已解決,系統回復使用非同步訊息時,會再度呼叫回呼函數。 無:尚未對這個控點發出 MQCB 呼叫,因此未對這個控點配置使用非同步訊息。 這是預設值。 |
||
先讀 | 先讀連線狀態。 有四個可能的值: 否:這個物件未啟用先讀非持續訊息。 這是預設值。 是:這個物件已啟用先讀非持續訊息,且正在有效地使用。待辦事項:這個物件已啟用先讀非持續訊息。 先讀未有效地使用,因為用戶端傳送了大量訊息,但並未使用它們。 禁止:應用程式已要求先讀,但因第一個 MQGET 呼叫中指定了不相容的選項而被禁止。 |
READA |