Blame mibs/ietf/HC-ALARM-MIB

Packit 022b05
HC-ALARM-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
IMPORTS
Packit 022b05
        MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Packit 022b05
        Integer32, Counter32, Unsigned32
Packit 022b05
                FROM SNMPv2-SMI
Packit 022b05
        MODULE-COMPLIANCE, OBJECT-GROUP,
Packit 022b05
        NOTIFICATION-GROUP
Packit 022b05
                FROM SNMPv2-CONF
Packit 022b05
        RowStatus, VariablePointer, StorageType,
Packit 022b05
        TEXTUAL-CONVENTION
Packit 022b05
                FROM SNMPv2-TC
Packit 022b05
        CounterBasedGauge64
Packit 022b05
                FROM HCNUM-TC
Packit 022b05
        rmon, OwnerString, rmonEventGroup
Packit 022b05
                FROM RMON-MIB;
Packit 022b05
Packit 022b05
hcAlarmMIB MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED    "200212160000Z"
Packit 022b05
    ORGANIZATION    "IETF RMONMIB Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
            "        Andy Bierman
Packit 022b05
                     Cisco Systems, Inc.
Packit 022b05
                Tel: +1 408 527-3711
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
             E-mail: abierman@cisco.com
Packit 022b05
             Postal: 170 West Tasman Drive
Packit 022b05
                     San Jose, CA USA 95134
Packit 022b05
Packit 022b05
                     Keith McCloghrie
Packit 022b05
                     Cisco Systems, Inc.
Packit 022b05
                Tel: +1 408 526-5260
Packit 022b05
             E-mail: kzm@cisco.com
Packit 022b05
             Postal: 170 West Tasman Drive
Packit 022b05
                     San Jose, CA USA 95134
Packit 022b05
Packit 022b05
             Send comments to <rmonmib@ietf.org>
Packit 022b05
             Mailing list subscription info:
Packit 022b05
                 http://www.ietf.org/mailman/listinfo/rmonmib "
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This module defines Remote Monitoring MIB extensions for
Packit 022b05
             High Capacity Alarms.
Packit 022b05
Packit 022b05
             Copyright (C) The Internet Society (2002). This version
Packit 022b05
             of this MIB module is part of RFC 3434; see the RFC
Packit 022b05
             itself for full legal notices."
Packit 022b05
Packit 022b05
    REVISION        "200212160000Z"
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Initial version of the High Capacity Alarm MIB module.
Packit 022b05
             This version published as RFC 3434."
Packit 022b05
    ::= { rmon 29 }
Packit 022b05
Packit 022b05
hcAlarmObjects       OBJECT IDENTIFIER ::= { hcAlarmMIB 1 }
Packit 022b05
hcAlarmNotifications OBJECT IDENTIFIER ::= { hcAlarmMIB 2 }
Packit 022b05
hcAlarmConformance   OBJECT IDENTIFIER ::= { hcAlarmMIB 3 }
Packit 022b05
Packit 022b05
hcAlarmControlObjects OBJECT IDENTIFIER ::= { hcAlarmObjects 1 }
Packit 022b05
hcAlarmCapabilitiesObjects OBJECT IDENTIFIER
Packit 022b05
                                        ::= { hcAlarmObjects 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Textual Conventions
Packit 022b05
--
Packit 022b05
Packit 022b05
HcValueStatus ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This data type indicates the validity and sign of the data
Packit 022b05
            in associated object instances which represent the absolute
Packit 022b05
            value of a high capacity numeric quantity.  Such an object
Packit 022b05
            may be represented with one or more object instances. An
Packit 022b05
            object of type HcValueStatus MUST be defined within the same
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            structure as the object(s) representing the high capacity
Packit 022b05
            absolute value.
Packit 022b05
Packit 022b05
            If the associated object instance(s) representing the high
Packit 022b05
            capacity absolute value could not be accessed during the
Packit 022b05
            sampling interval, and is therefore invalid, then the
Packit 022b05
            associated HcValueStatus object will contain the value
Packit 022b05
            'valueNotAvailable(1)'.
Packit 022b05
Packit 022b05
            If the associated object instance(s) representing the high
Packit 022b05
            capacity absolute value are valid and actual value of the
Packit 022b05
            sample is greater than or equal to zero, then the associated
Packit 022b05
            HcValueStatus object will contain the value
Packit 022b05
            'valuePositive(2)'.
Packit 022b05
Packit 022b05
            If the associated object instance(s) representing the high
Packit 022b05
            capacity absolute value are valid and the actual value of
Packit 022b05
            the sample is less than zero, then the associated
Packit 022b05
            HcValueStatus object will contain the value
Packit 022b05
            'valueNegative(3)'.  The associated absolute value should be
Packit 022b05
            multiplied by -1 to obtain the true sample value."
Packit 022b05
    SYNTAX INTEGER {
Packit 022b05
        valueNotAvailable(1),
Packit 022b05
        valuePositive(2),
Packit 022b05
        valueNegative(3)
Packit 022b05
    }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- High Capacity Alarm Table
Packit 022b05
--
Packit 022b05
Packit 022b05
hcAlarmTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF HcAlarmEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A list of entries for the configuration of high capacity
Packit 022b05
            alarms."
Packit 022b05
    ::= { hcAlarmControlObjects 1 }
Packit 022b05
Packit 022b05
hcAlarmEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      HcAlarmEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A conceptual row in the hcAlarmTable. Entries are usually
Packit 022b05
            created in this table by management application action, but
Packit 022b05
            may also be created by agent action as well."
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    INDEX { hcAlarmIndex }
Packit 022b05
    ::= { hcAlarmTable 1 }
Packit 022b05
Packit 022b05
HcAlarmEntry ::= SEQUENCE {
Packit 022b05
    hcAlarmIndex                     Integer32,
Packit 022b05
    hcAlarmInterval                  Integer32,
Packit 022b05
    hcAlarmVariable                  VariablePointer,
Packit 022b05
    hcAlarmSampleType                INTEGER,
Packit 022b05
    hcAlarmAbsValue                  CounterBasedGauge64,
Packit 022b05
    hcAlarmValueStatus               HcValueStatus,
Packit 022b05
    hcAlarmStartupAlarm              INTEGER,
Packit 022b05
    hcAlarmRisingThreshAbsValueLo    Unsigned32,
Packit 022b05
    hcAlarmRisingThreshAbsValueHi    Unsigned32,
Packit 022b05
    hcAlarmRisingThresholdValStatus  HcValueStatus,
Packit 022b05
    hcAlarmFallingThreshAbsValueLo   Unsigned32,
Packit 022b05
    hcAlarmFallingThreshAbsValueHi   Unsigned32,
Packit 022b05
    hcAlarmFallingThresholdValStatus HcValueStatus,
Packit 022b05
    hcAlarmRisingEventIndex          Integer32,
Packit 022b05
    hcAlarmFallingEventIndex         Integer32,
Packit 022b05
    hcAlarmValueFailedAttempts       Counter32,
Packit 022b05
    hcAlarmOwner                     OwnerString,
Packit 022b05
    hcAlarmStorageType               StorageType,
Packit 022b05
    hcAlarmStatus                    RowStatus }
Packit 022b05
Packit 022b05
hcAlarmIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An arbitrary integer index value used to uniquely identify
Packit 022b05
            this high capacity alarm entry."
Packit 022b05
    ::= { hcAlarmEntry 1 }
Packit 022b05
Packit 022b05
hcAlarmInterval OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..2147483647)
Packit 022b05
    UNITS      "seconds"
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The interval in seconds over which the data is sampled and
Packit 022b05
            compared with the rising and falling thresholds.  When
Packit 022b05
            setting this variable, care should be taken in the case of
Packit 022b05
            deltaValue sampling - the interval should be set short
Packit 022b05
            enough that the sampled variable is very unlikely to
Packit 022b05
            increase or decrease by more than 2^63 - 1 during a single
Packit 022b05
            sampling interval.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 2 }
Packit 022b05
Packit 022b05
hcAlarmVariable OBJECT-TYPE
Packit 022b05
    SYNTAX      VariablePointer
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The object identifier of the particular variable to be
Packit 022b05
            sampled.  Only variables that resolve to an ASN.1 primitive
Packit 022b05
            type of INTEGER (INTEGER, Integer32, Counter32, Counter64,
Packit 022b05
            Gauge, or TimeTicks) may be sampled.
Packit 022b05
Packit 022b05
            Because SNMP access control is articulated entirely in terms
Packit 022b05
            of the contents of MIB views, no access control mechanism
Packit 022b05
            exists that can restrict the value of this object to
Packit 022b05
            identify only those objects that exist in a particular MIB
Packit 022b05
            view.  Because there is thus no acceptable means of
Packit 022b05
            restricting the read access that could be obtained through
Packit 022b05
            the alarm mechanism, the probe must only grant write access
Packit 022b05
            to this object in those views that have read access to all
Packit 022b05
            objects on the probe.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 3 }
Packit 022b05
Packit 022b05
hcAlarmSampleType OBJECT-TYPE
Packit 022b05
    SYNTAX INTEGER {
Packit 022b05
               absoluteValue(1),
Packit 022b05
               deltaValue(2)
Packit 022b05
           }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The method of sampling the selected variable and
Packit 022b05
            calculating the value to be compared against the thresholds.
Packit 022b05
            If the value of this object is absoluteValue(1), the value
Packit 022b05
            of the selected variable will be compared directly with the
Packit 022b05
            thresholds at the end of the sampling interval.  If the
Packit 022b05
            value of this object is deltaValue(2), the value of the
Packit 022b05
            selected variable at the last sample will be subtracted from
Packit 022b05
            the current value, and the difference compared with the
Packit 022b05
            thresholds.
Packit 022b05
Packit 022b05
            If the associated hcAlarmVariable instance could not be
Packit 022b05
            obtained at the previous sample interval, then a delta
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            sample is not possible, and the value of the associated
Packit 022b05
            hcAlarmValueStatus object for this interval will be
Packit 022b05
            valueNotAvailable(1).
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 4 }
Packit 022b05
Packit 022b05
hcAlarmAbsValue OBJECT-TYPE
Packit 022b05
    SYNTAX      CounterBasedGauge64
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The absolute value (i.e., unsigned value) of the
Packit 022b05
            hcAlarmVariable statistic during the last sampling period.
Packit 022b05
            The value during the current sampling period is not made
Packit 022b05
            available until the period is completed.
Packit 022b05
Packit 022b05
            To obtain the true value for this sampling interval, the
Packit 022b05
            associated instance of hcAlarmValueStatus must be checked,
Packit 022b05
            and the value of this object adjusted as necessary.
Packit 022b05
Packit 022b05
            If the MIB instance could not be accessed during the
Packit 022b05
            sampling interval, then this object will have a value of
Packit 022b05
            zero and the associated instance of hcAlarmValueStatus will
Packit 022b05
            be set to 'valueNotAvailable(1)'."
Packit 022b05
    ::= { hcAlarmEntry 5 }
Packit 022b05
Packit 022b05
hcAlarmValueStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      HcValueStatus
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object indicates the validity and sign of the data for
Packit 022b05
            the hcAlarmAbsValue object, as described in the
Packit 022b05
            HcValueStatus textual convention."
Packit 022b05
    ::= { hcAlarmEntry 6 }
Packit 022b05
Packit 022b05
hcAlarmStartupAlarm OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                  risingAlarm(1),
Packit 022b05
                  fallingAlarm(2),
Packit 022b05
                  risingOrFallingAlarm(3)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The alarm that may be sent when this entry is first set to
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            active.  If the first sample after this entry becomes active
Packit 022b05
            is greater than or equal to the rising threshold and this
Packit 022b05
            object is equal to risingAlarm(1) or
Packit 022b05
            risingOrFallingAlarm(3), then a single rising alarm will be
Packit 022b05
            generated.  If the first sample after this entry becomes
Packit 022b05
            valid is less than or equal to the falling threshold and
Packit 022b05
            this object is equal to fallingAlarm(2) or
Packit 022b05
            risingOrFallingAlarm(3), then a single falling alarm will be
Packit 022b05
            generated.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 7 }
Packit 022b05
Packit 022b05
hcAlarmRisingThreshAbsValueLo OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The lower 32 bits of the absolute value for threshold for
Packit 022b05
            the sampled statistic.  The actual threshold value is
Packit 022b05
            determined by the associated instances of the
Packit 022b05
            hcAlarmRisingThreshAbsValueHi and
Packit 022b05
            hcAlarmRisingThresholdValStatus objects, as follows:
Packit 022b05
Packit 022b05
               ABS(threshold) = hcAlarmRisingThreshAbsValueLo +
Packit 022b05
                     (hcAlarmRisingThreshAbsValueHi * 2^^32)
Packit 022b05
Packit 022b05
            The absolute value of the threshold is adjusted as required,
Packit 022b05
            as described in the HcValueStatus textual convention.  These
Packit 022b05
            three object instances are conceptually combined to
Packit 022b05
            represent the rising threshold for this entry.
Packit 022b05
Packit 022b05
            When the current sampled value is greater than or equal to
Packit 022b05
            this threshold, and the value at the last sampling interval
Packit 022b05
            was less than this threshold, a single event will be
Packit 022b05
            generated.  A single event will also be generated if the
Packit 022b05
            first sample after this entry becomes valid is greater than
Packit 022b05
            or equal to this threshold and the associated
Packit 022b05
            hcAlarmStartupAlarm is equal to risingAlarm(1) or
Packit 022b05
            risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
            After a rising event is generated, another such event will
Packit 022b05
            not be generated until the sampled value falls below this
Packit 022b05
            threshold and reaches the threshold identified by the
Packit 022b05
            hcAlarmFallingThreshAbsValueLo,
Packit 022b05
            hcAlarmFallingThreshAbsValueHi, and
Packit 022b05
            hcAlarmFallingThresholdValStatus objects.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
Packit 022b05
    ::= { hcAlarmEntry 8 }
Packit 022b05
Packit 022b05
hcAlarmRisingThreshAbsValueHi OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The upper 32 bits of the absolute value for threshold for
Packit 022b05
            the sampled statistic.  The actual threshold value is
Packit 022b05
            determined by the associated instances of the
Packit 022b05
            hcAlarmRisingThreshAbsValueLo and
Packit 022b05
            hcAlarmRisingThresholdValStatus objects, as follows:
Packit 022b05
Packit 022b05
               ABS(threshold) = hcAlarmRisingThreshAbsValueLo +
Packit 022b05
                     (hcAlarmRisingThreshAbsValueHi * 2^^32)
Packit 022b05
Packit 022b05
            The absolute value of the threshold is adjusted as required,
Packit 022b05
            as described in the HcValueStatus textual convention.  These
Packit 022b05
            three object instances are conceptually combined to
Packit 022b05
            represent the rising threshold for this entry.
Packit 022b05
Packit 022b05
            When the current sampled value is greater than or equal to
Packit 022b05
            this threshold, and the value at the last sampling interval
Packit 022b05
            was less than this threshold, a single event will be
Packit 022b05
            generated.  A single event will also be generated if the
Packit 022b05
            first sample after this entry becomes valid is greater than
Packit 022b05
            or equal to this threshold and the associated
Packit 022b05
            hcAlarmStartupAlarm is equal to risingAlarm(1) or
Packit 022b05
            risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
            After a rising event is generated, another such event will
Packit 022b05
            not be generated until the sampled value falls below this
Packit 022b05
            threshold and reaches the threshold identified by the
Packit 022b05
            hcAlarmFallingThreshAbsValueLo,
Packit 022b05
            hcAlarmFallingThreshAbsValueHi, and
Packit 022b05
            hcAlarmFallingThresholdValStatus objects.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 9 }
Packit 022b05
Packit 022b05
hcAlarmRisingThresholdValStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      HcValueStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    DESCRIPTION
Packit 022b05
            "This object indicates the sign of the data for the rising
Packit 022b05
            threshold, as defined by the hcAlarmRisingThresAbsValueLo
Packit 022b05
            and hcAlarmRisingThresAbsValueHi objects, as described in
Packit 022b05
            the HcValueStatus textual convention.
Packit 022b05
Packit 022b05
            The enumeration 'valueNotAvailable(1)' is not allowed, and
Packit 022b05
            the associated hcAlarmStatus object cannot be equal to
Packit 022b05
            'active(1)' if this object is set to this value.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 10 }
Packit 022b05
Packit 022b05
hcAlarmFallingThreshAbsValueLo OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The lower 32 bits of the absolute value for threshold for
Packit 022b05
            the sampled statistic.  The actual threshold value is
Packit 022b05
            determined by the associated instances of the
Packit 022b05
            hcAlarmFallingThreshAbsValueHi and
Packit 022b05
            hcAlarmFallingThresholdValStatus objects, as follows:
Packit 022b05
Packit 022b05
               ABS(threshold) = hcAlarmFallingThreshAbsValueLo +
Packit 022b05
                     (hcAlarmFallingThreshAbsValueHi * 2^^32)
Packit 022b05
Packit 022b05
            The absolute value of the threshold is adjusted as required,
Packit 022b05
            as described in the HcValueStatus textual convention.  These
Packit 022b05
            three object instances are conceptually combined to
Packit 022b05
            represent the falling threshold for this entry.
Packit 022b05
Packit 022b05
            When the current sampled value is less than or equal to this
Packit 022b05
            threshold, and the value at the last sampling interval was
Packit 022b05
            greater than this threshold, a single event will be
Packit 022b05
            generated.  A single event will also be generated if the
Packit 022b05
            first sample after this entry becomes valid is less than or
Packit 022b05
            equal to this threshold and the associated
Packit 022b05
            hcAlarmStartupAlarm is equal to fallingAlarm(2) or
Packit 022b05
            risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
            After a falling event is generated, another such event will
Packit 022b05
            not be generated until the sampled value rises above this
Packit 022b05
            threshold and reaches the threshold identified by the
Packit 022b05
            hcAlarmRisingThreshAbsValueLo,
Packit 022b05
            hcAlarmRisingThreshAbsValueHi, and
Packit 022b05
            hcAlarmRisingThresholdValStatus objects.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 11 }
Packit 022b05
Packit 022b05
hcAlarmFallingThreshAbsValueHi OBJECT-TYPE
Packit 022b05
    SYNTAX      Unsigned32
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The upper 32 bits of the absolute value for threshold for
Packit 022b05
            the sampled statistic.  The actual threshold value is
Packit 022b05
            determined by the associated instances of the
Packit 022b05
            hcAlarmFallingThreshAbsValueLo and
Packit 022b05
            hcAlarmFallingThresholdValStatus objects, as follows:
Packit 022b05
Packit 022b05
               ABS(threshold) = hcAlarmFallingThreshAbsValueLo +
Packit 022b05
                     (hcAlarmFallingThreshAbsValueHi * 2^^32)
Packit 022b05
Packit 022b05
            The absolute value of the threshold is adjusted as required,
Packit 022b05
            as described in the HcValueStatus textual convention.  These
Packit 022b05
            three object instances are conceptually combined to
Packit 022b05
            represent the falling threshold for this entry.
Packit 022b05
Packit 022b05
            When the current sampled value is less than or equal to this
Packit 022b05
            threshold, and the value at the last sampling interval was
Packit 022b05
            greater than this threshold, a single event will be
Packit 022b05
            generated.  A single event will also be generated if the
Packit 022b05
            first sample after this entry becomes valid is less than or
Packit 022b05
            equal to this threshold and the associated
Packit 022b05
            hcAlarmStartupAlarm is equal to fallingAlarm(2) or
Packit 022b05
            risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
            After a falling event is generated, another such event will
Packit 022b05
            not be generated until the sampled value rises above this
Packit 022b05
            threshold and reaches the threshold identified by the
Packit 022b05
            hcAlarmRisingThreshAbsValueLo,
Packit 022b05
            hcAlarmRisingThreshAbsValueHi, and
Packit 022b05
            hcAlarmRisingThresholdValStatus objects.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 12 }
Packit 022b05
Packit 022b05
hcAlarmFallingThresholdValStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      HcValueStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            "This object indicates the sign of the data for the falling
Packit 022b05
            threshold, as defined by the hcAlarmFallingThreshAbsValueLo
Packit 022b05
            and hcAlarmFallingThreshAbsValueHi objects, as described in
Packit 022b05
            the HcValueStatus textual convention.
Packit 022b05
Packit 022b05
            The enumeration 'valueNotAvailable(1)' is not allowed, and
Packit 022b05
            the associated hcAlarmStatus object cannot be equal to
Packit 022b05
            'active(1)' if this object is set to this value.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 13 }
Packit 022b05
Packit 022b05
hcAlarmRisingEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The index of the eventEntry that is used when a rising
Packit 022b05
            threshold is crossed.  The eventEntry identified by a
Packit 022b05
            particular value of this index is the same as identified by
Packit 022b05
            the same value of the eventIndex object.  If there is no
Packit 022b05
            corresponding entry in the eventTable, then no association
Packit 022b05
            exists.  In particular, if this value is zero, no associated
Packit 022b05
            event will be generated, as zero is not a valid event index.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 14 }
Packit 022b05
Packit 022b05
hcAlarmFallingEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The index of the eventEntry that is used when a falling
Packit 022b05
            threshold is crossed.  The eventEntry identified by a
Packit 022b05
            particular value of this index is the same as identified by
Packit 022b05
            the same value of the eventIndex object.  If there is no
Packit 022b05
            corresponding entry in the eventTable, then no association
Packit 022b05
            exists.  In particular, if this value is zero, no associated
Packit 022b05
            event will be generated, as zero is not a valid event index.
Packit 022b05
Packit 022b05
            This object may not be modified if the associated
Packit 022b05
            hcAlarmStatus object is equal to active(1)."
Packit 022b05
    ::= { hcAlarmEntry 15 }
Packit 022b05
Packit 022b05
hcAlarmValueFailedAttempts OBJECT-TYPE
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The number of times the associated hcAlarmVariable instance
Packit 022b05
            was polled on behalf of this hcAlarmEntry, (while in the
Packit 022b05
            active state) and the value was not available.  This counter
Packit 022b05
            may experience a discontinuity if the agent restarts,
Packit 022b05
            indicated by the value of sysUpTime."
Packit 022b05
    ::= { hcAlarmEntry 16 }
Packit 022b05
Packit 022b05
hcAlarmOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The entity that configured this entry and is therefore
Packit 022b05
            using the resources assigned to it."
Packit 022b05
    ::= { hcAlarmEntry 17 }
Packit 022b05
Packit 022b05
hcAlarmStorageType OBJECT-TYPE
Packit 022b05
    SYNTAX     StorageType
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The type of non-volatile storage configured for this entry.
Packit 022b05
            If this object is equal to 'permanent(4)', then the
Packit 022b05
            associated hcAlarmRisingEventIndex and
Packit 022b05
            hcAlarmFallingEventIndex objects must be writable."
Packit 022b05
    ::= { hcAlarmEntry 18 }
Packit 022b05
Packit 022b05
hcAlarmStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The status of this row.
Packit 022b05
Packit 022b05
            An entry MUST NOT exist in the active state unless all
Packit 022b05
            objects in the entry have an appropriate value, as described
Packit 022b05
            in the description clause for each writable object.
Packit 022b05
Packit 022b05
            The hcAlarmStatus object may be modified if the associated
Packit 022b05
            instance of this object is equal to active(1),
Packit 022b05
            notInService(2), or notReady(3).  All other writable objects
Packit 022b05
            may be modified if the associated instance of this object is
Packit 022b05
            equal to notInService(2) or notReady(3)."
Packit 022b05
    ::= { hcAlarmEntry 19 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Capabilities
Packit 022b05
--
Packit 022b05
Packit 022b05
hcAlarmCapabilities OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS {
Packit 022b05
       hcAlarmCreation(0),
Packit 022b05
       hcAlarmNvStorage(1)
Packit 022b05
    }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "An indication of the high capacity alarm capabilities
Packit 022b05
            supported by this agent.
Packit 022b05
Packit 022b05
            If the 'hcAlarmCreation' BIT is set, then this agent allows
Packit 022b05
            NMS applications to create entries in the hcAlarmTable.
Packit 022b05
Packit 022b05
            If the 'hcAlarmNvStorage' BIT is set, then this agent allows
Packit 022b05
            entries in the hcAlarmTable which will be recreated after a
Packit 022b05
            system restart, as controlled by the hcAlarmStorageType
Packit 022b05
            object."
Packit 022b05
    ::= { hcAlarmCapabilitiesObjects 1 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Notifications
Packit 022b05
--
Packit 022b05
Packit 022b05
hcAlarmNotifPrefix OBJECT IDENTIFIER
Packit 022b05
      ::= { hcAlarmNotifications 0 }
Packit 022b05
Packit 022b05
hcRisingAlarm NOTIFICATION-TYPE
Packit 022b05
    OBJECTS  { hcAlarmVariable,
Packit 022b05
               hcAlarmSampleType,
Packit 022b05
               hcAlarmAbsValue,
Packit 022b05
               hcAlarmValueStatus,
Packit 022b05
               hcAlarmRisingThreshAbsValueLo,
Packit 022b05
               hcAlarmRisingThreshAbsValueHi,
Packit 022b05
               hcAlarmRisingThresholdValStatus,
Packit 022b05
               hcAlarmRisingEventIndex }
Packit 022b05
    STATUS   current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The SNMP notification that is generated when a high
Packit 022b05
            capacity alarm entry crosses its rising threshold and
Packit 022b05
            generates an event that is configured for sending SNMP
Packit 022b05
            traps.
Packit 022b05
Packit 022b05
            The hcAlarmEntry object instances identified in the OBJECTS
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            clause are from the entry that causes this notification to
Packit 022b05
            be generated."
Packit 022b05
     ::= { hcAlarmNotifPrefix 1 }
Packit 022b05
Packit 022b05
hcFallingAlarm NOTIFICATION-TYPE
Packit 022b05
    OBJECTS { hcAlarmVariable,
Packit 022b05
              hcAlarmSampleType,
Packit 022b05
              hcAlarmAbsValue,
Packit 022b05
              hcAlarmValueStatus,
Packit 022b05
              hcAlarmFallingThreshAbsValueLo,
Packit 022b05
              hcAlarmFallingThreshAbsValueHi,
Packit 022b05
              hcAlarmFallingThresholdValStatus,
Packit 022b05
              hcAlarmFallingEventIndex }
Packit 022b05
    STATUS    current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "The SNMP notification that is generated when a high
Packit 022b05
            capacity alarm entry crosses its falling threshold and
Packit 022b05
            generates an event that is configured for sending SNMP
Packit 022b05
            traps.
Packit 022b05
Packit 022b05
            The hcAlarmEntry object instances identified in the OBJECTS
Packit 022b05
            clause are from the entry that causes this notification to
Packit 022b05
            be generated."
Packit 022b05
     ::= { hcAlarmNotifPrefix 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Conformance Section
Packit 022b05
--
Packit 022b05
Packit 022b05
hcAlarmCompliances OBJECT IDENTIFIER ::= { hcAlarmConformance 1 }
Packit 022b05
hcAlarmGroups      OBJECT IDENTIFIER ::= { hcAlarmConformance 2 }
Packit 022b05
Packit 022b05
hcAlarmCompliance MODULE-COMPLIANCE
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "Describes the requirements for conformance to the High
Packit 022b05
            Capacity Alarm MIB."
Packit 022b05
    MODULE  -- this module
Packit 022b05
        MANDATORY-GROUPS {
Packit 022b05
                           hcAlarmControlGroup,
Packit 022b05
                           hcAlarmCapabilitiesGroup,
Packit 022b05
                           hcAlarmNotificationsGroup
Packit 022b05
                         }
Packit 022b05
Packit 022b05
    MODULE RMON-MIB
Packit 022b05
        MANDATORY-GROUPS { rmonEventGroup }
Packit 022b05
Packit 022b05
    ::= { hcAlarmCompliances 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- Object Groups
Packit 022b05
Packit 022b05
hcAlarmControlGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
             hcAlarmInterval,
Packit 022b05
             hcAlarmVariable,
Packit 022b05
             hcAlarmSampleType,
Packit 022b05
             hcAlarmAbsValue,
Packit 022b05
             hcAlarmValueStatus,
Packit 022b05
             hcAlarmStartupAlarm,
Packit 022b05
             hcAlarmRisingThreshAbsValueLo,
Packit 022b05
             hcAlarmRisingThreshAbsValueHi,
Packit 022b05
             hcAlarmRisingThresholdValStatus,
Packit 022b05
             hcAlarmFallingThreshAbsValueLo,
Packit 022b05
             hcAlarmFallingThreshAbsValueHi,
Packit 022b05
             hcAlarmFallingThresholdValStatus,
Packit 022b05
             hcAlarmRisingEventIndex,
Packit 022b05
             hcAlarmFallingEventIndex,
Packit 022b05
             hcAlarmValueFailedAttempts,
Packit 022b05
             hcAlarmOwner,
Packit 022b05
             hcAlarmStorageType,
Packit 022b05
             hcAlarmStatus
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A collection of objects used to configure entries for high
Packit 022b05
            capacity alarm threshold monitoring purposes."
Packit 022b05
    ::= { hcAlarmGroups 1 }
Packit 022b05
Packit 022b05
hcAlarmCapabilitiesGroup OBJECT-GROUP
Packit 022b05
    OBJECTS {
Packit 022b05
             hcAlarmCapabilities
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A collection of objects used to indicate an agent's high
Packit 022b05
            capacity alarm threshold monitoring capabilities."
Packit 022b05
    ::= { hcAlarmGroups 2 }
Packit 022b05
Packit 022b05
hcAlarmNotificationsGroup NOTIFICATION-GROUP
Packit 022b05
    NOTIFICATIONS {
Packit 022b05
            hcRisingAlarm,
Packit 022b05
            hcFallingAlarm
Packit 022b05
    }
Packit 022b05
    STATUS  current
Packit 022b05
    DESCRIPTION
Packit 022b05
            "A collection of notifications to deliver information
Packit 022b05
            related to a high capacity rising or falling threshold event
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            to a management application."
Packit 022b05
    ::= { hcAlarmGroups 3 }
Packit 022b05
Packit 022b05
END