目的地內容

您可以在「目的地內容」對話框中檢視和設定目的地的內容。 對話框中可用的內容視目的地類型而定。

下表列出您可以為目的地設定的所有內容:

每一項內容都有一個簡要說明,來說明您何時需要配置該內容。 表格中還提供了在「JMS 管理」指令行工具中使用的同等完整名稱及簡稱。 「內容」對話框中可用的內容視目的地類型而定;佇列目的地與主題目的地之間有些內容不同。 如需相關資訊,請參閱 使用管理工具來配置 JMS 物件

「一般」頁面

下表列出您可以在「目的地內容」對話框的一般頁面上設定的內容。

表 1. 一般頁面內容
內容 意義 詳細名稱 簡短名稱
名稱 顯示物件的名稱。 名稱  
說明 鍵入物件的說明。 說明 DESC
類別名稱 顯示目的地實作的類別名稱。    
傳訊提供者 這會顯示目的地物件所支援的傳輸,且可以是 IBM® MQ 或「即時」傳輸。 無法在 IBM MQ 8.0 中使用即時傳輸。 如果您使用 IBM MQ 8.0,可以定義「即時」傳輸,但當嘗試建立連線時,它會失敗。    
佇列管理程式 選取或輸入管理目的地佇列的佇列管理程式的名稱。 QMANAGER QMGR
佇列 選取由目的地代表的佇列名稱。 佇列 QU
主題 輸入此目的地代表的主題名稱。 TOPIC TOP

「訊息處理」頁面

下表列出您可以在「目的地內容」對話框的訊息處理頁面上設定的內容。 編輯訊息處理頁面上的內容,可配置傳送給目的地的訊息會發生的情況。

表 2. 訊息處理頁面內容
內容 意義 詳細名稱 簡短名稱
期限 指定目的地的訊息的期限。 若要指定期限可以由 JMS 用戶端應用程式定義,請按一下應用程式。 若要指定無期限,請按一下無限制。 否則,請輸入訊息到期之前的毫秒數。 EXPIRY EXP
持續性 指定傳送至目的地之訊息的持續性。 若要指定持續性由 JMS 應用程式定義,請按一下應用程式。 若要指定持續性取用佇列的預設值,請按一下 佇列預設值。 若要指定訊息為持續性,請按一下 持續性。 若要指定訊息為非持續性,請按一下非持續性。 若要指定當佇列管理程式在靜止或立即關閉之後重新啟動時不會捨棄佇列上的非持續性訊息,請按一下(不過,在強制關機或故障之後可能會捨棄非持續性訊息)。 PERSISTENCE PER
優先順序 指定傳送至目的地之訊息的優先順序。 若要指定優先順序由 JMS 用戶端應用程式定義,請按一下應用程式。 若要指定優先順序取用佇列的預設值,請按一下佇列預設值。 否則,請鍵入 0 到 9 的優先順序。 PRIORITY PRI
MQMD 訊息環境定義 指定傳送訊息至目的地時的環境定義。 有三個選項可供選擇:

預設值:MQOPEN API 呼叫及 MQPMO 結構不會指定明確訊息環境定義選項。 這是預設值。

設定所有環境定義:MQOPEN API 呼叫指定訊息環境定義選項 MQOO_SET_ALL_CONTEXT,MQPMO 結構指定 MQPMO_SET_ALL_CONTEXT。

設定身分環境定義:MQOPEN API 呼叫指定訊息環境定義選項 MQOO_SET_IDENTITY_CONTEXT,MQPMO 結構指定 MQPMO_SET_IDENTITY_CONTEXT。

MDMSGCTX MDCTX
啟用 MQMD 寫入 指定 JMS 應用程式是否可以設定 MQMD 欄位的值。 有兩個選項可供選擇:

:所有 JMS_IBM_MQMD* 內容會被忽略,且其值不會複製至基礎 MQMD 結構。 這是預設值。

:會處理所有 JMS_IBM_MQMD* 內容。 其值會複製到基礎 MQMD 結構。
MDWRITE MDW
啟用 MQMD 讀取 指定 JMS 應用程式是否可以擷取 MQMD 欄位的值。 有兩個選項可供選擇:

:傳送訊息時,已傳送訊息上的 JMS_IBM_MQMD* 內容不會更新來反映 MQMD 中已更新的欄位值。 接收訊息時,在接收的訊息中無法使用任何 JMS_IBM_MQMD* 內容,即使傳送端已設定部分或全部內容亦如此。 這是預設值。

:傳送訊息時,將會更新已傳送訊息中的所有 JMS_IBM_MQMD* 內容(包括寄件者未明確設定的內容),來反映 MQMD 中已更新的欄位值。 接收訊息時,在接收的訊息中可以使用所有 JMS_IBM_MQMD* 內容(包括使寄件者未明確設定的內容)。
MDREAD MDR
訊息內文 指定 JMS 應用程式是否將 IBM MQ 訊息的 MQRFH2 處理成 JMS 訊息內文的一部分。 有三個選項可供選擇:

未指定:傳送訊息時,JMS 的 IBM MQ 類別不產生,也不會產生 MQRFH2 標頭,視 WMQ_TARGET_CLIENT 的值而定。 接收訊息時,其行為如同是將此值設定為 JMS。 這是預設值。

JMS:傳送訊息時,JMS 的 IBM MQ 類別會自動產生 MQRFH2 標頭,並將它包括在 IBM MQ 訊息中。 在接收訊息時,JMS 的 IBM MQ 類別會根據 MQRFH2 中的值來設定 JMS 訊息內容(如果存在的話);它不會將 MQRFH2 呈現為 JMS 訊息內文的一部分。

MQ:傳送訊息時,JMS 的 IBM MQ 類別不會產生 MQRFH2。 接收訊息時,JMS 的 IBM MQ 類別會將 MQRFH2 顯示為 JMS 訊息內文的一部分。

MSGBODY MBODY
接收轉換 配置使用 MQGMO_CONVERT 選項。 在要求訊息時,在 MQGET 或用戶端應用程式中指定 MQGMO_CONVERT,來選取是否要在佇列管理程式中執行轉換。 RECEIVECONVERSION RCNV
接收 CCSID 要求用以轉換訊息的目標 CCSID。 當 JMS 的 IBM MQ 類別要求佇列管理程式執行轉換時使用(例如,透過指定 WMQ_RECEIVE_CONVERSION_QMGR 作為 setReceiveConversion 的引數)。 這個內容的值是 CCSID,也就是要求佇列管理程式將訊息轉換成的目標。 預設值是 CCSID 1208。 RECEIVECCSID RCCS

「分配管理系統」頁面

下表列出您可以在「目的地內容」對話框的分配管理系統頁面上設定的內容。 編輯分配管理系統頁面上的內容,可提供發佈/訂閱分配管理系統的詳細資料。

表 3. 分配管理系統頁面內容
內容 意義 詳細名稱 簡短名稱
分配管理系統可延續訂閱佇列 這個內容可以用於 IBM WebSphere® MQ 7.0 或更新版本的 JMS 用戶端,但對 IBM WebSphere MQ 7.0 或更新版本的佇列管理程式沒有作用。

如果 JMS 用戶端連接的佇列管理程式與發佈訂閱分配管理系統使用的佇列管理程式相同,您就可以從分配管理系統佇列管理程式中選取一個佇列。 選取的佇列管理程式必須在執行中。

如果不是這樣,您就必須輸入要從中擷取可延續訂閱訊息的佇列名稱。 預設佇列為 SYSTEM.JMS.D.SUBSCRIBER.QUEUE。
BROKERDURSUBQ BDSUB
分配管理系統 CC 可延續訂閱訊息佇列 此內容可以用於 IBM WebSphere MQ 7.0 或更新版本的 JMS 用戶端,但對 IBM WebSphere MQ 7.0 或更新版本的佇列管理程式沒有作用

如果 JMS 用戶端連接的佇列管理程式與發佈訂閱分配管理系統使用的佇列管理程式相同,您就可以從分配管理系統佇列管理程式中選取一個佇列。 選取的佇列管理程式必須在執行中。

如果不是這樣,您就必須輸入針對 ConnectionConsumer 而要從中擷取可延續訂閱訊息的佇列名稱。 預設佇列為 SYSTEM.JMS.D.CC.SUBSCRIBER.QUEUE。
BROKERCCDURSUBQ CCDSUB
發佈串流 這個內容可以用於 IBM WebSphere MQ 7.0 或更新版本的 JMS 用戶端,但對 IBM WebSphere MQ 7.0 或更新版本的佇列管理程式沒有作用。

選取或輸入所發佈訊息傳至的佇列名稱(串流佇列)。 預設佇列為 SYSTEM.BROKER.DEFAULT.STREAM。 若要使用「選取」來輸入名稱,您必須已選取 Broker Publication Queue Manager 內容的值,且選取的佇列管理程式必須在執行中。

BROKERPUBQ BPUB
分配管理系統發佈佇列管理程式 選取或輸入佇列管理程式的名稱,其擁有對主題所發佈訊息會傳至的佇列。 BROKERPUBQMGR BPQM
分配管理系統版本 這個內容可以用於 IBM WebSphere MQ 7.0 或更新版本的 JMS 用戶端,但對 IBM WebSphere MQ 7.0 或更新版本的佇列管理程式沒有作用。

請選取所使用的分配管理系統版本。 按一下 V1 以在相容模式下使用 IBM MQ 發佈/訂閱分配管理系統或 IBM Integration Bus;如果「傳輸」內容設為 BindingsClient,則這是預設值。 按一下 V2,以原生模式使用 IBM Integration Bus 的分配管理系統;如果 Transport 內容設為 DirectDirectHTTP,則這是預設值。

BROKERVER BVER

「產生者」頁面

下表列出您可以在「目的地內容」對話框的產生者頁面上設定的內容。 編輯產生者頁面上的內容,可變更目的地物件的其他內容。

表 4. 產生者頁面內容
內容 意義 詳細名稱 簡短名稱
允許非同步放置 指定是否容許訊息產生者使用非同步放置,以傳送訊息至此目的地。 若要藉由參照佇列或主題定義的方式來決定是否容許訊息產生者,請按一下當作目的地(預設值)。 若要容許非同步放置,請按一下已啟用;若不允許非同步放置,請按一下已停用 PUTASYNCALLOWED PAA

「消費者」頁面

下表列出您可以在「目的地內容」對話框的消費者頁面上設定的內容。 編輯消費者頁面上的內容,可變更目的地物件的其他內容。

表 5. 消費者頁面內容
內容 意義 詳細名稱 簡短名稱
允許先讀 指定是否容許訊息消費者和佇列瀏覽器在接收訊息之前使用先讀,將這個目的地的非持續性訊息讀到用戶端緩衝區。 若要藉由參照佇列或主題定義的方式來決定是否容許先讀,請按一下當作目的地(預設值)。 若容許先讀,請按一下已啟用;若不容許先讀,請按一下已停用 READAHEADALLOWED RAA ®
先讀關閉原則 對於分送至非同步訊息接聽器的訊息,指定當訊息消費者關閉時,用戶端 Proxy 佇列上的訊息會發生什麼情況。 若要指定用戶端 Proxy 佇列上的所有訊息在傳回之前會分送至應用程式的 MessageListener,請按一下全部分送(預設值)。 若要指定在傳回之前只完成現行 MessageListener 呼叫,可能留下用戶端 Proxy 佇列上的其他訊息等待捨棄,請按一下分送現行 READAHEADCLOSEPOLICY RACP
萬用字元格式 指定要使用的萬用字元語法的版本。

按一下僅字元萬用字元,可以僅使用字元萬用字元(為了與先前使用「分配管理系統第 1 版」的應用程式一致;請參閱「分配管理系統」版本內容)。

按一下僅主題萬用字元,可以僅使用主題層次萬用字元,其使用於「分配管理系統第 2 版」。
WILDCARDFORMAT WCFMT

「延伸事項」頁面

下表列出您可以在「目的地內容」對話框的延伸事項頁面上設定的內容。 編輯延伸事項頁面上的內容,可變更目的地物件的其他內容。

表 6. 延伸事項頁面內容
內容 意義 詳細名稱 簡短名稱
編碼字集 ID 輸入要用於目的地的編碼字集 ID (CCSID)。 CCSID CCS
編碼 選取用於此目的地的編碼方法。 如需相關資訊,請參閱 使用管理工具來配置 JMS 物件 ENCODING ENC
靜止即失敗 指定當佇列管理程式在靜止狀態時,對某些方法的呼叫是否會失敗。 若要指定當佇列管理程式在靜止狀態時,對某些方法的呼叫會失敗,請按一下。 這表示如果應用程式偵測到佇列管理程式是靜止的,則應用程式可立即完成它的作業並關閉連線,讓佇列管理程式停止。 如果要指定佇列管理程式處於靜止狀態時,不會使方法呼叫失敗,請按一下。 這表示應用程式無法偵測佇列管理程式在靜止中,因此應用程式可能會繼續針對佇列管理程式執行作業,以防止佇列管理程式停止。 FAILIFQUIESCE FIQ
多重播送 指定是否將訊息遞送至正在使用多重播送傳輸的訊息消費者。 多重播送傳輸僅適用於主題目的地,而且僅能在 Connection Factory 利用「直接 IP」傳輸時使用。 IBM MQ 8.0 中的直接 IP 傳輸無法使用。 如果使用 IBM MQ 8.0,則可以定義「直接 IP 傳輸」,但當嘗試建立連線時,它會失敗。

預設值是當作 Connection Factory,這表示會使用 Connection Factory 的多重播送內容的值。

按一下已啟用,以將訊息遞送至正在使用多重播送傳輸的訊息消費者。 主題必須在分配管理系統中配置為可靠的多重播送;如果主題配置為可靠的多重播送,會使用可靠的服務品質。

MULTICAST MCAST
多重播送(續)

按一下可靠,以將訊息遞送至正在使用多重播送傳輸及可靠服務品質的訊息消費者。 在分配管理系統中,主題必須配置為可靠的多重播送;如果主題未配置為可靠的多重播送,則您將無法建立該主題的訊息消費者。

按一下不可靠,以將訊息遞送至正在使用多重播送傳輸,但未使用可靠服務品質的訊息消費者。 主題必須在分配管理系統中配置為多重播送;即使主題配置為可靠的多重播送,也無法使用可靠的服務品質。
MULTICAST MCAST
目標用戶端

按一下 JMS 以指定訊息的目標是 JMS 應用程式。

按一下 MQ,指定訊息的目標為非 JMS IBM MQ 應用程式。

TARGCLIENT TC
回覆目的地樣式

指定 JMSReplyTo 欄位的格式。

按一下預設值以使用預設值。 除非已設定 JVM 系統內容,否則預設值相當於 RFH2 中的資訊。

按一下 MQMD 以使用 MQMD 中提供的值。 這會將來自 MQMD 的值移入佇列管理程式欄位。

按一下 RFH2 以使用 RFH2 標頭中提供的值。 如果傳送端應用程式設定了 JMSReplyTo 值,則會使用該值。

REPLYTOSTYLE RTOST
接收轉換 配置 MQGMO_CONVERT 選項的使用。 在要求訊息時,在 MQGET 或用戶端應用程式中指定 MQGMO_CONVERT,來選取是否要在佇列管理程式中執行轉換。 RECEIVECONVERSION RCNV
接收 CCSID 所要求將訊息轉換為的 CCSID。 當 JMS 的 IBM MQ 類別要求佇列管理程式執行轉換時使用(例如,透過指定 WMQ_RECEIVE_CONVERSION_QMGR 作為 setReceiveConversion 的引數)。 這個內容的值是 CCSID,也就是要求佇列管理程式將訊息轉換成的目標。 預設值是 CCSID 1208。 RECEIVECCSID RCCS