Macro TEXTUAL-CONVENTION

As convenções textuais do SNMP são mapeadas para tipos definidos pelo CIM.

Observação

Para obter mais informações sobre como instalar o provedor, consulte Configurar o ambiente SNMP do WMI.

As seguintes regras de mapeamento se aplicam às convenções textuais do SNMP:

• A definição de tipo nomeado na cláusula SYNTAX mapeia textualmente como o qualificador de propriedade CIM object_syntax.
• Use a tabela a seguir para mapear convenções textuais quando a cláusula SYNTAX se referir explicitamente a uma convenção textual de uma macro TEXTUAL-CONVENTION do SNMPv2C ou se referir a uma convenção textual implícita. O valor padrão é sempre NULL.

Convenção textual	Tipo de variante do CIM	Qualificador do 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

• O tipo de variante definido pelo CIM e os qualificadores de propriedade do CIM textual_convention, encoding, object_syntax e cimtype mapeiam usando o tipo primitivo subjacente.
• A cláusula DISPLAY-HINT da macro TEXTUAL-CONVENTION do SNMPv2C mapeia textualmente como o qualificador de propriedade do CIM display_hint. Esse qualificador não será gerado se não houver nenhuma macro TEXTUAL-CONVENTION ou se a macro não contiver uma cláusula DISPLAY-HINT.

Código de exemplo

O exemplo a seguir descreve uma convenção textual do SNMPv1.

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

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

Este exemplo gera os qualificadores do CIM a seguir.

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

O exemplo a seguir descreve uma convenção textual do 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 ""

Este exemplo gera os qualificadores do CIM a seguir.

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