FGG - Edit all files of an FGG

The FGG statement serves to edit all the files of an FGG jointly in a single output file. The name of the output file is specified with the OUTFILE operand. In command mode, the user is free to issue any number of FGG commands.

FGG	{fgg-name| *linkprefix }  [,EDIT = { PRINTER | TERMINAL } ]  [,INFO = { LONG | DUMP | SHORT } ]  [,OUTFILE = filename ]

fgg-name	Name of a file generation group (FGG) which contains the UTM dump. openUTM creates a separate file generation for each task in the application.
*linkprefix	Link name prefix of the files which originate from a dump FGG, but exist only as individual files. The prefix may consist of a maximum of three alphanumeric characters only. The actual link name has the format linkprefix.number, where number is a decimal number comprising a maximum of four digits, without leading zeros, commencing with '1', '2',... etc.. On successful execution of a command, all link names are 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

• When the FGG control statement is entered, a UTM dump file which was read in by means of the DUMP command is removed in its entirety from memory. Consequently, the UTM dump under examination prior to the FGG command will no longer be available for diagnostic purposes.

• The individual file generations of the FGG are read consecutively and removed from memory again after processing, so that after execution of this command none of the files remains in memory.

• If the dump files are read in by means of link names (*linkprefix is specified), then after each successful editing operation performed on a dump file the associated link name is removed from the TFT.

Example

• You want to edit all files of a dump FGG using the KDCDUMP command FGG:
  FGG DUMP.UTM.LKLC64.885301.ANW1,EDIT=T

• You want to edit files of a former UTM dump FGG, which only exist as four single files.

  To do this, assign a link name to the four files having the prefix UD1:

  /SET-FILE-LINK LINK-NAME=UD1.1,FILE-NAME=DUMP.UTM.PCMM01.1
  /SET-FILE-LINK LINK-NAME=UD1.2,FILE-NAME=DUMP.UTM.WAITT2.2
  /SET-FILE-LINK LINK-NAME=UD1.3,FILE-NAME=DUMP.UTM.WAITT2.3
  /SET-FILE-LINK LINK-NAME=UD1.4,FILE-NAME=DUMP.UTM.WAITT2.4 
  

  These four files are edited by means of a single KDCDUMP command:

  FGG *UD1