Notas del release

42.7 Opciones adicionales de la sentencia GET DIAGNOSTICS

Sentencia GET DIAGNOSTICS

La sentencia GET DIAGNOSTICS se utiliza para obtener información sobre la sentencia de SQL ejecutada anteriormente. La sintaxis de esta sentencia se ha actualizado de la siguiente manera:

Sintaxis del mandato

>>-GET DIAGNOSTICS---------------------------------------------->
 
>--+-nombre-variable-SQL--=--+-ROW_COUNT-----+-+---------------><
   |                         '-RETURN_STATUS-' |
   '-| información-condición |-----------------'
 
información-condición
 
|--EXCEPTION--1------------------------------------------------->
 
   .-,--------------------------------------------.
   V                                              |
>----nombre-variable-SQL--=--+-MESSAGE_TEXT-----+-+-------------|
                             '-DB2_TOKEN_STRING-'
 
 

Parámetros del mandato

nombre-variable-SQL

Identifica la variable que es el destino de la asignación. Si se especifica ROW_COUNT o RETURN_STATUS, la variable debe ser un entero. De lo contrario, la variable debe ser CHAR o VARCHAR. Pueden definirse variables de SQL en una sentencia compuesta.

ROW_COUNT

Identifica el número de filas asociadas con la sentencia de SQL anterior. Si la sentencia de SQL anterior es DELETE, INSERT o UPDATE, la cláusula ROW_COUNT identifica el número de filas suprimidas, insertadas o actualizadas por esa sentencia, de las cuales excluye las filas afectadas por desencadenantes o restricciones de integridad de referencia. Si la sentencia anterior es PREPARE, la cláusula ROW_COUNT identifica el número estimado de filas de resultados en la sentencia preparada.

RETURN_STATUS

Identifica el valor de estado devuelto por el procedimiento almacenado que está asociado con la sentencia de SQL ejecutada anteriormente, siempre y cuando la sentencia fuera una sentencia CALL invocando un procedimiento que devuelve un estado. Si la sentencia anterior no es de este tipo, el valor devuelto no tiene significado y puede ser cualquier entero.

información-condición

Especifica que debe devolverse la información de error o de aviso sobre la sentencia de SQL ejecutada anteriormente. Si es necesaria información relativa a un error, la sentencia GET DIAGNOSTICS debe ser la primera sentencia especificada en el manejador que se encargará del error. Si es necesaria información relativa a un aviso y si el manejador va a obtener el control de la condición de aviso, la sentencia GET DIAGNOSTICS debe ser la primera sentencia especificada en ese manejador. Si el manejador no va a obtener el control de la condición de aviso, la sentencia GET DIAGNOSTICS debe ser la siguiente sentencia ejecutada.

MESSAGE_TEXT

Identifica cualquier texto de mensaje de error o aviso devuelto por la sentencia de SQL que se ha ejecutado anteriormente. El texto de mensaje se devuelve en el idioma del servidor de bases de datos donde se ha procesado la sentencia. Si la sentencia se completa con un SQLCODE de cero, se devuelven una serie vacía o espacios en blanco.

DB2_TOKEN_STRING

Identifica cualquier símbolo de mensaje de error o aviso devuelto por la sentencia de SQL que se ha ejecutado anteriormente. Si la sentencia se completa con un SQLCODE de cero, o si el SQLCODE no tiene símbolos, se devuelven una serie vacía o espacios en blanco.