Condividi tramite

macro TEXTUAL-CONVENTION

  • 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 di convenzioni testuali quando la clausola SYNTAX fa riferimento in modo esplicito a una convenzione testuale di una macro SNMPv2C TEXTUAL-CONVENTION 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
codifica: OCTETSTRING
object_syntax: DateAndTime
cimtype: string
Displaystring VT_BSTR textual_convention: Displaystring
codifica: OCTETSTRING
object_syntax: Displaystring
cimtype: string
MacAddress VT_BSTR textual_convention: MacAddress
codifica: OCTETSTRING
object_syntax: MacAddress
cimtype: string
PhysAddress VT_BSTR textual_convention: PhysAddress
codifica: OCTETSTRING
object_syntax: PhysAddress
cimtype: string
SnmpUDPAddress VT_BSTR textual_convention: SnmpUDPAddress
codifica: OCTETSTRING
object_syntax: SnmpUDPAddress
cimtype: string
SnmpOSIAddress VT_BSTR textual_convention: SnmpOSIAddress
codifica: OCTETSTRING
object_syntax: SnmpOSIAddress
cimtype: string
SnmpIPXAddress VT_BSTR textual_convention: SnmpIPXAddress
codifica: OCTETSTRING
object_syntax: SnmpIPXAddress
cimtype: string
  • Il tipo variant definito da CIM e i qualificatori di proprietà CIM textual_convention, codifica, object_syntaxe cimtype mappa usando il tipo primitivo sottostante.
  • La clausola DISPLAY-HINT del TEXTUAL-CONVENTION macro SNMPv2C esegue il mapping verbatim al qualificatore di proprietà CIM display_hint. Questo qualificatore non viene generato se non è presente alcuna macro TEXTUAL-CONVENTION oppure la macro non contiene una clausola DISPLAY-HINT.

Codice di esempio

L'esempio seguente descrive una convenzione testuale SNMPv1.

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

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

Questo esempio genera i qualificatori CIM seguenti.

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

L'esempio seguente descrive 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 ""

Questo esempio genera i qualificatori CIM seguenti.

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