This statement defines the page layout of the output file.
The SET-PAGE-LAYOUT statement can be omitted if FILE=*SYSOUT or FILE=*SYSLST has been specified in the ASSIGN-OUTPUT-FILE statement or if a SET-GROUP-ATTRIBUTES statement has been specified. In this case, processing is carried out in accordance with the default values (see "Editing records and blocks ").
If several SET-PAGE-LAYOUT statements in a conversion step refer to the same link name, only the last statement specified is executed for this link name.
The following lines are not taken into account when editing an output for SYSOUT:
header lines (irrespective of the specification in the HEADER-LINE operand)
blank lines
user lines (irrespective of the specification in the USER-LINE operand).
Any control characters X ́00 ́ thru X ́3F ́ contained in an output record to be edited will be replaced. This can be suppressed by means of the REPLACE-CONTROL-CHAR operand, for instance if printer control characters are inserted by the user.
SET-PAGE-LAYOUT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OUTPUT-LINK-NAME =
Link names of the output files to which this statement is to refer.
OUTPUT-LINK-NAME = *STD
This statement refers to all output files specified up to now.
OUTPUT-LINK-NAME = list-poss(2000): <filename 1..8 without-gen>
If the statement is to reference only certain output files, the link names of these files must be specified.
HEADER-LINE =
Specifies which header line is output for a page.
HEADER-LINE = *STD
File copying: HEADER-LINE = *PAGE-COUNTERTape editing: HEADER-LINE = *TITLE
HEADER-LINE = *NONE
PERCON does not output a header line.
HEADER-LINE = *PAGE-COUNTER
The text PAGE xxxxxx is inserted in line 1, column 119, of each page. xxxxxx is the current status of the page counter.
|
|
|
|
|
|
HEADER-LINE = *TITLE
PERCON outputs a standard header line in the first line.
OUTPUT-AREA =
This operand uses FIRST-LINE and LAST-LINE to define the start and end of a line range per print page to which PERCON outputs the output records. Several such lines can be defined per print page.
This operand can be used to overwrite the header line.
OUTPUT-AREA = *LINE-RANGE(...)
Defines the line range.
FIRST-LINE = 5 / <integer 1..112>
Specifies the start line for data output.
LAST-LINE = 66 / <integer 1..112>
Specifies the end line for data output.
SPACING = 0 / <integer 0..3>
Specifies the number of blank lines output after every print line.
OUTPUT-FORMAT =
Specifies the output format of the data to be output.
OUTPUT-FORMAT = *STD
File copying: OUTPUT-FORMAT = *CHARACTERTape editing: OUTPUT-FORMAT = *BOTH
OUTPUT-FORMAT =*CHARACTER
Outputs data in the form of characters. Nonprintable characters are only represented as blanks if REPLACE-CONTROL-CHAR=*YES applies and none of the tables of printable characters supplied by XHCS is available.
OUTPUT-FORMAT = *HEXADECIMAL
Outputs data in hexadecimal format.
OUTPUT-FORMAT = *BOTH
Data is output in hexadecimal format. Printable characters are additionally output in a second line above the corresponding hexadecimal codes. Nonprintable characters are only represented as blanks if REPLACE-CONTROL-CHAR=*YES applies and none of the tables of printable characters supplied by XHCS is available. Therefore 2 data lines are occupied by each output record (or each part of it if it is longer than the line, see the LINE-SIZE operand).
LINE-SIZE = *STD / <integer 1..204>
Number of characters in the record to be edited that are to be output per line. This enables an output record to be distributed over several lines. The length of an output line is determined not only by the LINE-SIZE operand, but also by the COLUMN-SIZE and OUTPUT-FORMAT operands.
If the records to be edited are variable in format, the record length field is also part of the data to be output.
In addition, a leader is inserted at the start of each line; its length depends on the selected output medium and the selected function, as shown in the following table.
Function | Output file | |
SYSLST, cataloged file | SYSOUT | |
File copying | No leader | 9 characters |
Tape editing | 21 characters | 9 characters |
COLUMN-SIZE = *LINE-SIZE / <integer 1..204>
Defines the number of characters of the output record which are to belong to one group and are to be separated from the next group by means of blanks.
COLUMN-SIZE = *LINE-SIZE
There is no subdivision into groups.
SUPPRESS-EQUAL-LINES =
Influences the printing of lines of a record with identical contents. The last line of an edited record is always printed out, irrespective of the assignment of the SUPPRESS-EQUAL-LINES parameter.
SUPPRESS-EQUAL-LINES = *YES
If two or more identical lines occur consecutively, the repeat line is printed only once. The message
’xxxxxx IDENTICAL LINES SUPPRESSED’,
appears in the next line, where “xxxxxx” is the number of lines with identical contents.
SUPPRESS-EQUAL-LINES = *NO
All lines are output, even duplicated ones.
REPLACE-CONTROL-CHAR =
Determines how printer control characters are to be handled.
REPLACE-CONTROL-CHAR = *YES
Any control characters X ́00 ́ thru X ́3F ́ in the output records are replaced by blanks if either the XHCS is not active, or XHCS is active but the output file has no CCSN.
If XHCS is active and the output file has a CCSN, the XHCS table of printable characters for this CCS is used for the replacement.
REPLACE-CONTROL-CHAR = *NO
The output records contain characters that are not to be replaced.
No check is performed as to whether there are any nonprintable characters. No character replacement is performed.
USER-LINE =
Outputs keywords and literals at specific positions on the page. The header line and line range defined by the OUTPUT-AREA operand may be overwritten.
USER-LINE = *NONE
No user lines are output.
USER-LINE = *RECORD-LENGTH(...)
LINK-NAME = <filename 1..8 without-gen>
Specifies the link name of the input/output file or of the input tape whose current record length is to be used in the user line.
This is represented as an 8-digit number.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the record length is written.
OUTPUT-COLUMN = <integer 1..197>
Specifies the position where the output file begins, relative to the beginning of the user line.
OUTPUT-LENGTH = *STD / <integer 1..32>
Length of the output field. The default value *STD is 8.
USER-LINE = *BLOCK-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Specifies the link name of the input tape whose current block counter value is to be used in the user line. This is represented as an 8-digit decimal number.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the value of the block counter is written.
OUTPUT-COLUMN = <integer 1..197>
Specifies the position where the output field begins, relative to the beginning of the user line.
OUTPUT-LENGTH = *STD / <integer 1..32>
Length of the output field. The default value *STD is 8.
USER-LINE = *BYTE-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Specifies the link name of the input/output file or of the input tape whose current byte counter value is to be used in the user line.This is represented as a 10-digit decimal number.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the value of the byte counter is written.
OUTPUT-COLUMN = <integer 1..195>
Specifies the position where the output field begins, relative to the beginning of the user line.
OUTPUT-LENGTH = *STD / <integer 1..32>
Length of the output field. The default value *STD is 10.
USER-LINE = *RECORD-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Specifies the link name of the input/output file whose current record value is to be written in the user line.
This is represented as an 8-digit decimal number.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the value of the record counter is written.
OUTPUT-COLUMN = <integer 1..197>
Specifies the position where the output field begins, relative to the beginning of the user line.
OUTPUT-LENGTH = *STD / <integer 1..32>
Length of the output field. The default value *STD is 8.
USER-LINE = *PAGE-COUNTER(...)
LINK-NAME = <filename 1..8 without-gen>
Specifies the link name of the output file whose current page counter value is to be used in the user line.
This is represented as a 6-digit decimal number.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the page number is written.
OUTPUT-COLUMN = <integer 1..199>
Specifies the number of the line to which the page number is written.
OUTPUT-LENGTH = *STD / <integer 1..32>
Length of the output field. The default value *STD is 6.
USER-LINE = *DATE(...)
Specifies the start date of the PERCON conversion step as an 8-digit string in the form yy-mm-dd.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the date is written.
OUTPUT-COLUMN = <integer 1..197>
Specifies the position where the output field begins, relative to the beginning of the user line.
CENTURY = *NO / *YES
If CENTURY=*YES is specified, the date is output as a 10-digit character string with the century specified in the format yyyy-mm-dd. This reduces the maximum value for OUTPUT-COLUMN by 2.
USER-LINE = *TIME(...)
Specifies the start time of the PERCON conversion step as an 8-digit string in the form hh:mm:ss.
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the time is written.
OUTPUT-COLUMN = <integer 1..197>
Specifies the position where the output field begins, relative to the beginning of the user line.
USER-LINE =<c-string 1..204 with-low>
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the character constant is written.
OUTPUT-COLUMN = <integer 1..204>
Specifies the position where the output field begins, relative to the beginning of the user line.
USER-LINE =<x-string 1..408>(...)
OUTPUT-LINE = <integer 1..112>
Specifies the number of the line to which the character constant is written.
OUTPUT-COLUMN = <integer 1..204>
Specifies the position where the output field begins, relative to the beginning of the user line.