SHOW-FORMATTED-FILE Show formatted file

Privileges:          STD-PROCESSING

Function

The SHOW-FORMATTED-FILE statement enables you to show information contained in a formatted file in a structured way.

The advantage of a formatted file is that the output information from a number of SHOW statements can be collected in a file. The formatted file can then be output.

For example, a user specifies the SHOW-INSTALLATION-UNITS INSTALLATION-ITEMS=*YES statement with output to a formatted file. The result file is specified as an input and output file in another SHOW statement in order to show the installation items. The formatted file generated from this contains all the information about installation units and installation items. The contents of the formatted file can be output to SYSLST using the SHOW-FORMATTED-FILE statement.

Format

SHOW-FORMATTED-FILE

FROM-FILE = <filename1..54 without-gen-vers>
,OUTPUT = *SYSLST(...)
	*SYSLST(...)
		|	SYSLST-NUMBER = *STD / <integer 1..99>

Operands

FROM-FILE = <filename 1..54 without-gen-vers>
Name of the formatted file.

OUTPUT =
The target for output.

OUTPUT = *SYSLST(...)
Output the information to SYSLST.

SYSLST-NUMBER =
SYSLST number.

SYSLST-NUMBER = *STD
Output the information to standard SYSLST.

SYSLST-NUMBER = <integer 1..99>
Specifies the SYSLST number.

Notes

1. The statement is rejected without action and an error message is displayed if the input file does not exist or cannot be accessed.

2. The statement is aborted and a message is displayed if a format error occurs.

3. If the information in the SCI changes after the formatted file is generated, the information that is output is no longer current.