|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
|
xcall RW_GETRPT(channel, key, report_name, status[, report_file])
Arguments
channel
A channel for the reports file. (n)
key
The name of the first report to find. (a)
report_name
Returned with the name of the next report found. (a)
status
The error status: (n)
0 = Report name found
1 = No more matching reports
n = Synergy DBL error number
report_file
(optional) The name of the reports file to open. (a)
Discussion
The RW_GETRPT routine gets a sequence of reports or all reports in a given reports file. This routine is intended to be called iteratively to retrieve report names that match a specified key portion (key). If key is “ ”, all report names will be returned in sequence (one per call). If key is “CUST”, for example, all report names beginning with “CUST” will be selected, and so on.
On the first call, channel should not be open or allocated, and report_name should be blank. The routine will open the report definition file and return the first matching report name.
Subsequent calls to the routine should pass report_name with the last report name found. This will cause the routine to seek the next matching report name in the reports file.
If report_file is not specified, the routine will attempt to open the file pointed to by the RPTRFIL environment variable, and if RPTRFIL is not set, the routine will attempt to open the reports.rpt file in the directory that RPTDAT points to.
