Digital TCP/IP Services for OpenVMS eSNMP Programming and Reference

Previous | Contents

3.4 Defining MIB-II Implemented Objects .

Table 3-3 MIB-II System Group Objects Object Name sysDescr sysObjectID Data Type Access RFC Description A textual description of the entity, for example, hardware or operating system.

DisplayString Read only Object Identifier TimeTicks

The vendor's authoritative identification of the Read only network management subsystem contained in the entity. The time, in hundredths of a second, since the network Read only management portion of the system was last reinitialized. The textual identification of the contact person responsible for this managed node. An administratively assigned name for this managed node. A value indicating the set of services that this entity primarily offers.

sysUpTime sysContact sysName

DisplayString Read/write DisplayString Read/write

sysLocation DisplayString Read/write The physical location of this node. sysServices Integer Read only

Object Name ifNumber ifTable ifEntry ifIndex ifDescr

Table 3-4 MIB-II Interfaces Group Objects Data Type Access RFC Description Integer Read only The number of network interfaces. Sequence of IfEntry IfEntry Integer Not accessible Not accessible A list of interface entries. An interface entry containing objects at the subnetwork layer and below for a particular interface. Information about the interface, including name of manufacturer, product name, and

Read only A unique value for each interface.

DisplayString Read only

version of the hardware interface. ifType ifMtu ifSpeed ifPhysAddress ifAdminStatus Integer Integer Gauge PhysAddress Integer Read only Read only Read only Read only Type of interface, distinguished according to the physical/link protocol(s). The size of the largest datagram, in octets, that can be sent/received on the interface. An estimate of the interface's current bandwidth capacity. The interface's address at the protocol layer immediately below the Network layer.

Desired interface state: up (1); down (2); Read/write testing (3). The testing state indicates that no operational packets can be passed. Current operational interface state: up (1); down (2); testing (3). The testing state Read only indicates that no operational packets can be passed. Read only Read only Read only Read only Value of sysUpTime at the time the interface entered its current operational state. Total number of octets received on the interface, including framing characters. Number of subnetwork unicast packets delivered to a higher-layer protocol. Number of non-unicast packets delivered to a higher-layer protocol.

ifOperStatus

Integer

ifLastChange ifInOctets ifInUcastPkts ifInNUcastPkts

TimeTicks Counter Counter Counter

ifInDiscards

Counter

Number of inbound packets discarded even though no errors were detected. This prevents Read only them from being delivered to a higher-layer protocol (for example, buffer overflow). Number of inbound packets that contain errors Read only preventing them from being deliverable to a higher-layer protocol. Number of packets that were discarded Read only because of an unknown or unsupported protocol. Read only Total number of octets transmitted on the interface, including framing characters.

ifInErrors

Counter

ifInUnknownProtos Counter ifOutOctets Counter

ifOutUcastPkts ifOutNUcastPkts

Counter Counter

Total number of packets requested by higherlevel protocols to be transmitted to a Read only subnetwork- unicast address, including those that were discarded or otherwise not sent. Read only Total number of packets requested by higher-

level protocols to be transmitted to a nonunicast address, including those that were discarded or otherwise not sent. ifOutDiscards Counter Number of outbound packets discarded even though no errors were detected. This prevents Read only them from being transmitted (for example, buffer overflow). Read only Number of outbound packets that could not be transmitted because of errors.

ifOutErrors ifOutQLen ifSpecific

Counter Gauge Object Identifier

Read only Length of the output packet queue (in packets). Reference to MIB definitions specific to the Read only particular media being used to realize the interface.

Object Name atTable atEntry atIndex

Table 3-5 MIB-II Address Translation Group Objects Data Type Access RFC Description Sequence of AtEntry AtEntry Integer Not accessible Not accessible Contains the NetAddress to PhysAddress equivalent. Each entry contains one NetAddress to PhysAddress equivalent.

Read/write Interface on which this entry is effective. Read/write Media-dependent physical address. The NetAddress (for example, IP address) Read/write corresponding to the media-dependent physical address. Table 3-6 MIB-II IP Group Objects Data Type Access Integer RFC Description

atPhysAddress PhysAddress atNetAddress NetAddress

Object Name ipForwarding

If the value is (1), the entity is acting as an IP gateway (1). If the Read/write value is (2), the entity is not acting as an IP gateway. Default value inserted into timeto-live field of IP header of Read/write datagrams originated at this entity. Total number of input datagrams Read only received from interfaces, including those received in error. Number of input datagrams discarded due to errors in IP header.

ipDefaultTTL

Integer

ipInReceives

Counter

ipInDdrErrors

Counter

ipAddrErrors

Counter

Number of input datagrams discarded because the IP address Read only in the destination field was not valid for receipt at this entity. Number of input datagrams for which this entity was not their Read only final IP destination, a result of which an attempt was made to forward. Number of locally addressed datagrams received successfully Read only but discarded because of an unknown or unsupported protocol. Number of input datagrams for which no problems were encountered to prevent their Read only continued processing but that were discarded (for example, for lack of buffer space). Total number of input Datagram Read only successfully delivered to IP user protocols. Total number of input datagrams that local IP user protocols Read only supplied to IP in request for transmission. Number of output datagrams for which no problems were encountered to prevent Read only transmission to their destination but were discarded (for example, for lack of buffer space). Number of IP datagrams Read only discarded because no route could be found. Maximum number of seconds that received fragments are held Read only awaiting reassembly at this entity. Number of IP fragments received Read only that needed to be reassembled at this entity.

ipForwDatagrams

Counter

ipUnknownProtos

Counter

ipDiscards

Counter

ipDelivers

Counter

ipOutRequests

Counter

ipOutDiscards

Counter

ipOutNoRoutes

Counter

ipReasmTimeout

Integer

ipReasmReqds

Counter

ipReasmOKs ipReasmFails ipFragOKs

Counter Counter Counter

Read only Read only

Number of IP datagrams successfully reassembled. Number of failures detected by the IP reassembly algorithm.

Number of IP datagrams that Read only have been successfully fragmented at this entity. Number of IP datagrams discarded because they needed to Read only be fragmented at this entity but could not be because the do-notfragment flag was set. Number of IP datagram Read only fragments generated at this entity. Table of addressing information Not relevant to the IP address of this accessible entity. Not Addressing information for one accessible of this entity's IP addresses. Read only IP address to which this entry's addressing information pertains.

ipFragFails

Counter

ipFragCreates

Counter Sequence of IpAddrEntry IpAddrEntry IpAddress Integer IpAddress

ipAddrTable ipAddrEntry ipAdEntAddr ipAdEntIndex ipAdEntNetMask

Index value that uniquely Read only identifies the interface to which this entry is applicable. Read only Subnetwork mask associated with the IP address of this entity.

ipAdEntBcastAddr

Integer

Value of the least-significant bit in the IP broadcast address used Read only for sending datagrams on the logical interface associated with the IP address of this entry. Size of the largest IP datagrams that this entity can reassemble Read only from incoming IP fragmented datagrams received on this interface. Not The IP routing table for this accessible entity. Not A route to a specific destination. accessible

ipAdEntReasmMaxSize

Integer

ipRouteTable ipRouteEntry

Sequence of IpRouteEntry IpRouteEntry

ipRouteDest

IpAddress

Read/write

The destination IP address of this route.

ipRouteIfIndex

Integer

Index value that uniquely identifies the local interface Read/write through which the next hop of this route should be reached. Read/write Read/write Read/write Read/write Read/write Primary routing metric for this route. Alternate routing metric for this route. Alternate routing metric for this route. Alternate routing metric for this route. IP address of next hop of this route.

ipRouteMetric1 ipRouteMetric2 ipRouteMetric3 ipRouteMetric4 ipRouteNextHop

Integer Integer Integer Integer IpAddress

ipRouteType

Integer

The type of route. The following values are valid for this entity: Read/write other (1); invalid (2); direct (3); indirect (4). The routing mechanism via which this route was learned. The following values are valid for this entity: other (1); local (2); Read only netmgmt (3); icmp (4); egp (5); ggp (6); hello (7); rip (8); is-is (9); es-is (10); ciscoIgrp (11); bbnSpfIgp (12); ospf (13); bgp (14). Number of seconds since this Read/write route was last updated or verified. Mask to be ANDed with Read/write destination address before being compared to ipRouteDest. Read/write Alternate routing metric for this route.

ipRouteProto

Integer

ipRouteAge

Integer

ipRouteMask ipRouteMetric5 ipRouteInfo ipNetToMediaTable

IpAddress Integer Object Identifier

Reference to MIB definitions Read only specific to the routing protocol responsible for this route.

Sequence of Not IP address translation table used IpNetToMediaEntry accessible for mapping from IP addresses to

physical addresses. ipNetToMediaEntry ipNetToMediaIfIndex Each entry contains one IP Not address to physical address IpNetToMediaEntry accessible equivalent. Integer Read/write Read/write Interface for which this entry's equivalence applies. Media-dependent physical address.

ipNetToMediaPhysAddress PhysAddress ipNetToMediaNetAddress IpAddress

IP address correspoding to the Read/write media-dependent physical address. Type of mapping: Other (1); Read/write invalid (2); dynamic (3); static (4). Number of routing entries discarded even though valid (for Read only example, due to lack of buffer space).

ipNetToMediaType

Integer

ipRoutingDiscards

Counter

Object Name icmpInMsgs icmpInErrors icmpInDestUnreachs icmpInTimeExcds icmpInParmProbs icmpInSrcQuenchs icmpInRedirects icmpInEchos icmpInEchoReps icmpInTimestamps

Table 3-7 MIB-II ICMP Group Objects Data Access RFC Description Type Counter Counter Counter Counter Counter Counter Counter Counter Counter Read only Read only Read only Read only Read only Read only Read only Read only Read only Number of ICMP messages that the entity received. Number of ICMP messages received but determined to have ICMP-specific errors. Number of ICMP destination-unreachable messages received. Number of ICMP time-exceeded messages received. Number of ICMP parameter-problem messages received. Number of ICMP source-quench messages received. Number of ICMP redirect messages received. Number of ICMP echo-request messages received. Number of ICMP echo-reply messages received. Number of ICMP timestamp-request messages

Counter Read

only icmpInTimestampReps icmpInAddrMasks icmpInAddrMaskReps icmpOutMsgs icmpOutErrors icmpOutDestUnreachs icmpOutTimeExcds icmpOutParmProbs icmpOutSrcQuenchs icmpOutRedirects icmpOutEchos icmpOutEchoReps icmpOutTimestamps Counter Counter Counter Counter Counter Counter Counter Counter Counter Counter Counter Counter Counter Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only Read only

received. Number of ICMP timestamp-reply messages received. Number of ICMP address-mask-request messages received. Number of ICMP address-mask-reply messages received. Total number of ICMP messages that the entity attempted to send. Number of ICMP messages that the entity did not send due to problems discovered within ICMP. Number of ICMP destination-unreachable messages sent. Number of ICMP time-exceeded messages sent. Number of ICMP parameter-problem messages sent. Number of ICMP source-quench messages sent. Number of ICMP redirect messages sent. Number of ICMP echo-request messages sent. Number of ICMP echo-reply messages sent. Number of ICMP timestamp-request messages sent. Number of ICMP timestamp-reply messages sent. Number of ICMP address-mask-request messages sent. Number of ICMP address-mask-reply messages sent.

icmpOutTimestampReps Counter icmpOutAddrMasks Counter

icmpOutAddrMaskReps Counter

Object Name

Table 3-8 MIB-II TCP Group Objects Data Type Access RFC Description The algorithm used to determine the timeout value used for retransmitting Read only unacknowledged octets. Retransmission time: other (1); constant (2); MIL-STD1778 (3); Van Jacobson's algorithm (4).

tcpRtoAlgorithm

Integer

tcpRtoMin tcpRtoMax tcpMaxConn tcpActiveOpens

Integer Integer Integer Counter

Read only Read only Read only

Minimum value for the retransmission timeout, measured in milliseconds. Maximum value for the retransmission timeout, measured in milliseconds. Limit on total number of TCP connections the entity can support.

Number of times TCP connections have Read only made a direct transition to the SYN-SENT state from the CLOSED state. Number of times TCP connections have Read only made a direct transition to the SYN-RCVD state from the LISTEN state. Number of times TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the Read only SYN-RCVD state. In addition, this includes number of times TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state. Number of times TCP connections have made a direct transition to the CLOSED Read only state from either the ESTABLISHED state or the CLOSE-WAIT state. Number of TCP connections for which the Read only current state is either ESTABLISHED or CLOSE-WAIT. Read only Read only Total number of segments received, including those received in error. Total number of segments sent, excluding those containing only retransmitted octets.

tcpPassiveOpens

Counter

tcpAttemptFails

Counter

tcpEstabResets

Counter

tcpCurrEstab tcpInSegs tcpOutSegs tcpRetransSeg tcpConnTable tcpConnEntry

Gauge Counter Counter Counter

Read only Total number of retransmitted segments.

Sequence of Not Contains TCP connection-specific TcpConnEntry accessible information. TcpConnEntry Not Information about a particular current TCP accessible connection. The state of this TCP connection closed (1), listen (2), synSent (3), synReceived (4), Read/write established (5), finWait1 (6), finWait2 (7), closeWait (8), lastAck (9), closing (10), timeWait (11), delete TCB (12). Read only Local IP address for this TCP connection.

tcpConnState

Integer

tcpConnLocalAddress IpAddress

tcpConnLocalPort

Integer

Read only Local port number for this TCP connection. Read only Remote IP address for this TCP connection. Read only Remote port number for this TCP connection. Number of TCP segments sent containing the RST flag.

tcpConnRemAddress IpAddress tcpConnRemPort tcpInErrs tcpOutRsts Integer Counter Counter

Read only Total number of segments received in error. Read only

Object Name udpInDatagrams udpNoPorts

Table 3-9 MIB-II UDP Group Objects Data Type Access RFC Description Counter Counter Read only Total number of UDP datagrams delivered to UDP users.

Total number of received UDP datagrams for Read only which there was no application at the destination port. Number of received UDP datagrams that could Read only not be delivered for reasons other than the lack of an application at the destination port. Read only Total number of UDP datagrams sent from this entity.

udpInErrors

Counter

udpOutDatagrams Counter udpTable udpEntry Sequence of UdpEntry UdpEntry

Not Contains UDP listener information. accessible Not Information about a particular current UDP accessible listener. Read only Local IP address for this UDP listener. Read only Local port number for this UDP listener.

udpLocalAddress IpAddress udpLocalPort Integer

Object Name snmpInPkts snmpOutPkts

Table 3-10 MIB-II SNMP Group Objects Data Access RFC Description Type Read The total number of messages delivered to the Counter only SNMP entity from the transport service. Read Counter only Counter Read only The total number of SNMP messages passed from the SNMP protocol entity to the transport service. The total number of SNMP messages delivered to the SNMP protocol entity that were for an unsupported version of SNMP. The total number of SNMP messages that used a community name unknown to the receiving SNMP protocol entity.

snmpInBadVersions

Read snmpInBadCommunityNames Counter only

snmpInBadCommunityUses

Read Counter only

The total number of SNMP messages delivered to the SNMP protocol entity that represented an SNMP operation that was not allowed by the SNMP community named in the message. The total number of Abstract Syntax Notation One (ASN.1) or basic encoding rules (BER) language code errors encountered by the SNMP protocol entity when decoding received SNMP messages. The total number of SNMP protocol data units (PDUs) delivered to the SNMP protocol entity for which the value of the error-status field is tooBig. The total number of SNMP PDUs delivered to the SNMP protocol entity for which the value of the error-status field is noSuchName. The total number of SNMP PDUs delivered to the SNMP protocol entity for which the value of the error-status field is badValue. The total number of valid SNMP PDUs delivered to the SNMP protocol entity for that the value of the error-status field is "Read only." It is a protocol error to generate an SNMP PDU that contains the value "Read only" in the error-status field. This object is provided as a means of detecting incorrect implementations of the SNMP. The total number of SNMP PDUs delivered to the SNMP protocol entity for which the value of the error-status field is genErr. The total number of MIB objects retrieved successfully by the SNMP protocol entity as the result of receiving valid SNMP Get-Request and Get-Next PDUs. The total number of MIB objects altered successfully by the SNMP protocol entity as the result of receiving valid SNMP Set-Request PDUs. The total number of SNMP Get-Request PDUs accepted and processed by the SNMP protocol entity. The total number of SNMP Get-Next PDUs accepted and processed by the SNMP protocol

snmpInASNParseErrs

Counter

Read only

snmpInTooBigs

Counter

Read only

snmpInNoSuchName

Read Counter only Counter Read only

snmpInBadValues

snmpInReadOnlys

Counter

Read only

snmpInGenErrs

Counter

Read only Read only

snmpInTotalReqVars

Counter

snmpInTotalSetVars

Counter

Read only

snmpInGetRequests snmpInGetNexts

Read Counter only Counter Read only

entity. snmpInSetRequests Counter Read only Read only The total number of SNMP Set-Request PDUs accepted and processed by the SNMP protocol entity. The total number of SNMP Get-Response PDUs accepted and processed by the SNMP protocol entity. The total number of SNMP Trap PDUs accepted and processed by the SNMP protocol entity. The total number of SNMP PDUs generated by the SNMP protocol entity and for which the value of the error-status field is tooBig. The total number of SNMP PDUs generated by the SNMP protocol entity and for which the value of the error-status is noSuchName. The total number of SNMP PDUs generated by the SNMP protocol entity and for which the value of the error-status field is badValue. The total number of SNMP PDUs generated by the SNMP protocol entity and for which the value of the error-status field is genErr. The total number of SNMP Get-Request PDUs generated by the SNMP protocol entity. The total number of SNMP Get-Next PDUs generated by the SNMP protocol entity. The total number of SNMP Set-Request PDUs generated by the SNMP protocol entity. The total number of SNMP Get-Response PDUs generated by the SNMP protocol entity. The total number of SNMP Trap PDUs generated by the SNMP protocol entity. Indicates whether the SNMP agent process is permitted to generate authentication-failure traps. The value of this object overrides any configuration information. For example, this entity provides a means to disable all authentication-failure traps. Digital strongly recommends that this object be stored in nonvolatile memory so it remains constant between reinitializations of the network management system.

snmpInGetResponses

Counter

snmpInTraps

Read Counter only Counter Read only

snmpOutTooBigs

snmpOutNoSuchNames

Read Counter only Counter Read only

snmpOutBadValues

snmpOutGenErrs snmpOutGetRequests snmpOutGetNexts snmpOutSetRequests snmpOutGetResponses snmpOutTraps

Read Counter only Counter Counter Counter Counter Counter Read only Read only Read only Read only Read only

snmpEnableAuthenTraps

Integer

Read only