mibs/ibm/IBMHPRROUTETEST-MIB
IBMHPRROUTETEST-MIB DEFINITIONS ::= BEGIN
IMPORTS
enterprises, Gauge
FROM RFC1155-SMI
DisplayString
FROM RFC1213-MIB
OBJECT-TYPE
FROM RFC-1212;
-- IMPORTS
-- MODULE-IDENTITY, Unsigned32, OBJECT-TYPE, enterprises
-- FROM SNMPv2-SMI
-- OBJECT-GROUP, MODULE-COMPLIANCE
-- FROM SNMPv2-CONF
-- DisplayString
-- FROM SNMPv2-TC;
-- ibmHprRouteTest MODULE-IDENTITY
-- LAST-UPDATED "9701282100Z"
-- ORGANIZATION "IBM"
-- CONTACT-INFO "Bob Moore (remoore @ ralvm6)
-- IBM Corporation
-- 800 Park Offices Drive
-- RHJA/664
-- P.O. Box 12195
-- Research Triangle Park, NC 27709, USA
-- Tel: 1 919 254 4436
-- E-mail: remoore@ralvm6.vnet.ibm.com"
-- DESCRIPTION
-- "This MIB module represents the HPR route test group from the
-- original IBM version of the HPR MIB, updated to SNMPv2 SMI. It
-- is set up to use as its anchor point the same OID that
-- identified the group in the IBM-HPR-MIB, so that existing
-- manager applications will not need to change."
-- ::= { hpr 4 }
-- The following OID assignments result in the same OIDs for the
-- objects in the port DLC trace group as those in the IBM-6611-APPN-MIB.
ibm OBJECT IDENTIFIER ::= { enterprises 2 }
ibmArchitecture OBJECT IDENTIFIER ::= { ibm 5 }
hpr OBJECT IDENTIFIER ::= { ibmArchitecture 10 }
ibmHprRouteTest OBJECT IDENTIFIER ::= { hpr 4 }
-- **********************************************************************
-- HPR Route Test
-- ----------------------------------------------------------------------
-- This group applies to HPR tower nodes which support the
-- HPR Route Test Function.
-- **********************************************************************
ibmHprRtGlobe OBJECT IDENTIFIER ::= { ibmHprRouteTest 1 }
-- **********************************************************************
-- HPR Route Test Global Objects
-- ----------------------------------------------------------------------
-- The following simple objects allow a HPR route test to be
-- triggered by specifying an:
-- 1. existing rtp connection id (nceid and tcid), or
-- 2. destination lu name and a mode name
--
-- The results of the route test will be placed in the HPR Route
-- Test General and Detail Result tables.
-- **********************************************************************
ibmHprRtGlobeConnTrigger OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0 | 10..17))
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This object is used to trigger an HPR route test of the
physical path of an existing RTP Connection. The format of
this object is: nceid-length.nceid.tcid, where
- nceid-length: 1 octet. valid values are 1-8.
- nceid: 1-8 octets.
- tcid: 8 octets."
::= { ibmHprRtGlobe 1}
ibmHprRtGlobeNameTrigger OBJECT-TYPE
SYNTAX DisplayString (SIZE (0 | 5..26))
ACCESS read-write
STATUS mandatory
DESCRIPTION
"This object is used to trigger an HPR route test of the
physical path of an existing or non-existing RTP Connection.
The names will be used to generate a HPR Route which may or may
not match an existing RTP Connection; but must be reside on a
current or potential RTP Connection endpoint node. The format
of this object is: netid.lu-name.mode-name, where
- netid: 1-8 octets.
- period: 1 octet.
- lu-name: 1-8 octets.
- period: 1 octet.
- mode-name: 1-8 octets."
::= { ibmHprRtGlobe 2}
ibmHprRtGenResults OBJECT IDENTIFIER ::= { ibmHprRouteTest 2 }
-- **********************************************************************
-- HPR Route Test General Results
-- ----------------------------------------------------------------------
-- The each entry in the following table provides the general results
-- from a specific HPR route test.
-- **********************************************************************
ibmHprRtGenTable OBJECT-TYPE
SYNTAX SEQUENCE OF IbmHprRtGenEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
"The HPR Route Test General Results Table."
::= { ibmHprRtGenResults 1}
ibmHprRtGenEntry OBJECT-TYPE
SYNTAX IbmHprRtGenEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
"The HPR Route Test Id is used to index to this table. This Id
is an integer that begins at 1 and is incremented with each
route test executed on the agent node."
INDEX { ibmHprRtGenTestId }
::= { ibmHprRtGenTable 1}
IbmHprRtGenEntry ::= SEQUENCE {
ibmHprRtGenTestId Gauge, -- route test id
ibmHprRtGenTestType INTEGER, -- route test type
ibmHprRtGenConnTrigger OCTET STRING, -- connection trigger
ibmHprRtGenNameTrigger DisplayString, -- name trigger
ibmHprRtGenResult INTEGER, -- result
ibmHprRtGenSenseCode OCTET STRING, -- sense code
ibmHprRtGenCosName DisplayString, -- cos name
ibmHprRtGenRscv OCTET STRING -- rscv
}
ibmHprRtGenTestId OBJECT-TYPE
SYNTAX Gauge
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The route test id. This Id is an integer that begins at 1 and
is incremented with each route test execution."
::= { ibmHprRtGenEntry 1}
ibmHprRtGenTestType OBJECT-TYPE
SYNTAX INTEGER {
connTrigger(1),
nameTrigger(2)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The route test type. This indicates whether the route test
was triggered by setting the:
1. global connection trigger, or
2. global name trigger."
::= { ibmHprRtGenEntry 2}
ibmHprRtGenConnTrigger OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0 | 10..17))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This object will be valid if the route test was triggered by
setting the global connection trigger. If the route test was
triggered by setting the global name trigger, this object will
return the zero-length string. When it is not null, the format
of this object is: nceid-length.nceid.tcid, where
- nceid-length: 1 octet. valid values are 1-8.
- nceid: 1-8 octets.
- tcid: 8 octets."
::= { ibmHprRtGenEntry 3}
ibmHprRtGenNameTrigger OBJECT-TYPE
SYNTAX DisplayString (SIZE (0 | 5..26))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"This object will be valid if the route test was triggered by
setting the global name trigger. If the route test was
triggered by setting the global connection trigger, this object
will return the zero-length string. When it is not null, the
format of this object is: netid.lu-name.mode-name, where
- netid: 1-8 octets.
- period: 1 octet.
- lu-name: 1-8 octets.
- period: 1 octet.
- mode-name: 1-8 octets."
::= { ibmHprRtGenEntry 4}
ibmHprRtGenResult OBJECT-TYPE
SYNTAX INTEGER {
successful(1),
inProgess(2),
noResponse(3),
nceidInvalid(4),
tcidInvalid(5),
luInvalid(6),
modeInvalid(7),
noHprRoute(8)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The route test result. This indicates whether the route test
was:
1. successfully executed, or
2. in progress and has not completed yet, or
3. no response was received from one or more nodes, or
4. the nce id used to trigger the route test was invalid, or
5. the tcid used to trigger the route test was invalid, or
6. the lu name used to trigger the route test was invalid, or
7. the mode name used to trigger the route test was invalid
for the lu name specified, or
8. a contiguous hpr route from this node to the target lu
does not exist and cannot be created."
::= { ibmHprRtGenEntry 5}
ibmHprRtGenSenseCode OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The SNA sense data that corresponds to the route test result."
::= { ibmHprRtGenEntry 6}
ibmHprRtGenCosName OBJECT-TYPE
SYNTAX DisplayString (SIZE (1..8))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The class of service name used for this route test."
::= { ibmHprRtGenEntry 7}
ibmHprRtGenRscv OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..255))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The route selection control vector used for this route test."
::= { ibmHprRtGenEntry 8}
ibmHprRtDetResults OBJECT IDENTIFIER ::= { ibmHprRouteTest 3 }
-- **********************************************************************
-- HPR Route Test Detailed Results
-- ----------------------------------------------------------------------
-- Each entry in the following table provides detailed results from a
-- a specific HPR route test.
-- **********************************************************************
ibmHprRtDetTable OBJECT-TYPE
SYNTAX SEQUENCE OF IbmHprRtDetEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
"The HPR Route Test Detailed Results Table."
::= { ibmHprRtDetResults 1}
ibmHprRtDetEntry OBJECT-TYPE
SYNTAX IbmHprRtDetEntry
ACCESS not-accessible
STATUS mandatory
DESCRIPTION
"The HPR Route Test Id and HPR Route Sub Test Id are used to
index this table. The Test Id is an integer that begins at 1
and is incremented with each route test execution. The Sub
Test Id is an integer that begins at 1 and is incremented with
each node along the path being tested."
INDEX { ibmHprRtDetTestId,
ibmHprRtDetSubTestId }
::= { ibmHprRtDetTable 1}
IbmHprRtDetEntry ::= SEQUENCE {
ibmHprRtDetTestId Gauge, -- route test id
ibmHprRtDetSubTestId INTEGER, -- node test id
ibmHprRtDetDestNode DisplayString, -- destination node
ibmHprRtDetPriorNode DisplayString, -- prior node
ibmHprRtDetLastTgNumber INTEGER, -- last tg number
ibmHprRtDetRtripTime Gauge, -- round trip time
ibmHprRtDetResult INTEGER -- result
}
ibmHprRtDetTestId OBJECT-TYPE
SYNTAX Gauge
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The route test id. This Id is an integer that begins at 1 and
is incremented with each route test execution. If this object
has the same value as the ibmHprRtGenTestId, then the two
objects apply to the same route test."
::= { ibmHprRtDetEntry 1}
ibmHprRtDetSubTestId OBJECT-TYPE
SYNTAX INTEGER (1..255)
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The sub test id. This Id is an integer that begins at 1 and
is incremented with each node along the path being tested. The
last entry of the test will be designated by a value 255."
::= { ibmHprRtDetEntry 2}
ibmHprRtDetDestNode OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..17))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The destination node name for this portion of the route test."
::= { ibmHprRtDetEntry 3}
ibmHprRtDetPriorNode OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..17))
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The name of the node which is prior to the destination node
for this portion of the route test."
::= { ibmHprRtDetEntry 4}
ibmHprRtDetLastTgNumber OBJECT-TYPE
SYNTAX INTEGER (0..255)
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The last TG number for this portion of the route test."
::= { ibmHprRtDetEntry 5}
ibmHprRtDetRtripTime OBJECT-TYPE
SYNTAX Gauge
-- UNITS "1/1000ths of a second"
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The round trip time for this portion of the route test. It is
the total time from when the test frame was sent by this node
to the time when the test frame was received back at this
node."
::= { ibmHprRtDetEntry 6}
ibmHprRtDetResult OBJECT-TYPE
SYNTAX INTEGER {
successful(1),
noResponse(2)
}
ACCESS read-only
STATUS mandatory
DESCRIPTION
"The result of this portion of the route test. It indicates
whether this portion of the route test was:
1. successfully executed, or
2. no response was received."
::= { ibmHprRtDetEntry 7}
-- ******************************************************************
-- IBM HPR route test conformance
-- ******************************************************************
-- ibmHprRtCompliances OBJECT IDENTIFIER ::= { ibmHprRouteTest 4 }
-- ibmHprRtConfGroups OBJECT IDENTIFIER ::= { ibmHprRouteTest 5 }
-- ibmHprRtCompliance MODULE-COMPLIANCE
-- STATUS mandatory
-- DESCRIPTION
-- "The compliance statement for the SNMPv2 entities that
-- implement the IBM HPR Route Test function."
-- MODULE
-- MANDATORY-GROUPS
-- { ibmHprRtObjectsConfGroup }
-- ::= { ibmHprRtCompliances 1 }
-- ibmHprRtObjectsConfGroup OBJECT-GROUP
-- OBJECTS {
-- ibmHprRtGlobeConnTrigger,
-- ibmHprRtGlobeNameTrigger,
-- ibmHprRtGenTestType,
-- ibmHprRtGenConnTrigger,
-- ibmHprRtGenNameTrigger,
-- ibmHprRtGenResult,
-- ibmHprRtGenSenseCode,
-- ibmHprRtGenCosName,
-- ibmHprRtGenRscv,
-- ibmHprRtDetDestNode,
-- ibmHprRtDetPriorNode,
-- ibmHprRtDetLastTgNumber,
-- ibmHprRtDetRtripTime,
-- ibmHprRtDetResult
-- }
-- STATUS mandatory
-- DESCRIPTION
-- "All of the accessible objects in this module."
-- ::= { ibmHprRtConfGroups 1 }
END