Devices 6212 Reference Guide

Tivoli Agent for Network Devices
Version 6.2.1.2
Reference Guide
SC27-2831-00
Tivoli Agent for Network Devices
Version 6.2.1.2
Reference Guide
SC27-2831-00
Note
Before using this information and the product it supports, read the information in Appendix B, Notices, on page 111.
This edition applies to version 6.2.1.2 of IBM Tivoli Foundation Application Manager Agent for Network Devices
(product number 5724-Y07) and to all subsequent releases and modifications until otherwise indicated in new
editions.
Copyright IBM Corporation 2009, 2010.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Chapter 1. Overview of the agent . . . . 1
Features of the monitoring agent
User interface options . . . .
.
.
.
.
.
.
.
.
.
.
.
.
. 1
. 1
UDPTable attribute group . . . . . .

Disk capacity planning for historical data .
.
.
.
.
. 90
. 91
Chapter 4. Situations reference . . . . 93

Chapter 2. Workspaces reference . . . . 3
About workspaces . . . . . . . . . . . .
More information about workspaces . . . . . .
Predefined workspaces . . . . . . . . . . .
Agent Navigator items . . . . . . . . . . .
Network Devices Navigator item . . . . . .
Monitored Network Devices nodes Navigator item
Performance Object Status Navigator item . . .
Monitored Network Devices subnode . . . . . .
Monitored Network Devices Navigator item . . .
nma Performance Object Status Navigator item . .
3
3
4
4
4
5
5
5
5
6
Chapter 3. Attributes reference . . . . . 7

About attributes . . . . . . . . . . . .
More information about attributes . . . . . .
Attribute groups and attributes for the Network
Devices agent . . . . . . . . . . . . .
IfTable attribute group . . . . . . . . . .
IfToIpMap attribute group . . . . . . . .
Interfaces attribute group . . . . . . . . .
IP attribute group . . . . . . . . . . .
IpAddrTable attribute group. . . . . . . .
IpRouteTable attribute group . . . . . . .
Monitored Network Devices nodes attribute group
nma Performance Object Status attribute group .
Performance Object Status attribute group . . .
SNMP attribute group . . . . . . . . . .
System attribute group . . . . . . . . .
TCP attribute group . . . . . . . . . .
TCPConnTable attribute group . . . . . . .
Thread Pool Status attribute group . . . . .
UDP attribute group . . . . . . . . . .
Copyright IBM Corp. 2009, 2010
. 7
. 7
. 7
. 9
. 22
. 37
. 38
. 46
. 48
52
. 53
. 59
. 64
. 75
. 77
. 82
. 84
. 88
About situations . . . . . . . . . .
More information about situations . . . .
Predefined situations . . . . . . . .
Monitored Network Devices (nma) subnode
KN4_IPHdrErrors . . . . . . . .
KN4_InterfaceDown . . . . . . .
KN4_PacketsOnError . . . . . . .
KN4_TCPinErrors . . . . . . . .
KN4_UDPinErrors . . . . . . . .
KN4_ipInAddrErrors . . . . . . .
KN4_snmpInASNParseErrs . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
93
93
94
94
94
94
94
95
95
95
95
Chapter 5. Take Action commands

reference. . . . . . . . . . . . . . 97
About Take Action commands . . . . . . .
More information about Take Action commands .
Predefined Take Action commands . . . . .
. 97
. 97
. 97
Chapter 6. Policies reference . . . . . 99

About policies . . . . . .
More information about policies
Predefined policies . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 99
. 99
. 99
Appendix A. IBM Tivoli Enterprise

Console event mapping . . . . . . . 101
Appendix B. Notices . . . . . . . . 111
Trademarks .
. 113
Index . . . . . . . . . . . . . . . 115
iii
iv
Network Devices agent: Reference Guide
Chapter 1. Overview of the agent

The IBM Tivoli Foundations Application Manager Agent for Network Devices
provides you with the capability to monitor network devices and systems. This
chapter provides a description of the features, components, and interface options
for the Network Devices agent.
Features of the monitoring agent

The Network Devices agent monitors SNMP-enabled devices. The agent identifies
and notifies you of common network problems as reported by SNMP
MIB-II-enabled devices. The software includes the following features:
v
v
v
v
SNMPv1, SNMPv2c, SNMPv3

MIB-II network monitoring standards
Historical data collection for further analysis
Automatic sampling of data and notification when certain conditions occur
User interface options

Installation of the base software and other integrated applications provides the
following interfaces that you can use to work with your resources and data:
Tivoli Enterprise Portal browser client interface
The browser client interface is automatically installed with the Tivoli
Enterprise Portal Server. To start the Tivoli Enterprise Portal browser client
in your Internet browser, enter the URL for a specific Tivoli Enterprise
Portal browser client installed on your Web server.
Manage Tivoli Enterprise Monitoring Services window
The window for the Manage Tivoli Enterprise Monitoring Services utility is
used for configuring the agent and starting Tivoli services not already
designated to start automatically.
IBM Tivoli Enterprise Console
An event management application that integrates system, network,
database, and application management to help ensure the optimal
availability of an IT services for an organization.
Tivoli Netcool/OMNIbus event list
You can use the event list to monitor and manage alerts. An alert is created
when the ObjectServer receives an event, alarm, message, or data item.
Each alert is made up of columns (or fields) of information that are held in
a row in the ObjectServer alerts.status table. In addition, the Tivoli
Netcool/OMNIbus Web GUI is a Web-based application that processes
network events from one or more data sources and presents the event data
in various graphical formats.
Chapter 2. Workspaces reference

This chapter contains an overview of workspaces, references for detailed
information about workspaces, and descriptions of the predefined workspaces
included in this monitoring agent.
About workspaces
A workspace is the working area of the Tivoli Enterprise Portal application
window. At the left of the workspace, is a Navigator that you use to select the
workspace you want to see. As part of the application window, the right side of
the status bar shows the Tivoli Enterprise Portal server name and port number to
which the displayed information applies, and the ID of the current user.
When you select an item in the Navigator tree, a default workspace is displayed.
When you right-click a Navigator item, a menu that includes a Workspace item is
displayed. The Workspace item contains a list of workspaces for that Navigator
item. Each workspace has at least one view. Some views have links to other
workspaces.
This monitoring agent provides predefined workspaces. You cannot modify or
delete the predefined workspaces, but you can create new workspaces by editing
them and saving the changes with a different name.
The Network Devices agent provides various default workspaces. These
workspaces are displayed in the Navigator tree under the following nodes and
subnodes for this monitoring agent:
Network Devices (N4 node)
Corresponds to a Network Devices instance and contains agent
instance-level workspaces.
Monitored Network Devices (nma subnode)
Contains the network monitored devices.
When an instance of the monitoring agent is defined on a system, the top-level
node is Network Devices - Instance:Hostname:N4. The Network Devices workspace
is defined at this node.
A table view within a workspace corresponds to a group of attributes; the columns
in the table view show some or all of the attributes available in the attribute group.
More information about workspaces

For more information about creating, customizing, and working with workspaces,
see the Tivoli Enterprise Portal User's Guide.
For a list of the predefined workspaces for this monitoring agent and a description
of each workspace, see the Predefined workspaces section in this chapter and the
information in that section for each individual workspace.
Some attribute groups for this monitoring agent might not be represented in the
predefined workspaces or views for this agent. For a full list of the attribute
groups, see the Attributes reference section.
Predefined workspaces
The Network Devices agent provides the following predefined workspaces, which
are organized by Navigator item.
Agent-level navigator items
v Network Devices Navigator item
Network Devices workspace
v Monitored Network Devices nodes Navigator item
Monitored Network Devices nodes workspace
v Performance Object Status Navigator item
Performance Object Status workspace
v Monitored Network Devices Navigator item
Monitored Network Devices workspace
Interface Status workspace
v nma Performance Object Status Navigator item
nma Performance Object Status workspace
Agent Navigator items

This section contains descriptions of predefined workspaces. The workspaces are
organized by the Navigator item to which the workspaces are relevant.
Network Devices Navigator item

Network Devices workspace
The Network Monitor Agent Self Monitoring workspace is the root
workspace of the Network Devices agent. This workspace contains
information that reflects the health of your actively monitored network
devices and your Network Devices agent.
This workspace contains the following views:
Situation Event Console
This view displays the situation events reported by all network
devices that are being monitored. Each event might indicate a
potential network device health problem, and should be reviewed
and processed.
Monitored Devices Information
This view lists the network devices actively monitored by the
Network Devices agent, and also provides the version of the
monitored device.
Self Monitoring Statistics
This view displays the self-monitoring information on the
performance of the Network Devices agent. You can find out if the
agent has encountered errors, when the last data collection was
performed, and how many data collections the agent has
performed.
Monitored Network Devices nodes Navigator item

This workspace lists all the network devices that are actively monitored by
the agent for Network Devices.
This workspace contains the following view:
Report
This view lists the network devices actively monitored by the agent
for Network Devices, and also provides the version of the
monitored device.
Performance Object Status Navigator item

Performance Object Status workspace
The Data Collection Status workspace displays the overall health of the
application.
Data Collection Status
Displays the status of the collection of data from the application.
Normally this will display NO ERROR indicating that the agent is
collecting application data correctly. If some of the agent's other
views are empty this view will help isolate the cause of the failure.
SNMP objects will display a descriptive name of the MIB object
and NO INSTANCES RETURNED if it receives an answer but
there are no instances present, or NO RESPONSE RECEIVED if the
the SNMP agent does not answer, or AUTHENTICATION FAILED
if a version 3 authorization failure occurs, or GENERAL
RESPONSE ERROR if the received data has the error flag set. .
Monitored Network Devices subnode

This section contains descriptions of predefined workspaces. The workspaces are
organized by the Navigator item to which the workspaces are relevant.
Monitored Network Devices Navigator item

Monitored Network Devices workspace
The default workspace for the Monitored Network Devices node is the
Interface Statistics workspace. This workspace contains information about
the network interfaces in the monitored node. Network interface
throughput data is plotted for easy inspection.
Current Interface Throughput
This view plots a chart that visualizes interface throughput
information. Only interfaces that have an operation status of up
(ifOperStatus) are included. Interface bandwidth (ifSpeed) is drawn
as a bar chart and additional lines show the inbound packet rate
(ifInOctetsPerSec) and the outbound packet rate
(ifOutOctetsPerSec) information.
Cumulative Rate of Transmission
This view plots a chart that summarizes the inbound packet rate
(ifInOctetsPerSec) and the outbound packet rate
(ifOutOctetsPerSec) from all network interfaces.
Chapter 2. Workspaces reference
Interface Statistics Table

This view displays the information about the network interface. All
information collected pertaining to the network interface is
displayed in the table.
Interface Status workspace
The Interface Status workspace displays all network interface performance
data with an emphasis on operation status and IP addresses.
Interfaces Status
This view displays a chart that shows the number of interfaces that
are currently operational and non-operational.
Interface to IP Address Mapping
This view displays a list that shows the mapping between the
network interfaces and IP addresses. The net mask and interface
type are also displayed.
Interface Status Table
This view displays the information about the network interface. All
information collected pertaining to the network interface is
displayed in the table.
nma Performance Object Status Navigator item

nma Performance Object Status workspace
The Data Collection Status workspace displays the overall health of the
application.
Data Collection Status
Displays the status of the collection of data from the application.
Normally this will display NO ERROR indicating that the agent is
collecting application data correctly. If some of the agent's other
views are empty this view will help isolate the cause of the failure.
SNMP objects will display a descriptive name of the MIB object
and NO INSTANCES RETURNED if it receives an answer but
there are no instances present, or NO RESPONSE RECEIVED if the
the SNMP agent does not answer, or AUTHENTICATION FAILED
if a version 3 authorization failure occurs, or GENERAL
RESPONSE ERROR if the received data has the error flag set. .
Chapter 3. Attributes reference

This chapter contains an overview of attributes, references for detailed information
about attributes, and descriptions of the attributes for each attribute group
included in this monitoring agent.
About attributes
Attributes are the application properties that are being measured and reported by
the Network Devices agent.
Attributes are organized into groups according to their purpose. The attributes in a
group can be used in the following two ways:
v Chart or table views
Attributes are displayed in chart and table views. The chart and table views use
queries to specify which attribute values to request from a monitoring agent.
You use the Query editor to create a new query, modify an existing query, or
apply filters and set styles to define the content and appearance of a view based
on an existing query.
v Situations
You use attributes to create situations that monitor the state of your operating
system, database, or application. A situation describes a condition you want to
test. When you start a situation, the Tivoli Enterprise Portal compares the values
you have assigned to the situation attributes with the values collected by the
Network Devices agent and registers an event if the condition is met. You are
alerted to events by indicator icons that are displayed in the Navigator.
More information about attributes

For more information about using attributes and attribute groups, see the Tivoli
Enterprise Portal User's Guide.
For a list of the attributes groups, a list of the attributes in each attribute group,
and descriptions of the attributes for this monitoring agent, see the Attribute
groups and attributes section in this chapter.
Attribute groups and attributes for the Network Devices agent

This monitoring agent contains the following attribute groups. The table name
depends on the maximum table name limits of the target database being used for
the Tivoli Data Warehouse. If the maximum name is 30 characters, then any
warehouse table name longer than 30 characters is shortened to 30 characters.
v Attribute group name: IfTable
Table name: KN4IFTABLE
Warehouse table name: KN4_IFTABLE
v Attribute group name: IfToIpMap
Table name: KN4IFTOIPM
Warehouse table name: KN4_IFTOIPMAP or KN4IFTOIPM
v Attribute group name: Interfaces
Table name: KN4INTERFA
Warehouse table name: KN4_INTERFACES or KN4INTERFA

v Attribute group name: IP
Table name: KN4IP
Warehouse table name: KN4_IP
v Attribute group name: IpAddrTable
Table name: KN4IPADDRT
Warehouse table name: KN4_IPADDRTABLE or KN4IPADDRT
v Attribute group name: IpRouteTable
Table name: KN4IPROUTE
Warehouse table name: KN4_IPROUTETABLE or KN4IPROUTE
v Attribute group name: Monitored Network Devices nodes
Table name: KN4NMADS
Warehouse table name: KN4_MONITORED_NETWORK_DEVICES_NODES or
KN4NMADS
v Attribute group name: nma Performance Object Status
Table name: KN4NMAPOS
Warehouse table name: KN4_NMA_PERFORMANCE_OBJECT_STATUS or
KN4NMAPOS
v Attribute group name: Performance Object Status
Table name: KN4POBJST
Warehouse table name: KN4_PERFORMANCE_OBJECT_STATUS or
KN4POBJST
v Attribute group name: SNMP
Table name: KN4SNMP
Warehouse table name: KN4_SNMP
v Attribute group name: System
Table name: KN4SYSTEM
Warehouse table name: KN4_SYSTEM
v Attribute group name: TCP
Table name: KN4TCP
Warehouse table name: KN4_TCP
v Attribute group name: TCPConnTable
Table name: KN4TCPCONN
Warehouse table name: KN4_TCPCONNTABLE or KN4TCPCONN
v Attribute group name: Thread Pool Status
Table name: KN4THPLST
Warehouse table name: KN4_THREAD_POOL_STATUS or KN4THPLST
v Attribute group name: UDP
Table name: KN4UDP
Warehouse table name: KN4_UDP
v Attribute group name: UDPTable
Table name: KN4UDPTABL
Warehouse table name: KN4_UDPTABLE or KN4UDPTABL
The remaining sections of this chapter contain descriptions of these attribute

groups, which are listed alphabetically. The following information is provided for
each attribute group:
Historical group
Whether the attribute group is a historical type that you can roll off to a
data warehouse
Attribute descriptions
Description, type, and Warehouse name for each attribute in the attribute
group
Some attributes are designated as key attributes. A key attribute is an
attribute that is used in warehouse aggregation to identify rows of data
that represent the same object.
IfTable attribute group

Data gathered from SNMP Object IfTable. If the warehouse default setting is
enabled, data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
This attribute group is part of the default historical group, and is eligible for use
with Tivoli Data Warehouse.
The following list contains information about each attribute in the IfTable attribute
group:
Node attribute - This attribute is a key attribute.
Description
The managed system name of the agent.
Type
String
Warehouse name
NODE
Timestamp attribute
Description
The local time at the agent when the data was collected.
Type
String
Warehouse name
TIMESTAMP
ifIndex attribute - This attribute is a key attribute.
Description
A unique value for each interface. The value ranges between 1 and
the value of ifNumber. The value for each interface must remain
constant at least from one re-initialization of the entity's network
management system to the next re-initialization.
Type
Integer (Gauge) with enumerated values. The strings are displayed

in the Tivoli Enterprise Portal. The warehouse and queries return
the values shown in parentheses. The following values are defined:
v Value_Exceeds_Maximum (2147483647)
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by the
agent in the Tivoli Enterprise Portal.
Warehouse name
IFINDEX
ifDescr attribute
Description
A textual string containing information about the interface. This
string should include the name of the manufacturer, the product
name, and the version of the interface hardware or software.
Type
String
Warehouse name
IFDESCR
ifType attribute
Description
The type of interface. Additional values for ifType are assigned by
the Internet Assigned Numbers Authority (IANA), through
updating the syntax of the IANAifType textual convention.
Type
Integer with enumerated values. The strings are displayed in the

Tivoli Enterprise Portal. The warehouse and queries return the
values shown in parentheses. The following values are defined:
v other (1)
v regular1822 (2)
v hdh1822 (3)
v ddnX25 (4)
v rfc877x25 (5)
v ethernetCsmacd (6)
v iso88023Csmacd (7)
v iso88024TokenBus (8)
v iso88025TokenRing (9)
v iso88026Man (10)
v starLan (11)
v proteon10Mbit (12)
10
v
v
v
v
v
v
proteon80Mbit (13)
hyperchannel (14)
fddi (15)
lapb (16)
sdlc (17)
ds1 (18)
v
v
v
v
v
v
e1 (19)
basicISDN (20)
primaryISDN (21)
propPointToPointSerial (22)
ppp (23)
softwareLoopback (24)
v
v
v
v
v
eon (25)
ethernet3Mbit (26)
nsip (27)
slip (28)
ultra (29)
v
v
v
v
v
v
v
ds3 (30)
sip (31)
frameRelay (32)
rs232 (33)
para (34)
arcnet (35)
arcnetPlus (36)
v
v
v
v
v
v
atm (37)
miox25 (38)
sonet (39)
x25ple (40)
iso88022llc (41)
localTalk (42)
v smdsDxi (43)
v frameRelayService (44)
v v35 (45)
v
v
v
v
hssi (46)
hippi (47)
modem (48)
aal5 (49)
v sonetPath (50)
v sonetVT (51)
v smdsIcip (52)
v
v
v
v
v
propVirtual (53)
propMultiplexor (54)
ieee80212 (55)
fibre-channel (56)
hippiInterfaces (57)
v frameRelayInterconnect (58)
v aflane8023 (59)
v
v
v
v
v
v
v
aflane8025 (60)
cctEmul (61)
fastEther (62)
isdn (63)
v11 (64)
v36 (65)
g703-64k (66)
v g703-2mb (67)
v qllc (68)
v fastEtherFX (69)
11
v
v
v
v
v
channel (70)
iEEE80211 (71)
ibm370parChan (72)
eSCON (73)
dLSw (74)
v
v
v
v
v
v
v
iSDNs (75)
iSDNu (76)
lapd (77)
ip-switch (78)
rsrb (79)
atm-logical (80)
ds0 (81)
v
v
v
v
v
v
ds0Bundle (82)
bsc (83)
async (84)
cnr (85)
iso88025Dtr (86)
eplrs (87)
v arap (88)
v propCnls (89)
v hostPad (90)
v
v
v
v
termPad (91)
frameRelayMPI (92)
x213 (93)
adsl (94)
v radsl (95)
v sdsl (96)
v vdsl (97)
v
v
v
v
v
iso88025CRFPInt (98)
myrinet (99)
voiceEM (100)
voiceFXO (101)
voiceFXS (102)
v voiceEncap (103)
v voiceOverIp (104)
v
v
v
v
v
v
v
atmDxi (105)
atmFuni (106)
atmIma (107)
pppMultilinkBundle (108)
ipOverCdlc (109)
ipOverClaw (110)
stackToStack (111)
v virtualIpAddress (112)
v mpc (113)
v ipOverAtm (114)
12
v
v
v
v
v
iso88025Fiber (115)
tdlc (116)
gigabitEthernet (117)
hdlc (118)
lapf (119)
v
v
v
v
v
v
v
v37 (120)
x25mlp (121)
x25huntGroup (122)
transpHdlc (123)
interleave (124)
fast (125)
ip (126)
v
v
v
v
v
v
docsCableMaclayer (127)
docsCableDownstream (128)
docsCableUpstream (129)
a12MppSwitch (130)
tunnel (131)
coffee (132)
v ces (133)
v atmSubInterface (134)
v l2vlan (135)
v
v
v
v
l3ipvlan (136)
l3ipxvlan (137)
digitalPowerLine (138)
mediaMailOverIP (139)
v dtm (140)
v dcm (141)
v ipForward (142)
v msdsl (143)
v ieee1394 (144)
Warehouse name
IFTYPE
ifMtu attribute
Description
The size of the largest packet which can be sent or received on the
interface specified in octets. For interfaces that are used for
transmitting network datagrams, this is the size of the largest
network datagram that can be sent on the interface.
Type

13
Warehouse name
IFMTU
ifSpeed attribute
Description
An estimate of the interface's current bandwidth in bits per second.
For interfaces which do not vary in bandwidth or for those where
no accurate estimation can be made, this object should contain the
nominal bandwidth.
Type
Integer ( 64 Bit Gauge) with enumerated values. The strings are

displayed in the Tivoli Enterprise Portal. The warehouse and
queries return the values shown in parentheses. The following
values are defined:
Warehouse name
IFSPEED
ifPhysAddress attribute
Description
The interface's address at the protocol sub-layer. For example, for
an 802.x interface, this object normally contains a MAC address.
The interface's media-specific MIB must define the bit and byte
ordering and the format of the value of this object.
Type
String
Warehouse name
IFPHYSADDRESS or IFPHYSADDR
ifAdminStatus attribute
Description
The desired state of the interface. The testing(3) state indicates that
no operational packets can be passed. When a managed system
initializes, all interfaces start with ifAdminStatus in the down(2)
state.
Type

v up (1)
v down (2)
v testing (3)
Warehouse name
IFADMINSTATUS or IFADMINSTA
ifOperStatus attribute
14
Description
The current operational state of the interface. The testing(3) state
indicates that no operational packets can be passed. If
ifAdminStatus is down(2) then ifOperStatus should be down(2).
Type

v up (1)
v down (2)
v testing (3)
v
v
v
v
unknown (4)
dormant (5)
notPresent (6)
lowerLayerDown (7)
Warehouse name
IFOPERSTATUS or IFOPERSTAT
ifLastChange attribute
Description
The value of sysUpTime at the time the interface entered its
current operational state. If the current state was entered prior to
the last re-initialization of the local network management
subsystem, then this object contains a zero value.
Type
String
Warehouse name
IFLASTCHANGE or IFLASTCHAN
ifInOctets attribute
Description
The total number of octets received on the interface, includes
framing characters.
Type
Integer ( 64 Bit Counter) with enumerated values. The strings are

values are defined:
Warehouse name
IFINOCTETS
ifInUcastPkts attribute
Description
The number of packets, delivered by this sub-layer to a higher
layer or sub-layer, which were not addressed to a multicast or
broadcast address at this sub-layer.
15
Type
Integer (Counter) with enumerated values. The strings are

values are defined:
Warehouse name
IFINUCASTPKTS or IFINUCASTP
ifInNUcastPkts attribute
Description
layer or sub-layer, which were addressed to a multicast or
Type

values are defined:
Warehouse name
IFINNUCASTPKTS or IFINNUCAST
ifInDiscards attribute
Description
The number of inbound packets which were chosen to be
discarded even though no errors had been detected to prevent
their being deliverable to a higher-layer protocol. One possible
reason for discarding such a packet could be to free up buffer
space.
Type

values are defined:
Warehouse name
IFINDISCARDS or IFINDISCAR
ifInErrors attribute
Description
The number of inbound packets or transmission units that
contained errors preventing them from being deliverable to a
higher-layer protocol.
16
Type

values are defined:
Warehouse name
IFINERRORS
ifInUnknownProtos attribute
Description
The number of packets or transmission units received through the
interface which were discarded because of an unknown or
unsupported protocol. For any interface that does not support
protocol multiplexing, this counter will always be 0.
Type

values are defined:
Warehouse name
IFINUNKNOWNPROTOS or IFINUNKNOW
ifOutOctets attribute
Description
The total number of octets transmitted out of the interface,
including framing characters.
Type

values are defined:
Warehouse name
IFOUTOCTETS or IFOUTOCTET
ifOutUcastPkts attribute
Description
The total number of packets that higher-level protocols requested
be transmitted, which were not addressed to a multicast or
broadcast address at this sub-layer. This includes packets that were
discarded or not sent.
Type

17

values are defined:
Warehouse name
IFOUTUCASTPKTS or IFOUTUCAST
ifOutNUcastPkts attribute
Description
be transmitted, which were addressed to a multicast or broadcast
address at this sub-layer. This includes packets that were discarded
or not sent.
Type

values are defined:
Warehouse name
IFOUTNUCASTPKTS or IFOUTNUCAS
ifOutDiscards attribute
Description
The number of outbound packets which were chosen to be
their being transmitted. One possible reason for discarding such a
packet could be to free up buffer space.
Type

values are defined:
Warehouse name
IFOUTDISCARDS or IFOUTDISCA
ifOutErrors attribute
Description
The number of outbound packets or trasnission units that could
not be transmitted because of errors.
Type
18

values are defined:
Warehouse name
IFOUTERRORS or IFOUTERROR
ifOutQLen attribute
Description
The length of the output packet queue (in packets).
Type

Warehouse name
IFOUTQLEN
ifSpecific attribute
Description
A reference to MIB definitions specific to the particular media
being used to realize the interface. Typically this value point relates
to an instance of a MIB object in the media-specific MIB.
Type
String
Warehouse name
IFSPECIFIC
ifInOctetsInMil attribute
Description
The total number of octets received on the interface (in millions),
Type

values are defined:
Warehouse name
IFINOCTETSINMIL or IFINOCTET0
ifOutOctectsInMil attribute
19
Description
The total number of octets transmitted out of the interface (in
millions), including framing characters.
Type

values are defined:
Warehouse name
IFOUTOCTECTSINMIL or IFOUTOCTEC
ifOutOctectsPerSec attribute
Description
Type
Integer (rate of change between successive values) with

enumerated values. The strings are displayed in the Tivoli
Enterprise Portal. The warehouse and queries return the values
shown in parentheses. The following values are defined:
Warehouse name
IFOUTOCTECTSPERSEC or IFOUTOCTE0
ifInOctectsPerSec attribute
Description
The total number of octets received on the interface, including
framing characters.
Type

Warehouse name
IFINOCTECTSPERSEC or IFINOCTECT
ifInDiscardsPerSec attribute
Description
20

space.
Type

Warehouse name
IFINDISCARDSPERSEC or IFINDISCA0
ifInErrorsPerSec attribute
Description
Type

Warehouse name
IFINERRORSPERSEC or IFINERROR0
ifInUnknownProtosPerSec attribute
Description
interface that were discarded because of an unknown or
unsupported protocol.
Type

Warehouse name
IFINUNKNOWNPROTOSPERSEC or IFINUNKNO0
ifOutDiscardsPerSec attribute
Description
21

Type

Warehouse name
IFOUTDISCARDSPERSEC or IFOUTDISC0
ifOutErrorsPerSec attribute
Description
The number of outbound packets or transmission units that could
Type

Warehouse name
IFOUTERRORSPERSEC or IFOUTERRO0
ifOutQLenPerSec attribute
Description
Type

Warehouse name
IFOUTQLENPERSEC or IFOUTQLENP
IfToIpMap attribute group

This attribute groups shows the mapping of the interfaces to IP addresses. If the
warehouse default setting is enabled, data for this attribute group is stored in
Tivoli Data Warehouse.
22
Historical group
The following list contains information about each attribute in the IfToIpMap
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
ifIndex attribute - This attribute is a key attribute.
Description
A unique value for each interface. The value ranges between 1 and
the value of ifNumber. The value for each interface must remain
constant at least from one re-initialization of the entity's network
management system to the next re-initialization.
Type

Warehouse name
IFINDEX
ifDescr attribute
Description
A textual string containing information about the interface. This
string should include the name of the manufacturer, the product
name, and the version of the interface hardware or software.
Type
String
Warehouse name
IFDESCR
ifType attribute
Description
The type of interface. Additional values for ifType are assigned by
23
the Internet Assigned Numbers Authority (IANA), through

updating the syntax of the IANAifType textual convention.
Type

v other (1)
v regular1822 (2)
v hdh1822 (3)
v ddnX25 (4)
v rfc877x25 (5)
v ethernetCsmacd (6)
v iso88023Csmacd (7)
v iso88024TokenBus (8)
v
v
v
v
v
iso88025TokenRing (9)
iso88026Man (10)
starLan (11)
proteon10Mbit (12)
proteon80Mbit (13)
v hyperchannel (14)
v fddi (15)
v lapb (16)
v
v
v
v
sdlc (17)
ds1 (18)
e1 (19)
basicISDN (20)
v
v
v
v
primaryISDN (21)
propPointToPointSerial (22)
ppp (23)
softwareLoopback (24)
v eon (25)
v ethernet3Mbit (26)
v nsip (27)
v slip (28)
v ultra (29)
v
v
v
v
v
v
v
v
ds3 (30)
sip (31)
frameRelay (32)
rs232 (33)
para (34)
arcnet (35)
arcnetPlus (36)
atm (37)
v miox25 (38)
v sonet (39)
v x25ple (40)
24
v
v
v
v
v
iso88022llc (41)
localTalk (42)
smdsDxi (43)
frameRelayService (44)
v35 (45)
v
v
v
v
v
v
v
hssi (46)
hippi (47)
modem (48)
aal5 (49)
sonetPath (50)
sonetVT (51)
smdsIcip (52)
v
v
v
v
v
v
propVirtual (53)
propMultiplexor (54)
ieee80212 (55)
fibre-channel (56)
hippiInterfaces (57)
frameRelayInterconnect (58)
v aflane8023 (59)
v aflane8025 (60)
v cctEmul (61)
v
v
v
v
fastEther (62)
isdn (63)
v11 (64)
v36 (65)
v g703-64k (66)
v g703-2mb (67)
v qllc (68)
v
v
v
v
v
fastEtherFX (69)
channel (70)
iEEE80211 (71)
ibm370parChan (72)
eSCON (73)
v dLSw (74)
v iSDNs (75)
v
v
v
v
v
v
v
iSDNu (76)
lapd (77)
ip-switch (78)
rsrb (79)
atm-logical (80)
ds0 (81)
ds0Bundle (82)
v bsc (83)
v async (84)
v cnr (85)
25
v
v
v
v
v
iso88025Dtr (86)
eplrs (87)
arap (88)
propCnls (89)
hostPad (90)
v
v
v
v
v
v
v
termPad (91)
frameRelayMPI (92)
x213 (93)
adsl (94)
radsl (95)
sdsl (96)
vdsl (97)
v
v
v
v
v
v
iso88025CRFPInt (98)
myrinet (99)
voiceEM (100)
voiceFXO (101)
voiceFXS (102)
voiceEncap (103)
v voiceOverIp (104)
v atmDxi (105)
v atmFuni (106)
v
v
v
v
atmIma (107)
pppMultilinkBundle (108)
ipOverCdlc (109)
ipOverClaw (110)
v stackToStack (111)
v virtualIpAddress (112)
v mpc (113)
v
v
v
v
v
ipOverAtm (114)
iso88025Fiber (115)
tdlc (116)
gigabitEthernet (117)
hdlc (118)
v lapf (119)
v v37 (120)
v
v
v
v
v
v
v
x25mlp (121)
x25huntGroup (122)
transpHdlc (123)
interleave (124)
fast (125)
ip (126)
docsCableMaclayer (127)
v docsCableDownstream (128)
v docsCableUpstream (129)
v a12MppSwitch (130)
26
v
v
v
v
v
tunnel (131)
coffee (132)
ces (133)
atmSubInterface (134)
l2vlan (135)
v
v
v
v
v
v
v
l3ipvlan (136)
l3ipxvlan (137)
digitalPowerLine (138)
mediaMailOverIP (139)
dtm (140)
dcm (141)
ipForward (142)
v msdsl (143)
v ieee1394 (144)
Warehouse name
IFTYPE
ifMtu attribute
Description
The size of the largest packet which can be sent or received on the
interface specified in octets. For interfaces that are used for
transmitting network datagrams, this is the size of the largest
network datagram that can be sent on the interface.
Type

Warehouse name
IFMTU
ifSpeed attribute
Description
An estimate of the interface's current bandwidth in bits per second.
For interfaces which do not vary in bandwidth or for those where
no accurate estimation can be made, this object should contain the
nominal bandwidth.
Type
Integer ( 64 Bit Gauge) with enumerated values. The strings are

values are defined:
27
Warehouse name
IFSPEED
ifPhysAddress attribute
Description
The interface's address at the protocol sub-layer. For example, for
an 802.x interface, this object normally contains a MAC address.
The interface's media-specific MIB must define the bit and byte
ordering and the format of the value of this object.
Type
String
Warehouse name
IFPHYSADDRESS or IFPHYSADDR
ifAdminStatus attribute
Description
The desired state of the interface. The testing(3) state indicates that
no operational packets can be passed. When a managed system
initializes, all interfaces start with ifAdminStatus in the down(2)
state.
Type

v up (1)
v down (2)
v testing (3)
Warehouse name
IFADMINSTATUS or IFADMINSTA
ifOperStatus attribute
Description
The current operational state of the interface. The testing(3) state
indicates that no operational packets can be passed. If
ifAdminStatus is down(2) then ifOperStatus should be down(2).
Type

v up (1)
v
v
v
v
v
v
down (2)
testing (3)
unknown (4)
dormant (5)
notPresent (6)
lowerLayerDown (7)
28
Warehouse name
IFOPERSTATUS or IFOPERSTAT
ifLastChange attribute
Description
The value of sysUpTime at the time the interface entered its
current operational state. If the current state was entered prior to
the last re-initialization of the local network management
subsystem, then this object contains a zero value.
Type
String
Warehouse name
IFLASTCHANGE or IFLASTCHAN
ifInOctets attribute
Description
The total number of octets received on the interface, includes
framing characters.
Type

values are defined:
Warehouse name
IFINOCTETS
ifInUcastPkts attribute
Description
layer or sub-layer, which were not addressed to a multicast or
Type

values are defined:
Warehouse name
IFINUCASTPKTS or IFINUCASTP
ifInNUcastPkts attribute
Description
layer or sub-layer, which were addressed to a multicast or
Type

29

values are defined:
Warehouse name
IFINNUCASTPKTS or IFINNUCAST
ifInDiscards attribute
Description
space.
Type

values are defined:
Warehouse name
IFINDISCARDS or IFINDISCAR
ifInErrors attribute
Description
Type

values are defined:
Warehouse name
IFINERRORS
ifInUnknownProtos attribute
Description
interface which were discarded because of an unknown or
unsupported protocol. For any interface that does not support
protocol multiplexing, this counter will always be 0.
30
Type

values are defined:
Warehouse name
IFINUNKNOWNPROTOS or IFINUNKNOW
ifOutOctets attribute
Description
Type

values are defined:
Warehouse name
IFOUTOCTETS or IFOUTOCTET
ifOutUcastPkts attribute
Description
be transmitted, which were not addressed to a multicast or
broadcast address at this sub-layer. This includes packets that were
discarded or not sent.
Type

values are defined:
Warehouse name
IFOUTUCASTPKTS or IFOUTUCAST
ifOutNUcastPkts attribute
Description
be transmitted, which were addressed to a multicast or broadcast
address at this sub-layer. This includes packets that were discarded
or not sent.
Type

31

values are defined:
Warehouse name
IFOUTNUCASTPKTS or IFOUTNUCAS
ifOutDiscards attribute
Description
Type

values are defined:
Warehouse name
IFOUTDISCARDS or IFOUTDISCA
ifOutErrors attribute
Description
The number of outbound packets or trasnission units that could
Type

values are defined:
Warehouse name
IFOUTERRORS or IFOUTERROR
ifOutQLen attribute
Description
Type
32

Warehouse name
IFOUTQLEN
ifSpecific attribute
Description
A reference to MIB definitions specific to the particular media
being used to realize the interface. Typically this value point relates
to an instance of a MIB object in the media-specific MIB.
Type
String
Warehouse name
IFSPECIFIC
ifInOctetsInMil attribute
Description
The total number of octets received on the interface (in millions),
Type

values are defined:
Warehouse name
IFINOCTETSINMIL or IFINOCTET0
ifOutOctectsInMil attribute
Description
The total number of octets transmitted out of the interface (in
millions), including framing characters.
Type

values are defined:
Warehouse name
IFOUTOCTECTSINMIL or IFOUTOCTEC
ifOutOctectsPerSec attribute
Description
33
Type

Warehouse name
IFOUTOCTECTSPERSEC or IFOUTOCTE0
ifInOctectsPerSec attribute
Description
The total number of octets received on the interface, including
framing characters.
Type

Warehouse name
IFINOCTECTSPERSEC or IFINOCTECT
ifInDiscardsPerSec attribute
Description
space.
Type

Warehouse name
IFINDISCARDSPERSEC or IFINDISCA0
ifInErrorsPerSec attribute
Description
Type
34

Warehouse name
IFINERRORSPERSEC or IFINERROR0
ifInUnknownProtosPerSec attribute
Description
interface that were discarded because of an unknown or
unsupported protocol.
Type

Warehouse name
IFINUNKNOWNPROTOSPERSEC or IFINUNKNO0
ifOutDiscardsPerSec attribute
Description
Type

Warehouse name
IFOUTDISCARDSPERSEC or IFOUTDISC0
ifOutErrorsPerSec attribute
Description
The number of outbound packets or transmission units that could
Type

35

Warehouse name
IFOUTERRORSPERSEC or IFOUTERRO0
ifOutQLenPerSec attribute
Description
Type

Warehouse name
IFOUTQLENPERSEC or IFOUTQLENP
ipAdEntAddr attribute - This attribute is a key attribute.
Description
The IP address for a set of pertaining informaiton.
Type
String
Warehouse name
IPADENTADDR or IPADENTADD
ipAdEntIfIndex attribute
Description
The index value which uniquely identifies the interface pertaining
to a specific entry. The interface identified by a particular value of
this index is the same interface as identified by the same value of
RFC 1573's ifIndex.
Type

Warehouse name
IPADENTIFINDEX or IPADENTIFI
ipAdEntNetMask attribute
36
Description
The subnet mask associated with the IP address for a specific entry.
The value of the mask is an IP address with all the network bits set
to 1 and all the hosts bits set to 0.
Type
String
Warehouse name
IPADENTNETMASK or IPADENTNET
ipAdEntBcastAddr attribute
Description
The value of the least significant bit in the IP broadcast address
used for sending datagrams on the (logical) interface associated
with the IP address.
Type

Warehouse name
IPADENTBCASTADDR or IPADENTBCA
ipAdEntReasmMaxSize attribute
Description
The size of the largest IP datagram which this entity can
reassemble from incoming IP fragmented datagrams received on
the interface.
Type

Warehouse name
IPADENTREASMMAXSIZE or IPADENTREA
Interfaces attribute group

Data gathered from SNMP Object Interfaces. If the warehouse default setting is
Historical group
37
The following list contains information about each attribute in the Interfaces
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
ifNumber attribute
Description
The number of network interfaces (regardless of their current state)
present on this system.
Type

Warehouse name
IFNUMBER
IP attribute group
Data gathered from SNMP Object IP. If the warehouse default setting is enabled,
data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
The following list contains information about each attribute in the IP attribute
group:
Description
Type
38
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
ipForwarding attribute
Description
Indicates whether the entity is acting as an IP router for forwarded
datagrams. IP routers forward datagrams; IP hosts do not forward
datagrams (except those source-routed through the host).
Type

v forwarding (1)
v notForwarding (2)
Warehouse name
IPFORWARDING or IPFORWARDI
ipDefaultTTL attribute
Description
The default value inserted into the Time-To-Live field of the IP
header for datagrams originated at the entity. A TTL value is not
supplied by the transport layer protocol.
Type

Warehouse name
IPDEFAULTTTL or IPDEFAULTT
ipInReceives attribute
Description
The total number of input datagrams received from interfaces,
including those received in error.
Type

values are defined:
39
Warehouse name
IPINRECEIVES or IPINRECEIV
ipInHdrErrors attribute
Description
The number of input datagrams discarded due to errors in their IP
headers, including: bad checksums, version number mismatch,
format errors, Time-To-Live exceeded, and errors discovered in
processing IP options.
Type

values are defined:
Warehouse name
IPINHDRERRORS or IPINHDRERR
ipInAddrErrors attribute
Description
The number of input datagrams discarded because the IP address
in the IP header's destination field was not a valid address to be
received. This count includes invalid addresses (such as 0.0.0.0)
and addresses of unsupported classes (such as, Class E).
Type

values are defined:
Warehouse name
IPINADDRERRORS or IPINADDRER
ipForwDatagrams attribute
Description
The number of input datagrams that do not point to this entity as
a final IP destination. These datagrams result in an attempt to find
a route to forward them to their final destination.
Type

values are defined:
40
Warehouse name
IPFORWDATAGRAMS or IPFORWDATA
ipInUnknownProtos attribute
Description
The number of locally-addressed datagrams received successfully
but discarded because of an unknown or unsupported protocol.
Type

values are defined:
Warehouse name
IPINUNKNOWNPROTOS or IPINUNKNOW
ipInDiscards attribute
Description
The number of input IP datagrams for which no problems were
encountered to prevent their continued processing, but which were
discarded. This counter does not include any datagrams discarded
while awaiting reassembly.
Type

values are defined:
Warehouse name
IPINDISCARDS or IPINDISCAR
ipInDelivers attribute
Description
The total number of input datagrams successfully delivered to IP
user-protocols (including ICMP).
Type

values are defined:
41
Warehouse name
IPINDELIVERS or IPINDELIVE
ipOutRequests attribute
Description
The total number of IP datagrams that local IP user-protocols
(including ICMP) supplied to IP in requests for transmission. This
counter does not include any datagrams counted in
ipForwDatagrams.
Type

values are defined:
Warehouse name
IPOUTREQUESTS or IPOUTREQUE
ipOutDiscards attribute
Description
The number of output IP datagrams for which no problem was
encountered to prevent their transmission to their destination, but
that were discarded. This counter includes datagrams counted in
ipForwDatagrams that meet the discard criteria.
Type

values are defined:
Warehouse name
IPOUTDISCARDS or IPOUTDISCA
ipOutNoRoutes attribute
Description
The number of IP datagrams discarded because no route could be
found to transmit them to their destination. This also includes
datagrams that a host cannot route becauase all of its default
gateways are down.
Type
42

values are defined:
Warehouse name
IPOUTNOROUTES or IPOUTNOROU
ipReasmTimeout attribute
Description
The maximum number of seconds that received fragments are held
while awaiting reassembly at this entity.
Type

Warehouse name
IPREASMTIMEOUT or IPREASMTIM
ipReasmReqds attribute
Description
The number of IP fragments received that need to be reassembled
at this entity.
Type

values are defined:
Warehouse name
IPREASMREQDS or IPREASMREQ
ipReasmOKs attribute
Description
The number of IP datagrams successfully reassembled.
Type

values are defined:
Warehouse name
IPREASMOKS
ipReasmFails attribute
43
Description
The number of failures detected by the IP reassembly algorithm.
This is not a count of discarded IP fragments. Note: Some
algorithms (such as the algorithm in RFC 815) can lose track of the
number of fragments by combining them as they are received.
Type

values are defined:
Warehouse name
IPREASMFAILS or IPREASMFAI
ipFragOKs attribute
Description
The number of IP datagrams that have been successfully
fragmented at this entity.
Type

values are defined:
Warehouse name
IPFRAGOKS
ipFragFails attribute
Description
The number of IP datagrams that have been discarded because
they needed to be fragmented at this entity but could not be. One
reason could be their Don't Fragment flag was set.
Type

values are defined:
Warehouse name
IPFRAGFAILS or IPFRAGFAIL
ipFragCreates attribute
44
Description
The number of IP datagram fragments that have been generated as
a result of fragmentation at this entity.
Type

values are defined:
Warehouse name
IPFRAGCREATES or IPFRAGCREA
ipRoutingDiscards attribute
Description
The number of routing entries that were chosen to be discarded
even though they were valid. One possible reason for discarding
such an entry could be to free-up buffer space for other routing
entries.
Type

values are defined:
Warehouse name
IPROUTINGDISCARDS or IPROUTINGD
ipInHdrErrorsPerSec attribute
Description
The number of input datagrams discarded due to errors in their IP
headers, including: bad checksums, version number mismatch,
format errors, time-to-live exceeded, and errors discovered in
processing IP options.
Type

Warehouse name
IPINHDRERRORSPERSEC or IPINHDRER0
ipInAddrErrorsPerSec attribute
45
Description
The number of input datagrams discarded because the IP address
in their IP header's destination field was not a valid address to be
received at this entity. This count includes invalid addresses (such
as 0.0.0.0) and addresses of unsupported classes.
Type

Warehouse name
IPINADDRERRORSPERSEC or IPINADDRE0
IpAddrTable attribute group

Data gathered from SNMP Object IpAddrTable. If the warehouse default setting is
Historical group
The following list contains information about each attribute in the IpAddrTable
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
ipAdEntAddr attribute - This attribute is a key attribute.
Description
The IP address for a set of pertaining informaiton.
Type
String
Warehouse name
IPADENTADDR or IPADENTADD
46
ipAdEntIfIndex attribute
Description
The index value which uniquely identifies the interface pertaining
to a specific entry. The interface identified by a particular value of
this index is the same interface as identified by the same value of
RFC 1573's ifIndex.
Type

Warehouse name
IPADENTIFINDEX or IPADENTIFI
ipAdEntNetMask attribute
Description
The subnet mask associated with the IP address for a specific entry.
The value of the mask is an IP address with all the network bits set
to 1 and all the hosts bits set to 0.
Type
String
Warehouse name
IPADENTNETMASK or IPADENTNET
ipAdEntBcastAddr attribute
Description
The value of the least significant bit in the IP broadcast address
used for sending datagrams on the (logical) interface associated
with the IP address.
Type

Warehouse name
IPADENTBCASTADDR or IPADENTBCA
ipAdEntReasmMaxSize attribute
Description
The size of the largest IP datagram which this entity can
reassemble from incoming IP fragmented datagrams received on
the interface.
Type

47
Warehouse name
IPADENTREASMMAXSIZE or IPADENTREA
IpRouteTable attribute group

Data gathered from SNMP Object IpRouteTable. If the warehouse default setting is
Historical group
The following list contains information about each attribute in the IpRouteTable
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
ipRouteDest attribute - This attribute is a key attribute.
Description
The destination IP address of the route. A default route is 0.0.0.0.
Multiple routes to a single destination appear in the table, but
access to multiple entries is dependent on the table access
mechanisms defined by the network management protocol in use.
Type
String
Warehouse name
IPROUTEDEST or IPROUTEDES
ipRouteIfIndex attribute
Description
The index value which uniquely identifies the local interface
through which the next hop in the route should be reached. The
interface identified by a particular value of this index is the same
interface as identified by the same value of ifIndex.
Type
48

Warehouse name
IPROUTEIFINDEX or IPROUTEIFI
ipRouteMetric1 attribute
Description
The primary routing metric for the route. The semantics of this
metric are determined by the routing protocol specified in the
route's ipRouteProto value. If this metric is not used, the value
should be set to -1.
Type

Warehouse name
IPROUTEMETRIC1 or IPROUTEMET
Description
An alternate routing metric for the route. The semantics of this
Type

Warehouse name
IPROUTEMETRIC2 or IPROUTEME0
Description
Type

49
Warehouse name
Description
Type

Warehouse name
ipRouteNextHop attribute
Description
The IP address of the next hop in the route. (In the case of a route
bound to an interface which is realized through a broadcast media,
the value of this field is the agent's IP address on that interface.)
Type
String
Warehouse name
IPROUTENEXTHOP or IPROUTENEX
ipRouteType attribute
Description
The type of route. Note: The values direct(3) and indirect(4) refer
to direct and indirect routing in the IP architecture. Setting this
object to invalid(2), invalidates the corresponding entry in the
ipRouteTable object.
Type

v other (1)
v invalid (2)
v direct (3)
v indirect (4)
Warehouse name
IPROUTETYPE or IPROUTETYP
50
ipRouteProto attribute
Description
The routing mechanism that learned the route. Inclusion of values
for gateway routing protocols is not intended to imply that hosts
should support those protocols.
Type

v other (1)
v local (2)
v netmgmt (3)
v icmp (4)
v egp (5)
v ggp (6)
v
v
v
v
v
hello (7)
rip (8)
is-is (9)
es-is (10)
ciscoIgrp (11)
v bbnSpfIgp (12)
v ospf (13)
v bgp (14)
Warehouse name
IPROUTEPROTO or IPROUTEPRO
ipRouteAge attribute
Description
The number of seconds since the route was last updated or
otherwise determined to be correct.
Type

Warehouse name
IPROUTEAGE
ipRouteMask attribute
Description
Indicates if the mask is logical to the destination address before
being compared to the value in the ipRouteDest field.
Type
String
51
Warehouse name
IPROUTEMASK or IPROUTEMAS
Description
metric are determined by the routing-protocol specified in the
Type

Warehouse name
ipRouteInfo attribute
Description
A reference to MIB definitions specific to the particular routing
protocol responsible for this route, as determined by the value
specified in the route's ipRouteProto value.
Type
String
Warehouse name
IPROUTEINFO or IPROUTEINF
Monitored Network Devices nodes attribute group

Contains the network monitored devices. If the warehouse default setting is
Historical group
This attribute group is part of the default historical group, and is not eligible for
use with Tivoli Data Warehouse.
The following list contains information about each attribute in the Monitored
Network Devices nodes attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
52
Description
Type
String
Warehouse name
TIMESTAMP
Subnode MSN attribute - This attribute is a key attribute.
Description
This is the Managed System Name of the subnode agent.
Type
String
Warehouse name
SUBNODE_MSN or SN_MSN
Subnode Affinity attribute
Description
This is the affinity for the subnode agent.
Type
String
Warehouse name
SUBNODE_AFFINITY or SN_AFFIN
Subnode Type attribute - This attribute is a key attribute.
Description
This is the Node Type of this subnode.
Type
String
Warehouse name
SUBNODE_TYPE or SN_TYPE
Subnode Resource Name attribute
Description
This is the Resource Name of the subnode agent.
Type
String
Warehouse name
SUBNODE_RESOURCE_NAME or SN_RES
Subnode Version attribute
Description
This is the Version of the subnode agent.
Type
String
Warehouse name
SUBNODE_VERSION or SN_VER
nma Performance Object Status attribute group

The Performance Object Status attribute group contains information that reflects
the status of other attribute groups so you can see the status of all of the
performance objects that make up this application all at once. Each of these other
performance attribute groups is represented by a row in this table (or other type of
view). The status for an attribute group reflects the result of the last attempt to
collect data for that attribute group, which allows you to see whether the agent is
53
performing correctly. Unlike other attribute groups, the Performance Object Status
attribute group does not reflect the state of the monitored application. This
attribute group is most often used to determine why data is not available for one
of the performance attribute groups. If the warehouse default setting is enabled,
Historical group
The following list contains information about each attribute in the nma
Performance Object Status attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
Query Name attribute - This attribute is a key attribute.
Description
The name of the attribute group.
Type
String
Warehouse name
QUERY_NAME or ATTRGRP
Object Name attribute
Description
The name of the performance object.
Type
String
Warehouse name
OBJECT_NAME or OBJNAME
Object Type attribute
Description
The type of the performance object.
Type

v WMI (0)
v PERFMON (1)
54
v
v
v
v
v
WMI_ASSOCIATION_GROUP (2)
JMX (3)
SNMP (4)
SHELL_COMMAND (5)
JOINED_GROUPS (6)
v
v
v
v
v
v
v
CIMOM (7)
CUSTOM (8)
ROLLUP_DATA (9)
WMI_REMOTE_DATA (10)
LOG_FILE (11)
JDBC (12)
CONFIG_DISCOVERY (13)
v
v
v
v
v
v
NT_EVENT_LOG (14)
FILTER (15)
SNMP_EVENT (16)
PING (17)
DIRECTOR_DATA (18)
DIRECTOR_EVENT (19)
Warehouse name
OBJECT_TYPE or OBJTYPE
Object Status attribute
Description
The status of the performance object.
Type

v ACTIVE (0)
v INACTIVE (1)
Warehouse name
OBJECT_STATUS or OBJSTTS
Error Code attribute
Description
The error code associated with the query
Type

v NO_ERROR (0)
v GENERAL_ERROR (1)
v OBJECT_NOT_FOUND (2)
v COUNTER_NOT_FOUND (3)
v NAMESPACE_ERROR (4)
55
v
v
v
v
v
OBJECT_CURRENTLY_UNAVAILABLE (5)
COM_LIBRARY_INIT_FAILURE (6)
SECURITY_INIT_FAILURE (7)
PROXY_SECURITY_FAILURE (9)
NO_INSTANCES_RETURNED (10)
ASSOCIATOR_QUERY_FAILED (11)
REFERENCE_QUERY_FAILED (12)
NO_RESPONSE_RECEIVED (13)
CANNOT_FIND_JOINED_QUERY (14)
CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_1_RESULTS
(15)
v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_2_RESULTS
(16)
v
v
v
v
v
v
v
v
v
v
QUERY_1_NOT_A_SINGLETON (17)
NO_INSTANCES_RETURNED_IN_QUERY_1 (19)
CANNOT_FIND_ROLLUP_QUERY (21)
v CANNOT_FIND_ROLLUP_ATTRIBUTE (22)
v FILE_OFFLINE (23)
v NO_HOSTNAME (24)
v
v
v
v
MISSING_LIBRARY (25)
ATTRIBUTE_COUNT_MISMATCH (26)
ATTRIBUTE_NAME_MISMATCH (27)
COMMON_DATA_PROVIDER_NOT_STARTED (28)
v
v
v
v
CALLBACK_REGISTRATION_ERROR (29)
MDL_LOAD_ERROR (30)
AUTHENTICATION_FAILED (31)
CANNOT_RESOLVE_HOST_NAME (32)
v SUBNODE_UNAVAILABLE (33)
v SUBNODE_NOT_FOUND_IN_CONFIG (34)
v ATTRIBUTE_ERROR (35)
v CLASSPATH_ERROR (36)
v CONNECTION_FAILURE (37)
v
v
v
v
v
v
v
v
FILTER_SYNTAX_ERROR (38)
FILE_NAME_MISSING (39)
SQL_QUERY_ERROR (40)
SQL_FILTER_QUERY_ERROR (41)
SQL_DB_QUERY_ERROR (42)
SQL_DB_FILTER_QUERY_ERROR (43)
PORT_OPEN_FAILED (44)
ACCESS_DENIED (45)
v TIMEOUT (46)
v NOT_IMPLEMENTED (47)
v REQUESTED_A_BAD_VALUE (48)
56
v
v
v
v
v
RESPONSE_TOO_BIG (49)
GENERAL_RESPONSE_ERROR (50)
SCRIPT_NONZERO_RETURN (51)
SCRIPT_NOT_FOUND (52)
SCRIPT_LAUNCH_ERROR (53)
v
v
v
v
v
v
CONF_FILE_DOES_NOT_EXIST (54)
CONF_FILE_ACCESS_DENIED (55)
INVALID_CONF_FILE (56)
EIF_INITIALIZATION_FAILED (57)
CANNOT_OPEN_FORMAT_FILE (58)
FORMAT_FILE_SYNTAX_ERROR (59)
Warehouse name
ERROR_CODE or ERRCODE
Last Collection Start attribute
Description
The most recent time a data collection of this group started
Type
Timestamp with enumerated values. The strings are displayed in

the Tivoli Enterprise Portal. The warehouse and queries return the
v NOT COLLECTED (0691231190000000)
Warehouse name
LAST_COLLECTION_START or COLSTRT
Last Collection Finished attribute
Description
The most recent time a data collection of this group finished
Type

v NOT COLLECTED (0691231190000000)
Warehouse name
LAST_COLLECTION_FINISHED or COLFINI
Last Collection Duration attribute
Description
The duration of the most recently completed data collection of this
group in seconds
Type
Real number (Counter) with 2 decimal places of precision
Warehouse name
LAST_COLLECTION_DURATION or COLDURA
57
Average Collection Duration attribute

Description
The average duration of all data collections of this group in
seconds
Type
Real number (Counter) with 2 decimal places of precision with

v NO DATA (-100)
Warehouse name
AVERAGE_COLLECTION_DURATION or COLAVGD
Refresh Interval attribute
Description
The interval at which this group is refreshed in seconds
Type
Integer (Counter)
Warehouse name
REFRESH_INTERVAL or REFRINT
Number of Collections attribute
Description
The number of times this group has been collected since agent start
Type
Integer (Counter)
Warehouse name
NUMBER_OF_COLLECTIONS or NUMCOLL
Cache Hits attribute
Description
The number of times an external data request for this group was
satisfied from the cache
Type
Integer (Counter)
Warehouse name
CACHE_HITS or CACHEHT
Cache Misses attribute
Description
not available in the cache
Type
Integer (Counter)
Warehouse name
CACHE_MISSES or CACHEMS
Cache Hit Percent attribute
Description
The percentage of external data requests for this group that were
Type
58
Warehouse name
CACHE_HIT_PERCENT or CACHPCT
Intervals Skipped attribute
Description
The number of times a background data collection for this group
was skipped because the previous collection was still running
when the next one was due to start
Type
Integer (Counter)
Warehouse name
INTERVALS_SKIPPED or INTSKIP
Performance Object Status attribute group

The Performance Object Status attribute group contains information that reflects
the status of other attribute groups so you can see the status of all of the
performance objects that make up this application all at once. Each of these other
performance attribute groups is represented by a row in this table (or other type of
view). The status for an attribute group reflects the result of the last attempt to
collect data for that attribute group, which allows you to see whether the agent is
performing correctly. Unlike other attribute groups, the Performance Object Status
attribute group does not reflect the state of the monitored application. This
attribute group is most often used to determine why data is not available for one
of the performance attribute groups. If the warehouse default setting is enabled,
Historical group
The following list contains information about each attribute in the Performance
Object Status attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
Query Name attribute - This attribute is a key attribute.
Description
The name of the attribute group.
59
Type
String
Warehouse name
QUERY_NAME or ATTRGRP
Object Name attribute
Description
The name of the performance object.
Type
String
Warehouse name
OBJECT_NAME or OBJNAME
Object Type attribute
Description
The type of the performance object.
Type

v
v
v
v
v
WMI (0)
PERFMON (1)
WMI_ASSOCIATION_GROUP (2)
JMX (3)
SNMP (4)
v SHELL_COMMAND (5)
v JOINED_GROUPS (6)
v
v
v
v
v
v
v
v
v
CIMOM (7)
CUSTOM (8)
ROLLUP_DATA (9)
WMI_REMOTE_DATA (10)
LOG_FILE (11)
JDBC (12)
CONFIG_DISCOVERY (13)
NT_EVENT_LOG (14)
FILTER (15)
v SNMP_EVENT (16)
v PING (17)
v DIRECTOR_DATA (18)
v DIRECTOR_EVENT (19)
Warehouse name
OBJECT_TYPE or OBJTYPE
Object Status attribute
Description
The status of the performance object.
Type
60

v ACTIVE (0)
v INACTIVE (1)
Warehouse name
OBJECT_STATUS or OBJSTTS
Description
The error code associated with the query
Type

v NO_ERROR (0)
v GENERAL_ERROR (1)
v
v
v
v
v
OBJECT_NOT_FOUND (2)
COUNTER_NOT_FOUND (3)
NAMESPACE_ERROR (4)
OBJECT_CURRENTLY_UNAVAILABLE (5)
COM_LIBRARY_INIT_FAILURE (6)
v SECURITY_INIT_FAILURE (7)
v PROXY_SECURITY_FAILURE (9)
v NO_INSTANCES_RETURNED (10)
v ASSOCIATOR_QUERY_FAILED (11)
v REFERENCE_QUERY_FAILED (12)
v NO_RESPONSE_RECEIVED (13)
v CANNOT_FIND_JOINED_QUERY (14)
(15)
(16)
v QUERY_1_NOT_A_SINGLETON (17)
v
v
v
v
v
CANNOT_FIND_ROLLUP_QUERY (21)
CANNOT_FIND_ROLLUP_ATTRIBUTE (22)
v
v
v
v
v
v
v
FILE_OFFLINE (23)
NO_HOSTNAME (24)
MISSING_LIBRARY (25)
ATTRIBUTE_COUNT_MISMATCH (26)
ATTRIBUTE_NAME_MISMATCH (27)
COMMON_DATA_PROVIDER_NOT_STARTED (28)
CALLBACK_REGISTRATION_ERROR (29)
61
v
v
v
v
v
MDL_LOAD_ERROR (30)
AUTHENTICATION_FAILED (31)
CANNOT_RESOLVE_HOST_NAME (32)
SUBNODE_UNAVAILABLE (33)
SUBNODE_NOT_FOUND_IN_CONFIG (34)
v
v
v
v
v
v
v
ATTRIBUTE_ERROR (35)
CLASSPATH_ERROR (36)
CONNECTION_FAILURE (37)
FILTER_SYNTAX_ERROR (38)
FILE_NAME_MISSING (39)
SQL_QUERY_ERROR (40)
SQL_FILTER_QUERY_ERROR (41)
v
v
v
v
v
v
SQL_DB_QUERY_ERROR (42)
SQL_DB_FILTER_QUERY_ERROR (43)
PORT_OPEN_FAILED (44)
ACCESS_DENIED (45)
TIMEOUT (46)
NOT_IMPLEMENTED (47)
v REQUESTED_A_BAD_VALUE (48)
v RESPONSE_TOO_BIG (49)
v GENERAL_RESPONSE_ERROR (50)
v
v
v
v
SCRIPT_NONZERO_RETURN (51)
SCRIPT_NOT_FOUND (52)
SCRIPT_LAUNCH_ERROR (53)
CONF_FILE_DOES_NOT_EXIST (54)
v CONF_FILE_ACCESS_DENIED (55)
v INVALID_CONF_FILE (56)
v EIF_INITIALIZATION_FAILED (57)
v CANNOT_OPEN_FORMAT_FILE (58)
v FORMAT_FILE_SYNTAX_ERROR (59)
Warehouse name
ERROR_CODE or ERRCODE
Last Collection Start attribute
Description
The most recent time a data collection of this group started
Type

v NOT COLLECTED (0691231190000000)
Warehouse name
LAST_COLLECTION_START or COLSTRT
62
Last Collection Finished attribute

Description
The most recent time a data collection of this group finished
Type

v NOT COLLECTED (0691231190000000)
Warehouse name
LAST_COLLECTION_FINISHED or COLFINI
Last Collection Duration attribute
Description
The duration of the most recently completed data collection of this
group in seconds
Type
Warehouse name
LAST_COLLECTION_DURATION or COLDURA
Average Collection Duration attribute
Description
The average duration of all data collections of this group in
seconds
Type
Real number (Counter) with 2 decimal places of precision with

v NO DATA (-100)
Warehouse name
AVERAGE_COLLECTION_DURATION or COLAVGD
Description
The interval at which this group is refreshed in seconds
Type
Integer (Counter)
Warehouse name
REFRESH_INTERVAL or REFRINT
Number of Collections attribute
Description
The number of times this group has been collected since agent start
Type
Integer (Counter)
Warehouse name
NUMBER_OF_COLLECTIONS or NUMCOLL
Cache Hits attribute
63
Description
Type
Integer (Counter)
Warehouse name
CACHE_HITS or CACHEHT
Cache Misses attribute
Description
not available in the cache
Type
Integer (Counter)
Warehouse name
CACHE_MISSES or CACHEMS
Cache Hit Percent attribute
Description
The percentage of external data requests for this group that were
Type
Warehouse name
CACHE_HIT_PERCENT or CACHPCT
Intervals Skipped attribute
Description
The number of times a background data collection for this group
was skipped because the previous collection was still running
when the next one was due to start
Type
Integer (Counter)
Warehouse name
INTERVALS_SKIPPED or INTSKIP
SNMP attribute group

Data gathered from SNMP Object SNMP. If the warehouse default setting is
Historical group
The following list contains information about each attribute in the SNMP attribute
group:
Description
Type
64
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
snmpInPkts attribute
Description
The total number of messages delivered to the SNMP entity from
the transport service.
Type

values are defined:
Warehouse name
SNMPINPKTS
snmpOutPkts attribute
Description
The total number of SNMP Messages that were passed from the
SNMP protocol entity to the transport service.
Type

values are defined:
Warehouse name
SNMPOUTPKTS or SNMPOUTPKT
snmpInBadVersions attribute
Description
The total number of SNMP messages that were delivered to the
SNMP entity and were for an unsupported SNMP version.
Type

values are defined:
65
Warehouse name
SNMPINBADVERSIONS or SNMPINBADV
snmpInBadCommunityNames attribute
Description
The total number of SNMP messages delivered to the SNMP entity
that used an SNMP community name not known to said entity.
Type

values are defined:
Warehouse name
SNMPINBADCOMMUNITYNAMES or SNMPINBADC
snmpInBadCommunityUses attribute
Description
The total number of SNMP messages delivered to the SNMP entity
which represented an SNMP operation that was not allowed by the
SNMP community named in the message.
Type

values are defined:
Warehouse name
SNMPINBADCOMMUNITYUSES or SNMPINBAD0
snmpInASNParseErrs attribute
Description
The total number of ASN.1 or BER errors encountered by the
SNMP entity when decoding received SNMP messages.
Type

values are defined:
66
Warehouse name
SNMPINASNPARSEERRS or SNMPINASNP
snmpInTooBigs attribute
Description
The total number of SNMP PDUs that were delivered to the SNMP
protocol entity and for which the value of the error-status field is
'toobig'.
Type

values are defined:
Warehouse name
SNMPINTOOBIGS or SNMPINTOOB
snmpInNoSuchNames attribute
Description
'noSuchName'.
Type

values are defined:
Warehouse name
SNMPINNOSUCHNAMES or SNMPINNOSU
snmpInBadValues attribute
Description
'badValue'.
Type

values are defined:
Warehouse name
SNMPINBADVALUES or SNMPINBAD1
67
snmpInReadOnlys attribute
Description
The total number valid SNMP PDUs that were delivered to the
SNMP protocol entity and for which the value of the error-status
field is 'readOnly'. It is a protocol error to generate an SNMP PDU
that contains the value 'readOnly' in the error-status field.
Type

values are defined:
Warehouse name
SNMPINREADONLYS or SNMPINREAD
snmpInGenErrs attribute
Description
'genErr'.
Type

values are defined:
Warehouse name
SNMPINGENERRS or SNMPINGENE
snmpInTotalReqVars attribute
Description
The total number of MIB objects that have been retrieved
successfully by the SNMP protocol entity as the result of receiving
valid SNMP Get-Request and Get-Next PDUs.
Type

values are defined:
Warehouse name
SNMPINTOTALREQVARS or SNMPINTOTA
snmpInTotalSetVars attribute
68
Description
The total number of MIB objects that have been altered successfully
by the SNMP protocol entity as the result of receiving valid SNMP
Set-Request PDUs.
Type

values are defined:
Warehouse name
SNMPINTOTALSETVARS or SNMPINTOT0
snmpInGetRequests attribute
Description
The total number of SNMP Get-Request PDUs that have been
accepted and processed by the SNMP protocol entity.
Type

values are defined:
Warehouse name
SNMPINGETREQUESTS or SNMPINGETR
snmpInGetNexts attribute
Description
The total number of SNMP Get-Next PDUs that have been
Type

values are defined:
Warehouse name
SNMPINGETNEXTS or SNMPINGETN
snmpInSetRequests attribute
Description
The total number of SNMP Set-Request PDUs that have been
69
Type

values are defined:
Warehouse name
SNMPINSETREQUESTS or SNMPINSETR
snmpInGetResponses attribute
Description
The total number of SNMP Get-Response PDUs that have been
Type

values are defined:
Warehouse name
SNMPINGETRESPONSES or SNMPINGET0
snmpInTraps attribute
Description
The total number of SNMP Trap PDUs that have been accepted
and processed by the SNMP protocol entity.
Type

values are defined:
Warehouse name
SNMPINTRAPS or SNMPINTRAP
snmpOutTooBigs attribute
Description
The total number of SNMP PDUs that were generated by the
field is 'tooBig'.
Type
70

values are defined:
Warehouse name
SNMPOUTTOOBIGS or SNMPOUTTOO
snmpOutNoSuchNames attribute
Description
SNMP protocol entity and for which the value of the error-status is
'noSuchName'.
Type

values are defined:
Warehouse name
SNMPOUTNOSUCHNAMES or SNMPOUTNOS
snmpOutBadValues attribute
Description
field is 'badValue'.
Type

values are defined:
Warehouse name
SNMPOUTBADVALUES or SNMPOUTBAD
snmpOutGenErrs attribute
Description
field is `genErr'.
Type

values are defined:
71
Warehouse name
SNMPOUTGENERRS or SNMPOUTGEN
snmpOutGetRequests attribute
Description
The total number of SNMP Get-Request PDUs that have been
generated by the SNMP protocol entity.
Type

values are defined:
Warehouse name
SNMPOUTGETREQUESTS or SNMPOUTGET
snmpOutGetNexts attribute
Description
The total number of SNMP Get-Next PDUs that have been
Type

values are defined:
Warehouse name
SNMPOUTGETNEXTS or SNMPOUTGE0
snmpOutSetRequests attribute
Description
The total number of SNMP Set-Request PDUs that have been
Type

values are defined:
Warehouse name
SNMPOUTSETREQUESTS or SNMPOUTSET
72
snmpOutGetResponses attribute
Description
The total number of SNMP Get-Response PDUs that have been
Type

values are defined:
Warehouse name
SNMPOUTGETRESPONSES or SNMPOUTGE1
snmpOutTraps attribute
Description
The total number of SNMP Trap PDUs that have been generated
by the SNMP protocol entity.
Type

values are defined:
Warehouse name
SNMPOUTTRAPS or SNMPOUTTRA
snmpEnableAuthenTraps attribute
Description
Indicates whether the SNMP entity is permitted to generate
authenticationFailure traps. The value of this object overrides any
configuration information; as such, it provides a means whereby all
authenticationFailure traps might be disabled.
Type

v enabled (1)
v disabled (2)
Warehouse name
SNMPENABLEAUTHENTRAPS or SNMPENABLE
snmpSilentDrops attribute
Description
The total number of GetRequest-PDUs, GetNextRequest-PDUs,
73
GetBulkRequest-PDUs, SetRequest-PDUs, and InformRequest-PDUs

delivered to the SNMP entity that were silently dropped because
the size of a reply containing an alternate Response-PDU was
empty.
Type

values are defined:
Warehouse name
SNMPSILENTDROPS or SNMPSILENT
snmpProxyDrops attribute
Description
The total number of GetRequest-PDUs, GetNextRequest-PDUs,
GetBulkRequest-PDUs, SetRequest-PDUs, and InformRequest-PDUs
delivered to the SNMP entity which were silently dropped because
of the transmission of a message to a proxy target.
Type

values are defined:
Warehouse name
SNMPPROXYDROPS or SNMPPROXYD
snmpInASNParseErrsPerSec attribute
Description
The total number of ASN.1 or BER errors encountered by the
SNMP entity when decoding received SNMP messages.
Type

Warehouse name
SNMPINASNPARSEERRSPERSEC or SNMPINASN0
74
System attribute group

Data gathered from SNMP Object System. If the warehouse default setting is
Historical group
The following list contains information about each attribute in the System attribute
group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
sysDescr attribute
Description
A textual description of the entity. This value includes the full
name and version identification of the system's hardware type,
software operating-system, and networking software.
Type
String
Warehouse name
SYSDESCR
sysObjectID attribute
Description
The vendor's authoritative identification of the network
management subsystem contained in the entity. This value is
allocated within the SMI enterprises subtree (1.3.6.1.4.1).
Type
String
Warehouse name
SYSOBJECTID or SYSOBJECTI
sysUpTime attribute
Description
The time (in hundredths of a second) since the network
management portion of the system was last re-initialized.
Type
String
75
Warehouse name
SYSUPTIME
sysContact attribute
Description
The textual identification of the contact person for the managed
node. If no contact information is known, the value is the
zero-length string.
Type
String
Warehouse name
SYSCONTACT
sysName attribute
Description
An administratively-assigned name for the managed node. By
convention, this is the node's fully-qualified domain name. If the
name is unknown, the value is the zero-length string.
Type
String
Warehouse name
SYSNAME
sysLocation attribute
Description
The physical location of the node. For example, telephone closet or
3rd floor. If the location is unknown, the value is the zero-length
string.
Type
String
Warehouse name
SYSLOCATION or SYSLOCATIO
sysServices attribute
Description
A value that indicates the set of services this entity might
potentially offers. The value is a sum.
Type

Warehouse name
SYSSERVICES or SYSSERVICE
sysORLastChange attribute
Description
The value of sysUpTime at the time of the most recent change in
state or value of any instance of sysORID.
Type
76
String
Warehouse name
SYSORLASTCHANGE or SYSORLASTC
TCP attribute group

Data gathered from SNMP Object TCP. If the warehouse default setting is enabled,
Historical group
The following list contains information about each attribute in the TCP attribute
group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
tcpRtoAlgorithm attribute
Description
The algorithm used to determine the timeout value used for
retransmitting unacknowledged octets.
Type

v other (1)
v constant (2)
v rsre (3)
v vanj (4)
Warehouse name
TCPRTOALGORITHM or TCPRTOALGO
tcpRtoMin attribute
Description
The minimum value permitted by a TCP implementation for the
retransmission timeout, measured in milliseconds. More refined
77
information for objects of this type depend upon the algorithm

used to determine the retransmission timeout.
Type

Warehouse name
TCPRTOMIN
tcpRtoMax attribute
Description
The maximum value permitted by a TCP implementation for the
retransmission timeout, measured in milliseconds. More refined
information for objects of this type depend upon the algorithm
used to determine the retransmission timeout.
Type

Warehouse name
TCPRTOMAX
tcpMaxConn attribute
Description
The limit on the total number of TCP connections the entity can
support. In entities where the maximum number of connections is
dynamic, this object should contain the value -1.
Type

Warehouse name
TCPMAXCONN
tcpActiveOpens attribute
Description
The number of times TCP connections have made a direct
transition to the SYN-SENT state from the CLOSED state.
Type
78

values are defined:
Warehouse name
TCPACTIVEOPENS or TCPACTIVEO
tcpPassiveOpens attribute
Description
transition to the SYN-RCVD state from the LISTEN state.
Type

values are defined:
Warehouse name
TCPPASSIVEOPENS or TCPPASSIVE
tcpAttemptFails attribute
Description
transition to the CLOSED state from either the SYN-SENT state or
the SYN-RCVD state, including connections that have made a
direct transition to the LISTEN state from the SYN-RCVD state.
Type

values are defined:
Warehouse name
TCPATTEMPTFAILS or TCPATTEMPT
tcpEstabResets attribute
Description
transition to the CLOSED state from either the ESTABLISHED state
or the CLOSE-WAIT state.
Type
79

values are defined:
Warehouse name
TCPESTABRESETS or TCPESTABRE
tcpCurrEstab attribute
Description
The number of TCP connections that are in the current state
ESTABLISHED or CLOSE- WAIT.
Type

Warehouse name
TCPCURRESTAB or TCPCURREST
tcpInSegs attribute
Description
The total number of segments received, including those received in
error. This count includes segments received on currently
established connections.
Type

values are defined:
Warehouse name
TCPINSEGS
tcpOutSegs attribute
Description
The total number of segments sent, including those on current
connections but excluding those containing only retransmitted
octets.
Type
80

values are defined:
Warehouse name
TCPOUTSEGS
tcpRetransSegs attribute
Description
The total number of TCP segments retransmitted containing one or
more previously transmitted octets.
Type

values are defined:
Warehouse name
TCPRETRANSSEGS or TCPRETRANS
tcpInErrs attribute
Description
The total number of segments received in error. For example, bad
TCP checksums.
Type

values are defined:
Warehouse name
TCPINERRS
tcpOutRsts attribute
Description
The number of TCP segments sent containing the RST flag.
Type

values are defined:
Warehouse name
TCPOUTRSTS
81
tcpInErrsPerSec attribute
Description
The total number of segments received in error. For example, bad
TCP checksums.
Type

Warehouse name
TCPINERRSPERSEC or TCPINERRSP
TCPConnTable attribute group

Data gathered from SNMP Object TCPConnTable. If the warehouse default setting
is enabled, data for this attribute group is stored in Tivoli Data Warehouse.
Historical group
The following list contains information about each attribute in the TCPConnTable
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
tcpConnState attribute
Description
The state of the TCP connection. The only value which may be set
by a management station is deleteTCB(12). It is appropriate for an
agent to return a `badValue' response if a management station
attempts to set this object to any other value.
Type
82

v closed (1)
v listen (2)
v synSent (3)
v synReceived (4)
v established (5)
v finWait1 (6)
v
v
v
v
v
v
finWait2 (7)
closeWait (8)
lastAck (9)
closing (10)
timeWait (11)
deleteTCB (12)
Warehouse name
TCPCONNSTATE or TCPCONNSTA
tcpConnLocalAddress attribute - This attribute is a key attribute.
Description
The local IP address for the TCP connection. In the case of a
connection in the listen state that is willing to accept connections
for any IP interface associated with the node, the value 0.0.0.0 is
used.
Type
String
Warehouse name
TCPCONNLOCALADDRESS or TCPCONNLOC
tcpConnLocalPort attribute - This attribute is a key attribute.
Description
The local port number for the TCP connection.
Type

Warehouse name
TCPCONNLOCALPORT or TCPCONNLO0
tcpConnRemAddress attribute - This attribute is a key attribute.
Description
The remote IP address for the TCP connection.
Type
String
Warehouse name
TCPCONNREMADDRESS or TCPCONNREM
83
tcpConnRemPort attribute - This attribute is a key attribute.

Description
The remote port number for the TCP connection.
Type

Warehouse name
TCPCONNREMPORT or TCPCONNRE0
Thread Pool Status attribute group

The Thread Pool Status attribute group contains information that reflects the status
of the internal thread pool used to collect data asynchronously. If the warehouse
default setting is enabled, data for this attribute group is stored in Tivoli Data
Warehouse.
Historical group
The following list contains information about each attribute in the Thread Pool
Status attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
Thread Pool Size attribute
Description
The number of threads currently existing in the thread pool.
Type
84

v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_SIZE or THPSIZE
Thread Pool Max Size attribute
Description
The maximum number of threads allowed to exist in the thread
pool.
Type
Integer (Numeric Property) with enumerated values. The strings

are displayed in the Tivoli Enterprise Portal. The warehouse and
values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_MAX_SIZE or TPMAXSZ
Thread Pool Active Threads attribute
Description
The number of threads in the thread pool currently active doing
work.
Type

v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_ACTIVE_THREADS or TPACTTH
Thread Pool Avg Active Threads attribute
Description
The average number of threads in the thread pool simultaneously
active doing work.
Type
Real number (Gauge) with 2 decimal places of precision with

v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_AVG_ACTIVE_THREADS or TPAVGAT
85
Thread Pool Min Active Threads attribute

Description
The smallest number of threads in the thread pool that have
simultaneously been active doing work.
Type

values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_MIN_ACTIVE_THREADS or TPMINAT
Thread Pool Max Active Threads attribute
Description
The peak number of threads in the thread pool that have
simultaneously been active doing work.
Type

values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_MAX_ACTIVE_THREADS or TPMAXAT
Thread Pool Queue Length attribute
Description
The number of jobs currently waiting in the thread pool queue.
Type

v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_QUEUE_LENGTH or TPQLGTH
Thread Pool Avg Queue Length attribute
Description
The average length of the thread pool queue during this run.
Type
86


v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_AVG_QUEUE_LENGTH or TPAVGQL
Thread Pool Min Queue Length attribute
Description
The minimum length the thread pool queue has reached.
Type

values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_MIN_QUEUE_LENGTH or TPMINQL
Thread Pool Max Queue Length attribute
Description
The peak length the thread pool queue has reached.
Type

values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_MAX_QUEUE_LENGTH or TPMAXQL
Thread Pool Avg Job Wait attribute
Description
The average time a job spends waiting on the thread pool queue in
seconds.
Type

v NO DATA (-1)
v NO DATA (-100)
87
Warehouse name
THREAD_POOL_AVG_JOB_WAIT or TPAVJBW
Thread Pool Total Jobs attribute
Description
The number of jobs completed by all threads in the pool since
agent start.
Type

values are defined:
v NO DATA (-1)
v NO DATA (-100)
Warehouse name
THREAD_POOL_TOTAL_JOBS or TPTJOBS
UDP attribute group

Data gathered from SNMP Object UDP. If the warehouse default setting is enabled,
Historical group
The following list contains information about each attribute in the UDP attribute
group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
udpInDatagrams attribute
Description
The total number of UDP datagrams delivered to UDP users.
Type
88

values are defined:
Warehouse name
UDPINDATAGRAMS or UDPINDATAG
udpNoPorts attribute
Description
The total number of received UDP datagrams for which there was
no application at the destination port.
Type

values are defined:
Warehouse name
UDPNOPORTS
udpInErrors attribute
Description
The number of received UDP datagrams that could not be
delivered for reasons other than the lack of an application at the
destination port.
Type

values are defined:
Warehouse name
UDPINERRORS or UDPINERROR
udpOutDatagrams attribute
Description
The total number of UDP datagrams sent from the entity.
Type

values are defined:
89
Warehouse name
UDPOUTDATAGRAMS or UDPOUTDATA
udpInErrorsPerSec attribute
Description
The number of received UDP datagrams that could not be
delivered for reasons other than the lack of an application at the
destination port.
Type

Warehouse name
UDPINERRORSPERSEC or UDPINERRO0
UDPTable attribute group

Data gathered from SNMP Object UDPTable. If the warehouse default setting is
Historical group
The following list contains information about each attribute in the UDPTable
attribute group:
Description
Type
String
Warehouse name
NODE
Timestamp attribute
Description
Type
String
Warehouse name
TIMESTAMP
udpLocalAddress attribute - This attribute is a key attribute.
90
Description
The local IP address for the UDP listener. A UDP listener that is
willing to accept datagrams for any IP interface associated with the
node, has a value of 0.0.0.0.
Type
String
Warehouse name
UDPLOCALADDRESS or UDPLOCALAD
udpLocalPort attribute - This attribute is a key attribute.
Description
The local port number for the UDP listener.
Type

Warehouse name
UDPLOCALPORT or UDPLOCALPO
Disk capacity planning for historical data

Disk capacity planning for a monitoring agent is a prediction of the amount of disk
space to be consumed for each attribute group with historical data that is being
collected. Required disk storage is an important factor to consider when you are
defining data collection rules and your strategy for historical data collection.
The table in this chapter provides the following information required to calculate
disk space for this monitoring agent:
v Table is the table name as it is displayed in the warehouse database, if the
attribute group is configured to be written to the warehouse. The table name
listed here corresponds to the Table name in Attribute groups and attributes for
the Network Devices agent on page 7
v Attribute group is the name of the attribute group used to create the table in the
warehouse database if it is short enough to fit in the table naming constraints of
the database being used for the warehouse. The attribute group name listed here
corresponds to the Warehouse table name in Attribute groups and attributes for
the Network Devices agent on page 7.
v Bytes per instance (agent) is an estimate of the record length for each row or
instance written to the agent disk for historical data collection. This estimate can
be used for agent disk space planning purposes.
v Database bytes per instance (warehouse) is an estimate of the record length for
detailed records written to the warehouse database, if the attribute group is
configured to be written to the warehouse. Detailed records are those that have
been uploaded from the agent for long-term historical data collection. This
estimate can be used for warehouse disk space planning purposes.
v Aggregate bytes per instance (warehouse) is an estimate of the record length for
aggregate records written to the warehouse database, if the attribute group is
configured to be written to the warehouse. Aggregate records are created by the
91
Summarization agent for attribute groups that have been configured for
summarization. This estimate can be used for warehouse disk space planning
purposes.
In addition to the information in the tables, you must know the number of
instances of data that you plan to collect. An attribute group can have single or
multiple instances of data depending on the application environment that is being
monitored. For example, if your attribute group is monitoring each processor in
your computer and you have a dual processor computer, the number of instances
is two.
The following table contains capacity planning information for the data logged by
Network Devices.
Table 1. Capacity planning for historical data logged by component IBM Tivoli Monitoring for Network Devices
Database
bytes per
instance
(warehouse)
Aggregate
bytes per
instance
(warehouse)
Table
Attribute group
Bytes per
instance
(agent)
KN4IFTABLE
KN4_IFTABLE
655
683
1396
KN4IFTOIPM
KN4_IFTOIPMAP
731
764
1594
KN4INTERFA
KN4_INTERFACES
80
77
153
KN4IP
KN4_IP
164
182
630
KN4IPADDRT
KN4_IPADDRTABLE
152
153
307
KN4IPROUTE
KN4_IPROUTETABLE
272
281
591
KN4NMADS
KN4_MONITORED_NETWORK_DEVICES_NODES
197
198
235
KN4NMAPOS
KN4_NMA_PERFORMANCE_OBJECT_STATUS
352
399
664
KN4POBJST
KN4_PERFORMANCE_OBJECT_STATUS
352
399
664
KN4SNMP
KN4_SNMP
200
227
738
KN4SYSTEM
KN4_SYSTEM
1292
1296
1372
KN4TCP
KN4_TCP
136
147
514
KN4TCPCONN
KN4_TCPCONNTABLE
152
153
190
KN4THPLST
KN4_THREAD_POOL_STATUS
124
168
550
KN4UDP
KN4_UDP
96
97
233
KN4UDPTABL
KN4_UDPTABLE
112
110
147
For more information about historical data collection, see the IBM Tivoli Monitoring
Administrator's Guide.
92
Chapter 4. Situations reference

This chapter contains an overview of situations, references for detailed information
about situations, and descriptions of the predefined situations included in this
monitoring agent.
About situations
A situation is a logical expression involving one or more system conditions.
Situations are used to monitor the condition of systems in your network. You can
manage situations from Tivoli Enterprise Portal by using the Situation Editor.
The monitoring agents that you use to monitor your system environment are
delivered with a set of predefined situations that you can use as-is or you can
create new situations to meet your requirements. Predefined situations contain
attributes that check for system conditions common to many enterprises.
Using predefined situations can improve the speed with which you can begin
using the Network Devices agent. You can examine and, if necessary, change the
conditions or values being monitored by a predefined situation to those best suited
to your enterprise.
You can display predefined situations and create your own situations using the
Situation Editor. The left frame of the Situation editor initially lists the situations
associated with the Navigator item that you selected. When you click a situation
name or create a new situation, the right frame opens with the following tabs:
Formula
Formula describing condition being tested
Distribution
List of managed systems (operating systems, subsystems, or applications)
to which the situation can be distributed. All of the Network Devices agent
managed systems are assigned by default.
Expert advice
Comments and instructions to be read in the event workspace
Action
Command to be sent to the system
Until
Options to close the event after a period of time, or when another situation
becomes true
More information about situations

Tivoli Enterprise Portal User's Guide contains more information about predefined
and custom situations and how to use them to respond to alerts.
For a list of the predefined situations for this monitoring agent and a description
of each situation, see the Predefined situations section in this chapter and the
information in that section for each individual situation.
93
Predefined situations
This monitoring agent contains the following predefined situations.
v
v
v
v
v
v
v
KN4_IPHdrErrors
KN4_InterfaceDown
KN4_PacketsOnError
KN4_TCPinErrors
KN4_UDPinErrors
KN4_ipInAddrErrors
KN4_snmpInASNParseErrs
The remaining sections of this chapter contain descriptions of each of these

situations.

KN4_IPHdrErrors
Triggers when packets are discarded due to errors in the header. Monitors the
reporting of packets that are discarded due to errors in the header and raises a
critical alert when any errors are reported. The default configuration has the
following SQL syntax:
*IF *VALUE KN4_IP.ipInHdrErrorsPerSec *GT 0
This situation is evaluated every 1 minute.

This situation is automatically distributed to instances of this agent.
This situation is associated with the Monitored Network Devices (nma) subnode.
KN4_InterfaceDown
Triggers when packets are discarded due to errors in the header. Monitors for an
interface with an administrator status marked as active that has become inactive,
and raises a critical alert. The default configuration has the following SQL syntax:
*IF *VALUE KN4_IFTABLE.ifAdminStatus *EQ up *AND
*VALUE KN4_IFTABLE.ifOperStatus *NE up
This situation is evaluated every 1 minute

KN4_PacketsOnError
Triggers when packets with errors are detected in the interface. Monitors the
reporting of error packets that are detected in the interface and raises a critical
alert when any errors are reported. The default configuration has the following
SQL syntax:
*IF ( ( *VALUE KN4_IFTABLE.ifOutErrorsPerSec *GT 0 ) *OR
( *VALUE KN4_IFTABLE.ifInErrorsPerSec *GT 0 ) )
94

KN4_TCPinErrors
Triggers when there are bad TCP checksumsin packets. Monitors the reporting of
corrupt TCP checksums in packets and raises a critical alert when any errors are
reported. The default configuration has the following SQL syntax:
*IF *VALUE KN4_TCP.tcpInErrsPerSec *GT 0

KN4_UDPinErrors
Triggers when UDP packets could not be delivered. Monitors the reporting of UDP
packets that could not be delivered and raises a critical alert when any errors are
reported. The default configuration has the following SQL syntax:
*IF *VALUE KN4_UDP.udpInErrorsPerSec *GT 0

KN4_ipInAddrErrors
Triggers when packets are discarded because a wrong IP address. Monitors the
reporting of packets that are discarded due to a wrong IP address and raises a
critical alert when any errors are reported. The default configuration has the
following SQL syntax:
*IF *VALUE KN4_IP.ipInAddrErrorsPerSec *GT 0

Triggers when errors in ASN.1 or BER packet decoding. Monitors the reporting of
errors in ASN.1 or BER packet decoding and raises a critical alert when any errors
are reported. The default configuration has the following SQL syntax:
*IF *VALUE KN4_SNMP.snmpInASNParseErrsPerSec *GT 0

Chapter 4. Situations reference
95
96
Chapter 5. Take Action commands reference

This chapter contains an overview of Take Action commands, references for
detailed information about Take Action commands, and descriptions of the Take
Action commands included in this monitoring agent, if any.
About Take Action commands

Take Action commands can be run from the portal client or included in a situation
or a policy.
When included in a situation, the command runs when the situation becomes true.
A Take Action command in a situation is also referred to as reflex automation.
When you enable a Take Action command in a situation, you automate a response
to system conditions. For example, you can use a Take Action command to send a
command to restart a process on the managed system or to send a text message to
a cell phone.
Advanced automation uses policies to perform actions, schedule work, and
automate manual tasks. A policy comprises a series of automated steps called
activities that are connected to create a workflow. After an activity is completed,
the Tivoli Enterprise Portal receives return code feedback, and advanced
automation logic responds with subsequent activities prescribed by the feedback.
A basic Take Action command displays the return code of the operation in a
message box that is displayed after the action completes or in a log file. After you
close this window, no further information is available for this action.
More information about Take Action commands

For more information about working with Take Action commands, see the Tivoli
Enterprise Portal User's Guide.
Predefined Take Action commands

The Network Devices agent does not provide predefined Take Action commands.
97
98
Chapter 6. Policies reference

This chapter contains an overview of policies, references for detailed information
about policies, and descriptions of the predefined policies included in this
monitoring agent, if any.
About policies
Policies are an advanced automation technique for implementing more complex
workflow strategies than you can create through simple automation.
A policy is a set of automated system processes that can perform actions, schedule
work for users, or automate manual tasks. You use the Workflow Editor to design
policies. You control the order in which the policy executes a series of automated
steps, which are also called activities. Policies are connected to create a workflow.
After an activity is completed, Tivoli Enterprise Portal receives return code
feedback and advanced automation logic responds with subsequent activities
prescribed by the feedback.
More information about policies

This monitoring agent does not provide predefined policies. For more information
about working with policies, see the Tivoli Enterprise Portal User's Guide.
For information about using the Workflow Editor, see the IBM Tivoli Monitoring
Administrator's Guide or the Tivoli Enterprise Portal online help.
Predefined policies
The Network Devices agent does not provide predefined policies.
99
100
Appendix A. IBM Tivoli Enterprise Console event mapping

Each event class corresponds to an attribute group in the IBM Tivoli Enterprise
Console. For a description of the event slots for each event class, see the lists in
this appendix. For more information about mapping attribute groups to event
classes, see the IBM Tivoli Monitoring Administrator's Guide.
Generic event mapping provides useful event class and attribute information for
situations that do not have specific event mapping defined. BAROC files are found
on the Tivoli Enterprise Monitoring Server in the installation directory in TECLIB
(that is, install_dir/cms/TECLIB for Windows systems and install_dir/tables/
TEMS_hostname/TECLIB for UNIX systems). IBM Tivoli Enterprise Console event
synchronization provides a collection of ready-to-use rule sets that you can deploy
with minimal configuration. Be sure to install IBM Tivoli Enterprise Console event
synchronization to access the correct Sentry.baroc, which is automatically included
during base configuration of IBM Tivoli Enterprise Console rules if you indicate
that you want to use an existing rulebase. See the IBM Tivoli Monitoring Installation
and Setup Guide for details.
Each of the event classes is a child of KN4_Base and is defined in the kn4.baroc
file. The KN4_Base event class can be used for generic rules processing for any
event from the Network Devices.
For events generated by situations in the IfTable attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_IFTABLE class. This class contains
the following slots:
v
v
v
v
v
node: STRING
timestamp: STRING
ifindex: INTEGER
ifdescr: STRING
iftype: INTEGER
v iftype_enum: STRING
v ifmtu: INTEGER
v
v
v
v
v
v
v
ifspeed: INTEGER
ifphysaddress: STRING
ifadminstatus: INTEGER
ifadminstatus_enum: STRING
ifoperstatus: INTEGER
ifoperstatus_enum: STRING
iflastchange: STRING
v
v
v
v
v
ifinoctets: INTEGER
ifinucastpkts: INTEGER
ifinnucastpkts: INTEGER
ifindiscards: INTEGER
ifinerrors: INTEGER
v ifinunknownprotos: INTEGER
v ifoutoctets: INTEGER
101
v
v
v
v
v
ifoutucastpkts: INTEGER
ifoutnucastpkts: INTEGER
ifoutdiscards: INTEGER
ifouterrors: INTEGER
ifoutqlen: INTEGER
v
v
v
v
v
v
v
ifspecific: STRING
ifinoctetsinmil: INTEGER
ifoutoctectsinmil: INTEGER
ifoutoctectspersec: INTEGER
ifinoctectspersec: INTEGER
ifindiscardspersec: INTEGER
ifinerrorspersec: INTEGER
v
v
v
v
ifinunknownprotospersec: INTEGER
ifoutdiscardspersec: INTEGER
ifouterrorspersec: INTEGER
ifoutqlenpersec: INTEGER
For events generated by situations in the IfToIpMap attribute group, Tivoli

Enterprise Console events are sent using the ITM_KN4_IFTOIPMAP class. This
class contains the following slots:
v node: STRING
v
v
v
v
timestamp: STRING
ifindex: INTEGER
ifdescr: STRING
iftype: INTEGER
v iftype_enum: STRING
v ifmtu: INTEGER
v ifspeed: INTEGER
v
v
v
v
v
ifphysaddress: STRING
ifadminstatus: INTEGER
ifadminstatus_enum: STRING
ifoperstatus: INTEGER
ifoperstatus_enum: STRING
v iflastchange: STRING
v ifinoctets: INTEGER
102
v
v
v
v
v
v
v
ifinucastpkts: INTEGER
ifinnucastpkts: INTEGER
ifindiscards: INTEGER
ifinerrors: INTEGER
ifinunknownprotos: INTEGER
ifoutoctets: INTEGER
ifoutucastpkts: INTEGER
v
v
v
v
ifoutnucastpkts: INTEGER
ifoutdiscards: INTEGER
ifouterrors: INTEGER
ifoutqlen: INTEGER
v
v
v
v
v
ifspecific: STRING
ifinoctetsinmil: INTEGER
ifoutoctectsinmil: INTEGER
ifoutoctectspersec: INTEGER
ifinoctectspersec: INTEGER
v
v
v
v
v
v
v
ifindiscardspersec: INTEGER
ifinerrorspersec: INTEGER
ifinunknownprotospersec: INTEGER
ifoutdiscardspersec: INTEGER
ifouterrorspersec: INTEGER
ifoutqlenpersec: INTEGER
ipadentaddr: STRING
v
v
v
v
ipadentifindex: INTEGER
ipadentnetmask: STRING
ipadentbcastaddr: INTEGER
ipadentreasmmaxsize: INTEGER
For events generated by situations in the Interfaces attribute group, Tivoli

Enterprise Console events are sent using the ITM_KN4_INTERFACES class. This
v node: STRING
v timestamp: STRING
v ifnumber: INTEGER
For events generated by situations in the IP attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_IP class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v ipforwarding: INTEGER
v ipforwarding_enum: STRING
v
v
v
v
v
v
ipdefaultttl: INTEGER
ipinreceives: INTEGER
ipinhdrerrors: INTEGER
ipinaddrerrors: INTEGER
ipforwdatagrams: INTEGER
ipinunknownprotos: INTEGER
v
v
v
v
v
v
v
ipindiscards: INTEGER
ipindelivers: INTEGER
ipoutrequests: INTEGER
ipoutdiscards: INTEGER
ipoutnoroutes: INTEGER
ipreasmtimeout: INTEGER
ipreasmreqds: INTEGER
v ipreasmoks: INTEGER
v ipreasmfails: INTEGER
103
v
v
v
v
v
ipfragoks: INTEGER
ipfragfails: INTEGER
ipfragcreates: INTEGER
iproutingdiscards: INTEGER
ipinhdrerrorspersec: INTEGER
v ipinaddrerrorspersec: INTEGER
For events generated by situations in the IpAddrTable attribute group, Tivoli
Enterprise Console events are sent using the ITM_KN4_IPADDRTABLE class. This
v
v
v
v
v
v
v
node: STRING
timestamp: STRING
ipadentaddr: STRING
ipadentifindex: INTEGER
ipadentnetmask: STRING
ipadentbcastaddr: INTEGER
ipadentreasmmaxsize: INTEGER
For events generated by situations in the IpRouteTable attribute group, Tivoli

Enterprise Console events are sent using the ITM_KN4_IPROUTETABLE class. This
v node: STRING
v timestamp: STRING
v iproutedest: STRING
v
v
v
v
v
v
v
v
v
iprouteifindex: INTEGER
iproutemetric1: INTEGER
iproutenexthop: STRING
iproutetype: INTEGER
iproutetype_enum: STRING
iprouteproto: INTEGER
v iprouteproto_enum: STRING
v iprouteage: INTEGER
v iproutemask: STRING
v iproutemetric5: INTEGER
v iprouteinfo: STRING
For events generated by situations in the Monitored Network Devices nodes
attribute group, Tivoli Enterprise Console events are sent using the
ITM_KN4_MONITORED_NETWORK_DEVICES_NODES class. This class contains
the following slots:
v node: STRING
v timestamp: STRING
v subnode_msn: STRING
v subnode_affinity: STRING
104
v subnode_type: STRING
v subnode_resource_name: STRING
v subnode_version: STRING
For events generated by situations in the nma Performance Object Status attribute
group, Tivoli Enterprise Console events are sent using the
ITM_KN4_NMA_PERFORMANCE_OBJECT_STATUS class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v query_name: STRING
v object_name: STRING
v object_type: INTEGER
v
v
v
v
v
v
object_type_enum: STRING
object_status: INTEGER
object_status_enum: STRING
error_code: INTEGER
error_code_enum: STRING
last_collection_start: STRING
v last_collection_start_enum: STRING
v last_collection_finished: STRING
v last_collection_finished_enum: STRING
v
v
v
v
last_collection_duration: REAL
average_collection_duration: REAL
average_collection_duration_enum: STRING
refresh_interval: INTEGER
v number_of_collections: INTEGER
v cache_hits: INTEGER
v cache_misses: INTEGER
v cache_hit_percent: REAL
v intervals_skipped: INTEGER
For events generated by situations in the Performance Object Status attribute
group, Tivoli Enterprise Console events are sent using the
ITM_KN4_PERFORMANCE_OBJECT_STATUS class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v query_name: STRING
v
v
v
v
v
v
v
v
object_name: STRING
object_type: INTEGER
object_type_enum: STRING
object_status: INTEGER
object_status_enum: STRING
error_code: INTEGER
error_code_enum: STRING
last_collection_start: STRING
105
v
v
v
v
v
last_collection_start_enum: STRING
last_collection_finished: STRING
last_collection_finished_enum: STRING
last_collection_duration: REAL
average_collection_duration: REAL
v
v
v
v
v
v
v
average_collection_duration_enum: STRING
refresh_interval: INTEGER
number_of_collections: INTEGER
cache_hits: INTEGER
cache_misses: INTEGER
cache_hit_percent: REAL
intervals_skipped: INTEGER
For events generated by situations in the SNMP attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_SNMP class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v snmpinpkts: INTEGER
v snmpoutpkts: INTEGER
v snmpinbadversions: INTEGER
v
v
v
v
snmpinbadcommunitynames: INTEGER
snmpinbadcommunityuses: INTEGER
snmpinasnparseerrs: INTEGER
snmpintoobigs: INTEGER
v snmpinnosuchnames: INTEGER
v snmpinbadvalues: INTEGER
v snmpinreadonlys: INTEGER
v
v
v
v
v
snmpingenerrs: INTEGER
snmpintotalreqvars: INTEGER
snmpintotalsetvars: INTEGER
snmpingetrequests: INTEGER
snmpingetnexts: INTEGER
v snmpinsetrequests: INTEGER
v snmpingetresponses: INTEGER
106
v
v
v
v
v
v
v
snmpintraps: INTEGER
snmpouttoobigs: INTEGER
snmpoutnosuchnames: INTEGER
snmpoutbadvalues: INTEGER
snmpoutgenerrs: INTEGER
snmpoutgetrequests: INTEGER
snmpoutgetnexts: INTEGER
v
v
v
v
snmpoutsetrequests: INTEGER
snmpoutgetresponses: INTEGER
snmpouttraps: INTEGER
snmpenableauthentraps: INTEGER
v
v
v
v
snmpenableauthentraps_enum: STRING
snmpsilentdrops: INTEGER
snmpproxydrops: INTEGER
snmpinasnparseerrspersec: INTEGER
For events generated by situations in the System attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_SYSTEM class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v
v
v
v
v
v
v
v
sysdescr: STRING
sysobjectid: STRING
sysuptime: STRING
syscontact: STRING
sysname: STRING
syslocation: STRING
sysservices: INTEGER
sysorlastchange: STRING
For events generated by situations in the TCP attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_TCP class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v
v
v
v
v
v
v
v
v
tcprtoalgorithm: INTEGER
tcprtoalgorithm_enum: STRING
tcprtomin: INTEGER
tcprtomax: INTEGER
tcpmaxconn: INTEGER
tcpactiveopens: INTEGER
tcppassiveopens: INTEGER
tcpattemptfails: INTEGER
tcpestabresets: INTEGER
v tcpcurrestab: INTEGER
v tcpinsegs: INTEGER
v
v
v
v
v
tcpoutsegs: INTEGER
tcpretranssegs: INTEGER
tcpinerrs: INTEGER
tcpoutrsts: INTEGER
tcpinerrspersec: INTEGER
For events generated by situations in the TCPConnTable attribute group, Tivoli

Enterprise Console events are sent using the ITM_KN4_TCPCONNTABLE class.
This class contains the following slots:
v node: STRING
v timestamp: STRING
v tcpconnstate: INTEGER
107
v
v
v
v
v
tcpconnstate_enum: STRING
tcpconnlocaladdress: STRING
tcpconnlocalport: INTEGER
tcpconnremaddress: STRING
tcpconnremport: INTEGER
For events generated by situations in the Thread Pool Status attribute group, Tivoli
Enterprise Console events are sent using the ITM_KN4_THREAD_POOL_STATUS
class. This class contains the following slots:
v node: STRING
v
v
v
v
v
v
v
v
timestamp: STRING
thread_pool_size: INTEGER
thread_pool_size_enum: STRING
thread_pool_max_size: INTEGER
thread_pool_max_size_enum: STRING
thread_pool_active_threads: INTEGER
thread_pool_active_threads_enum: STRING
thread_pool_avg_active_threads: REAL
v thread_pool_avg_active_threads_enum: STRING
v thread_pool_min_active_threads: INTEGER
v thread_pool_min_active_threads_enum: STRING
v
v
v
v
thread_pool_max_active_threads: INTEGER
thread_pool_max_active_threads_enum: STRING
thread_pool_queue_length: INTEGER
thread_pool_queue_length_enum: STRING
v thread_pool_avg_queue_length: REAL
v thread_pool_avg_queue_length_enum: STRING
v thread_pool_min_queue_length: INTEGER
v
v
v
v
v
thread_pool_min_queue_length_enum: STRING
thread_pool_max_queue_length: INTEGER
thread_pool_max_queue_length_enum: STRING
thread_pool_avg_job_wait: REAL
thread_pool_avg_job_wait_enum: STRING
v thread_pool_total_jobs: INTEGER
v thread_pool_total_jobs_enum: STRING
For events generated by situations in the UDP attribute group, Tivoli Enterprise
Console events are sent using the ITM_KN4_UDP class. This class contains the
following slots:
v node: STRING
v timestamp: STRING
v udpindatagrams: INTEGER
v udpnoports: INTEGER
v udpinerrors: INTEGER
v udpoutdatagrams: INTEGER
v udpinerrorspersec: INTEGER
108
For events generated by situations in the UDPTable attribute group, Tivoli

Enterprise Console events are sent using the ITM_KN4_UDPTABLE class. This
v
v
v
v
node: STRING
timestamp: STRING
udplocaladdress: STRING
udplocalport: INTEGER
109
110
Appendix B. Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not give you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM
Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain
transactions, therefore, this statement might not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
111
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases payment of a fee.
The licensed program described in this document and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement or any equivalent agreement
between us.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurement may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or
withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBM's suggested retail prices, are current and are subject
to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
This information contains examples of data and reports used in daily business
operations. To illustrate them as completely as possible, the examples include the
names of individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an actual business
enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which
illustrate programming techniques on various operating platforms. You may copy,
modify, and distribute these sample programs in any form without payment to
112
IBM, for the purposes of developing, using, marketing or distributing application

programs conforming to the application programming interface for the operating
platform for which the sample programs are written. These examples have not
been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or
imply reliability, serviceability, or function of these programs. You may copy,
modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application
programs conforming to IBMs application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must
include a copyright notice as follows:
(your company name) (year). Portions of this code are derived from IBM Corp.
Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights
reserved.
If you are viewing this information in softcopy form, the photographs and color
illustrations might not be displayed.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corp., registered in many jurisdictions worldwide.
Other product and service names might be trademarks of IBM or other companies.
A current list of IBM trademarks is available on the Web at Copyright and
trademark information at www.ibm.com/legal/copytrade.shtml.
Intel, Intel logo, and Itanium are trademarks or registered trademarks of Intel
Corporation or its subsidiaries in the United States and other countries.
Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Sun Microsystems, Inc. in the United States,
other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or

both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Other company, product, and service names may be trademarks or service marks
of others.
Appendix B. Notices
113
114
Index
A
attribute groups
IfTable 9
IfToIpMap 22
Interfaces 37
IP 38
IpAddrTable 46
IpRouteTable 48
list of all 7
Monitored Network Devices nodes 52
more information 7
nma Performance Object Status 53
overview 7
Performance Object Status 59
SNMP 64
System 75
TCP 77
TCPConnTable 82
Thread Pool Status 84
UDP 88
UDPTable 90
attributes
Average Collection Duration 58, 63
Cache Hit Percent 58, 64
Cache Hits 58, 63
Cache Misses 58, 64
Error Code 55, 61
ifAdminStatus 14, 28
ifDescr 10, 23
ifIndex 9, 23
ifInDiscards 16, 30
ifInDiscardsPerSec 20, 34
ifInErrors 16, 30
ifInErrorsPerSec 21, 34
ifInNUcastPkts 16, 29
ifInOctectsPerSec 20, 34
ifInOctets 15, 29
ifInOctetsInMil 19, 33
ifInUcastPkts 15, 29
ifInUnknownProtos 17, 30
ifInUnknownProtosPerSec 21, 35
ifLastChange 15, 29
ifMtu 13, 27
ifNumber 38
ifOperStatus 14, 28
ifOutDiscards 18, 32
ifOutDiscardsPerSec 21, 35
ifOutErrors 18, 32
ifOutErrorsPerSec 22, 35
ifOutNUcastPkts 18, 31
ifOutOctectsInMil 19, 33
ifOutOctectsPerSec 20, 33
ifOutOctets 17, 31
ifOutQLen 19, 32
ifOutQLenPerSec 22, 36
ifOutUcastPkts 17, 31
ifPhysAddress 14, 28
ifSpecific 19, 33
ifSpeed 14, 27
IfTable 9
IfToIpMap 23
attributes (continued)
ifType 10, 23
Interfaces 38
Intervals Skipped 59, 64
IP 38
IpAddrTable 46
ipAdEntAddr 36, 46
ipAdEntBcastAddr 37, 47
ipAdEntIfIndex 36, 47
ipAdEntNetMask 36, 47
ipAdEntReasmMaxSize 37, 47
ipDefaultTTL 39
ipForwarding 39
ipForwDatagrams 40
ipFragCreates 44
ipFragFails 44
ipFragOKs 44
ipInAddrErrors 40
ipInAddrErrorsPerSec 45
ipInDelivers 41
ipInDiscards 41
ipInHdrErrors 40
ipInHdrErrorsPerSec 45
ipInReceives 39
ipInUnknownProtos 41
ipOutDiscards 42
ipOutNoRoutes 42
ipOutRequests 42
ipReasmFails 43
ipReasmOKs 43
ipReasmReqds 43
ipReasmTimeout 43
ipRouteAge 51
ipRouteDest 48
ipRouteIfIndex 48
ipRouteInfo 52
ipRouteMask 51
ipRouteMetric1 49
ipRouteMetric2 49
ipRouteMetric3 49
ipRouteMetric4 50
ipRouteMetric5 52
ipRouteNextHop 50
ipRouteProto 51
IpRouteTable 48
ipRouteType 50
ipRoutingDiscards 45
Last Collection Duration 57, 63
Last Collection Finished 57, 63
Last Collection Start 57, 62
Monitored Network Devices nodes 52
more information 7
nma Performance Object Status 54
Node 9, 23, 38, 46, 48, 52, 54, 59, 64, 75, 77, 82, 84, 88, 90
Number of Collections 58, 63
Object Name 54, 60
Object Status 55, 60
Object Type 54, 60
overview 7
Query Name 54, 59
115
Refresh Interval 58, 63
SNMP 64
snmpEnableAuthenTraps 73
snmpInASNParseErrs 66
snmpInASNParseErrsPerSec 74
snmpInBadCommunityNames 66
snmpInBadCommunityUses 66
snmpInBadValues 67
snmpInBadVersions 65
snmpInGenErrs 68
snmpInGetNexts 69
snmpInGetRequests 69
snmpInGetResponses 70
snmpInNoSuchNames 67
snmpInPkts 65
snmpInReadOnlys 68
snmpInSetRequests 69
snmpInTooBigs 67
snmpInTotalReqVars 68
snmpInTotalSetVars 68
snmpInTraps 70
snmpOutBadValues 71
snmpOutGenErrs 71
snmpOutGetNexts 72
snmpOutGetRequests 72
snmpOutGetResponses 73
snmpOutNoSuchNames 71
snmpOutPkts 65
snmpOutSetRequests 72
snmpOutTooBigs 70
snmpOutTraps 73
snmpProxyDrops 74
snmpSilentDrops 73
Subnode Affinity 53
Subnode MSN 53
Subnode Resource Name 53
Subnode Type 53
Subnode Version 53
sysContact 76
sysDescr 75
sysLocation 76
sysName 76
sysObjectID 75
sysORLastChange 76
sysServices 76
System 75
sysUpTime 75
TCP 77
tcpActiveOpens 78
tcpAttemptFails 79
tcpConnLocalAddress 83
tcpConnLocalPort 83
tcpConnRemAddress 83
tcpConnRemPort 84
tcpConnState 82
TCPConnTable 82
tcpCurrEstab 80
tcpEstabResets 79
tcpInErrs 81
tcpInErrsPerSec 82
tcpInSegs 80
tcpMaxConn 78
tcpOutRsts 81
tcpOutSegs 80
tcpPassiveOpens 79
tcpRetransSegs 81
116
tcpRtoAlgorithm 77
tcpRtoMax 78
tcpRtoMin 77
Thread Pool Active Threads 85
Thread Pool Avg Active Threads 85
Thread Pool Avg Job Wait 87
Thread Pool Avg Queue Length 86
Thread Pool Max Active Threads 86
Thread Pool Max Queue Length 87
Thread Pool Max Size 85
Thread Pool Min Active Threads 86
Thread Pool Min Queue Length 87
Thread Pool Queue Length 86
Thread Pool Size 84
Thread Pool Status 84
Thread Pool Total Jobs 88
Timestamp 9, 23, 38, 39, 46, 48, 52, 54, 59, 65, 75, 77, 82,
84, 88, 90
UDP 88
udpInDatagrams 88
udpInErrors 89
udpInErrorsPerSec 90
udpLocalAddress 90
udpLocalPort 91
udpNoPorts 89
udpOutDatagrams 89
UDPTable 90
Average Collection Duration attribute 58, 63
C
Cache Hit Percent attribute 58, 64
Cache Hits attribute 58, 63
Cache Misses attribute 58, 64
calculate historical data disk space 91
capacity planning
Network Devices agent 92
capacity planning for historical data 91
commands, Take Action 97
D
data logged
disk capacity planning
See capacity planning
disk capacity planning for historical data
E
environment
features 1
event
mapping 101
55, 61
F
features, Network Devices agent
H
historical data
calculate disk space
91
91
historical data (continued)

capacity planning
disk capacity planning 91
I
IBM Tivoli Enterprise Console
event mapping 101
ifAdminStatus attribute 14, 28
ifDescr attribute 10, 23
ifIndex attribute 9, 23
ifInDiscards attribute 16, 30
ifInDiscardsPerSec attribute 20, 34
ifInErrors attribute 16, 30
ifInErrorsPerSec attribute 21, 34
ifInNUcastPkts attribute 16, 29
ifInOctectsPerSec attribute 20, 34
ifInOctets attribute 15, 29
ifInOctetsInMil attribute 19, 33
ifInUcastPkts attribute 15, 29
ifInUnknownProtos attribute 17, 30
ifInUnknownProtosPerSec attribute 21, 35
ifLastChange attribute 15, 29
ifMtu attribute 13, 27
ifNumber attribute 38
ifOperStatus attribute 14, 28
ifOutDiscards attribute 18, 32
ifOutDiscardsPerSec attribute 21, 35
ifOutErrors attribute 18, 32
ifOutErrorsPerSec attribute 22, 35
ifOutNUcastPkts attribute 18, 31
ifOutOctectsInMil attribute 19, 33
ifOutOctectsPerSec attribute 20, 33
ifOutOctets attribute 17, 31
ifOutQLen attribute 19, 32
ifOutQLenPerSec attribute 22, 36
ifOutUcastPkts attribute 17, 31
ifPhysAddress attribute 14, 28
ifSpecific attribute 19, 33
ifSpeed attribute 14, 27
IfTable attribute group 9
IfToIpMap attribute group 22
ifType attribute 10, 23
information, additional
attributes 7
policies 99
situations 93
Take Action commands 97
workspaces 3
Interface Status workspace 6
interface, user 1
Interfaces attribute group 37
Intervals Skipped attribute 59, 64
IP attribute group 38
IpAddrTable attribute group 46
ipAdEntAddr attribute 36, 46
ipAdEntBcastAddr attribute 37, 47
ipAdEntIfIndex attribute 36, 47
ipAdEntNetMask attribute 36, 47
ipAdEntReasmMaxSize attribute 37, 47
ipDefaultTTL attribute 39
ipForwarding attribute 39
ipForwDatagrams attribute 40
ipFragCreates attribute 44
ipFragFails attribute 44
ipFragOKs attribute 44
ipInAddrErrors attribute 40
ipInAddrErrorsPerSec attribute 45
ipInDelivers attribute 41
ipInDiscards attribute 41
ipInHdrErrors attribute 40
ipInHdrErrorsPerSec attribute 45
ipInReceives attribute 39
ipInUnknownProtos attribute 41
ipOutDiscards attribute 42
ipOutNoRoutes attribute 42
ipOutRequests attribute 42
ipReasmFails attribute 43
ipReasmOKs attribute 43
ipReasmReqds attribute 43
ipReasmTimeout attribute 43
ipRouteAge attribute 51
ipRouteDest attribute 48
ipRouteIfIndex attribute 48
ipRouteInfo attribute 52
ipRouteMask attribute 51
ipRouteMetric1 attribute 49
ipRouteNextHop attribute 50
ipRouteProto attribute 51
IpRouteTable attribute group 48
ipRouteType attribute 50
ipRoutingDiscards attribute 45
K
KN4_InterfaceDown
situations 94
KN4_InterfaceDown situation 94
KN4_IPHdrErrors
situations 94
KN4_IPHdrErrors situation 94
KN4_ipInAddrErrors
situations 94
KN4_ipInAddrErrors situation 95
KN4_PacketsOnError
situations 94
KN4_PacketsOnError situation 94
situations 94
KN4_snmpInASNParseErrs situation
KN4_TCPinErrors
situations 94
KN4_TCPinErrors situation 95
KN4_UDPinErrors
situations 94
KN4_UDPinErrors situation 95
95
L
Last Collection Duration attribute 57, 63
Last Collection Finished attribute 57, 63
Last Collection Start attribute 57, 62
logged data
Index
117
queries, using attributes 7

Query Name attribute 54, 59
situations (continued)
KN4_ipInAddrErrors 95
KN4_PacketsOnError 94
KN4_snmpInASNParseErrs 95
KN4_TCPinErrors 95
KN4_UDPinErrors 95
list of all 94
more information 93
overview 93
predefined 94
situations, using attributes 7
SNMP attribute group 64
snmpEnableAuthenTraps attribute 73
snmpInASNParseErrs attribute 66
snmpInASNParseErrsPerSec attribute 74
snmpInBadCommunityNames attribute 66
snmpInBadCommunityUses attribute 66
snmpInBadValues attribute 67
snmpInBadVersions attribute 65
snmpInGenErrs attribute 68
snmpInGetNexts attribute 69
snmpInGetRequests attribute 69
snmpInGetResponses attribute 70
snmpInNoSuchNames attribute 67
snmpInPkts attribute 65
snmpInReadOnlys attribute 68
snmpInSetRequests attribute 69
snmpInTooBigs attribute 67
snmpInTotalReqVars attribute 68
snmpInTotalSetVars attribute 68
snmpInTraps attribute 70
snmpOutBadValues attribute 71
snmpOutGenErrs attribute 71
snmpOutGetNexts attribute 72
snmpOutGetRequests attribute 72
snmpOutGetResponses attribute 73
snmpOutNoSuchNames attribute 71
snmpOutPkts attribute 65
snmpOutSetRequests attribute 72
snmpOutTooBigs attribute 70
snmpOutTraps attribute 73
snmpProxyDrops attribute 74
snmpSilentDrops attribute 73
Subnode Affinity attribute 53
Subnode MSN attribute 53
Subnode Resource Name attribute 53
Subnode Type attribute 53
Subnode Version attribute 53
sysContact attribute 76
sysDescr attribute 75
sysLocation attribute 76
sysName attribute 76
sysObjectID attribute 75
sysORLastChange attribute 76
sysServices attribute 76
System attribute group 75
sysUpTime attribute 75
Monitored Network
workspaces
descriptions
Monitored Network
workspaces
descriptions
list 4
Monitored Network
Monitored Network
Monitored Network
situations 94
Monitored Network
Devices
5
Devices nodes
5
Devices nodes attribute group
Devices nodes workspace 5
Devices subnode
Devices workspace
52
N
Network Devices
workspaces
descriptions 4
list 4
Network Devices agent
features 1
Network Devices workspace 4
nma Performance Object Status
workspaces
descriptions 6
nma Performance Object Status attribute group 53
nma Performance Object Status workspace 6
Node attribute 9, 23, 38, 46, 48, 52, 54, 59, 64, 75, 77, 82, 84,
88, 90
Number of Collections attribute 58, 63
O
Object Name attribute 54, 60
Object Status attribute 55, 60
Object Type attribute 54, 60
P
Performance Object Status
workspaces
descriptions 5
list 4
Performance Object Status attribute group
Performance Object Status workspace 5
policies
more information 99
overview 99
59
58, 63
S
situations
KN4_InterfaceDown 94
KN4_IPHdrErrors 94
118
Take Action commands

more information 97
overview 97
TCP attribute group 77
tcpActiveOpens attribute 78
tcpAttemptFails attribute 79
tcpConnLocalAddress attribute
83
tcpConnLocalPort attribute 83
tcpConnRemAddress attribute 83
tcpConnRemPort attribute 84
tcpConnState attribute 82
TCPConnTable attribute group 82
tcpCurrEstab attribute 80
tcpEstabResets attribute 79
tcpInErrs attribute 81
tcpInErrsPerSec attribute 82
tcpInSegs attribute 80
tcpMaxConn attribute 78
tcpOutRsts attribute 81
tcpOutSegs attribute 80
tcpPassiveOpens attribute 79
tcpRetransSegs attribute 81
tcpRtoAlgorithm attribute 77
tcpRtoMax attribute 78
tcpRtoMin attribute 77
Thread Pool Active Threads attribute 85
Thread Pool Avg Active Threads attribute 85
Thread Pool Avg Job Wait attribute 87
Thread Pool Avg Queue Length attribute 86
Thread Pool Max Active Threads attribute 86
Thread Pool Max Queue Length attribute 87
Thread Pool Max Size attribute 85
Thread Pool Min Active Threads attribute 86
Thread Pool Min Queue Length attribute 87
Thread Pool Queue Length attribute 86
Thread Pool Size attribute 84
Thread Pool Status attribute group 84
Thread Pool Total Jobs attribute 88
Timestamp attribute 9, 23, 38, 39, 46, 48, 52, 54, 59, 65, 75, 77,
82, 84, 88, 90
workspaces (continued)
nma Performance Object Status
overview 3
predefined 3, 4
U
UDP attribute group 88
udpInDatagrams attribute 88
udpInErrors attribute 89
udpInErrorsPerSec attribute 90
udpLocalAddress attribute 90
udpLocalPort attribute 91
udpNoPorts attribute 89
udpOutDatagrams attribute 89
UDPTable attribute group 90
user interfaces options 1
V
views
Interface Status workspace 6
Monitored Network Devices workspace 5
Network Devices workspace 4
nma Performance Object Status workspace 6
Performance Object Status workspace 5
W
workspaces
Interface Status 6
list of all 3, 4
Monitored Network Devices 5
Monitored Network Devices nodes
more information 3
Network Devices 4
Index
119
120

Printed in USA
SC27-2831-00

Devices 6212 Reference Guide

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Devices 6212 Reference Guide

Uploaded by

Copyright:

Available Formats

Tivoli Agent for Network Devices

Tivoli Agent for Network Devices

UDPTable attribute group . . . . . .

Chapter 4. Situations reference . . . . 93

Chapter 3. Attributes reference . . . . . 7

Copyright IBM Corp. 2009, 2010

Chapter 5. Take Action commands

Chapter 6. Policies reference . . . . . 99

Appendix A. IBM Tivoli Enterprise

Network Devices agent: Reference Guide

Chapter 1. Overview of the agent

Features of the monitoring agent

SNMPv1, SNMPv2c, SNMPv3

User interface options

Copyright IBM Corp. 2009, 2010

Network Devices agent: Reference Guide

Chapter 2. Workspaces reference

More information about workspaces

Agent Navigator items

Network Devices Navigator item

Network Devices agent: Reference Guide

Monitored Network Devices nodes Navigator item

Performance Object Status Navigator item

Monitored Network Devices subnode

Monitored Network Devices Navigator item

Interface Statistics Table

nma Performance Object Status Navigator item

Network Devices agent: Reference Guide

Chapter 3. Attributes reference

More information about attributes

Attribute groups and attributes for the Network Devices agent

Warehouse table name: KN4_INTERFACES or KN4INTERFA

Network Devices agent: Reference Guide

The remaining sections of this chapter contain descriptions of these attribute

IfTable attribute group

Integer (Gauge) with enumerated values. The strings are displayed

Integer with enumerated values. The strings are displayed in the

Network Devices agent: Reference Guide

Network Devices agent: Reference Guide

Integer (Gauge) with enumerated values. The strings are displayed

Integer ( 64 Bit Gauge) with enumerated values. The strings are

Integer with enumerated values. The strings are displayed in the

Network Devices agent: Reference Guide

Integer with enumerated values. The strings are displayed in the

Integer ( 64 Bit Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

Network Devices agent: Reference Guide

Integer (Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

Integer ( 64 Bit Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

displayed in the Tivoli Enterprise Portal. The warehouse and

Integer (Counter) with enumerated values. The strings are

Integer (Counter) with enumerated values. The strings are

Network Devices agent: Reference Guide

Integer (Counter) with enumerated values. The strings are

displayed in the Tivoli Enterprise Portal. The warehouse and

Integer (Gauge) with enumerated values. The strings are displayed

Integer ( 64 Bit Counter) with enumerated values. The strings are

Chapter 3. Attributes reference

Integer ( 64 Bit Counter) with enumerated values. The strings are

Integer (rate of change between successive values) with