[Docs] [txt|pdf] [Tracker] [WG] [Email] [Diff1] [Diff2] [Nits]

Versions: 02 RFC 1451

          Draft               Manager to Manager MIB              Oct 92
          
          
                                Manager to Manager
                           Management Information Base
          
                             Thu Nov 12 08:51:15 1992                     |
          
          
                                 Jeffrey D. Case
                               SNMP Research, Inc.
                        University of Tennessee, Knoxville
                                 case@cs.utk.edu
          
          
                                 Keith McCloghrie
                                Hughes LAN Systems
                                   kzm@hls.com
          
          
                                 Marshall T. Rose
                           Dover Beach Consulting, Inc.
                              mrose@dbc.mtview.ca.us
          
          
                               Steven L. Waldbusser
                            Carnegie Mellon University
                            waldbusser@andrew.cmu.edu
          
          
          
          
          
          
          1.  Status of this Memo
          
          This document is an Internet Draft.  Internet Drafts are
          working documents of the Internet Engineering Task Force
          (IETF), its Areas, and its Working Groups.  Note that other
          groups may also distribute working documents as Internet
          Drafts.
          
          Internet Drafts are valid for a maximum of six months and may
          be updated, replaced, or obsoleted by other documents at any
          time.  It is inappropriate to use Internet Drafts as reference
          material or to cite them other than as a "work in progress".
          
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 1]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          2.  Introduction
          
          A network management system contains: several (potentially
          many) entities, each with management instrumentation termed an
          agent; at least one management station; and, a management
          protocol, which is used to convey management information
          between the agents and management stations, as well as between
          the management stations.  Operations of the protocol are
          carried out under an administrative framework which defines
          both authentication and authorization policies.
          
          Network management stations execute management applications
          which monitor and control network elements.  Network elements
          are devices such as hosts, routers, terminal servers, etc.,
          which are monitored and controlled through access to their
          management information.
          
          Management information is viewed as a collection of managed
          objects, residing in a virtual information store, termed the
          Management Information Base (MIB).  Collections of related
          objects are defined in MIB modules.  These modules are written
          using a subset of OSI's Abstract Syntax Notation One (ASN.1)
          [1], termed the Structure of Management Information (SMI) [2].
          
          The management protocol, SNMPv2 [3], provides for the exchange
          of messages which convey management information between the
          agents and the management stations, including between
          management stations.  It is the purpose of this document to
          define managed objects which describe the behavior of an
          SNMPv2 entity acting in both a manager role and an agent role.
          
          
          2.1.  A Note on Terminology
          
          For the purpose of exposition, the original Internet-standard   +
          Network Management Framework, as described in RFCs 1155, 1157,  +
          and 1212, is termed the SNMP version 1 framework (SNMPv1).      +
          The current framework is termed the SNMP version 2 framework    +
          (SNMPv2).                                                       +
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 2]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          3.  Overview
          
          The purpose of this MIB is to provide the means for
          coordination between multiple management stations.  That is,
          the means by which the controlling and monitoring functions of
          network management can be distributed amongst multiple
          management stations.  Such distribution facilitates the
          scaling of network management solutions based on the SNMPv2 to
          meet the needs of very large networks, or of networks composed
          of multiple interconnected administrations. Specifically, this
          MIB provides the means for one management station to request
          management services from another management station.
          
          
          3.1.  A SNMPv2 Entity Acting in a Dual Role
          
          A management station providing services to other management
          station(s), is an SNMPv2 entity which acts in the dual role of
          both manager and agent; the requests for service are received
          through acting in an agent role (with respect to the managed
          objects defined in this MIB), and the requested services are
          performed through acting in a manager role.
          
          
          3.2.  Alarms, Events, and Notifications
          
          In this initial version, this MIB defines the concepts of
          "alarms", "events", and "notifications".  Each alarm is a
          specific condition detected through the periodic (at a
          configured sampling interval) monitoring of the value of a
          specific management information variable.  An example of an
          alarm condition is when the monitored variable falls outside a
          configured range.  Each alarm condition triggers an event, and
          each event can cause (one or more) notifications to be
          reported to other management stations using the Inform-Request
          PDU.
          
          Specifically, this MIB defines three MIB tables and a number
          of scalar objects.  The three tables are: the Alarm Table, the
          Event Table, and the Notification Table.
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 3]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          3.3.  Access Control
          
          The Administrative framework for SNMPv2 [4] includes an access
          control model, which must not be subverted by allowing access
          to management information variables via the Alarm table.  That
          is, access to a monitored variable via the Alarm table must be
          controlled according to the identity of the management station
          accessing the particular entry in the Alarm table.
          
          An entry in the Alarm table provides the means to configure
          the sampling of the value of a MIB variable in a particular
          MIB view.  The particular MIB view is that associated with a
          party [4], called the sampling destination party, which can be
          any party accessible from the SNMPv2 entity acting in a dual
          role, either local or remote.  The sampling is done by
          (conceptually or actually) issuing a SNMPv2 request to
          retrieve the variable's value.  This request is authenticated
          according to a source party, called the sampling source party
          which must be local to the SNMPv2 entity acting in a dual
          role, and directed to the sampling destination party.
          
          Thus, to provide the required access control, the initial MIB
          view assigned, by convention, to parties on SNMPv2 entities
          that implement the snmpAlarmTable, must include the component:
          
               viewSubtree  = { snmpAlarm }
               viewStatus   = { excluded }
               viewMask     = { ''h }
          
          Then, the MIB view of a party, partyRequestDest, accessible by
          a requesting management station, can be configured to include
          specific Alarm table entries -- the ones associated with those
          sampling destination parties to which the requesting
          management station has access.
          
          In particular, to provide a partyRequestDest with access to
          the sampling destination party partySampleDest, the following
          family of view subtrees would be included for partyRequestDest
          on the SNMPv2 entity acting in a dual role:
          
               { snmpAlarmEntry WILDCARD partySampleDest }
          
          Which would be configured in the party MIB [5] as:
          
               viewParty    = { partyRequestDest }
          
          
          
          
          
                               Expires May 12, 1993             [Page 4]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
               viewSubtree  = { snmpAlarmEntry 1 partySampleDest }
               viewStatus   = { included }
               viewMask     = { 'FFBF'h } -- specifies wildcard for column
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 5]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          4.  Definitions
          
          SNMPv2-M2M-MIB DEFINITIONS ::= BEGIN
          
          IMPORTS
              MODULE-IDENTITY, OBJECT-TYPE, OBJECT-GROUP,
              MODULE-COMPLIANCE, NOTIFICATION-TYPE,                       |
              snmpModules                                                 |
                  FROM SNMPv2-SMI
              DisplayString, InstancePointer, RowStatus
                  FROM SNMPv2-TC
              Party, partyIdentity
                  FROM RFC1353-MIB;
          
          
          snmpM2M MODULE-IDENTITY
              LAST-UPDATED "9210070433Z"
              ORGANIZATION "IETF SNMPv2 Working Group"
              CONTACT-INFO
                      "        Steven L. Waldbusser
          
                       Postal: Carnegie Mellon University
                               UCC 130
                               Pittsburgh, PA  15213
          
                          Tel: +1 412 268 6628
                          Fax: +1 412 268 4987
          
                       E-mail: waldbusser@andrew.cmu.edu"
              DESCRIPTION
                      "The Manager to Manager MIB module."
              ::= { snmpModules 2 }
          
          
          snmpM2MCompliance MODULE-COMPLIANCE
              STATUS  current
              DESCRIPTION
                      "The compliance statement for SNMPv2 entities
                      which implement the Manager to Manager MIB."
              MODULE  -- this module
                  MANDATORY-GROUPS { snmpAlarm, snmpEvent }
              ::= { snmpM2M 1 }
          
          
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 6]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          -- the alarm group
          snmpAlarm OBJECT-GROUP
              OBJECTS { snmpAlarmNextIndex,                               |
                        snmpAlarmSourcePartyID,
                        snmpAlarmVariable, snmpAlarmInterval,
                        snmpAlarmSampleType, snmpAlarmValue,
                        snmpAlarmStartupAlarm, snmpAlarmRisingThreshold,
                        snmpAlarmFallingThreshold,
                        snmpAlarmRisingEventIndex,
                        snmpAlarmFallingEventIndex,
                        snmpAlarmUnavailableEventIndex,
                        snmpAlarmStatus }
              STATUS  current
              DESCRIPTION
                      "A collection of objects allowing the description
                      and configuration of threshold alarms from an
                      SNMPv2 entity acting in a dual role."
              ::= { snmpM2M 2 }
          
          -- This Alarm mechanism periodically takes statistical samples
          -- from variables available via SNMPv2 and compares them to
          -- thresholds that have been configured.  The alarm table
          -- stores configuration entries that each define a variable,
          -- polling period, and threshold parameters.  If a sample is
          -- found to cross the threshold values, an event is generated.
          -- Only variables that resolve to an ASN.1 primitive type of
          -- INTEGER (Integer32, Counter32, Gauge32, TimeTicks, or
          -- Counter64) may be monitored in this way.
          --
          -- This function has a hysteresis mechanism to limit the
          -- generation of events.  This mechanism generates one event
          -- as a threshold is crossed in the appropriate direction.  No
          -- more events are generated for that threshold until the
          -- opposite threshold is crossed.
          --
          -- In the case of sampling a deltaValue, an entity may
          -- implement this mechanism with more precision if it takes a
          -- delta sample twice per period, each time comparing the sum
          -- of the latest two samples to the threshold.  This allows
          -- the detection of threshold crossings that span the sampling
          -- boundary.  Note that this does not require any special
          -- configuration of the threshold value.  It is suggested that
          -- entities implement this more precise algorithm.
          --
          
          
          
          
          
          
                               Expires May 12, 1993             [Page 7]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          snmpAlarmNextIndex OBJECT-TYPE
              SYNTAX     INTEGER (1..65535)
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The index number of the next appropriate
                      unassigned entry in the snmpAlarmTable.
          
                      A management station should create new entries in
                      the snmpAlarmTable using this algorithm: first,
                      issue a management protocol retrieval operation to
                      determine the value of snmpAlarmNextIndex; and,
                      second, issue a management protocol set operation
                      to create an instance of the snmpAlarmStatus
                      object setting its value to
                      `underConstruction(2)'.  If this latter operation
                      succeeds, then the management station may continue
                      modifying the instances corresponding to the newly
                      created conceptual row, without fear of collision
                      with other management stations."
              ::= { snmpAlarm 1 }
          
          snmpAlarmTable OBJECT-TYPE
              SYNTAX     SEQUENCE OF SnmpAlarmEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A list of snmpAlarm entries."
              ::= { snmpAlarm 2 }
          
          snmpAlarmEntry OBJECT-TYPE
              SYNTAX     SnmpAlarmEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A list of parameters that set up a periodic
                      sampling query to check for alarm conditions.  The
                      partyIdentity included in the INDEX clause is the
                      sampling destination party, i.e., the party to
                      which the sampling queries are directed."
              INDEX      { partyIdentity, snmpAlarmIndex }
              ::= { snmpAlarmTable 1 }
          
          SnmpAlarmEntry ::= SEQUENCE {
              snmpAlarmIndex                    INTEGER,
          
          
          
          
          
                               Expires May 12, 1993             [Page 8]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              snmpAlarmSourcePartyID            Party,
              snmpAlarmVariable                 InstancePointer,
              snmpAlarmInterval                 Integer32,
              snmpAlarmSampleType               INTEGER,
              snmpAlarmValue                    Integer32,
              snmpAlarmStartupAlarm             INTEGER,
              snmpAlarmRisingThreshold          Integer32,
              snmpAlarmFallingThreshold         Integer32,
              snmpAlarmRisingEventIndex         INTEGER,
              snmpAlarmFallingEventIndex        INTEGER,
              snmpAlarmUnavailableEventIndex    INTEGER,
              snmpAlarmStatus                   RowStatus
          }
          
          snmpAlarmIndex OBJECT-TYPE
              SYNTAX     INTEGER (1..65535)
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "An index that uniquely identifies an entry in the
                      snmpAlarm table for a particular sampling
                      destination party.  Each such entry defines a
                      diagnostic sample at a particular interval for a
                      variable in the particular party's MIB view."
              ::= { snmpAlarmEntry 1 }
          
          snmpAlarmSourcePartyID OBJECT-TYPE
              SYNTAX     Party
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The sampling source party, i.e., the source party
                      to be used to query the variable's value.  This
                      party must be local to the SNMPv2 entity acting in
                      a dual role."
              ::= { snmpAlarmEntry 2 }
          
          snmpAlarmVariable OBJECT-TYPE
              SYNTAX     InstancePointer
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The object identifier of the particular variable
                      to be sampled.  Only variables that resolve to an
                      ASN.1 primitive type of INTEGER (Integer32,
          
          
          
          
          
                               Expires May 12, 1993             [Page 9]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      Counter32, Gauge32, TimeTicks, or Counter64) may
                      be sampled.
          
                      If it is detected by an error response of
                      authorizationError, noSuchObject, or
                      noSuchInstance that the variable name of an
                      established snmpAlarmEntry is no longer available
                      to the sampling destination party, a single
                      snmpObjectUnavailableAlarm event is generated and
                      the status of this snmpAlarmEntry is changed to
                      `underDestruction(3)'.  Likewise, if the syntax of
                      the variable retrieved by the query is not
                      Integer32, Counter32, Gauge32, TimeTicks, or
                      Counter64, the same actions will be taken.
          
                      If the SNMPv2 entity acting in a dual role detects
                      that the sampled value can not be obtained due to
                      lack of response to management queries, it should
                      set the status of this snmpAlarmEntry to
                      `underDestruction(3)' if it is determined that
                      further communication is not possible; or delete
                      the associated snmpAlarmValue instance (but not
                      the entire conceptual row) and continue to attempt
                      to sample the variable and recreate the associated
                      snmpAlarmValue instance should communication be
                      reestablished.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 3 }
          
          snmpAlarmInterval OBJECT-TYPE
              SYNTAX     Integer32
              UNITS      "seconds"
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The interval in seconds over which the data is
                      sampled and compared with the rising and falling
                      thresholds.  When setting this object and the
                      sampling type is `deltaValue(2)',  care should be
                      taken to ensure that the change during this
          
          
          
          
          
                               Expires May 12, 1993            [Page 10]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      interval of the variable being sampled will not
                      exceed the (-2^31...2^31-1) range of the
                      snmpAlarmValue.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 4 }
          
          snmpAlarmSampleType OBJECT-TYPE
              SYNTAX     INTEGER {
                             absoluteValue(1),
                             deltaValue(2)
                         }
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The method of sampling the selected variable and
                      calculating the value to be compared against the
                      thresholds.  If the value of this object is
                      `absoluteValue(1)', the value of the selected
                      variable at the end of the sampling interval will
                      be compared directly with both the
                      snmpAlarmRisingThreshold and the
                      snmpAlarmFallingThreshold values.  If the value of
                      this object is `deltaValue(2)', the value of the
                      selected variable at the end of the sampling
                      interval will be subtracted from its value at the
                      end of the previous sampling interval, and the
                      difference compared with both the
                      snmpAlarmRisingThreshold and the
                      snmpAlarmFallingThreshold values.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              DEFVAL { deltaValue }
              ::= { snmpAlarmEntry 5 }
          
          snmpAlarmValue OBJECT-TYPE
              SYNTAX     Integer32
          
          
          
          
          
                               Expires May 12, 1993            [Page 11]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The value of the statistic during the last
                      sampling period.  The value during the current
                      sampling period is not made available until the
                      period is completed.  If the value of the
                      statistic does not fit in the signed 32 bit
                      representation of this object, it should be
                      truncated in an implementation specific manner.
          
                      Note that if the associated snmpAlarmSampleType is
                      set to `deltaValue(2)', the value of this object
                      is the difference in the sampled variable since
                      the last sample.
          
                      This object will be created by the SNMPv2 entity
                      acting in a dual role when this entry is set to
                      `active(1)', and the first sampling period has
                      completed.  It may be created and deleted at other
                      times by the SNMPv2 entity acting in a dual role
                      when the sampled value can not be obtained, as
                      specified in the snmpAlarmVariable object."
              ::= { snmpAlarmEntry 6 }
          
          snmpAlarmStartupAlarm OBJECT-TYPE
              SYNTAX     INTEGER {
                             risingAlarm(1),
                             fallingAlarm(2),
                             risingOrFallingAlarm(3)
                         }
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The alarm that may be sent when this entry is
                      first set to `active(1)'.  If the first sample
                      after this entry becomes active is greater than or
                      equal to the risingThreshold and
                      snmpAlarmStartupAlarm is equal to `risingAlarm(1)'
                      or `risingOrFallingAlarm(3)', then a single rising
                      alarm will be generated.  If the first sample
                      after this entry becomes active is less than or
                      equal to the fallingThreshold and
                      snmpAlarmStartupAlarm is equal to
                      `fallingAlarm(2)' or `risingOrFallingAlarm(3)',
          
          
          
          
          
                               Expires May 12, 1993            [Page 12]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      then a single falling alarm will be generated.
                      Note that an snmpObjectUnavailableAlarm is sent
                      upon startup whenever it is applicable,
                      independent of the setting of
                      snmpAlarmStartupAlarm.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              DEFVAL { risingOrFallingAlarm }
              ::= { snmpAlarmEntry 7 }
          
          snmpAlarmRisingThreshold OBJECT-TYPE
              SYNTAX     Integer32
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "A threshold for the sampled statistic.  When the
                      current sampled value is greater than or equal to
                      this threshold, and the value at the last sampling
                      interval was less than this threshold, a single
                      event will be generated.  A single event will also
                      be generated if the first sample after this entry
                      becomes active is greater than or equal to this
                      threshold and the associated snmpAlarmStartupAlarm
                      is equal to `risingAlarm(1)' or
                      `risingOrFallingAlarm(3)'.
          
                      After a rising event is generated, another such
                      event will not be generated until the sampled
                      value falls below this threshold and reaches the
                      snmpAlarmFallingThreshold.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 8 }
          
          snmpAlarmFallingThreshold OBJECT-TYPE
              SYNTAX     Integer32
              MAX-ACCESS read-create
          
          
          
          
          
                               Expires May 12, 1993            [Page 13]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              STATUS     current
              DESCRIPTION
                      "A threshold for the sampled statistic.  When the
                      current sampled value is less than or equal to
                      this threshold, and the value at the last sampling
                      interval was greater than this threshold, a single
                      event will be generated.  A single event will also
                      be generated if the first sample after this entry
                      becomes active is less than or equal to this
                      threshold and the associated snmpAlarmStartupAlarm
                      is equal to `fallingAlarm(2)' or
                      `risingOrFallingAlarm(3)'.
          
                      After a falling event is generated, another such
                      event will not be generated until the sampled
                      value rises above this threshold and reaches the
                      snmpAlarmRisingThreshold.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 9 }
          
          snmpAlarmRisingEventIndex OBJECT-TYPE
              SYNTAX     INTEGER (0..65535)
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The index of the snmpEventEntry that is used when
                      a rising threshold is crossed.  The snmpEventEntry
                      identified by a particular value of this index is
                      the same as identified by the same value of the
                      snmpEventIndex object.  If there is no
                      corresponding entry in the snmpEventTable, then no
                      association exists.  In particular, if this value
                      is zero, no associated event will be generated, as
                      zero is not a valid snmpEventIndex.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
          
          
          
          
          
                               Expires May 12, 1993            [Page 14]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              ::= { snmpAlarmEntry 10 }
          
          snmpAlarmFallingEventIndex OBJECT-TYPE
              SYNTAX     INTEGER (0..65535)
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The index of the snmpEventEntry that is used when
                      a falling threshold is crossed.  The
                      snmpEventEntry identified by a particular value of
                      this index is the same as identified by the same
                      value of the snmpEventIndex object.  If there is
                      no corresponding entry in the snmpEventTable, then
                      no association exists.  In particular, if this
                      value is zero, no associated event will be
                      generated, as zero is not a valid snmpEventIndex.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 11 }
          
          snmpAlarmUnavailableEventIndex OBJECT-TYPE
              SYNTAX     INTEGER (0..65535)
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The index of the snmpEventEntry that is used when
                      a variable becomes unavailable.  The
                      snmpEventEntry identified by a particular value of
                      this index is the same as identified by the same
                      value of the snmpEventIndex object.  If there is
                      no corresponding entry in the snmpEventTable, then
                      no association exists.  In particular, if this
                      value is zero, no associated event will be
                      generated, as zero is not a valid snmpEventIndex.
          
                      An attempt to modify this object will fail with an
                      `inconsistentValue' error if the associated
                      snmpAlarmStatus object would be equal to
                      `active(1)' both before and after the modification
                      attempt."
              ::= { snmpAlarmEntry 12 }
          
          
          
          
          
                               Expires May 12, 1993            [Page 15]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          snmpAlarmStatus OBJECT-TYPE
              SYNTAX     RowStatus
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The status of this snmpAlarm entry.  This object
                      may not be set to `active(1)' unless the following
                      columnar objects exist in this row:
                      snmpAlarmSourcePartyID, snmpAlarmVariable,
                      snmpAlarmInterval, snmpAlarmSampleType,
                      snmpAlarmStartupAlarm, snmpAlarmRisingThreshold,
                      snmpAlarmFallingThreshold,
                      snmpAlarmRisingEventIndex,
                      snmpAlarmFallingEventIndex, and
                      snmpAlarmUnavailableEventIndex."
              ::= { snmpAlarmEntry 13 }
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 16]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          -- alarm-related notifications                                  |
          
          snmpAlarmNotifications OBJECT IDENTIFIER ::= { snmpAlarm 3 }    |
          
          snmpRisingAlarm NOTIFICATION-TYPE                               |
              OBJECTS { snmpAlarmVariable, snmpAlarmSampleType, snmpAlarmValue,
                        snmpAlarmRisingThreshold }
              STATUS  current
              DESCRIPTION
                      "An event that is generated when an alarm entry
                      crosses its rising threshold.  The instances of
                      those objects contained within the varbind list
                      are those of the alarm entry which generated this
                      event."
              ::= { snmpAlarmNotifications 1 }                            |
          
          snmpFallingAlarm NOTIFICATION-TYPE                              |
              OBJECTS { snmpAlarmVariable, snmpAlarmSampleType, snmpAlarmValue,
                        snmpAlarmFallingThreshold }
              STATUS  current
              DESCRIPTION
                      "An event that is generated when an alarm entry
                      crosses its falling threshold.  The instances of
                      those objects contained within the varbind list
                      are those of the alarm entry which generated this
                      event."
              ::= { snmpAlarmNotifications 2 }                            |
          
          snmpObjectUnavailableAlarm NOTIFICATION-TYPE                    |
              OBJECTS { snmpAlarmVariable }
              STATUS  current
              DESCRIPTION
                      "An event that is generated when a variable
                      monitored by an alarm entry becomes unavailable.
                      The instance of snmpAlarmVariable contained within
                      the varbind list is the one associated with the
                      alarm entry which generated this event."
              ::= { snmpAlarmNotifications 3 }                            |
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 17]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          -- the event group                                              -
          snmpEvent OBJECT-GROUP
              OBJECTS { snmpEventNextIndex,                               |
                        snmpEventID, snmpEventDescription,
                        snmpEventEvents, snmpEventLastTimeSent,
                        snmpEventStatus, snmpEventNotifyMinInterval,
                        snmpEventNotifyMaxRetransmissions,
                        snmpEventNotifySrcParty,
                        snmpEventNotifyIntervalRequested,
                        snmpEventNotifyRetransmissionsRequested,
                        snmpEventNotifyLifetime, snmpEventNotifyStatus }
              STATUS  current
              DESCRIPTION
                      "A collection of objects allowing the description
                      and configuration of events from an SNMPv2 entity
                      acting in a dual role."
              ::= { snmpM2M 3 }
          
          -- The snmpEvent table defines the set of events generated on a SNMPv2
          -- entity acting in a dual role.  Each entry in the snmpEventTable
          -- associates an event type with the notification method and
          -- associated parameters.  Some snmpEvent entries are fired by an
          -- associated condition in the snmpAlarmTable.  Others are
          -- fired on behalf of conditions defined in the NOTIFICATION-TYPE|
          -- macro.  The snmpNotificationTable defines notifications that
          -- should occur when an associated event is fired.
          
          snmpEventNextIndex OBJECT-TYPE
              SYNTAX     INTEGER (1..65535)
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The index number of the next appropriate
                      unassigned entry in the snmpEventTable.
          
                      A management station should create new entries in
                      the snmpEventTable using this algorithm: first,
                      issue a management protocol retrieval operation to
                      determine the value of snmpEventNextIndex; and,
                      second, issue a management protocol set operation
                      to create an instance of the snmpEventStatus
                      object setting its value to
                      `underConstruction(2)'.  If this latter operation
                      succeeds, then the management station may continue
                      modifying the instances corresponding to the newly
          
          
          
          
          
                               Expires May 12, 1993            [Page 18]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      created conceptual row, without fear of collision
                      with other management stations."
              ::= { snmpEvent 1 }
          
          snmpEventTable OBJECT-TYPE
              SYNTAX     SEQUENCE OF SnmpEventEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A list of events."
              ::= { snmpEvent 2 }
          
          snmpEventEntry OBJECT-TYPE
              SYNTAX     SnmpEventEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A set of parameters that describe an event that
                      is generated when certain conditions are met."
              INDEX      { snmpEventIndex }
              ::= { snmpEventTable 1 }
          
          SnmpEventEntry ::= SEQUENCE {
              snmpEventIndex          INTEGER,
              snmpEventID             OBJECT IDENTIFIER,
              snmpEventDescription    DisplayString,
              snmpEventEvents         Counter32,
              snmpEventLastTimeSent   TimeStamp,
              snmpEventStatus         RowStatus
          }
          
          snmpEventIndex OBJECT-TYPE
              SYNTAX     INTEGER (1..65535)
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "An index that uniquely identifies an entry in the
                      snmpEvent table.  Each such entry defines an event
                      generated when the appropriate conditions occur."
              ::= { snmpEventEntry 1 }
          
          snmpEventID OBJECT-TYPE
              SYNTAX     OBJECT IDENTIFIER
              MAX-ACCESS read-create
              STATUS     current
          
          
          
          
          
                               Expires May 12, 1993            [Page 19]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              DESCRIPTION
                      "The authoritative identification of the event
                      type generated by this entry.  This variable
                      occurs as the first varbind of an InformRequest-
                      PDU.  If this OBJECT IDENTIFIER maps to a           |
                      NOTIFICATION-TYPE the sender will place the         |
                      objects listed in the NOTIFICATION-TYPE in the      |
                      varbind list."
              ::= { snmpEventEntry 2 }
          
          snmpEventDescription OBJECT-TYPE
              SYNTAX     DisplayString (SIZE (0..127))
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "A comment describing this snmpEvent entry."
              ::= { snmpEventEntry 3 }
          
          snmpEventEvents OBJECT-TYPE
              SYNTAX     Counter32
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The number of events caused by event generators
                      associated with this snmpEvent entry."
              ::= { snmpEventEntry 4 }
          
          snmpEventLastTimeSent OBJECT-TYPE
              SYNTAX     TimeStamp
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The value of sysUpTime at the time this snmpEvent
                      entry last generated an event.  If this entry has
                      not generated any events, this value will be
                      zero."
              DEFVAL { 0 }
              ::= { snmpEventEntry 5 }
          
          snmpEventStatus OBJECT-TYPE
              SYNTAX     RowStatus
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The status of this snmpEvent entry.  This object
          
          
          
          
          
                               Expires May 12, 1993            [Page 20]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      may not be set to `active(1)' unless the following
                      columnar objects exist in this row: snmpEventID,
                      snmpEventDescription, snmpEventEvents, and
                      snmpEventLastTimeSent.
          
                      Setting an instance of this object to the value
                      any/all entries in the snmpEventTable, and the
                      snmpEventNotifyTable which reference the
                      corresponding snmpEventEntry."
              ::= { snmpEventEntry 6 }
          
          snmpEventNotifyMinInterval OBJECT-TYPE
              SYNTAX     Integer32
              UNITS      "seconds"
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The minimum interval that the SNMPv2 entity
                      acting in a dual role will wait before
                      retransmitting an InformRequest-PDU.  This object
                      specifies the minimal value supported by the
                      SNMPv2 entity acting in a dual role, based on
                      resource or implementation constraints.
          
                      For a particular entry in the
                      snmpEventNotifyTable, if the associated
                      snmpEventNotifyIntervalRequested variable is
                      greater than this object, the
                      snmpEventNotifyIntervalRequested value shall be
                      used as the minimum interval for retransmissions
                      of InformRequest-PDUs sent on behalf of that
                      entry."
              ::= { snmpEvent 3 }
          
          snmpEventNotifyMaxRetransmissions OBJECT-TYPE
              SYNTAX     Integer32
              MAX-ACCESS read-only
              STATUS     current
              DESCRIPTION
                      "The maximum number of time that the SNMPv2 entity
                      acting in a dual role will retransmit an
                      InformRequest-PDU.  This object specifies the
                      maximal value supported by the SNMPv2 entity
                      acting in a dual role, based on resource or
                      implementation constraints.
          
          
          
          
          
                               Expires May 12, 1993            [Page 21]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
                      For a particular entry in the
                      snmpEventNotifyTable, if the associated
                      snmpEventNotifyRetransmissionsRequested variable
                      is less than this object, the
                      snmpEventNotifyRetransmissionsRequested value
                      shall be used as the retransmission count for
                      InformRequest-PDUs sent on behalf of that entry."
              ::= { snmpEvent 4 }
          
          -- The snmpEventNotifyTable is used to configure the
          -- destination and type of notifications sent by an SNMPv2
          -- entity acting in a manager role when a particular event
          -- is triggered.
          
          snmpEventNotifyTable OBJECT-TYPE
              SYNTAX     SEQUENCE OF SnmpEventNotifyEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A list of protocol configuration entries for
                      event notifications from this entity."
              ::= { snmpEvent 5 }
          
          snmpEventNotifyEntry OBJECT-TYPE
              SYNTAX     SnmpEventNotifyEntry
              MAX-ACCESS not-accessible
              STATUS     current
              DESCRIPTION
                      "A set of parameters that describe the type and
                      destination of InformRequest-PDUs sent for a
                      particular event.  The snmpEventIndex in this
                      entry's INDEX clause identifies the snmpEventEntry
                      which, when triggered, will generate a
                      notification as configured in this entry.  The
                      partyIdentity in this entry's INDEX clause
                      identifies the destination party to which a
                      notification will be sent."
              INDEX      { snmpEventIndex, partyIdentity }
              ::= { snmpEventNotifyTable 1 }
          
          SnmpEventNotifyEntry ::= SEQUENCE {
              snmpEventNotifySrcParty                 Party,
              snmpEventNotifyIntervalRequested        Integer32,
              snmpEventNotifyRetransmissionsRequested Integer32,
              snmpEventNotifyLifetime                 Integer32,
          
          
          
          
          
                               Expires May 12, 1993            [Page 22]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
              snmpEventNotifyStatus                   RowStatus
          }
          
          snmpEventNotifySrcParty OBJECT-TYPE
              SYNTAX     Party
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The source party to be used to send the
                      InformRequest-PDU."
              ::= { snmpEventNotifyEntry 1 }
          
          snmpEventNotifyIntervalRequested OBJECT-TYPE
              SYNTAX     Integer32
              UNITS      "seconds"
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The requested interval for retransmission of
                      Inform PDUs generated on the behalf of this entry.
          
                      This variable will be the actual interval used
                      unless the snmpEventNotifyMinInterval is greater
                      than this object, in which case the interval shall
                      be equal to snmpEventNotifyMinInterval."
              DEFVAL { 30 }
              ::= { snmpEventNotifyEntry 2 }
          
          snmpEventNotifyRetransmissionsRequested OBJECT-TYPE
              SYNTAX     Integer32
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The requested number of retransmissions of an
                      InformRequest-PDU generated on behalf of this
                      entry.
          
                      This variable will be the actual number of
                      retransmissions used unless the
                      snmpEventNotifyMaxRetransmissions is less than
                      this object, in which case the retransmission
                      count shall be equal to
                      snmpEventNotifyMaxRetransmissions."
              DEFVAL { 5 }
              ::= { snmpEventNotifyEntry 3 }
          
          
          
          
          
                               Expires May 12, 1993            [Page 23]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          snmpEventNotifyLifetime OBJECT-TYPE
              SYNTAX     Integer32
              UNITS      "seconds"
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The number of seconds this entry shall live until
                      it is put into the underDestruction state.  This
                      value shall count down to zero, at which time the
                      status of this entry will be changed to
                      underDestruction.  Any management station that is
                      using this entry must periodically refresh this
                      value to ensure the continued delivery of events."
              DEFVAL { 86400 }
              ::= { snmpEventNotifyEntry 4 }
          
          snmpEventNotifyStatus OBJECT-TYPE
              SYNTAX     RowStatus
              MAX-ACCESS read-create
              STATUS     current
              DESCRIPTION
                      "The state of this snmpEventNotifyEntry.  This
                      object may not be set to `active(1)' unless the
                      following columnar objects exist in this row:
                      snmpEventNotifySrcParty,
                      snmpEventNotifyIntervalRequested,
                      snmpEventNotifyRetransmissionsRequested, and
                      snmpEventNotifyLifetime."
              ::= { snmpEventNotifyEntry 5 }
          
          END
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 24]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          5.  Acknowledgements
          
          The comments of the SNMP version 2 working group are
          gratefully acknowledged:
          
               Steve Alexander, Interactive Systems
               Uri Blumenthal, International Business Machines
               Jeffrey D. Case, SNMP Research, Inc.
               Tracy Cox, Bellcore
               James R. (Chuck) Davin, Bellcore
               Mike Davison, FiberCom
               Taso N. Devetzis, Bellcore
               Gary W. Haney, Martin Marietta Energy Systems
               Matt Hecht, SNMP Research, Inc.
               Susan E. Hicks, Martin Marietta Energy Systems
               Satish Joshi, SynOptics
               Mark Kepke, Hewlett-Packard
               Ken Key, SNMP Research, Inc.
               Michael Kornegay, Visisoft
               Deidre C. Kostick, Bellcore
               Cheryl Krupczak, Georgia Tech
               Robert C. Lushbaugh, Martin Marietta Energy Systems
               Keith McCloghrie, Hughes LAN Systems
               Dave Minnich, FiberCom
               Dave Perkins, SynOptics
               Marshall T. Rose, Dover Beach Consulting, Inc.
               Shawn A. Routhier, Epilogue Technology
               Jon Saperia, Digital Equipment Corporation
               Bob Stewart, Xyplex (chair)
               Robert Synder, Cisco Systems
               Maurice Turcotte, Racal Datacom
               Steven L. Waldbusser, Carnegie Mellon University
               Bert Wijnen, International Business Machines
               Peter Wilson, 3Com
               Steven Wong, Digital Equipment Corporation
               Chris Young, Cabletron
               Kiho Yum, 3Com
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 25]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          6.  References
          
          [1]  Information processing systems - Open Systems
               Interconnection - Specification of Abstract Syntax
               Notation One (ASN.1), International Organization for
               Standardization.  International Standard 8824, (December,
               1987).
          
          [2]  J.D. Case, K. McCloghrie, M.T. Rose, S.L. Waldbusser,
               Structure of Management Information for version 2 of the
               Simple Network Management Protocol, Internet-Draft,
               (October 7, 1992).
          
          [3]  J.D. Case, K. McCloghrie, M.T. Rose, S.L. Waldbusser,
               Protocol Operations for version 2 of the Simple Network
               Management Protocol (SNMPv2), Internet-Draft, (October 7,
               1992).
          
          [4]  J.R. Davin, J.M. Galvin, K. McCloghrie, SNMP
               Administrative Model.  Request for Comments 1351, (July,
               1992).
          
          [5]  K. McCloghrie, J.R. Davin, J.M. Galvin, Definitions of
               Managed Objects for Administration of SNMP Parties.
               Request for Comments 1353, (July, 1992).
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 26]
          

          Draft               Manager to Manager MIB              Oct 92
          
          
          Table of Contents
          
          
          1 Status of this Memo ...................................    1
          2 Introduction ..........................................    2
          2.1 A Note on Terminology ...............................    2
          3 Overview ..............................................    3
          3.1 A SNMPv2 Entity Acting in a Dual Role ...............    3
          3.2 Alarms, Events, and Notifications ...................    3
          3.3 Access Control ......................................    4
          4 Definitions ...........................................    6
          3.1 The Alarm Group .....................................    7
          3.1.2 Alarm-Related Notifications .......................   17
          3.2 The Event Group .....................................   18
          5 Acknowledgements ......................................   25
          6 References ............................................   26
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
          
                               Expires May 12, 1993            [Page 27]
          

Html markup produced by rfcmarkup 1.111, available from https://tools.ietf.org/tools/rfcmarkup/