Using SQL interruption

Interrupt long running SQL queries, or interrupt queries waiting for locked data.

If the database server supports SQL interruption, a program can interrupt a long running SQL statement.

SQL interruption is not enabled by default. Use the OPTIONS SQL INTERRUPT ON instruction to enable SQL interruption.

The OPTIONS SQL INTERRUPT ON instruction must be used together with signal handling instructions DEFER INTERRUPT and DEFER QUIT, otherwise the program will stop immediately in case of an interruption event.

Depending on the type of database server and client, SQL interruption handling may require additional overhead. Consider enabling SQL interruption only for SQL queries that can take a while to execute or can be blocked for a long time because of concurrent access (locks).

SQL interruption results in abnormal SQL statement execution and raises a runtime error. Therefore, the SQL statement that can be interrupted must be protected by a WHENEVER ERROR exception handler or TRY/CATCH block.

MAIN
  DEFINE cnt INTEGER
  DEFER INTERRUPT
  DATABASE test1
  WHENEVER ERROR CONTINUE
  OPTIONS SQL INTERRUPT ON
  -- Start long query (self join takes time)
  -- From now on, user can hit CTRL-C in TUI mode to stop the query,
  -- or use the special "interrupt" action (button) in GUI mode. 
  SELECT COUNT(*) INTO cnt FROM customers a, customers b 
       WHERE a.cust_id <> b.cust_id 
  OPTIONS SQL INTERRUPT OFF
  IF sqlca.sqlcode == -213 THEN
     DISPLAY "Statement was interrupted by user..."
     EXIT PROGRAM 1
  END IF
  WHENEVER ERROR STOP
END MAIN

When SQL interruption is supported by a database server type other than IBM® Informix®, the database drivers will return error -213 in case of interruption, to behave as in IBM Informix.

When FGLSQLDEBUG is set, OPTIONS SQL INTERRUPT ON/OFF instructions are traced.