Condividi tramite


Formato TRM per il modello di programmazione dati utente TRM TCP

Questa sezione descrive il formato e il contenuto del messaggio di richiesta di transazione (TRM) usato dal modello di programmazione dati utente 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    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 nelle costanti 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 campo formattato Data
2 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.

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 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
0x0B Error Il server ha generato un'eccezione
0x0C Error Le informazioni sull'errore di eccezione si trovano nel blocco degli errori dei metadati

Per altre informazioni sul formato del TRM, vedere il file di definizione TRM in <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 dei collegamenti TCP TRM