Ansicht
Dokumentation

BAL_LOG_CREATE - Application Log: Log: Create with Header Data

BAL_LOG_CREATE - Application Log: Log: Create with Header Data

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

Functionality

The function module BAL_LOG_CREATE opens the Application Log whose header data is in the Importing parameter I_S_LOG_HEADER, which has the structure BAL_S_LOG.

The function module BAL_LOG_CREATE returns the log handle (LOG_HANDLE, CHAR22).
The LOG_HANDLE is a GUID (globally unique identifier) which uniquely identifies a log. You can access this log with this handle, for example, to subsequently change the header data ( BAL_LOG_HDR_CHANGE) or to add a message (BAL_LOG_MSG_ADD) or an exception text (BAL_LOG_EXCEPTION_ADD) to the log.
The LOG_HANDLE has its permanent value straight away, so it remains valid after saving.

==>Note:
Logs in memory and in the database are referred to in the new Application Log by the log handle (LOG_HANDLE), but the previous LOGNUMBER, which is assigned from number range interval 01 of number range object APPL_LOG when you save, still exists. A lot of applications have a reference to this LOGNUMBER in their structures, so it is still supported. The LOGNUMBER is also more understandable for users than the LOG_HANDLE. There is a 1:1 relationship between LOG_HANDLE and LOGNUMBER.

Related function modules

Simple log creation call
Methods of collecting messages

Further information

Overview of the most important function groups

Quick start documentation

Application Log: Technical documentation





Parameters

E_LOG_HANDLE
I_S_LOG

Exceptions

LOG_HEADER_INCONSISTENT

Function Group

SBAL

ABAP Short Reference   ABAP Short Reference  
This documentation is copyright by SAP AG.

Length: 2529 Date: 20240601 Time: 234255     sap01-206 ( 47 ms )