upsTestSpinLock
UPS-MIB ·
.1.3.6.1.2.1.33.1.7.2
Object
A spin lock on the test subsystem. The spinlock is
used as follows.
Before starting a test, a manager-station should make
sure that a test is not in progress as follows:
try_again:
get (upsTestSpinLock)
while (upsTestResultsSummary == inProgress) {
/* loop while a test is running for another
manager */
short delay
get (upsTestSpinLock)
}
lock_value = upsTestSpinLock
/* no test in progress, start the test */
set (upsTestSpinLock = lock_value, upsTestId =
requested_test)
if (error_index == 1) { /* (upsTestSpinLock
failed) */
/* if problem is not access control, then
some other manager slipped in ahead of us
*/
goto try_again
}
if (error_index == 2) { /* (upsTestId) */
/* cannot perform the test */
give up
}
/* test started ok */
/* wait for test completion by polling
upsTestResultsSummary */
get (upsTestSpinLock, upsTestResultsSummary,
upsTestResultsDetail)
while (upsTestResultsSummary == inProgress) {
short delay
get (upsTestSpinLock, upsTestResultsSummary,
upsTestResultsDetail)
}
/* when test completes, retrieve any additional
test results */
/* if upsTestSpinLock == lock_value + 1, then
these are our test */
/* results (as opposed to another manager's */
The initial value of upsTestSpinLock at agent
initialization shall
be 1.
Values & Constraints
Type Constraints
range: 0..2147483647
Related Objects
Sibling Objects
| Object | Type | Syntax | OID |
|---|---|---|---|
| upsTestId The test is named by an OBJECT IDENTIFIER which
allows a standard mechanism for the initiation of
tests, including the well known tests identified in
this document as well as thos… | scalar | ObjectIdentifier | .1.3.6.1.2.1.33.1.7.1 |
| upsTestResultsSummary The results of the current or last UPS diagnostics
test performed. The values for donePass(1),
doneWarning(2), and doneError(3) indicate that the
test completed either successful… | scalar | Enumeration | .1.3.6.1.2.1.33.1.7.3 |
| upsTestResultsDetail Additional information about upsTestResultsSummary.
If no additional information available, a zero length
string is returned. | scalar | OctetString | .1.3.6.1.2.1.33.1.7.4 |
| upsTestStartTime The value of sysUpTime at the time the test in
progress was initiated, or, if no test is in progress,
the time the previous test was initiated. If the
value of upsTestResultsSumm… | scalar | SNMPv2-TCTimeStamp | .1.3.6.1.2.1.33.1.7.5 |
| upsTestElapsedTime The amount of time, in TimeTicks, since the test in
progress was initiated, or, if no test is in progress,
the previous test took to complete. If the value of
upsTestResultsSumma… | scalar | SNMPv2-TCTimeInterval | .1.3.6.1.2.1.33.1.7.6 |
| upsWellKnownTests | node | - | .1.3.6.1.2.1.33.1.7.7 |