訊息內容
「訊息內容」對話框中顯示訊息的屬性。您不能編輯任何訊息屬性。
下表列出您可以在佇列中放入及取出的 IBM® MQ 訊息的屬性:
每一個屬性都有屬性意義的簡要說明。該表格也顯示名稱的 MQMD 格式,其用於 API 中。IBM MQ 線上產品說明文件的 MQMD 概觀中提供了此說明。
「一般」頁面
下表列出「訊息內容」對話框之一般頁面中的屬性。
屬性 | 意義 | MQMD 形式 |
---|---|---|
位置 | 唯讀。訊息佇列中的現行位置。 | (不適用。) |
訊息類型 | 唯讀。這是訊息的類型:資料包表示訊息不需要回覆;要求表示訊息需要回覆;回覆表示訊息是之前要求訊息的回覆;報告表示訊息會根據一些預期或非預期的情況報告,通常是與其他訊息相關。比方說,包含無效資料的要求訊息。 | MsgType |
優先順序 | 唯讀。這是訊息的優先順序。最低的優先順序為 0。 | 優先順序 |
持續性 | 唯讀。這指出訊息是持續還是非持續。如果訊息是持續,它在系統失敗並重新啟動佇列管理程式之後仍然存在。如果是非持續訊息,則只有在它出現在具有 NPMCLASS(HIGH) 屬性的佇列上時,才會在重新啟動後仍然存在。但是,即使具有 NPMCLASS(HIGH) 屬性,訊息在 QMGR 類別中還是不會存在。即使在重新啟動程序期間,在輔助儲存體上找到非持續訊息,但在佇列管理程式重新啟動時,還是會捨棄具有 NPMCLASS(NORMAL) 屬性的佇列上的這些訊息。 | 持續性 |
放置日期/時間 | 唯讀。這是放置訊息的日期。 | PutDate; PutTime |
期限 | 唯讀。這是如果在此之後訊息仍未從目標佇列中移除,就可以予以捨棄的期間(十分之一秒)。期限間隔是由放置訊息的應用程式所設定。 | 期限 |
回覆目的地佇列 | 唯讀。這是發出取得訊息要求的應用程式應該將回覆與報告訊息傳送給此的訊息佇列名稱。 | ReplyToQ |
回覆目的地佇列管理程式 | 唯讀。這是在其中定義回覆目的地佇列的佇列管理程式名稱。 | ReplyToQmgr |
取消次數 | 唯讀。這是之前由 MQGET 呼叫將訊息當成工作單元的一部分傳回,隨後又取消的次數。 | BackoutCount |
「報告」頁面
下表列出「訊息內容」對話框之報告頁面中的屬性。報告是一則關於另一則訊息的訊息,用來通知應用程式與原始訊息相關的預期或非預期事件。報告頁面會顯示與報告訊息相關的屬性。如需相關資訊,請參閱 IBM MQ 線上產品說明文件中的報告選項及訊息旗標。
屬性 | 意義 | MQMD 形式 |
---|---|---|
報告 | 唯讀。傳送端應用程式會在這個欄位中指定是否需要報告訊息、應用程式資料是否要納入報告訊息中,以及如何設定報告或回覆訊息中的訊息和相關性 ID。 | 報告 |
意見 | 唯讀。這只用於報告訊息以指出報告的本質。 | 意見 |
原始長度 | 唯讀。這只用於報告訊息以指出報告相關之原始訊息的長度。 | OriginalLength |
「環境定義」頁面
下表列出「訊息內容」對話框之環境定義頁面中的屬性。環境定義頁面會顯示來自傳送端應用程式的訊息相關資訊。
屬性 | 意義 | MQMD 形式 |
---|---|---|
使用者 ID | 唯讀。這是發出訊息之應用程式的使用者 ID。 | UserIdentifier |
應用程式類型 | 唯讀。這是放置訊息的應用程式類型,例如,CICS® 或 AIX®。 | PutApplType |
放置應用程式名稱 | 唯讀。這是放置訊息的應用程式名稱。此名稱可能會被截斷。 | PutApplName |
應用程式身分資料 | 唯讀。這是由應用程式套件定義的資訊,可以用來提供訊息或其發送端的相關資訊。 | ApplIdentityData |
應用程式原始資料 | 唯讀。這是由應用程式套件定義的資訊,可以用來提供訊息出處的其他資訊。 | ApplOriginData |
帳戶記號 | 唯讀。這項資訊可讓應用程式適當地負責因訊息產生的工作。 | 帳戶記號 |
ID 頁面
下表列出「訊息內容」對話框之 ID 頁面中的屬性。ID 頁面會顯示與訊息關聯的識別資訊。
屬性 | 意義 | MQMD 形式 |
---|---|---|
訊息 ID | 唯讀。這是用來區分訊息的訊息 ID。 | 訊息 ID |
訊息 ID 位元組數 | 唯讀。這是位元組形式的訊息 ID。 | 訊息 ID |
相關性 ID | 唯讀。這是相關性 ID,應用程式可以用來建立訊息與訊息的關聯,或建立訊息與應用程式所執行的其他工作的關聯。 | CorrelId |
相互關係 ID 位元組數 | 唯讀。這是位元組形式的相關性 ID。 | CorrelId |
群組 ID | 唯讀。這是群組 ID,可以用來識別實際訊息所屬的特定訊息群組或邏輯訊息。 | GroupId |
群組 ID 位元組數 | 唯讀。這是位元組形式的群組 ID。 | GroupId |
「分段」頁面
下表列出「訊息內容」對話框之分段頁面中的屬性。分段頁面會顯示與分段大型訊息相關的屬性。
屬性 | 意義 | MQMD 形式 |
---|---|---|
邏輯序號 | 唯讀。這是群組內邏輯訊息的序號。序號是從 1 開始,群組中每一個新的邏輯訊息會增加 1,上限為 999,999,999。不在群組中的實際訊息的序號為 1。 | MsgSeqNumber |
偏移 | 唯讀。這是從邏輯訊息開始算起,資料在實際訊息中的偏移。 | 偏移 |
旗標 | 唯讀。這些是指定訊息屬性或是控制其處理的訊息旗標。 | 訊息旗標 |
「具名內容」頁面
下表列出「訊息內容」對話框的具名內容頁面上的屬性。只有當您在「喜好設定」對話框的「訊息內容」頁面中選取了作為具名內容,且所選的訊息有內容時,才會顯示具名內容頁面。訊息的內容(訊息描述子或延伸中的除外)必須以名稱/值配對顯示在具名內容畫面中,且這些內容會從訊息資料中移除。
「MQGMO 選項」為 MQGMO_PROPERTIES_IN_HANDLE;如需相關之「取得訊息選項」的詳細資訊,請參閱 MQ 取得訊息選項。如需「喜好設定」對話框的相關資訊,請參閱配置 MQ 探險家。
屬性 | 意義 |
---|---|
名稱 | 唯讀。訊息內容的名稱。 |
值 | 唯讀。這是具名內容的實際值。 |
「MQRFH2 內容」頁面
- 在「喜好設定」對話框的「訊息」頁面中,選取作為訊息內文中的 MQRFH2 結構。
訊息的內容(訊息描述子或延伸中的除外)必須顯示在「MQRFH2 內容」中,且這些內容會留在訊息資料中。「MQGMO 選項」為 MQGMO_PROPERTIES_FORCE_MQRFH2;如需相關「取得訊息選項」的詳細資訊,請參閱 MQ 取得訊息選項。
- 在「喜好設定」對話框的「訊息」頁面中,選取作為訊息內文中與 WebSphere MQ 第 6 版相容的 MQRFH2 結構。只有當訊息含有字首為 mcd、jms、usr 或 mqext 的內容時,才會顯示 MQRFH2 內容頁面。
如果訊息含有字首為 mcd、jms、usr 或 mqext 的內容,所有訊息內容(訊息描述子或延伸中的除外)都必須顯示在「MQRFH2 內容」畫面中,且這些內容會留在訊息資料中。否則,訊息的所有內容(訊息描述子或延伸中的除外)都會被捨棄而不會顯示。「MQGMO 選項」為 MQGMO_PROPERTIES_IN_COMPATIBILITY;如需相關之「取得訊息選項」的詳細資訊,請參閱 MQ 取得訊息選項。
由於 MQRFH2 結構是巢狀的 xml,因此「MQRFH2 內容」頁面會以樹狀結構視圖顯示 MQRFH2 內容。同義字相同的所有內容都會群組在同義字樹狀結構下,其可以展開以顯示所有內容,也可以收合以隱藏所有內容。
屬性 | 意義 |
---|---|
名稱 | 唯讀。訊息內容的名稱。 |
值 | 唯讀。這是具名內容的實際值。 |
「資料」頁面
下表列出「訊息內容」對話框之資料頁面中的屬性。資料頁面會顯示訊息資料本身以及資料格式的相關資訊。
屬性 | 意義 | MQMD 形式 |
---|---|---|
資料長度 | 唯讀。這是原始訊息的長度。 | OriginalLength |
格式 | 唯讀。這是訊息傳送端的名稱,其用來告訴接收端有關訊息中的資料本質。 | 格式 |
編碼字集 ID | 唯讀。這是應用程式訊息資料中字元資料的編碼字集 ID。 | 編碼字元設定 ID |
編碼 | 唯讀。這是訊息中數值資料的數值編碼。這個值不適用於 MQMD 結構本身的數值資料。 | 編碼 |
訊息資料 | 唯讀。這是可讀取的 ASCII 文字的訊息資料。 | (不適用。) |
訊息資料位元組數 | 唯讀。這是十六進位格式的訊息資料。 | (不適用。) |
「無法傳送郵件的標頭」頁面
下表列出「訊息內容」對話框之無法傳送郵件的標頭頁面中的屬性。只有當訊息有無法傳送郵件的標頭時,才會顯示無法傳送郵件的標頭頁面。
屬性 | 意義 | MQMD 形式 |
---|---|---|
原因 | 這指出訊息為何放在無法傳送的郵件(未遞送的訊息)佇列中,而非放在原始目的地佇列中。 | 原因 |
目的地佇列 | 訊息佇列的名稱,這是訊息的原始目的地。 | DestQName |
目的地佇列管理程式 | 佇列管理程式的名稱,這是訊息的原始目的地。 | DestQMgrName |
原始編碼 | 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的數值編碼;其不適用於 MQDLH 結構本身的數值資料。 | 編碼 |
原始 CCSID | 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的字集 ID;其不適用於 MQDLH 結構本身的字集。 | 編碼字元設定 ID |
原始格式 | 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的格式名稱。 | 格式 |
放置應用程式類型 | 放置訊息的應用程式類型。這是訊息原始上下文的一部分。如需訊息環境定義的相關資訊,請參閱 IBM MQ 線上產品說明文件中的訊息環境定義。 | PutApplType |
放置應用程式名稱 | 將訊息放到無法傳送郵件的佇列的應用程式名稱。名稱的格式會視放置應用程式類型屬性而定。此名稱可能會被截斷。 | PutApplName |
放置日期 | 訊息放到無法傳送郵件的佇列的日期。 | PutDate |
放置時間 | 訊息放到無法傳送郵件的佇列的時間。 | PutTime |