HP 3000 Manuals

HP ALLBASE/BRW Reference Manual

Global Functions 

Global functions are very similar to table and layout functions but are
defined for use by more than one report.

The Global Function screen and the Global Function Formula screen are
used to define Global Functions in the BRWSETUP program.

For information on proper function syntax for the formula, refer to the
Syntax Diagrams in Chapter 15.

Global Functions Screen 

Use this screen to define a calculation that you want to use in several
reports.  Get the this screen by choosing Global Functions on the Global
Values screen.


            

To add a new function 

   1.  Type the name of the Function, the Result Type, the Function
       Argument, and the Type.

   2.  Choose Add Function.

   3.  Choose Define Formula to go to the Global Function Formula screen.
       See the Global Function Formula Screen section of this chapter for
       details on using this screen.

To copy a function 

   1.  Type the name of the new function and press the CLEAR DSPLY key on
       the terminal keyboard.

   2.  Choose Add Function.

   3.  When the system prompts, type the name of the function you want to
       copy.

   4.  Press Enter.  The function and its formulas are copied.

To modify a function 

   1.  Use Next/Prev Function key to access the function you want to
       modify.  You can also use QUICK BROWSE to access a function.  See
       Chapter 1 for details about the QUICK BROWSE feature.

   2.  Make the required changes to the function.

   3.  Press Enter.

To delete a function 

   1.  Use Next/Prev Function key to access the function you want to
       delete.  You can also use QUICK BROWSE to access a function.

   2.  Choose Delete Function.

   3.  Press Enter or choose Delete Function to confirm the deletion.

To rename a function 

   1.  Use Next/Prev Function key to access the function you want to
       rename.  You can also use QUICK BROWSE to access a function.

   2.  Type the new name over the old function name.

   3.  Make any required changes to the function definition and press
       Enter.

   4.  Press Enter to confirm the rename.

Field Descriptions 

Function 

The name of the function.

Result Type 

One of the codes listed for Result Type.

Arguments 

The formal names of the function arguments.  Use these names within the
function formula.  Actual values for the arguments must be provided when
the function is called.

Type 

Type of each argument.  Use the codes listed on the screen.

Soft Keys 

Add Function 

Adds a new function.

Delete Function 

Deletes the current function.

Define Formula 

Displays the Global Function Formula screen.

Prev/Next Function 

These keys bring the previous or next function information to the screen.

Global Function Formula Screen 

Use this screen to define a global function formula.  Get to the screen
by chooseing Define Formula on the Global Values screen.


            

Use this screen to define a formula for a global function.

To define a formula 

   1.  Type the calculation formula.

              Leave blanks around any operators in the formula.

              You can use all terminal editing and arrow keys when
              entering and editing a formula.

              Use Prev/Next Page terminal keys to define the next page of
              the formula.

   2.  Press Enter.

          a.  The system checks the formula for correctness.

          b.  If the system detects an error, the part of the formula
              with the error is highlighted.  Correct the error and press
              Enter again.  Or, press Exit Save to save the formula as-is
              for later correction.

Mail Values Screen 

Use this screen to define default specifications for HP BRW-Desk/XL. Get
to this screen by choosing Mail Values on the Global Values screen.


            

Note that this is only used if you have BRW-Desk/XL. You must specify a
global sender name and desk address.  Other global values most likely to
be needed are the maximum number of deliverable pages and the maximum
number of records for files.  You can also decide whether you want to
always print a delivery audit trail or not.  See Chapter 13 for more
information about HP BRW-Desk/XL.

   1.  Type the sender name and desk address in the Sender Name/Address
       field.

   2.  Type a password, if necessary, for the sender.

   3.  To change the default specifications, type the desired value in
       the appropriate fields.  See the field descriptions on the next
       page.

   4.  Press Enter.

Field Descriptions 

Sender Name/Address 

This is the HPDESK user name/address that is used when signing on to
HPDESK. This address is not validated at specification time.  You can
specify up to 9 different senders, and a minimum of 1 sender is required.
HP BRW-Desk/XL will use this pool of senders to do the sign on to HPDESK.
If it cannot sign on with the first sender, the next sender will be used
until the sign on is successful or until the configured number of senders
is exceeded.

Password 

Optional.  This is the password of the user signing on.  Note that HPDESK
passwords are case-sensitive; that is, if the password is PeTeR, and you
supply PETER in the Password field, HPDESK will not let HP BRW-Desk/XL
log on.

These passwords are encrypted in the configuration file.

Maximum Number of Deliverable Pages  

Optional.  This option allows the user to place a limit on the size of
the message that can be sent to HPDESK. This limit is counted in report
pages.  If a message exceeds this limit, the message will not be
submitted to HPDESK and the delivery audit trail will show that fact.
The default is the maximum size of an item permitted in the HPDESK
system.

Maximum Number of Records for Files  

Optional.  Use this field to set the maximum number of records for output
files that can be generated and sent via HP BRW-Desk/XL. If the number is
exceeded, the HP ALLBASE/BRW execution program (BRWEXEC) will abort.  The
default is the maximum size of an item permitted in the HPDESK system.

Print Delivery Audit Trail 

Optional.  Blank out the X in this field if you do not want to print the
delivery audit trail messages (a record of the mailing process that is
generated whenever a report using HP BRW-Desk/XL is run).  The default is
an X in this field:  that is, to print the delivery audit trail.

MPE/iX 5.0 Documentation