Format TRM untuk Model Pemrograman Data Pengguna TCP TRM

2023-07-21

Bagian ini menjelaskan format dan konten pesan permintaan transaksi (TRM) yang digunakan oleh model pemrograman Data Pengguna TCP TRM.

Pesan Permintaan TRM

Tabel berikut ini memperlihatkan konten pesan permintaan.

TranID	Koma	Klien dalam data
4	1	35

TranID
ID Transaksi Server Bersamaan yang akan dimulai oleh Pendengar.

Koma
Koma (,) memisahkan ID transaksi dari Klien dalam data.

Klien dalam data
35 byte data yang digunakan oleh CICS TCP/IP security exit dan diteruskan ke Server Bersamaan dalam pesan inisiasi transaksi (TIM).

Klien dalam data untuk format Keluar Keamanan Microsoft

Blok kode berikut menjelaskan format klien dalam data untuk keluarnya keamanan Microsoft.

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

Klien dalam data untuk format Keluar Keamanan IBM

Blok kode berikut menjelaskan format klien dalam data untuk keluarnya keamanan IBM.

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

Klien dalam data untuk COBOL

Blok kode berikut menjelaskan format klien di 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.

Klien dalam konstanta data untuk COBOL

Blok kode berikut menjelaskan konstanta untuk klien dalam data di 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'.

Pesan Balasan TRM

Tabel berikut ini memperlihatkan konten pesan balasan.

Panjang msg balasan TRM	Panjang bidang yang diformat	Kode bidang yang diformat	Data
2	4	1	0-n

Catatan

Panjang bidang yang diformat, kode bidang yang diformat, dan data dapat diulang beberapa kali dalam satu pesan.

Panjang msg balasan TRM
Panjang total pesan balasan TRM. Panjang ini adalah jumlah semua panjang bidang yang diformat yang mengikuti dalam pesan dan tidak menyertakan panjang bidang panjang msg balasan TRM itu sendiri.

Panjang bidang yang diformat
Panjang bidang yang diformat.

Panjang bidang yang diformat adalah jumlah kombinasi panjang kode bidang Yang Diformat dan panjang Data.

Kode bidang yang diformat
Kode 1-byte yang menjelaskan informasi yang diteruskan dari Server Bersamaan kembali ke klien.

Anda tidak dapat mengubah kode bidang Yang Diformat.

Kode bidang khusus untuk penanganan komunikasi antara WIP dan HIP TCP Transports dan program MSCMTICS, MSHIPLNK dan TCP Concurrent Server.

Data
0 atau lebih byte informasi yang terkait dengan bidang berformat tertentu.

Anda dapat mengubah informasi yang disimpan dalam Data. Jika Anda mengubah Data, pastikan Anda juga mengubah Balasan TRM dan Panjang Bidang Yang Diformat ke nilai baru.

Panjang Data sama dengan panjang bidang yang diformat dikurangi ukuran kode bidang yang diformat.

Kode normal

Tabel berikut menunjukkan arti kode normal.

Kode	Jenis	Makna
0x01	info	ID Versi untuk Microsoft® Transaction Integrator Concurrent Server
0x02	info	Data Pengguna
0x07	info	Eksekusi OK

Kode kesalahan

Tabel berikut menunjukkan arti kode kesalahan.

Kode	Jenis	Makna
0x03	Kesalahan	ProgID Tidak Valid
0x04	Kesalahan	TranID Tidak Valid
0x05	Kesalahan	Pertanyaan Gagal
0x06	Kesalahan	Status Pertanyaan
0x08	Kesalahan	Program ABEND
0x09	Kesalahan	Eksekusi Gagal
0x0A	Kesalahan	TRM Tidak Valid
0x0B	Kesalahan	Server menghasilkan pengecualian
0x0C	Kesalahan	Informasi kesalahan pengecualian ada di Blok Kesalahan Meta Data

Untuk informasi selengkapnya tentang format TRM, lihat file definisi TRM di <drive>:\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim. Gunakan Visual Studio untuk melihat file.

Lihat juga

Format TRM untuk Model Pemrograman Tautan TCP TRM

Bagikan melalui