Ansicht
Dokumentation

BAL_LOG_MSG_CUMULATE - Anwendungs-Log: Protokoll: Meldung: Kumuliert hinzufügen

CPI1466 during Backup General Material Data
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Eine Meldung wird dem mit I_LOG_HANDLE (Protokollhandle) identifizierten Protokoll kumuliert hinzugefügt.

Die Daten einer 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 diese Meldung eindeutig identifiziert.

Was bedeutet 'Kumulieren' ?

Gewisse Meldungen werden im Laufe eines Programms mehrfach abgesetzt, ohne daß ihr wiederholtes Auftreten eine weitere Information bringt. Um den Hauptspeicher nicht unnötig zu belasten, können derartige Meldungen mit BAL_LOG_MSG_CUMULATE auch kumuliert werden. Wenn eine gleichartige Meldung wiederholt abgesetzt wird, dann wird keine neue Meldung angelegt sondern der Zähler MSG_COUNT bei der alten Meldung hochgesetzt.
Was gleichartig heißt, kann in der Schnittstelle des Funktionsbausteins angegeben werden. Auf jeden Fall müssen die T100-Daten identisch sein. Optional kann man auch noch definieren, daß weiter Daten gleich sein müssen:

I_COMPARE_ATTRIBUTES = 'X'
Die weiteren Meldungsattribute (Problemklasse PROBCLASS, Detaillierungslevel DETLEVEL und Sortierfeld ALSORT) müssen gleich sein

I_COMPARE_CONTEXT = 'X'
Auch der Kontext muß gleich sein

I_COMPARE_PARAMETERS = 'X'
Auch die Parameter der Meldung müssen gleich sein.

Um eine gleichartige Meldung möglichst schnell bei Kumulation zu finden, baut das Application Log zur Laufzeit eine kleine Indextabelle auf, die eine möglichst eindeutige Signatur einer Meldung enthält. Dieser Index wird allerdings nur aufgebaut, wenn die Kumulation genutzt wird.

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.

==>Hinweis
Die Angabe des Protokollhandles bei Funktionsbausteinen wie BAL_LOG_MSG_ADD, BAL_LOG_MSG_CUMULATE, BAL_LOG_MSG_ADD_FREE_TEXT, etc. ist optional.
Wird es nicht angegeben, so wird das Default-Protokoll genommen. Dieses kann (neben anderen Default-Daten) mit BAL_GLB_MSG_DEFAULTS_SET gesetzt werden. Ist kein Default-Log definiert, wird es automatisch durch BAL_LOG_CREATE gesetzt (näheres siehe hier).

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_COMPARE_ATTRIBUTES
I_COMPARE_CONTEXT
I_COMPARE_PARAMETERS
I_LOG_HANDLE
I_S_MSG

Ausnahmen

LOG_IS_FULL
LOG_NOT_FOUND
MSG_INCONSISTENT

Funktionsgruppe

SBAL

rdisp/max_wprun_time - Maximum work process run time ROGBILLS - Synchronize billing plans
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4391 Date: 20240523 Time: 112406 sap01-206 ( 71 ms )

Ansicht Dokumentation