NAME

dtexec − execute command-based action

SYNOPSIS

dtexec [−open open_option ] [ −ttprocid procid ] [ −tmp tmpfile ] cmd [ cmd_arg ... ]

DESCRIPTION

CDE uses the dtexec utility to execute COMMAND actions.  In normal usage, CDE automatically invokes dtexec when it is needed.  CDE users and administrators do not need to interact directly with dtexec. 

The primary argument for dtexec is the name of a command to execute and any command-line options or arguments for that command.  There are several important services that dtexec provides for the commands that it executes.  These services are controlled via the options specified in the “OPTIONS” section in this document. 

OPTIONS

The following options are available:

-open open_option
The -open option tells dtexec whether it should continue to run or exit after the command terminates.  This option is used when COMMAND actions are executed in a terminal emulator to control the lifetime of the terminal window. 

  The valid values for open_option are:

-1 (default) continue to execute after cmd terminates, thus keeping the terminal window open. 

0 exit as soon as cmd terminates, thus allowing the terminal window to close. 

n continue to execute if cmd terminates within n seconds of starting. 

-ttprocid procid
The dtexec command uses the -ttprocid option to send ToolTalk messages back to the application that invoked the COMMAND action.  These messages are used to convey status information (for example, the command has terminated). 

-tmp tmpfile The -tmp option names a temporary file that dtexec removes after cmd terminates if either no -ttprocid option is supplied or contact is lost with the specified procid.  In normal usage, the parent process that starts dtexec, performs this cleanup.  This option can be issued multiple times, once for each tmp file present.  Typically, tmpfile also appears as a cmd_arg. 

EXIT STATUS

The following exit values are returned:

0 Implies all system resources were available to fork and exec the requested command, not that the requested command executed successfully. 

1 An error occurred. 

APPLICATION USAGE

Normally, application programs do not directly invoke this program.  Normally, an application program links with the action service, which then invokes dtexec as needed.  Applications should use the waitTime resource to configure the value of the −open_option and the DtexecPath resource to configure the location of dtexec. 

SEE ALSO

dtaction(1), dtactionfile(4). 
 
 
 
 
 
 
 
 
 
 

  —  12 Apr 1994