USE-REPORT

Function

For programs with multiple reports, allows the user to switch between reports.

Syntax

USE-REPORT {report_name_lit|_var|_col}

Arguments

report_name_lit|_var|_col

The report to become the “current” report. All subsequent PRINT and PRINT-DIRECT statements are written to this report until the next USE-REPORT is encountered.

Description

Defines to which report file(s) the subsequent report output is to be written. An application can contain several USE-REPORT statements to control several reports.

You must specify the report name and report characteristics in a DECLARE-REPORT paragraph and in the associated DECLARE‑LAYOUT and DECLARE-PRINTER paragraphs.

Examples

use-report customer_orders
use-printer-type PostScript
print (1, 1) 'Customer Name: '
print () $customer_name

See Also

DECLARE-REPORT, DECLARE-LAYOUT, DECLARE-PRINTER, and USE-PRINTER-TYPE