DB2 Cursor with Hold Example


Input -

employee_details table

Scenario1 - Declare the WITH HOLD CURSOR for updating column manager_id of employee_details table.

  EXEC SQL 
	DECLARE E1 CURSOR WITH HOLD FOR
     	SELECT EMP_NAME,
               MANAGER_ID
     	FROM   EMPLOYEE_DETAILS
        FOR    UPDATE OF MANAGER_ID
   END-EXEC.

Scenario2 - Declare the WITH HOLD CURSOR for updating all columns of the employee_details table.

   EXEC SQL 
	DECLARE E2 CURSOR WITH HOLD FOR
     	SELECT EMP_ID,
               EMP_NAME,
               DESIGNATION,
               MANAGER_ID,
               DATE_OF_HIRE,
               SALARY,
               DEPT_ID
     	FROM   EMPLOYEE_DETAILS 
     	FOR UPDATE 
   END-EXEC.

Scenario3 - Declare the with hold cursor for designation "FRESHER" in department 1000 of employee_details table.

   EXEC SQL 
	DECLARE E3 CURSOR WITH HOLD FOR
     	SELECT EMP_ID,
               EMP_NAME,
               DESIGNATION
     	FROM   EMPLOYEE_DETAILS 
     	WHERE  DESIGNATION = "FRESHER"
		AND    DEPT_ID = 1000
     	FOR    READ ONLY 
   END-EXEC.

Practical Example -


Scenario - The below example describes how the WITH HOLD CURSOR is coded in the COBOL + DB2 program.

Requirement - Increasing the salary of every TESTER by 2000 and save the changes after the second row got updated without closing the cursor.

Table Before Update -

Table Before Update

Code -

----+----1----+----2----+----3----+----4----+----5----+
       IDENTIFICATION DIVISION.
       PROGRAM-ID. CWHOLD.
       AUTHOR. MTH.

       ENVIRONMENT DIVISION.
       DATA DIVISION.
       WORKING-STORAGE SECTION.
 
           EXEC SQL
             INCLUDE SQLCA
           END-EXEC.

           EXEC SQL
             INCLUDE EMPLDET
           END-EXEC.
 
      * DECLARING UPDATE   CURSOR
           EXEC SQL
                DECLARE CSR1  CURSOR WITH HOLD FOR
                SELECT EMP_ID,
                       EMP_NAME, 
                       DESIGNATION,
                       MANAGER_ID,
                       SALARY
                FROM   EMPLOYEE_DETAILS
                WHERE  DESIGNATION = 'TESTER'
                  AND  DEPT_ID = 2000 
                FOR    UPDATE OF SALARY
           END-EXEC.

        01 WS-VAR.
           05 WS-UCNT         PIC 9(02) VALUE ZEROES.
           05 WS-UPDATED-SAL  PIC S9(5)V9(2) USAGE COMP-3.

       PROCEDURE DIVISION.
  
      * OPENING CURSOR 
           EXEC SQL
                OPEN CSR1
           END-EXEC.
  
      * FETCHING CURSOR LOOP UNTIL END OF RESULT TABLE
           IF SQLCODE EQUAL ZERO
              PERFORM FETCH-EMP-DETAILS 
                 THRU FETCH-EMP-DETAILS-EXIT
                UNTIL SQLCODE NOT EQUAL 0
           END-IF.
 
      * CLOSING CURSOR
           EXEC SQL
                CLOSE CSR1
           END-EXEC.
 
           DISPLAY "NO OF ROWS UPDATED:  ", WS-UCNT.
           STOP RUN.

       FETCH-EMP-DETAILS.
   
      * FETCH CURSOR
           EXEC SQL
                FETCH CSR1
                INTO   :EMP-ID,
                       :EMP-NAME,
                       :DESIGNATION,
                       :MANAGER-ID
                       :MANAGER-ID-NI,
                       :SALARY
           END-EXEC.

           EVALUATE SQLCODE
               WHEN ZERO
                    DISPLAY EMP-ID " : " EMP-NAME " : " DESIGNATION
      -             " : " MANAGER-ID " : " SALARY
                       PERFORM UPDATE-EMP-DETAILS
                          THRU UPDATE-EMP-DETAILS-EXIT
               WHEN 100
                    CONTINUE
               WHEN OTHER
                    DISPLAY "DB2 FETCH ERROR:  ", SQLCODE
           END-EVALUATE.

       FETCH-EMP-DETAILS-EXIT.
           EXIT.
   
       UPDATE-EMP-DETAILS.

           COMPUTE WS-UPDATED-SAL = SALARY + 2000.

           EXEC SQL
                UPDATE EMPLOYEE_DETAILS
                   SET SALARY = :WS-UPDATED-SAL
                 WHERE CURRENT OF CSR1
           END-EXEC.
   
           EVALUATE SQLCODE
               WHEN ZERO
                    COMPUTE WS-UCNT = WS-UCNT + 1
               WHEN 100
                    DISPLAY "UPDATING ROW NOT FOUND"
               WHEN OTHER
                    DISPLAY "DB2 ERROR: ", SQLCODE 
           END-EVALUATE.

           IF WS-UCNT = 2
              PERFORM COMMIT-EMP-DETAILS
                 THRU COMMIT-EMP-DETAILS-EXIT
           END-IF.

       UPDATE-EMP-DETAILS-EXIT.
           EXIT.

       COMMIT-EMP-DETAILS.

           EXEC SQL
                COMMIT
           END-EXEC.

           EVALUATE SQLCODE
               WHEN ZERO 
                    DISPLAY "COMMIT PERFORMED SUCCESSFULLY"
               WHEN OTHER
                    DISPLAY "DB2 COMMIT ERROR: ", SQLCODE
           END-EVALUATE.

       COMMIT-EMP-DETAILS-EXIT.
           EXIT.

Output -

WITH HOLD CURSOR Program Output

Table After Update -

Table After Update Output