Formato ELM per il modello di programmazione dati utente ELM TCP

Articolo
10/14/2023

Questa sezione descrive il formato e il contenuto del messaggio ELM (Enhanced Listener Message) usato dal modello di programmazione TCP ELM User Data.

Messaggio di richiesta ELM

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

Client nei dati
35

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;

Messaggio di risposta ELM

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

Lunghezza msg risposta ELM	Lunghezza del campo formattato	Codice di campo formattato	Dati
4	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 ELM
Lunghezza totale del messaggio di risposta ELM. Questa lunghezza corrisponde alla somma di tutte le lunghezze dei campi formattati che seguono nel messaggio e non include la lunghezza del campo lunghezza msg risposta ELM 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	ELM non valido

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

Vedere anche

Formato ELM per il modello di programmazione collegamento ELM TCP
Amministrazione CICS listener avanzato

Condividi tramite