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.