IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Agent-based services > Agent Service Interface

IBM Tivoli Monitoring, Version 6.3 Fix Pack 2


Agent Service Interface - Queries

Select the Queries option of the Agent Service Interface to query the kpc.atr file for the selected attribute group, shown by table name. One report is a list of the attributes, their column name and display name, and characteristics. The other report shows the current sampled values of the attributes.

Select a table name from the list to see the component attributes and a report of the sampled data.

Table name

This is the table name for the attribute group taken from the <install_dir>/TMAITM6/ATTRLIB/kpc.atr file (where pc is the two-character product code).

Name

This is the column name for the attribute. It is not used in private situations or private history, but is what you would see if you were to look up the stored data in the Tivoli Data Warehouse.

Display

This is the detailed name of the attribute, formatted as Attribute_Group_Name.Attribute_Name, and is what you enter in the private situation and private history definitions. For example, KHD_CONFIG.Connection_Pool_Size or NT_Registry.Server_Name.

Type

Displayed in this column is a number that represents the type of attribute this is, such as 4 to denote an integer-enumerated attribute. The type is not used directly in a private situation or private history definition, but informs you of the required format for the attribute value.

Length

This is the number of bytes or maximum number of bytes possible for the attribute value. For TIMESTAMP attributes, 16 indicates the following format: CYYMMDDHHMMSSmmm, such as 1090819160501000 for the 21st century on August 19, 2009 at 4:05:01 PM

Minimum

The lowest possible value for the attribute is displayed here. If the field is empty, there is no minimum value for the attribute.

Maximum

The highest possible value for the attribute is shown in this column. If the field is empty, there is no maximum value for the attribute.

ENUMS

This is the enumeration and what it represents for an attribute. Some enumerated attributes have multiple enumerations. When composing a private situation for an enumerated attribute, use the actual value in the formula and not the display value (what you would see in the Tivoli Enterprise Portal).

These two reports show the results of a query to the Windows IP Address attribute group, table name NTIPADDR. The first report is a listing of the attributes in the table as they appear in the kpc.atr file. When creating private situations or private history definitions, use the name shown in the Display column.


Agent Service Interface - Queries sample attribute listing

Name Display Type Length Minimum Maximum ENUMS
ORIGINNODE NT_IP_Address.System_Name 2 64      
TIMESTAMP NT_IP_Address.Timestamp 2 16      
INTFNAME NT_IP_Address.Network_
Interface_Name
3       Not Available for Windows 2000
IPADDRESS NT_IP_Address.IP_Address 2 50      
DNSNAME NT_IP_Address.DNS_Name 10 388     No DNS Entry
IPVERSION NT_IP_Address.IP_Version 4   -2147483648 2147483647 4   IPv4
6   IPv6
10   IPv4_IPv6
MACADDRESS NT_IP_Address.MAC_Address 2 28      

The second report is displayed with the current sampled values of the attribute group.


Agent Service Interface - Queries sample report

ORIGINNODE TIMESTAMP INTFNAME IPADDRESS DNSNAME IPVERSION MACADDRESS
Primary:East:NT 1090819142128111 11a_b_g Wireless LAN Mini PCI Adapter 9.52.100.111 East.ibm.com 4 00054e48f5bd
Primary:East:NT 1090819142128111 MS TCP Loopback interface 127.0.0.1 NO_DNS_
ENTRY
4 000d608b2938


Parent topic:

Agent Service Interface

+

Search Tips   |   Advanced Search