TCP TRM 使用者資料程式設計模型的 TRM 格式
本節說明 TCP TRM 使用者資料程式設計模型所使用的交易要求訊息格式和內容 (TRM) 。
TRM 要求訊息
下表顯示要求訊息的內容。
| TranID | Comma (逗號) | 資料中的用戶端 |
|---|---|---|
| 4 | 1 | 35 |
TranID
要由接聽程式啟動之並行伺服器的異動識別碼。
Comma (逗號)
逗號 (，) 分隔交易識別碼與資料中的用戶端。
資料中的用戶端
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;
COBOL 資料中的用戶端
下列程式碼區塊描述 COBOL 中的用戶端格式
01 CLIENT-IN-DATA PIC X(35).
01 FILLER REDEFINES CLIENT-IN-DATA.
05 CID-USERID PIC X(8).
05 CID-PASSWORD PIC X(8).
05 CID-LINK-TO-PROG PIC X(8).
05 CID-COMMAREA-LEN PIC S9(4) COMP.
05 CID-DATA-LEN PIC S9(8) COMP.
05 CID-VERSION PIC X.
05 CID-FLAG-1 PIC X.
05 CID-FLAG-2 PIC X.
05 CID-RESERVED PIC X.
05 CID-FORMAT PIC X.
COBOL 資料常數中的用戶端
下列程式碼區塊描述 COBOL 資料中用戶端的常數。
01 CLIENT-IN-DATA-CONSTANTS.
05 CID-C-VERSION.
10 CID-VERSION-1 PIC X VALUE X'00'.
10 CID-VERSION-2 PIC X VALUE X'01'.
05 CID-C-FLAG-1.
10 CID-USE-TICS-WORK-AREA PIC X VALUE X'01'.
05 CID-C-FLAG-2.
10 CID-PC-NONE PIC X VALUE X'01'.
10 CID-PC-OPEN PIC X VALUE X'02'.
10 CID-PC-USE PIC X VALUE X'04'.
10 CID-PC-CLOSE PIC X VALUE X'08'.
10 CID-NO-OBJ-PERSIST PIC X VALUE X'10'.
05 CID-C-FORMAT.
10 CID-FORMAT-NOTSET PIC X VALUE X'00'.
10 CID-FORMAT-MS PIC X VALUE X'01'.
10 CID-FORMAT-IBM PIC X VALUE X'02'.
TRM 回復訊息
下表顯示回復訊息的內容。
| TRM 回復訊息長度 | 格式化欄位長度 | 格式化的功能變數代碼 | 資料 |
|---|---|---|---|
| 2 | 4 | 1 | 0-n |
注意
格式化的欄位長度、格式化的功能變數代碼和資料可以在單一訊息中重複多次。
TRM 回復訊息長度
TRM 回復訊息的總長度。 這個長度是訊息中後面所格式化欄位的所有長度總和，不包含 TRM 回復訊息長度欄位本身的長度。
格式化欄位長度
格式化欄位的長度。
格式化欄位長度是格式化功能變數代碼長度和資料長度的組合總和。
格式化的功能變數代碼
1 位元組程式碼，描述從並行伺服器傳回用戶端的資訊。
您無法變更 [格式化] 功能變數代碼。
功能變數代碼是 WIP 與 HIP TCP 傳輸與 MSCMTICS、MSHIPLNK 和 TCP 並行伺服器程式之間的通訊處理專屬。
資料
與特定格式化欄位相關聯的 0 或更多位元組資訊。
您可以變更儲存在資料中的資訊。 如果您變更資料，請確定您也會將 TRM 回復和格式化欄位長度變更為新的值。
資料的長度等於格式化欄位長度減去格式化功能變數代碼的大小。
一般代碼
下表顯示一般程式碼的意義。
| 程式碼 | 類型 | 意義 |
|---|---|---|
| 0x01 | Info | Microsoft® 交易整合器並行伺服器的版本識別碼 |
| 0x02 | Info | 使用者資料 |
| 0x07 | Info | 執行確定 |
錯誤碼
下表顯示錯誤碼的意義。
| 程式碼 | 類型 | 意義 |
|---|---|---|
| 0x03 | 錯誤 | 不正確 ProgID |
| 0x04 | 錯誤 | 不正確 TranID |
| 0x05 | 錯誤 | 查詢失敗 |
| 0x06 | 錯誤 | 查詢狀態 |
| 0x08 | 錯誤 | 程式 ABEND |
| 0x09 | 錯誤 | 執行失敗 |
| 0x0A | 錯誤 | 不正確 TRM |
| 0x0B | 錯誤 | 伺服器產生例外狀況 |
| 0x0C | 錯誤 | 例外狀況錯誤資訊位於中繼資料錯誤區塊中 |
如需 TRM 格式的詳細資訊，請參閱磁片磁碟機 > ：\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim 上的 < TRM 定義檔案。 使用 Visual Studio 來檢視檔案。