|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
|
status = %RW_GENRPT([report], [out_location], [out_file], [out_format], [page_header] & [, separator])
Return value
status
Either 0 (no error occurred) or a handle to error data as defined in reports.def.
Arguments
report
(optional) The name of the report to generate. (a)
out_location
(optional) The output location: (n)
RO_SCREEN = Screen (default)
RO_PRINT = Printer
RO_FILE = File
out_file
(optional) The output file, if out_location is RO_FILE. (a)
out_format
(optional) The output format, if out_location is RO_FILE: (n)
RF_REPORT = Report (default)
RF_DATA = Data only
RF_WORKSHEET = Worksheet
page_header
(optional) The page header output flag, if out_location is RO_FILE: (n)
R_NOHEADER = No page header output (default)
R_HEADER = Page header output
separator
(optional) The separator character to use for worksheet output: (n)
RS_COMMA = Comma (default)
RS_TAB = Tab
RS_SPACE = Space
RS_SEMICOLON = Semicolon
Discussion
%RW_GENRPT enables users to generate a ReportWriter report without chaining or spawning to ReportWriter.
Make sure you call %RW_INIT before calling %RW_GENRPT.
%RW_GENRPT requires a WRUN license. If there is no WRUN license available, it will attempt to use an RPTW license. If neither license type is available, %RW_GENRPT returns an error. %RW_GENRPT releases the license when report generation is complete.
%RW_GENRPT does not perform any message parsing from either a SEND message or an RPTUSR environment variable.
Any EUTILS_METHOD that you have overloaded with E_METHOD will be overridden by the EUTILS_METHOD that ReportWriter overloads in %RW_GENRPT.
