home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 1400s / rfc1451.txt < prev    next >
Text File  |  1993-04-29  |  63KB  |  2,125 lines
  1.  
  2.  
  3.  
  4.           Network Working Group                                  J. Case
  5.           Request for Comments: 1451                 SNMP Research, Inc.
  6.                                                            K. McCloghrie
  7.                                                       Hughes LAN Systems
  8.                                                                  M. Rose
  9.                                             Dover Beach Consulting, Inc.
  10.                                                            S. Waldbusser
  11.                                               Carnegie Mellon University
  12.                                                               April 1993
  13.  
  14.  
  15.                                 Manager-to-Manager
  16.                            Management Information Base
  17.  
  18.  
  19.           Status of this Memo
  20.  
  21.           This RFC specifes an IAB standards track protocol for the
  22.           Internet community, and requests discussion and suggestions
  23.           for improvements.  Please refer to the current edition of the
  24.           "IAB Official Protocol Standards" for the standardization
  25.           state and status of this protocol.  Distribution of this memo
  26.           is unlimited.
  27.  
  28.  
  29.           Table of Contents
  30.  
  31.  
  32.           1 Introduction ..........................................    2
  33.           1.1 A Note on Terminology ...............................    2
  34.           2 Overview ..............................................    3
  35.           2.1 A SNMPv2 Entity Acting in a Dual Role ...............    3
  36.           2.2 Alarms, Events, and Notifications ...................    3
  37.           2.3 Access Control ......................................    4
  38.           3 Definitions ...........................................    6
  39.           3.1 The Alarm Group .....................................    7
  40.           3.1.1 Alarm-Related Notifications .......................   20
  41.           3.2 The Event Group .....................................   21
  42.           3.3 Conformance Information .............................   29
  43.           3.3.1 Compliance Statements .............................   29
  44.           3.3.2 Units of Conformance ..............................   29
  45.           4 Acknowledgements ......................................   31
  46.           5 References ............................................   35
  47.           6 Security Considerations ...............................   36
  48.           7 Authors' Addresses ....................................   36
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           Case, McCloghrie, Rose & Waldbusser                   [Page 1]
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           RFC 1451            Manager-to-Manager MIB          April 1993
  65.  
  66.  
  67.           1.  Introduction
  68.  
  69.           A network management system contains: several (potentially
  70.           many) nodes, each with a processing entity, termed an agent,
  71.           which has access to management instrumentation; at least one
  72.           management station; and, a management protocol, used to convey
  73.           management information between the agents and management
  74.           stations.  Operations of the protocol are carried out under an
  75.           administrative framework which defines both authentication and
  76.           authorization policies.
  77.  
  78.           Network management stations execute management applications
  79.           which monitor and control network elements.  Network elements
  80.           are devices such as hosts, routers, terminal servers, etc.,
  81.           which are monitored and controlled through access to their
  82.           management information.
  83.  
  84.           Management information is viewed as a collection of managed
  85.           objects, residing in a virtual information store, termed the
  86.           Management Information Base (MIB).  Collections of related
  87.           objects are defined in MIB modules.  These modules are written
  88.           using a subset of OSI's Abstract Syntax Notation One (ASN.1)
  89.           [1], termed the Structure of Management Information (SMI) [2].
  90.  
  91.           The management protocol, version 2 of the Simple Network
  92.           Management Protocol [3], provides for the exchange of messages
  93.           which convey management information between the agents and the
  94.           management stations, including between management stations.
  95.           It is the purpose of this document to define managed objects
  96.           which describe the behavior of a SNMPv2 entity acting in both
  97.           a manager role and an agent role.
  98.  
  99.  
  100.           1.1.  A Note on Terminology
  101.  
  102.           For the purpose of exposition, the original Internet-standard
  103.           Network Management Framework, as described in RFCs 1155, 1157,
  104.           and 1212, is termed the SNMP version 1 framework (SNMPv1).
  105.           The current framework is termed the SNMP version 2 framework
  106.           (SNMPv2).
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.           Case, McCloghrie, Rose & Waldbusser                   [Page 2]
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           RFC 1451            Manager-to-Manager MIB          April 1993
  124.  
  125.  
  126.           2.  Overview
  127.  
  128.           The purpose of this MIB is to provide the means for
  129.           coordination between multiple management stations.  That is,
  130.           the means by which the controlling and monitoring functions of
  131.           network management can be distributed amongst multiple
  132.           management stations.  Such distribution facilitates the
  133.           scaling of network management solutions based on the SNMPv2 to
  134.           meet the needs of very large networks, or of networks composed
  135.           of multiple interconnected administrations. Specifically, this
  136.           MIB provides the means for one management station to request
  137.           management services from another management station.
  138.  
  139.  
  140.           2.1.  A SNMPv2 Entity Acting in a Dual Role
  141.  
  142.           A management station providing services to other management
  143.           station(s), is a SNMPv2 entity which acts in the dual role of
  144.           both manager and agent; the requests for service are received
  145.           through acting in an agent role (with respect to the managed
  146.           objects defined in this MIB), and the requested services are
  147.           performed through acting in a manager role.
  148.  
  149.  
  150.           2.2.  Alarms, Events, and Notifications
  151.  
  152.           In this initial version, this MIB defines the concepts of
  153.           "alarms", "events", and "notifications".  Each alarm is a
  154.           specific condition detected through the periodic (at a
  155.           configured sampling interval) monitoring of the value of a
  156.           specific management information variable.  An example of an
  157.           alarm condition is when the monitored variable falls outside a
  158.           configured range.  Each alarm condition triggers an event, and
  159.           each event can cause (one or more) notifications to be
  160.           reported to other management stations using the Inform-Request
  161.           PDU.
  162.  
  163.           Specifically, this MIB defines three MIB tables and a number
  164.           of scalar objects.  The three tables are: the Alarm Table, the
  165.           Event Table, and the Notification Table.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.           Case, McCloghrie, Rose & Waldbusser                   [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182.           RFC 1451            Manager-to-Manager MIB          April 1993
  183.  
  184.  
  185.           2.3.  Access Control
  186.  
  187.           The Administrative Model for SNMPv2 document [4] includes an
  188.           access control model, which must not be subverted by allowing
  189.           access to management information variables via the Alarm
  190.           table.  That is, access to a monitored variable via the Alarm
  191.           table must be controlled according to the identity of the
  192.           management station accessing the particular entry in the Alarm
  193.           table.
  194.  
  195.           An entry in the Alarm table provides the means to configure
  196.           the sampling of the value of a MIB variable in the MIB view
  197.           associated with the specified context (which can refer to
  198.           object resources that are either local or remote).  The
  199.           sampling is done by (conceptually or actually) issuing a
  200.           SNMPv2 request to retrieve the variable's value.  This request
  201.           is authenticated and/or protected from disclosure according to
  202.           a source party and a destination party pair which has access
  203.           to the indicated context.
  204.  
  205.           Thus, to provide the required access control, the initial MIB
  206.           view assigned, by convention, to parties on SNMPv2 entities
  207.           that implement the snmpAlarmTable, must include the component:
  208.  
  209.             viewSubtree  = { snmpAlarm }
  210.             viewStatus   = { excluded }
  211.             viewMask     = { ''H }
  212.  
  213.           Then, the MIB view associated with the context,
  214.           requestContext, accessible by a requesting management station,
  215.           can be configured to include specific Alarm table entries --
  216.           the ones associated with those contexts to which the
  217.           requesting management station has access.
  218.  
  219.           In particular, to provide a requestContext with access to the
  220.           sampling context sampleContext, the following family of view
  221.           subtrees would be included for the requestContext on the
  222.           SNMPv2 entity acting in a dual role:
  223.  
  224.                { snmpAlarmEntry WILDCARD sampleContext }
  225.  
  226.           Which would be configured in the party MIB [5] as:
  227.  
  228.             contextIdentity   = { requestContext }
  229.             contextViewIndex  = { ViewIndex }
  230.  
  231.  
  232.  
  233.  
  234.  
  235.           Case, McCloghrie, Rose & Waldbusser                   [Page 4]
  236.  
  237.  
  238.  
  239.  
  240.  
  241.           RFC 1451            Manager-to-Manager MIB          April 1993
  242.  
  243.  
  244.         viewIndex         = { ViewIndex }
  245.         viewSubtree       = { snmpAlarmEntry 0 sampleContext }
  246.         viewStatus        = { included }
  247.         viewMask          = { 'FFEF'H } -- specifies wildcard for column
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.           Case, McCloghrie, Rose & Waldbusser                   [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300.           RFC 1451            Manager-to-Manager MIB          April 1993
  301.  
  302.  
  303.           3.  Definitions
  304.  
  305.           SNMPv2-M2M-MIB DEFINITIONS ::= BEGIN
  306.  
  307.           IMPORTS
  308.               MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  309.               Integer32, Counter32, snmpModules
  310.                   FROM SNMPv2-SMI
  311.               DisplayString, InstancePointer, RowStatus, TimeStamp
  312.                   FROM SNMPv2-TC
  313.               MODULE-COMPLIANCE, OBJECT-GROUP
  314.                   FROM SNMPv2-CONF
  315.               contextIdentity
  316.                   FROM SNMPv2-PARTY-MIB;
  317.  
  318.  
  319.           snmpM2M MODULE-IDENTITY
  320.               LAST-UPDATED "9304010000Z"
  321.               ORGANIZATION "IETF SNMPv2 Working Group"
  322.               CONTACT-INFO
  323.                       "        Steven Waldbusser
  324.  
  325.                        Postal: Carnegie Mellon University
  326.                                4910 Forbes Ave
  327.                                Pittsburgh, PA  15213
  328.  
  329.                           Tel: +1 412 268 6628
  330.                           Fax: +1 412 268 4987
  331.  
  332.                        E-mail: waldbusser@cmu.edu"
  333.               DESCRIPTION
  334.                       "The Manager-to-Manager MIB module."
  335.               ::= { snmpModules 2 }
  336.  
  337.  
  338.           snmpM2MObjects OBJECT IDENTIFIER ::= { snmpM2M 1 }
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.           Case, McCloghrie, Rose & Waldbusser                   [Page 6]
  354.  
  355.  
  356.  
  357.  
  358.  
  359.           RFC 1451            Manager-to-Manager MIB          April 1993
  360.  
  361.  
  362.           -- the alarm group
  363.           --
  364.           -- a collection of objects allowing the description and
  365.           -- configuration of threshold alarms from a SNMPv2 entity
  366.           -- acting in a dual role.
  367.  
  368.           snmpAlarm      OBJECT IDENTIFIER ::= { snmpM2MObjects 1 }
  369.  
  370.           -- This Alarm mechanism periodically takes statistical samples
  371.           -- from variables available via SNMPv2 and compares them to
  372.           -- thresholds that have been configured.  The alarm table
  373.           -- stores configuration entries that each define a variable,
  374.           -- polling period, and threshold parameters.  If a sample is
  375.           -- found to cross the threshold values, an event is generated.
  376.           -- Only variables that resolve to an ASN.1 primitive type of
  377.           -- INTEGER (Integer32, Counter32, Gauge32, TimeTicks,
  378.           -- Counter64, or UInteger32) may be monitored in this way.
  379.           --
  380.           -- This function has a hysteresis mechanism to limit the
  381.           -- generation of events.  This mechanism generates one event
  382.           -- as a threshold is crossed in the appropriate direction.  No
  383.           -- more events are generated for that threshold until the
  384.           -- opposite threshold is crossed.
  385.           --
  386.           -- In the case of sampling a deltaValue, an entity may
  387.           -- implement this mechanism with more precision if it takes a
  388.           -- delta sample twice per period, each time comparing the sum
  389.           -- of the latest two samples to the threshold.  This allows
  390.           -- the detection of threshold crossings that span the sampling
  391.           -- boundary.  Note that this does not require any special
  392.           -- configuration of the threshold value.  It is suggested that
  393.           -- entities implement this more precise algorithm.
  394.           --
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.           Case, McCloghrie, Rose & Waldbusser                   [Page 7]
  413.  
  414.  
  415.  
  416.  
  417.  
  418.           RFC 1451            Manager-to-Manager MIB          April 1993
  419.  
  420.  
  421.           snmpAlarmNextIndex OBJECT-TYPE
  422.               SYNTAX     INTEGER (0..65535)
  423.               MAX-ACCESS read-only
  424.               STATUS     current
  425.               DESCRIPTION
  426.                       "The index number of the next appropriate
  427.                       unassigned entry in the snmpAlarmTable.  The value
  428.                       0 indicates that no unassigned entries are
  429.                       available.
  430.  
  431.                       A management station should create new entries in
  432.                       the snmpAlarmTable using this algorithm: first,
  433.                       issue a management protocol retrieval operation to
  434.                       determine the value of snmpAlarmNextIndex; and,
  435.                       second, issue a management protocol set operation
  436.                       to create an instance of the snmpAlarmStatus
  437.                       object setting its value to `createAndGo' or
  438.                       `createAndWait' (as specified in the description
  439.                       of the RowStatus textual convention)."
  440.               ::= { snmpAlarm 1 }
  441.  
  442.           snmpAlarmTable OBJECT-TYPE
  443.               SYNTAX     SEQUENCE OF SnmpAlarmEntry
  444.               MAX-ACCESS not-accessible
  445.               STATUS     current
  446.               DESCRIPTION
  447.                       "A list of snmpAlarm entries."
  448.               ::= { snmpAlarm 2 }
  449.  
  450.           snmpAlarmEntry OBJECT-TYPE
  451.               SYNTAX     SnmpAlarmEntry
  452.               MAX-ACCESS not-accessible
  453.               STATUS     current
  454.               DESCRIPTION
  455.                       "A list of parameters that set up a periodic
  456.                       sampling query to check for alarm conditions.  The
  457.                       contextIdentity included in the INDEX clause is
  458.                       the context to which the sampling queries are
  459.                       directed."
  460.               INDEX      { contextIdentity, snmpAlarmIndex }
  461.               ::= { snmpAlarmTable 1 }
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.           Case, McCloghrie, Rose & Waldbusser                   [Page 8]
  472.  
  473.  
  474.  
  475.  
  476.  
  477.           RFC 1451            Manager-to-Manager MIB          April 1993
  478.  
  479.  
  480.           SnmpAlarmEntry ::= SEQUENCE {
  481.               snmpAlarmIndex                    INTEGER,
  482.               snmpAlarmVariable                 InstancePointer,
  483.               snmpAlarmInterval                 Integer32,
  484.               snmpAlarmSampleType               INTEGER,
  485.               snmpAlarmValue                    Integer32,
  486.               snmpAlarmStartupAlarm             INTEGER,
  487.               snmpAlarmRisingThreshold          Integer32,
  488.               snmpAlarmFallingThreshold         Integer32,
  489.               snmpAlarmRisingEventIndex         INTEGER,
  490.               snmpAlarmFallingEventIndex        INTEGER,
  491.               snmpAlarmUnavailableEventIndex    INTEGER,
  492.               snmpAlarmStatus                   RowStatus
  493.           }
  494.  
  495.           snmpAlarmIndex OBJECT-TYPE
  496.               SYNTAX     INTEGER (1..65535)
  497.               MAX-ACCESS not-accessible
  498.               STATUS     current
  499.               DESCRIPTION
  500.                       "An index that uniquely identifies an entry in the
  501.                       snmpAlarm table for a particular sampling context.
  502.                       Each such entry defines a diagnostic sample at a
  503.                       particular interval for a variable in the
  504.                       particular context's object resources."
  505.               ::= { snmpAlarmEntry 1 }
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.           Case, McCloghrie, Rose & Waldbusser                   [Page 9]
  531.  
  532.  
  533.  
  534.  
  535.  
  536.           RFC 1451            Manager-to-Manager MIB          April 1993
  537.  
  538.  
  539.           snmpAlarmVariable OBJECT-TYPE
  540.               SYNTAX     InstancePointer
  541.               MAX-ACCESS read-create
  542.               STATUS     current
  543.               DESCRIPTION
  544.                       "The object identifier of the particular variable
  545.                       to be sampled.  Only variables that resolve to an
  546.                       ASN.1 primitive type of INTEGER (Integer32,
  547.                       Counter32, Gauge32, TimeTicks, Counter64, or
  548.                       UInteger32) may be sampled.
  549.  
  550.                       If it is detected by an error response of
  551.                       authorizationError, noSuchObject, or
  552.                       noSuchInstance that the variable name of an
  553.                       established snmpAlarmEntry is no longer available
  554.                       in the sampling context, a single
  555.                       snmpObjectUnavailableAlarm event is generated and
  556.                       the status of this snmpAlarmEntry is set to
  557.                       `destroy'.  Likewise, if the syntax of the
  558.                       variable retrieved by the query is not Integer32,
  559.                       Counter32, Gauge32, TimeTicks, Counter64, or
  560.                       UInteger32, the same actions will be taken.
  561.  
  562.                       If the SNMPv2 entity acting in a dual role detects
  563.                       that the sampled value can not be obtained due to
  564.                       lack of response to management queries, it should
  565.                       either:
  566.  
  567.                            1) Set the status of this snmpAlarmEntry to
  568.                            `destroy', if it is determined that further
  569.                            communication is not possible;
  570.  
  571.                            or,
  572.  
  573.                            2) Delete the associated snmpAlarmValue
  574.                            instance (but not the entire conceptual row),
  575.                            and continue to attempt to sample the
  576.                            variable and recreate the associated
  577.                            snmpAlarmValue instance should communication
  578.                            be reestablished.
  579.  
  580.                       An attempt to modify this object will fail with an
  581.                       `inconsistentValue' error if the associated
  582.                       snmpAlarmStatus object would be equal to `active'
  583.                       both before and after the modification attempt."
  584.  
  585.  
  586.  
  587.  
  588.  
  589.           Case, McCloghrie, Rose & Waldbusser                  [Page 10]
  590.  
  591.  
  592.  
  593.  
  594.  
  595.           RFC 1451            Manager-to-Manager MIB          April 1993
  596.  
  597.  
  598.               ::= { snmpAlarmEntry 2 }
  599.  
  600.           snmpAlarmInterval OBJECT-TYPE
  601.               SYNTAX     Integer32
  602.               UNITS      "seconds"
  603.               MAX-ACCESS read-create
  604.               STATUS     current
  605.               DESCRIPTION
  606.                       "The interval in seconds over which the data is
  607.                       sampled and compared with the rising and falling
  608.                       thresholds.  When setting this object and the
  609.                       sampling type is `deltaValue',  care should be
  610.                       taken to ensure that the change during this
  611.                       interval of the variable being sampled will not
  612.                       exceed the (-2^31...2^31-1) range of the
  613.                       snmpAlarmValue.
  614.  
  615.                       An attempt to modify this object will fail with an
  616.                       `inconsistentValue' error if the associated
  617.                       snmpAlarmStatus object would be equal to `active'
  618.                       both before and after the modification attempt."
  619.               ::= { snmpAlarmEntry 3 }
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.           Case, McCloghrie, Rose & Waldbusser                  [Page 11]
  649.  
  650.  
  651.  
  652.  
  653.  
  654.           RFC 1451            Manager-to-Manager MIB          April 1993
  655.  
  656.  
  657.           snmpAlarmSampleType OBJECT-TYPE
  658.               SYNTAX     INTEGER {
  659.                              absoluteValue(1),
  660.                              deltaValue(2)
  661.                          }
  662.               MAX-ACCESS read-create
  663.               STATUS     current
  664.               DESCRIPTION
  665.                       "The method of sampling the selected variable and
  666.                       calculating the value to be compared against the
  667.                       thresholds.  If the value of this object is
  668.                       `absoluteValue', the value of the selected
  669.                       variable at the end of the sampling interval will
  670.                       be compared directly with both the
  671.                       snmpAlarmRisingThreshold and the
  672.                       snmpAlarmFallingThreshold values.  If the value of
  673.                       this object is `deltaValue', the value of the
  674.                       selected variable at the end of the sampling
  675.                       interval will be subtracted from its value at the
  676.                       end of the previous sampling interval, and the
  677.                       difference compared with both the
  678.                       snmpAlarmRisingThreshold and the
  679.                       snmpAlarmFallingThreshold values.
  680.  
  681.                       An attempt to modify this object will fail with an
  682.                       `inconsistentValue' error if the associated
  683.                       snmpAlarmStatus object would be equal to `active'
  684.                       both before and after the modification attempt."
  685.               DEFVAL { deltaValue }
  686.               ::= { snmpAlarmEntry 4 }
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.           Case, McCloghrie, Rose & Waldbusser                  [Page 12]
  708.  
  709.  
  710.  
  711.  
  712.  
  713.           RFC 1451            Manager-to-Manager MIB          April 1993
  714.  
  715.  
  716.           snmpAlarmValue OBJECT-TYPE
  717.               SYNTAX     Integer32
  718.               MAX-ACCESS read-only
  719.               STATUS     current
  720.               DESCRIPTION
  721.                       "The value of the statistic during the last
  722.                       sampling period.  The value during the current
  723.                       sampling period is not made available until the
  724.                       period is completed.  If the value of the
  725.                       statistic does not fit in the signed 32 bit
  726.                       representation of this object, it should be
  727.                       truncated in an implementation specific manner.
  728.  
  729.                       Note that if the associated snmpAlarmSampleType is
  730.                       set to `deltaValue', the value of this object is
  731.                       the difference in the sampled variable since the
  732.                       last sample.
  733.  
  734.                       This object will be created by the SNMPv2 entity
  735.                       acting in a dual role when this entry is set to
  736.                       `active', and the first sampling period has
  737.                       completed.  It may be created and deleted at other
  738.                       times by the SNMPv2 entity acting in a dual role
  739.                       when the sampled value can not be obtained, as
  740.                       specified in the snmpAlarmVariable object."
  741.               ::= { snmpAlarmEntry 5 }
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.           Case, McCloghrie, Rose & Waldbusser                  [Page 13]
  767.  
  768.  
  769.  
  770.  
  771.  
  772.           RFC 1451            Manager-to-Manager MIB          April 1993
  773.  
  774.  
  775.           snmpAlarmStartupAlarm OBJECT-TYPE
  776.               SYNTAX     INTEGER {
  777.                              risingAlarm(1),
  778.                              fallingAlarm(2),
  779.                              risingOrFallingAlarm(3)
  780.                          }
  781.               MAX-ACCESS read-create
  782.               STATUS     current
  783.               DESCRIPTION
  784.                       "The alarm that may be sent when this entry is
  785.                       first set to `active'.  If the first sample after
  786.                       this entry becomes active is greater than or equal
  787.                       to the risingThreshold and snmpAlarmStartupAlarm
  788.                       is equal to `risingAlarm' or
  789.                       `risingOrFallingAlarm', then a single rising alarm
  790.                       will be generated.  If the first sample after this
  791.                       entry becomes active is less than or equal to the
  792.                       fallingThreshold and snmpAlarmStartupAlarm is
  793.                       equal to `fallingAlarm' or `risingOrFallingAlarm',
  794.                       then a single falling alarm will be generated.
  795.                       Note that a snmpObjectUnavailableAlarm is sent
  796.                       upon startup whenever it is applicable,
  797.                       independent of the setting of
  798.                       snmpAlarmStartupAlarm.
  799.  
  800.                       An attempt to modify this object will fail with an
  801.                       `inconsistentValue' error if the associated
  802.                       snmpAlarmStatus object would be equal to `active'
  803.                       both before and after the modification attempt."
  804.               DEFVAL { risingOrFallingAlarm }
  805.               ::= { snmpAlarmEntry 6 }
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.           Case, McCloghrie, Rose & Waldbusser                  [Page 14]
  826.  
  827.  
  828.  
  829.  
  830.  
  831.           RFC 1451            Manager-to-Manager MIB          April 1993
  832.  
  833.  
  834.           snmpAlarmRisingThreshold OBJECT-TYPE
  835.               SYNTAX     Integer32
  836.               MAX-ACCESS read-create
  837.               STATUS     current
  838.               DESCRIPTION
  839.                       "A threshold for the sampled statistic.  When the
  840.                       current sampled value is greater than or equal to
  841.                       this threshold, and the value at the last sampling
  842.                       interval was less than this threshold, a single
  843.                       event will be generated.  A single event will also
  844.                       be generated if the first sample after this entry
  845.                       becomes active is greater than or equal to this
  846.                       threshold and the associated snmpAlarmStartupAlarm
  847.                       is equal to `risingAlarm' or
  848.                       `risingOrFallingAlarm'.
  849.  
  850.                       After a rising event is generated, another such
  851.                       event will not be generated until the sampled
  852.                       value falls below this threshold and reaches the
  853.                       snmpAlarmFallingThreshold.
  854.  
  855.                       An attempt to modify this object will fail with an
  856.                       `inconsistentValue' error if the associated
  857.                       snmpAlarmStatus object would be equal to `active'
  858.                       both before and after the modification attempt."
  859.               ::= { snmpAlarmEntry 7 }
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.           Case, McCloghrie, Rose & Waldbusser                  [Page 15]
  885.  
  886.  
  887.  
  888.  
  889.  
  890.           RFC 1451            Manager-to-Manager MIB          April 1993
  891.  
  892.  
  893.           snmpAlarmFallingThreshold OBJECT-TYPE
  894.               SYNTAX     Integer32
  895.               MAX-ACCESS read-create
  896.               STATUS     current
  897.               DESCRIPTION
  898.                       "A threshold for the sampled statistic.  When the
  899.                       current sampled value is less than or equal to
  900.                       this threshold, and the value at the last sampling
  901.                       interval was greater than this threshold, a single
  902.                       event will be generated.  A single event will also
  903.                       be generated if the first sample after this entry
  904.                       becomes active is less than or equal to this
  905.                       threshold and the associated snmpAlarmStartupAlarm
  906.                       is equal to `fallingAlarm' or
  907.                       `risingOrFallingAlarm'.
  908.  
  909.                       After a falling event is generated, another such
  910.                       event will not be generated until the sampled
  911.                       value rises above this threshold and reaches the
  912.                       snmpAlarmRisingThreshold.
  913.  
  914.                       An attempt to modify this object will fail with an
  915.                       `inconsistentValue' error if the associated
  916.                       snmpAlarmStatus object would be equal to `active'
  917.                       both before and after the modification attempt."
  918.               ::= { snmpAlarmEntry 8 }
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.           Case, McCloghrie, Rose & Waldbusser                  [Page 16]
  944.  
  945.  
  946.  
  947.  
  948.  
  949.           RFC 1451            Manager-to-Manager MIB          April 1993
  950.  
  951.  
  952.           snmpAlarmRisingEventIndex OBJECT-TYPE
  953.               SYNTAX     INTEGER (0..65535)
  954.               MAX-ACCESS read-create
  955.               STATUS     current
  956.               DESCRIPTION
  957.                       "The index of the snmpEventEntry that is used when
  958.                       a rising threshold is crossed.  The snmpEventEntry
  959.                       identified by a particular value of this index is
  960.                       the same as identified by the same value of the
  961.                       snmpEventIndex object.  If there is no
  962.                       corresponding entry in the snmpEventTable, then no
  963.                       association exists.  In particular, if this value
  964.                       is zero, no associated event will be generated, as
  965.                       zero is not a valid snmpEventIndex.
  966.  
  967.                       An attempt to modify this object will fail with an
  968.                       `inconsistentValue' error if the associated
  969.                       snmpAlarmStatus object would be equal to `active'
  970.                       both before and after the modification attempt."
  971.               ::= { snmpAlarmEntry 9 }
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.           Case, McCloghrie, Rose & Waldbusser                  [Page 17]
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.           RFC 1451            Manager-to-Manager MIB          April 1993
  1009.  
  1010.  
  1011.           snmpAlarmFallingEventIndex OBJECT-TYPE
  1012.               SYNTAX     INTEGER (0..65535)
  1013.               MAX-ACCESS read-create
  1014.               STATUS     current
  1015.               DESCRIPTION
  1016.                       "The index of the snmpEventEntry that is used when
  1017.                       a falling threshold is crossed.  The
  1018.                       snmpEventEntry identified by a particular value of
  1019.                       this index is the same as identified by the same
  1020.                       value of the snmpEventIndex object.  If there is
  1021.                       no corresponding entry in the snmpEventTable, then
  1022.                       no association exists.  In particular, if this
  1023.                       value is zero, no associated event will be
  1024.                       generated, as zero is not a valid snmpEventIndex.
  1025.  
  1026.                       An attempt to modify this object will fail with an
  1027.                       `inconsistentValue' error if the associated
  1028.                       snmpAlarmStatus object would be equal to `active'
  1029.                       both before and after the modification attempt."
  1030.               ::= { snmpAlarmEntry 10 }
  1031.  
  1032.           snmpAlarmUnavailableEventIndex OBJECT-TYPE
  1033.               SYNTAX     INTEGER (0..65535)
  1034.               MAX-ACCESS read-create
  1035.               STATUS     current
  1036.               DESCRIPTION
  1037.                       "The index of the snmpEventEntry that is used when
  1038.                       a variable becomes unavailable.  The
  1039.                       snmpEventEntry identified by a particular value of
  1040.                       this index is the same as identified by the same
  1041.                       value of the snmpEventIndex object.  If there is
  1042.                       no corresponding entry in the snmpEventTable, then
  1043.                       no association exists.  In particular, if this
  1044.                       value is zero, no associated event will be
  1045.                       generated, as zero is not a valid snmpEventIndex.
  1046.  
  1047.                       An attempt to modify this object will fail with an
  1048.                       `inconsistentValue' error if the associated
  1049.                       snmpAlarmStatus object would be equal to `active'
  1050.                       both before and after the modification attempt."
  1051.               ::= { snmpAlarmEntry 11 }
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.           Case, McCloghrie, Rose & Waldbusser                  [Page 18]
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.           RFC 1451            Manager-to-Manager MIB          April 1993
  1068.  
  1069.  
  1070.           snmpAlarmStatus OBJECT-TYPE
  1071.               SYNTAX     RowStatus
  1072.               MAX-ACCESS read-create
  1073.               STATUS     current
  1074.               DESCRIPTION
  1075.                       "The status of this snmpAlarm entry.  This object
  1076.                       may not be set to `active' unless the following
  1077.                       columnar objects exist in this row:
  1078.                       snmpAlarmVariable, snmpAlarmInterval,
  1079.                       snmpAlarmSampleType, snmpAlarmStartupAlarm,
  1080.                       snmpAlarmRisingThreshold,
  1081.                       snmpAlarmFallingThreshold,
  1082.                       snmpAlarmRisingEventIndex,
  1083.                       snmpAlarmFallingEventIndex, and
  1084.                       snmpAlarmUnavailableEventIndex."
  1085.               ::= { snmpAlarmEntry 12 }
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.           Case, McCloghrie, Rose & Waldbusser                  [Page 19]
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.           RFC 1451            Manager-to-Manager MIB          April 1993
  1127.  
  1128.  
  1129.           -- alarm-related notifications
  1130.  
  1131.           snmpAlarmNotifications
  1132.                          OBJECT IDENTIFIER ::= { snmpAlarm 3 }
  1133.  
  1134.           snmpRisingAlarm NOTIFICATION-TYPE
  1135.               OBJECTS { snmpAlarmVariable, snmpAlarmSampleType,
  1136.                         snmpAlarmValue, snmpAlarmRisingThreshold }
  1137.               STATUS  current
  1138.               DESCRIPTION
  1139.                       "An event that is generated when an alarm entry
  1140.                       crosses its rising threshold.  The instances of
  1141.                       those objects contained within the varbind list
  1142.                       are those of the alarm entry which generated this
  1143.                       event."
  1144.               ::= { snmpAlarmNotifications 1 }
  1145.  
  1146.           snmpFallingAlarm NOTIFICATION-TYPE
  1147.               OBJECTS { snmpAlarmVariable, snmpAlarmSampleType,
  1148.                         snmpAlarmValue, snmpAlarmFallingThreshold }
  1149.               STATUS  current
  1150.               DESCRIPTION
  1151.                       "An event that is generated when an alarm entry
  1152.                       crosses its falling threshold.  The instances of
  1153.                       those objects contained within the varbind list
  1154.                       are those of the alarm entry which generated this
  1155.                       event."
  1156.               ::= { snmpAlarmNotifications 2 }
  1157.  
  1158.           snmpObjectUnavailableAlarm NOTIFICATION-TYPE
  1159.               OBJECTS { snmpAlarmVariable }
  1160.               STATUS  current
  1161.               DESCRIPTION
  1162.                       "An event that is generated when a variable
  1163.                       monitored by an alarm entry becomes unavailable.
  1164.                       The instance of snmpAlarmVariable contained within
  1165.                       the varbind list is the one associated with the
  1166.                       alarm entry which generated this event."
  1167.               ::= { snmpAlarmNotifications 3 }
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.           Case, McCloghrie, Rose & Waldbusser                  [Page 20]
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.           RFC 1451            Manager-to-Manager MIB          April 1993
  1186.  
  1187.  
  1188.           -- the event group
  1189.           --
  1190.           -- a collection of objects allowing the description and
  1191.           -- configuration of events from a SNMPv2 entity acting
  1192.           -- in a dual role.
  1193.  
  1194.           snmpEvent      OBJECT IDENTIFIER ::= { snmpM2MObjects 2 }
  1195.  
  1196.           -- The snmpEvent table defines the set of events generated on
  1197.           -- a SNMPv2 entity acting in a dual role.  Each entry in the
  1198.           -- snmpEventTable associates an event type with the
  1199.           -- notification method and associated parameters.  Some
  1200.           -- snmpEvent entries are fired by an associated condition in
  1201.           -- the snmpAlarmTable.  Others are fired on behalf of
  1202.           -- conditions defined in the NOTIFICATION-TYPE macro.  The
  1203.           -- snmpNotificationTable defines notifications that should
  1204.           -- occur when an associated event is fired.
  1205.  
  1206.           snmpEventNextIndex OBJECT-TYPE
  1207.               SYNTAX     INTEGER (0..65535)
  1208.               MAX-ACCESS read-only
  1209.               STATUS     current
  1210.               DESCRIPTION
  1211.                       "The index number of the next appropriate
  1212.                       unassigned entry in the snmpEventTable.  The value
  1213.                       0 indicates that no unassigned entries are
  1214.                       available.
  1215.  
  1216.                       A management station should create new entries in
  1217.                       the snmpEventTable using this algorithm: first,
  1218.                       issue a management protocol retrieval operation to
  1219.                       determine the value of snmpEventNextIndex; and,
  1220.                       second, issue a management protocol set operation
  1221.                       to create an instance of the snmpEventStatus
  1222.                       object setting its value to `createAndWait' or
  1223.                       'createAndGo'."
  1224.               ::= { snmpEvent 1 }
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.           Case, McCloghrie, Rose & Waldbusser                  [Page 21]
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.           RFC 1451            Manager-to-Manager MIB          April 1993
  1245.  
  1246.  
  1247.           snmpEventTable OBJECT-TYPE
  1248.               SYNTAX     SEQUENCE OF SnmpEventEntry
  1249.               MAX-ACCESS not-accessible
  1250.               STATUS     current
  1251.               DESCRIPTION
  1252.                       "A list of events."
  1253.               ::= { snmpEvent 2 }
  1254.  
  1255.           snmpEventEntry OBJECT-TYPE
  1256.               SYNTAX     SnmpEventEntry
  1257.               MAX-ACCESS not-accessible
  1258.               STATUS     current
  1259.               DESCRIPTION
  1260.                       "A set of parameters that describe an event that
  1261.                       is generated when certain conditions are met."
  1262.               INDEX      { snmpEventIndex }
  1263.               ::= { snmpEventTable 1 }
  1264.  
  1265.           SnmpEventEntry ::= SEQUENCE {
  1266.               snmpEventIndex          INTEGER,
  1267.               snmpEventID             OBJECT IDENTIFIER,
  1268.               snmpEventDescription    DisplayString,
  1269.               snmpEventEvents         Counter32,
  1270.               snmpEventLastTimeSent   TimeStamp,
  1271.               snmpEventStatus         RowStatus
  1272.           }
  1273.  
  1274.           snmpEventIndex OBJECT-TYPE
  1275.               SYNTAX     INTEGER (1..65535)
  1276.               MAX-ACCESS not-accessible
  1277.               STATUS     current
  1278.               DESCRIPTION
  1279.                       "An index that uniquely identifies an entry in the
  1280.                       snmpEvent table.  Each such entry defines an event
  1281.                       generated when the appropriate conditions occur."
  1282.               ::= { snmpEventEntry 1 }
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.           Case, McCloghrie, Rose & Waldbusser                  [Page 22]
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.           RFC 1451            Manager-to-Manager MIB          April 1993
  1304.  
  1305.  
  1306.           snmpEventID OBJECT-TYPE
  1307.               SYNTAX     OBJECT IDENTIFIER
  1308.               MAX-ACCESS read-create
  1309.               STATUS     current
  1310.               DESCRIPTION
  1311.                       "The authoritative identification of the event
  1312.                       type generated by this entry.  This variable
  1313.                       occurs as the second varbind of an InformRequest-
  1314.                       PDU.  If this OBJECT IDENTIFIER maps to a
  1315.                       NOTIFICATION-TYPE the sender will place the
  1316.                       objects listed in the NOTIFICATION-TYPE in the
  1317.                       varbind list."
  1318.               ::= { snmpEventEntry 2 }
  1319.  
  1320.           snmpEventDescription OBJECT-TYPE
  1321.               SYNTAX     DisplayString (SIZE (0..127))
  1322.               MAX-ACCESS read-create
  1323.               STATUS     current
  1324.               DESCRIPTION
  1325.                       "A comment describing this snmpEvent entry."
  1326.               ::= { snmpEventEntry 3 }
  1327.  
  1328.           snmpEventEvents OBJECT-TYPE
  1329.               SYNTAX     Counter32
  1330.               MAX-ACCESS read-only
  1331.               STATUS     current
  1332.               DESCRIPTION
  1333.                       "The number of events caused by event generators
  1334.                       associated with this snmpEvent entry."
  1335.               ::= { snmpEventEntry 4 }
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.           Case, McCloghrie, Rose & Waldbusser                  [Page 23]
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.           RFC 1451            Manager-to-Manager MIB          April 1993
  1363.  
  1364.  
  1365.           snmpEventLastTimeSent OBJECT-TYPE
  1366.               SYNTAX     TimeStamp
  1367.               MAX-ACCESS read-only
  1368.               STATUS     current
  1369.               DESCRIPTION
  1370.                       "The value of sysUpTime at the time this snmpEvent
  1371.                       entry last generated an event.  If this entry has
  1372.                       not generated any events, this value will be
  1373.                       zero."
  1374.               DEFVAL { 0 }
  1375.               ::= { snmpEventEntry 5 }
  1376.  
  1377.           snmpEventStatus OBJECT-TYPE
  1378.               SYNTAX     RowStatus
  1379.               MAX-ACCESS read-create
  1380.               STATUS     current
  1381.               DESCRIPTION
  1382.                       "The status of this snmpEvent entry.  This object
  1383.                       may not be set to `active' unless the following
  1384.                       columnar objects exist in this row: snmpEventID,
  1385.                       snmpEventDescription, snmpEventEvents, and
  1386.                       snmpEventLastTimeSent.
  1387.  
  1388.                       Setting an instance of this object to the value
  1389.                       'destroy' has the effect of invalidating any/all
  1390.                       entries in the snmpEventTable, and the
  1391.                       snmpEventNotifyTable which reference the
  1392.                       corresponding snmpEventEntry."
  1393.               ::= { snmpEventEntry 6 }
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.           Case, McCloghrie, Rose & Waldbusser                  [Page 24]
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.           RFC 1451            Manager-to-Manager MIB          April 1993
  1422.  
  1423.  
  1424.           snmpEventNotifyMinInterval OBJECT-TYPE
  1425.               SYNTAX     Integer32
  1426.               UNITS      "seconds"
  1427.               MAX-ACCESS read-only
  1428.               STATUS     current
  1429.               DESCRIPTION
  1430.                       "The minimum interval that the SNMPv2 entity
  1431.                       acting in a dual role will wait before
  1432.                       retransmitting an InformRequest-PDU.  This object
  1433.                       specifies the minimal value supported by the
  1434.                       SNMPv2 entity acting in a dual role, based on
  1435.                       resource or implementation constraints.
  1436.  
  1437.                       For a particular entry in the
  1438.                       snmpEventNotifyTable, if the associated
  1439.                       snmpEventNotifyIntervalRequested variable is
  1440.                       greater than this object, the
  1441.                       snmpEventNotifyIntervalRequested value shall be
  1442.                       used as the minimum interval for retransmissions
  1443.                       of InformRequest-PDUs sent on behalf of that
  1444.                       entry."
  1445.               ::= { snmpEvent 3 }
  1446.  
  1447.           snmpEventNotifyMaxRetransmissions OBJECT-TYPE
  1448.               SYNTAX     Integer32
  1449.               MAX-ACCESS read-only
  1450.               STATUS     current
  1451.               DESCRIPTION
  1452.                       "The maximum number of time that the SNMPv2 entity
  1453.                       acting in a dual role will retransmit an
  1454.                       InformRequest-PDU.  This object specifies the
  1455.                       maximal value supported by the SNMPv2 entity
  1456.                       acting in a dual role, based on resource or
  1457.                       implementation constraints.
  1458.  
  1459.                       For a particular entry in the
  1460.                       snmpEventNotifyTable, if the associated
  1461.                       snmpEventNotifyRetransmissionsRequested variable
  1462.                       is less than this object, the
  1463.                       snmpEventNotifyRetransmissionsRequested value
  1464.                       shall be used as the retransmission count for
  1465.                       InformRequest-PDUs sent on behalf of that entry."
  1466.               ::= { snmpEvent 4 }
  1467.  
  1468.           -- The snmpEventNotifyTable is used to configure the
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.           Case, McCloghrie, Rose & Waldbusser                  [Page 25]
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.           RFC 1451            Manager-to-Manager MIB          April 1993
  1481.  
  1482.  
  1483.           -- destination and type of notifications sent by a SNMPv2
  1484.           -- entity acting in a manager role when a particular event
  1485.           -- is triggered.
  1486.  
  1487.           snmpEventNotifyTable OBJECT-TYPE
  1488.               SYNTAX     SEQUENCE OF SnmpEventNotifyEntry
  1489.               MAX-ACCESS not-accessible
  1490.               STATUS     current
  1491.               DESCRIPTION
  1492.                       "A list of protocol configuration entries for
  1493.                       event notifications from this entity."
  1494.               ::= { snmpEvent 5 }
  1495.  
  1496.           snmpEventNotifyEntry OBJECT-TYPE
  1497.               SYNTAX     SnmpEventNotifyEntry
  1498.               MAX-ACCESS not-accessible
  1499.               STATUS     current
  1500.               DESCRIPTION
  1501.                       "A set of parameters that describe the type and
  1502.                       destination of InformRequest-PDUs sent for a
  1503.                       particular event.  The snmpEventIndex in this
  1504.                       entry's INDEX clause identifies the snmpEventEntry
  1505.                       which, when triggered, will generate a
  1506.                       notification as configured in this entry.  The
  1507.                       contextIdentity in this entry's INDEX clause
  1508.                       identifies the context to which a notification
  1509.                       will be sent."
  1510.               INDEX      { snmpEventIndex, contextIdentity }
  1511.               ::= { snmpEventNotifyTable 1 }
  1512.  
  1513.           SnmpEventNotifyEntry ::= SEQUENCE {
  1514.               snmpEventNotifyIntervalRequested        Integer32,
  1515.               snmpEventNotifyRetransmissionsRequested Integer32,
  1516.               snmpEventNotifyLifetime                 Integer32,
  1517.               snmpEventNotifyStatus                   RowStatus
  1518.           }
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.           Case, McCloghrie, Rose & Waldbusser                  [Page 26]
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.           RFC 1451            Manager-to-Manager MIB          April 1993
  1540.  
  1541.  
  1542.           snmpEventNotifyIntervalRequested OBJECT-TYPE
  1543.               SYNTAX     Integer32
  1544.               UNITS      "seconds"
  1545.               MAX-ACCESS read-create
  1546.               STATUS     current
  1547.               DESCRIPTION
  1548.                       "The requested interval for retransmission of
  1549.                       Inform PDUs generated on the behalf of this entry.
  1550.  
  1551.                       This variable will be the actual interval used
  1552.                       unless the snmpEventNotifyMinInterval is greater
  1553.                       than this object, in which case the interval shall
  1554.                       be equal to snmpEventNotifyMinInterval."
  1555.               DEFVAL { 30 }
  1556.               ::= { snmpEventNotifyEntry 1 }
  1557.  
  1558.           snmpEventNotifyRetransmissionsRequested OBJECT-TYPE
  1559.               SYNTAX     Integer32
  1560.               MAX-ACCESS read-create
  1561.               STATUS     current
  1562.               DESCRIPTION
  1563.                       "The requested number of retransmissions of an
  1564.                       InformRequest-PDU generated on behalf of this
  1565.                       entry.
  1566.  
  1567.                       This variable will be the actual number of
  1568.                       retransmissions used unless the
  1569.                       snmpEventNotifyMaxRetransmissions is less than
  1570.                       this object, in which case the retransmission
  1571.                       count shall be equal to
  1572.                       snmpEventNotifyMaxRetransmissions."
  1573.               DEFVAL { 5 }
  1574.               ::= { snmpEventNotifyEntry 2 }
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.           Case, McCloghrie, Rose & Waldbusser                  [Page 27]
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.           RFC 1451            Manager-to-Manager MIB          April 1993
  1599.  
  1600.  
  1601.           snmpEventNotifyLifetime OBJECT-TYPE
  1602.               SYNTAX     Integer32
  1603.               UNITS      "seconds"
  1604.               MAX-ACCESS read-create
  1605.               STATUS     current
  1606.               DESCRIPTION
  1607.                       "The number of seconds this entry shall live until
  1608.                       the corresponding instance of
  1609.                       snmpEventNotifyStatus is set to 'destroy'.  This
  1610.                       value shall count down to zero, at which time the
  1611.                       corresponding instance of snmpEventNotifyStatus
  1612.                       will be set to 'destroy'.  Any management station
  1613.                       that is using this entry must periodically refresh
  1614.                       this value to ensure the continued delivery of
  1615.                       events."
  1616.               DEFVAL { 86400 }
  1617.               ::= { snmpEventNotifyEntry 3 }
  1618.  
  1619.           snmpEventNotifyStatus OBJECT-TYPE
  1620.               SYNTAX     RowStatus
  1621.               MAX-ACCESS read-create
  1622.               STATUS     current
  1623.               DESCRIPTION
  1624.                       "The state of this snmpEventNotifyEntry.  This
  1625.                       object may not be set to `active' unless the
  1626.                       following columnar objects exist in this row:
  1627.                       snmpEventNotifyIntervalRequested,
  1628.                       snmpEventNotifyRetransmissionsRequested, and
  1629.                       snmpEventNotifyLifetime."
  1630.               ::= { snmpEventNotifyEntry 4 }
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.           Case, McCloghrie, Rose & Waldbusser                  [Page 28]
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.           RFC 1451            Manager-to-Manager MIB          April 1993
  1658.  
  1659.  
  1660.           -- conformance information
  1661.  
  1662.           snmpM2MConformance
  1663.                          OBJECT IDENTIFIER ::= { snmpM2M 2 }
  1664.  
  1665.           snmpM2MCompliances
  1666.                          OBJECT IDENTIFIER ::= { snmpM2MConformance 1 }
  1667.           snmpM2MGroups  OBJECT IDENTIFIER ::= { snmpM2MConformance 2 }
  1668.  
  1669.  
  1670.           -- compliance statements
  1671.  
  1672.           snmpM2MCompliance MODULE-COMPLIANCE
  1673.               STATUS  current
  1674.               DESCRIPTION
  1675.                       "The compliance statement for SNMPv2 entities
  1676.                       which implement the Manager-to-Manager MIB."
  1677.               MODULE  -- this module
  1678.                   MANDATORY-GROUPS { snmpAlarmGroup, snmpEventGroup }
  1679.               ::= { snmpM2MCompliances 1 }
  1680.  
  1681.  
  1682.           -- units of conformance
  1683.  
  1684.           snmpAlarmGroup OBJECT-GROUP
  1685.               OBJECTS { snmpAlarmNextIndex,
  1686.                         snmpAlarmVariable, snmpAlarmInterval,
  1687.                         snmpAlarmSampleType, snmpAlarmValue,
  1688.                         snmpAlarmStartupAlarm, snmpAlarmRisingThreshold,
  1689.                         snmpAlarmFallingThreshold,
  1690.                         snmpAlarmRisingEventIndex,
  1691.                         snmpAlarmFallingEventIndex,
  1692.                         snmpAlarmUnavailableEventIndex,
  1693.                         snmpAlarmStatus }
  1694.               STATUS  current
  1695.               DESCRIPTION
  1696.                       "A collection of objects allowing the description
  1697.                       and configuration of threshold alarms from a
  1698.                       SNMPv2 entity acting in a dual role."
  1699.               ::= { snmpM2MGroups 1 }
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.           Case, McCloghrie, Rose & Waldbusser                  [Page 29]
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.           RFC 1451            Manager-to-Manager MIB          April 1993
  1717.  
  1718.  
  1719.           snmpEventGroup OBJECT-GROUP
  1720.               OBJECTS { snmpEventNextIndex,
  1721.                         snmpEventID, snmpEventDescription,
  1722.                         snmpEventEvents, snmpEventLastTimeSent,
  1723.                         snmpEventStatus, snmpEventNotifyMinInterval,
  1724.                         snmpEventNotifyMaxRetransmissions,
  1725.                         snmpEventNotifyIntervalRequested,
  1726.                         snmpEventNotifyRetransmissionsRequested,
  1727.                         snmpEventNotifyLifetime, snmpEventNotifyStatus }
  1728.               STATUS  current
  1729.               DESCRIPTION
  1730.                       "A collection of objects allowing the description
  1731.                       and configuration of events from a SNMPv2 entity
  1732.                       acting in a dual role."
  1733.               ::= { snmpM2MGroups 2 }
  1734.  
  1735.  
  1736.           END
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.           Case, McCloghrie, Rose & Waldbusser                  [Page 30]
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.           RFC 1451            Manager-to-Manager MIB          April 1993
  1776.  
  1777.  
  1778.           4.  Acknowledgements
  1779.  
  1780.           The comments of the SNMP version 2 working group are
  1781.           gratefully acknowledged:
  1782.  
  1783.                Beth Adams, Network Management Forum
  1784.                Steve Alexander, INTERACTIVE Systems Corporation
  1785.                David Arneson, Cabletron Systems
  1786.                Toshiya Asaba
  1787.                Fred Baker, ACC
  1788.                Jim Barnes, Xylogics, Inc.
  1789.                Brian Bataille
  1790.                Andy Bierman, SynOptics Communications, Inc.
  1791.                Uri Blumenthal, IBM Corporation
  1792.                Fred Bohle, Interlink
  1793.                Jack Brown
  1794.                Theodore Brunner, Bellcore
  1795.                Stephen F. Bush, GE Information Services
  1796.                Jeffrey D. Case, University of Tennessee, Knoxville
  1797.                John Chang, IBM Corporation
  1798.                Szusin Chen, Sun Microsystems
  1799.                Robert Ching
  1800.                Chris Chiotasso, Ungermann-Bass
  1801.                Bobby A. Clay, NASA/Boeing
  1802.                John Cooke, Chipcom
  1803.                Tracy Cox, Bellcore
  1804.                Juan Cruz, Datability, Inc.
  1805.                David Cullerot, Cabletron Systems
  1806.                Cathy Cunningham, Microcom
  1807.                James R. (Chuck) Davin, Bellcore
  1808.                Michael Davis, Clearpoint
  1809.                Mike Davison, FiberCom
  1810.                Cynthia DellaTorre, MITRE
  1811.                Taso N. Devetzis, Bellcore
  1812.                Manual Diaz, DAVID Systems, Inc.
  1813.                Jon Dreyer, Sun Microsystems
  1814.                David Engel, Optical Data Systems
  1815.                Mike Erlinger, Lexcel
  1816.                Roger Fajman, NIH
  1817.                Daniel Fauvarque, Sun Microsystems
  1818.                Karen Frisa, CMU
  1819.                Shari Galitzer, MITRE
  1820.                Shawn Gallagher, Digital Equipment Corporation
  1821.                Richard Graveman, Bellcore
  1822.                Maria Greene, Xyplex, Inc.
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.           Case, McCloghrie, Rose & Waldbusser                  [Page 31]
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.           RFC 1451            Manager-to-Manager MIB          April 1993
  1835.  
  1836.  
  1837.                Michel Guittet, Apple
  1838.                Robert Gutierrez, NASA
  1839.                Bill Hagerty, Cabletron Systems
  1840.                Gary W. Haney, Martin Marietta Energy Systems
  1841.                Patrick Hanil, Nokia Telecommunications
  1842.                Matt Hecht, SNMP Research, Inc.
  1843.                Edward A. Heiner, Jr., Synernetics Inc.
  1844.                Susan E. Hicks, Martin Marietta Energy Systems
  1845.                Geral Holzhauer, Apple
  1846.                John Hopprich, DAVID Systems, Inc.
  1847.                Jeff Hughes, Hewlett-Packard
  1848.                Robin Iddon, Axon Networks, Inc.
  1849.                David Itusak
  1850.                Kevin M. Jackson, Concord Communications, Inc.
  1851.                Ole J. Jacobsen, Interop Company
  1852.                Ronald Jacoby, Silicon Graphics, Inc.
  1853.                Satish Joshi, SynOptics Communications, Inc.
  1854.                Frank Kastenholz, FTP Software
  1855.                Mark Kepke, Hewlett-Packard
  1856.                Ken Key, SNMP Research, Inc.
  1857.                Zbiginew Kielczewski, Eicon
  1858.                Jongyeoi Kim
  1859.                Andrew Knutsen, The Santa Cruz Operation
  1860.                Michael L. Kornegay, VisiSoft
  1861.                Deirdre C. Kostik, Bellcore
  1862.                Cheryl Krupczak, Georgia Tech
  1863.                Mark S. Lewis, Telebit
  1864.                David Lin
  1865.                David Lindemulder, AT&T/NCR
  1866.                Ben Lisowski, Sprint
  1867.                David Liu, Bell-Northern Research
  1868.                John Lunny, The Wollongong Group
  1869.                Robert C. Lushbaugh Martin, Marietta Energy Systems
  1870.                Michael Luufer, BBN
  1871.                Carl Madison, Star-Tek, Inc.
  1872.                Keith McCloghrie, Hughes LAN Systems
  1873.                Evan McGinnis, 3Com Corporation
  1874.                Bill McKenzie, IBM Corporation
  1875.                Donna McMaster, SynOptics Communications, Inc.
  1876.                John Medicke, IBM Corporation
  1877.                Doug Miller, Telebit
  1878.                Dave Minnich, FiberCom
  1879.                Mohammad Mirhakkak, MITRE
  1880.                Rohit Mital, Protools
  1881.                George Mouradian, AT&T Bell Labs
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.           Case, McCloghrie, Rose & Waldbusser                  [Page 32]
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.           RFC 1451            Manager-to-Manager MIB          April 1993
  1894.  
  1895.  
  1896.                Patrick Mullaney, Cabletron Systems
  1897.                Dan Myers, 3Com Corporation
  1898.                Rina Nathaniel, Rad Network Devices Ltd.
  1899.                Hien V. Nguyen, Sprint
  1900.                Mo Nikain
  1901.                Tom Nisbet
  1902.                William B. Norton, MERIT
  1903.                Steve Onishi, Wellfleet Communications, Inc.
  1904.                David T. Perkins, SynOptics Communications, Inc.
  1905.                Carl Powell, BBN
  1906.                Ilan Raab, SynOptics Communications, Inc.
  1907.                Richard Ramons, AT&T
  1908.                Venkat D. Rangan, Metric Network Systems, Inc.
  1909.                Louise Reingold, Sprint
  1910.                Sam Roberts, Farallon Computing, Inc.
  1911.                Kary Robertson, Concord Communications, Inc.
  1912.                Dan Romascanu, Lannet Data Communications Ltd.
  1913.                Marshall T. Rose, Dover Beach Consulting, Inc.
  1914.                Shawn A. Routhier, Epilogue Technology Corporation
  1915.                Chris Rozman
  1916.                Asaf Rubissa, Fibronics
  1917.                Jon Saperia, Digital Equipment Corporation
  1918.                Michael Sapich
  1919.                Mike Scanlon, Interlan
  1920.                Sam Schaen, MITRE
  1921.                John Seligson, Ultra Network Technologies
  1922.                Paul A. Serice, Corporation for Open Systems
  1923.                Chris Shaw, Banyan Systems
  1924.                Timon Sloane
  1925.                Robert Snyder, Cisco Systems
  1926.                Joo Young Song
  1927.                Roy Spitier, Sprint
  1928.                Einar Stefferud, Network Management Associates
  1929.                John Stephens, Cayman Systems, Inc.
  1930.                Robert L. Stewart, Xyplex, Inc. (chair)
  1931.                Kaj Tesink, Bellcore
  1932.                Dean Throop, Data General
  1933.                Ahmet Tuncay, France Telecom-CNET
  1934.                Maurice Turcotte, Racal Datacom
  1935.                Warren Vik, INTERACTIVE Systems Corporation
  1936.                Yannis Viniotis
  1937.                Steven L. Waldbusser, Carnegie Mellon Universitty
  1938.                Timothy M. Walden, ACC
  1939.                Alice Wang, Sun Microsystems
  1940.                James Watt, Newbridge
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.           Case, McCloghrie, Rose & Waldbusser                  [Page 33]
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.           RFC 1451            Manager-to-Manager MIB          April 1993
  1953.  
  1954.  
  1955.                Luanne Waul, Timeplex
  1956.                Donald E. Westlake III, Digital Equipment Corporation
  1957.                Gerry White
  1958.                Bert Wijnen, IBM Corporation
  1959.                Peter Wilson, 3Com Corporation
  1960.                Steven Wong, Digital Equipment Corporation
  1961.                Randy Worzella, IBM Corporation
  1962.                Daniel Woycke, MITRE
  1963.                Honda Wu
  1964.                Jeff Yarnell, Protools
  1965.                Chris Young, Cabletron
  1966.                Kiho Yum, 3Com Corporation
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.           Case, McCloghrie, Rose & Waldbusser                  [Page 34]
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.           RFC 1451            Manager-to-Manager MIB          April 1993
  2012.  
  2013.  
  2014.           5.  References
  2015.  
  2016.           [1]  Information processing systems - Open Systems
  2017.                Interconnection - Specification of Abstract Syntax
  2018.                Notation One (ASN.1), International Organization for
  2019.                Standardization.  International Standard 8824, (December,
  2020.                1987).
  2021.  
  2022.           [2]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  2023.                "Structure of Management Information for version 2 of the
  2024.                Simple Network Management Protocol (SNMPv2)", RFC 1442,
  2025.                SNMP Research, Inc., Hughes LAN Systems, Dover Beach
  2026.                Consulting, Inc., Carnegie Mellon University, April 1993.
  2027.  
  2028.           [3]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  2029.                "Protocol Operations for version 2 of the Simple Network
  2030.                Management Protocol (SNMPv2)", RFC 1448, SNMP Research,
  2031.                Inc., Hughes LAN Systems, Dover Beach Consulting, Inc.,
  2032.                Carnegie Mellon University, April 1993.
  2033.  
  2034.           [4]  Galvin, J., and McCloghrie, K., "Administrative Model for
  2035.                version 2 of the Simple Network Management Protocol
  2036.                (SNMPv2)", RFC 1445, Trusted Information Systems, Hughes
  2037.                LAN Systems, April 1993.
  2038.  
  2039.           [5]  McCloghrie, K., and Galvin, J., "Party MIB for version 2
  2040.                of the Simple Network Management Protocol (SNMPv2)", RFC
  2041.                1447, Hughes LAN Systems, Trusted Information Systems,
  2042.                April 1993.
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.           Case, McCloghrie, Rose & Waldbusser                  [Page 35]
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.           RFC 1451            Manager-to-Manager MIB          April 1993
  2071.  
  2072.  
  2073.           6.  Security Considerations
  2074.  
  2075.           Security issues are not discussed in this memo.
  2076.  
  2077.  
  2078.           7.  Authors' Addresses
  2079.  
  2080.                Jeffrey D. Case
  2081.                SNMP Research, Inc.
  2082.                3001 Kimberlin Heights Rd.
  2083.                Knoxville, TN  37920-9716
  2084.                US
  2085.  
  2086.                Phone: +1 615 573 1434
  2087.                Email: case@snmp.com
  2088.  
  2089.  
  2090.                Keith McCloghrie
  2091.                Hughes LAN Systems
  2092.                1225 Charleston Road
  2093.                Mountain View, CA  94043
  2094.                US
  2095.  
  2096.                Phone: +1 415 966 7934
  2097.                Email: kzm@hls.com
  2098.  
  2099.  
  2100.                Marshall T. Rose
  2101.                Dover Beach Consulting, Inc.
  2102.                420 Whisman Court
  2103.                Mountain View, CA  94043-2186
  2104.                US
  2105.  
  2106.                Phone: +1 415 968 1052
  2107.                Email: mrose@dbc.mtview.ca.us
  2108.  
  2109.                Steven Waldbusser
  2110.                Carnegie Mellon University
  2111.                4910 Forbes Ave
  2112.                Pittsburgh, PA  15213
  2113.                US
  2114.  
  2115.                Phone: +1 412 268 6628
  2116.                Email: waldbusser@cmu.edu
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.           Case, McCloghrie, Rose & Waldbusser                  [Page 36]
  2124.  
  2125.