Edit

Share via

NOTIFICATION-TYPE Macro

  • Article

The NOTIFICATION-TYPE macro contains the following elements.

Note

For more information about installing the provider, see Setting up the WMI SNMP Environment.

Components

Object descriptor

Attaches a name to an SNMP event in a NOTIFICATION-TYPE macro. The following list lists the rules for mapping the object descriptor.

Type Concatenate
Encapsulated CIM class name "SNMP_"
MIB module identity name
underscore (_)
object descriptor
"_Notification"
Example: The vtpServerDisabled notification from the CISCO-VTP-MIB maps to SNMP_CISCO_VTP_MIB_vtpServerDisabled_Notification.
Referent CIM class name "SNMP_"
MIB module identity name
underscore (_)
object descriptor
"_ExtendedNotification"
Example: The vtpServerDisabled notification from the CISCO-VTP-MIB maps to SNMP_CISCO_VTP_MIB_vtpServerDisabled_ExtendedNotification.

OBJECTS clause

Enumerates the set of objects associated with the notification object.

REFERENCE clause

Refers to another document that contains more information about the object. It maps to the CIM class qualifier Reference, which is of type string.

DESCRIPTION clause

Describes the object in question. It maps to the CIM class qualifier Description, which is of type string

STATUS clause

Indicates whether the object must be supported. When the status is either obsolete or deprecated, the notification is discarded from the mapping. Otherwise, this clause maps to the CIM class qualifier Status, which is of type string.

For SNMPv1, the preferred value of Status is either mandatory or optional, but the qualifier can contain some other value. For SNMPv2C, the preferred value of Status is either current or deprecated, but the qualifier can contain some other value.

Remarks

The SNMP provider maps the NOTIFICATION-TYPE macro to either an encapsulated or referent class definition.

An encapsulated class definition does not expose the instance information associated with the MIB object. Instead, the class definition encodes the OBJECTS clause as a series of properties of the CIM event class. Each CIM property reflects the name, type, and value of the corresponding MIB object in the OBJECTS clause. If you require instance information, you must map to a referent class. An encapsulated class definition maps to the SnmpNotification class.

A referent class defines an MIB object and the instance information used to obtain the object. The class definition encodes the OBJECTS clause as a series of properties of the CIM event class. Each CIM property reflects the name of the corresponding MIB object in the OBJECTS clause and the type as an embedded object that reflects an instance of the class associated with that MIB object. The provider then generates a class associated with the MIB object. For example, ifIndex maps to an embedded class named SNMP_RFC1213_MIB_ifIndex. For more information about this type of class, see OBJECT-TYPE Macro.