Create Action window: Start a program on a system

Starts a program on a specified system. Programs can include command-line commands that can start or stop programs on the system.

Fields

Action name
Specifies the name for the event action.
Protocol
Specifies the transport protocol used for communication between the target system and the management server. Available values are:
  • Common Agent Services (CAS)
  • TCPIP
  • IPX
  • NETBIOS
IP address or host name
Specifies the system on which the program is run. This information varies depending on the protocol that you selected:
CAS
An IP address or host name, for example, 9.88.113.22 or myclient.mylocation.mycompany.com.
Notes:
  1. Do not use this selection for systems running IBM® Director Agent 5.20 or earlier.
  2. IPv4 addresses are accepted.
  3. In order for the IP address or host name to be valid, the affected system must be managed by IBM Systems Director and access to the system must be granted before this event action is invoked.
TCPIP
An IP address or host name, for example, 9.88.113.22 or myclient.mylocation.mycompany.com.
Notes:
  1. IPv4 addresses are accepted.
  2. In order for the IP address or host name to be valid, the affected system must be managed by IBM Systems Director and access must be granted before this event action is invoked.
IPX
An internetwork address, for example, A1:1005A9823411.
NETBIOS
Network address or computer name, for example, HenrysBox. This name is specified in the Network address field of the Network Driver Configuration window when you are enabling the NetBIOS network driver.
Working directory
Specifies the working directory used by the program. Specifying a working directory has the same effect as changing the current directory to a specified drive and directory before starting a program. This capability is helpful if the program being started needs to load other files or programs that are assumed to be in the same location.

You can use event-data-substitution variables in this field.

Program file name
Specifies the program file that is to be run on the target system. When running a program, the program file name might include the drive and directory information relative to the target system. An alternative to fully qualifying the program is to use a working directory.

You also can specify system commands (for example, erase c:\logs\*.log). Note that in all cases, the target system command processor is used to initiate each program or command.

You can use event-data-substitution variables in this field.

Language
Sets the preferred language that the event-data substitution uses, for example, in the &text variable.
Time zone
Sets the time zone that event-data substitution uses, for example, in the &time variable.
Description
Accepts a description of the event action that you have configured.

Actions

Insert
Inserts the event-data-substitution variable that you have selected from the list. You can select and insert more than one variable into an associated field. For information about the information each variable provides, see "Event-data-substitution variables."
Test
Tests the event action so you can make sure it performs as expected.
OK
Saves changes on the page and closes the page.
Cancel
Closes the page without saving any changes that you have made.

Table of Contents