Macro TEXTUAL-CONVENTION

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