Cláusula INDEX
La cláusula INDEX especifica una clave para seleccionar una fila única en una colección escalar o de tabla. El proveedor SNMP se asigna a un tipo diferente de clase CIM en función del tipo de tabla que usa el dispositivo SNMP. Dado que una clave puede ser más de un tipo de objeto, el proveedor usa reglas de asignación diferentes en función del tipo de objeto dentro de la clave. Para obtener más información, vea index (Tipos de datos de cláusula INDEX).
Nota
Para obtener más información sobre cómo instalar el proveedor, vea Configuración del entorno SNMP de WMI.
Una colección escalar se asigna a una clase singleton CIM: es decir, una clase que solo puede tener una instancia. Dado que no es necesario identificar de forma única una instancia de otra, una clase singleton no designa una o varias propiedades como clave. Clases generadas a partir de colecciones escalares:
- No contenga calificadores de propiedad clave.
- Contenga el calificador de clase CIM estándar Singleton, que es de tipo Bool.
Una colección de tablas se asigna a una clase CIM que puede tener más de una instancia. Como resultado, la definición de clase CIM debe contener al menos una propiedad que defina la clave de objeto; es decir, una propiedad que identifica de forma única una instancia de la clase . La cláusula INDEX de la macro OBJECT-TYPE de una colección de tablas especifica el conjunto de propiedades clave de la colección. Se aplican las siguientes reglas de asignación:
El calificador CIM Key, escriba Bool, define una propiedad de clave.
La ordenación de la información INDEX dentro de la colección de tablas define la ordenación de las claves dentro de la definición de clase CIM.
El calificador CIM Key_Order define la ordenación de las claves. Este calificador es un valor entero de 32 bits sin signo que, para los fines de la sintaxis del calificador MOF, debe convertirse en un valor entero de 32 bits con signo mediante la operación twos-complement.
Actualmente, la asignación de la cláusula INDEX de SNMPv2C no controla el uso del calificador de IMPLICIT. En este caso, no se genera una definición de clase CIM.
Tipos de datos de cláusula INDEX
Debido a la flexibilidad de la cláusula INDEX dentro de la macro OBJECT-TYPE, la especificación de las propiedades clave no es sencilla. En su lugar, debe tener en cuenta las posibilidades que la cláusula INDEX puede contener uno o varios de los siguientes tipos de datos:
Valor indexobject accesible internamente
El indexobject valor es un valor con nombre que hace referencia a una definición de objeto MIB que aparece en la fila conceptual de la misma tabla que contiene la cláusula INDEX. La definición de objeto MIB a la que se hace referencia en la cláusula INDEX se asigna a una propiedad clave de la definición de clase CIM.
Valor de indexobject accesible externamente
En este caso, indexobject es un valor con nombre que hace referencia a una definición de objeto MIB que aparece en la fila conceptual de una tabla diferente.
Valor de de tipo de índice accesible
El valor indextype es un tipo con nombre que hace referencia a uno de los siguientes tipos de datos: INTEGER, OCTET STRING, OBJECT IDENTIFIER, NetworkAddresso IpAddress. Si la cláusula INDEX contiene una referencia de tipo MIB, se aplican las siguientes reglas de asignación:
- El objeto MIB al que se hace referencia se asigna a una propiedad clave de la definición de clase CIM. Su sintaxis de tipo se basa en el valor de indextype especificado, que se asigna a calificadores de propiedad CIM mediante la cláusula SINTAXIS estándar procedimientos de asignación.
- El proceso de asignación genera un nombre de propiedad único mediante la concatenación del descriptor de objeto de tabla MIB, un carácter de subrayado (_) y el orden de clasificación de la cláusula INDEX valor de indextype. Por ejemplo, el nombre de propiedad del tercer componente indextype de la tabla MIB enterpriseIfTable es enterpriseIfTable_3.
- La propiedad CIM se anota con el calificador Virtual_Key. Este calificador especifica que el proveedor SNMP debe calcular el valor de la propiedad en función del superconjunto de información de instancia asociada a todas las definiciones de objetos MIB accesibles en la definición de clase.
- La definición de clase CIM debe contener al menos una propiedad que no tenga un calificador de Virtual_Key asociado; error al especificar esta propiedad invalida la definición de clase.
Subtipo de longitud fija
Cuando la cláusula INDEX de una colección de tablas SNMP contiene un tipo compatible con SNMP que está subtipo como UNA CADENA OCTET de longitud fija, el calificador de propiedad CIM Fixed_Length debe usarse para especificar este valor.