可選的中繼資料

作為開發人員，您可以選擇讓交易整合器（TI）執行環境在大型主機交易程序（TP）之間傳送和接收中繼資料，並選擇該中繼資料的內容。

您可以發送或接收：

• 沒有元資料。

• 只有方法名稱作為元資料。

• 所有中繼資料，包括方法名稱。

  TI 執行時環境會依指示向 TP 傳送或接收元資料。 元數據協助 TP 完成以下任務：

• 識別元資料格式（版本資訊）。

• 識別用於調用TP的方法名稱。

• 將詳細錯誤資訊回報給客戶。

  這些元資料對自動化客戶端來說是看不到的。 中繼資料作為發送至 TP 的請求訊息或從 TP 收到的回應訊息的一部分，送達或接收主機 TP。

  元資料集包含以下資料：

• TI 執行時版本。

  一串字元，例如「Microsoft TI version 1.0.0」，唯一識別產生請求的 TI 執行時環境版本。

• 由用戶端應用程式碼呼叫的方法名稱（32 字元字串）。

• 元資料區塊 ID。

  一個以字元形式呈現的 GUID，唯一識別此例外資料區塊。 GUID 支援未來新增例外格式的能力，並協助確保接收到的資料是有效的。

• 迄今無指定用途的變數（保留）：

  • 布林旗標指示TP是否準備好提交。

  • 布林標誌表示 TP 是否準備好執行額外工作。

  • 兩個短整數用來存放 TI 執行時環境版本號的部分，一個短整數用來儲存主要版本號，另一個則用來存放次要版本號。

• 例外區塊（僅用於回覆）。

  一個二進位格式的 GUID，能唯一識別此異常資料區塊。 GUID 允許未來支援更多例外格式，並協助確保接收的資料有效：

  • 布林旗標，指示 TP 是否已準備好進行提交。

  • 布林標誌表示 TP 是否準備好執行額外工作。

  • 布林標誌，指示是否應該將例外回傳給用戶端應用程式。 若設定此標誌，該標誌也會導致交易終止。

  • 16位元整數用來識別錯誤（詳見本主題後續說明）。 你可以從伺服器指定這個值，連同描述錯誤的 256 字元訊息，讓當 TI 執行時錯誤發生時，該值會被回傳。

  • 32 位元整數，用來識別 TP 說明檔案中的上下文 ID（如果有的話）。

  • 256 字元的訊息描述錯誤。 你可以將此值與伺服器端識別錯誤的 16 位元整數一併指派，當 TI 執行時錯誤發生時，該值會被回傳。

  元資料總是位於訊息的開頭。