Ansicht
Dokumentation

BAL_LOG_MSG_REPLACE - Anwendungs-Log: Protokoll: Meldung: Die letzte ersetzen

rdisp/max_wprun_time - Maximum work process run time BAL Application Log Documentation
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Die zuletzt in das Application Log gestellte Meldung wird gelöscht und durch eine neue Meldung ersetzt.

Die Daten der neuen Meldung werden mittels des IMPORTING-Parameters I_S_MSG (Struktur BAL_S_MSG) vorgegeben. Man erhält mit E_S_MSG_HANDLE ein Meldungshandle zurück, das die neue Meldung eindeutig identifiziert.

In welches Protokoll wird die neue Meldung gestellt?

Wird mit I_LOG_HANDLE kein Protokollhandle vorgegeben, dann wird die Meldung, in das gleiche Protokoll gestellt wie die gelöschte Meldung.

Andernfalls wird die neue Meldung in das mit I_LOG_HANDLE identifizierte Protokoll gestellt.

Gibt es keine alte Meldung und ist mit I_LOG_HANDLE kein Protokoll vorgegeben, dann wird die Meldung dem Default-Protokoll hinzugefügt (mehr dazu siehe hier).

Wozu die letzte Meldung ersetzen?

Gelegentlich möchte man eine von einem Fremdprogramm an das Application Log abgesetzte Meldung durch eine eigene Meldung übersteuern. Mit dem Funktionsbaustein BAL_LOG_MSG_REPLACE kann dies durchgeführt werden.

Beispiel
Ein generischer Funktionsbaustein zur Terminierung wird aufgerufen, um die Termine für einen Flug zu berechnen. Beim Scheitern der Terminierung könnte so ein Funktionsbaustein mit einer relativ technischen Meldung aussteigen: "Terminierung für Vorgang 0006 gescheitert". Da Meldungen immer am Ort ihres Entstehen protokolliert werden sollen, schreibt dieser Baustein eine Meldung ins Application Log. Für den User wäre hingegen die Meldung "Terminermittlung für den Flug von Hamburg nach New York ist fehlgeschlagen" viel sprechender.

==>Hinweis
Das Handle der zuletzt abgesetzten Meldung kann man sich auch mit BAL_GLB_MSG_CURRENT_HANDLE_GET abholen. Dies kann man z.B. nutzen, wenn man die zuletzt geschriebene Meldung nicht überschreiben sondern löschen (mit BAL_LOG_MSG_DELETE) oder verändern (BAL_LOG_MSG_CHANGE) möchte.

Durch die Konfiguration des Application Logs kann man steuern, ob eine Meldung direkt angezeigt bzw. gesammelt werden soll. Die Exporting-Parameter E_MSG_WAS_DISPLAYED und E_MSG_WAS_LOGGED geben Auskunft darüber, was mit der Meldung geschehen ist.

Weiterführende Informationen

Übersicht der wichtigsten Funktionsgruppen

Quickstart-Dokumentation

Application Log: Technische Dokumentation

Parameter

E_MSG_WAS_DISPLAYED
E_MSG_WAS_LOGGED
E_S_MSG_HANDLE
I_LOG_HANDLE
I_S_MSG

Ausnahmen

LOG_IS_FULL
LOG_NOT_FOUND
MSG_INCONSISTENT

Funktionsgruppe

SBAL_TOOLBOX

ABAP Short Reference BAL_S_LOG - Application Log: Log header data
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4375 Date: 20240523 Time: 110740 sap01-206 ( 66 ms )

Ansicht Dokumentation