Innovative Model Railroad Control System

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Erweiterte Traces ======
[[german#rocrail|{{  server.png}}]][[german|{{  rocrail-logo-35.png}}]]
[[german | Inhalt ]] -> [[german#rocrail|Rocrail-Server]] -> |[[rocrailini-de | Konfiguration]] 
  * [[rocrailini-gen-de|Allgemein]] | **[[rocrailini-trace-de|Trace]]** | [[rocrailini-service-de|Dienste]] | [[rocrailini-automode-de|Automatik]] | [[rocrailini-controller-de|Zentrale]] | [[:networking-de|R2Rnet]]
    * **Erweiterte Traces**
 \\

In speziellen Fällen werden ggf. über den Standard hinaus mehr Protokollmöglichkeiten benötigt, um dem Administrator zu helfen.\\
Ein Teil dieser Optionen ist nicht durch Dialoge änderbar und nur für Experten.\\
 \\
XML-Beschreibung: http://www.rocrail.net/doc/rocrail-wrappers/wrapper-en.html#trace\\
 \\

===== Optionen =====
Diese Attribute können im **''<trace…/>''** - Knoten der **''rocrail.ini''** verwendet werden.
^ Option        ^ Standard  ^ Beschreibung  ^
| protpath      | .          | Protokoll Pfad; Wohin die Protokolldateien gespeichert werden. (Relative Pfade nur bei Verwendung des **[[servermonitor-de|http Dienst]]** benutzen.) Der Pfad ist relativ zum pwd¹! |
| unique        | false      | Erstellen einer einzigen Protokolldatei beim Start. |
| size          |        100 | Dateigröße der Protokolldatei in KB. |
| nr            |         10 | Anzahl der aufeinanderfolgenden Protokolldateien. Im Falle von 0 oder 1 werden alle Ergebnisse in eine Datei geschrieben ohne Berücksichtigung der Dateigröße |
| exceptionfile | false      | Erstellen einer zusätzlichen Datei für Ergebnisse. |
| invoke        | ./xmail.pl | Externes Programm oder Skript aufrufen, um eine Ergebnis-Datei zu erstellen. |
| invokeasync   | false      | Der Aufruf wird in einem eigenen Thread behandelt. |
| dumpsize      |        128 | Max. byte dump Größe.|
 \\
¹) pwd = process working directory=Arbeitsverzeichnis\\

==== Unique ====
Um das Überschreiben bereits bestehender Protokolldateien bei einer Problemsuche zu verhindern, sorgt diese Einstellung dafür, dass immer ein einzigartiger Dateiname vergeben wird.\\
 \\

==== Invoke ====
Die **invoke** Option, in Verbindung mit **exceptionfile**, stellt einen Mechanismus dar, um jemanden oder etwas vom ersten Ergebnis zu informieren, das in eine neue Datei geschrieben wird.\\
Nach Durchsicht der Datei sollte diese verschoben oder gelöscht werden, um die Möglichkeit der Erstellung einer neuen Datei zu ermöglichen. (Wenn gewünscht.)\\
Das Skript oder Programm zur Überwachung ist benutzerdefiniert, wenn das externe Progamm aber den Rocrail-Server stoppen kann, sollte **invokeasync** auf //true// gesetzt werden.\\

==== xmail.pl ====
Das Beispiel Skript sendet eine Email wenn ein Protokoll erstellt wird:\\
<code perl>
#!/usr/bin/perl
require 5.000;

$mailaddr = $ARGV[0];

open(SENDMAIL, "| /usr/sbin/sendmail -t -n") || die "Unable to open sendmail";
print SENDMAIL "From: Rocrail\n";
print SENDMAIL "To: $mailaddr\n";
print SENDMAIL "Reply-To: Rocrail\n";
print SENDMAIL "Subject: Exception file created.\n";
print SENDMAIL "This email is sended to notify you because an exception file is created.\n";
close(SENDMAIL);</code>

=====Ebenen-Werte=====
<code>
TRCLEVEL_EXCEPTION=0x0001 ,TRCLEVEL_INFO   =0x0002  ,TRCLEVEL_WARNING =0x0004  ,TRCLEVEL_DEBUG    =0x0008,
TRCLEVEL_BYTE     =0x0010 ,TRCLEVEL_METHOD =0x0020  ,TRCLEVEL_MEMORY  =0x0040  ,TRCLEVEL_PARAM    =0x0080,
TRCLEVEL_PROTOCOL =0x0100 ,TRCLEVEL_ERROR  =0x0200  ,TRCLEVEL_PARSE   =0x0400  ,TRCLEVEL_WRAPPER  =0x0800,
TRCLEVEL_USER1    =0x1000 ,TRCLEVEL_USER2  =0x2000  ,TRCLEVEL_MONITOR =0x4000  ,TRCLEVEL_XMLH     =0x8000,
TRCLEVEL_USER     =0xF000 ,TRCLEVEL_CALC   =0x10000 ,TRCLEVEL_STATUS  =0x20000 ,TRCLEVEL_XMLSCRIPT=0x40000,
TRCLEVEL_FIND     =0x80000,TRCLEVEL_CLNTCON=0x100000,TRCLEVEL_ROUTER  =0x200000,TRCLEVEL_ALL      =0xFFFFFF
</code>