Assembler,
COBOL
ou PL/I |
C |
Fortran |
Tipo de dado |
Propósito |
| SQLCAID |
sqlcaid |
Not used. |
CHAR(8) |
Um atrativo para despejos de armazenamento, contendo o texto 'SQLCA'.
O sexto byte é 'L' se as informações do número da linha forem retornadas da análise de uma instrução dinâmica ou de um procedimento SQL nativo.
O sexto byte não é definido ao processar um procedimento SQL externo. |
| SQLCABC |
sqlcabc |
Not used. |
INTEGER |
Contém o tamanho do SQLCA: 136. |
SQLCODE
(nota 1) |
SQLCODE |
SQLCOD |
INTEGER |
Contém o código de retorno do SQL. (nota 2)
Código Mensagem
0
Execução OK (embora pudesse ter mensagens de advertencias).
positivo
Execução OK, mas com uma condição de advertência ou outra informação.
negativo
Condição de erro.
|
SQLERRML
(nota 3) |
sqlerrml
(nota 3) |
SQLTXL |
SMALLINT |
Indicador de comprimento para SQLERRMC, no intervalo de 0 a 70.
0 (zero) significa que o valor de SQLERRMC não é pertinente. |
SQLERRMC
(nota 3) |
sqlerrmc
(nota 3) |
SQLTXT |
VARCHAR(70) |
Contém um ou mais tokens, separados por X'FF ', que são substituídos por variáveis nas descrições das condições de erro.
Ele pode conter tokens truncados. Um comprimento de mensagem de 70 bytes indica um possível truncamento.
|
| SQLERRP |
sqlerrp |
SQLERP |
CHAR(8) |
Provê uma assinatura de produto e, no caso de um erro, gera um diagnóstico
com informações, como o nome do módulo que detectou o erro.
Em todos os casos, os primeiros três caráter são 'DSN ' para DB2, OS/390 e z/OS
|
| SQLERRD(1) |
sqlerrd[0] |
SQLERR(1) |
INTEGER |
Contém o número de linhas da pesquisa em uma tabela quando a posição do
cursor for depois da última linha (quer dizer, quando SQLCODE é igual a +100).
SQLERRD(1) também pode conter um código de erro interno.
|
| SQLERRD(2) |
sqlerrd[1] |
SQLERR(2) |
INTEGER |
Contém o número de linhas da pesquisa em uma tabela quando a posição do
cursor for depois da última linha (quer dizer, quando SQLCODE é igual a +100).
SQLERRD(2) também pode conter um código de erro interno.
|
| SQLERRD(3) |
sqlerrd[2] |
SQLERR(3) |
INTEGER |
Contém o número de linhas qualificadas para serem excluídas, inseridas ou atualizadas após uma instrução DELETE, INSERT, UPDATE ou
MERGE.
O número exclui linhas afetadas por gatilhos, restrições de integridade referencial ou linhas inseridas que são o resultado do processamento de uma cláusula
FOR PORTION OF para um período BUSINESS_TIME.
Para o OPEN de um cursor para um SELECT com uma instrução de mudança de dados ou para um SELECT INTO, SQLERRD (3) contém o número de linhas afetadas pela
instrução de mudança de dados embutida.
O valor é 0 se a instrução SQL falhar, indicando que todas as alterações feitas na execução da instrução foram canceladas.
Para uma instrução DELETE, o valor será -1 se a operação for uma exclusão em massa de uma tabela em um espaço de tabela segmentado e a instrução DELETE não
incluir critérios de seleção.
Se a exclusão foi feita em uma visão, nem a instrução DELETE nem a definição da visão incluíram os critérios de seleção.
Para uma instrução TRUNCATE, o valor será -1.
Para uma instrução PREPARE, contém o número estimado de linhas selecionadas.
Se o número de linhas for maior que 2.147.483.647, um valor de 2.147.483.647 é retornado.
Para uma instrução REFRESH TABLE, SQLERRD (3) contém o número de linhas inseridas na tabela de consulta materializada.
Para um FETCH orientado a conjunto de linhas, contém o número de linhas buscadas.
Para SQLCODES -911 e -913 , SQLERRD (3) contém o código de razão para o tempo limite ou conflito.
Quando um erro é encontrado na análise de uma instrução dinâmica, ou ao analisar, vincular ou executar um procedimento SQL nativo, SQLERRD (3) conterá o
número da linha onde o erro foi encontrado.
O sexto byte de SQLCAID deve ser 'L' para que seja um número de linha válido.
Este valor será significativo apenas se a origem da instrução contiver novos caracteres de controle de linha.
Essas informações não são retornadas para um procedimento SQL externo.
|
| SQLERRD(4) |
sqlerrd[3] |
SQLERR(4) |
INTEGER |
Geralmente, contém timerons, um pequeno valor de ponto flutuante
que indica uma estimativa relativa áspera de recursos requeridos (Veja nota 4).
Não reflete uma estimativa do tempo requerida.
Quando estiver preparando a definição de uma declaração de SQL dinamicamente, você pode usar este campo como um indicador do custo relativo da declaração
de SQL preparada.
Para uma declaração particular, este número pode variar com mudanças às estatísticas no catálogo.
Também está sujeito a mudança entre liberações de DB2 para OS/390 e z/OS
|
| SQLERRD(5) |
sqlerrd[4] |
SQLERR(5) |
INTEGER |
Contém a posição ou coluna da sintaxe de erro para uma declaração
PREPARE ou EXECUTE IMMEDIATE
|
| SQLERRD(6) |
sqlerrd[5] |
SQLERR(6) |
INTEGER |
Contém um código de erro interno. |
| SQLWARN0 |
SQLWARN0 |
SQLWRN(0) |
CHAR(1) |
Contém um espaço em branco se nenhum outro indicador é fixado a uma condição de
advertência (quer dizer, nenhum outro indicador contém um W ou Z).
Contém um W se pelo menos um outro indicador contiver um W ou Z.
|
| SQLWARN1 |
SQLWARN1 |
SQLWRN(1) |
CHAR(1) |
Contém a W se o valor da coluna foi truncado quando assinado para uma variável host.
Contém um N para um CURSOR non-scrollable e um S para um CURSOR scrollable depois da declaração OPEN CURSOR ou ALLOCATE CURSOR.
|
| SQLWARN2 |
SQLWARN2 |
SQLWRN(2) |
CHAR(1) |
Contém um W se foram eliminados valores nulos do argumento de uma função de coluna;
não necessariamente fixa para W a função MIN porque seus resultados não são dependentes na eliminação de valores nulos.
|
| SQLWARN3 |
SQLWARN3 |
SQLWRN(3) |
CHAR(1) |
Contém um W se o número de colunas do resultado for maior que o número de variáveis host.
Contém um Z se menos locators foram providenciados dentro a declaração de ASSOCIATE LOCATORS que o procedimento armazenado retornou.
|
| SQLWARN4 |
SQLWARN4 |
SQLWRN(4) |
CHAR(1) |
Contém um W se uma delcaração UPDATE ou DELETE preparada não inclui uma cláusula WHERE.
Para um CURSOR scrollable, contém um I para um CURSOR insensitivo e S para CURSOR estático sensitivo depois de uma declaração OPEN CURSOR ou
ALLOCATE CURSOR; contém um branco se o CURSOR não é scrollable.
|
| SQLWARN5 |
SQLWARN5 |
SQLWRN(5) |
CHAR(1) |
Contém um W se a declaração de SQL não foi executada porque não é uma declaração de
SQL válida em DB2 para OS/390 e z/OS.
Contém um valor de caráter de 1 (sómente leitura), 2 (leitura e deletar), ou 4 (leitura, deletar e atualizar) para refletir a capacidade do cursor depois da
declaração OPEN CURSOR ou ALLOCATE CURSOR.
|
| SQLWARN6 |
SQLWARN6 |
SQLWRN(6) |
CHAR(1) |
Contém um W se a adição de um mês ou duração de ano para um DATE ou TIMESTAMP resultam
em um dia inválido (por exemplo, 31 de junho).
Indica que o valor do dia foi mudado para o último dia do mês para fazer o resultado válido.
|
| SQLWARN7 |
SQLWARN7 |
SQLWRN(7) |
CHAR(1) |
Contém um W se um ou mais digito diferente de zeros foram eliminados da parte fracional
do número usado como o operando de um operação de multiplicação ou divisão.
|
| SQLWARN8 |
SQLWARN8 |
SQLWRX(1) |
CHAR(1) |
Contém um W se um caráter que não pôde ser convertido foi trocado com um caráter substituto.
|
| SQLWARN9 |
SQLWARN9 |
SQLWRX(2) |
CHAR(1) |
Contém um W se foram ignoradas exceções de aritmética durante um COUNT ou COUNT_BIG.
Contém um Z se o procedimento armazenado retornou múltiplos resultados setados.
|
| SQLWARNA |
SQLWARNA |
SQLWRX(3) |
CHAR(1) |
Contém um W se pelo menos um campo de caráter do SQLCA ou o SQLDA, nomes ou rótulos
são inválidos devido a um erro de conversão de caráter.
|
| SQLSTATE |
sqlstate |
SQLSTT |
CHAR(5) |
Contém um código de retorno para o resultado da mais recente execução de
uma declaração de SQL (Veja nota 5).
|
