USR-TRACEROUTE-MIB

File: USR-TRACEROUTE-MIB.mib (11870 bytes)

Imported modules

SNMPv2-SMI SNMPv2-TC USR-DEFINITIONS-MIB

Imported symbols

OBJECT-TYPE MODULE-IDENTITY Integer32
IpAddress RowStatus common
DisplayString UsrConfigStatus

Defined Types

UsrTracerouteEntry  
SEQUENCE    
  usrTracerouteIndex Integer32
  usrTracerouteDestination DisplayString Size(1..255)
  usrTracerouteResolvedIPAddress IpAddress
  usrTracerouteHopTimeout Integer32 1..60
  usrTracerouteHopProbes Integer32 1..10
  usrTracerouteMaxHops Integer32 1..255
  usrTracerouteUDPPort Integer32 1..65000
  usrTracerouteDataSize Integer32 1..8184
  usrTracerouteHopCount Integer32
  usrTracerouteState INTEGER
  usrTracerouteRowStatus RowStatus

UsrTracerouteHopEntry  
SEQUENCE    
  usrTracerouteTableIndex Integer32
  usrTracerouteHopIndex Integer32
  usrTracerouteHopIPAddress IpAddress
  usrTracerouteHopRoundTripTime Integer32

Defined Values

usrTraceroute 1.3.6.1.4.1.429.4.40
The commWorks enterprise defined MIB objects for TraceRoute
MODULE-IDENTITY    

usrTracerouteBase 1.3.6.1.4.1.429.4.40.1
OBJECT IDENTIFIER    

usrTracerouteIndexNext 1.3.6.1.4.1.429.4.40.1.1
This object contains an appropriate value that can be used for 'usrTracerouteIndex' when creating a new row in the Traceroute Table'. If the value 0 is returned, it indicates that the table contains the maximum number of rows and thus it is not possible to add another one.
OBJECT-TYPE    
  Integer32  

usrTracerouteIndexNRows 1.3.6.1.4.1.429.4.40.1.2
Number of rows currently present in the Traceroute table.
OBJECT-TYPE    
  Integer32  

usrTracerouteMaxRows 1.3.6.1.4.1.429.4.40.1.3
Maximum number of rows allowed in the Traceroute table. Note that setting this object to a number which is smaller than the current number of rows will NOT cause any row deletions - rather, the effect of such an action will be noted in future attempts at row creation.
OBJECT-TYPE    
  Integer32 1..255  

usrTracerouteConfigFileName 1.3.6.1.4.1.429.4.40.1.4
The name of a ConfigFile to read/write permanent database records. If the value of this object is an empty string, then the Traceroute process uses the default name `@file://TracerouteProcess.cfg'.
OBJECT-TYPE    
  DisplayString  

usrTracerouteCFMStatusFlag 1.3.6.1.4.1.429.4.40.1.5
Setting the value of this object to `save' causes the values of the Remote Ping Group to be written out to the current config file, which is stored in the usrTracerouteConfigFileName object. While the new ConfigFile is being written, the Remote Ping process will set the value of this flag set to `saving''. Any attempts to set the value while it is not `normal' (i.e. the file is currently being written to the ConfigFile) while result in a badValue error being returned. Setting the value to `normal' will result in no action.
OBJECT-TYPE    
  UsrConfigStatus  

usrTracerouteTable 1.3.6.1.4.1.429.4.40.2
A table of traceroute entries.
OBJECT-TYPE    
  SEQUENCE OF  
    UsrTracerouteEntry

usrTracerouteEntry 1.3.6.1.4.1.429.4.40.2.1
A list of fields defining this traceroute
OBJECT-TYPE    
  UsrTracerouteEntry  

usrTracerouteIndex 1.3.6.1.4.1.429.4.40.2.1.1
A unique index identifying this entry in the table.
OBJECT-TYPE    
  Integer32  

usrTracerouteDestination 1.3.6.1.4.1.429.4.40.2.1.2
The host name or IP address (in dot notation) of the target destination being traced by this row. A row cannot be activated unless this object has a length greater than zero. Router DNS services will always be used to resolve (names) and/or verify addresses in dot notation. If DNS fails, the object usrTracerouteRowState will indicate 'dnsFailed' or 'badAddress'. This object cannot be modified whenever usrTracerouteRowStatus is 'active'.
OBJECT-TYPE    
  DisplayString Size(1..255)  

usrTracerouteResolvedIPAddress 1.3.6.1.4.1.429.4.40.2.1.3
The IP address resolved from the destination address string. If an IP address was set in the destination field it will be reflected here as well. If an address cannot be resolved, this object returns zero and the state field is set to dnsFail
OBJECT-TYPE    
  IpAddress  

usrTracerouteHopTimeout 1.3.6.1.4.1.429.4.40.2.1.4
Amount of time in seconds before retrying a hop. This object cannot be modified whenever usrTracerouteRowStatus is 'active'.
OBJECT-TYPE    
  Integer32 1..60  

usrTracerouteHopProbes 1.3.6.1.4.1.429.4.40.2.1.5
The maixmum number of times to try to discern a hop before moving on to the next hop
OBJECT-TYPE    
  Integer32 1..10  

usrTracerouteMaxHops 1.3.6.1.4.1.429.4.40.2.1.6
The maixmum number of hops to trace before quitting.
OBJECT-TYPE    
  Integer32 1..255  

usrTracerouteUDPPort 1.3.6.1.4.1.429.4.40.2.1.7
The UDP port value to use when attempting to find the route
OBJECT-TYPE    
  Integer32 1..65000  

usrTracerouteDataSize 1.3.6.1.4.1.429.4.40.2.1.8
The maixmum number of hops to trace before quitting.
OBJECT-TYPE    
  Integer32 1..8184  

usrTracerouteHopCount 1.3.6.1.4.1.429.4.40.2.1.9
The number of hops taken to get to the destination.
OBJECT-TYPE    
  Integer32  

usrTracerouteState 1.3.6.1.4.1.429.4.40.2.1.10
The state of the 'traceroute' process associated with this row. Before this row is activated, this object will have the value 'notActive(1)'. Upon activation, if DNS resolution is needed, the object will receive the value 'waitingDns(2)'. If DNS times out or otherwise fails, this object will receive the value 'dnsFailed(3)'. If the resolved IP address is not legal, this object value will be 'badAddress(4)'. If the a timeout occurs or the hop count is exceeded, the value will be 'hopTimeout(6)' or 'hopsExceeded(7)'. If a route to the host could not be found, a 'destUnreachable(8)' value will be returned. If none of the above fails, the first traceroute command will be sent and this object will indicate the value 'tracing(9)'. After the completes this object will receive the value completed(10)'.
OBJECT-TYPE    
  INTEGER notActive(1), waitingDns(2), dnsFailed(3), badAddress(4), hopsExceeded(5), destUnreachable(6), tracing(7), completed(8), resourceFailure(9)  

usrTracerouteRowStatus 1.3.6.1.4.1.429.4.40.2.1.11
This object is used to create, modify or delete a row in this table. Setting this object to 'createAndWait' creates the row with default values. Right after creation the value of this object will be 'notReady'. When all parameters are given proper values, this object will return the value 'notInService', at which point the client can set the object to 'active' to activate the row. Modifying this object from 'active' to 'notInService' will cancel any on-going traceroute and remove entries for it from the usrTracerouteHopTable. Setting the object to 'active' again will start a new traceroute with the supplied parameters Setting this object to 'destroy' will stop any on-going activity and delete the row.
OBJECT-TYPE    
  RowStatus  

usrTracerouteHopTable 1.3.6.1.4.1.429.4.40.3
A table of traceroute hop entries.
OBJECT-TYPE    
  SEQUENCE OF  
    UsrTracerouteHopEntry

usrTracerouteHopEntry 1.3.6.1.4.1.429.4.40.3.1
A list of fields containing the hop information for all traceroute instances
OBJECT-TYPE    
  UsrTracerouteHopEntry  

usrTracerouteTableIndex 1.3.6.1.4.1.429.4.40.3.1.1
The index into the usrTracerouteTable corresponding to this hop.
OBJECT-TYPE    
  Integer32  

usrTracerouteHopIndex 1.3.6.1.4.1.429.4.40.3.1.2
The hop number corresponding to the usrTracerouteHopIPAddress in this row.
OBJECT-TYPE    
  Integer32  

usrTracerouteHopIPAddress 1.3.6.1.4.1.429.4.40.3.1.3
The IP address for a hop. An address of zero means that there was no response from that hop.
OBJECT-TYPE    
  IpAddress  

usrTracerouteHopRoundTripTime 1.3.6.1.4.1.429.4.40.3.1.4
Round trip time for this hop in milliseconds.
OBJECT-TYPE    
  Integer32