Ansicht
Dokumentation

HRIQ_BAL_LOG_CREATE - Anwendungs-Log: Protokoll: Anlegen mit Kopfdaten

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up Vendor Master (General Section)
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Ein Protokoll läßt sich im Application Log mit dem Funktionsbaustein BAL_LOG_CREATE eröffnen. Diesem Funktionsbaustein kann man die Kopfdaten des Protokoll mittels des Importing-Parameters I_S_LOG_HEADER mitgeben. Dieser hat die Struktur BAL_S_LOG.

Bei Aufruf des Funktionsbausteins BAL_LOG_CREATE erhält man das sogenannte Protokollhandle (LOG_HANDLE, CHAR22) zurück.
Das LOG_HANDLE ist eine sogenannte GUID (globally unique identifier), die ein Protokoll eindeutig identifiziert. Mit diesem Handle kann man auf dieses Protokoll zugreifen, um z.B. die Kopfdaten nachträglich zu verändern (BAL_LOG_HDR_CHANGE ) oder um eine Meldung (BAL_LOG_MSG_ADD) oder einen Aunsnahmetext (BAL_LOG_EXCEPTION_ADD) dem Protokoll hinzuzufügen.
Das LOG_HANDLE besitzt sofort seinen endgültigen Wert, ist also auch nach dem Sichern noch gültig.

==>Hinweis:
Protokolle im Hauptspeicher und auch auf der Datenbank werden im neuen Application Log durch das Protokollhandle (LOG_HANDLE) referenziert. Es existiert aber weiterhin die klassische LOGNUMBER, die beim Sichern aus dem Nummernkreisintervall 01 des Nummernkreisobjektes APPL_LOG gezogen wird. Viele Applikationen haben in ihren Strukturen eine Referenz auf diese LOGNUMBER, so daß diese weiterhin unterstützt wird. Außerdem ist in der Präsentation nach außen für den User die LOGNUMBER wesentlich verständlicher als das LOG_HANDLE. Zwischen LOG_HANDLE und LOGNUMBER besteht eine 1:1-Beziehung.

Weiterführende Informationen

Übersicht der wichtigsten Funktionsgruppen

Quickstart-Dokumentation

Application Log: Technische Dokumentation

Parameter

E_LOG_HANDLE
I_S_LOG

Ausnahmen

LOG_HEADER_INCONSISTENT

Funktionsgruppe

HRPIQ00BAL

rdisp/max_wprun_time - Maximum work process run time BAL_S_LOG - Application Log: Log header data
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3034 Date: 20240604 Time: 062640 sap01-206 ( 56 ms )

Ansicht Dokumentation