Uso de atributos de conexión de DB2 CLI para DB2

DB2 Call Level Interface (DB2 CLI) es una interfaz SQL invocable de DB2 LUW, DB2 para z/OS y DB2 para i. IBM® Cognos Business Intelligence puede modificar algunos de los atributos de conexión de DB2 CLI para transmitir contexto de aplicación a DB2 en un formato aceptable para los componentes de IBM Optim Integrated Data Management.

Esta información se puede recuperar posteriormente desde registros especiales de DB2 mediante sentencias SQL.

Para habilitar esta funcionalidad en IBM Cognos BI, debe modificar el archivo CQEConfig.xml de cada sistema servidor de informes de IBM Cognos configurado para su entorno de IBM Cognos. Dado que esta funcionalidad se configura a nivel de consulta, la información asociada a los atributos de conexión se actualiza automáticamente cada vez que se ejecuta el informe.

En la lista siguiente se muestran los atributos de conexión de DB2 CLI que IBM Cognos BI puede modificar y el tipo de información que dichos atributos pueden transmitir a DB2:

  • SQL_ATTR_INFO_USERID

    Especifica el nombre del usuario que ejecuta un informe.

  • SQL_ATTR_INFO_WRKSTNNAME

    Especifica la dirección del sistema en el que está instalado el navegador del usuario.

  • SQL_ATTR_INFO_APPLNAME

    Especifica el nombre de paquete asociado a la consulta. Si la longitud de la cadena es superior a 32 caracteres, se desborda a $SLOT2 en la cadena de contabilidad.

  • SQL_ATTR_INFO_ACCTSTR

    Especifica el prefijo o cadena que asocia la solicitud a IBM Cognos BI. Los valores son:

    Valor

    Descripción

    COG

    Asocia la solicitud a productos de IBM Cognos en IBM Optim Integrated Data Management.

    ccc

    Asocia la solicitud a una solución IBM Cognos. Para la versión 8.4, se establece en BI.

    vr

    Especifica la versión del producto de IBM Cognos, por ejemplo, 8.4.

    Información de contabilidad adicional

    Esta información se divide en los campos siguientes (ranuras):

    • $SLOT2 - $packageName (sección de desbordamiento para $SLOT1)
    • $SLOT3 - $reportName
    • $SLOT4 - $queryName
    • $SLOT5 - $reportPath

    Cada ranura cuenta con una longitud fija que acepta cadenas que no contengan más de 46 bytes, con espacios añadidos si es necesario. Dado que las rutas de informes, las rutas de modelos, etc., a menudo son largas, es posible acortar las cadenas para ajustarse a las limitaciones de espacio.

    Nota: En DB2, los valores transmitidos a la API no pueden contener caracteres de comillas simples, que se convierten en espacios. Si la codificación del juego de caracteres utiliza varios bytes por carácter, el carácter se convierte en "?" para evitar el desbordamiento. Esto es importante cuando se utiliza Unicode y un carácter podría necesitar más de 2 bytes.

Procedimiento

  1. Copie el archivo ubicación_c10/configuration/CQEConfig.xml.sample en ubicación_c10/bin y cambie el nombre por CQEConfig.xml.

    Nota: Si CQEConfig.xml se ha utilizado para otros fines, por ejemplo, para inhabilitar el almacenamiento de la sesión en la caché, es posible que exista ya en el directorio ubicación_c10/bin. En tal caso, utilice el archivo CQEConfig.xml existente para realizar los pasos restantes.

  2. Abra el archivo ubicación_c10/bin/CQEConfig.xml con un editor.

    Asegúrese de que su editor permita guardar archivos en formato UTF-8.

  3. Localice el elemento <section name="QueryEngine"> y añada la entrada DB2WFM con un valor de 1, tal como se muestra a continuación:
    <section name="QueryEngine">
          <entry name=" DB2WFM" value="1"/>
           …
    </section>

    Para inhabilitar esta funcionalidad, establezca el valor en cero o elimine el elemento.

  4. Guarde el archivo CQEConfig.xml.
  5. Repita los pasos para cada sistema servidor de informes configurado para el entorno IBM Cognos.
  6. Reinicie el servicio de IBM Cognos.