Partilhar via

TEXTUAL-CONVENTION Macro

  • Artigo

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

Observação

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

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

  • A definição de tipo nomeado na cláusula SYNTAX mapeia literalmente 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 CIM
DataAndHora VT_BSTR textual_convention: DateAndTime
codificação: OCTETSTRING
object_syntax: DateAndTime
cimtype: string
Displaystring VT_BSTR textual_convention: Displaystring
codificação: OCTETSTRING
object_syntax: Displaystring
cimtype: string
MacEndereço VT_BSTR textual_convention: MacAddress
codificação: OCTETSTRING
object_syntax: MacAddress
cimtype: string
PhysAddress VT_BSTR textual_convention: PhysAddress
codificação: OCTETSTRING
object_syntax: PhysAddress
cimtype: string
SnmpUDPAddress VT_BSTR textual_convention: SnmpUDPAddress
codificação: OCTETSTRING
object_syntax: SnmpUDPAddress
cimtype: string
SnmpOSIAddress VT_BSTR textual_convention: SnmpOSIAddress
codificação: OCTETSTRING
object_syntax: SnmpOSIAddress
cimtype: string
SnmpIPXAddress VT_BSTR textual_convention: SnmpIPXAddress
codificação: OCTETSTRING
object_syntax: SnmpIPXAddress
cimtype: string
  • O tipo de variante definido pelo CIM e os qualificadores de propriedade CIM textual_convention, codificação, object_syntaxe cimtype mapear usando o tipo primitivo subjacente.
  • A cláusula DISPLAY-HINT da macro SNMPv2C TEXTUAL-CONVENTION mapeia literalmente para o qualificador de propriedade CIM display_hint. Este qualificador não é 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 SNMPv1.

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

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

Este exemplo gera os seguintes qualificadores 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 CIM.

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