HP 3000 Manuals

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