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.

	       Click here to view figure.
          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