ABAPCALL_FUNCTION_BACKGROUND_UNIT - CALL FUNCTION BACKGROUND UNIT

Addresses (Business Address Services)   ABAP Short Reference  
This documentation is copyright by SAP AG.

CALL FUNCTION - IN BACKGROUND UNIT

Short Reference

Syntax

CALL FUNCTION func IN BACKGROUND UNIT oref
                  parameter_list.

Effect

Background Remote Function Call (bgRFC) of a remote-enabled function module specified in func using theRFC interface. oref is anobject reference variable that must point to an object of a class that is implemented by the interfaceIF_BGRFC_UNIT.

The object contains all the information required for the Remote Function Call: The destination, whetherto execute a transactional or queued call and, if required, the quantity of queues. If the same objectis used for several calls, all called function modules are executed in one unit. Conversely, multiple objects of this type can be used in parallel in one internal session, which enables parallel processing.

Parallel processing is executed if queues or destinations in the used objects have different names.If, in successive calls, different objects are used for which the same queues and destinations are specified, they are processed in the same queue one after the other.

More information

For detailed information on bgRFC, refer to bgRFC (Background Remote Function Call) in the SAP Library.

Notes

• Before Release 7.0, SP14, the parallel processing of multiple function modules was only possible usingthe AS SEPARATE UNIT addition to the statement CALL FUNCTION IN BACKGROUND TASK. This same functionality is provided by the parallel use of multiple objects, which means this addition is no longer necessary.
  
  
• If, within the same SAP LUW, bgRFC units and alsoupdatesare executed, the bgRFC units are dependent on the update. Only after the update has been processedcan the linked bgRFC also be processed. When an incorrect update record is deleted, the correspondingbgRFC units are also deleted. The linkage of bgRFC with the update can be removed with the interface method IF_BGRFC_UNIT~SEPARATE_FROM_UPDATE_TASK of the bgRFC object.
  
  
• Dialog module registeredbgRFCsthat were not started there using COMMIT WORK are not executed by the COMMIT WORK of the caller either.
  
  
• The statements COMMITWORK and ROLLBACK WORK may not be executed in a unit. In addition, no implicitdatabase commit may be triggered there.
  
  
  

Exceptions

Catchable Exceptions

CX_BGRFC_INVALID_UNIT

• Cause: oref points to an invalid object.
  
  
  

CL_GUI_FRONTEND_SERVICES - Frontend Services   General Data in Customer Master  
This documentation is copyright by SAP AG.


Length: 4631 Date: 20120518 Time: 195713     triton ( 146 ms )