Suplemento de instalación y configuración

Listado de las palabras clave de configuración de CLI/ODBC de DB2

Las palabras clave se listan en orden alfabético que comienza por "APPENDAPINAME." También se dividen en categorías. En la herramienta Configuración de fuente de datos de ODBC (no disponible en plataformas UNIX) cada una de estas categorías se presenta en una pestaña independiente del cuaderno.

Para obtener más información sobre aplicaciones CLI/ODBC de DB2, consulte la información sobre el sistema operativo específico en Detalles específicos de cada plataforma para el acceso de CLI/ODBC.


Configuración de palabras clave por categoría

Palabras clave de configuración general de valores de CLI/ODBC

Palabras clave de configuración de compatibilidad

El conjunto de opciones de Compatibilidad se utiliza para definir el comportamiento de DB2. Pueden definirse para asegurarse de que las demás aplicaciones son compatibles con DB2.

Palabras clave de configuración de tipo de datos

El conjunto de opciones de Tipo de datos se utiliza para definir el modo en que DB2 comunica y maneja diversos tipos de datos.

Palabras clave de configuración de Enterprise

El conjunto de opciones de Enterprise se utiliza para maximizar la eficacia de las conexiones con bases de datos grandes.

Palabras clave de configuración de entorno

El conjunto de opciones de Entorno se utiliza para definir la ubicación de diversos archivos en las máquinas cliente y servidor.

Palabras clave de configuración de DSN de archivos

El conjunto de opciones DSN de archivos se utiliza para definir los valores de TCP/IP para una conexión de DSN de archivos.

Palabras clave de configuración de optimización

El conjunto de opciones de Optimización se utiliza para acelerar y reducir la cantidad de flujo de red entre el servidor y Controlador de CLI/ODBC.

Palabras clave de configuración de servicio

El conjunto de opciones de Servicio se utiliza para ayudar a solucionar los problemas con las conexiones de CLI/ODBC. Algunas opciones también pueden utilizarlas los programadores para obtener una mejor comprensión del modo en que sus programas de CLI se convierten en llamadas en el servidor.

Palabras clave de configuración de SQL estática

El conjunto de opciones de SQL estática se utilizan al ejecutar sentencias de SQL estáticas en aplicaciones CLI/ODBC.

Palabras clave de configuración de transacción

El conjunto de opciones Transacción se utiliza para controlar y acelerar las sentencias de SQL utilizadas en la aplicación.


Descripciones de palabras clave de configuración

APPENDAPINAME

Descripción de la palabra clave:
Agregue el nombre de función de CLI/ODBC que ha generado un error al mensaje de error.

Sintaxis de la palabra clave db2cli.ini:
APPENDAPINAME = 0 | 1

Valor por omisión:
NO visualizar nombre de función de CLI de DB2.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Notas de utilización:
 

El nombre de la función de CLI de DB2 (API) que ha generado un error se agrega al mensaje de error que se recupera utilizando SQLGetDiagRec() o SQLError(). El nombre de función está encerrado entre llaves { }.

Por ejemplo,

[IBM][CLI Driver]" CLIxxxx: < text >
SQLSTATE=XXXXX {SQLGetData}"

0 = NO agregar nombre de función de CLI de DB2 (valor por omisión)
1 = agregar el nombre de función de CLI de DB2

Esta palabra clave sólo se utiliza para la depuración.

ASYNCENABLE

Descripción de la palabra clave:
Habilitar o inhabilitar la posibilidad de ejecutar consultas de modo asíncrono.

Sintaxis de la palabra clave db2cli.ini:
ASYNCENABLE = 1 | 0

Valor por omisión:
Ejecutar consultas de modo asíncrono.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Notas de utilización:
 

Esta opción le permite habilitar o inhabilitar la posibilidad de ejecutar consultas de modo asíncrono. Esto sólo beneficia a las aplicaciones que se han escrito para sacar partido de esta característica. Inhabilítela sólo en el caso de que la aplicación no funcione del modo debido cuando se habilite. Se coloca en la sección específica de la fuente de datos del archivo db2cli.ini.

1 = Ejecutar consultas de modo asíncrono (valor por omisión)
0 = Las consultas no se ejecutan de modo asíncrono

Nota:El controlador CLI/ODBC actuará como en las versiones anteriores de DB2 que no daban soporte al ODBC asíncrono.

BITDATA

Descripción de la palabra clave:
Especificar si los tipos de datos binarios se comunican como tipos de datos de tipo carácter o binarios.

Sintaxis de la palabra clave db2cli.ini:
BITDATA = 1 | 0

Valor por omisión:
Comunicar los tipos de datos FOR BIT DATA y BLOB como tipos de datos binarios.

Pestaña de valores de CLI de DB2/ODBC:
Tipo de datos

Notas de utilización:
 

Esta opción le permite especificar si los tipos de datos binarios de ODBC (SQL_BINARY, SQL_VARBINARY, SQL_LONGVARBINARY y SQL_BLOB), se comunican como datos de tipo binario. Los IBM DBMS dan soporte a columnas con tipos de datos binarios definiendo columnas CHAR, VARCHAR y LONG VARCHAR con el atributo FOR BIT DATA. DB2 Universal Database también dará soporte a los datos binarios por medio del tipo de datos BLOB (en este caso se correlaciona con un tipo de datos de CLOB).

Es posible que los usuarios también necesiten establecer esta opción en el caso de que estén utilizando una aplicación de DB2 versión 1 que recupere datos de (LONG) (VAR)CHAR en el almacenamiento intermedio de SQL_C_CHAR. En DB2 versión 1, los datos se trasladan al almacenamiento intermedio de SQL_C_CHAR sin modificarse; comenzando por DB2 versión 2, los datos se convierten en la representación de ASCII de cada porción hexadecimal.

Únicamente ha de establecer BITDATA = 0 en el caso de que esté seguro de que todas las columnas que se han definido como FOR BIT DATA o BLOB únicamente contienen datos de tipo carácter y de que la aplicación es incapaz de visualizar columnas de datos binarias.

1 = comunicar los tipos de datos FOR BIT DATA y BLOB como tipos de datos binarios (valor por omisión).
0 = comunicar los tipos de datos FOR BIT DATA y BLOB como tipos de datos de tipo carácter.

CLIPKG

Descripción de la palabra clave:
Número de paquetes grandes que ha de generarse

Sintaxis de la palabra clave db2cli.ini:
CLIPKG = 3 | 4 | ... | 30

Valor por omisión:
3

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Si el valor NO es un entero entre 3 y 30, se utilizará el valor por omisión sin error o aviso.

Esta palabra clave se utiliza para aumentar el número de secciones para sentencias de SQL en aplicaciones CLI/ODBC. Si se utiliza, el administrador debe vincular explícitamente los archivos de vinculación de CLI necesarios con la opción de vinculación de CLIPKG. Asimismo, debe actualizarse el archivo db2cli.ini en el servidor (DB2 UDB V6.1 o posterior en plataformas UNIX o Intel) con el mismo valor de CLIPKG.

Este valor sólo se aplica a paquetes grandes (que contengan 364 secciones). El número de paquetes pequeños (que contienen 64 secciones) es de 3 y no puede cambiarse.

Le recomendamos que sólo aumente el número de secciones lo suficiente para ejecutar la aplicación ya que los paquetes utilizan espacio de la base de datos.

CLISCHEMA

Descripción de la palabra clave:
Establecer la vista de catálogo de DB2 ODBC que ha de utilizarse.

Sintaxis de la palabra clave db2cli.ini:
CLISCHEMA = vista de catálogo de ODBC

Valor por omisión:
Ninguno - No se utiliza ninguna vista de catálogo de ODBC

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Consulte asimismo:
SYSSCHEMA

Notas de utilización:
 

El catálogo DB2 ODBC ha sido diseñado para mejorar el rendimiento de las llamadas de esquema para las listas de tablas en aplicaciones ODBC que se conectan a los DBMS de sistema principal a través de DB2 Connect.

El catálogo de DB2 ODBC, creado y mantenido en el DBMS de sistema principal, contiene filas que representan objetos definidos en el catálogo de DB2 real, pero estas filas incluyen únicamente las columnas necesarias para dar soporte a las operaciones de ODBC. Las tablas del catálogo de DB2 ODBC se unen con anterioridad y se colocan en un índice específicamente para dar soporte al acceso rápido por catálogo para las aplicaciones de ODBC.

Los administradores del sistema pueden crear varias vistas de catálogo de DB2 ODBC, cada una de las cuales contendrá únicamente las filas que necesita un grupo de usuarios en concreto. Después, cada usuario final podrá seleccionar la vista de catálogo de DB2 ODBC que desea utilizar (estableciendo esta palabra clave).

La utilización del valor de CLISCHEMA resulta completamente transparente para la aplicación de ODBC; puede utilizar esta opción con cualquier aplicación de ODBC.

En tanto que esta palabra clave tiene algunos efectos que son parecidos a los de la palabra clave SYSSCHEMA, CLISCHEMA es la que deberá utilizarse (cuando se pueda).

CLISCHEMA mejora la eficacia del acceso de datos: Las tablas definidas por el usuario que se utilizan con SYSSCHEMA eran imágenes de espejo de las tablas de catálogo de DB2 y el controlador de ODBC aún ha de unir filas procedentes de varias tablas para producir la información que necesita el usuario de ODBC. La utilización de CLISCHEMA da asimismo como resultado una menor contención en las tablas de catálogos.

CONNECTNODE

Descripción de la palabra clave:
Especificar el nodo para el que va a efectuarse una conexión

Sintaxis de la palabra clave db2cli.ini:
CONNECTNODE = valor de entero de 1 a 999 | SQL_CONN_CATALOG_NODE

Valor por omisión:
Se utiliza el nodo lógico que se define con el puerto 0 en la máquina.

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Sólo es de aplicación al:
Conectarse a un servidor de base de datos DB2 Extended Enterprise Edition de varios nodos.

Notas de utilización:
 

Se utiliza para especificar el nodo lógico destino de un servidor de particiones de base de datos de DB2 Extended Enterprise Edition al que desee conectarse. Esta palabra clave (o valor de atributo) altera temporalmente el valor de la variable de entorno DB2NODE. Puede establecerse en:

Si no se establece esta variable, el nodo lógico de destino toma el valor por omisión del nodo lógico que se define con el puerto 0 en la máquina.

CONNECTTYPE

Descripción de la palabra clave:
Unidad de trabajo distribuida o remota

Sintaxis de la palabra clave db2cli.ini:
CONNECTTYPE = 1 | 2

Valor por omisión:
Unidad de trabajo remota

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Consulte asimismo:
SYNCPOINT

Notas de utilización:
 

Esta opción le permite especificar el tipo de conexión por omisión.

1 = Unidad de trabajo remota. Varias conexiones simultáneas, cada una con su propio ámbito de confirmación. Las transacciones simultáneas no están coordinadas. (valor por omisión)
2 = Unidad de trabajo distribuida. Conexiones coordinadas en las que varias bases de datos participan bajo la misma unidad de trabajo distribuida. Este valor funciona conjuntamente con el valor SYNCPOINT para determinar si debería utilizarse un Gestor de transacciones.

CURRENTFUNCTIONPATH

Descripción de la palabra clave:
Especificar el esquema utilizado para resolver referencias de función y referencias de tipo de datos en sentencias SQL dinámicas.

Sintaxis de la palabra clave db2cli.ini:
CURRENTFUNCTIONPATH = vía_acceso_función_actual

Valor por omisión:
Consulte la descripción que viene a continuación.

Pestaña de valores de CLI de DB2/ODBC:
Entorno

Notas de utilización:
 

Esta palabra clave define la vía de acceso utilizada para resolver referencias de función y referencias de tipo de datos que se utilizan en sentencias SQL dinámicas. Contiene una lista de uno o más nombres de esquema, estando éstos encerrados entre dobles comillas y separados por comas.

El valor por omisión es "SYSIBM","SYSFUN",X donde X es el valor del registro especial USER delimitado por comillas dobles. No ha de especificarse el esquema SYSIBM. Si no se incluye en la vía de acceso de función, el primer esquema se asume implícitamente.

Esta palabra clave se utiliza como parte del proceso para resolver referencias de función sin calificar que pudieran haberse definido en un nombre de esquema diferente del esquema de usuario actual. El orden de los nombres de esquema determina el orden en el que se resolverán los nombres de función. Para obtener más información sobre la resolución de funciones, consulte el manual Consulta de SQL.

CURRENTPACKAGESET

Descripción de la palabra clave:
Emita "SET CURRENT PACKAGESET schema" después de cada una de las conexiones.

Sintaxis de la palabra clave db2cli.ini:
CURRENTPACKAGESET = nombre esquema

Valor por omisión:
La cláusula no se agrega.

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Esta opción emitirá el mandato "SET CURRENT PACKAGESET schema" después de cada una de las conexiones a una base de datos. Por omisión, esta cláusula no se agrega.

Esta sentencia establece el nombre de esquema (identificador de colección) que se utilizará para seleccionar el paquete que ha de utilizarse para sentencias de SQL sucesivas.

Las aplicaciones CLI/ODBC emiten sentencias SQL dinámicas. Utilizando esta opción puede controlar los privilegios utilizados para ejecutar estas sentencias:

Las sentencias de SQL de las aplicaciones de CLI/ODBC se ejecutarán en este momento bajo el esquema especificado y utilizarán los privilegios allí definidos.

Consulte el manual Consulta de SQL para obtener más información sobre el mandato SET CURRENT PACKAGESET.

CURRENTREFRESHAGE

Descripción de la palabra clave:
Establezca el valor del registro especial CURRENT REFRESH AGE.

Sintaxis de la palabra clave db2cli.ini:
CURRENTREFRESHAGE = 0 | ANY | a numeric constant

Valor por omisión:
0 - las tablas de resumen definidas con REFRESH DEFERRED no se utilizarán para optimizar el proceso de una consulta

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Para obtener información sobre las Tablas de resumen y la sentencia SET CURRENT REFRESH AGE, consulte la publicación SQL Reference.

Esta palabra clave puede establecerse en uno de los siguientes valores:

CURRENTSCHEMA

Descripción de la palabra clave:
Especificar el esquema utilizado en una sentencia SET CURRENT SCHEMA al conectarse satisfactoriamente.

Sintaxis de la palabra clave db2cli.ini:
CURRENTSCHEMA = nombre esquema

Valor por omisión:
No se emite ninguna sentencia.

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Al conectarse satisfactoriamente, si se establece esta opción, se envía una sentencia SET CURRENT SCHEMA al DBMS. Esta acción permite al usuario final o aplicación dar nombre a objetos de SQL sin tener que calificarlos por nombre de esquema.

Para obtener más información sobre la sentencia SET CURRENT SCHEMA, consulte la publicación Consulta de SQL.

CURRENTSQLID

Descripción de la palabra clave:
Especificar el ID utilizado en una sentencia SET CURRENT SQLID enviada al DBMS al conectarse satisfactoriamente.

Sintaxis de la palabra clave db2cli.ini:
CURRENTSQLID = sqlid_actual

Valor por omisión:
No se emite ninguna sentencia.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Sólo es de aplicación al:
conectarse a los DBMS de DB2 en los que SET CURRENT SQLID está soportada (por ejemplo DB2 para MVS/ESA).

Notas de utilización:
 

Al conectarse satisfactoriamente, si se establece esta opción, se envía una sentencia SET CURRENT SQLID al DBMS. Esta acción permite al usuario final y a la aplicación dar nombre a objetos de SQL sin tener que calificarlos por nombre de esquema.

CURSORHOLD

Descripción de la palabra clave:
Efecto de una finalización de transacción en cursores abiertos.

Sintaxis de la palabra clave db2cli.ini:
CURSORHOLD = 1 | 0

Valor por omisión:
Seleccionado--Los cursores no se destruyen.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Notas de utilización:
 

Esta opción controla el efecto de una finalización de transacción en cursores abiertos.

1 = cursor retenido, los cursores no se destruyen cuando se confirma la transacción (valor por omisión).
0 = cursor no retenido, los cursores se destruyen cuando se confirma la transacción.

Nota:Los cursores siempre se destruyen cuando se retrotraen las transacciones.

Esta opción afecta al resultado que devuelve SQLGetInfo() cuando se llama con SQL_CURSOR_COMMIT_BEHAVIOR o SQL_CURSOR_ROLLBACK_BEHAVIOR. El valor de CURSORHOLD se ignora si se conecta a DB2 para VSE y VM donde cursor with hold (con retención) no está soportado.

Puede utilizar esta opción para ajustar el rendimiento. Puede establecerse en cursor no retenido (0) en el caso de que esté seguro de que la aplicación:

  1. No se comporta en función de la información de SQL_CURSOR_COMMIT_BEHAVIOR o SQL_CURSOR_ROLLBACK_BEHAVIOR que se devuelve por medio de SQLGetInfo() y
  2. No necesita que se conserven cursores de una transacción para la siguiente.

El DBMS funcionará de modo más eficiente, en el caso de que no se tengan que mantener recursos después de que haya finalizado una transacción.

DATABASE

Descripción de la palabra clave:
Base de datos del servidor a la que conectarse al utilizar un DSN de archivos

Sintaxis de la palabra clave db2cli.ini:
DATABASE = nombre de la base de datos

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Sólo es de aplicación cuando:
PROTOCOL se establece en TCPIP

Consulte asimismo:
HOSTNAME, PROTOCOL, SERVICENAME

Notas de utilización:
 

Al utilizar un DSN de archivos debe utilizar esta opción para especificar la base de datos en el servidor al que se ha de conectar. Este valor no tiene nada que ver con ningún nombre de alias de base de datos especificado en el cliente, debe establecerse en el nombre de la base de datos del propio servidor.

Este valor sólo se tiene en cuenta cuando la opción PROTOCOL se establece en TCPIP.

DB2CONNECTVERSION

Descripción de la palabra clave:
Especificar DB2 Connect o la sesión de pasarela de DB2 DDCS que está utilizándose.

Sintaxis de la palabra clave db2cli.ini:
DB2CONNECTVERSION = versión de pasarela

Valor por omisión:
5

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Sólo es de aplicación al:
conectarse a una fuente de datos a través de una pasarela de DB2 Connect o DB2 DDCS.

Notas de utilización:
 

Esta opción se utiliza para indicar al controlador de CLI de DB2 la versión de pasarela de DB2 Connect o DB2 DDCS que se está utilizando. El controlador de CLI puede utilizar esta información para maximizar su interacción con la fuente de datos (que dé soporte a los procedimientos almacenados que devuelven varios conjuntos de resultados, por ejemplo).

5 = Indica que se está utilizando una pasarela de DB2 Connect versión 5 (valor por omisión).

2 = Indica que se está utilizando una pasarela de DB2 DDCS versión 2.

DB2DEGREE

Descripción de la palabra clave:
Establecer el grado de paralelismo para la ejecución de sentencias de SQL.

Sintaxis de la palabra clave db2cli.ini:
DB2DEGREE = 0 | integer value from 1 to 32767 | ANY

Valor por omisión:
No se emite la sentencia SET CURRENT DEGREE.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Sólo es de aplicación al:
conectarse a un sistema de base de datos de cluster.

Notas de utilización:
 

Esta opción sólo se aplica a DB2 Versión 5.2 o a un servidor posterior. Si el valor especificado es cualquier valor diferente a 0 (el valor por omisión), CLI de DB2 emitirá la sentencia SQL siguiente después de una conexión satisfactoria:

SET CURRENT DEGREE valor

Especifica el grado de paralelismo para la ejecución de sentencias de SQL. El gestor de la base de datos determinará el grado de paralelismo si se especifica ANY.

Para obtener más información, consulte la sentencia SET CURRENT DEGREE en la publicación Consulta de SQL.

DB2ESTIMATE

Descripción de la palabra clave:
Umbral para visualizar estimaciones de optimizador de CLI después de una preparación de sentencia de consultas de SQL.

Sintaxis de la palabra clave db2cli.ini:
DB2ESTIMATE = 0 | large positive number

Valor por omisión:
No se devuelven estimaciones.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Sólo es de aplicación cuando:
una aplicación de GUI accede a un servidor de DB2 Versión 2 o posterior.

Notas de utilización:
 

Esta opción determina si CLI de DB2 visualizará un recuadro de diálogo para comunicar las estimaciones que devuelve el optimizador de DB2 al final de la preparación de sentencias de consulta de SQL.

0 = No se devuelven estimaciones (valor por omisión).
número positivo grande = El umbral por encima del cual CLI de DB2 visualizará la ventana para comunicar estimaciones. Este valor se compara con el campo SQLERRD(4) en el SQLCA asociado con el PREPARE. Si el valor de SQLERRD(4) es mayor que DB2ESTIMATE, aparecerá la ventana de estimaciones.

La ventana de gráficos visualizará las estimaciones del optimizador, junto con los pulsadores para permitir a los usuarios elegir si desean continuar con la posterior ejecución de esta consulta o cancelarla.

El valor recomendado para DB2ESTIMATE es 60000.

Esta opción sólo es relevante al conectarse a una base de datos DB2 versión 2 o posterior. Para que aparezca la ventana, la aplicación debe tener una interfaz gráfica.

Si se utiliza esta opción, no se tendrá en consideración la opción de CLI de DB2/ODBC DEFERREDPREPARE.

DB2EXPLAIN

Descripción de la palabra clave:
Determina si el servidor generará Explicar instantánea y/o Explicar información de tabla.

Sintaxis de la palabra clave db2cli.ini:
DB2EXPLAIN = 0 | 1 | 2 | 3

Valor por omisión:
El servidor no generará ni Explicar instantánea ni Explicar información de tabla.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Notas de utilización:
 

Esta palabra clave determina si el servidor generará Explicar instantánea y/o Explicar información de tabla.

0 = ambas están desativadas (valor por omisión)

Se enviará una sentencia 'SET CURRENT EXPLAIN SNAPSHOT=NO' y una sentencia 'SET CURRENT EXPLAIN MODE=NO' al servidor para inhabilitar tanto los recursos de captura de Explicar instantánea como de Explicar información de tabla.

1 = Activar únicamente Explicar instantánea

Se enviará una sentencia 'SET CURRENT EXPLAIN SNAPSHOT=YES' y una sentencia 'SET CURRENT EXPLAIN MODE=NO' al servidor para habilitar el recurso de captura de Explicar instantánea e inhabilitar el recurso de captura Explicar información de tabla.

2 = Activar únicamente recurso de captura de Explicar información de tabla

Se enviará una sentencia 'SET CURRENT EXPLAIN MODE=YES' y una sentencia 'SET CURRENT EXPLAIN SNAPSHOT=NO' al servidor para habilitar el recurso de captura de Explicar información de tabla e inhabilitar el recurso de Explicar instantánea.

3 = Ambas están activadas

Se enviará una sentencia 'SET CURRENT EXPLAIN MODE=YES' y una sentencia 'SET CURRENT EXPLAIN SNAPSHOT=YES' al servidor para habilitar tanto los recursos de captura de Explicar instantánea como de Explicar información de tabla.

Explicar información se inserta en el recurso Explicar tablas, que debe crearse antes de que pueda generarse el recurso Explicar información. Para obtener más información sobre estas tablas, consulte la publicación Consulta de SQL.

El ID de autorización actual debe tener privilegio de INSERT para el recurso Explicar tablas.

La opción 1 sólo es válida al conectarse a una base de datos DB2 Common Server versión 2.1.0 o posterior; las opciones 2 y 3 al conectarse a una base de datos DB2 Common Server versión 2.1.1 o posterior.

DB2OPTIMIZATION

Descripción de la palabra clave:
Establecer el nivel de optimización de consultas.

Sintaxis de la palabra clave db2cli.ini:
DB2OPTIMIZATION = valor de entero de 0 a 9

Valor por omisión:
No se envía ninguna sentencia SET CURRENT QUERY OPTIMIZATION.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Sólo es de aplicación al:
conectarse a un servidor DB2 Versión 2 o posterior.

Notas de utilización:
 

Si se establece esta opción, CLI de DB2 emitirá la sentencia SQL siguiente después de una conexión satisfactoria:

SET CURRENT QUERY OPTIMIZATION número positivo

Esta acción especifica el nivel de optimización en el que el optimizador debe operar las consultas de SQL. Consulte en la publicación Consulta de SQL cuales son los niveles de optimización admisibles.

DBALIAS

Descripción de la palabra clave:
Habilita nombres de la fuente de datos con más de 8 caracteres.

Sintaxis de la palabra clave db2cli.ini:
DBALIAS = dbalias

Valor por omisión:
Utilice el alias de base de datos de DB2 como Nombre de fuente de datos de ODBC.

Pestaña de valores de CLI de DB2/ODBC:
Valores generales de CLI/ODBC

Notas de utilización:
 

Esta palabra clave permite Nombres de fuente de datos con más de 8 caracteres de un único byte. El Nombre de fuente de datos (DSN) es el nombre, encerrado entre corchetes, que denota la cabecera de sección del archivo db2cli.ini (en las plataformas en las que es un archivo ASCII). Normalmente, esta cabecera de sección es el nombre de alias de base de datos que tiene una longitud máxima de 8 bytes. Un usuario que desea hacer referencia a la fuente de datos que tenga un nombre más significativo y más largo puede colocar el nombre más largo en la cabecera de sección y establecer este valor de palabra clave en el alias de base de datos utilizado en el mandato CATALOG. A continuación se muestra un ejemplo:

; The much longer name maps to an 8 single byte character dbalias
[MyMeaningfulName]
DBALIAS=DB2DBT10

El usuario final puede especificar [MyMeaningfulName] como nombre de fuente de datos en la conexión en tanto que el alias de la base de datos real sea DB2DBT10.

En un entorno de ODBC de Windows de 16 bits, bajo la entrada de [ODBC DATA SOURCES] del archivo ODBC.INI, también debe actualizarse la línea siguiente con el nombre de alias largo (dbname).

  < alias >=IBM DB2 ODBC DRIVER

DBNAME

Descripción de la palabra clave:
Especificar el nombre de la base de datos para reducir el tiempo que tarda la aplicación en consultar información de tabla de MVS.

Sintaxis de la palabra clave db2cli.ini:
DBNAME = dbname

Valor por omisión:
No filtrar la columna DBNAME.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Sólo es de aplicación al:
conectarse a DB2 para MVS/ESA.

Consulte asimismo:
SCHEMALIST, TABLETYPE

Notas de utilización:
 

Esta opción sólo se utiliza al conectarse a DB2 para MVS/ESA y únicamente si la aplicación solicita información de catálogo de tablas (base). Si hay un gran número de tablas en el subsistema de DB2 para MVS/ESA, puede especificarse un dbname para reducir el tiempo que tarda la aplicación en consultar información de tablas y reducir el número de tablas que lista la aplicación.

Si se establece esta opción, la sentencia IN DATABASE dbname se agregará a diversas sentencias, como por ejemplo CREATE TABLE.

Este valor se correlaciona con la columna DBNAME en las tablas de catálogo de sistema de DB2 para MVS/ESA. Si no se especifica ningún valor, o si se especifican asimismo vistas, sinónimos, tablas del sistema o alias por medio de TABLETYPE, sólo se restringirá la información de tablas; las vistas, alias y sinónimos no se restringen con DBNAME. Puede utilizarse junto con SCHEMALIST y TABLETYPE para limitar aún más el número de tablas para las que se devolverá información.

DEFAULTPROCLIBRARY

Descripción de la palabra clave:
Establecer biblioteca de procedimientos almacenados por omisión.

Sintaxis de la palabra clave db2cli.ini:
DEFAULTPROCLIBRARY = < nombre de vía de acceso completa >

Valor por omisión:
No añadir una biblioteca de procedimientos almacenados a las llamadas de procedimientos almacenados.

Pestaña de valores de CLI de DB2/ODBC:
Entorno

Sólo es de aplicación cuando:
la aplicación no está utilizando la tabla de catálogos de procedimientos almacenados.

Notas de utilización:
 

Esta opción sólo debe utilizarse con base temporal; en su lugar debe utilizarse la tabla de catálogos de procedimientos almacenados. Consulte la publicación Consulta de SQL para obtener más información.

La biblioteca a la que apunta esta opción se utilizará en todas las llamadas de procedimientos almacenadas que ya no especifican una biblioteca explícitamente. Puesto que está especificando una ubicación en la máquina servidor, debe utilizar el formato de vía de acceso de dicho sistema operativo y no del cliente. Para obtener más información, consulte la sentencia CALL en la publicación Consulta de SQL.

Por ejemplo, si los procedimientos almacenados están ubicados en el servidor del archivo de bibliotecas d:\terry\proclib\comstor, puede establecer DEFAULTPROCLIBRARY para d:\terry\proclib\comstor y después llamar el procedimiento almacenado func sin especificar una biblioteca. La sentencia SQL resultante enviada sería:

      CALL d:\terry\proclib\comstor!func

DEFERREDPREPARE

Descripción de la palabra clave:
Minimizar el flujo de red combinando la petición PREPARE con la petición de ejecución correspondiente.

Sintaxis de la palabra clave db2cli.ini:
DEFERREDPREPARE = 0 | 1

Valor por omisión:
La petición de preparar se retardará hasta que se envíe la petición de ejecución.

Pestaña de valores de CLI de DB2/ODBC:
Compatibilidad

No es de aplicación cuando:
se establece DB2ESTIMATE.

Notas de utilización:
 

Difiere el envío de la petición PREPARE hasta que se emita la petición de ejecución correspondiente. A continuación, se combinan las dos peticiones en un flujo de mandato/respuesta (en vez de dos) para minimizar el flujo de red y mejorar el rendimiento.

El comportamiento por omisión ha cambiado respecto al de DB2 versión 2. La preparación diferida es ahora el valor por omisión y debe desactivarse explícitamente en el caso de que sea necesario.

Nota:Cuando se habilita la preparación diferida, las estimaciones de fila y coste que normalmente se devuelven en el SQLERRD(3) y SQLERRD(4) de la SQLCA de una sentencia PREPARE pueden convertirse en ceros. Esto puede ser preocupante para los usuarios que desean utilizar dichos valores para decidir si continuar o no con la sentencia de SQL.

Esta opción se desactiva si la opción de CLI/ODBC DB2ESTIMATE se establece en un valor que no sea cero.

DISABLEMULTITHREAD

Descripción de la palabra clave:
Inhabilitar varios pasos simultáneos.

Sintaxis de la palabra clave db2cli.ini:
DISABLEMULTITHREAD = 0 | 1

Valor por omisión:
Se habilitan varios pasos simultáneos.

Pestaña de valores de CLI de DB2/ODBC:
Compatibilidad

Notas de utilización:
 

El controlador de CLI/ODBC puede dar soporte a varios pasos simultáneos.

Esta opción se utiliza para habilitar o inhabilitar el soporte de varios pasos simultáneos.

0 = Están habilitados varios pasos simultáneos (valor por omisión).
1 = Inhabilitar varios pasos simultáneos.

Si se inhabilitan varios pasos simultáneos todas las llamadas para todos los pasos se serializarán en el nivel de proceso. Utilice este valor para las aplicaciones de varios pasos simultáneos que necesitan un comportamiento serializado de DB2 Versión 2.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

EARLYCLOSE

Descripción de la palabra clave:
¿Debería el servidor de DB2 cerrar de modo prematuro el cursor asociado con la conexión cuando se encuentre con el final del conjunto de resultados?

Sintaxis de la palabra clave db2cli.ini:
EARLYCLOSE = 1 | 0

Valor por omisión:
El comportamiento de EARLYCLOSE está activado.

Pestaña de valores de CLI de DB2/ODBC:
Compatibilidad

Notas de utilización:
 

Esta opción especifica si el cursor temporal del servidor puede cerrarse o no de modo automático sin cerrar el cursor en el cliente, cuando se envíe el último registro al cliente.

0 = No cerrar el cursor temporal en el servidor de modo prematuro.
1 = Cerrar el cursor temporal en el servidor de modo prematuro (valor por omisión).

Esta acción ahorra una petición de red al controlador de CLI/ODBC al no emitir la sentencia para cerrar explícitamente el cursor debido a que ya sabe que se ha cerrado.

Tener activada esta opción acelerará las aplicaciones que utilicen muchos conjuntos de resultados pequeños.

La característica EARLYCLOSE no se utiliza. en el caso de que:

Nota:Aunque esta opción puede establecerse en cualquier momento, el valor de opción utilizado es el que existe cuando se ejecuta la sentencia (cuando se abre el cursor).

GRANTEELIST

Descripción de la palabra clave:
Reducir la cantidad de información que se devuelve cuando la aplicación obtiene una lista de privilegios de tabla o columna.

Sintaxis de la palabra clave db2cli.ini:
GRANTEELIST = " 'IDusuario1', 'IDusuario2',... 'IDusuarion' "

Valor por omisión:
No filtrar los resultados.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Consulte asimismo:
GRANTORLIST

Notas de utilización:
 

Esta opción puede utilizarse para reducir la cantidad de información que se devuelve cuando la aplicación obtiene una lista de privilegios para tablas de una base de datos o columnas de una tabla. La lista de ID de autorización se utiliza como filtro; las únicas tablas o columnas que se devuelven son aquellas que tienen privilegios que se hayan otorgado TO (A) dichos ID.

Establezca esta opción en una lista de uno o más ID de autorización a los que se haya otorgado privilegios, delimitados por un sólo signo de comillas y separados por comas. La serie completa también debe ir entrecomillada entre dobles comillas. Por ejemplo:

    GRANTEELIST=" 'USER1', 'USER2', 'USER8' "

En el ejemplo anterior, si la aplicación obtiene una lista de privilegios para una tabla específica, sólo se devolverán aquellas columnas que tengan un privilegio otorgado TO (A) USER1, USER2 o USER8.

GRANTORLIST

Descripción de la palabra clave:
Reducir la cantidad de información que se devuelve cuando la aplicación obtiene una lista de privilegios de tabla o columna.

Sintaxis de la palabra clave db2cli.ini:
GRANTORLIST = " 'IDusuario1', 'IDusuario2',... 'IDusuarion' "

Valor por omisión:
No filtrar los resultados.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Consulte asimismo:
GRANTEELIST

Notas de utilización:
 

Esta opción puede utilizarse para reducir la cantidad de información que se devuelve cuando la aplicación obtiene una lista de privilegios para tablas de una base de datos o columnas de una tabla. La lista de los ID de autorización especificados se utiliza como filtro; las únicas tablas o columnas que se devuelven son aquellas que tienen privilegios que hayan sido otorgados BY (POR) dichos ID.

Establezca esta opción en una lista de uno o más ID de autorización que han otorgado privilegios, delimitados por un sólo signo de comillas y separados por comas. La serie completa debe estar asimismo entrecomillada entre dobles comillas. Por ejemplo:

    GRANTORLIST=" 'USER1', 'USER2', 'USER8' "

En el ejemplo anterior, si la aplicación obtiene una lista de privilegios para una tabla específica, sólo se devolverán aquellas columnas que tengan un privilegio otorgado BY (POR) USER1, USER2 o USER8.

GRAPHIC

Descripción de la palabra clave:
Controla si DB2 CLI comunica IBM GRAPHIC (soporte de caracteres de doble byte) como uno de los tipos de datos soportados.

Sintaxis de la palabra clave db2cli.ini:
GRAPHIC = 0 | 1 | 2 | 3

Valor por omisión:
GRAPHIC no se devuelve como tipo de datos soportado.

Pestaña de valores de CLI de DB2/ODBC:
Tipo de datos

Notas de utilización:
 

Esta opción controla el modo en que la aplicación devuelve dos informaciones relacionadas:

0 = No comunicar el tipo de datos de IBM GRAPHIC como tipo soportado. Longitud de columnas gráficas que se devuelve como número de caracteres de DBCS. (valor por omisión)
1 = Comunicar el tipo de datos de IBM GRAPHIC como soportado. Longitud de columnas gráficas que se devuelve como número de caracteres de DBCS.
2 = No comunicar el tipo de datos de IBM GRAPHIC como tipo soportado. Longitud de columnas gráficas que se devuelve como número de bytes. (Se necesita para Microsoft Access** 1.1-J y Microsoft Query**-J.)
3 = Los valores 1 y 2 combinados. El tipo de datos de IBM GRAPHIC se comunica como soportado. Longitud de columnas gráficas que se devuelve como número de bytes.

El valor por omisión es que no se devuelva GRAPHIC ya que muchas de las propias aplicaciones no reconocen este tipo de datos y no pueden facilitar un manejo apropiado.

HOSTNAME

Descripción de la palabra clave:
La dirección de IP o nombre de sistema principal del sistema servidor, utilizados con el DSN de archivos.

Sintaxis de la palabra clave db2cli.ini:
HOSTNAME = nombre de sistema principal | Dirección IP

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
DSN de archivos

Sólo es de aplicación cuando:
PROTOCOL se establece en TCPIP

Consulte asimismo:
PROTOCOL, SERVICENAME

Notas de utilización:
 

Utilice esta opción junto con la opción SERVICENAME para especificar los atributos necesarios para la conexión de TCP/IP desde esta máquina cliente para un servidor que ejecute DB2. Estos dos valores sólo se tienen en cuenta cuando la opción PROTOCOL se establece en TCPIP.

Especifica el nombre de sistema principal del sistema servidor o su dirección de IP.

IGNOREWARNINGS

Descripción de la palabra clave:
Ignorar avisos.

Sintaxis de la palabra clave db2cli.ini:
IGNOREWARNINGS = 0 | 1

Valor por omisión:
Los avisos se devuelven como de costumbre.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Consulte asimismo:
WARNINGLIST, IGNOREWARNLIST

Notas de utilización:
 

En contadas ocasiones una aplicación no manejará los mensajes de aviso de modo apropiado. Esta opción puede utilizarse para indicar que los avisos del gestor de bases de datos no van a pasarse a la aplicación.

0 = Los avisos se comunican como de costumbre (valor por omisión).
1 = Los avisos del gestor de bases de datos se ignoran, se devuelve SQL_SUCCESS. Los avisos del controlador de CLI de DB2/ODBC se siguen devolviendo; muchos son necesarios para un funcionamiento normal.

Aunque esta opción puede utilizarse de modo independiente, también puede utilizarse junto con la palabra clave de configuración WARNINGLIST de CLI/ODBC.

IGNOREWARNLIST

Descripción de la palabra clave:
Ignorar los sqlstates (estadosql) especificados.

Sintaxis de la palabra clave db2cli.ini:
IGNOREWARNLIST = "'estadosql1', 'estadosql2', ..."

Valor por omisión:
Los avisos se devuelven como de costumbre

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Consulte asimismo:
WARNINGLIST, IGNOREWARNINGS

Notas de utilización:
 

En contadas ocasiones, es posible que una aplicación no maneje algunos mensajes de aviso de modo apropiado, sin que se desee ignorar todos los mensajes de aviso. Esta palabra opción puede utilizarse para indicar los avisos que no van a pasarse a la aplicación. La palabra clave IGNOREWARNINGS debe utilizarse en el caso de que se ignoren todos los avisos del gestor de bases de datos.

Si se incluye un sqlstate (estadosql) tanto en IGNOREWARNLIST como en WARNINGLIST, éste se ignorará por completo.

Todos los sqlstate (estadosql) deben estar en mayúsculas, delimitados por caracteres de una sola comilla y separados por comas. La serie completa debe ir asimismo entrecomillada entre dobles comillas. Por ejemplo:

   IGNOREWARNLIST="'01000', '01004','01504'"

KEEPCONNECT

Descripción de la palabra clave:
Número de conexiones a colocar en antememoria.

Sintaxis de la palabra clave db2cli.ini:
KEEPCONNECT = 0 | positive integer

Valor por omisión:
No colocar las conexiones en antememoria.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Notas de utilización:
 

0 = No colocar conexiones de base de datos en antememoria (valor por omisión).

Establecer esta opción en un valor superior a cero puede acelerar las aplicaciones que constantemente se conectan y se desconectan de la misma base de datos utilizando la misma información de conexión.

En vez de cerrar la conexión cada vez y después volverla a abrir, el controlador de CLI/ODBC mantendrá abierta la conexión y colocará la información de conexión en antememoria. Cuando la petición de conectarse a la misma base de datos se produce por segunda vez, se utiliza la conexión existente. Esta acción ahorra tiempo, recursos y flujo de red para cerrar la primera conexión, así como para volver a abrir la segunda conexión.

El valor establecido para esta opción indica el número de conexiones de base de datos a colocar en la antememoria. Aunque el máximo sólo está limitado por los recursos del sistema, normalmente un valor de 1 ó 2 es suficiente para las aplicaciones que se beneficiarán por completo de este comportamiento.

KEEPSTATEMENT

Descripción de la palabra clave:
Número de manejadores de sentencia a colocar en antememoria.

Sintaxis de la palabra clave db2cli.ini:
KEEPSTATEMENT = 5 | positive integer

Valor por omisión:
Poner en antememoria 5 manejadores de sentencias.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Notas de utilización:
 

Por omisión, se pone en antememoria la memoria necesaria para 5 manejadores de sentencias. Cuando se cierra un manejador de sentencias, no se desasigna la memoria utilizada para dicho manejador, sino que se utiliza cuando se asigna el siguiente manejador de sentencias.

El valor establecido para esta opción determina el número de manejadores de sentencias que se coloca en la antememoria. Puede establecerse en menos de 5 para reducir explícitamente la cantidad de memoria que utiliza la antememoria de sentencias. Puede aumentarse a más de 5 para mejorar el rendimiento para las aplicaciones que abren, cierran y después vuelven a abrir grandes conjuntos de sentencias.

Los recursos del sistema determinan el número máximo de manejadores de sentencias que se coloca en antememoria.

LOBMAXCOLUMNSIZE

Descripción de la palabra clave:
Alterar temporalmente COLUMN_SIZE por omisión para tipos de datos LOB.

Sintaxis de la palabra clave db2cli.ini:
LOBMAXCOLUMNSIZE = entero superior a cero

Valor por omisión:
2 Gigabytes (1G para DBCLOB)

Pestaña de valores de CLI de DB2/ODBC:
Tipo de datos

Sólo es de aplicación cuando:
Se utiliza la opción LONGDATACOMPAT.

Consulte asimismo:
LONGDATACOMPAT

Notas de utilización:
 

Esta opción alterará temporalmente el valor de 2 Gigabytes (1G para DBCLOB) que devuelve SQLGetTypeInfo() para la columna COLUMN_SIZE para los tipos de datos SQL_CLOB, SQL_BLOB y SQL_DBCLOB SQL. Las siguientes sentencias CREATE TABLE que contienen columnas LOB utilizarán el valor de tamaño de columna establecido en este punto en vez del valor por omisión.

LONGDATACOMPAT

Descripción de la palabra clave:
Comunicar los LOB como tipos de datos largos o como tipos de objetos grandes.

Sintaxis de la palabra clave db2cli.ini:
LONGDATACOMPAT = 0 | 1

Valor por omisión:
Referenciar tipos de datos LOB como tipos de objetos grandes.

Pestaña de valores de CLI de DB2/ODBC:
Tipo de datos

Consulte asimismo:
LOBMAXCOLUMNSIZE

Notas de utilización:
 

Esta opción indica a CLI de DB2 el tipo de datos que espera la aplicación al trabajar con una base de datos con columnas de objetos grandes (LOB).
Tipo de datos de base de datos Objetos grandes (0--Valor por omisión) Tipos de datos largos (1)
CLOB SQL_CLOB SQL_LONGVARCHAR
BLOB SQL_BLOB SQL_LONGVARBINARY
DBCLOB SQL_DBCLOB SQL_LONGVARGRAPHIC

Esta opción resulta útil al ejecutar aplicaciones ODBC que no pueden manejar los tipos de objetos grandes.

La opción CLI de DB2/ODBC LOBMAXCOLUMNSIZE puede utilizarse conjuntamente con esta opción para reducir el tamaño por omisión declarado para los datos.

MAXCONN

Descripción de la palabra clave:
Número máximo de conexiones que se admite para cada una de las aplicaciones.

Sintaxis de la palabra clave db2cli.ini:
MAXCONN = 0 | positive number

Valor por omisión:
Tantas conexiones como permitan los recursos del sistema.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Notas de utilización:
 

Esta opción se utiliza para especificar el número máximo de conexiones que se permite para cada aplicación CLI/ODBC. Puede utilizarse como gobernador del número máximo de conexiones que puede abrir cada una de las aplicaciones y que un administrador puede optar por restringir. Puede utilizarse un valor de 0 para representar sin límite; es decir, se permite que una aplicación abra tantas conexiones como permitan los recursos del sistema.

En las plataformas OS/2 y WIN32 (Windows NT y Windows 95), si se está utilizando el protocolo de NetBIOS, este valor se corresponde con el número de conexiones (sesiones de NetBIOS) que la aplicación configurará de modo simultáneo. El rango de valores para OS/2 NetBIOS va de 1 a 254. Especificar 0 (el valor por omisión) dará como resultado 5 conexiones reservadas. Sesiones NetBIOS reservadas no puede ser utilizado por otras aplicaciones. El número de conexiones que especifica este parámetro se aplicará a cualquier adaptador que utilice el protocolo NetBIOS de DB2 para conectarse al servidor remoto (el número de adaptador se especifica en el directorio de nodos para un nodo de NetBIOS).

MODE

Descripción de la palabra clave:
Modalidad de conexión por omisión.

Sintaxis de la palabra clave db2cli.ini:
MODE = SHARE | EXCLUSIVE

Valor por omisión:
SHARE

Pestaña de valores de CLI de DB2/ODBC:
Transacción

No es de aplicación al:
conectarse a una base de datos DRDA.

Notas de utilización:
 

Establece la modalidad de CONNECT en SHARE o EXCLUSIVE. Si la aplicación establece una modalidad en el momento de la conexión, se ignorará este valor. El valor por omisión es SHARE.
Nota:EXCLUSIVE no se permite para las conexiones DRDA. Consulte la publicación Consulta de SQL para obtener más información sobre la sentencia CONNECT.

MULTICONNECT

Descripción de la palabra clave:
El modo en que las peticiones SQLConnect() se correlacionan con las conexiones de base de datos físicas.

Sintaxis de la palabra clave db2cli.ini:
MULTICONNECT = 0 | 1

Valor por omisión:
Cada petición SQLConnect() por parte de la aplicación dará como resultado una conexión de base de datos física.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Notas de utilización:
 

Esta opción se utiliza para especificar el modo en que las peticiones de SQLConnect() se correlacionan con las conexiones de bases de datos físicas.

1 = Las conexiones no están compartidas, se utilizan varias conexiones (valor por omisión) -- Cada petición SQLConnect() por parte de la aplicación dará como resultado una conexión de base de datos física.
0 = Las conexiones se correlacionan con una conexión física, se utiliza una conexión -- Todas las conexiones para la aplicación se correlacionan a una conexión física. Esto puede resultar útil si:

Si MULTICONNECT se establece en 0, deben inhabilitarse la acción de varios pasos simultáneos utilizando la palabra clave DISABLEMULTITHREAD

Nota:Si se arranca MULTICONNECT, se ejecutan todas las sentencias en la misma conexión y por tanto en la misma transacción. Esto significa que una retrotracción retrotraerá ALL (TODAS) las sentencias en todas las conexiones. Asegúrese de que la aplicación se ha diseñado para que funcione con MULTICONNECT desactivado antes de hacerlo o es posible que la aplicación no funcione de modo correcto.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

OPTIMIZEFORNROWS

Descripción de la palabra clave:
Agregar la cláusula "OPTIMIZE FOR n ROWS" a cada sentencia seleccionada.

Sintaxis de la palabra clave db2cli.ini:
OPTIMIZEFORNROWS = entero

Valor por omisión:
La cláusula no se agrega.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Notas de utilización:
 

La opción agregará la cláusula "OPTIMIZE FOR n ROWS" a cada sentencia seleccionada, donde n es cualquier entero mayor que 0. Si se establece en 0 (el valor por omisión) esta cláusula no se agregará.

Para obtener más información sobre el efecto de la cláusula OPTIMIZE FOR n ROWS, consulte la publicación Administration Guide.

OPTIMIZESQLCOLUMNS

Descripción de la palabra clave:
Optimizar llamada SQLColumns() con Nombre de tabla y esquema explícitos.

Sintaxis de la palabra clave db2cli.ini:
OPTIMIZESQLCOLUMNS = 0 | 1

Valor por omisión:
0 - toda la información de columna devuelta

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Si OPTIMIZESQLCOLUMNS está activada (se establece en 1), todas las llamadas a SQLColumns() se optimizarán si se especifica un Nombre de esquema explícito (sin comodín especificado), un Nombre de tabla explícito y % (ALL (Todas) las columnas) para Nombre de columna. El Controlador de DB2 CLI/ODBC optimizará esta llamada para que no se exploren las tablas del sistema. Si se optimiza la llamada, no se devuelve la información de COLUMN_DEF (que contiene la serie por omisión para las columnas). Al conectarse a una base de datos de AS/400, la información que devuelve SQLColumns() para las columnas cuyo tipo de datos es NUMERIC será incorrecta. Si la aplicación no necesita esta información, podrá activar la optimización para aumentar el rendimiento.

Si la aplicación necesita la información de COLUMN_DEF, OPTIMIZESQLCOLUMNS debería establecerse en 0. Este es el valor por omisión.

PATCH1

Descripción de la palabra clave:
Utilizar soluciones indirectas para problemas conocidos con aplicaciones de ODBC.

Sintaxis de la palabra clave db2cli.ini:
PATCH1 = { 0 | 1 | 2 | 4 | 8 | 16 | ... }

Valor por omisión:
No utilizar soluciones indirectas.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Consulte asimismo:
PATCH2

Notas de utilización:
 

Esta palabra clave se utiliza para especificar una solución indirecta para problemas conocidos con aplicaciones de ODBC. El valor especificado puede ser para una solución indirecta, varias soluciones indirectas o ninguna. Los valores de parche que se especifican en este punto se utilizan conjuntamente con cualquier valor de PATCH2 que también pudiera haberse establecido.

Utilizando el cuaderno Valores de CLI de DB2/ODBC puede seleccionar uno o más de los parches que han de utilizarse. Si establece los valores en el propio archivo db2cli.ini y desea utilizar varios valores de parche, sume simplemente los valores para formar el valor de palabra clave. Por ejemplo, si desea los parches 1, 4 y 8, especifique PATCH1=13.

0 = No hay solución indirecta (valor por omisión).

El cuaderno Valores de CLI de DB2/ODBC tiene una lista de valores. Seleccione la carpeta Servicio en la carpeta de DB2 para obtener información sobre el modo de actualizar esta lista de valores. Esta información también está contenida en el archivo README (el archivo README no tendrá dicha sección en el caso de que no haya valores de parche actuales para dicha plataforma).

PATCH2

Descripción de la palabra clave:
Utilizar soluciones indirectas para problemas conocidos con aplicaciones de CLI/ODBC.

Sintaxis de la palabra clave db2cli.ini:
PATCH2 = "valor de parche 1valor de parche 2valor de parche 3,  ..."

Valor por omisión:
No utilizar soluciones indirectas

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Consulte asimismo:
PATCH1

Notas de utilización:
 

Esta palabra clave se utiliza para especificar una solución indirecta para problemas conocidos con aplicaciones de CLI/ODBC. El valor especificado puede ser para una solución indirecta, varias soluciones indirectas o ninguna. Los valores de parche que se especifican en este punto se utilizan conjuntamente con cualquier valor de PATCH1 que también pudiera haberse establecido.

Al especificar varios parches, los valores se especifican en una serie delimitada por comas (al contrario que la opción PATCH1 en la que los valores se suman y se utiliza la suma).

0 = No hay solución indirecta (valor por omisión).

Para establecer los valores 3, 4 y 8 de PATCH2, debe especificar:

    PATCH2="3, 4, 8"

Los valores de PATCH2 están contenidos en el archivo README (el archivo README no tendrá dicha sección en el caso de que no haya valores de parche actuales para dicha plataforma).

POPUPMESSAGE

Descripción de la palabra clave:
Hacer emerger un recuadro de mensaje cada vez que CLI/ODBC genera un error.

Sintaxis de la palabra clave db2cli.ini:
POPUPMESSAGE = 0 | 1

Valor por omisión:
No visualizar recuadro de mensajes.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Sólo es de aplicación al:
ejecutar aplicaciones de OS/2 o Windows.

Consulte asimismo:
SQLSTATEFILTER

Notas de utilización:
 

Hacer emerger un recuadro de mensajes cada vez que CLI de DB2 genera un error que puede recuperarse utilizando SQLGetDiagRec() o SQLError(). Resulta útil para depurar aplicaciones que no comunican mensajes a los usuarios.

0 = NO visualizar un recuadro de mensajes (valor por omisión)
1 = visualizar un recuadro de mensajes

PROTOCOL

Descripción de la palabra clave:
Protocolo de comunicaciones utilizado para DSN de archivos.

Sintaxis de la palabra clave db2cli.ini:
PROTOCOL = TCPIP

Valor por omisión:
ninguno

Pestaña de valores de CLI de DB2/ODBC:
DSN de archivos

Consulte asimismo:
HOSTNAME, SERVICENAME

Notas de utilización:
 

TCP/IP es el único protocolo soportado al utilizar un DSN de archivos. Establezca la opción en la serie TCPIP (sin la barra inclinada).

Cuando se establezca esta opción, también deben establecerse las siguientes opciones:

PWD

Descripción de la palabra clave:
Definir contraseña por omisión.

Sintaxis de la palabra clave db2cli.ini:
PWD = contraseña

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Valores generales de CLI/ODBC

Notas de utilización:
 

Se utiliza este valor de contraseña en el caso de que la aplicación no proporcione una contraseña en tiempo de conexión.

Se almacena en texto plano y por tanto no está protegida.

QUERYTIMEOUTINTERVAL

Descripción de la palabra clave:
Retardo (en segundos) entre comprobaciones de un tiempo de espera excedido de consulta

Sintaxis de la palabra clave db2cli.ini:
QUERYTIMEOUTINTERVAL = 0 | positive integer

Valor por omisión:
5 segundos

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Notas de utilización:
 

Una aplicación puede utilizar la función SQLSetStmtAttr() para establecer el atributo de sentencia SQL_ATTR_QUERY_TIMEOUT. Esta acción indica el número de segundos que ha de esperarse la ejecución de una sentencia SQL antes de volver a la aplicación

La palabra de configuración QUERYTIMEOUTINTERVAL se utiliza para indicar el tiempo que ha de esperar el controlador de CLI entre comprobaciones para ver si se ha completado la consulta.

Por ejemplo, suponga que SQL_ATTR_QUERY_TIMEOUT se ha establecido en 25 segundos (tiempo de espera excedido después de haber esperado 25 segundos) y que QUERYTIMEOUTINTERVAL se ha establecido en 10 segundos (comprobar la consulta cada 10 segundos). La consulta no llegará al tiempo de espera excedido hasta los 30 segundos (la primera comprobación DESPUÉS del límite de 25 segundos).

Puede haber casos en los que SQL_ATTR_QUERY_TIMEOUT se haya establecido en un valor que sea demasiado bajo y la consulta NO llegue al tiempo de espera excedido. Si no puede modificarse la aplicación (es decir, una aplicación de ODBC de un tercero), el QUERYTIMEOUTINTERVAL puede establecerse en 0 y el controlador de CLI ignorará el valor de SQL_ATTR_QUERY_TIMEOUT.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

SCHEMALIST

Descripción de la palabra clave:
Restringir los esquemas utilizados para consultar información de tablas.

Sintaxis de la palabra clave db2cli.ini:
SCHEMALIST = " 'esquema1', 'esquema2',... 'esquemaN' "

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Notas de utilización:
 

SCHEMALIST se utiliza para proporcionar un valor por omisión más restrictivo y por tanto para mejorar el rendimiento, para las aplicaciones que listan cada una de las tablas en el DBMS.

Si hay un gran número de tablas definido en la base de datos, puede especificarse una lista de esquemas para reducir el tiempo que tarda la aplicación en consultar información de tablas y reducir el número de tablas que lista la aplicación. Cada nombre de esquema es sensible a mayúsculas y minúsculas, debe estar delimitado por comillas simples y separado por comas. La serie completa debe ir entrecomillada entre dobles comillas. Por ejemplo:

    SCHEMALIST="'USER1','USER2','USER3'"

Para DB2 para MVS/ESA, CURRENT SQLID puede incluirse asimismo en esta lista, pero sin las comillas simples, por ejemplo:

    SCHEMALIST="'USER1',CURRENT SQLID,'USER3'"

La longitud máxima de la serie es de 256 caracteres.

Esta opción puede utilizarse junto con SCHEMALIST y TABLETYPE para limitar aún más el número de tablas para las que se devolverá información.

SERVICENAME

Descripción de la palabra clave:
El número de puerto o nombre de servicio del sistema servidor, que se utiliza con el DSN de archivos.

Sintaxis de la palabra clave db2cli.ini:
SERVICENAME = nombre de servicio | número de puerto

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
DSN de archivos

Sólo es de aplicación cuando:
PROTOCOL se establece en TCPIP

Consulte asimismo:
PROTOCOL, HOSTNAME

Notas de utilización:
 

Utilice esta opción junto con la opción HOSTNAME para especificar los atributos necesarios para la conexión de TCP/IP desde esta máquina cliente para un servidor que ejecuta DB2. Estos dos valores sólo se tienen en cuenta cuando la opción PROTOCOL se establece en TCPIP.

Especifica el número de puerto o el nombre de servicio del sistema servidor.

SQLSTATEFILTER

Descripción de la palabra clave:
No hacer emerger un mensaje de error para los SQLSTATES definidos.

Sintaxis de la palabra clave db2cli.ini:
SQLSTATEFILTER = " 'XXXXX', 'YYYYY', ... "

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Sólo es de aplicación cuando:
Se activa la opción POPUPMESSAGE.

Consulte asimismo:
POPUPMESSAGE

Notas de utilización:
 

Ha de utilizarse conjuntamente con la opción POPUPMESSAGE. Esta acción impide que CLI de DB2 visualice los errores que estén asociados con los estados definidos.

Cada SQLSTATE debe estar en mayúsculas, delimitado por caracteres de comilla sencilla y separado por comas. La serie completa debe ir entrecomillada entre dobles comillas. Por ejemplo:

    SQLSTATEFILTER=" 'HY1090', '01504', '01508' "

STATICCAPFILE

Descripción de la palabra clave:
Especificar el nombre de Archivo de capturas y, opcionalmente, el directorio en el que se guardará.

Sintaxis de la palabra clave db2cli.ini:
STATICCAPFILE = < Full file name >

Valor por omisión:
Ninguno - debe especificar un nombre de archivo de capturas.

Pestaña de valores de CLI de DB2/ODBC:
SQL estático

Sólo es de aplicación cuando:
STATICMODE se establece en Captura o Coincidencia

Consulte asimismo:
STATICLOGFILE, STATICMODE, STATICPACKAGE

Notas de utilización:
 

Esta palabra clave se utiliza para especificar el nombre de Archivo de capturas y, opcionalmente, el directorio en el que se guardará.

Para obtener más información sobre la ejecución de aplicaciones de CLI/ODBC como SQL estático, consulte la palabra clave STATICMODE.

STATICLOGFILE

Descripción de la palabra clave:
Especificar el nombre de Archivo de anotaciones cronológicas de perfil estático y, opcionalmente, el directorio en el que se guardará.

Sintaxis de la palabra clave db2cli.ini:
STATICLOGFILE = < Full file name >

Valor por omisión:
No se crea la Anotación cronológica de perfiles estáticos. Si se especifica un nombarchivo sin un nombre de vía de acceso, se utilizará la vía de acceso actual.

Pestaña de valores de CLI de DB2/ODBC:
SQL estático

Sólo es de aplicación cuando:
STATICMODE se establece en Captura o Coincidencia

Consulte asimismo:
STATICCAPFILE, STATICMODE, STATICPACKAGE

Notas de utilización:
 

Esta palabra clave se utiliza para especificar el nombre de Archivo de anotación cronológica de perfiles estáticos y, opcionalmente, el directorio en el que se guardará.

Para obtener más información sobre la ejecución de aplicaciones de CLI/ODBC como SQL estático, consulte la palabra clave STATICMODE.

STATICMODE

Descripción de la palabra clave:
Especificar si la aplicación de CLI/ODBC capturará SQL o utilizará un paquete de SQL estático para este DSN.

Sintaxis de la palabra clave db2cli.ini:
STATICMODE = DISABLED | CAPTURE | MATCH

Valor por omisión:
0 Inhabilitado - Las sentencias de SQL no se capturan y no se utiliza ningún paquete de SQL estático.

Pestaña de valores de CLI de DB2/ODBC:
SQL estático

Consulte asimismo:
STATICCAPFILE, STATICPACKAGE, STATICLOGFILE

Notas de utilización:
 

Esta opción le permite especificar el modo en que se procesará el SQL que emite la aplicación CLI/ODBC para este DSN:

Para obtener más información sobre la ejecución de aplicaciones CLI/ODBC como SQL estático, consulte las Notas de release y la publicación CLI Guide and Reference También hay información adicional disponible en Internet en la dirección http://www.ibm.com/software/data/db2/udb/staticcli

STATICPACKAGE

Descripción de la palabra clave:
Especificar el paquete que ha de utilizarse con la característica de perfil estático.

Sintaxis de la palabra clave db2cli.ini:
STATICPACKAGE = collection_id.package_name

Valor por omisión:
Ninguno - debe especificar un nombre de paquete.

Pestaña de valores de CLI de DB2/ODBC:
SQL estático

Sólo es de aplicación cuando:
STATICMODE se establece en CAPTURE

Consulte asimismo:
STATICCAPFILE, STATICMODE, STATICLOGFILE

Notas de utilización:
 

Esta palabra clave se utiliza para especificar el paquete que ha de utilizarse cuando la aplicación se ejecuta en Modalidad de coincidencia. En primer lugar ha de utilizar la Modalidad de capturas para crear el Archivo de capturas.

Sólo se utilizarán los 7 primeros caracteres del nombre de paquete indicado. Se añadirá un sufijo de un byte para representar cada nivel de aislamiento, del modo siguiente:

Para obtener más información sobre la ejecución de aplicaciones de CLI/ODBC como SQL estático, consulte la palabra clave STATICMODE.

SYNCPOINT

Descripción de la palabra clave:
El modo en que las confirmaciones y retrotracciones se coordinan entre varias conexiones de base de datos (DUOW).

Sintaxis de la palabra clave db2cli.ini:
SYNCPOINT = 1 | 2

Valor por omisión:
Confirmación de 1 fase.

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Sólo es de aplicación cuando:
el tipo de conexión por omisión se establece en Conexiones coordinadas (CONNECTTYPE=2)

Consulte asimismo:
CONNECTTYPE

Notas de utilización:
 

Utilice esta opción para especificar el modo en que las confirmaciones y retrotracciones se coordinarán entre varias conexiones de base de datos (DUOW). Sólo es relevante cuando el tipo de conexión por omisión se establece en Conexiones coordenadas (CONNECTTYPE = 2).

SYSSCHEMA

Descripción de la palabra clave:
Indica un esquema alternativo que ha de buscarse en vez de los esquemas de SYSIBM (o SYSTEM, QSYS2).

Sintaxis de la palabra clave db2cli.ini:
SYSSCHEMA = esquemasis

Valor por omisión:
No se han especificado alternativas.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Notas de utilización:
 

Esta opción indica un esquema alternativo que ha de buscarse en vez de los esquemas de SYSIBM (o SYSTEM, QSYS2) cuando se emiten las llamadas de Función de catálogos de ODBC y CLI de DB2 para obtener información de catálogo del sistema.

Utilizando este nombre de esquema, el administrador del sistema puede definir un conjunto de vistas que conste de un subconjunto de las filas para cada una de las tablas de catálogo del sistema siguientes:
DB2 Universal Database DB2 para MVS/ESA DB2 para VSE y VM OS/400 DB2 Universal Database para AS/400
SYSTABLES SYSTABLES SYSCATALOG SYSTABLES SYSTABLES
SYSCOLUMNS SYSCOLUMNS SYSCOLUMNS SYSCOLUMNS SYSCOLUMNS
SYSINDEXES SYSINDEXES SYSINDEXES SYSINDEXES SYSINDEXES
SYSTABAUTH SYSTABAUTH SYSTABAUTH
SYSCST
SYSRELS SYSRELS SYSKEYCOLS
SYSKEYCST
SYSDATATYPES SYSSYNONYMS SYSSYNONYMS
SYSCSTCOL
SYSPROCEDURES SYSKEYS SYSKEYS
SYSKEYS
SYSPROCPARMS SYSCOLAUTH SYSCOLAUTH
SYSREFCST

SYSFOREIGNKEYS



SYSPROCEDURES 1



SYSDATABASE


1 DB2 para MVS/ESA 4.1 únicamente.

Por ejemplo, si el conjunto de vistas para las tablas de catálogo del sistema está en el esquema de ACME, la vista para SYSIBM.SYSTABLES es ACME.SYSTABLES; y SYSSCHEMA debería establecerse en ACME.

Definir y utilizar vistas limitadas de las tablas de catálogo del sistema reduce el número de tablas listadas por la aplicación, lo cual reduce el tiempo que utiliza la aplicación para consultar información de tablas.

Si no se especifica ningún valor, el valor por omisión es:

Esta palabra clave puede utilizarse junto con SCHEMALIST y TABLETYPE (y DBNAME en DB2 para MVS/ESA) para limitar aún más el número de tablas para las que se devolverá información.

TABLETYPE

Descripción de la palabra clave:
Definir una lista de TABLETYPES por omisión que se ha devuelto al consultar información de tablas.

Sintaxis de la palabra clave db2cli.ini:
TABLETYPE = " 'TABLE' | ,'ALIAS' | ,'VIEW' | , 'INOPERATIVE VIEW' | , 'SYSTEM TABLE' | ,'SYNONYM' "

Valor por omisión:
No se define una lista de TABLETYPES por omisión.

Pestaña de valores de CLI de DB2/ODBC:
Enterprise

Notas de utilización:
 

Si hay un gran número de tablas definido en la base de datos, puede especificarse una serie de tipos de tablas para reducir el tiempo que tarda la aplicación en consultar la información de tablas y reducir el número de tablas que lista la aplicación.

Puede especificarse cualquier número de valores. Cada tipo debe estar delimitado con comillas simples, estar separado por comas y estar en mayúsculas. La serie completa debe ir asimismo entrecomillada entre dobles comillas. Por ejemplo:

    TABLETYPE="'TABLE','VIEW'"

Esta opción puede utilizarse junto con DBNAME y SCHEMALIST para limitar aún más el número de tablas para las que se devolverá información.

TABLETYPE se utiliza para proporcionar un valor por omisión para la función de CLI de DB2 que recupera la lista de tablas, vistas, alias y sinónimos de la base de datos. Si la aplicación no especifica un tipo de tablas en la llamada de función y no se utiliza esta palabra clave, se devuelve información sobre todos los tipos de tabla. Si la aplicación proporciona un valor para tipo de tablas en la llamada de función, dicho valor de argumento alterará temporalmente este valor de palabra clave.

Si TABLETYPE incluye cualquier valor que no sea TABLE, no podrá utilizarse el valor de palabra clave DBNAME para restringir información para una base de datos DB2 para MVS/ESA en concreto.

TEMPDIR

Descripción de la palabra clave:
Definir el directorio utilizado para los archivos temporales asociados con campos LOB.

Sintaxis de la palabra clave db2cli.ini:
TEMPDIR = < nombre de vía de acceso completa >

Valor por omisión:
Utilizar el directorio temporal del sistema.

Pestaña de valores de CLI de DB2/ODBC:
Entorno

Notas de utilización:
 

Al trabajar con objetos grandes (CLOBS, BLOBS, etc...), a menudo se crea un archivo temporal en la máquina cliente para almacenar la información. Utilizando esta opción puede especificar una ubicación para estos archivos temporales. El directorio temporal del sistema se utilizará en el caso de que no se especifique nada.

La palabra clave se coloca en la sección específica de la fuente de datos del archivo db2cli.ini y tiene la sintaxis siguiente:

Cuando se accede a un Objeto grande, se devolverá un SQLSTATE de HY507 en el caso de que el nombre de vía de acceso no sea válido, o en en el caso de que los archivos temporales no puedan crearse en el directorio especificado.

TRACE

Descripción de la palabra clave:
Activar el recurso de rastreo de DB2 CLI/ODBC.

Sintaxis de la palabra clave db2cli.ini:
TRACE = 0 | 1

Valor por omisión:
No se captura información de rastreos.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Consulte asimismo:
TRACEFILENAME, TRACEFLUSH, TRACEPATHNAME

Notas de utilización:
 

Cuando se activa esta opción (1), los registros de rastreo de CLI/ODBC se agregan al archivo indicado por medio del parámetro de configuración de TRACEFILENAME o a los archivos del subdirectorio indicado por medio del parámetro de configuración TRACEPATHNAME.

Por ejemplo, para configurar un archivo de rastreos de CLI/ODBC que se grabe en disco después de cada entrada de rastreos:

     [COMMON]
     TRACE=1
     TRACEFILENAME=E:\TRACES\CLI\MONDAY.CLI
     TRACEFLUSH=1

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

TRACECOMM

Descripción de la palabra clave:
Incluir información sobre cada petición de red en el archivo de rastreos.

Sintaxis de la palabra clave db2cli.ini:
TRACECOMM = 0 | 1

Valor por omisión:
0 - No se ha capturado información de petición de red.

Pestaña de valores de CLI de DB2/ODBC:
Esta palabra clave no puede establecerse utilizando el cuaderno Valores de CLI/ODBC. El archivo db2cli.ini debe modificarse directamente para utilizar esta palabra clave.

Sólo es de aplicación cuando:
se activa la opción TRACE de CLI/ODBC.

Consulte asimismo:
TRACE, TRACEFILENAME, TRACEPATHNAME, TRACEFLUSH

Notas de utilización:
 

Cuando se activa TRACECOMM (1) se incluirá información sobre cada petición de red en el archivo de rastreos.

Esta opción sólo se utiliza cuando se activa la opción TRACE de CLI/ODBC. Para ver un ejemplo, consulte TRACE.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

TRACEFILENAME

Descripción de la palabra clave:
Archivo utilizado para almacenar información de rastreo de CLI de DB2/ODBC.

Sintaxis de la palabra clave db2cli.ini:
TRACEFILENAME = < Nombre de archivo completo >

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Sólo es de aplicación cuando:
se activa la opción TRACE.

Consulte asimismo:
TRACE, TRACEFLUSH, TRACEPATHNAME

Notas de utilización:
 

Si el archivo especificado no existe, se creará; en caso contrario, la información de rastreo nueva se agregará al final del archivo.

Si el nombarchivo dado no es válido o no puede crearse o grabarse, no se producirá ningún rastreo y no se devolverá ningún mensaje de error.

Esta opción sólo se utiliza cuando se activa la opción TRACE. Esta opción se efectuará de modo automático al establecer esta opción en el programa de utilidad de Configuración de CLI/ODBC.

Para ver un ejemplo de la utilización de diversos valores de rastreo, consulte la opción TRACE. La opción TRACEPATHNAME se ignorará en el caso de que se establezca esta opción.

El rastreo de CLI de DB2 sólo debe utilizarse con finalidad de depuración. Ralentizará la ejecución del controlador de CLI/ODBC y la información de rastreo puede llegar a ser muy grande en el caso de que se deje durante períodos de tiempo dilatados.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

TRACEFLUSH

Descripción de la palabra clave:
Forzar una grabación en disco después de cada entrada de rastreo de CLI/ODBC.

Sintaxis de la palabra clave db2cli.ini:
TRACEFLUSH = 0 | 1

Valor por omisión:
No grabar después de cada entrada.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Sólo es de aplicación cuando:
se activa la opción TRACE de CLI/ODBC.

Consulte asimismo:
TRACE, TRACEFILENAME, TRACEPATHNAME

Notas de utilización:
 

Establezca esta opción en (TRACEFLUSH = 1) para forzar una grabación en disco después de cada entrada de rastreo. Esta acción ralentizará el proceso de rastreo, pero asegurará que todas las entradas se graban en disco antes de que la aplicación continúe hacia la sentencia siguiente.

Esta opción sólo se utiliza cuando se activa la opción TRACE de CLI/ODBC. Para ver un ejemplo, consulte la opción TRACE.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

TRACEPATHNAME

Descripción de la palabra clave:
Subdirectorio utilizado para almacenar archivos de rastreo DB2 CLI/ODBC individuales.

Sintaxis de la palabra clave db2cli.ini:
TRACEPATHNAME = < Nombre de subdirectorio completo >

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Sólo es de aplicación cuando:
se activa la opción TRACE.

No es de aplicación cuando:
se activa la opción TRACEFILENAME.

Consulte asimismo:
TRACE, TRACEFILENAME, TRACEFLUSH

Notas de utilización:
 

Cada paso o proceso que utiliza la misma biblioteca compartida o DLL tendrá un archivo de rastreo CLI de DB2/ODBC independiente creado en el directorio especificado.

No se producirá ningún rastreo y no se devolverá ningún mensaje de error, en el caso de que el subdirectorio dado no sea válido o no pueda grabarse en el mismo.

Esta opción sólo se utiliza cuando se activa la opción TRACE. Esta opción se efectuará de modo automático al establecer esta opción en el programa de utilidad de Configuración de CLI/ODBC.

Para ver un ejemplo de la utilización de diversos valores de rastreo, consulte la opción TRACE. Se ignorará si se utiliza la opción CLI de DB2/ODBC TRACEFILENAME.

El rastreo de CLI de DB2 sólo debe utilizarse con finalidad de depuración. Ralentizará la ejecución del controlador de CLI/ODBC y la información de rastreo puede llegar a ser muy grande en el caso de que se deje durante períodos de tiempo dilatados.

(Esta opción se halla en la sección "Common" del archivo de inicialización y, por tanto, se aplica a todas las conexiones con DB2.)

TXNISOLATION

Descripción de la palabra clave:
Establece el nivel de aislamiento por omisión.

Sintaxis de la palabra clave db2cli.ini:
TXNISOLATION = 1 | 2 | 4 | 8 | 32

Valor por omisión:
Lectura confirmada (Estabilidad del cursor)

Pestaña de valores de CLI de DB2/ODBC:
Transacción

Sólo es de aplicación cuando:
se utiliza el nivel de aislamiento por omisión. Esta palabra clave no tendrá efecto alguno en el caso de que la aplicación haya establecido el nivel de aislamiento de modo específico.

Notas de utilización:
 

Establece el nivel de aislamiento en:

1 = Lectura no confirmada (lectura sin confirmar)
2 = Lectura confirmada (Estabilidad del cursor) (valor por omisión)
4 = Lectura repetible (Estabilidad de lectura)
8 = Serializable (Lectura repetible)
32 = (Sin confirmación, DATABASE 2 para AS/400 sólo; es similar a confirmación automática)

Las palabras entre paréntesis son la terminología de IBM para los niveles de aislamiento de SQL92 equivalente. Tenga en cuenta que sin confirmación no es un nivel de aislamiento de SQL92 y sólo está soportado en DB2 Universal Database para AS/400. Consulte la publicación Consulta de SQL para obtener más información sobre los niveles de aislamiento.

Esta palabra clave sólo es aplicable si se utiliza el nivel de aislamiento por omisión. Esta palabra clave no tendrá efecto alguno en el caso de que la aplicación haya establecido el nivel de aislamiento de modo específico.

UID

Descripción de la palabra clave:
Definir el ID de usuario por omisión

Sintaxis de la palabra clave db2cli.ini:
UID = idusuario

Valor por omisión:
Ninguno

Pestaña de valores de CLI de DB2/ODBC:
Valores generales de CLI/ODBC

Notas de utilización:
 

Se utiliza el valor de idusuario especificado en el caso de que la aplicación no proporcione un ID de usuario en tiempo de conexión.

UNDERSCORE

Descripción de la palabra clave:
Especificar si va a utilizarse o no el carácter de subrayado "_" como carácter de comodín.

Sintaxis de la palabra clave db2cli.ini:
UNDERSCORE = 1 | 0

Valor por omisión:
"_" actúa como comodín.

Pestaña de valores de CLI de DB2/ODBC:
Optimización

Notas de utilización:
 

Esta opción le permite especificar si va a utilizarse o no el carácter de subrayado "_" como carácter de comodín (que se corresponde con cualquier carácter, incluyendo la ausencia de un carácter), o va a utilizarse como propio carácter de subrayado. Esta opción sólo afecta a las llamadas de función de catálogo que aceptan series de patrón de búsqueda.

Nota:Esta palabra clave sólo tiene efecto sobre las versiones de servidor común de DB2 anteriores a la versión 2.1. La cláusula ESCAPE para el predicado LIKE pueden utilizarse para las versiones sucesivas y todos los demás servidores de DB2. Para obtener más información sobre la cláusula ESCAPE, consulte el manual Consulta de SQL.

WARNINGLIST

Descripción de la palabra clave:
Especificar los errores que han de rebajarse a avisos.

Sintaxis de la palabra clave db2cli.ini:
WARNINGLIST = " 'xxxxx', 'yyyyy',  ..."

Valor por omisión:
No rebajar ningún SQLSTATE.

Pestaña de valores de CLI de DB2/ODBC:
Servicio

Consulte asimismo:
IGNOREWARNLIST, IGNOREWARNINGS

Notas de utilización:
 

Cualquier SQLSTATE que se devuelva como error puede rebajarse al nivel de aviso. Cada uno de ellos debe estar delimitado con comillas simples, estar separado por comas y estar en mayúsculas. La serie completa debe ir asimismo entrecomillada entre dobles comillas. Por ejemplo:

    WARNINGLIST=" '01S02', 'HY090' "

Esta opción puede utilizarse junto con la palabra clave de configuración IGNOREWARNINGS de CLI/ODBC. Si también activa IGNOREWARNINGS, no se comunicará ninguno de los errores que rebaje a avisos.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]