Console Reports

A report may be directed to the console (CON), printer (PRN), or any other file in the system. The console-type report offers several features not available in reports sent to a file or the printer. A console report will be output to the screen in the colors defined by the form which comprise the report being generated.

Pagination is performed differently when directed to the console as well. If a report is to be paginated, SAGE will cause the report output to pause after each page and will request the user to choose whether to continue or terminate the report. If the report is sent to the console and is paginated, the application should check Reports.ConsoleTerminate after each output to determine whether the user has requested termination, and terminate the report if so directed. If pagination is not requested in the report format for the console, the report will smoothly scroll until completed. Console reports are not usually directed to print the page number lines, but this feature can be included if desired.

Reports.DefineConsoleWindow allows the definition of the region of the screen where the report should be written. More than one console report may be produced at a time in different windows of the screen to cause a split screen effect.

A more complex report may include the following steps using WrForm after opening and defining the report format.

Write out one or more lines of report introduction and heading.
(top form and bottom form names are null)

Write out column headings.
(top form and bottom form names are null)

Write out each report entry, giving the appropriate forms for new page headings and old page summaries.

Write out the report summary and subtotals.
(top form and bottom form names are null)

Go Back To Sage-ST TABLE OF CONTENTS