Inhaltsverzeichnis
Werbung
Beschreibung der einzelnen DP-Funktionen und Daten sowie Fehlercodes
4.1.27 DP_write_trc
Zweck
Diese Funktion ermöglicht es dem Anwenderprogramm, zu Test- und Debug-
Zwecken einen selbstdefinierten Texteintrag in die DP-Trace-Datei zu schreiben.
Optional ist es auch möglich, zusätzlich den Hex-Dump eines Speicherbereichs
ausgeben zu lassen.
Voraussetzung
Damit der Trace-Eintrag in die Trace-Datei geschrieben wird, sind folgende Vor-
aussetzungen erforderlich:
1. Aktivierung der DP-Trace-Datei durch das Programm „DP_Trace einstellen".
Der Aufruf dieses Programms erfolgt über „PG/PC-Schnittstelle einstellen"
(Diagnose -> erweiterte Diagnose -> DP_Trace).
2. Freischaltung der Funktion „DP_write_text" in der Trace-Auswahl des Pro-
gramms „DP_Trace einstellen"
3. Übereinstimmung des Aufzeichnungs-Levels zum Vorgabewert in „DP_Trace
einstellen". Der Aufzeichnungs-Level wird im Aufrufparameter trc_depth (siehe
unten) gewählt.
Hinweis 1
!
Die DP-Trace-Datei beeinträchtigt die Ausführungsgeschwindigkeit und Dynamik
des DP-Anwenderprogramms. Sie sollte daher nur zu Test- und Debug-Zwecken
des DP-Anwenderprogramms aktiviert werden.
Hinweis 2
Der DP-Trace ist als Umlaufpuffer konzipiert. Daher werden alte Trace-Einträge
überschrieben, wenn das Ende des Umlaufpuffers erreicht worden ist.
Syntax
DPR_DWORD DP_write_trc (
const DPR_STRING trc_text[DP_ERR_TXT_SIZE],// in
DPR_WORD
DPR_WORD
const DPR_BYTE
DPR_BYTE
Programmierschnittstelle DP-Base für CP 5613/CP 5614
C79000-G8900-C139-04
trc_depth,
*trc_active,
*buf,
buf_len);
// in
// out
// in
// in
135
Werbung
Inhaltsverzeichnis
