mibs/hp/HP-ICF-LINKTEST
HP-ICF-LINKTEST DEFINITIONS ::= BEGIN
IMPORTS
Integer32, OBJECT-TYPE, MODULE-IDENTITY
FROM SNMPv2-SMI
RowStatus, TimeInterval
FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF
OwnerString
FROM RMON-MIB
hpicfObjectModules, hpicfCommon
FROM HP-ICF-OID;
hpicfLinkTestMib MODULE-IDENTITY
LAST-UPDATED "200011032225Z" -- November 3, 2000
ORGANIZATION "Hewlett Packard Company,
Network Infrastructure Solutions"
CONTACT-INFO
"Hewlett Packard Company
8000 Foothills Blvd.
Roseville, CA 95747"
DESCRIPTION
"This MIB module describes objects for managing
the link test features of devices in the HP
Integrated Communication Facility product line."
REVISION "200011032225Z" -- November 3, 2000
DESCRIPTION "Updated division name."
REVISION "9703060338Z" -- March 6, 1997
DESCRIPTION
"Added 'destroyWhenDone' capability."
REVISION "9609062218Z" -- September 6, 1996
DESCRIPTION
"Initial version of this MIB module."
::= { hpicfObjectModules 7 }
-- The HP ICF Linktest Group
hpicfLinktest OBJECT IDENTIFIER ::= { hpicfCommon 6 }
hpicfLinkTestNextIndex OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A currently unassigned value of hpicfLinkTestIndex.
The value 0 indicates that no unassigned values are
available.
In order to cause a non-zero value of this object to
be assigned for use as the hpicfLinkTestIndex of a
future link test, it must be successfully modified by
a set operation. When modified by a set operation,
the new value must precisely match the value
presently held by the object. If not, the management
protocol set operation will fail.
Immediately after the completion of a successful set
operation, the agent must modify the value of this
object. The algorithm for modifying the value is
implementation-dependent, and may use a subset of
values within the legal range. However, the agent
must guarantee that the new value is not assigned to
any in-use value of hpicfLinkTestIndex.
A management station creates a new link test using
this algorithm:
- issue a management protocol retrieval operation
to obtain the value of hpicfLinkTestNextIndex;
if the retrieved value is zero, a new link test
cannot be created at this time;
- issue a management protocol set operation for
hpicfLinkTestNextIndex, supplying the same value
as obtained in the previous step;
- if the set operation succeeds, use the supplied
value as the hpicfLinkTestIndex of the new
link test; if the set operation fails, go back
to the first step and obtain a new value for
hpicfLinkTestNextIndex;
- issue a management protocol set operation to
create an instance of the hpicfLinkTestStatus
object setting its value to 'createAndGo' or
'createAndWait' (as specified in the description
of the RowStatus textual convention).
Note that the set of hpicfLinkTestNextIndex and the
instance of hpicfLinkTestStatus may occur in the
same set operation if desired."
::= { hpicfLinktest 1 }
hpicfLinkTestTable OBJECT-TYPE
SYNTAX SEQUENCE OF HpicfLinkTestEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of in-progress link tests."
::= { hpicfLinktest 2 }
hpicfLinkTestEntry OBJECT-TYPE
SYNTAX HpicfLinkTestEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A row in the table, containing information about a
single link test."
INDEX { hpicfLinkTestIndex }
::= { hpicfLinkTestTable 1 }
HpicfLinkTestEntry ::=
SEQUENCE {
hpicfLinkTestIndex Integer32,
hpicfLinkTestType INTEGER,
hpicfLinkTestAddress OCTET STRING,
hpicfLinkTestIfIndex Integer32,
hpicfLinkTestTimeout TimeInterval,
hpicfLinkTestRepetitions Integer32,
hpicfLinkTestAttempts Integer32,
hpicfLinkTestSuccesses Integer32,
hpicfLinkTestMinRespTime Integer32,
hpicfLinkTestMaxRespTime Integer32,
hpicfLinkTestTotalRespTime Integer32,
hpicfLinkTestOwner OwnerString,
hpicfLinkTestStatus RowStatus,
hpicfLinkTestDeleteMode INTEGER
}
hpicfLinkTestIndex OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The value of this object uniquely identifies this
link test."
::= { hpicfLinkTestEntry 1 }
hpicfLinkTestType OBJECT-TYPE
SYNTAX INTEGER {
icmpEcho(1),
ieee8022Test(2),
ipxDiagnostic(3)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The type of test to run."
::= { hpicfLinkTestEntry 2 }
hpicfLinkTestAddress OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(4|6|10))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The destination address used for sending link test
packets, formatted according to the value of the
corresponding instance of hpicfLinkTestType. When
hpicfLinkTestType is equal to 'icmpEcho', this object
will be four octets long, and contain an IP address
in network byte order. When hpicfLinkTestType is
equal to 'ieee8022Test', this object will be six
octets long, and contain an IEEE MAC address in
canonical order. When hpicfLinkTestType is equal to
'ipxDiagnostic', this object will be ten octets long,
and will contain the IPX network number in network
byte order, followed by the IPX node number in
network byte order."
::= { hpicfLinkTestEntry 3 }
hpicfLinkTestIfIndex OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The local interface to send the link test packets
on. The value of this object must correspond to an
ifIndex value for an interface capable of supporting
the requested link test. The value 0 is used to
indicate that the agent should determine the
interface using local routing information."
DEFVAL { 0 }
::= { hpicfLinkTestEntry 4 }
hpicfLinkTestTimeout OBJECT-TYPE
SYNTAX TimeInterval
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The time interval over which a link test response
must be recieved, or the test is counted as failed."
DEFVAL { 100 } -- one second
::= { hpicfLinkTestEntry 5 }
hpicfLinkTestRepetitions OBJECT-TYPE
SYNTAX Integer32 (1..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The total number of times that the agent should
send link test packets to the destination host."
DEFVAL { 1 }
::= { hpicfLinkTestEntry 6 }
hpicfLinkTestAttempts OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times we have sent link test packets
to the destination during the current test. This
object will start at zero when the corresponding
instance of hpicfLinkTestStatus is set to 'active'.
It will increment at the completion of each iteration
of the test until either it reaches the value of
hpicfLinkTestRepetitions, or the corresponding
instance of hpicfLinkTestStatus is set to a value
other than 'active'. Note that it is incremented
at the completion of each iteration, not when the
link test packet is sent, so that the number of
failures can be calculated accurately."
::= { hpicfLinkTestEntry 7 }
hpicfLinkTestSuccesses OBJECT-TYPE
SYNTAX Integer32 (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times that we have received a response
to a link test packet during the current test. This
object will start at zero when the corresponding
instance of hpicfLinkTestStatus is set to 'active'.
It will increment each time the agent receives a
response from the destination of this test. Note
that the number of failed attempts is given by
hpicfLinkTestAttempts - hpicfLinkTestSuccesses."
::= { hpicfLinkTestEntry 8 }
hpicfLinkTestMinRespTime OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The shortest time (in milliseconds) between request
and response for all of the link tests that have been
attempted as part of this test."
::= { hpicfLinkTestEntry 9 }
hpicfLinkTestMaxRespTime OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The longest time (in milliseconds) between request
and response for all of the link tests that have been
attempted as part of this test."
::= { hpicfLinkTestEntry 10 }
hpicfLinkTestTotalRespTime OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The sum of all of the response times (in
milliseconds) for all of the link tests that have
been attempted as part of this test. This value can
be used in conjunction with hpicfLinkTestSuccesses
to calculate the average response time."
::= { hpicfLinkTestEntry 11 }
hpicfLinkTestOwner OBJECT-TYPE
SYNTAX OwnerString
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The entity that configured this test and is
therefore using the resources assigned to it."
::= { hpicfLinkTestEntry 12 }
hpicfLinkTestStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this entry."
::= { hpicfLinkTestEntry 13 }
hpicfLinkTestDeleteMode OBJECT-TYPE
SYNTAX INTEGER {
keepWhenDone(1),
destroyWhenDone(2)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"When the value of this object is 'keepWhenDone',
the associated instance of the hpicfLinkTestStatus
object will be changed to 'notInService' upon
completion of the test. It will then be timed out
by the agent after 5 minutes in the 'notInService'
state.
When the value of this object is 'destroyWhenDone',
the assocated instance of the hpicfLinkTestStatus
object will be changed to 'destroy' upon completion
of the test. This will remove the row from the
table immediately after the test completes."
DEFVAL { keepWhenDone }
::= { hpicfLinkTestEntry 14 }
-- Conformance information
hpicfLinkTestConformance
OBJECT IDENTIFIER ::= { hpicfLinkTestMib 1 }
hpicfLinkTestCompliances
OBJECT IDENTIFIER ::= { hpicfLinkTestConformance 1 }
hpicfLinkTestGroups
OBJECT IDENTIFIER ::= { hpicfLinkTestConformance 2 }
-- Compliance statements
hpicfLinkTestCompliance MODULE-COMPLIANCE
STATUS deprecated
DESCRIPTION
"The compliance statement for ICF devices that
provide a connectivity test facility."
MODULE
MANDATORY-GROUPS { hpicfLinkTestGroup }
::= { hpicfLinkTestCompliances 1 }
hpicfLinkTestCompliance2 MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for ICF devices that
provide a connectivity test facility."
MODULE
MANDATORY-GROUPS { hpicfLinkTestGroup2 }
::= { hpicfLinkTestCompliances 2 }
-- Units of conformance
hpicfLinkTestGroup OBJECT-GROUP
OBJECTS { hpicfLinkTestNextIndex,
hpicfLinkTestType,
hpicfLinkTestAddress,
hpicfLinkTestIfIndex,
hpicfLinkTestTimeout,
hpicfLinkTestRepetitions,
hpicfLinkTestAttempts,
hpicfLinkTestSuccesses,
hpicfLinkTestMinRespTime,
hpicfLinkTestMaxRespTime,
hpicfLinkTestTotalRespTime,
hpicfLinkTestOwner,
hpicfLinkTestStatus
}
STATUS deprecated
DESCRIPTION
"A collection of objects for initiating and
monitoring network connectivity tests on ICF
devices."
::= { hpicfLinkTestGroups 1 }
hpicfLinkTestGroup2 OBJECT-GROUP
OBJECTS { hpicfLinkTestNextIndex,
hpicfLinkTestType,
hpicfLinkTestAddress,
hpicfLinkTestIfIndex,
hpicfLinkTestTimeout,
hpicfLinkTestRepetitions,
hpicfLinkTestAttempts,
hpicfLinkTestSuccesses,
hpicfLinkTestMinRespTime,
hpicfLinkTestMaxRespTime,
hpicfLinkTestTotalRespTime,
hpicfLinkTestOwner,
hpicfLinkTestStatus,
hpicfLinkTestDeleteMode
}
STATUS current
DESCRIPTION
"A collection of objects for initiating and
monitoring network connectivity tests on ICF
devices."
::= { hpicfLinkTestGroups 2 }
END