The purpose of the -D 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 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 a two-alphanumeric characters
string from AB to ZY (ZZ is
prohibited). The code value is used to differentiate categories from one
another.
- Report lines are grouped together according to the conditions under which
they will be printed (totaled lines, detail lines...). Leaving gaps in the
category sequence will facilitate future modifications. Categories used for
the lines containing the totals (Type of totalisation=> Totalisation
(with a break level from 1 to 9)), can contain several total lines,
cannot have a detail line, cannot be repetitive, can contain other ordinary
lines.
- Categories containing a detail line with elements to be totaled (Type
of totalisation => 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, can contain other
ordinary lines.
- Type
- This field is used to identify the type of category: standard, header,
repetitive or footer.
Values |
Comments |
Standard |
This is the default option.
|
A: Header |
This value applies to 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 |
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
- Comments entered in this field refers to the category to be printed. The
comments are displayed with the code of the category in the list of categories.
You can indicates in the 'Comments' field 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 being 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' tab of the Program which calls the
Report (Values are specified in the Program 'Source' tab.) or use the standard
VisualAge Pacbase index (jrrrcc) generated for the category:
- .rrr = Report code
- .cc = Category of Report (iterative)
The code is required before printing.
- Condition
- This field indicates the conditions relevant for the execution of the
Report. Format of entry: For IF conditions, use COBOL format but omit the
'IF'. For AND, OR etc., use COBOL format. The period (full stop) is generated
automatically and therefore should not be entered.
- Preview
- Clicking the Preview button displays a window where
you can view the edition lines of the selected Caterory, before printing.
The Comment and Category
identifier value 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 prior to print, the type of lines
with fields to accumulate in a Report totalisation, and the totaling 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 being displayed on the Edition line in the -D
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. You can modify this label by
clicking on the Change... button. A dialog box opens
up and displays the list of labels already defined in the layout. Select a
label and then click on OK to validate your selection.
Then, the label identiifer is being 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 one 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', otherwise, you can insert a page break.
- Type of totalisation
- Many Reports display after the header, a series of detail lines. Some
of these detail lines contain fields that are to be totaled. Other lines contain
fields that are used to display the totals. This field with the Foreign
total structure field are then used to identify all these lines.
Options |
Comments |
No totalisation |
|
*: 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: - can contain only one detail line,
- cannot contain a total line,
- can include other ordinary lines
|
0: global totalisation |
This option indicates that a line will display the
result of accumulated totals.
|
options from 1: totalisation (break level=1) to 9:
totalisation (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 sub-function which must be performed
before the processing of the structure number indicated on this line, and
before the WRITE command. The code is four characters long.
- The same structure number may be used in several categories. In this case
thePERFORM will take place each time through the processing
loop for that structure. It is not necessary to enter the function or sub-function
code on the first category that uses that structure
- A function should not be mentioned 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 lines without a structure number specified, the function will be performed
once only, preceding the completion of processing of the structures, and just
prior to the WRITE. 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 that has fields to be totalled or
on a 'totalisation' line, which has a detail line 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 may be needed. Only the totalled
Data Elements will be printed, at the designed control break level.