Ansicht
Dokumentation

TMS_ALT_ANALYSE_ALERT - Extern: Langtext zu Alert-ID ausgeben

BAL_S_LOG - Application Log: Log header data   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Baustein TMS_ALT_ANALYSE_ALERT dient zur Auswertung und Anzeige von Fehlersituationen im Transport Management System. Alle Fehler, die beim Ausführen von TMS-Services über die Kommunikationsschicht TMS-CI entstehen, werden von der CI aufgezeichnet. Diese sogenannten Alerts können von der rufenden Schicht (TMS-Manager) ausgewertet werden. In der Regel werden die Alerts an die User-Interface-Schicht (TMS-UI) weitergegeben und dort angezeigt.

Die vollständige Information zu einem Alert wird vom TMS Alert Service verwaltet und in der DB abgelegt. Mit TMS_ALT_ANALYSE_ALERT wird die Information zu einem Alert aus der DB ausgelesen und analysiert.

Zur Analyse eines Alerts wird der Baustein TMS__ANALYSE_ALERT aus der entsprechenden Service-Funktionsgruppe gerufen. Diese Funktionen sind Filter, mit denen die in der Alert-Struktur (TMSALOG) enthaltene Information nachbereitet werden können. Folgende Felder in der Alert-Struktur können modifiziert werden:

• TEXT

• MSGID, MSGTY, MSGNO, MSGV1, MSGV2, MSGV3, MSGV4

Zur Anzeige des Alert wird der TMS Alert Viewer (Baustein TMS_UA_DISPLAY_ALERT) benutzt. Dieser zeigt neben der Fehlernachricht und dem Freitextfeld die gesamte Information aus dem Umfeld des Alerts (System, Mandant, Service, ...) an.

Beispiel

Im TMS-Manager Baustein TMS_MGR_IMPORT_TR_QUEUE wird die Funktion TMS_TP_IMPORT aus dem Service TP ausgeführt.
* call remote command
call function 'TMS_CI_SEND_COMMAND'
exporting
iv_tarsystem = iv_system
iv_service = gc_tms_tp
iv_command = gc_tms_tp_import
iv_context = gc_tms_mgr_import_tr_queue
importing
es_exception = ls_exception
exceptions
alert = 1.

Im Verbose-Mode werden aufgetretene Fehler oder Warnungen angezeigt.
* send alert message
if iv_verbose = gc_x.
alt_analyse_alert ls_exception-id.
endif.

Die Alert-Struktur wird für die rufende Funktion bereitgestellt.
* export alert structure
es_exception = ls_exception.

Im TMS-UI Baustein werden Fehler und Warnungen angezeigt; im Falle eines Fehlers wird eine Exception ausgelöst.
* analyse alert
if ls_exception-id <> gc_tms_id_no_alert.
alt_analyse_alert ls_exception-id.
if ls_exception-severity = gc_tms_sev_error.
clear gs_dyn230.
raise import_queue_failed.
endif.
endif.

Hinweise

Rufen Sie den Baustein TMS_ALT_ANALYSE_ALERT nicht direkt auf. Benutzen Sie die vordefinierten Makros aus dem Include LTMSADEF.

Macro ALT_ANALYSE_ALERT Das Alert mit der Alert-ID &1 wird analysiert und mit dem TMS Alert Viewer angezeigt. Für Alerts mit Severity "Error" und "Info" wird sy-subrc auf 1 gesetzt. Die SY_MSG* Felder werden mit der angezeigten Fehlernachricht versorgt.

Macro ALT_ANALYSE_ALERT_FOR_RAISING Das Alert mit der Alert-ID &1 wird analysiert, aber nicht angezeigt. Für Alerts mit Severity "Error" und "Info" wird sy-subrc auf 1 gesetzt. Die SY_MSG* Felder werden mit der Fehlernachricht versorgt, die der TMS Alert Viewer anzeigt.

Macro ALT_ANALYSE_ALERT_FOR_EXTERNAL Das Alert mit der Alert-ID &1 wird analysiert, aber nicht angezeigt. Für Alerts mit Severity "Error" und "Info" wird sy-subrc auf 1 gesetzt. Die SY_MSG* Felder werden mit einer unspezifischen Standardmeldung gefüllt (siehe Parameter IV_STD_MSG).

Weiterführende Informationen

Parameter

ES_ALOG
ES_AMSG
EV_TP_KEY
IS_ALOG
IV_ALERT_ID
IV_DISPLAY_F1BUTTON
IV_NO_DISPLAY
IV_SERVICE
IV_SEVERITY
IV_STD_MSG
IV_STYLE
IV_TECH_INFO
TT_ALOG

Ausnahmen

ALERT

Funktionsgruppe

TMSA

BAL_S_LOG - Application Log: Log header data   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5313 Date: 20240523 Time: 143635     sap01-206 ( 78 ms )