FILE - Edit single dump file

This control statement edits a single dump file or a single generation of a UTM dump FGG. The result of editing is written to an output file. The user can define the name of the output file by means of the OUTFILE operand or a SET-FILE-LINK command with the link name LISTFILE. If no file is specified, KDCDUMP creates a list file with the default name.

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

dumpfile	Name of the UTM dump file. This file may also belong to an FGG. If the positional operand is omitted, it is assumed that a UTM dump file has already been read in with the DUMP statement. The FILE statement is then applied to this file. In this instance, the UTM dump file is not removed from memory.
*linkname	Link name of the UTM dump file. The link name may consist of three alphanumeric characters only. On successful execution of the command, the link name is deleted from the TFT.
EDIT=	This operand controls editing: With EDIT=PRINTER (default), an output file is created which is intended for printing on the printer. The output contains feed control characters, page headers, with a maximum line length of 132 characters. The table of contents at the end of the output relates to print pages and line numbers (for the unprinted dump). The file can be printed out by means of the command: /PRINT-DOCUMENT FILE-NAME=listfile, - /     LINE-SPACING=*BY-EBCDIC-CONTROL With EDIT=TERMINAL, the output file is edited in such a way that it can be evaluated on screen using an editor. The maximum line length is 80 characters. The table of contents at the end of the output relates to line numbers.
INFO=	This operand controls output of the summary information. This is an extract of the complete dump information and contains the data frequently required for diagnosis. INFO=LONG: editing with summary information (default). INFO=DUMP: editing without summary information. INFO=SHORT: KDCDUMP outputs only summary information.
OUTFILE=	This operand allows you to specify that output is to be written to a file with the name filename. If you do not specify OUTFILE, KDCDUMP checks whether the link name LISTFILE has been assigned or assigns the default name  LST.UTMDMP.rrrrrr.ttttff.aaaaaaaa (see  "The files of the UTM dump"  for a description).

Notes

• It should be noted that a UTM dump file which was read in by means of the DUMP command is deleted in its entirety from memory when the FILE control statement is used with the positional operand.

• If a link name KDCDUMP exists when KDCDUMP is started, KDCDUMP assumes that the associated file is a UTM dump. This is then edited. KDCDUMP subsequently terminates itself automatically.

• If the dump file is read using a link name (*linkname is specified) the link name is removed from the TFT after the dump file is edited successfully.