Creating custom tool definition files for HP Systems Insight Manager 5.1 or greater (481365-002, January 2009)

29
Appendix F: Environment Variables
Table F
-
1
lists the specific environment
variables (EVs) available to use for TDEFs. In addition to this
list, operating system environment variables are also available (for Windows systems) to be passed
into TDEFs. In addition to these ‘automatic’ EV’s, user
-
defined environment variables can be
set as
part of scripting in the TDEFs.
Table F
-
1
.
Environment Variable name and descriptions
Names Values
Description
NoticeLabel
The short string type of event (like Discovered Device)
NoticeState
Shows whether the event
has been cleared
NoticePlainText
Plain text description of the event and also includes whether it is set to In Progress,
Cleared, or Not Cleared
NoticeRawData
The raw data of the event that was sent and in a string format. It is in a pipe (|)
delimited f
ormat that can be used for simple parsing
NoticeSeverityStr
Can be Critical, Major, Minor, Unknown, Normal, Warning, or Informational
NoticeSeverity
An integer format of the severity
0
-
Unknown
1
–
Normal
2
–
Warning
3
–
Minor
4
–
Major
5
–
Critical
100
-
Informational
NoticeQueryName
Displays the event list that generated the event. In the format of:
This device or event meets the following query criteria: +QueryName;
This device or event now meets the following query criteria: +QueryName;
This device
or event no longer meets the following query criteria:
QueryName
DeviceName
Name of the device that generated the event
DeviceIpxAddressCount
Number of IPX addresses that are mapped to this device
DeviceIPAddressCount
Number of IP addresses that are ma
pped to this device
DeviceIPAddress%d
Based on the count of IP addresses, %d is an integer that shows the actual IP address.
For example, if DeviceIPAddressCount=2 then DeviceIPAddress0=111.111.111.111
and DeviceIPAddress1=222.222.222.222.
DeviceMACAddr
ess%d
Based on the MAC address count, %d is an integer that references the actual MAC
address variable. If DeviceMACAddressCount=2 then,
DeviceMACAddress0=00:80:5E:7F:B0:81 and
DeviceMACAddress1=00:80:C7:29:EF:B6
GenericTrapID
If tied to an event list and
the event was a SNMP trap, then this is set to the SNMP
generic trap ID of the trap received
SpecificTrapID
If tied to an event list and the event was a SNMP trap, then it is set to the SNMP specific
trap ID
Path
Path variable received from the operati
ng system (received in context of the windows
service account)