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_Name3 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_IPv6MACADDRESS 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_
ENTRY4 000d608b2938
Parent topic:
Agent Service Interface