Freigeben über


TRM-Format für das TCP TRM-Programmiermodell für Links

In diesem Thema werden das Format und der Inhalt der Transaktionsanforderungsnachricht (TRM) beschrieben, die vom TCP TRM-Programmiermodell für Links verwendet wird.

TRM-Anforderungsnachricht

Die folgende Tabelle zeigt den Inhalt der Anforderungsnachricht.

TranID Komma Client in data
4 1 35

TranID
Transaktions-ID der Concurrent Server-Instanz, die vom Listener gestartet werden soll.

Komma
Ein Komma (,) trennt die Transaktions-ID von „Client in data“.

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    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;  

TRM-Antwortnachricht

Die folgende Tabelle zeigt den Inhalt der Antwortnachricht.

TRM 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.

TRM reply msg length
Die Gesamtlänge der TRM-Antwortnachricht. Diese Länge ist die Summe aller Längen der formatierten Felder, die in der Nachricht folgen. Die Feldlänge der TRM-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 TRM

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