UPS-MIB DEFINITIONS ::= BEGIN

IMPORTS

    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,

    OBJECT-IDENTITY, Counter32, Gauge32, Integer32, mib-2

        FROM SNMPv2-SMI

    DisplayString, TimeStamp, TimeInterval, TestAndIncr,

      AutonomousType, TEXTUAL-CONVENTION

        FROM SNMPv2-TC

    MODULE-COMPLIANCE, OBJECT-GROUP

        FROM SNMPv2-CONF;

upsMIB MODULE-IDENTITY

    LAST-UPDATED "9402230000Z"

    ORGANIZATION "IETF UPS MIB Working Group"

    CONTACT-INFO

           "        Jeffrey D. Case

             Postal: SNMP Research, Incorporated

                     3001 Kimberlin Heights Road

                     Knoxville, TN  37920

                     US

                Tel: +1 615 573 1434

                Fax: +1 615 573 9197

             E-mail: case@snmp.com"

    DESCRIPTION

            "The MIB module to describe Uninterruptible Power

            Supplies."

    ::= { mib-2 33 }

PositiveInteger ::= TEXTUAL-CONVENTION

    DISPLAY-HINT "d"

    STATUS       current

    DESCRIPTION

            "This data type is a non-zero and non-negative value."

    SYNTAX       INTEGER (1..2147483647)

NonNegativeInteger ::= TEXTUAL-CONVENTION

    DISPLAY-HINT "d"

    STATUS       current

    DESCRIPTION

            "This data type is a non-negative value."

    SYNTAX       INTEGER (0..2147483647)

upsObjects            OBJECT IDENTIFIER ::= { upsMIB 1 }

--

-- The Device Identification group.

--      All objects in this group except for upsIdentName and

--      upsIdentAttachedDevices are set at device initialization

--      and remain static.

--

upsIdent              OBJECT IDENTIFIER ::= { upsObjects 1 }

upsIdentManufacturer OBJECT-TYPE

    SYNTAX     DisplayString (SIZE (0..31))

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The name of the UPS manufacturer."

    ::= { upsIdent 1 }

upsIdentModel OBJECT-TYPE

    SYNTAX     DisplayString (SIZE (0..63))

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The UPS Model designation."

    ::= { upsIdent 2 }

upsIdentUPSSoftwareVersion OBJECT-TYPE

    SYNTAX     DisplayString (SIZE (0..63))

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The UPS firmware/software version(s).  This variable

            may or may not have the same value as

            upsIdentAgentSoftwareVersion in some implementations."

    ::= { upsIdent 3 }

upsIdentAgentSoftwareVersion OBJECT-TYPE

    SYNTAX     DisplayString (SIZE (0..63))

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The UPS agent software version.  This variable may or

            may not have the same value as

            upsIdentUPSSoftwareVersion in some implementations."

    ::= { upsIdent 4 }

upsIdentName OBJECT-TYPE

    SYNTAX     DisplayString (SIZE(0..63))

    MAX-ACCESS read-write

    STATUS     current

    DESCRIPTION

            "A string identifying the UPS.  This object should be

            set by the administrator."

    ::= { upsIdent 5 }

upsIdentAttachedDevices OBJECT-TYPE

    SYNTAX     DisplayString (SIZE(0..63))

    MAX-ACCESS read-write

    STATUS     current

    DESCRIPTION

            "A string identifying the devices attached to the

            output(s) of the UPS.  This object should be set by

            the administrator."

    ::= { upsIdent 6 }

--

-- Battery Group

--

upsBattery            OBJECT IDENTIFIER ::= { upsObjects 2 }

upsBatteryStatus OBJECT-TYPE

    SYNTAX     INTEGER {

        unknown(1),

        batteryNormal(2),

        batteryLow(3),

        batteryDepleted(4)

    }

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The indication of the capacity remaining in the UPS

            system's batteries.   A value of batteryNormal

            indicates that the remaining run-time is greater than

            upsConfigLowBattTime.  A value of batteryLow indicates

            that the remaining battery run-time is less than or

            equal to upsConfigLowBattTime.  A value of

            batteryDepleted indicates that the UPS will be unable

            to sustain the present load when and if the utility

            power is lost (including the possibility that the

            utility power is currently absent and the UPS is

            unable to sustain the output)."

    ::= { upsBattery 1 }

upsSecondsOnBattery OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "seconds"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "If the unit is on battery power, the elapsed time

            since the UPS last switched to battery power, or the

            time since the network management subsystem was last

            restarted, whichever is less.  Zero shall be returned

            if the unit is not on battery power."

    ::= { upsBattery 2 }

upsEstimatedMinutesRemaining OBJECT-TYPE

    SYNTAX     PositiveInteger

    UNITS      "minutes"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "An estimate of the time to battery charge depletion

            under the present load conditions if the utility power

            is off and remains off, or if it were to be lost and

            remain off."

    ::= { upsBattery 3 }

upsEstimatedChargeRemaining OBJECT-TYPE

    SYNTAX     INTEGER (0..100)

    UNITS      "percent"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "An estimate of the battery charge remaining expressed

            as a percent of full charge."

    ::= { upsBattery 4 }

upsBatteryVoltage OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 Volt DC"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The magnitude of the present battery voltage."

    ::= { upsBattery 5 }

upsBatteryCurrent OBJECT-TYPE

    SYNTAX     Integer32

    UNITS      "0.1 Amp DC"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present battery current."

    ::= { upsBattery 6 }

upsBatteryTemperature OBJECT-TYPE

    SYNTAX     Integer32

    UNITS      "degrees Centigrade"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The ambient temperature at or near the UPS Battery

            casing."

    ::= { upsBattery 7 }

--

-- Input Group

--

upsInput              OBJECT IDENTIFIER ::= { upsObjects 3 }

upsInputLineBads OBJECT-TYPE

    SYNTAX     Counter32

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "A count of the number of times the input entered an

            out-of-tolerance condition as defined by the

            manufacturer.  This count is incremented by one each

            time the input transitions from zero out-of-tolerance

            lines to one or more input lines out-of-tolerance."

    ::= { upsInput 1 }

upsInputNumLines OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The number of input lines utilized in this device.

            This variable indicates the number of rows in the

            input table."

    ::= { upsInput 2 }

upsInputTable OBJECT-TYPE

    SYNTAX     SEQUENCE OF UpsInputEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "A list of input table entries.  The number of entries

            is given by the value of upsInputNumLines."

    ::= { upsInput 3 }

upsInputEntry OBJECT-TYPE

    SYNTAX     UpsInputEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "An entry containing information applicable to a

            particular input line."

    INDEX { upsInputLineIndex }

    ::= { upsInputTable 1 }

UpsInputEntry ::= SEQUENCE {

    upsInputLineIndex   PositiveInteger,

    upsInputFrequency   NonNegativeInteger,

    upsInputVoltage     NonNegativeInteger,

    upsInputCurrent     NonNegativeInteger,

    upsInputTruePower   NonNegativeInteger

}

upsInputLineIndex OBJECT-TYPE

    SYNTAX     PositiveInteger

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "The input line identifier."

    ::= { upsInputEntry 1 }

upsInputFrequency OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 Hertz"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present input frequency."

    ::= { upsInputEntry 2 }

upsInputVoltage OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "RMS Volts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The magnitude of the present input voltage."

    ::= { upsInputEntry 3 }

upsInputCurrent OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 RMS Amp"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The magnitude of the present input current."

    ::= { upsInputEntry 4 }

upsInputTruePower OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "Watts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The magnitude of the present input true power."

    ::= { upsInputEntry 5 }

--

-- The Output group.

--

upsOutput             OBJECT IDENTIFIER ::= { upsObjects 4 }

upsOutputSource OBJECT-TYPE

    SYNTAX     INTEGER {

        other(1),

        none(2),

        normal(3),

        bypass(4),

        battery(5),

        booster(6),

        reducer(7)

    }

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present source of output power.  The enumeration

            none(2) indicates that there is no source of output

            power (and therefore no output power), for example,

            the system has opened the output breaker."

    ::= { upsOutput 1 }

upsOutputFrequency OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 Hertz"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present output frequency."

    ::= { upsOutput 2 }

upsOutputNumLines OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The number of output lines utilized in this device.

            This variable indicates the number of rows in the

            output table."

    ::= { upsOutput 3 }

upsOutputTable OBJECT-TYPE

    SYNTAX     SEQUENCE OF UpsOutputEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "A list of output table entries.  The number of

            entries is given by the value of upsOutputNumLines."

    ::= { upsOutput 4 }

upsOutputEntry OBJECT-TYPE

    SYNTAX     UpsOutputEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "An entry containing information applicable to a

            particular output line."

    INDEX { upsOutputLineIndex }

    ::= { upsOutputTable 1 }

UpsOutputEntry ::= SEQUENCE {

    upsOutputLineIndex   PositiveInteger,

    upsOutputVoltage     NonNegativeInteger,

    upsOutputCurrent     NonNegativeInteger,

    upsOutputPower       NonNegativeInteger,

    upsOutputPercentLoad INTEGER

}

upsOutputLineIndex OBJECT-TYPE

    SYNTAX     PositiveInteger

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "The output line identifier."

    ::= { upsOutputEntry 1 }

upsOutputVoltage OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "RMS Volts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present output voltage."

    ::= { upsOutputEntry 2 }

upsOutputCurrent OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 RMS Amp"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present output current."

    ::= { upsOutputEntry 3 }

upsOutputPower OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "Watts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present output true power."

    ::= { upsOutputEntry 4 }

upsOutputPercentLoad OBJECT-TYPE

    SYNTAX     INTEGER (0..200)

    UNITS      "percent"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The percentage of the UPS power capacity presently

            being used on this output line, i.e., the greater of

            the percent load of true power capacity and the

            percent load of VA."

    ::= { upsOutputEntry 5 }

--

-- The Bypass group.

--

upsBypass             OBJECT IDENTIFIER ::= { upsObjects 5 }

upsBypassFrequency OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 Hertz"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present bypass frequency."

    ::= { upsBypass 1 }

upsBypassNumLines OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The number of bypass lines utilized in this device.

            This entry indicates the number of rows in the bypass

            table."

    ::= { upsBypass 2 }

upsBypassTable OBJECT-TYPE

    SYNTAX     SEQUENCE OF UpsBypassEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "A list of bypass table entries.  The number of

            entries is given by the value of upsBypassNumLines."

    ::= { upsBypass 3 }

upsBypassEntry OBJECT-TYPE

    SYNTAX     UpsBypassEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "An entry containing information applicable to a

            particular bypass input."

    INDEX { upsBypassLineIndex }

    ::= { upsBypassTable 1 }

UpsBypassEntry ::= SEQUENCE {

    upsBypassLineIndex  PositiveInteger,

    upsBypassVoltage    NonNegativeInteger,

    upsBypassCurrent    NonNegativeInteger,

    upsBypassPower      NonNegativeInteger

}

upsBypassLineIndex OBJECT-TYPE

    SYNTAX     PositiveInteger

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "The bypass line identifier."

    ::= { upsBypassEntry 1 }

upsBypassVoltage OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "RMS Volts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present bypass voltage."

    ::= { upsBypassEntry 2 }

upsBypassCurrent OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "0.1 RMS Amp"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present bypass current."

    ::= { upsBypassEntry 3 }

upsBypassPower OBJECT-TYPE

    SYNTAX     NonNegativeInteger

    UNITS      "Watts"

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present true power conveyed by the bypass."

    ::= { upsBypassEntry 4 }

--

-- The Alarm group.

--

upsAlarm              OBJECT IDENTIFIER ::= { upsObjects 6 }

upsAlarmsPresent OBJECT-TYPE

    SYNTAX     Gauge32

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The present number of active alarm conditions."

    ::= { upsAlarm 1 }

upsAlarmTable OBJECT-TYPE

    SYNTAX     SEQUENCE OF UpsAlarmEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "A list of alarm table entries.  The table contains

            zero, one, or many rows at any moment, depending upon

            the number of alarm conditions in effect.  The table

            is initially empty at agent startup.  The agent

            creates a row in the table each time a condition is

            detected and deletes that row when that condition no

            longer pertains.  The agent creates the first row with

            upsAlarmId equal to 1, and increments the value of

            upsAlarmId each time a new row is created, wrapping to

            the first free value greater than or equal to 1 when

            the maximum value of upsAlarmId would otherwise be

            exceeded.  Consequently, after multiple operations,

            the table may become sparse, e.g., containing entries

            for rows 95, 100, 101, and 203 and the entries should

            not be assumed to be in chronological order because

            upsAlarmId might have wrapped.

            Alarms are named by an AutonomousType (OBJECT

            IDENTIFIER), upsAlarmDescr, to allow a single table to

            reflect well known alarms plus alarms defined by a

            particular implementation, i.e., as documented in the

            private enterprise MIB definition for the device.  No

            two rows will have the same value of upsAlarmDescr,

            since alarms define conditions.  In order to meet this

            requirement, care should be taken in the definition of

            alarm conditions to insure that a system cannot enter

            the same condition multiple times simultaneously.

            The number of rows in the table at any given time is

            reflected by the value of upsAlarmsPresent."

    ::= { upsAlarm 2 }

upsAlarmEntry OBJECT-TYPE

    SYNTAX     UpsAlarmEntry

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "An entry containing information applicable to a

            particular alarm."

    INDEX { upsAlarmId }

    ::= { upsAlarmTable 1 }

UpsAlarmEntry ::= SEQUENCE {

    upsAlarmId          PositiveInteger,

    upsAlarmDescr       AutonomousType,

    upsAlarmTime        TimeStamp

}

upsAlarmId OBJECT-TYPE

    SYNTAX     PositiveInteger

    MAX-ACCESS not-accessible

    STATUS     current

    DESCRIPTION

            "A unique identifier for an alarm condition.  This

            value must remain constant."

    ::= { upsAlarmEntry 1 }

upsAlarmDescr OBJECT-TYPE

    SYNTAX     AutonomousType

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "A reference to an alarm description object.  The

            object referenced should not be accessible, but rather

            be used to provide a unique description of the alarm

            condition."

    ::= { upsAlarmEntry 2 }

upsAlarmTime OBJECT-TYPE

    SYNTAX     TimeStamp

    MAX-ACCESS read-only

    STATUS     current

    DESCRIPTION

            "The value of sysUpTime when the alarm condition was

            detected.  If the alarm condition was detected at the

            time of agent startup and presumably existed before

            agent startup, the value of upsAlarmTime shall equal

            0."

    ::= { upsAlarmEntry 3 }

--

-- Well known alarm conditions.

--

upsWellKnownAlarms    OBJECT IDENTIFIER ::= { upsAlarm 3 }

upsAlarmBatteryBad OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "One or more batteries have been determined to require

            replacement."

    ::= { upsWellKnownAlarms  1 }

upsAlarmOnBattery OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS is drawing power from the batteries."

    ::= { upsWellKnownAlarms  2 }

upsAlarmLowBattery OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The remaining battery run-time is less than or equal

            to upsConfigLowBattTime."

    ::= { upsWellKnownAlarms  3 }

upsAlarmDepletedBattery OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS will be unable to sustain the present load

            when and if the utility power is lost."

    ::= { upsWellKnownAlarms  4 }

upsAlarmTempBad OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "A temperature is out of tolerance."

    ::= { upsWellKnownAlarms  5 }

upsAlarmInputBad OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "An input condition is out of tolerance."

    ::= { upsWellKnownAlarms  6 }

upsAlarmOutputBad OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "An output condition (other than OutputOverload) is

            out of tolerance."

    ::= { upsWellKnownAlarms  7 }

upsAlarmOutputOverload OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The output load exceeds the UPS output capacity."

    ::= { upsWellKnownAlarms  8 }

upsAlarmOnBypass OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The Bypass is presently engaged on the UPS."

    ::= { upsWellKnownAlarms  9 }

upsAlarmBypassBad OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The Bypass is out of tolerance."

    ::= { upsWellKnownAlarms 10 }

upsAlarmOutputOffAsRequested OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS has shutdown as requested, i.e., the output

            is off."

    ::= { upsWellKnownAlarms 11 }

upsAlarmUpsOffAsRequested OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The entire UPS has shutdown as commanded."

    ::= { upsWellKnownAlarms 12 }

upsAlarmChargerFailed OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "An uncorrected problem has been detected within the

            UPS charger subsystem."

    ::= { upsWellKnownAlarms 13 }

upsAlarmUpsOutputOff OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The output of the UPS is in the off state."

    ::= { upsWellKnownAlarms 14 }

upsAlarmUpsSystemOff OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS system is in the off state."

    ::= { upsWellKnownAlarms 15 }

upsAlarmFanFailure OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The failure of one or more fans in the UPS has been

            detected."

    ::= { upsWellKnownAlarms 16 }

upsAlarmFuseFailure OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The failure of one or more fuses has been detected."

    ::= { upsWellKnownAlarms 17 }

upsAlarmGeneralFault OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "A general fault in the UPS has been detected."

    ::= { upsWellKnownAlarms 18 }

upsAlarmDiagnosticTestFailed OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The result of the last diagnostic test indicates a

            failure."

    ::= { upsWellKnownAlarms 19 }

upsAlarmCommunicationsLost OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "A problem has been encountered in the communications

            between the agent and the UPS."

    ::= { upsWellKnownAlarms 20 }

upsAlarmAwaitingPower OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS output is off and the UPS is awaiting the

            return of input power."

    ::= { upsWellKnownAlarms 21 }

upsAlarmShutdownPending OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "A upsShutdownAfterDelay countdown is underway."

    ::= { upsWellKnownAlarms 22 }

upsAlarmShutdownImminent OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "The UPS will turn off power to the load in less than

            5 seconds; this may be either a timed shutdown or a

            low battery shutdown."

    ::= { upsWellKnownAlarms 23 }

upsAlarmTestInProgress OBJECT-IDENTITY

    STATUS     current

    DESCRIPTION

            "A test is in progress, as initiated and indicated by

            the Test Group.  Tests initiated via other

            implementation-specific mechanisms can indicate the

            presence of the testing in the alarm table, if

            desired, via a OBJECT-IDENTITY macro in the MIB

            document specific to that implementation and are

            outside the scope of this OBJECT-IDENTITY."

    ::= { upsWellKnownAlarms 24 }

--

-- The Test Group

--

upsTest               OBJECT IDENTIFIER ::= { upsObjects 7 }

upsTestId OBJECT-TYPE

    SYNTAX     OBJECT IDENTIFIER

    MAX-ACCESS read-write

    STATUS     current

    DESCRIPTION

            "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 those introduced by a

            particular implementation, i.e., as documented in the

            private enterprise MIB definition for the device.

            Setting this variable initiates the named test. Sets

            to this variable require the presence of

            upsTestSpinLock in the same SNMP message.

            The set request will be rejected with an appropriate

            error message if the requested test cannot be

            performed, including attempts to start a test when

            another test is already in progress.  The status of

            the current or last test is maintained in

            upsTestResultsSummary. Tests in progress may be

            aborted by setting the upsTestId variable to

            upsTestAbortTestInProgress.

            Read operations return the value of the name of the

            test in progress if a test is in progress or the name

            of the last test performed if no test is in progress,

            unless no test has been run, in which case the well

            known value upsTestNoTestsInitiated is returned."

    ::= { upsTest 1 }

-- see [6] for more information on the semantics of objects with

-- syntax of TestAndIncr

upsTestSpinLock OBJECT-TYPE

    SYNTAX     TestAndIncr

    MAX-ACCESS read-write

    STATUS     current

    DESCRIPTION

            "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."

    ::= { upsTest 2 }

upsTestResultsSummary OBJECT-TYPE

    SYNTAX     INTEGER {