Die Dateien des UTM-Dumps

Die Dump-Dateien stehen in dem Dateiverzeichnis filebase/DUMP bzw. filebase\dump.Dabei ist filebase der Basisname der KDCFILE in der MAX-Anweisung.

Wird der Dump durch einen Fehler im UTM-Systemcode verursacht (System-Dump), wird eine Dateigenerationsgruppe (FGG) eingerichtet (siehe unten).

Ansonsten hat der Name der Dump-Datei die Form

reason.pid.no

Dabei bedeuten

reason	Kennzeichen für die Ursache des Speicherabzugs (6 Zeichen).
pid	die Prozessnummer des Prozesses, unter der der Dump erzeugt wurde.
no	bedeutet eine laufende Nummer für die Dumps, die ein Prozess einer Anwendung erzeugt, wenn die Dump-Dateien nicht als Dateigenerationsgruppe (FGG) eingerichtet sind; oder hexadezimaler Wert des Zählers für die Anzahl Kaltstarts der Anwendung, wenn die Dump-Dateien als FGG-Dateien eingerichtet sind.

Bei einem System-Dump wird eine Dateigenerationsgruppe (FGG) im Dateiverzeichnis reason.pid.no eingerichtet. Laufen in der Anwendung mehrere Workprozesse, dann wird je Workprozess eine Dump-Datei eingerichtet. Die FGG hat die Form:

/INFO	(Verwaltungsdatei der FGG)
/0001	(erste Dump-Datei)
/0002	(zweite Dump-Datei usw., vergleiche USLOG-FGG)
...

Der UTM-Dump wird unterdrückt, wenn die UTM-Anwendung mit TESTMODE=OFF gestartet wurde und ein PEND ER mit einem der nachfolgend aufgeführten KCRCDC-Codes auftritt.

FH01, K301, K302, K345, K601, K602, K603, K608,
KM01, KM02, KM03, KM04, KM05, KM07, KM08, 
KR01, KR02,
KT01, KT02, KT04,
KU14

In diesen Fällen unterbleibt auch das Beenden und Neustarten des Workprozesses, d.h. der Workprozess arbeitet weiter für die UTM-Anwendung.

Wenn für den aktuellen TAC PGWT-Aufrufe erlaubt sind und wenn der Aufruf, bei dem der Fehler auftrat, kein PEND-Aufruf war, dann wird das Programm nachgeladen. Beim KCRCDC-Code K316 wird unabhängig vom Test-Modus kein UTM-Dump geschrieben.

Reduzierung der Dump-Information über Startparameter DUMP-CONTENT

Über den Startparameter DUMP-CONTENT können Sie einstellen, ob openUTM die Dump-Information reduzieren soll oder nicht. Reduzieren heißt, dass Prozess-übergreifende Speicherbereiche (Shared Memories) nur im Dump des Workprozesses enthalten sind, der den Anwendungsabbruch verursacht hat.Durch die Reduzierung der Dump-Information benötigen die Diagnoseunterlagen bei einem Anwendungsabbruch erheblich weniger Platz. Die Reduzierung der Dump-Information ist als Standard eingestellt. Sie kann durch den Startparameter DUMP-CONTENT bei Bedarf ausgeschaltet und wieder eingeschaltet werden.

Syntax des Startparameters:

.UTM START DUMP-CONTENT={ STANDARD | EXTENDED }

STANDARD	Wenn UTM eine Dump-Dateigeneration erzeugt, dann sind  Prozess-übergreifende Speicherbereiche nur im Dump des ersten Prozesses (Verursacher) enthalten. Für die Diagnose ist das normalerweise ausreichend. STANDARD ist voreingestellt.
EXTENDED	Die Prozess-übergreifenden Speicherbereiche sind in allen Dumps einer Dump-Dateigeneration enthalten. Diesen Wert sollten Sie nur auf besondere Anforderung des Software Supports einstellen.