Compartilhar via

Macro TEXTUAL-CONVENTION

  • Artigo

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

Nota

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

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

  • A definição de tipo nomeado na cláusula SYNTAX mapeia verbatim para 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 SNMPv2C ou se referir a uma convenção textual implícita. O valor padrão é sempre NULL.
Convenção textual Tipo de variante CIM Qualificador de CIM
DateAndTime VT_BSTR textual_convention: DateAndTime
de codificação: OCTETSTRING
object_syntax: DateAndTime
de tipo cimtype: cadeia de caracteres
Displaystring VT_BSTR textual_convention: Displaystring
de codificação: OCTETSTRING
object_syntax: Displaystring
de tipo cimtype: cadeia de caracteres
MacAddress VT_BSTR textual_convention: MacAddress
de codificação: OCTETSTRING
object_syntax: MacAddress
de tipo cimtype: cadeia de caracteres
PhysAddress VT_BSTR textual_convention: PhysAddress
de codificação: OCTETSTRING
object_syntax: PhysAddress
de tipo cimtype: cadeia de caracteres
SnmpUDPAddress VT_BSTR textual_convention: SnmpUDPAddress
de codificação: OCTETSTRING
object_syntax: SnmpUDPAddress
de tipo cimtype: cadeia de caracteres
SnmpOSIAddress VT_BSTR textual_convention: SnmpOSIAddress
de codificação: OCTETSTRING
object_syntax: SnmpOSIAddress
de tipo cimtype: cadeia de caracteres
SnmpIPXAddress VT_BSTR textual_convention: SnmpIPXAddress
de codificação: OCTETSTRING
object_syntax: SnmpIPXAddress
de tipo cimtype: cadeia de caracteres
  • O tipo de variante definido pelo CIM e os qualificadores de propriedade CIM textual_convention, de codificação, object_syntaxe de tipo cimtype usando o tipo primitivo subjacente.
  • A cláusula DISPLAY-HINT da macro SNMPv2C TEXTUAL-CONVENTION mapeia verbatim para o qualificador de propriedade CIM display_hint. Esse qualificador não será gerado se não houver TEXTUAL-CONVENTION macro 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 SNMPv1.

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

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

Este exemplo gera os seguintes qualificadores de CIM.

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

O exemplo a seguir descreve uma convenção textual 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 seguintes qualificadores de CIM.

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