Task 2--Creating the Report Line Header [ HP ALLBASE/4GL Developer Self-Paced Training Guide ] MPE/iX 5.0 Documentation
HP ALLBASE/4GL Developer Self-Paced Training Guide
Task 2--Creating the Report Line Header
Before you can actually paint the report image, you must define the lines
that are used in the report. This report uses a total of eight print
lines from four of the available line groups.
Defining the Report Lines
Menu Path
1. From the main menu, select the Reports option.
2. Choose Line Header.
Screen Description
You use this screen to specify the line groups used by the report, and
define the way in which each of the print lines is handled. This screen
allows you to specify the following details for each line:
* How many blank lines to leave before or after printing.
* Whether the line is always printed.
* Which count field to use to count the number of times the line is
printed.
* The names of functions to be executed before and after each line
is printed.
Report Line Header Screen
To enter the field values:
The characteristics of each line are defined one line at a time. The
eight lines to be printed are P1.01, P1.02, C1.01, D1.01 through D1.04,
and TF.01.
Field Entry Explanation
---------------------------------------------------------------------------------------
Report Name Accept the default The name of the report for which you are
value of about to define the lines. The name in
product_rept. this field defaults to the last report name
used in any of the report development
screens. When you commit this field, HP
ALLBASE/4GL skips the secured field.
Line Group P1 The line group identifier. The P1 group is
the page header group and it specifies the
lines that HP ALLBASE/4GL prints at the
start of every new page.
Table 6-0. (cont.)
Field Entry Explanation
---------------------------------------------------------------------------------------
Line Number Accept the default of The line number specifier within the line
01. group that you just entered above. The
lines are printed on the report in
ascending numeric order. The combined
identifier of line group.line number is
known as a print line.
Action Accept the default. This action code is used in the same manner
as the other action codes, that is: A =
Add, C = Change, and D = Delete. The
action defaults to an appropriate code that
depends on whether the print line already
exists, or you are defining a new print
line.
Skip Lines/Page The next two fields determine the line
spacing used for this particular print
line.
Before Print Accept the default of This indicates that no line feed characters
0. are issued before this line is printed.
You can enter a value between 1 and 9 to
specify a number of line feeds, or you can
enter P to force a page break before this
line is printed.
After Print Accept the default of Indicates that one line feed character is
1. issued after this line is printed. You can
skip 1 to 9 lines after this line is
printed, or force a page break.
Note: The print line buffer is only
cleared after it is printed. If you
specify that a line has 0 lines skipped
after printing, the line is not printed and
the buffer contents remain intact. If the
next line printed skips 0 lines before
printing, the data is merged over the first
line and then printed.
Suppress Line If: The next two fields allow you to specify
that a line is only printed if it contains
non-blank or non-zero data.
Table 6-0. (cont.)
Field Entry Explanation
---------------------------------------------------------------------------------------
All Values are Zero Accept the default of When set to Y, this suppresses the printing
N. of a line if all the numeric fields in the
line are zero.
All Values are Blank Accept the default of When set to Y, this suppresses the printing
N. of a line if all the alphanumeric fields in
the line are blank.
Note: There are two sets of conditions for
these tests. The tests are relevant where
there are only numeric or only alphanumeric
fields on the print line. However, if the
line contains both field types, all numeric
fields must contain zeros and all
alphanumeric fields must be blank before
printing the line is suppressed.
Count Lines Printed Leave blank. Indicates which communication area *COUNT
into Counter Number field (*COUNT(1) to *COUNT(5)) is
incremented each time this particular print
line is printed. Leaving this entry blank
specifies that you don't require automatic
line counting.
Underline Numbers Leave blank. Indicates whether the numeric fields on the
print line are to be overlined (P = Prior),
underlined (A = After), or both (B = Both).
A blank entry specifies that no underlining
is done.
The underline or overline is printed on a
separate print line. This line is counted
as a regular line as the system tests to
see if a new page is necessary. The data
and its underlining or overlining always
appear on the same page as it is treated as
a single entity at print time.
Before Print Function Leave blank. The name of a function that is executed
before the print line is printed. This
function can perform data formatting, or
extract data from another source to be
included in the print line.
Table 6-0. (cont.)
Field Entry Explanation
---------------------------------------------------------------------------------------
After Print Function Leave blank. The name of a function that is executed
after the print line is printed. This
function could possibly initiate the
printing of extra lines on the report.
These extra lines could be based on the
line just printed.
Note: The functions that are executed
before or after printing a print line can
set two switches. These are the *BYPASS
and *ENDLINE switches. *BYPASS controls
the printing of each print line and
bypasses the current print line when set
on. *ENDLINE controls the line group, and
terminates the processing of the line group
when set on. This allows you to perform
more complex selection and validation of
data that is to be printed.
To complete and commit the screen:
1. Press the Commit Data function key to commit the definition of
the line group.
HP ALLBASE/4GL displays a summary of the line at the base of the
screen and then returns the cursor to the Line Number field. By
default, the system expects you to define another print line in
the same group.
2. If you want to define another line group, go back to the Line
Group field. You can now proceed to define the remaining seven
lines in this report.
To complete the remaining lines:
1. Enter the values required for each of the remaining lines of the
report. Only those fields that require an entry other than the
default are shown here.
2. Accept the default value for the other fields.
3. Press the Commit Data function key when you have completed the
details for each line.
Page Heading Line 2
Line Number 02
Skip Lines After Print 2
Column Heading Line 1
Line Group C1
Line Number 01
Detail Line 1
Line Group D1
Line Number 01
Skip Lines Before Print 1
Count Lines Printed ... 1
NOTE The total number of products included in the report is printed at
the end of the report. Each time this line is printed, *COUNT(1)
is incremented to count the number of records that have been
printed.
Detail Line 2
Line Number 02
Final Total Line 1
Line Group TF
Line Number 01
Skip Lines before Print 3
This completes the definition of the characteristics for each line. You
can now go on to paint the image of each line using the report painter.
MPE/iX 5.0 Documentation