Set an event system variable

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."
Related concepts

Log to a log file
Modify an event and send it
Post to a newsgroup (NNTP)
Send a numeric page
Send a Tivoli Enterprise Console event
Send an SNMP INFORM request to an IP host
Send an SNMP trap reliably to a NetView host
Send an SNMP trap to an IP host
Start a task on the system that generated the event
Static group: add or remove group members
Static group: add or remove the event-generating system
Timed alarm that generates an event
Timed alarm that starts a program
Event-data-substitution variables
Related tasks

Creating an event action to activate in an event automation plan
Related reference

Event Action Editor window: Set an event system variable

Table of Contents