Notas sobre o Release

43.12 Opções Adicionais na Instrução GET DIAGNOSTICS

Instrução GET DIAGNOSTICS

A instrução GET DIAGNOSTICS é utilizada para obter informações sobre a instrução SQL executada previamente. A sintaxe dessa instrução foi atualizada como segue.

Sintaxe do Comando

>>-GET DIAGNOSTICS---------------------------------------------->
 
>--+-SQL-variable-name--=--+-ROW_COUNT-----+-+-----------------><
   |                       '-RETURN_STATUS-' |
   '-| condition-information |---------------'
 
condition-information
 
|--EXCEPTION--1------------------------------------------------->
 
   .-,------------------------------------------.
   V                                            |
>----SQL-variable-name--=--+-MESSAGE_TEXT-----+-+---------------|
                           '-DB2_TOKEN_STRING-'
 
 

Parâmetros do Comando

SQL-variable-name

Identifica a variável que é o alvo da atribuição. Se ROW_COUNT ou RETURN_STATUS forem especificadas, a variável deve ser uma variável com um número inteiro. Caso contrário, a variável deve ser CHAR ou VARCHAR. Variáveis SQL podem ser definidas em uma instrução composta.

ROW_COUNT

Identifica o número de filas associadas à instrução SQL anterior. Se a instrução SQL anterior é uma instrução DELETE, INSERT ou UPDATE, ROW_COUNT identifica o número de filas excluídas, inseridas ou atualizadas pela instrução, exceto filas afetadas por disparos ou limitações de integridade referencial. Se a instrução anterior é uma instrução PREPARE, ROW_COUNT identifica o número estimado de filas resultantes na instrução preparada.

RETURN_STATUS

Identifica o valor de status retornado do procedimento armazenado associado à instrução SQL anteriormente executada, desde que a instrução tenha sido uma instrução CALL chamando um procedimento que retorna um status. Se a instrução anterior não era desse tipo, o valor retornado não tem significado e pode ser qualquer número inteiro.

condition-information

Especifica que as informações de erro ou de aviso da instrução SQL anteriormente executada devem ser retornadas. Se as informações sobre um erro forem necessárias, a instrução GET DIAGNOSTICS deve ser a primeira instrução especificada na rotina de tratamento que trata o erro. Se as informações sobre um aviso forem necessárias e se a rotina de tratamento assumir o controle da condição de aviso, a instrução GET DIAGNOSTICS deverá ser a primeira instrução especificada nessa rotina de tratamento. Se a rotina de tratamento não assumir controle da condição de aviso, a instrução GET DIAGNOSTICS deverá ser a próxima instrução executada.

MESSAGE_TEXT

Identifica qualquer texto de mensagem de erro ou de aviso retornado de uma instrução SQL anteriormente executada. O texto da mensagem é retornado na linguagem do servidor de banco de dados onde a instrução é processada. Se a instrução concluir com um SQLCODE igual a zero, uma cadeia vazia ou espaços em branco são retornados.

DB2_TOKEN_STRING

Identifica quaisquer tokens de mensagem de erro e de aviso retornados da instrução SQL anteriormente executada. Se a instrução concluir com um SQLCODE igual a zero ou se o SQLCODE não tiver tokens, uma cadeia vazia ou espaços em branco são retornados.