ABAPCREATE_OBJECT_AREA_HANDLE - CREATE OBJECT AREA HANDLE

BAL Application Log Documentation   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

CREATE OBJECT - AREA HANDLE

Short Reference

Syntax

CREATE OBJECT oref AREA HANDLE handle ... .

Effect

This statement creates an object as a shared object in thearea instance version of theshared memory, to which thearea handle referenced by handle is associated. The implicitly or explicitly specified class must be defined as asharedmemory enabled class using the SHARED MEMORY ENABLED addition of theCLASS statement.

For handle you must specify an object reference variable whose static type is CL_ABAP_MEMORY_AREA or one of its subclasses(area class). When the statement is executed, handle must point to anareahandle and the area handle must be associated with an area instance version with a change lock. To create such a reference, you can do either of the following:

• Copy the return value of the methods ATTACH_FOR_WRITE or ATTACH_FOR_UPDATE of an area class created using transaction SHMA.
  
  
• Copy the return value of the GET_HANDLE_BY_OREF method of any area class.
  
  
• Copy the return value of the GET_IMODE_HANDLE method of the predefined class CL_IMODE_AREA.
  

The latter is a reference to the area handle for the currentinternalsession and the CREATE OBJECT statement has the effect it does without the AREA HANDLE addition.

Note

• The only shared object that can be addressed directly from an ABAP program after a connection to an area instance version is the instance of thearea root class. All other objects have to be referenced in this instance.
  
• Like for every class, the static attributes of a shared object are created when you load the sharedmemory-enabled class in internal session of a program, and are not created in shared memory. They can thus occur more than once and independently of one another in different programs.
  
  
  

Example

See Creating a Class Instance as a Shared Object

CL_GUI_FRONTEND_SERVICES - Frontend Services   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.


Length: 3733 Date: 20120522 Time: 042706     triton ( 137 ms )