Run Program
Applies To: Opalis 6.3
The Run Program object can run any program or command on any computer in your domain in interactive or background mode. This object uses a satellite license.
Use the Run Program object to run backup applications or a batch script that runs a set of complex commands.
Configuring the Run Program Object
To configure the Run Program object you need to know the command line argument or program that you want to run and which computer it will run on. You must also know if a user on the target computer will need to interact with the program when it is run. The user account that will run the program or command must have administrator rights to run programs on the target computer.
To configure the Run Program object
From the Objects pane, drag a Run Program object to the active Policy.
Double-click the Run Program object icon. The Properties dialog opens.
For information about the settings on the Details tab, and the Advanced tab, see the following tables.
For information about the settings on the General tab, the Run Behavior tab, and other tabs if applicable, see Common Tabs.
Details Tab
Element | Configuration Instructions |
---|---|
Program execution |
Select this mode to execute a program in the same way as a Windows shortcut or the Windows Run dialog. You can also use the ellipsis (...) button to browse for the computer. |
Command execution |
Select this mode to execute a command in the same way as the Windows Command Prompt. |
Computer |
Type the computer where this program or command will be executed. Type localhost to run the program or command on the Action Server where the Policy is being processed. |
Program Path/Command |
|
Parameters |
Type the parameters that will be passed to the program that you want to run. This option is only available when you select the Program execution mode. |
Working folder |
Type the full path of the working folder that the program or command will use. The command or program will behave as if it was executed from the working folder. |
Advanced Tab
Element | Configuration Instructions |
---|---|
Execution mode |
Select the mode of execution for the program:
|
Wait for the completion of the program |
Select this option to cause the Run Program to wait for the program or command to finish executing before moving to the next object in the Policy. If you have set the Execution mode to Interactive, then the user must close the program before the Run Program object is able to move to the next object in the Policy. |
Terminate after |
Type the maximum number of minutes to wait for the program or command to complete. Set this value to 0 to have the Run Program object to wait indefinitely for the completion of the program or command. If the time has expired and the program or command has not completed executing, the Run Program object will shut down the program or command and report a failure. |
Do not wait for the completion of the program |
Select this option to cause the Run Program object to run the program or command and not wait for it to complete. When this option is selected, the Published Data items generated by the Run Program object will not be available to other objects. |
User name |
To use a different account name to log in to a computer and run a program, type the account number in the User name box. Note: This user name only logs in to the computer where the Run Program object is executed, and uses the Interactive logon type. If the program that the Run Program object launches accesses resources on other computers, the same user name is used on the remote computer, but with the Network logon type. |
Password |
Type the password associated with the user name to run the program on the remote computer. |
Run Program Published Data
The following table lists the element names and descriptions of the data published by this object. For information about the published data elements that are common to all objects, see Policy Workflow Rules.
Element Name |
---|
Program path |
Program parameters |
Working folder path |
Process ID |
Program exit code |
Computer |
Program output |
Pure Output |
Program output file |
UNC program output file |