Reporting Facility Commands › REPORT Command

REPORT Command

(Area 4A)

The REPORT command identifies each report to be generated within the Reporting Facility run and assigns optional user heading lines to appear at the top of each page of the report.

The format of the REPORT command is as follows:

►►─ REPORT ─┬──────────────┬─┬──────────────────────┬─────────────────────────►◄
            └─ 'literal1' ─┘ └───┬─ fieldname ──┬───┘
                                 ├─ 'literaln' ─┤
                                 └─ n1 ─────────┘

'literal1'

Is a character string, enclosed in apostrophes, that is to appear on each page of the report being defined. This literal centers automatically and prints on the line immediately following the USER lines. The CURRENT-DATE and PAGE NUMBER fields print on the left and right of this literal, respectively.

fieldname

Specifies a predefined field to be printed on the optional third heading line for the report.

'literaln'

Is a character string, enclosed in apostrophes, that is to appear on the optional third line of the heading for the report.

n1

Specifies the number of spaces to appear between a field name or a literal on the optional third heading line for the report. This parameter must be a positive integer and can be interspersed between any field name or literal. If not specified, the system assumes single spacing between a field name or literal.

Note the following:

• The REPORT command is the first command in a report definition group. You can define up to 63 unique report groups in a single processing run.
• The CURRENT-DATE field to be printed on the second heading line has the format MM/DD/YY, DD/MM/YY, or DD MMM YY, depending on the option selected during the installation of the Reporting Facility.
• The CURRENT-DATE and PAGE NUMBER fields print in specific locations within the second heading line and you cannot alter their contents.
• The total length of either the second or third heading lines cannot exceed the printer width currently in force.
• When the contents of fields are to print on the optional third heading line, you can also use the SKIP or NEWPAGE parameters on the CONTROL command to ensure proper printing.

The basic format of a report and a description of each line printed follows:

Line   ┌─────────────────────────────────────────────────────────────┐

  1                          User Heading
  2     DATE                Report Heading               PAGE nnn
  3     Third Heading Line
  4    ├─────────────────────────────────────────────────────────────┤

  5     Column
  6             Headings
  7    ├─────────────────────────────────────────────────────────────┤

  8     Detail Line 1
  9     Detail Line 2
  .
  .
  .
  n     Detail Line n
       └─────────────────────────────────────────────────────────────┘

Line 1

Contains the concatenated literal specified on the command, centered within the current printer width.

Line 2

Contains the CURRENT-DATE field, the first literal from the REPORT command, and the PAGE NUMBER field. The literal centers within the current printer width.

Line 3

Contains the optional third heading line from the REPORT command. The fields, literals, or spacing values do not center automatically.

Lines 4 and 7

Are generated automatically by the system and serve to separate the report headings from the detail column headings.

Lines 5 and 6

Represent the column headings of the fields to be in the report as specified on the PRINT command.

Lines 8—n

Represent the detail lines to be printed as specified on the PRINT command. Detail lines print until the maximum page depth is reached, then new headings are forced.