Compartir a través de

Macro TEXTUAL-CONVENTION

  • Artículo

Las convenciones textuales SNMP se asignan a tipos definidos por CIM.

Nota

Para obtener más información sobre cómo instalar el proveedor, vea Configuración del entorno SNMP de WMI.

Las siguientes reglas de asignación se aplican a las convenciones textuales SNMP:

  • La definición de tipo con nombre de la cláusula SYNTAX asigna textualmente al calificador de propiedad CIM object_syntax.
  • Use la tabla siguiente para asignar convenciones textuales cuando la cláusula SYNTAX hace referencia explícitamente a una convención textual de una macro TEXTUAL-CONVENTION de SNMPv2C o hace referencia a una convención textual implícita. El valor predeterminado siempre es NULL.
Convención textual Tipo de variante CIM Calificador 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
  • El tipo de variante definido por CIM y los calificadores de propiedad CIM textual_convention, encoding, object_syntax, y cimtype se asignan mediante el tipo primitivo subyacente.
  • La cláusula DISPLAY-HINT de la macro TEXTUAL-CONVENTION de SNMPv2C se asigna textualmente al calificador de la propiedad CIM display_hint. Este calificador no se genera si no hay ninguna macro TEXTUAL-CONVENTION o la macro no contiene una cláusula DISPLAY-HINT.

Código de ejemplo

En el ejemplo siguiente se describe una convención textual de SNMPv1.

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

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

En este ejemplo se generan los siguientes calificadores CIM.

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

En el ejemplo siguiente se describe una convención textual de 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 ""

En este ejemplo se generan los siguientes calificadores CIM.

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