DB2 Cursor with Hold
DB2 Cursor with Hold Example
Input -
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 -
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 -
Table After Update -