The REPORT statement is the first statement coded in a report declaration. This statement establishes the type and characteristics of the report. Only the REPORT statement parameters requiring special consideration when using extended reporting are shown here.
Syntax REPORT [report-name] + . . . [LABELS ([ACROSS literal-3] +
[DOWN literal-4] + [SIZE literal-5] + [NEWPAGE ]) ] + . . . [PRINTER file-name-3] + [PAGESIZE literal-6 ] + [LINESIZE literal-7 ] + [SKIP literal-8 ] + [SPACE literal-9 ] + [TITLESKIP literal-10] . . . Format Determination Parameters [SIZE literal-5]
SIZE is a subparameter of the LABELS parameter and sets the length of each label. The value of literal-5 is the number of print positions on a label. Literal-5 has a range from 1 to 'nnn', where 'nnn' is the length of the label.
File Directing Parameters [PRINTER file-name-3]
The optional PRINTER parameter directs the report's printed output. File-name-3 identifies the FILE that receives the report. This file must have the PRINTER or EXTENDED attribute specified. The default is the CA-Easytrieve/Plus system print output file: SYSPRINT for OS/390, SYSLST for VSE.
If the system print output file or file-name-3 has been associated with an extended reporting printer, then CA-Easytrieve/Plus automatically formats the report to satisfy the requirements defined for that extended reporting printer. CA-Easytrieve/Plus restricts the support of extended reporting facilities to those reports that are output to printer files that have been associated with an extended reporting printer.
Spacing Control Parameters [PAGESIZE literal-6]
The PAGESIZE option establishes the length of each printed page. The value of literal-6 sets the number of lines per page. Literal-6 has a valid range of 1 to 'nnn', where 'nnn' is at least as large as the sum of:
■ 'nnn' of the last 'TITLE nnn' ■ Literal-10 of TITLESKIP
■ Number of HEADING lines plus one ■ 'nnn' of the last 'LINE nnn'
■ Literal-8 of SKIP.
In other words, at least one line group must fit on a report page.
When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), then CA-Easytrieve/Plus multiplies the PAGESIZE value by the default height of the assigned extended reporting printer. This permits CA-Easytrieve/Plus to compare PAGESIZE with the heights of fonts used on the report as they are both in the same base unit -- the H-unit.
The value of literal-6 multiplied by the default height of the assigned extended reporting printer cannot exceed the maximum page length of that extended reporting printer.
[LINESIZE literal-7]
The LINESIZE option determines the length of each line on a page. Literal-7 is the number of print positions on each report line. The value of literal-7 must be 1 to 'nnn' where 'nnn' is one less than the physical length (record size) of the printer file receiving the report. The first character in a PRINTER file contains the ASA carriage control information.
When the report is assigned to an extended reporting printer that is not a standard Line Printer, the maximum value of LINESIZE is not dependent upon the record size of the print data set. The insertion of Overprint and Function Codes into print records plus the support of different fonts on the same print line all impact the relationship between LINESIZE and print data set record size. CA-Easytrieve/Plus supports any LINESIZE provided literal-7 multiplied by the value of the assigned extended reporting printers default width does not exceed the maximum page width of that extended reporting printer.
Literal-7 overrides the value defined in the CA-Easytrieve/Plus systems options module. If the report is directed to an extended reporting printer,
CA-Easytrieve/Plus multiplies the LINESIZE value by the default width of the assigned extended reporting printer. This value defines the width of the print line in terms of the extended reporting printer's W-unit.
[SKIP literal-8]
The SKIP option determines the number of blank lines to be inserted between line groups (between 'LINE nnn' and the next 'LINE 01'). Literal-8 has a valid range of 0 to 'nnn', where 'nnn' permits the printing of at least one line group on each page. If you specify a value of 0, a line group containing multiple lines can be spanned across a page break. A nonzero value inhibits this spanning. When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), the default height of the assigned extended reporting printer defines the height of each line.
[SPACE literal-9]
The SPACE option adjusts the default number of blanks (space characters) inserted between fields on TITLE and LINE statement items. The value of literal-9 has a valid range of 0 to 'nnn' (default is 3), where 'nnn' does not cause a line overflow. The SPREAD option overrides this parameter.
When the report is directed to an extended reporting printer,
CA-Easytrieve/Plus multiplies the SPACE factor by the default width of the assigned extended reporting printer. This operation expresses the SPACE factor in terms of the printer's W-unit.
[TITLESKIP literal-10]
The TITLESKIP option inserts blank lines between the last title line and the first heading line (or LINE 01) of a report. The value of literal-10 has a valid range of 0 to 'nnn', where 'nnn' permits the printing of at least one line group on each page. When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), the height of each line is defined by the default height of the assigned extended reporting printer. This operation converts the number of lines into the H-units applicable to the printer.