SZINTAXIS záradék

Az OBJECT-TYPE makró egy SZINTAXIS záradékot tartalmaz, amely meghatározza a MIB-objektum adatait és típusát. Míg az SNMP-szolgáltató megfigyeli a SZINTAXIS-záradékok leképezésére vonatkozó általános szabályokat, a szolgáltató számos adattípusra vonatkozó szabályokat is követ.

Az alábbi leképezési szabályok az alábbi táblázatban ismertetett összes adattípusra vonatkoznak:

• A SZINTAXIS záradék szöveges ábrázolása a CIM tulajdonság-minősítő textual_conventionlesz.
• A SZINTAXIS záradékban szereplő elnevezett típusdefiníció a CIM-tulajdonság minősítőjének object_syntaxlesz leképezve. Ez a leképezés az adattípustól függően eltérő. További információkért tekintse meg a leképezési leírásokat.
• Az SNMPv1 és az SNMPv2C protokollkeretek kódolásához használt SNMP-típus a CIM tulajdonság minősítőjéhez kódolási.
• A CIM tulajdonság-minősítő cimtype tartalmazza a mögöttes CIM protokoll értékét formázó szöveges ábrázolásokat.

Az alábbi táblázat azokat az adattípusokat sorolja fel, amelyek a szolgáltatóleképezési viselkedést szabályozó konkrét szabályokkal rendelkeznek.

Primitív típus

A primitív típus az RFC 1213- és RFC 1903-as dokumentumaiban definiált alapvető adattípusok egyike. Az SNMP primitív típusai a CIM által definiált típusokra képeznek le. Az alábbi táblázat felsorolja azokat a leképezéseket, amelyek akkor fordulnak elő, amikor a SZINTAXIS záradék explicit módon hivatkozik az SNMPv1 primitív típusára. A textual_convention, kódolásiés object_syntax minősítők mindig megegyeznek a MIB típusával, és az alapértelmezett érték mindig NULL.

A szolgáltató figyelmen kívül hagyja a OBJECT-TYPE makrót, amikor a SZINTAXIS záradék NULLhivatkozik explicit módon vagy egy elnevezett típus-hozzárendelésen keresztül. Az alábbi táblázat felsorolja azokat a leképezéseket, amelyek akkor fordulnak elő, amikor a SZINTAXIS záradék explicit módon hivatkozik az SNMPv2 primitív típusára. A textual_convention, kódolásiés object_syntax minősítők mindig megegyeznek a MIB típusával, és az alapértelmezett érték mindig NULL.

Névvel ellátott típus

Az SNMP által elnevezett típusok a CIM által definiált típusokra lesznek leképezve. Ha a SZINTAXIS záradék egy primitív típusú, szöveges konvenciós, vagy korlátozott típusra egy típus-hozzárendelési származtatáson keresztül, a típusokkal állapítsa meg, hogy mely leképezési eljárások alkalmazhatók.

• Ha a típus-hozzárendelési szabályok származtatásával korlátozott típusdefinícióval találkozik:

  • Ha pedig további származtatással találkozik az TEXTUAL-CONVENTION Makrófelsorolt szöveges konvenciók egyikével, alkalmazza a korlátozott típusok és szöveges konvenciók leképezési szabályait.
  • Ellenkező esetben, ha valamelyik primitív típustáblában szereplő primitív típussal találkozik, alkalmazza a leképezési szabályokat a primitív és a korlátozott típusok esetében.

• Ha a TEXTUAL_CONVENTION Makrófelsorolt szöveges konvenciók egyikével találkozik, alkalmazza a szöveges konvenciók leképezési szabályait.

• Ha valamelyik primitív típustáblában felsorolt primitív típussal találkozik, alkalmazza a primitív típusok leképezési szabályait.

Korlátozott típus

A korlátozott típus egy primitív típus, névvel ellátott típus vagy szöveges konvenció, amelyet az RFC 1213 és az RFC 1903 SMI-dokumentumokban meghatározott altípus-meghatározási mechanizmus korlátoz. Az altípusértékek megadásához további CIM-minősítőkre van szükség az altípusértékek megadásához. A SZINTAXIS záradékban szereplő elnevezett típusú definíció a cim tulajdonság minősítőjének szó szerinti leképezését object_syntax, de az altípus korlátait nem tartalmazza.

Az altípusok a következő formátumok bármelyikét követhetik:

• Számbavett EGÉSZ SZÁM

  A CIM tulajdonság minősítője enumerálási határozza meg a számbavételi értékeket. Ez a minősítő egy sztring, amely az aláírt 32 bites egész számértékek vesszővel tagolt listáját tartalmazza. Az alábbi táblázat a leképezési típusokat sorolja fel. Az alapértelmezett érték mindig NULL.

• BIT

  A CIM tulajdonság minősítője biteket megadja a számbavételi értékeket. Ez a minősítő egy sztring, amely az aláírt 32 bites egész számértékek vesszővel tagolt listáját tartalmazza. Az alábbi táblázat a leképezési típusokat sorolja fel. Az alapértelmezett érték mindig NULL.

• Változóhossz

  Ha a SZINTAXIS záradék olyan primitív típusra, névvel ellátott típusra vagy szöveges konvencióra hivatkozik, amely változó hosszúságú OKTET-SZTRINGként vagy Átlátszatlanként van altípusezve, a CIM tulajdonság-minősítő variable_length határozza meg a típusdefinícióhoz társított minimális, maximális és rögzített hosszúságú értékeket. Ez a minősítő sztringként van implementálva az alábbi formátumban, ahol a változó hosszúságú értékek aláíratlan 32 bites egész számként jelennek meg.

  (((0.9) .. (0.9)) | (0.9))(, (((0.9) .. (0.9)) | (0.9)))*
  

• Rögzített hosszúságú

  Ha a SZINTAXIS záradék egy primitív típusra, névvel ellátott típusra vagy szöveges konvencióra hivatkozik, amely rögzített hosszúságú OKTET-sztringként vagy átlátszatlanként van altípusezve, a CIM tulajdonság-minősítő fixed_length határozza meg a rögzített hosszúságú értéket. Ez a minősítő aláíratlan 32 bites egész számként jelenik meg.

• Tartomány

  Ha a SZINTAXIS záradék egy primitív típusra, névvel ellátott típusra vagy szöveges konvencióra hivatkozik, amely tartományos vagy rögzített értékű egész számként vagy mérőműszerként van altípusolva, a CIM tulajdonság-minősítő variable_value határozza meg a típusdefinícióhoz társított tartományos és rögzített értékeket. Ez a minősítő sztringként van implementálva a következő formátumban, ahol a tartomány és a rögzített hosszúságú értékek aláíratlan 32 bites egész számként jelennek meg.

  (((0.9)..(0.9))|(0.9))(,(((0.9)..(0.9))|(0.9)))*
  

Példakód

Az alábbi példa egy számbavett EGÉSZ SZÁM altípust ír le.

Status := INTEGER {
up(1),
down(2),
testing(3)
}

Ez a példa a következőre mutat:

enumeration("up(1),down(2),testing(3)")

Az alábbi példakód egy BITS-altípust ír le.

Status := BITS {
up(1),
down(2), 
testing(3)
}

Az alábbi példakód a következőre képez le:

bits("up(1),down(2),testing(3)")

Az alábbi példakód egy változó hosszúságú altípust ír le.

MySnmpOSIAddress ::=  TEXTUAL-CONVENTION

    DISPLAY-HINT    "*1x:/1x:"
    STATUS        current
    DESCRIPTION
            "Represents an OSI transport-address:

            octets    contents         encoding
              1        length of NSAP   'n' as an unsigned-integer
                                        (either 0 or from 3 to 20)
              2..(n+1)  NSAP          concrete binary representation
              (n+2)..m  TSEL             string of (up to 64) octets
            "
    SYNTAX         OCTET STRING (SIZE (1|4..85))

Ez a példa a következőre mutat:

display_hint("*1x:/1x:"),
encoding("OCTETSTRING"),
textual_convention("OCTETSTRING"),
variable_length ("1,4..85")

Az alábbi példa egy rögzített hosszúságú altípust ír le.

IPXADDRESS := OCTET STRING (SIZE (6))

Ez a példa a következőre mutat:

fixed_length(6)

Az alábbi példa egy tartomány altípusát ismerteti.

Status := INTEGER (10..20|8)

Ez a példa a következőre mutat:

variable_value("10..20,8")