HP 3000 Manuals HP 3000 Manuals
Execution Intrinsics The following table gives a brief description of each HP ALLBASE/BRW intrinsic: ------------------------------------------------------------------------------------------ | | | Intrinsic Name Description | | | ------------------------------------------------------------------------------------------ | | | BRWOPEN The intrinsic BRWOPEN opens a file or files and returns | | information about the files. The files opened can be either a | | report execution file and the standard job file, or a report job | | file. You determine which files are opened by supplying either | | the name of a report execution file, or the name of a report job | | file, in the FILENAME parameter when calling BRWOPEN. | | | | For example, if you call BRWOPEN with a FILENAME parameter of an | | Execution file, REPORT1.EXEC, BRWOPEN will open REPORT1.EXEC and | | the standard job file, and return information about those files | | in the parameter BRW_COMAREA. However, if you called BRWOPEN | | with a FILENAME parameter of a report job file, REPJOB1.BRWJOB, | | the intrinsic would only open the file REPJOB1.BRWJOB, and | | return information about that file in BRW_COMAREA. The | | information in BRW_COMAREA will be used by the other execution | | intrinsics. | | | | BRWINFO This intrinsic is called using the value in BRW_COMAREA obtained | | from the previous call of BRWOPEN. BRWINFO will obtain a full | | description of each parameter in either the report execution | | file and standard job file, or a report job file. The choice of | | files, of course, depends on the files opened by BRWOPEN. The | | full description will include such information as each | | parameter's name, type, result type, whether the parameter is | | required or not. The parameter descriptions will be held in the | | second parameter to intrinsic BRWINFO, called BRW_PARAMETERS. | | | | BRWSTREAM This intrinsic uses the parameter information returned by the | | previous call to BRWINFO, plus the file information returned by | | the call to BRWOPEN, either to stream the standard job file, | | which executes the report execution file, or to stream the | | report job file. The choice of files, of course, depends on the | | files opened by BRWOPEN. | | | | BRWEXEC This intrinsic executes a report execution file on line, by | | creating a son process that runs BRWEXEC.PUB.SYS. This intrinsic | | uses the information about the report execution file returned by | | BRWOPEN, and the parameter information returned by BRWINFO, when | | running BRWEXEC.PUB.SYS. Note that you cannot use this intrinsic | | with a report job file. | | | | BRWCLOSE This intrinsic closes the job file opened by BRWOPEN. | | | | The file closed will be either the standard job file, or the | | report job file. The choice of files closed, of course, depends | | on the files opened by BRWOPEN. | | | ------------------------------------------------------------------------------------------ The following diagrams illustrate how each intrinsic works.
![[]](../../pic3k/M011795/FFN2623c50.gif)
![[]](../../pic3k/M011795/FFN2633c50.gif)