Desenvolvimento de Aplicativos: CLI (Call Level Interface)

Palavra-chave de Configuração MapBigintCDefault de CLI/ODBC

Descrição da Palavra-chave: Especifique o tipo C padrão de colunas e marcadores de parâmetro BIGINT.
Sintaxe da Palavra-chave db2cli.ini:: MapBigintCDefault = 0 | 1 | 2
Definição Padrão:: A representação do tipo C padrão para dados BIGINT é SQL_C_BIGINT.
Notas de Uso:

MapBigintCDefault controla o tipo C utilizado quando SQL_C_DEFAULT é especificado para colunas e marcadores de parâmetros BIGINT. Esta palavra-chave deve ser utilizada principalmente com aplicativos da Microsoft, como o Microsoft Access, que não podem manipular inteiros de 8 bytes. Defina MapBigintCDefault da seguinte forma:

0 - para a representação do tipo C SQL_C_BIGINT padrão
1 - para uma representação de tipo C SQL_C_CHAR
2 - para uma representação de tipo C SQL_C_WCHAR

Esta palavra-chave afeta o comportamento de funções CLI nas quais SQL_C_DEFAULT pode ser especificado como um tipo C, por exemplo, SQLBindParameter(), SQLBindCol() e SQLGetData().

Palavra-chave de Configuração DescribeOutputLevel de CLI/ODBC

Descrição da Palavra-chave: Defina o nível de informações de descrição de colunas de saída que são solicitadas pelo driver CLI durante pedidos de preparação ou de descrição.
Sintaxe da Palavra-chave db2cli.ini:: DescribeOutputLevel = 0 | 1 | 2 | 3
Definição Padrão:: Solicite as informações de descrição listadas no nível 2 da Tabela 16.
Notas de Uso:

Esta palavra-chave controla a quantidade de informações solicitadas pelo driver CLI em um pedido de preparação ou de descrição. Por padrão, quando o servidor recebe um pedido de descrição, ele retorna as informações contidas no nível 2 da Tabela 16 para as colunas do conjunto de resultados. No entanto, um aplicativo talvez não precise destas informações ou precise de informações adicionais.

A definição da palavra-chave DescribeOutputLevel para um nível que atende as necessidades do aplicativo cliente pode aprimorar o desempenho, porque os dados de descrição transferidos entre o cliente e o servidor estão limitados à quantidade mínima requerida pelo aplicativo. Se a definição de DescribeOutputLevel for muito baixa, poderá impactar a funcionalidade do aplicativo (dependendo dos requisitos do aplicativo). As funções CLI para recuperar as informações de descrição podem não falhar neste caso, mas as informações retornadas podem estar incompletas.

As definições suportadas para DescribeOutputLevel são:

0 - nenhuma informação de descrição é retornada ao aplicativo cliente
1 - as informações de descrição categorizadas no nível 1 (consulte a Tabela 16) são retornadas ao aplicativo cliente
2 - (padrão) as informações de descrição categorizadas no nível 2 (consulte a Tabela 16) são retornadas ao aplicativo cliente
3 - as informações de descrição categorizadas no nível 3 (consulte a Tabela 16) são retornadas ao aplicativo cliente

A tabela a seguir lista os campos que formam as informações de descrição retornadas pelo servidor quando ele recebe um pedido de preparação ou descrição. Estes campos são agrupados em níveis e a palavra-chave de configuração DescribeOutputLevel de CLI/ODBC controla quais níveis de informações de descrição são solicitados pelo driver CLI.

Nota:

Nem todos os níveis de informações de descrição são suportados por todos os servidores DB2. Todos os níveis de informações de descrição são suportados nos servidores DB2 a seguir: DB2 UDB (Universal Database) para Linux , UNIX e Windows Versão 8 e posterior, DB2 UDB para z/OS Versão 8 e posterior e DB2 UDB para iSeries Versão 5 Release 3 e posterior. Todos os outros servidores DB2 suportam apenas a definição 2 ou 0 para DescribeOutputLevel.

Tabela 16. Níveis de Informações de Descrição
Nível 1	Nível 2	Nível 3
SQL_DESC_COUNT SQL_COLUMN_COUNT SQL_DESC_TYPE SQL_DESC_CONCISE_TYPE SQL_COLUMN_LENGTH SQL_DESC_OCTET_LENGTH SQL_DESC_LENGTH SQL_DESC_PRECISION SQL_COLUMN_PRECISION SQL_DESC_SCALE SQL_COLUMN_SCALE SQL_DESC_DISPLAY_SIZE SQL_DESC_NULLABLE SQL_COLUMN_NULLABLE SQL_DESC_UNSIGNED SQL_DESC_SEARCHABLE SQL_DESC_LITERAL_SUFFIX SQL_DESC_LITERAL_PREFIX SQL_DESC_CASE_SENSITIVE SQL_DESC_FIXED_PREC_SCALE	todos os campos de nível 1 e: SQL_DESC_NAME SQL_DESC_LABEL SQL_COLUMN_NAME SQL_DESC_UNNAMED SQL_DESC_TYPE_NAME SQL_DESC_DISTINCT_TYPE SQL_DESC_REFERENCE_TYPE SQL_DESC_STRUCTURED_TYPE SQL_DESC_USER_TYPE SQL_DESC_LOCAL_TYPE_NAME SQL_DESC_USER_DEFINED_ TYPE_CODE	todos os campos de níveis 1 e 2 e: SQL_DESC_BASE_COLUMN_NAME SQL_DESC_UPDATABLE SQL_DESC_AUTO_UNIQUE_VALUE SQL_DESC_SCHEMA_NAME SQL_DESC_CATALOG_NAME SQL_DESC_TABLE_NAME SQL_DESC_BASE_TABLE_NAME

Tabela 16. Níveis de Informações de Descrição

Nível 1

Nível 2

Nível 3

SQL_DESC_COUNT
SQL_COLUMN_COUNT
SQL_DESC_TYPE
SQL_DESC_CONCISE_TYPE
SQL_COLUMN_LENGTH
SQL_DESC_OCTET_LENGTH
SQL_DESC_LENGTH
SQL_DESC_PRECISION
SQL_COLUMN_PRECISION
SQL_DESC_SCALE
SQL_COLUMN_SCALE
SQL_DESC_DISPLAY_SIZE
SQL_DESC_NULLABLE
SQL_COLUMN_NULLABLE
SQL_DESC_UNSIGNED
SQL_DESC_SEARCHABLE
SQL_DESC_LITERAL_SUFFIX
SQL_DESC_LITERAL_PREFIX
SQL_DESC_CASE_SENSITIVE
SQL_DESC_FIXED_PREC_SCALE

todos os campos de nível
1 e:
SQL_DESC_NAME
SQL_DESC_LABEL
SQL_COLUMN_NAME
SQL_DESC_UNNAMED
SQL_DESC_TYPE_NAME
SQL_DESC_DISTINCT_TYPE
SQL_DESC_REFERENCE_TYPE
SQL_DESC_STRUCTURED_TYPE
SQL_DESC_USER_TYPE
SQL_DESC_LOCAL_TYPE_NAME
SQL_DESC_USER_DEFINED_
         TYPE_CODE

todos os campos de níveis
1 e 2 e:
SQL_DESC_BASE_COLUMN_NAME
SQL_DESC_UPDATABLE
SQL_DESC_AUTO_UNIQUE_VALUE
SQL_DESC_SCHEMA_NAME
SQL_DESC_CATALOG_NAME
SQL_DESC_TABLE_NAME
SQL_DESC_BASE_TABLE_NAME

[ Início da Página |Página Anterior | Próxima Página | Índice ]