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.
In the -D Lines tab, you enter the
characteristics of categories and edition lines. You can enter the
information in the Category definition and Edition
Line Definition sections for each line inserted in the
table or you can enter the information directly in the table. Some
of the fields in the table offer values in a list. When you move your
cursor on a value of the list, the label associated with the value
is displayed in a tooltip.
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 contain only 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 that 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 display 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
- Complete this field 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 that 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 you enter in this section display 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 selected, the structure
identifier value and label(s) names display 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 then displays 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 comprises
four characters.
- 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.