f$ProtokollDatei (engl. f$tracefile)

Mit dieser Funktion wird ePOS dazu veranlasst, alle Aktionen, die nach dieser Funktion ausgeführt werden, in eine Protokolldatei zu schreiben. Als Protokolldatei wird eine Textdatei mit Tabulatoren als Trennzeichen der einzelnen Spalten geschrieben. Diese Datei lässt sich am übersichtlichsten in Excel lesen. Als Dateierweiterung wird .txt vorgeschlagen. In der Protokolldatei steht der Name der Entscheidungstabelle, die ausgeführte Aktion und deren Text. Außerdem wird der Start, das Ende und die erfüllte Bedingung einer Entscheidungstabelle in die Protokolldatei geschrieben. Zusätzlich können auf Wunsch die Werte von ePOS Parametern mit ausgegeben werden.

Hinweis: Die Funktionen f$ProtokollDatei und f$ProtokollDatenbank können nicht gemeinsam ausgeführt werden. Ein Aufruf der Funktionen beendet die jeweils andere.

Syntax:	Status = f$ProtokollDatei ( 'Dateiname' , mit_Metacode , 'Parameternamen' )
	Argument	Typ	Bedeutung
	Dateiname	Zeichenkette	Name der Protokolldatei oder '', um die Protokollierung zu beenden
	Mit_Metacode	Ganzzahl	Dieser Parameter steuert, ob die Ausführung der Entscheidungstabellen in Metasprache ebenfalls protokolliert werden soll. 0 – ohne Metasprache 1 – der Aufruf der Metasprachen-ET wird protokolliert 2 – die gesamte Metasprachen-ET wird protokolliert
	Parameternamen	Zeichenkette	Mit Komma getrennte Liste an ePOS Parametern, deren Werte in der Protokolldatei ausgegeben werden sollen.
Ergebnis:	Ganzzahl	0 – Datei wurde angelegt -1 – Die Datei konnte nicht angelegt werden Mögliche Ursachen: Falscher Pfad, Datei ist geöffnet, nicht ausreichende Berechtigungen
Beispiele:	smp_status = f$protokolldatei ('E:\\temp\\std_druck1.txt', 1,'status,wk1.MaterialID, textzeile') oder Dateiname = 'E:\\temp\\std_druck1.txt' smp_status = f$protokolldatei (Dateiname, 1,'status,wk1.MaterialID, textzeile')

Auszug aus der Protokolldatei:

Start	std_druck:dokumente:start	Tiefe	Start:11.06.10 11:44:21	status	wk1.MaterialID	textzeile
Start	std_druck:angebot:position (1)	5		0	15
	std_druck:angebot:position	5	(R4): i > wkkopf.AnzPos && wk[i].StlEbene < i_ebene && wk[i].StlEbene > i_ebene && wk[i].MaterialVKEbene == 1 && wk[i].MaterialVKTyp && smtext.Ausgabeart && wk[i].StlEbene	0	15
	std_druck:angebot:position	5	(R4:A1): f$PGKopie('wk[i]','wk1')	0	15
	std_druck:angebot:position	5	(R4:A2): Menge = wk1.Menge * wk1.VKFaktor	0	16
	std_druck:angebot:position	5	(R4:A3): p$a_menge()	0	16
Start	std_druck:angebot:a_menge ()	6		0	16
	std_druck:angebot:a_menge	6	(R2): Sonst	0	16
Ende	std_druck:angebot:a_menge	6		0	16
	std_druck:angebot:position	5	(R4:A4): i_ebene_gl = i_ebene	0	16