The purpose of the -D Lines tab is
to create and describe the composition of a layout for the current
Report, especially its categories and edition lines.
Category definition
A category is defined
by its code, its type, the conditions of the Report execution and
a comment that is displayed in the list of categories with the code
of the category.
- Category identifier
- Enter the code of the category. It consists of two alphanumeric
characters from AB to ZY (ZZ is prohibited). The code value is used to differentiate categories
from one another.
- Report lines are grouped according to the conditions under which
they will be printed (totalled lines, detail lines). Leaving gaps
in the category sequence will facilitate future modifications. Categories
used for the lines containing the totals (Type of total => Total (with a break level from 1 to 9)) can
contain several total lines, cannot have a detail line, cannot be
repetitive and can contain other ordinary lines.
- Categories containing a detail line with elements to be totalled
(Type of total => editable or non-editable
detail lines on the Edition line section),
can only contain one detail line, cannot contain a total line, cannot
be repetitive and can contain other ordinary lines.
- Type
- This field is used to identify the type of category: standard,
header, repetitive or footer. Three options are presented
in the following table:
Table 1. Type of
categoryValues |
Comments |
Standard |
This is the default option. |
A: Header |
This value applies to the repetitive categories
only and indicates the first line of a top of page category (header). Headers are automatically printed at the top of each page of a Report.
They are also printed when the repetitive category lines exceed the
number of lines per page allowed for the Report, causing a new page
to be printed.
|
I: Repetitive |
This indicates the first line of a category
printed several times (repetitive category). This value causes the
generation of a subscript which controls the number of repetitions.
This number may be fixed or variable. |
Z: Footer |
This indicates the first line of an end of page
category. Footers are automatically printed when the repetitive
category lines exceed the number of lines per page allowed for that
Report.
|
- Comment
- The comments entered in this field refer to the category to be
printed. The comments are displayed with the code of the category
in the list of categories. In the Comments field, you can indicate the nature of the category: header, footer,
repetitive as an example.
- Repetition
- This field must be completed if the type of category is repetitive
so that a subscript, which controls the number of repetitions, is
generated.
- This value may be a fixed number or a variable number of repetitions:
- For a fixed number of repetitions, enter an absolute number value.
- For a variable number, enter the three-character code for use
of a subscript field, defined in the WORKING-STORAGE SECTION of the Program which calls the Report (the values are specified
in the Program -CD Lines tab) or use the standard jrrrcc Pacbase index generated for the category:
- .rrr being the Report code
- .cc being the category in the Report (iterative).
The code is required before printing.
- Condition
- This field indicates the conditions relevant for the execution
of the Report. For IF conditions, use the COBOL format but omit the
'IF'. For AND, OR... use the COBOL format. The period (full stop)
is automatically generated and therefore should not be entered.
- Preview
- Clicking the Preview button displays a
window where you can view the edition lines of the selected Category,
before printing.
The Comment and Category identifier values entered in this section are
displayed on the Category line in the -D list, just after the category
icon.
Edition Line Definition
In this section,
you modify or enter the definition of an edition line selected/created
in a category of the layout, the type of jump, the number of lines
to skip, or the absolute line number, the function to be performed
before printing, the type of lines with fields to accumulate in a
Report total, and the totalling structure Report field.
- Structure
- This field displays the structure identifier, which is the structure
code followed by the name of the label(s). The structure identifier
starts from '1' up to '99'. Each structure identifier has at least
one corresponding line on the layout. The identifiers are automatically
calculated but they can be modified. For a new edition line created,
there is no structure.
- Clicking the Change button opens a dialog
box where you can select a structure identifier already defined in
the layout. Once the structure identifier has been selected, the structure
identifier value and label(s) names are displayed on the edition line
in the -D lines list and in the structure field as a link. Clicking
the link switches to the -CE Lines tab, on the Structure Definition section.
- Clicking the Remove button deletes the
structure identifier code and label(s) calls from the structure field.
- Label identifier
- This field displays the label identifier. To modify this label,
click Change. A dialog box opens up and displays
the list of the labels already defined in the layout. Select a label
and click OK to validate your selection.
The label identifier is then displayed on the edition line in the
-D list and in the label field as a link. Clicking the link switches
to the -L Lines tab, on the Label
Definition section.
- Clicking the Remove button deletes the
label identifier call from the label field.
- Jump
- This field indicates the number of lines to skip if the line is
not the first line in the category.
- Type of jump
- In this field, you select the type of skip to be inserted before
generation. The default option is 'Line skip'. You can also insert
a page break.
- Type of totalization
- Many Reports display a series of detail lines after the header.
Some of these detail lines contain fields that are to be totalled.
Other lines contain fields that are used to display the totals. This
field, along with the Foreign total structure field, are then used to identify all these lines.
Options |
Comments |
No total |
|
* : detail editable |
This indicates a detail line containing fields
whose values are to be accumulated for totalling. The lines will be
printed in the Report. The logic for Data Elements to be totalled
is generated only if the edition conditions specified for the category
containing the detail line are met. There is a maximum of 6 such editable
lines in a Program.
|
T: detail not editable |
This indicates a detail line containing fields
whose values are to be accumulated for totalling but the line is not
to be printed in the Report.There is a maximum of 6 such non editable
lines in a Program. A category containing a detail line: - Cannot contain other detail lines,
- Cannot contain a total line,
- Can include other ordinary lines.
|
0: global total |
This option indicates that a line will display
the result of accumulated totals. |
Options from 1: total (break level 1) to 9: total (break level 9) |
Each of these options indicates a line for totalling
at the control break level corresponding to a value from 1 to 9. |
- Function to perform
- Enter the code of the function and subfunction which must be performed
before the structure number indicated on this line is processed, and
before the WRITE command. The code is four characters
long.
- The same structure number may be used in several categories. In
this case the PERFORM will take place each time
through the processing loop for that structure. It is not necessary
to enter the function or subfunction code on the first category that
uses that structure.
- A function should not be indicated more than once for the same
structure. In cases where several functions are to be performed with
the same structure, the execution sequence may be problematic.
- For the lines without a specified structure number, the function
will be performed only once, before the structures processing is completed,
and just before the WRITE command. This function
is performed according to the positioning of the associated structure
and thus to the type or condition of the category in which the structure
is called.
- Foreign total structure
- Enter the structure number on a line whose fields are to be totalled
or on a total line whose detail line is described in a another Report.
Some detail lines may be defined in a different Report: for example,
a summary Report based on accumulations from other Reports. Only the
totalled Data Elements will be printed, at the appropriate control
break level.