netconfcentral logo

SNMP-NOTIFICATION-MIB

HTML

SNMP-NOTIFICATION-MIB.yang



  module SNMP-NOTIFICATION-MIB {

    yang-version 1;

    namespace
      "urn:ietf:params:xml:ns:yang:smiv2:SNMP-NOTIFICATION-MIB";

    prefix snmp-notification;

    import SNMP-FRAMEWORK-MIB {
      prefix snmp-framework;
    }
    import SNMP-TARGET-MIB {
      prefix snmp-target;
    }
    import SNMPv2-TC {
      prefix smiv2;
    }
    import yang-smi {
      prefix smi;
    }
    import ietf-yang-types {
      prefix yang;
    }

    organization "IETF SNMPv3 Working Group";

    contact
      "WG-email:   snmpv3@lists.tislabs.com
      Subscribe:  majordomo@lists.tislabs.com
                  In message body:  subscribe snmpv3
      
      Co-Chair:   Russ Mundy
                  Network Associates Laboratories
      Postal:     15204 Omega Drive, Suite 300
                  Rockville, MD 20850-4601
                  USA
      EMail:      mundy@tislabs.com
      Phone:      +1 301-947-7107
      
      Co-Chair:   David Harrington
                  Enterasys Networks
      Postal:     35 Industrial Way
                  P. O. Box 5004
                  Rochester, New Hampshire 03866-5005
                  USA
      EMail:      dbh@enterasys.com
      Phone:      +1 603-337-2614
      
      Co-editor:  David B. Levi
                  Nortel Networks
      Postal:     3505 Kesterwood Drive
                  Knoxville, Tennessee 37918
      EMail:      dlevi@nortelnetworks.com
      Phone:      +1 865 686 0432
      
      Co-editor:  Paul Meyer
                  Secure Computing Corporation
      Postal:     2675 Long Lake Road
                  Roseville, Minnesota 55113
      EMail:      paul_meyer@securecomputing.com
      Phone:      +1 651 628 1592
      
      Co-editor:  Bob Stewart
                  Retired";

    description
      "This MIB module defines MIB objects which provide
      mechanisms to remotely configure the parameters
      used by an SNMP entity for the generation of
      notifications.
      
      Copyright (C) The Internet Society (2002). This
      version of this MIB module is part of RFC 3413;
      see the RFC itself for full legal notices.";

    revision "2002-10-14" {
      description
        "Clarifications, published as
         RFC 3413.";
    }

    revision "1998-08-04" {
      description
        "Clarifications, published as
         RFC 2573.";
    }

    revision "1997-07-14" {
      description
        "The initial revision, published as RFC2273.";
    }


    container snmpNotifyObjects {
      smi:oid "1.3.6.1.6.3.13.1";
      list snmpNotifyEntry {
        smi:oid "1.3.6.1.6.3.13.1.1.1";
        key "snmpNotifyName";
        description
          "An entry in this table selects a set of management targets
            which should receive notifications, as well as the type of
            
            notification which should be sent to each selected
            management target.
            
            Entries in the snmpNotifyTable are created and
            deleted using the snmpNotifyRowStatus object.";
        leaf snmpNotifyName {
          smi:oid "1.3.6.1.6.3.13.1.1.1.1";
          type snmp-framework:SnmpAdminString {
            length "1..32";
          }
          description
            "The locally arbitrary, but unique identifier associated
               with this snmpNotifyEntry.";
        }

        leaf snmpNotifyTag {
          smi:default "";
          smi:oid "1.3.6.1.6.3.13.1.1.1.2";
          type snmp-target:SnmpTagValue;
          description
            "This object contains a single tag value which is used
               to select entries in the snmpTargetAddrTable.  Any entry
               in the snmpTargetAddrTable which contains a tag value
               which is equal to the value of an instance of this
               object is selected.  If this object contains a value
               of zero length, no entries are selected.";
        }

        leaf snmpNotifyType {
          smi:default "trap";
          smi:oid "1.3.6.1.6.3.13.1.1.1.3";
          type enumeration {
            enum "trap" {
              value 1;
            }
            enum "inform" {
              value 2;
            }
          }
          description
            "This object determines the type of notification to
               
               be generated for entries in the snmpTargetAddrTable
               selected by the corresponding instance of
               snmpNotifyTag.  This value is only used when
               generating notifications, and is ignored when
               using the snmpTargetAddrTable for other purposes.
               
               If the value of this object is trap(1), then any
               messages generated for selected rows will contain
               Unconfirmed-Class PDUs.
               
               If the value of this object is inform(2), then any
               messages generated for selected rows will contain
               Confirmed-Class PDUs.
               
               Note that if an SNMP entity only supports
               generation of Unconfirmed-Class PDUs (and not
               Confirmed-Class PDUs), then this object may be
               read-only.";
        }

        leaf snmpNotifyStorageType {
          smi:default "nonVolatile";
          smi:oid "1.3.6.1.6.3.13.1.1.1.4";
          type smiv2:StorageType;
          description
            "The storage type for this conceptual row.
               Conceptual rows having the value 'permanent' need not
               allow write-access to any columnar objects in the row.";
        }

        leaf snmpNotifyRowStatus {
          smi:oid "1.3.6.1.6.3.13.1.1.1.5";
          type smiv2:RowStatus;
          description
            "The status of this conceptual row.
               
               To create a row in this table, a manager must
               set this object to either createAndGo(4) or
               createAndWait(5).";
        }
      }  // list snmpNotifyEntry

      list snmpNotifyFilterProfileEntry {
        smi:oid "1.3.6.1.6.3.13.1.2.1";
        key "snmpTargetParamsName";
        description
          "An entry in this table indicates the name of the filter
            profile to be used when generating notifications using
            the corresponding entry in the snmpTargetParamsTable.
            
            Entries in the snmpNotifyFilterProfileTable are created
            and deleted using the snmpNotifyFilterProfileRowStatus
            object.";
        leaf snmpTargetParamsName {
          type leafref {
            path "/snmp-target:snmpTargetObjects/snmp-target:snmpTargetParamsEntry/snmp-target:snmpTargetParamsName";
          }
          description
            "Automagically generated leafref leaf.";
        }

        leaf snmpNotifyFilterProfileName {
          smi:oid "1.3.6.1.6.3.13.1.2.1.1";
          type snmp-framework:SnmpAdminString {
            length "1..32";
          }
          description
            "The name of the filter profile to be used when generating
               notifications using the corresponding entry in the
               snmpTargetAddrTable.";
        }

        leaf snmpNotifyFilterProfileStorType {
          smi:default "nonVolatile";
          smi:oid "1.3.6.1.6.3.13.1.2.1.2";
          type smiv2:StorageType;
          description
            "The storage type for this conceptual row.
               Conceptual rows having the value 'permanent' need not
               allow write-access to any columnar objects in the row.";
        }

        leaf snmpNotifyFilterProfileRowStatus {
          smi:oid "1.3.6.1.6.3.13.1.2.1.3";
          type smiv2:RowStatus;
          description
            "The status of this conceptual row.
               
               To create a row in this table, a manager must
               set this object to either createAndGo(4) or
               createAndWait(5).
               
               Until instances of all corresponding columns are
               appropriately configured, the value of the
               corresponding instance of the
               snmpNotifyFilterProfileRowStatus column is 'notReady'.
               
               In particular, a newly created row cannot be made
               active until the corresponding instance of
               snmpNotifyFilterProfileName has been set.";
        }
      }  // list snmpNotifyFilterProfileEntry

      list snmpNotifyFilterEntry {
        smi:oid "1.3.6.1.6.3.13.1.3.1";
        key "snmpNotifyFilterProfileName snmpNotifyFilterSubtree";
        description
          "An element of a filter profile.
            
            Entries in the snmpNotifyFilterTable are created and
            deleted using the snmpNotifyFilterRowStatus object.";
        leaf snmpNotifyFilterProfileName {
          type leafref {
            path "/snmp-notification:snmpNotifyObjects/snmp-notification:snmpNotifyFilterProfileEntry/snmp-notification:snmpNotifyFilterProfileName";
          }
          description
            "Automagically generated leafref leaf.";
        }

        leaf snmpNotifyFilterSubtree {
          smi:oid "1.3.6.1.6.3.13.1.3.1.1";
          type yang:object-identifier;
          description
            "The MIB subtree which, when combined with the corresponding
               instance of snmpNotifyFilterMask, defines a family of
               subtrees which are included in or excluded from the
               filter profile.";
        }

        leaf snmpNotifyFilterMask {
          smi:default "";
          smi:oid "1.3.6.1.6.3.13.1.3.1.2";
          type binary {
            length "0..16";
          }
          description
            "The bit mask which, in combination with the corresponding
               instance of snmpNotifyFilterSubtree, defines a family of
               subtrees which are included in or excluded from the
               filter profile.
               
               Each bit of this bit mask corresponds to a
               sub-identifier of snmpNotifyFilterSubtree, with the
               most significant bit of the i-th octet of this octet
               string value (extended if necessary, see below)
               corresponding to the (8*i - 7)-th sub-identifier, and
               the least significant bit of the i-th octet of this
               octet string corresponding to the (8*i)-th
               sub-identifier, where i is in the range 1 through 16.
               
               Each bit of this bit mask specifies whether or not
               the corresponding sub-identifiers must match when
               determining if an OBJECT IDENTIFIER matches this
               family of filter subtrees; a '1' indicates that an
               exact match must occur; a '0' indicates 'wild card',
               i.e., any sub-identifier value matches.
               
               Thus, the OBJECT IDENTIFIER X of an object instance
               is contained in a family of filter subtrees if, for
               each sub-identifier of the value of
               snmpNotifyFilterSubtree, either:
               
                 the i-th bit of snmpNotifyFilterMask is 0, or
               
                 the i-th sub-identifier of X is equal to the i-th
                 sub-identifier of the value of
                 snmpNotifyFilterSubtree.
               
               If the value of this bit mask is M bits long and
               there are more than M sub-identifiers in the
               corresponding instance of snmpNotifyFilterSubtree,
               then the bit mask is extended with 1's to be the
               required length.
               
               Note that when the value of this object is the
               zero-length string, this extension rule results in
               a mask of all-1's being used (i.e., no 'wild card'),
               and the family of filter subtrees is the one
               subtree uniquely identified by the corresponding
               instance of snmpNotifyFilterSubtree.";
        }

        leaf snmpNotifyFilterType {
          smi:default "included";
          smi:oid "1.3.6.1.6.3.13.1.3.1.3";
          type enumeration {
            enum "included" {
              value 1;
            }
            enum "excluded" {
              value 2;
            }
          }
          description
            "This object indicates whether the family of filter subtrees
               defined by this entry are included in or excluded from a
               filter.  A more detailed discussion of the use of this
               object can be found in section 6. of [SNMP-APPL].";
        }

        leaf snmpNotifyFilterStorageType {
          smi:default "nonVolatile";
          smi:oid "1.3.6.1.6.3.13.1.3.1.4";
          type smiv2:StorageType;
          description
            "The storage type for this conceptual row.
               Conceptual rows having the value 'permanent' need not
               
               allow write-access to any columnar objects in the row.";
        }

        leaf snmpNotifyFilterRowStatus {
          smi:oid "1.3.6.1.6.3.13.1.3.1.5";
          type smiv2:RowStatus;
          description
            "The status of this conceptual row.
               
               To create a row in this table, a manager must
               set this object to either createAndGo(4) or
               createAndWait(5).";
        }
      }  // list snmpNotifyFilterEntry
    }  // container snmpNotifyObjects
  }  // module SNMP-NOTIFICATION-MIB

Summary

  
  
Organization IETF SNMPv3 Working Group
  
Module SNMP-NOTIFICATION-MIB
Version 2002-10-14
File SNMP-NOTIFICATION-MIB.yang
  
Prefix snmp-notification
Namespace urn:ietf:params:xml:ns:yang:smiv2:SNMP-NOTIFICATION-MIB
  
Cooked /cookedmodules/SNMP-NOTIFICATION-MIB/2002-10-14
YANG /src/SNMP-NOTIFICATION-MIB@2002-10-14.yang
XSD /xsd/SNMP-NOTIFICATION-MIB@2002-10-14.xsd
  
Abstract This MIB module defines MIB objects which provide mechanisms to remotely configure the parameters used by an SNMP entity for the...
  
Contact
WG-email:   snmpv3@lists.tislabs.com
Subscribe:  majordomo@lists.tislabs.com
	    In message body:  subscribe snmpv3

Co-Chair:   Russ Mundy
	    Network Associates Laboratories
Postal:     15204 Omega Drive, Suite 300
	    Rockville, MD 20850-4601
	    USA
EMail:      mundy@tislabs.com
Phone:      +1 301-947-7107

Co-Chair:   David Harrington
	    Enterasys Networks
Postal:     35 Industrial Way
	    P. O. Box 5004
	    Rochester, New Hampshire 03866-5005
	    USA
EMail:      dbh@enterasys.com
Phone:      +1 603-337-2614

Co-editor:  David B. Levi
	    Nortel Networks
Postal:     3505 Kesterwood Drive
	    Knoxville, Tennessee 37918
EMail:      dlevi@nortelnetworks.com
Phone:      +1 865 686 0432

Co-editor:  Paul Meyer
	    Secure Computing Corporation
Postal:     2675 Long Lake Road
	    Roseville, Minnesota 55113
EMail:      paul_meyer@securecomputing.com
Phone:      +1 651 628 1592

Co-editor:  Bob Stewart
	    Retired

Description

 
This MIB module defines MIB objects which provide
mechanisms to remotely configure the parameters
used by an SNMP entity for the generation of
notifications.

Copyright (C) The Internet Society (2002). This
version of this MIB module is part of RFC 3413;
see the RFC itself for full legal notices.

Objects

Type Key
Mandatory config
Optional config
Not config
Object Type Abstract
snmpNotifyObjects container snmpNotifyEntry snmpNotifyFilterProfileEntry snmpNotifyFilterEntry
   snmpNotifyEntry list An entry in this table selects a set of management targets which should receive notifications, as well as the type of notification which should be sent to each selected management target. Entries in the snmpNotifyTable are created and deleted using the ...
      snmpNotifyName leaf The locally arbitrary, but unique identifier associated with this snmpNotifyEntry.
      snmpNotifyRowStatus leaf The status of this conceptual row. To create a row in this table, a manager must set this object to either createAndGo(4) or createAndWait(5).
      snmpNotifyStorageType leaf The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.
      snmpNotifyTag leaf This object contains a single tag value which is used to select entries in the snmpTargetAddrTable. Any entry in the snmpTargetAddrTable which contains a tag value which is equal to the value of an instance of this object is selected. If this object con...
      snmpNotifyType leaf This object determines the type of notification to be generated for entries in the snmpTargetAddrTable selected by the corresponding instance of snmpNotifyTag. This value is only used when generating notifications, and is ignored when using the snmpTarg...
   snmpNotifyFilterEntry list An element of a filter profile. Entries in the snmpNotifyFilterTable are created and deleted using the snmpNotifyFilterRowStatus object.
      snmpNotifyFilterMask leaf The bit mask which, in combination with the corresponding instance of snmpNotifyFilterSubtree, defines a family of subtrees which are included in or excluded from the filter profile. Each bit of this bit mask corresponds to a sub-identifier of snmpNotify...
      snmpNotifyFilterProfileName leaf Automagically generated leafref leaf.
      snmpNotifyFilterRowStatus leaf The status of this conceptual row. To create a row in this table, a manager must set this object to either createAndGo(4) or createAndWait(5).
      snmpNotifyFilterStorageType leaf The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.
      snmpNotifyFilterSubtree leaf The MIB subtree which, when combined with the corresponding instance of snmpNotifyFilterMask, defines a family of subtrees which are included in or excluded from the filter profile.
      snmpNotifyFilterType leaf This object indicates whether the family of filter subtrees defined by this entry are included in or excluded from a filter. A more detailed discussion of the use of this object can be found in section 6. of [SNMP-APPL].
   snmpNotifyFilterProfileEntry list An entry in this table indicates the name of the filter profile to be used when generating notifications using the corresponding entry in the snmpTargetParamsTable. Entries in the snmpNotifyFilterProfileTable are created and deleted using the snmpNotifyF...
      snmpNotifyFilterProfileName leaf The name of the filter profile to be used when generating notifications using the corresponding entry in the snmpTargetAddrTable.
      snmpNotifyFilterProfileRowStatus leaf The status of this conceptual row. To create a row in this table, a manager must set this object to either createAndGo(4) or createAndWait(5). Until instances of all corresponding columns are appropriately configured, the value of the corresponding inst...
      snmpNotifyFilterProfileStorType leaf The storage type for this conceptual row. Conceptual rows having the value 'permanent' need not allow write-access to any columnar objects in the row.
      snmpTargetParamsName leaf Automagically generated leafref leaf.