INDEX Clause

La clause INDEX spécifie une clé pour sélectionner une ligne unique dans une collection scalaire ou de table. Le fournisseur SNMP est mappé à un type différent de classe CIM en fonction du type de table utilisé par l’appareil SNMP. Étant donné qu’une clé peut être plusieurs types d’objet, le fournisseur utilise des règles de mappage différentes en fonction du type d’objet dans la clé. Pour plus d’informations, consultez Types de données de clause INDEX.

Une collection scalaire est mappée à une classe singleton CIM, c’est-à-dire une classe qui ne peut avoir qu’une seule instance. Étant donné qu’il n’est pas nécessaire d’identifier de manière unique une instance d’une autre, une classe singleton ne désigne pas une ou plusieurs propriétés comme clé. Classes générées à partir de collections scalaires :

• Ne contiennent pas de qualificateurs de propriété Key.
• Contiennent le qualificateur de classe CIM standard Singleton, qui est de type Bool.

Une collection de tables est mappée à une classe CIM qui peut avoir plusieurs instances. Par conséquent, la définition de classe CIM doit contenir au moins une propriété qui définit la clé d’objet ; autrement dit, une propriété qui identifie de manière unique une instance de la classe . La clause INDEX de la macro OBJECT-TYPE d’une collection de tables spécifie l’ensemble de propriétés de clé de la collection. Les règles de mappage des noms suivantes s'appliquent :

• La Keyde qualificateur CIM, de type Bool, définit une propriété de clé.

• L’ordre des informations INDEX dans la collection de tables définit l’ordre des clés dans la définition de classe CIM.

  Le qualificateur CIM Key_Order définit l’ordre des clés. Ce qualificateur est une valeur entière 32 bits non signée qui, pour les besoins de la syntaxe du qualificateur MOF, doit être convertie en une valeur entière 32 bits signée à l’aide de l’opération à deux compléments.

Actuellement, le mappage de la clause INDEX SNMPv2C ne gère pas l’utilisation du qualificateur IMPLICITE. Aucune définition de classe CIM n’est générée dans ce cas.

Types de données de clause INDEX

En raison de la flexibilité de la clause INDEX dans la macro OBJECT-TYPE , la spécification des propriétés à clé n’est pas simple. Au lieu de cela, vous devez envisager les possibilités que la clause INDEX contienne un ou plusieurs des types de données suivants :

• Valeur indexobject accessible en interne

  La valeur indexobject est une valeur nommée qui fait référence à une définition d’objet MIB apparaissant dans la ligne conceptuelle de la même table qui contient la clause INDEX. La définition d’objet MIB référencée dans la clause INDEX est mappée à une propriété clé de la définition de classe CIM.

• Valeur indexobject accessible en externe

  Dans ce cas, indexobject est une valeur nommée qui fait référence à une définition d’objet MIB apparaissant dans la ligne conceptuelle d’une autre table.

• Valeur de type d’index accessible

  La valeur indextype est un type nommé qui fait référence à l’un des types de données suivants : INTEGER, OCTET STRING, OBJECT IDENTIFIER, NetworkAddressou IpAddress. Si la clause INDEX contient une référence de type MIB, les règles de mappage suivantes s’appliquent :

  • L’objet MIB fait référence à mappe à une propriété clé de la définition de classe CIM. Sa syntaxe de type est basée sur la valeur d’indextype spécifiée, qui est mappée aux qualificateurs de propriétés CIM à l’aide des procédures de mappage de clause SYNTAX standard.
  • Le processus de mappage génère un nom de propriété unique en concaténant le descripteur d’objet table MIB, un trait de soulignement (_) et l’ordre de classement de la valeur indextype de clause INDEX. Par exemple, le nom de propriété du troisième indextype de composant de la table MIB enterpriseIfTable est enterpriseIfTable_3.
  • La propriété CIM est annotée avec le qualificateur Virtual_Key. Ce qualificateur spécifie que le fournisseur SNMP doit calculer la valeur de la propriété en fonction du sur-ensemble d’informations d’instance associées à toutes les définitions d’objet MIB accessibles dans la définition de classe.
  • La définition de classe CIM doit contenir au moins une propriété qui n’a pas de qualificateur de Virtual_Key associé ; si vous ne spécifiez pas cette propriété, la définition de classe est invalidée.

• Sous-type de longueur fixe

  Lorsque la clause INDEX d’une collection de tables SNMP contient un type pris en charge par SNMP qui est sous-typé sous la forme d’une chaîne OCTET de longueur fixe, le qualificateur de propriété CIM Fixed_Length doit être utilisé pour spécifier cette valeur.