REPORT statement

The REPORT statement defines the type and characteristics of a report. Multiple reports can be specified per single JOB Activity Section. REPORT statement with its parameters is placed at the end of each JOB Activity Section. It also must be followed by the SEQUENCE, CONTROL, SUM, HEADING, TITLE, and LINE statements as described on the pages that follow.

Syntax

Read syntax diagramSkip visual syntax diagramREPORT&REPORTSUMMARYSUMFILE&SUMFILESUMSPACE3SUMSPACE&SUMSPACETALLYSIZE5TALLYSIZE&TALLYSIZEDTLCTLEVERYFIRSTNONESUMCTLALLHIARNONETAGDTLCOPYDTLCOPYALLFILE&WFILEPRINTER&PRINTERLABELS(ACROSS&ACROSSDOWN&DOWNSIZE&SIZENEWPAGE)PAGESIZE5666LINESIZE132PAGESIZE(&PAGESIZE&DSPLSIZE)LINESIZE&LINESIZESKIP&SKIPSPACE&SPACETITLESKIP2TITLESKIP&TITLESKIPCONTROLSKIP1CONTROLSKIP&CONTROLSKIPSPREADNOSPREADNOADJUSTNODATENOPATENOHEADINGLIMIT&LIMITEVERY&EVERYSHORTDATELONGDATEUSING(&EXITPGM,, &USINGPARAM1)
Notes:
  • 1 1–4 parameters can be passed to the exit program.

Special considerations

Migration Utility uses print control characters (CC) to compensate for the blank lines. Easytrieve Plus prints the blank lines.

This is especially noticed in the report's detail body.

Migration Utility's way is much more efficient as it saves on the number of I/Os.

If you were to print a hard copy, the reports would be the same.

Migration Utility does provide an option to print blank lines. Refer to the EZPARAMS PRINTIO=(,,,,NOEXPCC) option for further details.

Parameters

&REPORT
Report name. Easytrieve allows a name of up to 128 characters. Because of COBOL restrictions, Migration Utility assigns its own internal name for each declared report. However, you reference the name as declared. The internal naming conventions are REPORTNN, where NN is report sequence number relative to zero.
SUMMARY
Prints a summary report by minor control break. The detail report is not printed.
&SUMFILE
A one to eight character Optional Summary File name for recording Control Break field values and summary totals. All data is as of minor control break.
&SUMSPACE
The number of digits to be added to the size of the summary field buckets. This is needed to prevent overflow on accumulated values.
&TALLYSIZE
The size of the TALLY field. Valid values are 1 to 18 (digits).
DTLCTL
Indicates the printing method of control fields on detail line. Possible values are:
EVERY
Prints value of all control fields on every detail line.
FIRST
Prints value of all control fields on the first detail line of each page, and on the first detail line after each control break. Printing of control field values is inhibited on all other detail lines.
NONE
Inhibits printing of control fields on every detail line
SUMCTL
Indicates printing method of control fields on total lines. Possible values are:
ALL
Prints control field values on every total line
HIAR
Prints control field values in the hierarchical fashion on the total lines. Only values of control fields on the same hierarchical level, or higher than the breaking control field, are printed on the related total line.
NONE
Inhibits printing of control fields on total lines.
TAG
Prints &FIELD TOTAL annotation next to the totals. Keep in mind that there must be enough space, for the totals literal. &FIELD is the field name that caused the break.
DTLCOPY
Prints detailed information about minor level total lines.
DTLCOPYALL
Prints detailed information on all control breaks. (This option is not supported by Migration Utility)
&WFILE
Work file ddname. This statement is ignored by Migration Utility.
&PRINTER
Printer file ddname. Normally Easytrieve directs all reports to the SYSPRINT. This statement lets you redirect output to a designated file. Make sure you define the file in the Library Section.

When a printer file is not specified, the report is written to a file specified by the PRINTER= EASYTRAN/EZPARAMS option. For example, when PRINTER=SYSPRINT is in effect, the report is written to SYSPRINT, when PRINTER=AUTOGEN is in effect, an internal printer file is generated, when PRINTER=REPORT0 is in effect, the report is written to the REPORT0 file.

Note that Migration Utility Version 1 always defaulted to PRINTER=AUTOGEN. There was no override.

LABELS
Identifies mailing label printing. Possible values are:
&ACROSS
A number indicating the number of labels printed across the page
&DOWN
Specifies the number of print lines for each label
&LSIZE
Specifies the horizontal length of each label
NEWPAGE
Forces start of page (channel 1) for first label line

The NOHEADING and NOADJUST options are automatically activated for LABELS type of reports. You cannot use TITLE, HEADING and SUMMARY when you print labels.

&PAGESIZE
The number of lines per logical printed page. It can be 1 to 32767 and it must be at least as large as the sum of:
  • Number of the TITLE Lines
  • Number of TITLESKIP
  • Number of HEADING lines plus 1
  • Number of LINE statements
  • Number of lines of SKIP
&DSPLSIZE
Number of lines for each logical page for DISPLAY statements in report exits. If not coded, the default is the &PAGESIZE (if supplied), or as coded in the EASYDTAB default table.
&LINESIZE
The length of the printed line from 1 to 32767. One extra character is added, by the compiler, for print carriage control.
&SKIP
The number of blank lines to insert between line groups, that is, before the last printed LINE NN and the first LINE 01.
&SPACE
The default number of spaces (blank characters) between print fields. Note that the amount of space that each field occupies is the field (edited) length or the field Title, whichever is longer. The SPREAD parameter overrides this option.
&TITLESKIP
The number of blank lines between the last TITLE line and the first HEADING line. The default is 2 lines.
&CONTROLSKIP
The number of blank lines between the last total line and the first detail line (detail line post totals).
SPREAD
Insert maximum number of spaces between fields (columns).
NOSPREAD
Deactivates the SPREAD option.
NOADJUST
Deactivates automatic centering of report TITLES and LINES. When specified, all printed lines are left justified on the page. NOADJUST and SPREAD are mutually exclusive.
NODATE
Inhibits printing of System Date (CPU date) on the first title line.
NOPAGE
Inhibits printing of the Page Number (PAGE nnnnn) on the first title line.
NOHEADING
Inhibits printing of the column (field) headings. If this option is not specified, column headings are automatically printed.
&LIMIT
The maximum number of lines to print. This is a development option.
&EVERY
Every &EVERYth line is to be printed. This is a development option.
SHORTDATE
The SYSDATE date format is to be used.
LONGDATE
The SYSDATE-LONG date format is to be used.
&EXITPGM
Print I/O exit program name. This program is responsible for performing printer file I/O.
&USINGPARAM
Parameter to be passed to the exit program. Can be a literal or a field name.

See File I/O exits for non-MODIFY exit program coding conventions.