ELM-Format für das TCP ELM-Programmiermodell für Benutzerdaten

Artikel
07/21/2023

Dieser Abschnitt beschreibt das Format und den Inhalt der erweiterten Listenernachricht (Enhanced Listener Message, ELM), die vom TCP ELM-Benutzerdaten-Programmiermodell verwendet wird.

ELM-Anforderungsnachricht

Die folgende Tabelle zeigt den Inhalt der Anforderungsnachricht.

Client in data
35

Client in data
35 Bytes an Daten, die vom CICS-TCP/IP-Sicherheitsausstieg verwendet und in der Transaktionsinitiierungsnachricht (TIM) an die Concurrent Server-Instanz übergeben werden.

Format von „Client in data“ für den Microsoft-Sicherheitsausstieg

Der folgende Codeblock beschreibt das Format von „Client in data“ für den Microsoft-Sicherheitsausstieg.

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

Format von „Client in data“ für den IBM-Sicherheitsausstieg

Der folgende Codeblock beschreibt das Format von „Client in data“ für den IBM-Sicherheitsausstieg.

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

ELM-Antwortnachricht

Die folgende Tabelle zeigt den Inhalt der Antwortnachricht.

ELM reply msg length	Formatted field length	Formatted field code	Data
4	4	1	0-n

Hinweis

Die Länge des formatierten Felds, der Code des formatierten Felds und die Daten können in einer einzigen Nachricht mehrmals wiederholt werden.

ELM reply msg length
Die Gesamtlänge der ELM-Antwortnachricht. Diese Länge ist die Summe aller Längen der formatierten Felder, die in der Nachricht folgen. Die Feldlänge der ELM-Antwortnachricht selbst ist darin nicht enthalten.

Formatted field length
Die Länge des formatierten Felds.

Die Länge des formatierten Felds ist die Summe der Codelänge des formatierten Felds und der Datenlänge.

Formatted field code
Ein 1-Byte-Code zur Beschreibung der Informationen, die von der Concurrent Server-Instanz zurück an den Client übergeben werden.

Sie können den Code des formatierten Felds nicht ändern.

Die Feldcodes gelten speziell für die Kommunikationsverarbeitung zwischen den TCP-Transporten WIP und HIP und den Programmen MSCMTICS, MSHIPLNK und TCP Concurrent Server.

Data
0 oder mehr Bytes an Informationen, die einem bestimmten formatierten Feld zugeordnet sind.

Sie können die in „Data“ gespeicherten Informationen ändern. Wenn Sie „Data“ ändern, stellen Sie sicher, dass Sie auch die TRM-Antwort und die Länge des formatierten Felds in die neuen Werte ändern.

Die Länge von „Data“ entspricht der Länge des formatierten Felds abzüglich des Codeumfangs des formatierten Felds.

Normale Codes

In der folgenden Tabelle wird die Bedeutung der normalen Codes erläutert.

Code	type	Bedeutung
0x01	Info	Versions-ID für Microsoft Transaction Integrator Concurrent Server
0x02	Info	Benutzerdaten
0x07	Info	Ausführung OK

Fehlercodes

In der folgenden Tabelle wird die Bedeutung der Fehlercodes erläutert.

Code	type	Bedeutung
0x03	Fehler	Ungültige ProgID
0x04	Fehler	Ungültige TranID
0x05	Fehler	Abfragefehler
0x06	Fehler	Abfragestatus
0x08	Fehler	Programmabsturz (ABEND)
0x09	Fehler	Ausführungsfehler
0x0A	Fehler	Ungültige ELM

Weitere Informationen zum Format des TRM finden Sie in der TRM-Definitionsdatei unter <laufwerk>:\Programme\ Microsoft Host Integration Server\System\TIM\MicrosoftTRMDefs.tim. Verwenden Sie Visual Studio zum Anzeigen der Datei.

Weitere Informationen

ELM-Format für das TCP ELM-Programmiermodell für Links
Erweiterte Verwaltung von CICS-Listenern

Freigeben über