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