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.
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.
El conjunto de opciones de Tipo de datos se utiliza para definir el modo en que DB2 comunica y maneja diversos tipos de datos.
El conjunto de opciones de Enterprise se utiliza para maximizar la eficacia de las conexiones con bases de datos grandes.
El conjunto de opciones de Entorno se utiliza para definir la ubicación de diversos archivos en las máquinas cliente y servidor.
El conjunto de opciones DSN de archivos se utiliza para definir los valores de TCP/IP para una conexión de DSN de archivos.
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.
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.
El conjunto de opciones de SQL estática se utilizan al ejecutar sentencias de SQL estáticas en aplicaciones CLI/ODBC.
El conjunto de opciones Transacción se utiliza para controlar y acelerar las sentencias de SQL utilizadas en la aplicació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}"
Esta palabra clave sólo se utiliza para la depuració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.
Nota: | El controlador CLI/ODBC actuará como en las versiones anteriores de DB2 que no daban soporte al ODBC asíncrono. |
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.
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.
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.
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.
Esta opción le permite especificar el tipo de conexión por omisió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.
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.
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:
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.
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.
Esta opción controla el efecto de una finalización de transacción en cursores abiertos.
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:
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.
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.
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.
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.
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.
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.
Esta palabra clave determina si el servidor generará Explicar instantánea y/o Explicar información de tabla.
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.
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.
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.
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.
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.
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
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.
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
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.
Si la base de datos de DB2 Common Server destino o la pasarela de DDCS no dan soporte a la preparación diferida, el cliente inhabilita la preparación diferida para dicha conexión.
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.
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.
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.)
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.
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). |
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.
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.
Esta opción controla el modo en que la aplicación devuelve dos informaciones relacionadas:
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.
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.
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.
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.
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'"
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.
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.
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.
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.
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).
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. |
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.
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.)
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.
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.
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.
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).
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).
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).
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.
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:
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.
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 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.
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.
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' "
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.
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.
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
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.
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).
No se utiliza un Gestor de transacciones para efectuar una confirmación en dos fases pero se utiliza una confirmación en una fase para confirmar el trabajo efectuado por cada base de datos en una transacción de varias bases de datos.
Se necesita un Gestor de transacciones para coordinar confirmaciones en dos fases entre las bases de datos que dan soporte a esta opció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 |
|
|
|
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.
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.
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.
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.)
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.)
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.)
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.)
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.)
Establece el nivel de aislamiento en:
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.
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.
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.
El carácter de subrayado se trata como un comodín que se corresponde con cualquier carácter o con la ausencia de carácter. Por ejemplo, si se definen dos tablas del modo siguiente:
CREATE TABLE "OWNER"."KEY_WORDS" (COL1 INT) CREATE TABLE "OWNER"."KEYWORDS" (COL1 INT)
La llamada de función de catálogo de CLI de DB2 que devuelve información de tablas (SQLTables()) devolverá ambas entradas si se especifica "KEY_WORDS" en el argumento del patrón de búsqueda de nombres de tabla.
El carácter de subrayado se trata como carácter de subrayado. Si se definen dos tablas como en el ejemplo anterior, SQLTables() sólo devolverá la entrada "KEY_WORDS" si se especifica "KEY_WORDS" en el argumento del patrón de búsqueda del nombre de tablas.
Establecer en 0 esta palabra clave puede dar como resultado una mejora en el rendimiento en los casos en los que los nombres de objeto (propietario, tabla, columna) en la base de datos que contiene caracteres de subrayado.
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. |
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.