TEXTUAL-CONVENTION Macro

Le convenzioni testuali SNMP eseguono il mapping ai tipi definiti da CIM.

Nota

Per altre informazioni sull'installazione del provider, vedere Configurazione dell'ambiente SNMP WMI.

Le regole di mapping seguenti si applicano alle convenzioni testuali SNMP:

• La definizione del tipo denominato nella clausola SYNTAX esegue il mapping verbatim al qualificatore di proprietà CIM object_syntax.
• Utilizzare la tabella seguente per eseguire il mapping delle convenzioni testuali quando la clausola SYNTAX fa riferimento in modo esplicito a una convenzione testuale di una macro TEXTUAL-CONVENTION SNMPv2C oppure fa riferimento a una convenzione testuale implicita. Il valore predefinito è sempre NULL.

Convenzione testuale	Tipo variant CIM	Qualificatore 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

• Il tipo variant definito da CIM e i qualificatori di proprietà CIM textual_convention, codifica, object_syntax e cimtype mappa utilizzando il tipo primitivo sottostante.
• La clausola DISPLAY-HINT della macro SNMPv2C TEXTUAL-CONVENTION esegue il mapping verbatim al qualificatore di proprietà CIM display_hint. Questo qualificatore non viene generato se non è presente alcuna macro TEXTUAL-CONVENTION o la macro non contiene una clausola DISPLAY-HINT.

Codice di esempio

Nell'esempio seguente viene descritta una convenzione testuale SNMPv1.

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

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

In questo esempio vengono generati i qualificatori CIM seguenti.

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

Nell'esempio seguente viene descritta una convenzione testuale 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 ""

In questo esempio vengono generati i qualificatori CIM seguenti.

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