Cisco MCS-7825-H3-IPC1 Service Manual page 935

Chapter 8 Industry-Standard Management Information Base
Once ownership is obtained, any test parameters can be setup, and then the test is initiated by setting
ifTestType. On completion of the test, the agent sets ifTestStatus to 'notInUse'. Once this occurs,
the manager can retrieve the results. In the (rare) event that the invocation of tests by two network
managers were to overlap, then there would be a possibility that the first test's results might be
overwritten by the second test's results prior to the first results being read. This unlikely
circumstance can be detected by a network manager retrieving ifTestId at the same time as retrieving
the test results, and ensuring that the results are for the desired request.
If ifTestType is not set within an abnormally long period of time after ownership is obtained, the
agent should time-out the manager, and reset the value of the ifTestStatus object back to 'notInUse'.
It is suggested that this time-out period be 5 minutes.
In general, a management station must not retransmit a request to invoke a test for which it does not
receive a response; instead, it properly inspects an agent's MIB to determine if the invocation was
successful. Only if the invocation was unsuccessful, is the invocation request retransmitted.
Some tests may require the interface to be taken off-line in order to execute them, or may even
require the agent to reboot after completion of the test. In these circumstances, communication with
the management station invoking the test may be lost until after completion of the test. An agent is
not required to support such tests. However, if such tests are supported, then the agent should make
every effort to transmit a response to the request which invoked the test prior to losing
communication. When the agent is restored to normal service, the results of the test are properly
made available in the appropriate objects.
Note that this requires that the ifIndex value assigned to an interface must be unchanged even if the
test causes a reboot. An agent must reject any test for which it cannot, perhaps due to resource
constraints, make available at least the minimum amount of information after that test completes.
::= { ifMIBObjects 3 }
ifTestEntry OBJECT-TYPE
SYNTAX IfTestEntry
MAX-ACCESS not-accessible
STATUS deprecated
DESCRIPTION
An entry containing objects for invoking tests on an interface.
AUGMENTS { ifEntry }
::= { ifTestTable 1 }
IfTestEntry ::=
SEQUENCE { ifTestId TestAndIncr, ifTestStatus INTEGER, ifTestType AutonomousType,
ifTestResult INTEGER, ifTestCode OBJECT IDENTIFIER, ifTestOwnerOwnerString }
ifTestId OBJECT-TYPE
SYNTAX TestAndIncr
MAX-ACCESS read-write
STATUS deprecated
DESCRIPTION
This object identifies the current invocation of the interface's test.
::= { ifTestEntry 1 }
ifTestStatus OBJECT-TYPE
OL-22523-01
Cisco Unified Communications Manager Managed Services Guide
IF-MIB
8-131