400 lines
16 KiB
Plaintext
400 lines
16 KiB
Plaintext
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
|
|
|