TEXTUAL-CONVENTION-Makro

SNMP-Textkonventionen werden CIM-definierten Typen zugeordnet.

Hinweis

Weitere Informationen zum Installieren des Anbieters finden Sie unter Einrichten der WMI-SNMP-Umgebung.

Die folgenden Zuordnungsregeln gelten für SNMP-Textkonventionen:

  • Die Definition des benannten Typs in der SYNTAX-Klausel ordnet der CIM-Eigenschaftenqualifiziererobjektsyntax _ ausführlich zu.
  • Verwenden Sie die folgende Tabelle, um Textkonventionen zuzuordnen, wenn die SYNTAX-Klausel explizit auf eine Textkonvention eines SNMPv2C TEXTUAL-CONVENTION-Makros oder auf eine implizite Textkonvention verweist. Der Standardwert ist immer NULL.
Textkonvention CIM-Variantentyp CIM-Qualifizierer
DateAndTime VT _ BSTR textual _ convention: DateAndTime
encoding: OCTETSTRING
_ Objektsyntax: DateAndTime
cimtype: string
Displaystring VT _ BSTR textual _ convention: Displaystring
encoding: OCTETSTRING
_ Objektsyntax: Displaystring
cimtype: string
MacAddress VT _ BSTR _ Textkonvention: MacAddress
encoding: OCTETSTRING
_ Objektsyntax: MacAddress
cimtype: string
PhysAddress VT _ BSTR textual _ convention: PhysAddress
encoding: OCTETSTRING
_ Objektsyntax: PhysAddress
cimtype: string
SnmpUDPAddress VT _ BSTR textual _ convention: SnmpUDPAddress
encoding: OCTETSTRING
_ Objektsyntax: SnmpUDPAddress
cimtype: string
SnmpOSIAddress VT _ BSTR textual _ convention: SnmpOSIAddress
encoding: OCTETSTRING
_ Objektsyntax: SnmpOSIAddress
cimtype: string
SnmpIPXAddress VT _ BSTR textual _ convention: SnmpIPXAddress
encoding: OCTETSTRING
_ Objektsyntax: SnmpIPXAddress
cimtype: string
  • Der CIM-definierte Variant-Typ und die CIM-Eigenschaftsqualifizierer textual _ convention, encoding, object _ syntax und cimtype map using the underlying primitive type.
  • Die DISPLAY-HINT-Klausel des SNMPv2C TEXTUAL-CONVENTION-Makros wird dem _ ANZEIGEhinweis des CIM-Eigenschaftsqualifizierers ausführlich zugeordnet. Dieser Qualifizierer wird nicht generiert, wenn kein TEXTUAL-CONVENTION-Makro vorhanden ist oder das Makro keine DISPLAY-HINT-Klausel enthält.

Beispielcode

Im folgenden Beispiel wird eine SNMPv1-Textkonvention beschrieben.

myNamedType ::= DISPLAYSTRING (SIZE (0..127))

myNamedProperty OBJECT-TYPE
SYNTAX  myNamedType
ACCESS read-only
STATUS MANDATORY
DESCRIPTION ""

In diesem Beispiel werden die folgenden CIM-Qualifizierer generiert.

object_syntax("myNamedType"),
textual_convention("DISPLAYSTRING"),
encoding("OCTETSTRING"),
variable_length("0..127")

Im folgenden Beispiel wird eine SNMPv2-Textkonvention beschrieben.

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

In diesem Beispiel werden die folgenden CIM-Qualifizierer generiert.

object_syntax("myDisplaystring"),
textual_convention("OCTETSTRING"),
encoding("OCTETSTRING"),
display_hint("255a"),
variable_length("0..127")