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.
The
categories used for the lines containing the totals (
Type
of total =>
Total (with a break level from 1 to
9)) have the following characteristics:
- They cannot have a detail line
- They can contain several total lines
- They cannot be repetitive
- They can contain other ordinary lines
- The categories containing a detail line with elements to be totalled
(Type of total => editable or non-editable
detail lines on the Edition line section)
have the following characteristics,
- They can contain one detail line only
- They cannot contain a total line
- They cannot be repetitive
- They 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 can 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 that are relevant for the
execution of the Report. For IF conditions, you must use the COBOL
format but omit the IF. For other conditions
(such as AND or OR), you must use the COBOL format. The dot is automatically
generated and therefore should not be entered.
- Preview
- Clicking Preview displays a window where
you can view the edition lines of the selected category, before printing.
The Comment and Category
identifier values that you enter 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 that is selected
or reated in a category of the layout.
- Structure
- This field displays the structure identifier, which is the structure
code followed by the name of the labels. The structure identifier
ranges from 1 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. When the structure identifier is selected, the structure
identifier value and label 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 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,
is then used to identify all these lines.
Table 2. Possible values
for the type of totalizationOptions |
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 has the following
characteristics: - It cannot contain other detail lines,
- It cannot contain a total line,
- It 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 another Report.
Some detail lines can 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.