Difference between revisions of "RUN()"

From Recital Documentation Wiki
Jump to: navigation, search
 
(Products)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=RUN()=
 
 
 
==Class==
 
Applications
 
 
 
 
==Purpose==
 
==Purpose==
 
Function to execute an operating system command or an external program
 
Function to execute an operating system command or an external program
Line 11: Line 4:
  
 
==Syntax==
 
==Syntax==
RUN([<expLl>,] <expC> [,<expL2>])
+
RUN(<expC> [, <expL1] [, <expL2>]])
  
  
 
==See Also==
 
==See Also==
[[!]], [[!!]], [[ALIAS]], [[DO]], [[RUN]], [[SPAWN]], [[EXEC()]], [[GETENV()]], [[PUTENV()]], [[SET RUNCLEAR]], [[SET RUNWAIT]], [[DB_RUNLOG]]
+
[[!]], [[!!]], [[ALIAS]], [[DO]], [[RUN]], [[SPAWN]], [[EXEC()]], [[GETENV()]], [[PIPETOSTR()]], [[PUTENV()]], [[SET RUNCLEAR]], [[SET RUNWAIT]], [[DB_RUNLOG]]
  
  
Line 21: Line 14:
 
The RUN() function loads the specified operating system command or external program to be executed by the operating system.  The operating system command or external program is specified with character expression <expC>.  If the specified program is a batch file whose full path name is not the default path, and you are loading the program to the operating system via the command interpreter, <expC> must include the file extension.   
 
The RUN() function loads the specified operating system command or external program to be executed by the operating system.  The operating system command or external program is specified with character expression <expC>.  If the specified program is a batch file whose full path name is not the default path, and you are loading the program to the operating system via the command interpreter, <expC> must include the file extension.   
  
The two logical expressions, <expL1> and <expL2>, are provided for syntax compatibility only.
+
<expL1>  
 +
If <expL1> is .T. (true), output will be displayed in a text area.  Default is .F. (false).
 +
 
 +
<expL2>
 +
If <expL2> is .T. (true), output will be displayed full screen.  Default is .F. (false).
  
 
The RUN() function returns an operating system dependent numeric completion code.
 
The RUN() function returns an operating system dependent numeric completion code.
Line 28: Line 25:
 
==Example==
 
==Example==
 
<code lang="recital">
 
<code lang="recital">
run("dir")
+
run("dir",.t.,.f.)
 
</code>
 
</code>
  
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]

Latest revision as of 15:23, 7 December 2009

Purpose

Function to execute an operating system command or an external program


Syntax

RUN(<expC> [, <expL1] [, <expL2>]])


See Also

!, !!, ALIAS, DO, RUN, SPAWN, EXEC(), GETENV(), PIPETOSTR(), PUTENV(), SET RUNCLEAR, SET RUNWAIT, DB_RUNLOG


Description

The RUN() function loads the specified operating system command or external program to be executed by the operating system. The operating system command or external program is specified with character expression <expC>. If the specified program is a batch file whose full path name is not the default path, and you are loading the program to the operating system via the command interpreter, <expC> must include the file extension.

<expL1> If <expL1> is .T. (true), output will be displayed in a text area. Default is .F. (false).

<expL2> If <expL2> is .T. (true), output will be displayed full screen. Default is .F. (false).

The RUN() function returns an operating system dependent numeric completion code.


Example

run("dir",.t.,.f.)


Products

Recital, Recital Server