Função SQLCODE

SQLCODE é uma função de estado do banco de dados que retorna um tipo de dados INTEGER com um valor padrão de 0 (zero).

SINTAXE

Em um fluxo de mensagens, você pode acessar e atualizar um recurso do banco de dados externo utilizando as funções de banco de dados ESQL disponíveis nos nós Filter, Database e Compute. Ao efetuar chamadas para um banco de dados externo, você poderá obter erros, como uma tabela não existe, um banco de dados não está disponível ou uma inserção de uma chave que já existe.

Quando ocorrerem estes erros, a ação padrão do broker será gerar uma exceção. Esse comportamento é determinado de acordo com a definição da propriedade Emitir Exceção em Caso de Erro do Banco de Dados. Se esta caixa de opções estiver selecionada, o broker irá interromper o processamento do nó, irá propagar a mensagem para o terminal de falhas do nó e irá gravar os detalhes do erro em ExceptionList. Se desejar substituir o comportamento padrão e manipular um erro do banco de dados no ESQL no nó, limpe a caixa de opções Emitir Exceção em Caso de Erro do Banco de Dados. O intermediário não emite uma exceção e será necessário incluir a instrução THROW para emitir uma exceção caso um determinado código de estado SQL não seja esperado. Consulte Instrução THROW para obter uma descrição de THROW.

Se você escolher tratar erros de banco de dados em um nó, poderá utilizar a função de estado de banco de dados SQLCODE para receber informações sobre o status da chamada DBMS feita em ESQL. Você poderá incluí-la em instruções condicionais no ESQL do nó atual para que ele reconheça e lide com possíveis erros.

Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Visão Geral do ESQL
Tarefas relacionadas
Definindo o Conteúdo do Fluxo de Mensagens
Desenvolvendo ESQL
Capturando o Estado do Banco de Dados
Referências relacionadas
Função SQLERRORTEXT
Função SQLNATIVEERROR
Função SQLSTATE
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak17960_