ELM-Format für das TCP ELM-Programmiermodell für Links
In diesem Abschnitt werden das Format und der Inhalt der erweiterten Listenernachricht (ELM) beschrieben, die vom TCP ELM Link-Programmiermodell verwendet wird.
ELM-Anforderungsnachricht
Die folgende Tabelle zeigt den Inhalt der Anforderungsnachricht.
| Client in data |
|---|
| 35 |
Client in data
35 Byte an Daten, die vom TCP/IP-Sicherheitsausgang von CICS verwendet und an den Concurrent Server in der Tim-Metadatendatei (Transaction Integrator) ü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 bLinkToName[8];
USHORT usCommareaLen;
BYTE bReserved[9];
} 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 bLinkToName[8];
USHORT usCommareaLen;
BYTE bReserved[8];
} UNALIGNED;
Client in Daten für COBOL
Der folgende Codeblock beschreibt das Format des Clients 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 Datenkonstanten für COBOL
Der folgende Codeblock beschreibt die Konstanten für den Client in Daten 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'.
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.
Daten
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 Benutzerdaten