Difference between revisions of "DISPLAY CALLS"

From Recital Documentation Wiki
Jump to: navigation, search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{YLM to do}}
 
==Class==
 
Applications
 
 
 
 
==Purpose==
 
==Purpose==
 +
Display program stack
  
  
Line 12: Line 8:
  
 
==See Also==
 
==See Also==
[[DB_PRINT]], [[DISPLAY STATUS]], [[Function Keys]], [[LIST CALLS]], [[LIST PROCEDURE]], [[SET PAGELENGTH]], [[SET PAGEWIDTH]], [[SET PRINTER]], [[SET PROCEDURE]]
+
[[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==
 
==Description==
The DISPLAY CALLS command displays on screen the  
+
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.
 
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.
Line 33: Line 29:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
display calls
+
on error display calls
 
</code>
 
</code>
  
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital Server, Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Error Handling and Debugging]]
 +
[[Category:Error Handling and Debugging Commands]]

Latest revision as of 16:02, 10 November 2009

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 Server, Recital