The NOTIFICATION-TYPE macro contains the following elements.
Note For more information about support or requirements for installation on a specific operating system, see Operating System Availability of WMI Components.
- Object descriptor
Attaches a name to an SNMP event in a NOTIFICATION-TYPE macro. The following table lists the rules for mapping the object descriptor.
Type Concatenate Encapsulated CIM class name "SNMP_"
MIB module identity name
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
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.
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.