HP 3000 Manuals

HP ALLBASE/BRW Reference Manual

BRWINITREQUEST 

Call BRWINITREQUEST like this: 

BRWINITREQUEST (REQUEST_COMAREA)

This intrinsic initializes the common area (REQUEST_COMAREA) prior to the
first call to BRWSTARTREQUEST. You must set the parameter item
comarea_len to 100 before calling BRWSTARTREQUEST.

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.       |
_____________________________________________

            

Each item of the parameter REQUEST_COMAREA is discussed in detail below.

return_status :  2 bytes; 

Integer to which the intrinsic status is returned.  It is set to 0 if the
call is successful, or to a non-zero value if an error occurs; possible
return_status values are described in the section titled Error Handling.

error_parm :  2 bytes; 

If an error occurs, this integer contains additional error information;
possible error-parm values are described in the section titled Error
Handling.

comarea_len :  2 bytes.  (Set to 100); 

You must set comarea_len to 100 before calling BRWINITREQUEST.
Comarea_len is an integer containing the length in bytes of the allocated
area (that is, the REQUEST_COMAREA parameter) that can be used by the HP
ALLBASE/BRW Request Report intrinsics.

exec_filename :  36 bytes; 

Byte array containing the name of the Report or the report job file.

start_screen :  2 bytes; 

Integer that indicates whether the BRWSTART program should begin with the
Select Report Screen, the Request Report Screen or the Online Review
Screen.

        0 = start with Request Report
        1 = start with Select Report
        2 = start with Online Review

listf_id :  8 bytes; 

Byte array containing a string pattern for the file designator.  That is,
a filename or a fileset name with wildcard characters.

listf_group :  8 bytes; 

Byte array containing a string pattern for the group designator.  That
is, a group name with or without wildcard characters.

process_info :  40 bytes; 

For use by the intrinsics only.  Contains information for process
handling.

MPE/iX 5.0 Documentation