home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 May / W2KPRK.iso / apps / InternetScanner / data1.cab / Program_Files / Mibs / SNMP-NOTIFICATION-MIB.txt < prev    next >
Encoding:
Text File  |  1999-11-22  |  16.5 KB  |  557 lines
  1. SNMP-NOTIFICATION-MIB DEFINITIONS ::= BEGIN
  2.  
  3. IMPORTS
  4.    MODULE-IDENTITY,
  5.    OBJECT-TYPE,
  6.    snmpModules
  7.        FROM SNMPv2-SMI
  8.  
  9.    RowStatus,
  10.    StorageType
  11.        FROM SNMPv2-TC
  12.  
  13.    SnmpAdminString
  14.        FROM SNMP-FRAMEWORK-MIB
  15.  
  16.    SnmpTagValue,
  17.    snmpTargetParamsName
  18.        FROM SNMP-TARGET-MIB
  19.  
  20.    MODULE-COMPLIANCE,
  21.    OBJECT-GROUP
  22.        FROM SNMPv2-CONF;
  23.  
  24. snmpNotificationMIB MODULE-IDENTITY
  25.    LAST-UPDATED "9711210000Z"
  26.    ORGANIZATION "IETF SNMPv3 Working Group"
  27.    CONTACT-INFO
  28.        "WG-email:   snmpv3@tis.com
  29.     Subscribe:  majordomo@tis.com
  30.             In message body:  subscribe snmpv3
  31.  
  32.     Chair:      Russ Mundy
  33.             Trusted Information Systems
  34.     Postal:     3060 Washington Rd
  35.             Glenwood MD 21738
  36.             USA
  37.     Email:      mundy@tis.com
  38.     Phone:      +1-301-854-6889
  39.  
  40.     Co-editor:  David B. Levi
  41.             SNMP Research, Inc.
  42.     Postal:     3001 Kimberlin Heights Road
  43.             Knoxville, TN 37920-9716
  44.     E-mail:     levi@snmp.com
  45.     Phone:      +1 423 573 1434
  46.  
  47.     Co-editor:  Paul Meyer
  48.             Secure Computing Corporation
  49.     Postal:     2675 Long Lake Road
  50.             Roseville, MN 55113
  51.     E-mail:     paul_meyer@securecomputing.com
  52.     Phone:      +1 612 628 1592
  53.  
  54.     Co-editor:  Bob Stewart
  55.             Cisco Systems, Inc.
  56.     Postal:     170 West Tasman Drive
  57.             San Jose, CA 95134-1706
  58.     E-mail:     bstewart@cisco.com
  59.     Phone:      +1 603 654 6923"
  60.    DESCRIPTION
  61.        "This MIB module defines MIB objects which provide
  62.     mechanisms to remotely configure the parameters
  63.     used by an SNMP entity for the generation of
  64.     notifications."
  65.    REVISION    "9707140000Z"
  66.    DESCRIPTION
  67.        "The initial revision."
  68.    ::= { snmpModules 16 }
  69.  
  70. snmpNotifyObjects       OBJECT IDENTIFIER ::=
  71.                      { snmpNotificationMIB 1 }
  72. snmpNotifyConformance   OBJECT IDENTIFIER ::=
  73.                      { snmpNotificationMIB 3 }
  74.  
  75.  
  76. --
  77. --
  78. -- The snmpNotifyObjects group
  79. --
  80. --
  81.  
  82. snmpNotifyTable OBJECT-TYPE
  83.    SYNTAX      SEQUENCE OF SnmpNotifyEntry
  84.    MAX-ACCESS  not-accessible
  85.    STATUS      current
  86.    DESCRIPTION
  87.        "This table is used to select management targets which should
  88.     receive notifications, as well as the type of notification
  89.     which should be sent to each selected management target."
  90.    ::= { snmpNotifyObjects 1 }
  91.  
  92. snmpNotifyEntry OBJECT-TYPE
  93.    SYNTAX      SnmpNotifyEntry
  94.    MAX-ACCESS  not-accessible
  95.    STATUS      current
  96.    DESCRIPTION
  97.        "An entry in this table selects a set of management targets
  98.     which should receive notifications, as well as the type of
  99.     notification which should be sent to each selected
  100.     management target.
  101.  
  102.     Entries in the snmpNotifyTable are created and
  103.     deleted using the snmpNotifyRowStatus object."
  104.    INDEX { IMPLIED snmpNotifyName }
  105.    ::= { snmpNotifyTable 1 }
  106.  
  107. SnmpNotifyEntry ::= SEQUENCE {
  108.    snmpNotifyName         SnmpAdminString,
  109.    snmpNotifyTag          SnmpTagValue,
  110.    snmpNotifyType         INTEGER,
  111.    snmpNotifyStorageType  StorageType,
  112.    snmpNotifyRowStatus    RowStatus
  113. }
  114.  
  115. snmpNotifyName OBJECT-TYPE
  116.    SYNTAX      SnmpAdminString (SIZE(1..32))
  117.    MAX-ACCESS  not-accessible
  118.    STATUS      current
  119.    DESCRIPTION
  120.        "The locally arbitrary, but unique identifier associated
  121.     with this snmpNotifyEntry."
  122.    ::= { snmpNotifyEntry 1 }
  123.  
  124. snmpNotifyTag OBJECT-TYPE
  125.    SYNTAX      SnmpTagValue
  126.    MAX-ACCESS  read-create
  127.    STATUS      current
  128.    DESCRIPTION
  129.        "This object contains a single tag value which is used
  130.     to select entries in the snmpTargetAddrTable.  Any entry
  131.     in the snmpTargetAddrTable which contains a tag value
  132.     which is equal to the value of an instance of this
  133.     object is selected.  If this object contains a value
  134.     of zero length, no entries are selected."
  135.    ::= { snmpNotifyEntry 2 }
  136.  
  137. snmpNotifyType OBJECT-TYPE
  138.    SYNTAX      INTEGER {
  139.            trap(1),
  140.            inform(2)
  141.            }
  142.    MAX-ACCESS  read-create
  143.    STATUS      current
  144.    DESCRIPTION
  145.        "This object determines the type of notification to
  146.     be generated for entries in the snmpTargetAddrTable
  147.     selected by the corresponding instance of
  148.     snmpNotifyTag.
  149.  
  150.     If the value of this object is trap(1), then any
  151.     messages generated for selected rows will contain
  152.     SNMPv2-Trap PDUs.
  153.  
  154.     If the value of this object is inform(2), then any
  155.     messages generated for selected rows will contain
  156.     Inform PDUs.
  157.  
  158.     Note that if an SNMP entity only supports
  159.     generation of traps (and not informs), then this
  160.     object may be read-only."
  161.    DEFVAL { trap }
  162.    ::= { snmpNotifyEntry 3 }
  163.  
  164. snmpNotifyStorageType OBJECT-TYPE
  165.    SYNTAX      StorageType
  166.    MAX-ACCESS  read-create
  167.    STATUS      current
  168.    DESCRIPTION
  169.        "The storage type for this conceptual row."
  170.    ::= { snmpNotifyEntry 4 }
  171.  
  172. snmpNotifyRowStatus OBJECT-TYPE
  173.    SYNTAX      RowStatus
  174.    MAX-ACCESS  read-create
  175.    STATUS      current
  176.    DESCRIPTION
  177.        "The status of this conceptual row.
  178.  
  179.     To create a row in this table, a manager must
  180.     set this object to either createAndGo(4) or
  181.     createAndWait(5).
  182.  
  183.     Until instances of all corresponding columns are
  184.     appropriately configured, the value of the
  185.     corresponding instance of the snmpNotifyRowStatus
  186.     column is 'notReady'.
  187.  
  188.     In particular, a newly created row cannot be made
  189.     active until the corresponding snmpNotifyTag has
  190.     been set."
  191.    ::= { snmpNotifyEntry 5 }
  192.  
  193. snmpNotifyFilterProfileTable OBJECT-TYPE
  194.    SYNTAX      SEQUENCE OF SnmpNotifyFilterProfileEntry
  195.    MAX-ACCESS  not-accessible
  196.    STATUS      current
  197.    DESCRIPTION
  198.        "This table is used to associate a notification filter
  199.     profile with a particular set of target parameters."
  200.    ::= { snmpNotifyObjects 2 }
  201.  
  202. snmpNotifyFilterProfileEntry OBJECT-TYPE
  203.    SYNTAX      SnmpNotifyFilterProfileEntry
  204.    MAX-ACCESS  not-accessible
  205.    STATUS      current
  206.    DESCRIPTION
  207.        "An entry in this table indicates the name of the filter
  208.     profile to be used when generating notifications using
  209.     the corresponding entry in the snmpTargetParamsTable.
  210.  
  211.     Entries in the snmpNotifyFilterProfileTable are created
  212.     and deleted using the snmpNotifyFilterProfileRowStatus
  213.     object."
  214.    INDEX { IMPLIED snmpTargetParamsName }
  215.    ::= { snmpNotifyFilterProfileTable 1 }
  216.  
  217. SnmpNotifyFilterProfileEntry ::= SEQUENCE {
  218.    snmpNotifyFilterProfileName         SnmpAdminString,
  219.    snmpNotifyFilterProfileStorType     StorageType,
  220.    snmpNotifyFilterProfileRowStatus    RowStatus
  221. }
  222.  
  223. snmpNotifyFilterProfileName OBJECT-TYPE
  224.    SYNTAX      SnmpAdminString (SIZE(1..32))
  225.    MAX-ACCESS  read-create
  226.    STATUS      current
  227.    DESCRIPTION
  228.        "The name of the filter profile to be used when generating
  229.     notifications using the corresponding entry in the
  230.     snmpTargetAddrTable."
  231.    ::= { snmpNotifyFilterProfileEntry 1 }
  232.  
  233. snmpNotifyFilterProfileStorType OBJECT-TYPE
  234.    SYNTAX      StorageType
  235.    MAX-ACCESS  read-create
  236.    STATUS      current
  237.    DESCRIPTION
  238.        "The storage type of this conceptual row."
  239.    ::= { snmpNotifyFilterProfileEntry 2 }
  240.  
  241. snmpNotifyFilterProfileRowStatus OBJECT-TYPE
  242.    SYNTAX      RowStatus
  243.    MAX-ACCESS  read-create
  244.    STATUS      current
  245.    DESCRIPTION
  246.        "The status of this conceptual row.
  247.  
  248.     To create a row in this table, a manager must
  249.     set this object to either createAndGo(4) or
  250.     createAndWait(5)."
  251.    ::= { snmpNotifyFilterProfileEntry 3 }
  252.  
  253. snmpNotifyFilterTable OBJECT-TYPE
  254.    SYNTAX      SEQUENCE OF SnmpNotifyFilterEntry
  255.    MAX-ACCESS  not-accessible
  256.    STATUS      current
  257.    DESCRIPTION
  258.        "The table of filter profiles.  Filter profiles are used
  259.     to determine whether particular management targets should
  260.     receive particular notifications.
  261.  
  262.     When a notification is generated, it must be compared
  263.     with the filters associated with each management target
  264.     which is configured to receive notifications.  If the
  265.     notification is matched by a filter, it is not sent to
  266.     the management target with which the filter is
  267.     associated."
  268.    ::= { snmpNotifyObjects 3 }
  269.  
  270. snmpNotifyFilterEntry OBJECT-TYPE
  271.    SYNTAX      SnmpNotifyFilterEntry
  272.    MAX-ACCESS  not-accessible
  273.    STATUS      current
  274.    DESCRIPTION
  275.        "An element of a filter profile.
  276.  
  277.     Entries in the snmpNotifyFilterTable are created and
  278.     deleted using the snmpNotifyFilterRowStatus object."
  279.    INDEX {         snmpNotifyFilterProfileName,
  280.        IMPLIED snmpNotifyFilterSubtree }
  281.    ::= { snmpNotifyFilterTable 1 }
  282.  
  283. SnmpNotifyFilterEntry ::= SEQUENCE {
  284.    snmpNotifyFilterSubtree           OBJECT IDENTIFIER,
  285.    snmpNotifyFilterMask              OCTET STRING,
  286.    snmpNotifyFilterType              INTEGER,
  287.    snmpNotifyFilterStorageType       StorageType,
  288.    snmpNotifyFilterRowStatus         RowStatus
  289. }
  290.  
  291. snmpNotifyFilterSubtree OBJECT-TYPE
  292.    SYNTAX      OBJECT IDENTIFIER
  293.    MAX-ACCESS  not-accessible
  294.    STATUS      current
  295.    DESCRIPTION
  296.        "The MIB subtree which, when combined with the corresponding
  297.     instance of snmpNotifyFilterMask, defines a family of
  298.     subtrees which are included in or excluded from the
  299.     filter profile."
  300.    ::= { snmpNotifyFilterEntry 1 }
  301.  
  302. snmpNotifyFilterMask OBJECT-TYPE
  303.    SYNTAX      OCTET STRING (SIZE(0..16))
  304.    MAX-ACCESS  read-create
  305.    STATUS      current
  306.    DESCRIPTION
  307.        "The bit mask which, in combination with the corresponding
  308.     instance of snmpNotifyFilterSubtree, defines a family of
  309.     subtrees which are included in or excluded from the
  310.     filter profile.
  311.  
  312.     Each bit of this bit mask corresponds to a
  313.     sub-identifier of snmpNotifyFilterSubtree, with the
  314.     most significant bit of the i-th octet of this octet
  315.     string value (extended if necessary, see below)
  316.     corresponding to the (8*i - 7)-th sub-identifier, and
  317.     the least significant bit of the i-th octet of this
  318.     octet string corresponding to the (8*i)-th
  319.     sub-identifier, where i is in the range 1 through 16.
  320.  
  321.     Each bit of this bit mask specifies whether or not
  322.     the corresponding sub-identifiers must match when
  323.     determining if an OBJECT IDENTIFIER matches this
  324.     family of filter subtrees; a '1' indicates that an
  325.     exact match must occur; a '0' indicates 'wild card',
  326.     i.e., any sub-identifier value matches.
  327.  
  328.     Thus, the OBJECT IDENTIFIER X of an object instance
  329.     is contained in a family of filter subtrees if, for
  330.     each sub-identifier of the value of
  331.     snmpNotifyFilterSubtree, either:
  332.  
  333.       the i-th bit of snmpNotifyFilterMask is 0, or
  334.  
  335.       the i-th sub-identifier of X is equal to the i-th
  336.       sub-identifier of the value of
  337.       snmpNotifyFilterSubtree.
  338.  
  339.     If the value of this bit mask is M bits long and
  340.     there are more than M sub-identifiers in the
  341.     corresponding instance of snmpNotifyFilterSubtree,
  342.     then the bit mask is extended with 1's to be the
  343.     required length.
  344.  
  345.     Note that when the value of this object is the
  346.     zero-length string, this extension rule results in
  347.     a mask of all-1's being used (i.e., no 'wild card'),
  348.     and the family of filter subtrees is the one
  349.     subtree uniquely identified by the corresponding
  350.     instance of snmpNotifyFilterSubtree."
  351.    DEFVAL { ''H }
  352.    ::= { snmpNotifyFilterEntry 2 }
  353.  
  354. snmpNotifyFilterType OBJECT-TYPE
  355.    SYNTAX      INTEGER {
  356.            included(1),
  357.            excluded(2)
  358.            }
  359.    MAX-ACCESS  read-create
  360.    STATUS      current
  361.    DESCRIPTION
  362.        "This object indicates whether the family of filter subtrees
  363.     defined by this entry are included in or excluded from a
  364.     filter."
  365.    DEFVAL { included }
  366.    ::= { snmpNotifyFilterEntry 3 }
  367.  
  368. snmpNotifyFilterStorageType OBJECT-TYPE
  369.    SYNTAX      StorageType
  370.    MAX-ACCESS  read-create
  371.    STATUS      current
  372.    DESCRIPTION
  373.        "The storage type of this conceptual row."
  374.    ::= { snmpNotifyFilterEntry 4 }
  375.  
  376. snmpNotifyFilterRowStatus OBJECT-TYPE
  377.    SYNTAX      RowStatus
  378.    MAX-ACCESS  read-create
  379.    STATUS      current
  380.    DESCRIPTION
  381.        "The status of this conceptual row.
  382.  
  383.     To create a row in this table, a manager must
  384.     set this object to either createAndGo(4) or
  385.     createAndWait(5)."
  386.    ::= { snmpNotifyFilterEntry 5 }
  387.  
  388. --
  389. --
  390. -- Conformance information
  391. --
  392. --
  393.  
  394. snmpNotifyCompliances OBJECT IDENTIFIER ::=
  395.                        { snmpNotifyConformance 1 }
  396. snmpNotifyGroups      OBJECT IDENTIFIER ::=
  397.                        { snmpNotifyConformance 2 }
  398.  
  399. --
  400. --
  401. -- Compliance statements
  402. --
  403. --
  404.  
  405. snmpNotifyBasicCompliance MODULE-COMPLIANCE
  406.    STATUS      current
  407.    DESCRIPTION
  408.        "The compliance statement for minimal SNMP entities which
  409.     implement only SNMP Traps and read-create operations on
  410.     only the snmpTargetAddrTable."
  411.    MODULE SNMP-TARGET-MIB
  412.        MANDATORY-GROUPS { snmpTargetBasicGroup }
  413.  
  414.        OBJECT snmpTargetParamsMPModel
  415.        MIN-ACCESS    read-only
  416.        DESCRIPTION
  417.        "Create/delete/modify access is not required."
  418.  
  419.        OBJECT snmpTargetParamsSecurityModel
  420.        MIN-ACCESS    read-only
  421.        DESCRIPTION
  422.        "Create/delete/modify access is not required."
  423.  
  424.        OBJECT snmpTargetParamsSecurityName
  425.        MIN-ACCESS    read-only
  426.        DESCRIPTION
  427.        "Create/delete/modify access is not required."
  428.  
  429.        OBJECT snmpTargetParamsSecurityLevel
  430.        MIN-ACCESS    read-only
  431.        DESCRIPTION
  432.        "Create/delete/modify access is not required."
  433.  
  434.        OBJECT snmpTargetParamsStorageType
  435.        SYNTAX INTEGER {
  436.        readOnly(5)
  437.        }
  438.        MIN-ACCESS    read-only
  439.        DESCRIPTION
  440.        "Create/delete/modify access is not required.
  441.         Support of the values other(1), volatile(2),
  442.         nonVolatile(3), and permanent(4) is not required."
  443.  
  444.        OBJECT snmpTargetParamsRowStatus
  445.        SYNTAX INTEGER {
  446.        active(1)
  447.        }
  448.        MIN-ACCESS    read-only
  449.        DESCRIPTION
  450.        "Create/delete/modify access to the
  451.         snmpTargetParamsTable is not required.
  452.         Support of the values notInService(2), notReady(3),
  453.         createAndGo(4), createAndWait(5), and destroy(6) is
  454.         not required."
  455.  
  456.    MODULE -- This Module
  457.        MANDATORY-GROUPS { snmpNotifyGroup }
  458.  
  459.        OBJECT snmpNotifyTag
  460.        MIN-ACCESS    read-only
  461.        DESCRIPTION
  462.        "Create/delete/modify access is not required."
  463.  
  464.        OBJECT snmpNotifyType
  465.        SYNTAX INTEGER {
  466.        trap(1)
  467.        }
  468.        MIN-ACCESS    read-only
  469.        DESCRIPTION
  470.        "Create/delete/modify access is not required.
  471.         Support of the value notify(2) is not required."
  472.  
  473.        OBJECT snmpNotifyStorageType
  474.        SYNTAX INTEGER {
  475.        readOnly(5)
  476.        }
  477.        MIN-ACCESS    read-only
  478.        DESCRIPTION
  479.        "Create/delete/modify access is not required.
  480.         Support of the values other(1), volatile(2),
  481.         nonVolatile(3), and permanent(4) is not required."
  482.  
  483.        OBJECT snmpNotifyRowStatus
  484.        SYNTAX INTEGER {
  485.        active(1)
  486.        }
  487.        MIN-ACCESS    read-only
  488.        DESCRIPTION
  489.        "Create/delete/modify access to the
  490.         snmpNotifyTable is not required.
  491.         Support of the values notInService(2), notReady(3),
  492.         createAndGo(4), createAndWait(5), and destroy(6) is
  493.         not required."
  494.  
  495.    ::= { snmpNotifyCompliances 1 }
  496.  
  497. snmpNotifyBasicFiltersCompliance MODULE-COMPLIANCE
  498.    STATUS      current
  499.    DESCRIPTION
  500.        "The compliance statement for SNMP entities which implement
  501.     SNMP Traps with filtering, and read-create operations on
  502.     all related tables."
  503.    MODULE SNMP-TARGET-MIB
  504.        MANDATORY-GROUPS { snmpTargetBasicGroup }
  505.    MODULE -- This Module
  506.        MANDATORY-GROUPS { snmpNotifyGroup,
  507.               snmpNotifyFilterGroup }
  508.    ::= { snmpNotifyCompliances 2 }
  509.  
  510. snmpNotifyFullCompliance MODULE-COMPLIANCE
  511.    STATUS      current
  512.    DESCRIPTION
  513.        "The compliance statement for SNMP entities which either
  514.     implement only SNMP Informs, or both SNMP Traps and SNMP
  515.     Informs, plus filtering and read-create operations on
  516.     all related tables."
  517.    MODULE SNMP-TARGET-MIB
  518.        MANDATORY-GROUPS { snmpTargetBasicGroup,
  519.               snmpTargetResponseGroup }
  520.    MODULE -- This Module
  521.        MANDATORY-GROUPS { snmpNotifyGroup,
  522.               snmpNotifyFilterGroup }
  523.    ::= { snmpNotifyCompliances 3 }
  524.  
  525. snmpNotifyGroup OBJECT-GROUP
  526.    OBJECTS {
  527.        snmpNotifyTag,
  528.        snmpNotifyType,
  529.        snmpNotifyStorageType,
  530.        snmpNotifyRowStatus
  531.    }
  532.    STATUS      current
  533.    DESCRIPTION
  534.        "A collection of objects for selecting which management
  535.     targets are used for generating notifications, and the
  536.     type of notification to be generated for each selected
  537.     management target."
  538.    ::= { snmpNotifyGroups 1 }
  539.  
  540. snmpNotifyFilterGroup OBJECT-GROUP
  541.    OBJECTS {
  542.        snmpNotifyFilterProfileName,
  543.        snmpNotifyFilterProfileStorType,
  544.        snmpNotifyFilterProfileRowStatus,
  545.        snmpNotifyFilterMask,
  546.        snmpNotifyFilterType,
  547.        snmpNotifyFilterStorageType,
  548.        snmpNotifyFilterRowStatus
  549.    }
  550.    STATUS      current
  551.    DESCRIPTION
  552.        "A collection of objects providing remote configuration
  553.     of notification filters."
  554.    ::= { snmpNotifyGroups 2 }
  555.  
  556. END
  557.