Formato TRM per il modello di programmazione dati utente TRM TCP

Articolo
10/14/2023

Questa sezione descrive il formato e il contenuto del messaggio di richiesta di transazione (TRM) usato dal modello di programmazione tcp TRM User Data.

Messaggio di richiesta TRM

Nella tabella seguente viene illustrato il contenuto del messaggio di richiesta.

TranID	Virgola	Client nei dati
4	1	35

TranID
ID transazione del server simultaneo da avviare dal listener.

Virgola
Una virgola (,) separa l'ID transazione dal client nei dati.

Client nei dati
35 byte di dati usati dall'uscita di sicurezza TCP/IP CICS e passati al server simultaneo nel messaggio di avvio della transazione (TIM).

Client nei dati per il formato di uscita di sicurezza Microsoft

Il blocco di codice seguente descrive il formato del client nei dati per l'uscita di sicurezza Microsoft.

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

Client nei dati per il formato IBM Security Exit

Il blocco di codice seguente descrive il formato del client nei dati per l'uscita di sicurezza IBM.

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

Client nei dati per COBOL

Il blocco di codice seguente descrive il formato del client in 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.

Client in costanti di dati per COBOL

Il blocco di codice seguente descrive le costanti per il client nei dati in 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'.

Messaggio di risposta TRM

Nella tabella seguente viene illustrato il contenuto del messaggio di risposta.

Lunghezza msg risposta TRM	Lunghezza del campo formattato	Codice di campo formattato	Dati
2	4	1	0-n

Nota

La lunghezza del campo formattato, il codice di campo formattato e i dati possono essere ripetuti più volte in un singolo messaggio.

Lunghezza msg risposta TRM
Lunghezza totale del messaggio di risposta TRM. Questa lunghezza è la somma di tutte le lunghezze dei campi formattati che seguono nel messaggio e non include la lunghezza del campo di lunghezza msg risposta TRM stesso.

Lunghezza del campo formattato
Lunghezza del campo formattato.

La lunghezza del campo formattato è la somma della combinazione della lunghezza del codice di campo formattato e della lunghezza dei dati.

Codice di campo formattato
Codice a 1 byte che descrive le informazioni passate dal server simultaneo al client.

Non è possibile modificare il codice di campo formattato.

I codici di campo sono specifici della gestione delle comunicazioni tra i trasporti WIP e HIP TCP e i programmi MSCMTICS, MSHIPLNK e TCP Concurrent Server.

Dati
0 o più byte di informazioni associate a un campo formattato specifico.

È possibile modificare le informazioni archiviate in Dati. Se si modificaNo dati, assicurarsi di modificare anche TRM Reply e Formatted Field Length (Lunghezza campo formattato) sui nuovi valori.

La lunghezza dei dati è uguale alla lunghezza del campo formattato meno le dimensioni del codice di campo formattato.

Codici normali

Nella tabella seguente viene illustrato il significato dei codici normali.

Codice	Type	Significato
0x01	Info	ID versione per il server simultaneo di Microsoft® Transaction Integrator
0x02	Info	Dati utente
0x07	Info	Esecuzione OK

Codici di errore

Nella tabella seguente viene illustrato il significato dei codici di errore.

Codice	Type	Significato
0x03	Errore	ProgID non valido
0x04	Errore	TranID non valido
0x05	Errore	Richiesta non riuscita
0x06	Errore	Stato richiesta
0x08	Errore	Programma ABEND
0x09	Errore	Esecuzione non riuscita
0x0A	Errore	TRM non valido
0x0B	Errore	Il server ha generato un'eccezione
0x0C	Errore	Le informazioni sull'errore di eccezione si trovano nel blocco di errori dei metadati

Per altre informazioni sul formato del TRM, vedere il file di definizione TRM all'indirizzo <unità>:\Programmi\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim. Usare Visual Studio per visualizzare il file.

Vedere anche

Formato TRM per il modello di programmazione collegamento TRM TCP

Condividi tramite