Partager via

macro TEXTUAL-CONVENTION

  • Article

Les conventions textuelles SNMP correspondent aux types définis par CIM.

Note

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 mappe le verbatim 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
encodage: OCTETSTRING
object_syntax: DateAndTime
cimtype: chaîne
Chaîne d’affichage VT_BSTR textual_convention: Displaystring
encodage: OCTETSTRING
object_syntax: Displaystring
cimtype: chaîne
MacAddress VT_BSTR textual_convention: MacAddress
encodage: OCTETSTRING
object_syntax: MacAddress
cimtype: chaîne
PhysAddress VT_BSTR textual_convention: PhysAddress
encodage: OCTETSTRING
object_syntax: PhysAddress
cimtype: chaîne
SnmpUDPAddress VT_BSTR textual_convention: SnmpUDPAddress
encodage: OCTETSTRING
object_syntax: SnmpUDPAddress
cimtype: chaîne
SnmpOSIAddress VT_BSTR textual_convention: SnmpOSIAddress
encodage: OCTETSTRING
object_syntax: SnmpOSIAddress
cimtype: chaîne
SnmpIPXAddress VT_BSTR textual_convention: SnmpIPXAddress
encodage: OCTETSTRING
object_syntax: SnmpIPXAddress
cimtype: chaîne
  • Type de variante défini par CIM et qualificateurs de propriété CIM textual_convention, encodage, object_syntaxet carte cimtype à l’aide du type primitif sous-jacent.
  • La clause DISPLAY-HINT de la macro SNMPv2C TEXTUAL-CONVENTION mappe les commentaires au 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")