Compartilhar via

Macro TEXTUAL-CONVENTION

  • Artigo

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