Macro CONVENTION TEXTUELLE
Les conventions textuelles SNMP sont mappées aux types définis par CIM.
Notes
Pour plus d’informations sur l’installation du fournisseur, consultez Configuration de l’environnement SNMP WMI.
Les règles de mappage suivantes s’appliquent aux conventions textuelles SNMP :
- La définition de type nommé dans la clause SYNTAX est mappée au qualificateur de propriété CIM object_syntax.
- Utilisez le tableau suivant pour mapper des conventions textuelles lorsque la clause SYNTAX fait explicitement référence à une convention textuelle d’une macro SNMPv2C TEXTUAL-CONVENTION, ou fait référence à une convention textuelle implicite. La valeur par défaut est toujours NULL.
Convention textuelle | Type de variante CIM | Qualificateur CIM |
---|---|---|
DateAndTime | VT_BSTR |
textual_convention: DateAndTime encoding: OCTETSTRING object_syntax: DateAndTime cimtype: string |
Displaystring | VT_BSTR |
textual_convention: Displaystring encoding: OCTETSTRING object_syntax: Displaystring cimtype: string |
MacAddress | VT_BSTR |
textual_convention: MacAddress encoding: OCTETSTRING object_syntax: MacAddress cimtype: string |
PhysAddress | VT_BSTR |
textual_convention: PhysAddress encoding: OCTETSTRING object_syntax: PhysAddress cimtype: string |
SnmpUDPAddress | VT_BSTR |
textual_convention: SnmpUDPAddress encoding: OCTETSTRING object_syntax: SnmpUDPAddress cimtype: string |
SnmpOSIAddress | VT_BSTR |
textual_convention: SnmpOSIAddress encoding: OCTETSTRING object_syntax: SnmpOSIAddress cimtype: string |
SnmpIPXAddress | VT_BSTR |
textual_convention: SnmpIPXAddress encoding: OCTETSTRING object_syntax: SnmpIPXAddress cimtype: string |
- Le type de variante défini par CIM et les qualificateurs de propriété CIM textual_convention, encoding, object_syntax et cimtype mappent à l’aide du type primitif sous-jacent.
- La clause DISPLAY-HINT de la macro SNMPv2C TEXTUAL-CONVENTION mappe textuellement le qualificateur de propriété CIM display_hint. Ce qualificateur n’est pas généré s’il n’existe aucune macro TEXTUAL-CONVENTION ou si la macro ne contient pas de clause DISPLAY-HINT.
Exemple de code
L’exemple suivant décrit une convention textuelle SNMPv1.
myNamedType ::= DISPLAYSTRING (SIZE (0..127))
myNamedProperty OBJECT-TYPE
SYNTAX myNamedType
ACCESS read-only
STATUS MANDATORY
DESCRIPTION ""
Cet exemple génère les qualificateurs CIM suivants.
object_syntax("myNamedType"),
textual_convention("DISPLAYSTRING"),
encoding("OCTETSTRING"),
variable_length("0..127")
L’exemple suivant décrit une convention textuelle SNMPv2.
myDisplaystring ::= TEXTUAL-CONVENTION
DISPLAY-HINT "255a"
STATUS current
DESCRIPTION ""
SYNTAX OCTET STRING (SIZE (0..127))
myNamedProperty OBJECT-TYPE
SYNTAX myDisplaystring
MAX-ACCESS read-only
STATUS current
DESCRIPTION ""
Cet exemple génère les qualificateurs CIM suivants.
object_syntax("myDisplaystring"),
textual_convention("OCTETSTRING"),
encoding("OCTETSTRING"),
display_hint("255a"),
variable_length("0..127")