get diagnostics

Description

Retrieves error, warning, and informational messages from Client-Library.

Syntax

get diagnostics 
 {:hv = statement_info [, :hv = statement_info]...| 
 exception :condition_number 
 :hv = condition_info [, :hv = condition_info]...}
 end-exec

Parameters

statement_info

The keyword number is currently the only supported statement_info type. It returns the total number of exceptions in the diagnostics queue.

condition_info

Any one of the keywords sqlca_info, sqlcode_number, and returned_sqlstate.

Examples

Example 1

 EXEC SQL BEGIN DECLARE SECTION END-EXEC.
           01     NUM-MSGS      PIC S9(9) COMP.
           01     CONDCNT       PIC S9(9) COMP.
      EXEC SQL END DECLARE SECTION END-EXEC.
 
           ...
      EXEC SQL GET DIAGNOSTICS :NUM-MSGS = NUMBER   END-EXEC.
      MOVE 1 TO CONDCNT.
      PERFORM GET-DIAG-PARA UNTIL CONDCNT > NUM-MSGS.
           ...
 
      GET-DIAG-PARA.
           EXEC SQL GET DIAGNOSTICS EXCEPTION
                 :CONDCNT :SQLCA = SQLCA_INFO END-EXEC
           DISPLAY "DIAG. SQLCODE     = ",SQLCODE
           DISPLAY "DIAG. MESSAGE     = ",SQLERRMC
 
           ADD 1 TO CONDCNT.
      END-GET-DIAG-PARA.

Usage

See also

whenever