Notas sobre o Release

|42.11 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. |

|