Sets a user-defined system variable to
a new value or resets the value of an existing system variable. IBM® Systems Director provides
user-defined system variables to help you test and track the status
of network resources according to the needs of your organization.
System variable names and values can be referenced wherever event
data substitution is allowed.
Note: This event action affects
an
IBM Systems Director-provided,
user-defined system variable,
not an operating-system variable.
- Requirements
- None
- Result
- The specified variable and value are added to the EventSysVar.prop
file. This file is located on the management server in the install_root\data
directory, where install_root is
the root directory of your IBM Systems Director installation.
Note that this path uses the backslash (\) to delimit the directory;
depending on the system that you are using, you might be required
to enter the path using the forward slash (/).
- Example
Assume
that you need to monitor a bottleneck in the network that can cause
network congestion. You can create an
event automation plan to specify
an SNMP event that indicates network congestion, and initiate the
Set Event System Variable task when the event occurs. Assume that
you have specified the following settings:
- System variable name field: NetStatus
- New value field: Congested
- Reset value to use IBM Systems Director Server when restarts field: Normal
- Time until automatic value reset field: 10
If 10 seconds elapse before IBM Systems Director Server receives
the event that triggers this action or before IBM Systems Director Server stops and
restarts, the NetStatus system variable is reset to normal.
Instead
of using a specific event that signals that your NetStatus is Normal,
you have used a system variable that automatically resets to normal
when the events that cause this action to trigger are not received
within the interval. If IBM Systems Director Server continues
to receive the events before the interval expires, this action continues
to trigger, signaling that the network is congested. If the timer
interval expires, NetStatus is reset to Normal.
Note: You
can use event-data-substitution variables to include event-data information in the System variable name, New
value, and the Reset value to use IBM Systems Director Server when restarts fields
of this event action. For more information, see "Event-data-substitution
variables."