Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Abschnitt werden das Format und der Inhalt der vom TCP TRM-Programmiermodell verwendeten Transaktionsanforderungsnachricht (TRM) beschrieben.
TRM-Anforderungsnachricht
Die folgende Tabelle zeigt den Inhalt der Anforderungsnachricht.
| TranID | Komma | Client in Daten |
|---|---|---|
| 4 | 1 | 35 |
TranID
Transaktions-ID des gleichzeitigen Servers, der vom Listener gestartet werden soll.
Komma
Ein Komma (,) trennt die Transaktions-ID vom Client in Daten.
Client in Daten
35 Byte von Daten, die vom CICS TCP/IP-Sicherheitsende verwendet und an den gleichzeitigen Server in der Transaktionsinitiierungsnachricht (TIM) übergeben wurden.
Client in Daten für das Microsoft Security Exit-Format
Der folgende Codeblock beschreibt das Format des Clients in Daten für den Microsoft-Sicherheitsausgang.
struct CLIENT_IN_DATA {
BYTE bUserID[8];
BYTE bPassword[8];
BYTE bReserved[19];
} UNALIGNED;
Client in Daten für das IBM Security Exit-Format
Der folgende Codeblock beschreibt das Format des Clients in Daten für den IBM-Sicherheitsausgang.
struct CLIENT_IN_DATA2 {
BYTE bSecFlag;
BYTE bPassword[8];
BYTE bUserID[8];
BYTE bReserved[18];
} 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'.
TRM-Antwortnachricht
Die folgende Tabelle zeigt den Inhalt der Antwortnachricht.
| LÄNGE der TRM-Antwort msg | Formatierte Feldlänge | Formatierte Feldfunktion | Daten |
|---|---|---|---|
| 2 | 4 | 1 | 0-n |
Hinweis
Die formatierte Feldlänge, formatierte Feldfunktion und Daten können in einer einzelnen Nachricht mehrmals wiederholt werden.
LÄNGE der TRM-Antwort msg
Die Gesamtlänge der TRM-Antwortnachricht. Diese Länge ist die Summe aller Längen der formatierten Felder, die in der Nachricht folgen, und enthält nicht die Länge des Längenfelds der TRM-Antwort msg selbst.
Formatierte Feldlänge
Die Länge des formatierten Felds.
Die formatierte Feldlänge ist die Summe der Kombination aus der Länge der formatierten Feldfunktion und der Datenlänge.
Formatierte Feldfunktion
Ein 1-Byte-Code, der die vom gleichzeitigen Server übergebenen Informationen zurück an den Client beschreibt.
Sie können die formatierte Feldfunktion nicht ändern.
Die Feldfunktionen sind spezifisch für die Kommunikation zwischen wiP- und HIP TCP-Transporten und den MSCMTICS-, MSHIPLNK- und TCP-Gleichzeitigen Server-Programmen.
Daten
0 oder mehr Bytes von Informationen, die einem bestimmten formatierten Feld zugeordnet sind.
Sie können die in Den Daten gespeicherten Informationen ändern. Wenn Sie Daten ändern, stellen Sie sicher, dass Sie auch die TRM-Antwort und die formatierte Feldlänge in die neuen Werte ändern.
Die Länge der Daten entspricht der formatierten Feldlänge minus der Größe der formatierten Feldfunktion.
Normale Codes
Die folgende Tabelle zeigt die Bedeutung der normalen Codes.
| Code | Typ | Bedeutung |
|---|---|---|
| 0x01 | Info | Versions-ID für Microsoft® Transaction Integrator Gleichzeitiger Server |
| 0x02 | Info | Benutzerdaten |
| 0x07 | Info | Ausführung OK |
Fehlercodes
Die folgende Tabelle zeigt die Bedeutung der Fehlercodes.
| Code | Typ | Bedeutung |
|---|---|---|
| 0x03 | Fehler | Ungültige ProgID |
| 0x04 | Fehler | Ungültige TranID |
| 0x05 | Fehler | Anfrage fehlgeschlagen |
| 0x06 | Fehler | Anfragestatus |
| 0x08 | Fehler | Programm ABEND |
| 0x09 | Fehler | Ausführung fehlgeschlagen |
| 0x0A | Fehler | Ungültiges TRM |
| 0x0B | Fehler | Vom Server wurde eine Ausnahme generiert. |
| 0x0C | Fehler | Ausnahmefehlerinformationen befinden sich im Metadatenfehlerblock |
Weitere Informationen zum Format des TRM finden Sie in der TRM-Definitionsdatei unter <drive>:\Program Files\ Microsoft Host IntegrationServer\System\TIM\MicrosoftTRMDefs.tim. Verwenden Sie Visual Studio, um die Datei anzuzeigen.