TCP TRM ユーザー データのプログラミング モデルの TRM 形式
このセクションでは、TCP TRM ユーザー データ プログラミング モデルで使用されるトランザクション要求メッセージ (TRM) の形式と内容について説明します。
TRM 要求メッセージ
次の表に、要求メッセージの内容を示します。
| TranID | コンマ | データ内のクライアント |
|---|---|---|
| 4 | 1 | 35 |
TranID
リスナーによって開始される同時実行サーバーのトランザクション ID。
コンマ
コンマ (,) は、データ内のクライアントとトランザクション ID を分離します。
データ内のクライアント
CICS TCP/IP セキュリティ終了によって使用され、トランザクション開始メッセージ (TIM) で同時実行サーバーに渡される 35 バイトのデータ。
Microsoft セキュリティ出口のデータ内のクライアントの形式
次のコード ブロックでは、Microsoft セキュリティ出口のデータ内のクライアントの形式について説明します。
struct CLIENT_IN_DATA {
BYTE bUserID[8];
BYTE bPassword[8];
BYTE bReserved[19];
} UNALIGNED;
IBM セキュリティ出口のデータ内のクライアントの形式
次のコード ブロックでは、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 |
Note
書式設定されたフィールドの長さ、書式設定されたフィールド コード、およびデータは、1 つのメッセージで複数回繰り返すことができます。
TRM 応答メッセージの長さ
TRM 応答メッセージの合計長。 この長さは、メッセージの後に続く書式設定されたフィールドのすべての長さの合計であり、TRM 応答メッセージの長さフィールド自体の長さは含まれません。
書式設定されたフィールドの長さ
書式設定されたフィールドの長さ。
書式設定されたフィールドの長さは、書式設定されたフィールド コード長とデータ長の組み合わせの合計です。
書式設定されたフィールド コード
同時実行サーバーからクライアントに返される情報を記述する 1 バイト コード。
書式設定されたフィールド コードを変更することはできません。
フィールド コードは、WIP と HIP TCP トランスポートと MSCMTICS、MSHIPLNK、TCP 同時実行サーバー プログラムの間の通信処理に固有です。
データ
特定の書式設定されたフィールドに関連付けられている 0 バイト以上の情報。
データに格納されている情報を変更できます。 データを変更する場合は、TRM 応答と書式設定されたフィールドの長さも新しい値に変更してください。
データの長さは、書式設定されたフィールドの長さから書式設定されたフィールド コードのサイズを引いた値と等しくなります。
通常のコード
次の表に、通常のコードの意味を示します。
| コード | Type | 説明 |
|---|---|---|
| 0x01 | Info | Microsoft® Transaction Integrator Concurrent Server のバージョン ID |
| 0x02 | Info | ユーザー データ |
| 0x07 | Info | 実行 OK |
エラー コード
次の表に、エラー コードの意味を示します。
| コード | Type | 説明 |
|---|---|---|
| 0x03 | エラー | 無効な ProgID |
| 0x04 | エラー | 無効な TranID |
| 0x05 | エラー | 照会に失敗しました |
| 0x06 | エラー | 照会の状態 |
| 0x08 | エラー | プログラムの ABEND |
| 0x09 | エラー | 実行に失敗しました |
| 0x0A | エラー | 無効な TRM |
| 0x0B | エラー | サーバーで例外が生成されました |
| 0x0C | エラー | 例外エラー情報はメタデータ エラー ブロックにあります |
TRM の形式の詳細については、drive>:\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim にある TRM 定義ファイル<を参照してください。 Visual Studio を使用してファイルを表示します。