應用程式連線內容

應用程式連線內容顯示在「應用程式連線內容」對話框中。 您不能編輯任何這些內容的值。

下列表格列出應用程式連線的所有內容:

每一個內容都有其意義的簡要說明。 這些表格也提供了 DISPLAY CONN 指令同等的 MQSC 參數。 如需 MQSC 指令的相關資訊,請參閱 IBM® 文件中的 使用 MQSC 指令管理

「一般」頁面

下表列出「應用程式連線內容」對話框之一般頁面上的內容。

內容 意義 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 代表它保留資源,需要外部介入才能解決它。 這可能只是啟動回復協調程式(如:CICSIMS 或 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
物件類型 這是連線已開啟的物件類型;例如 QueueChannelStorage Class OBJTYPE
開啟選項

這些是連線用來開啟物件的選項。

Bind as queue definition 表示應用程式開啟佇列以取得使用佇列定義的預設值的訊息;Input shared 表示應用程式開啟佇列以取得共用存取權的訊息;Input exclusive 表示應用程式開啟佇列以取得專用存取權的訊息;Browse 表示應用程式開啟佇列以瀏覽佇列上的訊息; Output 表示應用程式開啟佇列以將訊息放置在佇列上;Inquire 表示應用程式開啟物件以取得物件內容清單;Set 表示應用程式開啟佇列來設定佇列的內容。

Bind on open 表示應用程式本端佇列管理程式會在開啟佇列時將佇列控點連結至目的地佇列的特定實例,以便使用此控點放置的所有訊息都會透過相同的路徑傳送至目的地佇列的相同實例;Bind not fixed 表示本端佇列管理程式不會將佇列控點連結至目的地佇列的特定實例,因此使用此控點的連續 MQPUT 呼叫可能會導致將訊息傳送至目的地佇列的不同實例,或將訊息傳送至相同實例,但透過不同的不同路徑傳送。Bind as queue default 表示本端佇列管理程式以佇列的預設連結類型內容所定義的方式來連結佇列控點。

OPENOPTS
 

Save all context 表示使用此控點擷取的任何訊息中的環境定義資訊都與此控點相關聯;Pass identity context 表示將訊息放入佇列時,可以將訊息中的身分環境定義資訊傳遞至已處理的訊息;Pass all context 表示將訊息放入佇列時,可以將訊息中的身分及原始環境定義資訊傳遞至已處理的訊息;Set identity context 表示應用程式可以設定將訊息放入佇列時與訊息相關聯的身分環境定義資訊;Set all context 表示應用程式可以設定將訊息放入佇列時與訊息相關聯的身分與原始環境定義資訊。 如需訊息環境定義的相關資訊,請參閱 IBM 說明文件中的 訊息環境定義

Alternate user authority 表示已針對呼叫中指定的使用者 ID 驗證 MQOPEN 呼叫;Fail if quiescing 表示如果佇列管理程式處於靜止狀態,則 MQOPEN 呼叫會失敗。

 
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