Difference between revisions of "DISPLAY CALLS"

From Recital Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
{{YLM to do}}
 
 
==Class==
 
==Class==
 
Error Handling and Debugging
 
Error Handling and Debugging
Line 5: Line 4:
  
 
==Purpose==
 
==Purpose==
 +
Display program stack
  
  
Line 12: Line 12:
  
 
==See Also==
 
==See Also==
[[DB_PRINT]], [[DISPLAY PROCEDURE]], [[DISPLAY STATUS]], [[DOLEVEL()]], [[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 33:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
display calls
+
on error display calls
 
</code>
 
</code>
  

Revision as of 15:17, 23 June 2009

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