openUTM dokumentiert eingetretene Ereignisse in taskspezifischen Trace-Bereichen, die zyklisch beschrieben werden. Dabei werden auch Aufträge an das Datenbanksystem dokumentiert. Für UDS/SQL ist inbesondere das Feld ’Secondary DB Trace Information’ relevant. Dort legt UDS/SQL Daten über den einzelnen Auftrag ab, die Sie zur Analyse von Abläufen und zur Diagnose von Fehlersituationen nutzen können. Diese Informationen sind aber teilweise nur mit anderen Diagnoseunterlagen (z. B. Dump) nutzbar, da die zugrunde liegenden Datenfelder nur UDS/SQL-intern genutzt werden. Insofern ist die Interpretation der Felder nur in Verbindung mit der zugrunde liegenden Version von UDS/SQL möglich.
Das Feld ’Secondary DB Trace Information’ ist 32 byte lang. Bei openUTM Versionen bis einschließlich V5.2 ist es Bestandteil eines Trace-Satzes der sogenannten DB-DIAGAREA, bei openUTM Versionen ab V5.3 ist es im DB-Record der UTM-DIAGAREA enthalten (siehe openUTM-Handbuch „Meldungen, Test und Diagnose (BS2000)“, DB-DIAGAREA bzw. UTM-DIAGAREA).
Die 'Secondary DB Trace Information' von UDS/SQL ist wie folgt aufgebaut:
Byte | Bedeutung | |
1-4 | Version | |
5-6 | Art des Auftrags | |
CB | COBOL-DML | |
CD | CALL-DML (inkl. KDBS-Auftrag) | |
CN | Konnektierung | |
DC | Diskonnektierung | |
FN | Transaktionsbeendigung | |
PA | Übergabe von Startparametern | |
PB | Besonderer Auftrag des COBOL Laufzeitsystems | |
RB | Taskfortsetzung einer offenen TA | |
SB | Taskunterbrechung bei offener TA | |
SQ | SQL-Auftrag | |
ST | Status-Anfrage von openUTM | |
7 | openUTM-Opcode 1 | |
8 | openUTM-Opcode 2 | |
9-32 | Unterschiedliche Bedeutungen in Abhängigkeit der in Byte 1-6 definierten Version und Art des Auftrags, siehe folgende Tabellen. | |
Tabelle 8: Aufbau des Feldes ’Secondary DB Trace Information’
In den folgenden Tabellen werden die Bedeutungen der Bytes 9-32 des Feldes ’Secondary DB Trace Information’ für die unterschiedlichen Versionen und Auftragsarten aufgeführt.
Byte 1-6: U01 CB
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13 | DML-Auftragskennzeichen 1 im BIB |
14 | DML-Auftragskennzeichen 2 im BIB |
15 | dynamisch vergebene UDS/SQL-interne Nummer der in der DML angesprochenen Satzart bei BIBs alter Art |
16 | dynamisch vergebene UDS/SQL-interne Nummer von in der DML genutztem Set bzw. Realm bei BIBs alter Art |
17-19 | Status-Code der abgewickelten DML |
20 | Kennzeichen, ob der in Byte 17-19 ausgewiesene Status-code mit dem in der BIB an den Anwender übergebenen übereinstimmt (’O’) oder nicht (’B’) |
21 | dynamisch vergebene UDS/SQL-interne Datenbank-Id |
22 | dynamisch vergebene UDS/SQL-interne Datenbank-Id in der Remote-Konfiguration |
23-26 | dynamisch vergebene UDS/SQL-interne Subschema-Referenz |
27-32 | Subschema-Name |
Byte 1-6: U02 CB
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13 | DML-Auftragskennzeichen 1 im BIB |
14 | DML-Auftragskennzeichen 2 im BIB |
15-16 | dynamisch vergebene UDS/SQL-interne Nummer der in der DML angesprochenen Satzart bei BIBs neuer Art |
17-19 | Status-Code der abgewickelten DML |
20 | Kennzeichen, ob der in Byte 17-19 ausgewiesene Status-code mit dem in der BIB an den Anwender übergebenen übereinstimmt (’O’) oder nicht (’B’) |
21 | dynamisch vergebene UDS/SQL-interne Datenbank-ID |
22 | dynamisch vergebene UDS/SQL-interne Datenbank-ID in der Remote-Konfiguration |
23-26 | dynamisch vergebene UDS/SQL-interne Subschema-Referenz |
27-32 | Subschema-Name |
Byte 1-6: U01 CD
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13 | DML-Auftragskennzeichen 1 im intern erzeugten BIB |
14 | DML-Auftragskennzeichen 2 im intern erzeugten BIB |
15 | dynamisch vergebene UDS/SQL-interne Nummer der in der DML angesprochenen Satzart bei BIBs alter Art |
16 | dynamisch vergebene UDS/SQL-interne Nummer von in der DML genutztem Set bzw. Realm bei BIBs neuer Art |
17-19 | Status-Code der abgewickelten DML |
20 | Kennzeichen, ob der in Byte 17-19 ausgewiesene Status-code mit dem in der BIB an den Anwender übergebenen übereinstimmt (’O’) oder nicht (’B’) |
21 | Kennzeichen, ob ein KDBS-Auftrag vorliegt |
22 | dynamisch vergebenes UDS/SQL-internes Datenbankkennzeichen |
23-28 | Subschema-Name |
Byte 1-6: U02 CD
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13 | DML-Auftragskennzeichen 1 im intern erzeugten BIB |
14 | DML-Auftragskennzeichen 2 im intern erzeugten BIB |
15-16 | dynamisch vergebene UDS/SQL-interne Nummer der in der DML angesprochenen Satzart bei BIBs neuer Art |
17-19 | Status-Code der abgewickelten DML |
20 | Kennzeichen, ob der in Byte 17-19 ausgewiesene Status-code mit dem in der BIB an den Anwender übergebenen übereinstimmt (’O’) oder nicht (’B’) |
21 | Kennzeichen, ob ein KDBS-Auftrag vorliegt |
22 | dynamisch vergebenes UDS/SQL-internes Datenbankkennzeichen |
23-28 | Subschema-Name |
Byte 1-6: U01 CN
Byte | Bedeutung |
13-20 | Name der UDS/SQL-Konfiguration |
21-24 | Returncode des ENAMP-SVC zum Anschluss an den CUP |
Byte 1-6: U01 DC
Byte | Bedeutung |
13-20 | Name der UDS/SQL-Konfiguration |
Byte 1-6: U01 FN
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
Byte 1-6: U01 PA
Byte | Bedeutung |
9-32 | 24 Byte der von openUTM übergebenen Startparameter |
Byte 1-6: U01 PB
Byte | Bedeutung |
9-32 | keine Zusatzinformation |
Byte 1-6: U01 RB
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
19-20 | Anzahl der offenen und wiederherzustellenden Verarbeitungsketten |
Byte 1-6: U03 RB
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions_ID |
13-15 | UDS/SQL-interne Zustandsanzeigen der Session, des letzten Auftrags in der Transaktion und der wiederherzustellenden Verarbeitungskette |
17-18 | UDS/SQL-interne Nummer der wiederherzustellenden Verarbeitungskette |
19-20 | Anzahl der offenen Verarbeitungsketten |
21-24 | Lage der wiederherzustellenden BIB im Communication-Pool |
27-32 | Subschemaname |
Byte 1-6: U01 SB
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13-16 | Anzahl der offenen Verarbeitungsketten und damit Anzahl der zu sichernden BIBs |
Byte 1-6: U01 SQ
Byte | Bedeutung |
9-12 | dynamisch vergebene UDS/SQL-interne Transaktions-ID |
13-16 | dynamisch vergebene UDS/SQL-interne ID des SQL-Vorgangs |
17-20 | SQL-Returncode des SQL-Auftrags |
21-24 | SQL-Returncode der 2. Schicht des SQL-Auftrags (operation) |
25 | interner SQL-Auftragscode |
27-28 | interner SQL-Fehlercode des Connections |
29-30 | interner Modul-Code des Connections bei Fehlern |
31-32 | modulinterne Fehlernummer |
Byte 1-6: U01 ST
Byte | Bedeutung |
13-16 | UDS/SQL-interne RLOG-ID bzgl. der die Statusanfrage erfolgt |
17-20 | Session Section Nr bzgl. der die Statusanfrage erfolgt |
21-22 | modulinterne Fehlercodes |