Condividi tramite

TEXTUAL-CONVENTION Macro

  • Articolo

Le convenzioni testuali SNMP eseguono il mapping ai tipi definiti da CIM.

Nota

Per altre informazioni sull'installazione del provider, vedere Configurazione dell'ambiente SNMP WMI.

Le regole di mapping seguenti si applicano alle convenzioni testuali SNMP:

  • La definizione del tipo denominato nella clausola SYNTAX esegue il mapping verbatim al qualificatore di proprietà CIM object_syntax.
  • Utilizzare la tabella seguente per eseguire il mapping delle convenzioni testuali quando la clausola SYNTAX fa riferimento in modo esplicito a una convenzione testuale di una macro TEXTUAL-CONVENTION SNMPv2C oppure fa riferimento a una convenzione testuale implicita. Il valore predefinito è sempre NULL.
Convenzione testuale Tipo variant CIM Qualificatore 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
  • Il tipo variant definito da CIM e i qualificatori di proprietà CIM textual_convention, codifica, object_syntax e cimtype mappa utilizzando il tipo primitivo sottostante.
  • La clausola DISPLAY-HINT della macro SNMPv2C TEXTUAL-CONVENTION esegue il mapping verbatim al qualificatore di proprietà CIM display_hint. Questo qualificatore non viene generato se non è presente alcuna macro TEXTUAL-CONVENTION o la macro non contiene una clausola DISPLAY-HINT.

Codice di esempio

Nell'esempio seguente viene descritta una convenzione testuale SNMPv1.

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

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

In questo esempio vengono generati i qualificatori CIM seguenti.

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

Nell'esempio seguente viene descritta una convenzione testuale 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 ""

In questo esempio vengono generati i qualificatori CIM seguenti.

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