Difference between revisions of "SET RUNCLEAR"

From Recital Documentation Wiki
Jump to: navigation, search
Line 15: Line 15:
  
 
==See Also==
 
==See Also==
[[!]], [[RUN]], [[SET RUNWAIT]], [[RUN()]], [[DB_RUNLOG]]
+
[[!]], [[!!]], [[DB_RUNLOG]], [[DB_RUNOPTS]], [[DB_RUNOPTS2]], [[RUN]], [[RUN()]], [[SET RUNWAIT]]
  
  
 
==Description==
 
==Description==
The SET RUNCLEAR command controls whether the screen is automatically cleared, before and after execution of an Operating System command via the RUN/! Commands or the RUN() function.
+
The SET RUNCLEAR command controls whether the screen is automatically cleared, before and after execution of an Operating System command via the RUN/!/!! Commands or the RUN() function.
 +
 
 
With SET RUNCLEAR ON, the screen is automatically cleared, and when SET RUNCLEAR is OFF, the display is retained.  This later setting allows for more efficient execution of operating system commands that do not require any screen output.  By default SET RUNCLEAR is ON.
 
With SET RUNCLEAR ON, the screen is automatically cleared, and when SET RUNCLEAR is OFF, the display is retained.  This later setting allows for more efficient execution of operating system commands that do not require any screen output.  By default SET RUNCLEAR is ON.
  
Line 26: Line 27:
  
 
==Example==
 
==Example==
<pre>
+
<code lang="recital">
 
set runclear off
 
set runclear off
 
run sysbackup > /dev/null 2>/dev/null
 
run sysbackup > /dev/null 2>/dev/null
set runclear on</pre>
+
set runclear on
 +
</code>
  
  

Revision as of 11:29, 17 April 2009

SET RUNCLEAR

Class

Recital Terminal Developer Environment


Purpose

Enable or disable clearing of the screen after the RUN/! Commands and the RUN() function.


Syntax

SET RUNCLEAR ON | OFF | (<expL>)


See Also

!, !!, DB_RUNLOG, DB_RUNOPTS, DB_RUNOPTS2, RUN, RUN(), SET RUNWAIT


Description

The SET RUNCLEAR command controls whether the screen is automatically cleared, before and after execution of an Operating System command via the RUN/!/!! Commands or the RUN() function.

With SET RUNCLEAR ON, the screen is automatically cleared, and when SET RUNCLEAR is OFF, the display is retained. This later setting allows for more efficient execution of operating system commands that do not require any screen output. By default SET RUNCLEAR is ON.

This command allows the optional logical expression <expL> to be evaluated. If a value of .T. is returned, RUNCLEAR is set ON, otherwise it is set OFF.


Example

set runclear off
run sysbackup > /dev/null 2>/dev/null
set runclear on


Products

Recital Terminal Developer