Ansicht
Dokumentation

SX_TRACE_INITIALIZE - SAPconnect: Trace neu anlegen, öffnen oder schließen

PERFORM Short Reference   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein ermittelt die einem Dokument zugehörige Tracedatei, legt diese ggf. neu an und öffnet sie. Alle nachfolgenden Traceausgaben mit SWT_TRACE_WRITE (z.B. durch Verwendung der im Include RSWTGDSO deklarierten Macros "sx_trace_*") werden dieser Tracedatei hinzugefügt.

Es werden pro Tracedatei jeweils alle Traceausgaben gesammelt, die
a) sich auf alle Versandvorgänge eines SAPoffice-Dokumentes beziehen,
d.h. Senden des Objekts (evtl. an mehrere Empfänger) und Empfangen
von Statusnachrichten umfassen
b) sich auf den Empfangsvorgang eines externen Dokumentes beziehen,
d.h. Empfangen des Objektes, Weiterleiten an einen oder mehrere
Empfänger im R/3 und Versand von Statusnachrichten umfassen
c) allgemeiner Natur sind und sich nicht auf ein spezielles Dokument
oder eine Statusnachricht beziehen. Für diese Ausgaben wird pro Tag
eine separate Tracedatei geschrieben.

Die Tracefunktion kann über die SAPconnect-Administration (Transaktion SCOA) für jede dieser drei Kategorien separat auf einen der folgenden Zustände eingestellt werden :
a) Ein: Bereits existierende Tracedateien werden fortgesetzt, für neue
Dokumente (bzw. bei Tageswechsel) werden neue Tracedateien angelegt.
b) Fortsetzen: Bereits existierende Tracedateien werden fortgesetzt,
für neue Dokumente (bzw. bei Tageswechsel) werden jedoch keine neuen
Tracedateien angelegt. Nachfolgende Aufrufe von SWT_TRACE_WRITE
bleiben ohne Wirkung.
c) Aus: Es werden keine Tracedateien fortgesetzt oder neu angelegt.
Alle nachfolgenden Aufrufe von SWT_TRACE_WRITE bleiben ohne Wirkung.

Beispiel

a) Setzen des Trace für ein ausgehendes Dokument bzw. eine empfangene
Statusnachricht:
CALL FUNCTION 'SX_TRACE_INITIALIZE'
EXPORTING OUTBOUND_OBJ_ID = object_id
OBJ_TITLE = document_data-obj_descr.

b) Setzen des Trace für ein empfangenes Dokument bzw. eine ausgehende
Statusnachricht:
CALL FUNCTION 'SX_TRACE_INITIALIZE'
EXPORTING INBOUND_OBJ_ID = receive_info-comm_id
OBJ_TITLE = document_data-obj_descr.

c) Setzen des Trace für allgemeine Ausgaben (auf kein Dokument bzw.
keine Statusnachricht bezogen):
CALL FUNCTION 'SX_TRACE_INITIALIZE'.
In diesem Falle wird der Titel der Tracedatei automatisch aus dem
Tagesdatum generiert, OBJ_TITLE wird ignoriert.

Hinweise

Weiterführende Informationen

Dokument "SAPconnect: Specification & Design"

Parameter

CHANGE_TITLE
GLOBAL_OBJ_ID
INBOUND_OBJ_ID
OBJ_TITLE
OUTBOUND_OBJ_ID

Ausnahmen

Funktionsgruppe

SX06

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

Length: 3116 Date: 20240523 Time: 104531     sap01-206 ( 34 ms )