HP 3000 Manuals

HP ALLBASE/BRW Reference Manual

BRWSTARTREQUEST 

Call BRWSTARTREQUEST like this: 

BRWSTARTREQUEST (REQUEST_COMAREA, parm_defaults)

This intrinsic starts the BRWSTART program.

REQUEST_COMAREA 

REQUEST_COMAREA is a 100-byte array with the following structure:
_____________________________________________
|                                           |
|        return_status   :   2 byte integer;|
|        error_parm      :   2 byte integer;|
|        comarea_len     :   2 byte integer;|
|        exec_filename   :  36 bytes;       |
|        start_screen    :   2 byte integer;|
|        listf_id        :   8 bytes;       |
|        listf_group     :   8 bytes;       |
|        process_info    :  40 bytes.       |
|                                           |
_____________________________________________

            

You must set the following items from the parameter REQUEST_COMAREA
before calling BRWSTARTREQUEST (the structure of REQUEST_COMAREA is
described under BRWINITREQUEST):

comarea_len:  set to 100 

exec_filename:  Report or report job file name. 

Set to the name of the report or report job file to be loaded when using
the Request Report screen.  This item is required to use the Online
Review screen, otherwise you can leave it blank.

start_screen:  0, 1 or 2 

Use the start_screen item to choose the first screen you want to display.
Various screens can be called depending on the start_screen value.  For
example:

     start_screen = 0

With the value set at 0, the Request Report screen is called first.  You
can then go to the Online Review screen.

     start_screen = 1

With the value set at 1, the Select Report screen is called first.  You
can then go to either the Request Report Screen or the Online Review
screen directly.  (You can also go to the Online Review screen from the
Request Report Screen).

     start_screen = 2

With the value set at 2, the Online Review screen is called first.  No
other screens can be called from the Online Review screen.

The illustration below shows the start_screen parameter and where you
enter the HP ALLBASE/BRW screens for each parameter value.


            

listf_id:  file or fileset name 

Set to the file designator of the reports to be listed if the first
screen is the Select Report screen.

listf_group:  group or groupset name 

Set to the group designator of the Reports to be listed if the first
screen is the Select Report screen.

process_info:  set by prior call to BRWINITREQUEST. 

PARM_DEFAULTS 

PARM_DEFAULTS is an integer array parameter.

The array structure is:
________________________________________________________________________
|                                                                      |
|     nbr_parms   :   2 byte integer;                                  |
|Then, for each parameter                                              |
|                                                                      |
|        parm_name      :  20 bytes;                                   |
|        default_value  :  55 bytes;                                   |
|        filler         :   1 byte;                                    |
________________________________________________________________________

            

The array size is calculated using the formula below.

     No. of bytes = (max number of parameters * 76) + 2

nbr_parms           an integer specifying the number of parameter
                    descriptions

parm_name           a byte array holding the parameter name

default_value       a byte array holding the value of the parameter

filler              not used

PARM_DEFAULTS allows the calling program to inform HP ALLBASE/BRW about
the defaults to be used for certain selections (for example, for
selection on ACTUAL-PERIOD or DIVISION). If the actual report does not
contain all of these parameters, any superfluous parameters are ignored.


NOTE  See REFRESHING THE TERMINAL earlier in this chapter for information
      on how to refresh your terminal after calling BRWSTARTREQUEST.

MPE/iX 5.0 Documentation