WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Instrução THROW

Utilize a instrução THROW para gerar uma exceção do usuário.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-THROW--+------+--EXCEPTION--+----------------------+--------->
          '-USER-'             '-SEVERITY--expression-'   

>--+-----------------------+--+-------------------------+------->
   '-CATALOG--catalog name-'  '-MESSAGE--message number-'   

>--+------------------------------+----------------------------><
   |            .-,----------.    |   
   |            V            |    |   
   '-VALUES--(----expression-+--)-'   

A palavra-chave USER indica o tipo de exceção que está sendo emitida. No momento, apenas as exceções USER são suportadas e, se você omitir a palavra-chave USER, de qualquer maneira, a exceção assumirá como padrão uma exceção USER. Especifique a palavra-chave USER, apesar de não ter nenhum efeito atualmente, pelas seguintes razões:
  • Se futuros releases do intermediário suportarem outros tipos de exceção e o tipo padrão for alterado, seu código não precisará ser alterado.
  • Isto deixa claro que esta é uma exceção do usuário.

SEVERITY é uma cláusula opcional que determina a gravidade associada à exceção. A cláusula pode conter qualquer expressão que retorna um valor inteiro, não-NULL. Se a cláusula for omitida, será assumido o padrão 1.

No Windows é necessário configurar SEVERITY como 3, para que o log de eventos do Windows relate o erro corretamente.

CATALOG é uma cláusula opcional; se você omiti-la, CATALOG será assumido como padrão para o catálogo da versão atual do WebSphere Message Broker. Para utilizar o catálogo de mensagens da versão atual explicitamente, utilize BIPmsgs em todos os sistemas operacionais.

MESSAGE é uma cláusula opcional; se você omiti-la, ela será padronizada com o primeiro número de mensagem do bloco de mensagens fornecido para utilizar instruções THROW no catálogo padrão (2951). Se você digitar um número de mensagem na instrução THROW, você poderá utilizar os números de mensagem 2951 a 2999 a partir do catálogo padrão. Alternativamente, você pode gerar seu próprio catálogo, seguindo as instruções em Criando Catálogos de Mensagens.

Utilize o campo VALUES opcional para inserir dados em sua mensagem. Você pode inserir qualquer número de partes de informações, mas as mensagens fornecidas (2951 - 2999) suprem apenas oito inserções.

Exemplos

Aqui estão alguns exemplos de como você pode utilizar uma instrução THROW:
  • THROW USER EXCEPTION; 
  • THROW USER EXCEPTION CATALOG 'BIPmsgs' MESSAGE 
    2951 VALUES(1,2,3,4,5,6,7,8) ;
  • THROW USER EXCEPTION CATALOG 'BIPmsgs' MESSAGE 
    2951 VALUES('The SQL State: ', 
        SQLSTATE, 'The SQL Code: ', SQLCODE, 'The SQLNATIVEERROR: ', SQLNATIVEERROR, 
        'The SQL Error Text: ', SQLERRORTEXT ) ;
  • THROW USER EXCEPTION CATALOG 'BIPmsgs' MESSAGE 
    2951 ;
  • THROW USER EXCEPTION CATALOG 'MyCatalog' MESSAGE 
    2951 VALUES('Hello World') ;
  • THROW USER EXCEPTION MESSAGE 
    2951 VALUES('Insert text 1', 'Insert text 2') ;

Para informações adicionais sobre como emitir uma exceção e detalhes de SQLSTATE, SQLCODE, SQLNATIVEERROR e SQLERRORTEXT, consulte Funções de Estado de Banco de Dados ESQL.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:55


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ak05150_