Ansicht
Dokumentation

BAL_CH_CHANGE -

PERFORM Short Reference   Vendor Master (General Section)  
This documentation is copyright by SAP AG.

|---------------------------------------------------------------------|
| Change log |
|---------------------------------------------------------------------|

Overview
=======================================================================

Application Log can create and change logs, whether they are still in the memory or have already been saved in the database. These functions are provided by the function modules described below.

Function modules
BAL_DB_ENQUEUE Lock log
BAL_DB_LOAD Load log(s)
BAL_DB_SAVE Save log(s)
BAL_DB_DEQUEUE Unlock log
BAL_LOG_MSG_CHANGE Change message
BAL_LOG_MSG_DELETE Delete message
BAL_LOG_EXCEPTION_CHANGE Change exception
BAL_LOG_EXCEPTION_DELETE Delete exception
BAL_LOG_HDR_CHANGE Change log header
BAL_LOG_DELETE Delete log (incl. in DB if saved)
BAL_LOG_REFRESH Delete log from memory

Lock and unlock logs
=======================================================================

To change a saved log, you must load it into memory with the function module BAL_DB_LOAD and save it after changing with BAL_DB_SAVE.

You should lock the log with BAL_DB_ENQUEUE, specifying the log handle I_LOG_HANDLE, before loading, to prevent its being changed by two programs at the same time.

You can also use the lock SCOPE parameter to specify when the lock is to be automaticaly reset (see SAP lock concept).

You can unlock a log with BAL_DB_DEQUEUE after saving.

Change log
=======================================================================

You can change logs as follows:

• Change message with BAL_LOG_MSG_CHANGE
  Message data (I_S_MSG) can be completely changed. You specify the message handle I_S_MSG_HANDLE.

• Delete message with BAL_LOG_MSG_DELETE
  The message with the message handle I_S_MSG_HANDLE is deleted.

• Change exception with BAL_LOG_EXCEPTION_CHANGE
  Under the specification of the message handle I_S_MSG_HANDLE, the exception data (I_S_EXC) can be completely changed.

• Delete exception with BAL_LOG_EXCEPTION_DELETE
  The exception with the message handle I_S_MSG_HANDLE is deleted.

• Change log header data with BAL_LOG_HDR_CHANGE
  Log header data (I_S_LOG) can be completely changed. You specify the log handle I_LOG_HANDLE

• Delete log with BAL_LOG_DELETE
  The log in memory with the log handle I_LOG_HANDLE is deleted from memory, and is deleted from the database when you save with BAL_DB_SAVE.

==>Note
To delete logs only in the database without first loading them into memory, use the function module BAL_DB_DELETE.

==>Note
To delete a log from memory only, without deleting it physically from the database when saving, use the function module BAL_LOG_REFRESH, e.g. when you have saved a log with BAL_DB_SAVE and then want to delete it from memory.

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

Length: 4821 Date: 20240510 Time: 025444     sap01-206 ( 50 ms )