訊息的內容

JMS_IBM_MQMD* 內容

IBM® Message Service Client for .NET 可讓用戶端應用程式使用 API 讀取/寫入 MQMD 欄位。 它也容許存取 MQ 訊息資料。 依預設會停用 MQMD 的存取權，且應用程式必須使用「目的地」內容 XMSC_WMQ_MQMD_WRITE_ENABLED 及 XMSC_WMQ_MQMD_READ_ENABLED 來明確啟用。 這兩個內容彼此獨立。

除了 StrucId 和 Version 之外，所有 MQMD 欄位都公開為其他訊息物件內容，並以 JMS_IBM_MQMD 為字首。

JMS_IBM_MQMD* 內容優先於上表所說明的其他內容 (例如 JMS_IBM*)。

傳送訊息

除了 StrucId 和 Version 之外的所有 MQMD 欄位都已呈現。 這些內容僅參照 MQMD 欄位; 如果內容同時出現在 MQMD 和 MQRFH2 標頭中，則不會設定或擷取 MQRFH2 中的版本。 可以設定任何這些內容，但 JMS_IBM_MQMD_BackoutCount除外。 會忽略為 JMS_IBM_MQMD_BackoutCount 設定的任何值。

如果內容具有長度上限，且您提供的值太長，則會截斷該值。

對於某些內容，您也必須在 Destination 物件上設定 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 內容。 應用程式必須以適當的環境定義權限執行，才能使此內容生效。 如果您未將 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 設為適當的值，則會忽略內容值。 如果您將 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 設為適當的值，但沒有佇列管理程式的足夠環境定義權限，則會發出異常狀況。 需要 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 特定值的內容如下。

接收訊息

如需進一步詳細資料，請參閱 MQMD 。

範例

此範例會導致將訊息放入具有 MQMD.UserIdentifier 設為 "JoeBloggs"。

  // Create a ConnectionFactory, connection, session, producer, message
  // ...

  // Create a destination
  // ...

  // Enable MQMD write
  dest.setBooleanProperty(XMSC_WMQ_MQMD_WRITE_ENABLED, 
		XMSC_WMQ_MQMD_WRITE_ENABLED_YES);
  
  // Optionally, set a message context if applicable for this MD field
  dest.setIntProperty(XMSC_WMQ_MQMD_MESSAGE_CONTEXT, 
    XMSC_WMQ_MDCTX_SET_IDENTITY_CONTEXT);

  // On the message, set property to provide custom UserId
  msg.setStringProperty(JMS_IBM_MQMD_USERIDENTIFIER, "JoeBloggs");

  // Send the message
  // ...

在設定 JMS_IBM_MQMD_USERIDENTIFIER 之前，必須先設定 XMSC_WMQ_MQMD_MESSAGE_CONTEXT。 如需使用 XMSC_WMQ_MQMD_MESSAGE_CONTEXT 的相關資訊，請參閱訊息物件內容。

同樣地，您可以在接收訊息之前將 XMSC_WMQ_MQMD_READ_ENABLED 設為 true ，然後使用訊息的 get 方法 (例如 getStringProperty) ，來解壓縮 MQMD 欄位的內容。 任何收到的內容都是唯讀的。

此範例會導致值欄位保留 MQMD.ApplIdentityData 欄位。

  // Create a ConnectionFactory, connection, session, consumer
  // ...

  // Create a destination
  // ...

  // Enable MQMD read
  dest.setBooleanProperty(XMSC_WMQ_MQMD_READ_ENABLED, XMSC_WMQ_MQMD_READ_ENABLED_YES);

  // Receive a message
  // ...

  // Get required MQMD field value using a property
  System.String value = rcvMsg.getStringProperty(JMS_IBM_MQMD_APPLIDENTITYDATA);