Condividi tramite


Formato TRM per il modello di programmazione dei collegamenti TCP TRM

In questo argomento viene descritto il formato e il contenuto del messaggio di richiesta di transazione (TRM) usato dal modello di programmazione di collegamento TRM TCP.

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 della 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    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[9];  
} 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    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[8];  
} UNALIGNED;  

Messaggio di risposta TRM

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

Lunghezza msg risposta TRM Lunghezza del campo formattato Codice campo formattato Data
4 4 1 0-n

Annotazioni

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 campo formattato
Codice a 1 byte che descrive le informazioni passate dal server simultaneo al client.

Non è possibile modificare il codice del 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.

Data
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 la risposta TRM e la lunghezza del campo formattato sui nuovi valori.

La lunghezza di Data è 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 Tipo Meaning
0x01 Informazioni ID versione per il server simultaneo di Microsoft® Transaction Integrator
0x02 Informazioni Dati utente
0x07 Informazioni Esecuzione OK

Codici di errore

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

Codice Tipo Meaning
0x03 Error ProgID non valido
0x04 Error TranID non valido
0x05 Error Richiesta non riuscita
0x06 Error Stato richiesta
0x08 Error Programma ABEND
0x09 Error Esecuzione non riuscita
0x0A Error TRM non valido

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

Vedere anche