Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

SYSEXEC

Executes a system-dependent shell-level command.

Syntax

<SYSEXEC
      CMD="command"
      [SYSOUT="output return"]
      [SYSERR="error return"]
      [WAIT="wait val"]/>

Parameters

CMD (required)

Shell-level command to execute.

SYSOUT (optional)

Variable name to contain the system output returns. If not set, these returns are unavailable. Specify SYSOUT and/or SYSERR arguments for this tag only if WAIT is true, otherwise, errno -14 is set.

SYSERR (optional)

Variable name to contain the system error returns. If not set, these returns are unavailable. Specify SYSOUT and/or SYSERR arguments for this tag only if WAIT is true, otherwise, errno -14 is set.

WAIT (optional)

Indicates whether to execute the command immediately or wait. Possible values are true or false. The default is false. You could create an infinite loop if you set this parameter to true for NT Command shell commands.

Error Numbers

The possible values of errno include:

Value	Description
-14	Process exception error.

Example

This example executes a Windows NT shell-level directory command on the value of Variables.testfile (replaced before the command executes).

<SYSEXEC CMD="cmd /c dir /OD Variables.testfile"
         SYSOUT="execout" 
         SYSERR="execerr" 
         WAIT="true"/>
<SYSEXEC CMD="ls Variables.testfile"
         SYSOUT="execout" 
         SYSERR="execerr" 
         WAIT="true"/>

Your code should check to see if the variables exist (contain data) before printing, for example:

<IF COND="IsVariable.execerr=true">
   <THEN>
      Error string returned: <CSVAR
 NAME="Variables.execerr"/>
   </THEN>
</IF>

See Also

CALLJAVA

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.