訊息內容

訊息內容會顯示在「訊息內容」對話框中。 您不能編輯任何訊息內容。

下表列出您可以在佇列中放置及取得 IBM® MQ 訊息的內容:

每一個內容都有內容意義的簡要說明。 該表格也顯示名稱的 MQMD 格式,其用於 API 中。 這在 IBM Documentation中的 MQMD 概觀 中有說明。

「一般」頁面

下表列出「訊息內容」對話框之一般頁面上的內容。

內容 意義 MQMD 形式
位置 唯讀。 訊息佇列中的現行位置。 (不適用。)
訊息類型 唯讀。 這是訊息類型:Datagram 表示訊息不需要回覆;Request 表示訊息需要回覆;Reply 表示訊息是先前要求訊息的回覆;Report 表示訊息正在報告某些預期或非預期的出現項目,通常與某些其他訊息相關。 比方說,包含無效資料的要求訊息。 MsgType
優先順序 唯讀。 這是訊息的優先順序。 最低的優先順序為 0。 優先順序
持續性 唯讀。 這指出訊息是持續還是非持續。 如果訊息是持續,它在系統失敗並重新啟動佇列管理程式之後仍然存在。 如果訊息是非持續性,則只有在它呈現在具有 NPMCLASS (HIGH) 內容的佇列上時,它才會在重新啟動之後仍然存在。 但是,即使具有 NPMCLASS(HIGH) 內容,訊息在 QMGR 類別中還是不會存在。 即使在重新啟動程序期間,在輔助儲存體上找到非持續訊息,但在佇列管理程式重新啟動時,還是會捨棄具有 NPMCLASS(NORMAL) 內容的佇列上的這些訊息。 持續性
放置日期/時間 唯讀。 這是放置訊息的日期。 PutDate; PutTime
期限 唯讀。 這是如果在此之後訊息仍未從目標佇列中移除,就可以予以捨棄的期間(十分之一秒)。 期限間隔是由放置訊息的應用程式所設定。 期限
回覆目的地佇列 唯讀。 這是發出取得訊息要求的應用程式應該將回覆與報告訊息傳送給此的訊息佇列名稱。 ReplyToQ
回覆目的地佇列管理程式 唯讀。 這是在其中定義回覆目的地佇列的佇列管理程式名稱。 ReplyToQmgr
取消次數 唯讀。 這是之前由 MQGET 呼叫將訊息當成工作單元的一部分傳回,隨後又取消的次數。 BackoutCount

「報告」頁面

下表列出「訊息內容」對話框之報告頁面上的內容。 報告是一則關於另一則訊息的訊息,用來通知應用程式與原始訊息相關的預期或非預期事件。 報告頁面會顯示與報告訊息相關的內容。 如需相關資訊,請參閱 IBM 說明文件中的 報告選項及訊息旗標

內容 意義 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 內容頁面有兩種方式:
  • 在「 喜好設定 」對話框的 訊息 頁面上,選取 作為訊息內文 中的 MQRFH2 結構。

    訊息的內容(訊息描述子或延伸中的除外)必須顯示在「MQRFH2 內容」中,且這些內容會留在訊息資料中。 「MQGMO 選項」是 MQGMO_PROPERTIES_FORCE_MQRFH2,如需相關「取得訊息選項」的相關資訊,請參閱 MQ 取得訊息選項

  • 在「 喜好設定 」對話框的 訊息 頁面上,選取 作為訊息內文中與 WebSphere MQ V6 相容的 MQRFH2 結構。 只有在訊息包含字首為 mcdjms使用者mqext 的內容時,才會顯示 MQRFH2 內容 頁面。

    如果訊息含有字首為 mcdjmsusrmqext 的內容,所有訊息內容(訊息描述子或延伸中的除外)都必須顯示在「MQRFH2 內容」畫面中,且這些內容會留在訊息資料中。 否則,訊息的所有內容(訊息描述子或延伸中的除外)都會被捨棄而不會顯示。 「MQGMO 選項」是 MQGMO_PROPERTIES_IN_COMPATIBILITY,如需相關「取得訊息選項」的相關資訊,請參閱MQ 取得訊息選項

如需「 喜好設定 」對話框的相關資訊,請參閱 配置 MQ 探險家

由於 MQRFH2 結構是巢狀的 xml,因此「MQRFH2 內容」頁面會以樹狀結構視圖顯示 MQRFH2 內容。 同義字相同的所有內容都會群組在同義字樹狀結構下,其可以展開以顯示所有內容,也可以收合以隱藏所有內容。

內容 意義
姓名 唯讀。 訊息內容的名稱。
唯讀。 這是具名內容的實際值。

「資料」頁面

下表列出「訊息內容」對話框之資料頁面上的內容。 資料頁面會顯示訊息資料本身以及資料格式的相關資訊。

內容 意義 MQMD 形式
資料長度 唯讀。 這是原始訊息的長度。 OriginalLength
格式 唯讀。 這是訊息傳送端的名稱,其用來告訴接收端有關訊息中的資料本質。 格式
編碼字集 ID 唯讀。 這是應用程式訊息資料中字元資料的編碼字集 ID。 編碼字元設定 ID
編碼 唯讀。 這是訊息中數值資料的數值編碼。 這個值不適用於 MQMD 結構本身的數值資料。 編碼
訊息資料 唯讀。 這是可讀取的 ASCII 文字的訊息資料。 (不適用。)
訊息資料位元組數 唯讀。 這是十六進位格式的訊息資料。 (不適用。)

「無法傳送郵件的標頭」頁面

下表列出「訊息內容」對話框之無法傳送郵件的標頭頁面上的內容。 只有當訊息有無法傳送郵件的標頭時,才會顯示無法傳送郵件的標頭頁面。

內容 意義 MQMD 形式
原因 這指出訊息為何放在無法傳送的郵件(未遞送的訊息)佇列中,而非放在原始目的地佇列中。 原因
目的地佇列 訊息佇列的名稱,這是訊息的原始目的地。 DestQName
目的地佇列管理程式 佇列管理程式的名稱,這是訊息的原始目的地。 DestQMgrName
原始編碼 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的數值編碼;其不適用於 MQDLH 結構本身的數值資料。 編碼
原始 CCSID 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的字集 ID;其不適用於 MQDLH 結構本身的字集。 編碼字元設定 ID
原始格式 這指定 MQDLH 結構後面之資料(通常是來自原始訊息的資料)的格式名稱。 格式
放置應用程式類型 放置訊息的應用程式類型。 這是訊息原始上下文的一部分。 如需訊息環境定義的相關資訊,請參閱 IBM 說明文件中的 訊息環境定義 PutApplType
放置應用程式名稱 將訊息放到無法傳送郵件的佇列的應用程式名稱。 名稱的格式取決於 Put Application Type 內容。 此名稱可能會被截斷。 PutApplName
放置日期 訊息放到無法傳送郵件的佇列的日期。 PutDate
放置時間 訊息放到無法傳送郵件的佇列的時間。 PutTime