FILE - Einzelne Dump-Datei aufbereiten

Mit dieser Steueranweisung wird eine einzelne Dump-Datei oder eine einzelne Generation einer UTM-Dump-FGG aufbereitet. Das Ergebnis der Aufbereitung wird in eine Ausgabedatei geschrieben. Der Name der Ausgabedatei wird mit dem Operanden OUTFILE bzw. durch ein SET-FILE-LINK-Kommando des Anwenders mit dem Linknamen LISTFILE festgelegt. Bei fehlender Angabe erzeugt KDCDUMP eine Listdatei mit einem Standardnamen.

FILE	[{ dumpfile | *linkname }] [,EDIT={ PRINTER | TERMINAL }] [,INFO= { LONG | DUMP | SHORT }] [,OUTFILE = filename ]

dumpfile	Name der UTM-Dump-Datei. Diese Datei kann auch einer FGG angehören. Fehlt der Stellungsoperand, so wird vorausgesetzt, dass eine UTM-Dump-Datei mit der DUMP-Anweisung schon eingelesen worden ist. Auf diese wird dann die FILE-Anweisung angewandt. Die UTM-Dump-Datei wird dabei nicht aus dem Speicher entfernt.
*linkname	Linkname der UTM-Dump-Datei. Der Linkname darf nur aus maximal drei alphanumerischen Zeichen bestehen.
EDIT=	Dieser Operand steuert die Aufbereitung: Bei EDIT=PRINTER (Standard) wird eine Ausgabedatei erzeugt, die zum Ausdruck bestimmt ist. Die Ausgabe enthält Vorschubsteuerzeichen, Seitenköpfe und maximal 132 Zeichen pro Zeile. Das Inhaltsverzeichnis am Ende der Ausgabe bezieht sich auf Druckseiten und Zeilennummern (für den nicht ausgedruckten Dump). Die Datei lässt sich ausdrucken mit dem Kommando: /PRINT-DOCUMENT FILE-NAME=listfile, - /   LINE-SPACING=*BY-EBCDIC-CONTROL Bei EDIT=TERMINAL wird die Ausgabedatei so aufbereitet, dass man sie mit einem Editor am Bildschirm auswerten kann. Die Zeilen enthalten maximal 80 Zeichen. Das Inhaltsverzeichnis am Ende der Ausgabe bezieht sich auf Zeilennummern.
INFO=	Dieser Operand steuert die Ausgabe der SUMMARY-Information. Sie ist ein Extrakt der gesamten Dump-Information und enthält die Daten, die bei der Diagnose häufig benötigt werden. INFO=LONG: Aufbereitung mit Summary-Information (Standard). INFO=DUMP: Aufbereitung ohne Summary-Information. INFO=SHORT: KDCDUMP gibt nur Summary-Information aus.
OUTFILE=	Mit diesem Operanden können Sie festlegen, dass die Ausgabe in eine Datei mit dem Namen filename geschrieben werden soll. Ist OUTFILE nicht angegeben,  prüft KDCDUMP, ob der Linkname LISTFILE vergeben ist. Falls nicht, vergibt KDCDUMP den Standardnamen LST.UTMDMP.rrrrrr.ttttff.aaaaaaaa (Erläuterung siehe "Die Dateien des UTM-Dumps").

Hinweise

• Es ist zu beachten, dass eine UTM-Dump-Datei, die mit dem Kommando DUMP eingelesen worden ist, vollständig aus dem Speicher gelöscht wird, wenn die FILE-Steueranweisung mit dem Stellungsoperanden genutzt wird.

• Existiert beim Start von KDCDUMP ein Linkname KDCDUMP, so nimmt der KDCDUMP an, dass die zugehörige Datei ein UTM-Dump ist. Dieser wird dann aufbereitet. Danach beendet sich der KDCDUMP automatisch.

• Wird die Dump-Datei mittels Linknamen eingelesen (Angabe von *linkname), so wird nach der erfolgreichen Aufbereitung der Dump-Datei der Linkname aus der TFT entfernt.