SAP NetWeaver AS ABAP Release 751, ©Copyright 2017 SAP AG. All rights reserved.  

ABAP - Keyword Documentation →  ABAP - Reference →  Processing External Data →  Data Consistency →  SAP LUW → 

ROLLBACK WORK

Quick Reference

Syntax

ROLLBACK WORK.

Effect

The statement ROLLBACK WORK closes the current SAP LUW and opens a new one. This cancels all change requests made by the current SAP LUW. To do this, ROLLBACK WORK carries out the following actions:

1. Executes all subroutines registered using PERFORM ON ROLLBACK.
   
   
2. Deletes the registrations of all subroutines registered using PERFORM ON COMMIT.
   
   
3. Triggers an internal event in the Object Services that makes sure that the attributes of persistent objects are initialized.
   
   
4. Deletes all update function modules registered using CALL FUNCTION ... IN UPDATE TASK from the VB... database tables and deletes all remote function calls registered using CALL FUNCTION ... IN BACKGROUND UNIT or CALL FUNCTION ... IN BACKGROUND TASK (obsolete) from the database tables ARFCSSTATE and ARFCSDATA.
   
   
5. Removes all SAP locks set in the current program for which the formal parameter _SCOPE of the lock function module was set to the value 2.
   
   
6. Triggers a database rollback on all currently open database connections, which also ends the current database LUW.
   
   

After the statement ROLLBACK WORK is completed, the event TRANSACTION_FINISHED from the system class CL_SYSTEM_TRANSACTION_STATE is triggered. Here, the parameter KIND has the value of the constant CL_SYSTEM_TRANSACTION_STATE=>ROLLBACK_WORK.

Notes

• All open database cursors in the database connections concerned are closed during ROLLBACKs, which means that a runtime error occurs when the system attempts to continue a SELECT loop after a ROLLBACK. For the same reason, a FETCH after a ROLLBACK on the cursor that is now closed also causes a runtime error. Make sure that cursors that are still open are no longer used after the ROLLBACK.
  
  
• After a ROLLBACK statement, sy-subrc is always zero. It is not necessary to query whether sy-subrc is not equal to zero after ROLLBACK.
  
  
• ROLLBACK must not be used during updates (CALL FUNCTION ... IN UPDATE TASK) or during the execution of subroutines that were registered with PERFORM ... ON COMMIT or PERFORM ... ON ROLLBACK are running.
  
  
• The statement ROLLBACK WORK must not be executed in units or LUWs that are managed by background RFC calls (bgRFC and the (obsolete) tRFC or qRFC).
  
  
• The ROLLBACK WORK statement is executed implicitly if a message of type A is handled by the addition error_message when calling a function module with CALL FUNCTION.
  
  
• ROLLBACK WORK empties global temporary tables of all currently open database connections and prevents the runtime error COMMIT_GTT_ERROR in the case of implicit database commits.
  
  
  

Exceptions

Non-Handleable Exceptions

• Cause: ROLLBACK WORK is not permitted within a FORM that is called with PERFORM ... ON COMMIT or PERFORM ... ON ROLLBACK.
  Runtime error: ROLLBACK_IN_PERFORM_ON_COMMIT
  
  
• Cause: ROLLBACK WORK is not permitted within updates.
  Runtime error: ROLLBACK_IN_POSTING