Macro CONVENTION TEXTUELLE

  • Article

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")