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