DISPLAY CALLS

From Recital Documentation Wiki
Revision as of 15:17, 23 June 2009 by Yvonnemilne (Talk | contribs)

Jump to: navigation, search

Class

Error Handling and Debugging


Purpose

Display program stack


Syntax

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


See Also

DB_PRINT, DEBUG, DISPLAY PROCEDURE, DISPLAY STATUS, DOLEVEL(), Function Keys, LIST CALLS, LIST PROCEDURE, ON ERROR, PROCNAME(), PROGRAM(), RESUME, SAVE ERROR, SET PAGELENGTH, SET PAGEWIDTH, SET PRINTER, SET PROCEDURE, SET STEP, SUSPEND


Description

The DISPLAY CALLS command displays on screen the name and line number of the current program or procedure/function and the program stack - program name and line number - from which it was called.

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

on error display calls


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer