Formato ELM per il modello di programmazione collegamento ELM TCP

Questa sezione descrive il formato e il contenuto del messaggio di listener avanzato (ELM) usato dal modello di programmazione TCP ELM Link.

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 file dei metadati dell'integratore di transazioni (TIM).

Client nei dati per il formato di uscita dalla sicurezza Microsoft

Il blocco di codice seguente descrive il formato del client nei dati per l'uscita dalla 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 ibm Security Exit format

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

struct CLIENT_IN_DATA2 {  
   BYTE    bSecFlag;  
   BYTE    bPassword[8];  
   BYTE    bUserID[8];  
   BYTE    bLinkToName[8];  
   USHORT  usCommareaLen;  
   BYTE    bReserved[8];  
} 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 ELM

La tabella seguente mostra il contenuto del messaggio di risposta.

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

Nota

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

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

Lunghezza del campo formattato
Lunghezza del campo formattato.

La lunghezza del campo formattato è la somma della combinazione della lunghezza del codice del 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 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 nei dati. Se si modificano i dati, assicurarsi di modificare anche la risposta TRM e la lunghezza del 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 Microsoft® Transaction Integrator Concurrent Server
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'unità<>:\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 dati utente ELM TCP

Amministrazione CICS listener avanzato