Ansicht
Dokumentation

APPL_LOG_WRITE_HEADER - Application log: Enter log header data

General Material Data   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Functionality

This function module writes the log header data specified in the HEADER structure to the local memory.

When the same object and sub-object are called repeatedly the data is overwritten. Any parameters may be deleted. You can check this with the flag UPDATE_OR_INSERT.

Example

Example call:

DATA: BEGIN OF HEADER_DATA.
        INCLUDE STRUCTURE BALHDRI.
DATA: END OF HEADER_DATA,
      UPDA_OR_INS(1) TYPE C.

...

CALL FUNCTION 'APPL_LOG_WRITE_HEADER'
     EXPORTING
          HEADER              = HEADER_DATA
     IMPORTING
          UPDATE_OR_INSERT    = UPDA_OR_INS
     EXCEPTIONS
          OBJECT_NOT_FOUND    = 01
          SUBOBJECT_NOT_FOUND = 02.

Notes

• This function module does not have to be called in order to enter a log or collect messages.

If one of the function modules for creating messages is called, without header data for the affected object being written explicitly beforehand, the header data is written implicitly. The structure HEADER is then filled from system fields.

• Note that when entering logs or collecting messages object and sub-object are always interpreted as keys. Therefore you cannot enter logs for various external numbers simultaneously for one object and sub-object. This can only be done in sequence, by writing the log for an external number with the function module APPL_LOG_WRITE_DB to the database and then initializing the local memory with the function module APPL_LOG_INIT.

• If the object and sub-object are not specified, the most recent object and sub-object are used.

Current object and sub-object can be explicitly set with the function module APPL_LOG_SET_OBJECT. The object and sub-object are set implicitly by the following function modules, if the object name is specified when the module is called:

• APPL_LOG_INIT

• APPL_LOG_WRITE_HEADER

• APPL_LOG_WRITE_LOG_PARAMETERS

• APPL_LOG_WRITE_SINGLE_MESSAGE

• APPL_LOG_WRITE_MESSAGES

• APPL_LOG_WRITE_MESSAGE_PARAMS

Further information

Parameters

E_LOG_HANDLE
HEADER
LOG_HANDLE
UPDATE_OR_INSERT

Exceptions

ERROR
OBJECT_NOT_FOUND
SUBOBJECT_NOT_FOUND

Function Group

SLG0

Vendor Master (General Section)   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.

Length: 4332 Date: 20240523 Time: 091201     sap01-206 ( 53 ms )