====== U2_EXECPROC Function     ======


 
==== Description ====
 
Executes U2 functions on the U2 back end.   This function returns Intercall status codes and sets @FILE.ERROR with error details.
 
==== Syntax ====
 
result = U2_ExecProc(VolumeID, Command, Buffer, Reply, Interactive)
 
==== Parameters ====
 
The function has the following parameters:

^Parameter^Description^
|VolumeID|Volume pointer name to base the virtual session on.|
|Command|The server command line to execute.|
|Buffer|The buffer contains the return data resulting from the command.||

 
==== Returns ====
 
Status Codes

^Code^Description^
|-1|Invalid arguments.|
|0|Execution complete.  This does not necessarily mean that the procedure was successful.|
|1|General failure.  @FILE.ERROR will contain detailed information.|
|n|Other. See Intercall Documentation.|

 
==== Remarks ====
 
The buffer can handle lengths up to 2048 characters.
 
==== See Also ====
 
[[u2_functions_in_oi|U2 Functions]]
 
==== Example ====
 
<code>
declare function u2_execproc

VolumeID = 'mylaptop6100b:UV'

Command = 'RUN BP LIST.INDEX'

buffer = ''

result =  u2_execProc(VolumeID, Command, Buffer)

* get rid of extra spaces

buffer = trim(buffer)

x = msg(@window, trim(Buffer) )
</code>