DOLEVEL()

Class

Applications

Purpose

Function to return the 'do' level of the currently executing program or procedure

Syntax

DOLEVEL()

See Also

DEBUG, DO, MESSAGE, MESSAGE(), PATH(), PROCLIBS(), PROCLINE(), PROCNAME(), PROGRAM(), RESUME, SET DEBUG, SET DOHISTORY, SET ECHO, SET HISTORY, SUSPEND, SYS()

Description

The DOLEVEL() function returns the 'do' level of the currently executing program or procedure. Issued at the command prompt, the DOLEVEL() function returns 0. Issued in a master or calling program, DOLEVEL() returns 1. Subsequent called programs or procedures are at a 'do' level based on the program nesting.

Example

> ? dolevel()
         0
//master.prg
procedure subproc1
? dolevel()
?
return
 
? dolevel()
subproc1()
//end of master.prg
> do master
         1
         2

Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer