Ansicht
Dokumentation

TH_SET_APPL_INFO - set application info

BAL Application Log Documentation   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Mit Hilfe des Bausteins TH_SET_APPL_INFO kann die Anwendung durch Setzten der Parameter APPL_INFO und APPL_INFO_LEN Informationen für eine ABAP Session hinterlegen. Diese Informationen werden dann z.B. innerhalb der Transaktionen SM04 (Benutzersitzungen) und SM50 (Workprozesse) angezeigt. Zudem werden sie im Falle eines Fehlers auch als Teil des ABAP Laufzeitfehlers hinterlegt (Transaktion ST22). Die maximale Länge der Informationen wird durch die Konstante TH_APPL_INFO_MAX_INFO_LEN (siehe Include TSKHINCL) definiert. Wenn keine Länge angegeben wird, wird intern die Größe des übergebenen Text-Objektes verwendet. Prinzipiell kann man zwei Arten von Informationen hinterlegen:

• STACK: hierbei werden die Informationen von verschiedenen Aufrufen "Stack artig" verwaltet. Dazu muss der optionale Parameter MODE den Wert TH_APPL_INFO_MODE_STACK (siehe IncludeTSKHINCL) haben. Das ist auch der Default-Wert dieses Parameters. Die maximale Stack-Tiefe wird durch die Konstante TH_APPL_INFO_MAX_ELEMS definiert (siehe Include TSKHINCL). Wurde die maximale Stack-Tiefe erreicht führt ein erneuter Aufruf zu einem Fehler. Mittels des Bausteins TH_DEL_APPL_INFO kann entweder das oberste Element dieses Stacks oder auch der gesamte Stack abgebaut werden.

• SCROLL: hierbei werden die Informationen in einem Bereich mit maximal TH_APPL_INFO_MAX_ELEMS Einträgen abgelegt. Um einen Eintrag in diesem Bereich zu erzeugen muss der Baustein mit dem Parameter MODE = TH_APPL_INFO_MODE_SCROLL aufgerufen werden. Sind alle Elemente dieses Bereichs gefüllt wird bei einem erneuten Aufruf der "älteste" Eintrag gelöscht.

Innerhalb der Bereiche sind die Einträge von 0 bis TH_APPL_INFO_MAX_ELEMS - 1 durchnummeriert.

Innerhalb der Transaktion SM04 wird der erste Eintrag des Stack-Bereichs (Eintrag mit Nummer 0) angezeigt. Innerhalb der Transaktion SM50 werden bei der Detail-Anzeige sowohl STACK- als auch SCROLL-Bereich angezeigt. Ein ABAP Laufzeitfehler enthält ebenfalls alle vorhandenen Bereiche.

Zum Lesen / Löschen der gesetzten Informationen können die Bausteine TH_GET_APPL_INFO / TH_DEL_APPL_INFO verwendet werden.

Außer diesen "sichtbaren" Informationen kann man mittels der Parameter APPL_HIDE und APPL_HIDE_LEN auch binäre Daten hinterlegen, die nicht Teil der oben genannten Ausgaben sind.

Beispiel

Hinweise

Weiterführende Informationen

Siehe auch die Bausteine TH_GET_APPL_INFO und TH_DEL_APPL_INFO.

Parameter

APPL_HIDE
APPL_HIDE_LEN
APPL_INFO
APPL_INFO_LEN
LEVEL
MODE

Ausnahmen

APPL_INFO_ERROR
APPL_INFO_STACK_EXCEEDED
APPL_INFO_TOO_LONG

Funktionsgruppe

THFB

CPI1466 during Backup   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3067 Date: 20240523 Time: 142319     sap01-206 ( 74 ms )