HP 3000 Manuals

HP ALLBASE/4GL Developer Reference Manual Vol. 1

Report Header Screen 

The report header screen allows you to define the name of a report.  It
also allows you to define the primary file for the report, the name of
the output file designator, the report destination, the type of
stationery, the parameters for the printed output, and the names of any
start and end of report functions.

Screen Image 


            

Field Descriptions 

Report Name   Enter the name of the report (up to 16 characters).

Secured   To protect this report definition from unauthorized
modification, enter Y after you have completed the report definition.
Otherwise, enter N. The entry in this field defaults to N.

If you enter Y, the report can only be modified by a developer who has
signed on to the application under the correct development security code.

Report File Designator   Enter the MPE/iX name (up to six characters) of
the formal file designator to which the formatted report is to be sent.

Any options specified in a file equation override the corresponding
options supplied by HP ALLBASE/4GL. This table lists the options that HP
ALLBASE/4GL sets, if they are not overridden in a file equation.

Option            Comment 

COPIES            Report header, number of copies field

DEV               Default value is "LP"

FORMS             Report header, type of stationery field if not
                  "Standard"

By using a file equation, you can override these defaults.  The following
examples show the use of file equations.

     FILE MYREPT=PAYSLIPS;DEV=LASER,12,3

This file equation passes the report written to the formal file
designator MYREPT to the MPE/iX spooler with the name PAYSLIPS. Three
copies of the report are printed on the device class LASER with an output
priority of 12.

     FILE MYREPT;DEV=DISC

This file equation writes the report to a disk file MYREPT. Any existing
file MYREPT will be overwritten.  The disk file will have embedded
carriage control codes so it could be spooled later if required.

Primary File [.Record].    Enter the HP ALLBASE/4GL name of the
application data file to be reported.  If a serial data file, KSAM data
file, or HP TurboIMAGE/iX data set uses more than one record layout, you
can specify the required record layout.  The report generator uses the
default record layout for a data file or data set if you don't enter a
record layout name.  The report generator reads records from this file
for selection and sorting.  (You can specify other files for report
linkages or for use from within functions.)

Index   The entry in this field defaults to 1, specifying that the report
generator uses the primary index for reading the file.

If you want to use a different index to read the file, enter the index
number in this field.

Printer   Enter F to have the report written to the formal file
designator named in the Report File Designator field.  Any options
specified in a file equation override the corresponding setting on the
report header screen.  This enables the end user to customize some of the
report parameters at run time.

Enter L to print the report on a slave printer attached to the terminal,
or enter D to display the report on the terminal screen.  (If you want to
display a report on the terminal screen, use a line length of 80
characters or less.)

If you display a report on the terminal, set the physical page length to
22 lines so each page will fit on the screen.  When HP ALLBASE/4GL
displays a report on the screen, the display pauses at the end of each
page.  Pressing Return displays the next page.

Type of Stationery   Enter the stationery type for the report (up to 12
characters).

If the value in this field is other than the default value "Standard", HP
ALLBASE/4GL opens the file with the option FORMS=stationery, where
stationery is the value entered in this field.  If a FORMS option is
specified in a file equation, this field has no effect.

Number of Copies   Enter a number in the range 0 to 99 specifying the
number of copies of the report to be printed.  This field defaults to 1
and is only applicable if the output is directed to a formal file
designator or a slave printer.

HP ALLBASE/4GL opens the file with a COPIES=number option, where number 
is the value entered in this field.  If a COPIES option is specified in a
file equation, this field has no effect.

Characters per Line   Enter the maximum number of characters that can be
printed on a report line.  (From 70 to 255.)

Actual Page Size in Lines   Enter the number of lines per page.  The
default is 66 (11 inch deep paper at 6 lines per inch).

Print Lines Used per Page   Enter the maximum number of lines actually
printed on each page.  Don't include the B1 (bottom of page) line group
in this figure.  If you define a B1 line group, it is printed after this
maximum number of lines have been printed.

The default is 60.

Formfeed Skip to Next Page   If you enter Y, the report generator uses a
page feed command to skip to a new page.  The default is Y.

If you enter N, the report generator uses the physical page length and
skips the appropriate number of lines to start the next page.  Typically,
you would use this option with special paper with a page length other
than 66 lines.

Start of Report Function Name   Enter the name of a function to be
executed before the report is executed.  The function can execute a
screen to obtain report selection values from the end user.  If the
function executes a process, the report is terminated.  The function
cannot contain a REPORT logic command.

End of Report Function Name   Enter the name of a function to be executed
after the report has completed.  The function cannot contain a REPORT
logic command.

Description   Documentation fields.  Enter a description of the report
for documentation purposes.  HP ALLBASE/4GL automatically updates the
date and time fields to show the date and time of the last modification.

Function Keys 

f1       Sorting  Cancels the current screen and displays the report
        sorting screen.

f2       Record Select  Cancels the current screen and displays the
        selection criteria screen.

f3       Line Header  Cancels the current screen and displays the report
        line header screen.

f4       Generate Report  Generates the report.

Additional Information 

You must define each report with this screen before you complete any of
the other reports definition screens.

Report Stationery.     

The report generator allows you to specify the type of stationery to be
used for a report.  This allows you to specify special stationery for
printing invoices or other special reports.

If the stationery name specified differs from the default stationery name
"Standard", HP ALLBASE/4GL opens the output file with FORMS=stationery,
where stationery is the value entered in the stationery field.  A FORMS
specifier in a file equation always overrides the setting made from HP
ALLBASE/4GL.

When the MPE/iX spooler is ready to print a file with a FORMS specifier,
it displays a message on the system console requesting the system
operator to load the required stationery.

If the report is written to a disk file using the formal file designator,
the stationery specification is ignored.


NOTE  HP ALLBASE/4GL is case sensitive with respect to stationery names.

MPE/iX 5.0 Documentation