%RW_GENRPT

Generate a report

WTSupported in traditional Synergy 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.