DISPLAY REPORT

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Display the contents of a report format file


Syntax

DISPLAY REPORT <.frm filename> | (<expC>) [TO FILE <.txt filename> | (<expC>)] | [TO PRINT]


See Also

CREATE REPORT, DB_PRINT, Function Keys, LIST REPORT, REPORT, SET PAGELENGTH, SET PAGEWIDTH, SET PRINTER


Description

The DISPLAY REPORT command provides a listing of the contents of the specified report <.frm filename>. The filename can be substituted with a <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".frm" is assumed. This command is primarily used in preparing system documentation.

DISPLAY commands differ from LIST commands in that they pause every 17 lines until a key is pressed. You can cancel any further output at this point by pressing the [ABANDON] key. Where the output is sent to a file or printer, the pause is disabled.


Keyword Description
TO <file> The display output will be sent to the specified file. The filename can be substituted with a <expC>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".txt" will be used. The command SET PAGELENGTH governs the output file pagination and SET PAGEWIDTH defines the width of each page. Page numbers are centered on the bottom of the page according to width.
TO PRINT The display output will be sent to a printer. The TO PRINT option will default to a local printer unless the command SET PRINTER TO \\SPOOLER is issued. The print request will then be spooled to the system printer, which is defined by the environment variable DB_PRINT.


Example

create report creditlist
set printer to \\spooler
display report creditlist to print
set printer to


Products

Recital Server, Recital