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: - Do not use this selection for systems running IBM® Director Agent
5.20 or earlier.
- IPv4 addresses are accepted.
- 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: - IPv4 addresses are accepted.
- 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.