TCP ELM 使用者資料程式設計模型的 ELM 格式

本節說明 TCP ELM 使用者資料程式設計模型所使用的增強式接聽程式訊息 (ELM) 格式和內容。

ELM 要求訊息

下表顯示要求訊息的內容。

資料中的用戶端
35

資料中的用戶端
CICS TCP/IP 安全性結束所使用的 35 位元組資料,並傳遞至交易初始訊息中的並行伺服器 (TIM) 。

Microsoft 安全性結束格式資料的用戶端

下列程式碼區塊描述 Microsoft 安全性結束資料中的用戶端格式。

struct CLIENT_IN_DATA {  
   BYTE    bUserID[8];  
   BYTE    bPassword[8];  
   BYTE    bReserved[19];  
} UNALIGNED;  

IBM Security Exit 格式資料的用戶端

下列程式碼區塊描述 IBM 安全性結束資料中的用戶端格式。

struct CLIENT_IN_DATA2 {  
   BYTE    bSecFlag;  
   BYTE    bPassword[8];  
   BYTE    bUserID[8];  
   BYTE    bReserved[18];  
} UNALIGNED;  

ELM 回復訊息

下表顯示回復訊息的內容。

ELM 回復訊息長度 格式化的欄位長度 格式化的功能變數代碼 資料
4 4 1 0-n

注意

格式化的欄位長度、格式化的功能變數代碼和資料可以在單一訊息中重複多次。

ELM 回復訊息長度
ELM 回復訊息的總長度。 此長度是訊息中後面所有格式化欄位長度的總和,不包含 ELM 回復訊息長度欄位本身的長度。

格式化的欄位長度
格式化欄位的長度。

格式化欄位長度是格式化功能變數代碼長度和資料長度的組合總和。

格式化的功能變數代碼
1 位元組程式碼,描述從並行伺服器傳回用戶端的資訊。

您無法變更格式化功能變數代碼。

功能變數代碼專屬於 WIP 和 HIP TCP 傳輸與 MSCMTICS、MSHIPLNK 和 TCP 並行伺服器程式之間的通訊處理。

資料
與特定格式化欄位相關聯的 0 或多個位元組資訊。

您可以變更儲存在資料中的資訊。 如果您變更資料,請確定您也會將 TRM 回復和格式化的欄位長度變更為新的值。

Data 的長度等於格式化的欄位長度減去格式化功能變數代碼的大小。

一般代碼

下表顯示一般程式碼的意義。

程式碼 類型 意義
0x01 Info Microsoft 交易整合器並行伺服器的版本識別碼
0x02 Info 使用者資料
0x07 Info 執行確定

錯誤碼

下表顯示錯誤碼的意義。

程式碼 類型 意義
0x03 錯誤 不正確 ProgID
0x04 錯誤 不正確 TranID
0x05 錯誤 查詢失敗
0x06 錯誤 查詢狀態
0x08 錯誤 程式 ABEND
0x09 錯誤 執行失敗
0x0A 錯誤 不正確 ELM

如需 TRM 格式的詳細資訊,請參閱磁片磁碟機 > :\Program Files\ Microsoft Host Integration Server\System\TIM\MicrosoftTRMDefs.tim 的 TRM 定義檔案 < 。 使用 Visual Studio 來檢視檔案。

另請參閱

TCP ELM 連結程式設計模型的 ELM 格式
增強接聽程式 CICS 管理