The General page defines the basic properties of the program to be run.
Target
Specify the program, batch file, script file, document file, etc., to be executed. You may specify here essentially anything that is valid when using the Run command from the Windows Start menu. Note that you must include quotes around the target if it contains spaces.
For example:
|
"c:\program files\serverdatacopy\prod1.exe" |
Runs the "prod1.exe" program. |
|
c:\data\mydocument.doc |
Launches Microsoft Word and loads "mydocument.doc". |
|
c:\cmd\copydata.cmd |
Runs the "copydata.cmd" batch file. |
|
|
If you use the ... button to browse for the target, be aware that you are browsing the file system of the client By "client" we mean the computer on which the adTempus Console is running.. If the server By "server" we mean the computer on which the adTempus service is running is a different computer this is not going to produce the result you want. Be sure that the target you specify is valid on the server. |
|
|
The Program Execution Task can be used to run Windows scripts (either by specifying the script file as the target, or specifying wscript.exe or cscript.exe as the target and passing the appropriate command-line parameters. However, this approach does not allow you to return a result code from the script. If you use the Script Execution task instead your script can return a result code. |
Skip this step if the process is already running
When this option is checked, it is like having a Process Condition on the target process. If the target process is already running (regardless of whether it is under the control of adTempus), the step will be skipped.
|
|
This option is only valid when you have specified an executable file (.exe) as the Target. The option will not work with other kinds of targets; nor will it work with 16-bit processes (processes that appear under NTVDM.EXE in the Task Manager). |
Command-Line Parameters
Specify any command-line parameters that should be passed to the program.
There are two ways to insert dynamic data into the command line:
use a script (see next section) to build the command line
Use substitution tokens within the command line.
Use a script to specify command-line parameters
Check this option to use a script to set the command-line parameters. For example, you can use a script to pass the current date to the target application. See the Script Overview topic for information on working with scripts.
|
|
Before it returns your script must set the global Result variable to the string that you wish to have passed on the command line. |
Startup Directory
Specify the startup ("working") directory to be associated with the program.
The Window Mode option determines how the program will appear:
Hidden. The program is run on a hidden desktop and will not be visible to any user who is logged in to the computer. This option should be used for programs that do not prompt for user input.
Capture Console. This option can be used with console-mode A console-mode program is a program that uses the console (or "DOS box") for input and output, rather than displaying a graphical user interface. programs only. When this option is selected the program is run on a hidden desktop (and so is not visible to any user who is logged in to the computer). The output that the program writes to the console is captured in a file, which is stored in the execution history for the job. To review the output, view the properties for the instance once the step completes. The console output will be found in the Captured Files list for the job, with the name "console output.txt".
Normal. The program is run on the interactive desktop, where it will be visible to any user who is logged in to the computer. This is equivalent to the behavior you would see if you launched the program using the Run command on the Windows Start menu.
Minimized. The program is run on the interactive desktop but is instructed to start with its main window minimized.
Maximized. The program is run on the interactive desktop but is instructed to start with its main window maximized.
|
|
If a program is run in one of the "interactive" modes (Normal, Minimized, or Maximized) it will be visible to any user logged in to the computer, regardless of whether the program is running under that user's account. The user will be able to interact with the program and could therefore "hijack" the program and use it to carry out actions the user is not normally authorized to perform. Also, "interactive" programs are terminated when the interactive user logs off, regardless of whose account the programs are running under. Therefore if access to the computer is not restricted, you should run programs in one of the "non-interactive" modes (Hidden or Capture Console) instead. |
Execution Priority
Specify the priority that the operating system should assign to the process.
Name for this step (optional)
Optionally, specify a descriptive name for the step. Otherwise the name of the target is used as the description for the step.
Description/Notes
Enter any extended descriptive information or notes for this step. There is no limit on the length of the text.
Program Execution Task Properties
Program Execution Task Overview
