HP 3000 Manuals HP 3000 Manuals
BRWOPEN
Use the BRWOPEN intrinsic to open an existing report execution file and
the standard job file, or a report job file. The intrinsic checks to see
if the file given as the call argument is a report job file or an
execution file.
The job file (report or standard job file) is kept open for use by other
intrinsics. The report execution file is closed, and all the information
it contains that will be needed by the other intrinsics is kept in the
BRW_COMEREA field.
Call BRWOPEN like this:
BRWOPEN (brw_comarea, filename)
The parameters have the following characteristics:
BRW_COMAREA
BRW_COMAREA has a 332 byte array with the following structure:
_____________________________________________
| |
| return_status : 2 byte integer;|
| error_parm : 2 byte integer;|
| for system use : 328 bytes. |
_____________________________________________
BRW_COMAREA is set by the BRWOPEN intrinsic. Return_status is an integer
that is set to 0 if the call is successful, or to a non-zero value if an
error occurs. Error_parm returns additional error information; all
values of return_status and error_parm are described in the section Error
Handling.
FILENAME
36-byte character array that must contain the report execution file name
or the report job filename. The filename must be followed by a
terminating blank character.
[REV BEG]
It is a good idea to fully qualify the execution file name. For example,
use REPORT1.PUB.APPLICS rather than REPORT1 or REPORT1.PUB. This will
avoid a problem if you use a file equation for the printfile when the
execution file name and the report printfile name are the same.[REV END]