directPRINT/Service

Windows Hot Directory Service

Spezifikation

Betriebssysteme:	Windows NT 4.0, Windows 2000, Windows XP, Windows Vista, Windows 7, Windows Server 2000, Server 2003, Server 2008
Softwaregattung:	Hot Directory Service als Windows Dienst oder Windows Applikation
Dateisysteme:	NTFS, FAT und Netzwerklaufwerke
Überwachung:	Mehrstufige Überwachung des Dateistatus: Ausnutzung von schnellen Low-Level Funktionen für NTFS-Laufwerke (Event Handled) Sichere Dateiüberwachung anhand List - Directory Funktion (Polling) für alle Dateisysteme Optionale Überwachung des Dateistatus anhand Indexdatei. Hoher Datendurchsatz für lokale NTFS-Laufwerke, da keine Timeouts verwendet werden.
Verzeichnisse:	Gleichzeitige Überwachung mehrerer Verzeichnisse ohne Einbußen in der Performance. Für jedes Verzeichnis können abhängig vom Dateityp unterschiedliche Programme aufgerufen werden.
Aktionen:	Abhängig vom Rückgabewert des Programmes können die verarbeiteten Dateien gelöscht werden. Optional können bei Rückgabe eines Fehlercodes die betroffenen Dateien in ein Fehlerverzeichnis zur weiteren Untersuchung durch den Operator kopiert werden.
Ereignisprotokoll:	Alle Fehlerzustände werden im Windows - Ereignisprotokoll vermerkt. Es werden keine Fehlerdialoge geöffnet. Das Fehlerprotokoll kann administrativ über das Netzwerk mit der Windows - Anwendung "eventvwr.exe" eingesehen werden.

Steuerung durch die Kommandozeile

Das Programm dcp32.exe besitzt folgende Parameter in der Kommandozeile:

dcp32 [/START | /STOP | /RESET | /INSTALL | /UNINSTALL]

Parameter	Beschreibung
/START	Startet die Überwachung. Wurde die Überwachung als Windows-Dienst konfiguriert, wird der Dienst gestartet und das Programm beendet. Wurde die Überwachung als Windows-Applikation definiert, wird die Überwachung gestartet. Die gestartete Applikation wird jedoch nicht beendet, solange die Überwachung durchgeführt wird. Im Windows Tray (neben der Uhr in der Startleiste) wird ein Symbol angezeigt.
/STOP	Beendet die Überwachung, falls diese als Dienst gestartet wurde. Eine Überwachung als Applikation kann derzeit nicht über die Kommandozeile gestoppt werden. Falls die Überwachung als Dienst konfiguriert wurde, wird das Programm beendet.
/RESET	Löscht alle gespeicherten Daten der Indexdatei. Dateien, deren Dateistatus zuvor in der Indexdatei enthalten waren, werden neu bearbeitet.
/INSTALL	Installiert den Windows - Dienst erneut. Diese Option kann verwendet werden, falls wärend der Installation ein Fehler aufgetreten ist und der Windows - Dienst nicht gestartet werden kann.
/UNINSTALL	Deinstalliert den Windows - Dienst. Nach der Deinstallation kann der gleiche Dienst für einen gewissen Zeitraum nicht erneut installiert werden.

Aufbau der Konfigurationsdatei

Die Konfiguration wird vollständig in einer ASCII-Datei vorgenommen. Die Datei verwendet das bekannte INI-Format und kann z.B. mit Notepad.exe editiert werden. Die Datei ist in verschiedene Abschnitte (Sektionen) unterteilt.

Um die Konfigurationsdatei zu öffnen:

Starten Sie directPRINT Service
Wählen Sie "Datei - Einstellungen..."

Sie erhalten Notepad mit der geladenen Konfigurationsdatei.

Der Abschnitt [SETUP]

Diese Sektion enthält globale Parameter, die für alle Überwachungspunkte gelten.

Parameter

Beschreibung

LOGLEVEL = <enum>

Filtert die Fehlermeldungen die in das Windows- Systemlog geschrieben werden. Sie können hiermit steuern, wie genau der Programmstatus im Fehlerlog angegeben werden soll. Gültige Werte für <enum> sind:

<enum>	Beschreibung
SUCCESS	Alle Meldungen anzeigen
WARNING	Warnungen und Fehler anzeigen
ERROR	Nur Fehler Anzeigen

EXTRASCANTIME = #

Der Intervall in Sekunden in der die Verzeichnisse nach übersehenden Dateien abgesucht werden sollen. Dies ist ein integriertes Sicherungssystem, dass bekannte Probleme des Windows - internen Dateisysteme abfängt. Bei hoher Systemlast oder inkompatiblen Netzwerklaufwerken (z.B. Samba) können u.U. Dateiänderungen übersehen werden. Die überwachten Verzeichnisse werden deshalb zusätzlich in einem Intervall nach Änderungen durchsucht. Beachten Sie, dass ein kürzerer Intervall die Netzwerklast signifikant erhöht.

Der Abschnitt [ENVIRONMENT]

Diese Sektion enthält eine Reihe frei definierbarer Parameter, die in den folgenden Definitionen als Textbausteine verwendet werden können. Alle Zeilen haben das Format:

Parameter	Beschreibung
NAME = WERT	Die Parameter des Environments können bei allen Pfad- und Programmangaben der folgenden Sektionen mit %NAME% verwendet werden. Der String %NAME% % wird dann durch WERT ersetzt. Verwenden Sie das Environment z.B., um Basisverzeichnisse für Anwendungen und Pfade anzugeben.

Der Abschnitt [WATCHPOINTS]

Geben Sie in dieser Sektion die zu überwachenden Verzeichnisse an. Jede Zeile besitzt das Format:

Parameter Beschreibung

WPSECTION = PATH,ACTIONSECTION,...

Parameter	Beschreibung
WPSECTION	Frei wählbarer Sektionsname für die Parameter dieses Überwachungspunktes.
PATH	Der zu überwachende Pfad. Es können die Parameter aus der Sektion [ENVIRONMENT] verwendet werden. Schließen Sie diesen Parameter zu Sicherheit in "doppelte Anführungszeichen" ein, falls der Pfadname das Komma enthält.
ACTIONSECTION	Frei wählbarer Sektionsname für die Parameter der Aktion. Es können mehrere Sektionsnamen angegeben werden. Trennen Sie diese durch das Komma. Werden mehrere Aktionen angeben, wird die erste Aktion ausgeführt, auf die der Dateiname passt.

Beachten Sie: Jedes zu überwachende Verzeichnis benötigt Systemresourcen.
Beispiel:
WatchPoint1 = c:\MySpooler\HotDir1,Action1

Der Abschnitt [WPSECTION]

Der Name WPSECTION dieser Sektion ist ein Platzhalter und frei wählbar. Er muss einem Sektionsnamen in der Sektion [WATCHPOINTS] entsprechen. Diese Sektion legt fest, wie Verzeichnis zu überwachen ist.

Parameter Beschreibung

DELETEFILES = <number>

Steuert wie die Dateien im überwachten Verzeichnis nach der Bearbeitung gelöscht werden sollen. Sollen die Dateien nach der Verarbeitung nicht gelöscht werden und langfristig im überwachten Verzeichnis verbleiben, so sollte die Option FileHistory=1 aktiviert werden.

<number>	Beschreibung
0	Ist dieser Parameter nicht vorhanden oder 0, werden keine Dateien gelöscht.
1	Dateien werden nach Ende des aufgerufenen Programmes gelöscht.
2	Die Dateien werden auf jeden Fall gelöscht, auch wenn sie schreibgeschützt sind oder zum Löschzeitpunkt durch eine Anwendung blockiert sind.

ERRORFILES = <path> Geben Sie diesen Parameter an, falls Dateien in ein Verzeichnis verschoben oder kopiert werden sollen, sobald das aufgerufene Programm mit einem Fehlercode beendet
Ersetzen Sie <path> durch ein gültiges lokales Verzeichnis. Haben Sie die Option DeleteFiles (s.o.) aktiviert, werden fehlerhaft bearbeitete Dateien in das Verzeichnis verschoben. Haben Sie die Option DeleteFiles nicht aktiviert, werden fehlerhaft bearbeitete Dateien in das Verzeichnis kopiert. Die originale Datei bleibt in jedem Fall erhalten.
Wird der Parameter ErrorFiles nicht angegeben, wird die Datei im Fehlerfall nicht verschoben bzw. kopiert.
Beispiel:
ErrorFiles = c:\MySpooler\Errors

WRITEDELAY = <number> Verzögert die Bearbeitung von neuen Dateien um die in <number> angegebenen Millisekunden (ms). Jeder erneute Schreibzugriff auf die Datei verlängert das Warteintervall. Einige Anwendungen wie der Microsoft IIS FTP-Dienst schließen und öffnen Dateien bei der Erstellung mehrfach. Über das Warteintervall kann die Weiterverarbeitung verzögert werden. Wird die Option FileHistory verwendet, sollte als WriteDelay ein Wert >= 1000 angegeben werden.

SUBDIRECTORIES=<bool>

Gibt an, ob die Überwachung nur für das angegebene Verzeichnis oder auch rekursiv für jedes Unterverzeichnis erfolgen soll.

<bool>	Beschreibung
0	Es wird nur das angegebene Verzeichnis überwacht.
1	Es wird das angegebene Verzeichnis und alle Unterverzeichnisse überwacht.

FILEHISTORY=<bool> Aktiviert die permanente Speicherung des Dateistatus in einer Indexdatei. Verwenden Sie diese Option, wenn die Dateien im überwachten Verzeichnis nach der Verarbeitung nicht gelöscht und langfristig im Verzeichnis verbleiben sollen. Sinnvollerweise sollte die Option DeleteFiles=0 angegeben werden. Bei aktivierter Option wird das letzte Schreibdatum und die letzte Dateigröße jeder gefundenen Datei in einer permanenten Indexdatei vorgehalten. So wird z.B. bei einem Neustart des Dienstes vermieden, dass bereits bearbeitete Dateien erneut bearbeitet werden. Wird die Datei verändert, so wird die konfigurierte Verarbeitungsroutine erneut aufgerufen.
Da bei einer großen Anzahl Dateien der Zugriff auf die Indexdatei etwas Zeit benötigt, sollte in der Option "WriteDelay=1000" oder mehr angegeben werden.
Die Indexdateien "filehistory.dat" und "filehistory.idx" werden automatisch bei erster Verwendung der Option im Programmverzeichnis erzeugt. Werden die Indexdateien gelöscht, werden alle im überwachten Verzeichnis enthaltenen Dateien erneut verarbeitet. Die Indexdateien können mit dem Befehl "dcp32 /RESET" gelöscht werden.

Der Abschnitt [ACTIONSECTION]

Der Name der ACTIONSECTION dieser Sektion ist ein Platzhalter und frei wählbar. Er muss einem Sektionsnamen in der Sektion [WATCHPOINTS] entsprechen. Diese Sektion legt fest, was bei einer gefundenen neuen Datei geschehen soll (Aktion).

Parameter Beschreibung

DESCRIPTION = <text> Legt eine Beschreibung für die Aktion fest. Ersetzen Sie <text> durch Ihre Beschreibung. Der Text wird bei Fehlermeldungen im Ereignisprotoll verwendet. Beispiel:
Description = Grafikdateien drucken

FILESPEC = <spec>,... Legt die Dateiendungen fest, die die aufgerufene Anwendung unterstützt. Ersetzten Sie <spec> durch eine Dateispezifikation ähnlich den DOS-Wildcards. Es können die Suchzeichen * und ? verwendet werden. Mehrere Spezifikationen können durch das Komma getrennt angegeben werden. Beispiel: FileSpec=*.tif,*.pcx,*.gif

WORKDIR = <path> Legt das aktuelle Laufwerk und Verzeichnis fest, in dem die Anwendung ausgeführt wird. Ersetzen Sie <path> durch einen gültigen Pfad ohne abschließendes Backslash. Beispiel:
WorkDir = c:\temp\long path

APPLICATION = <path> Legt die aufgerufene Applikation fest. Ersetzen Sie <path> durch den Dateinamen und Pfad der aufgerufenen Anwendung. Sie können die im Environment angegebenen Platzhalter verwenden. Beispiel:
Application = c:\programme\directtools\directprint.exe

PARAMETERS = <params>

Legt die Aufrufparameter (Kommandozeile) der gestarteten Anwendung fest. Im Aufrufparameter <params> können Platzhalter verwendet werden, um den Dateiname der im überwachten Verzeichnis gefundenen Datei zu übergeben.Folgende Platzhalter sind möglich:

Makro	Beschreibung	Beispiel
%1	Kompletter Dateiname mit Pfad	c:\long path\abc 1.tif
%2	Dateiname ohne Pfad	abc 1.tif
%3	Dateiname ohne Pfad und ohne Namenserweiterung (Extension)	abc 1
%4	Pfad der Datei	c:\long path
%5	Namenserweiterung (Extension) der Datei	.tif
%6	Kurzer Dateiname mit Pfad	c:\long~1\abc~1.tif
%7	Kurzer Dateiname ohne Pfad	abc~1.tif
%name%	Name einer beliebigen Variable, die durch eine Skript erstellt wurde.
%FILECOUNT% %FILECOUNT3% %FILECOUNT6%	Globaler Dateizähler, zählt alle Dateien in allen Verzeichnissen, ohne führende Null, 3- oder 6-stellig	5 005 000005
%DIRFILECOUNT% %DIRFILECOUNT3% %DIRFILECOUNT6%	Dateizähler für das überwachten Verzeichnis, ohne führende Null, 3- oder 6-stellig	3 003 000003
%HASH%	Eindeutige Dateikennung, 8 stellig	0034AB47
%YY%	Jahr, zweistellig	08
%YYYY%	Jahr, vierstellig	2008
%MM%	Monat, zweistellig	04
%DD%	Tag, zweistellig	01
%HH%	Stunde, zweistellig	07
%NN%	Minute, zweistellig	59
%SS%	Sekunde, zweistellig	59
%ZZZ%	Millisekdune, dreistellig	999

Kurze Dateinamen: Falls Sie kurze Dateinamen zum Kopieren von Dateien verwenden, beachten Sie bitte, dass ein kurzer Dateiname ohne Pfad die Datei in einem anderen Verzeichnis oder Laufwerk nicht mehr eindeutig bezeichnet.

SCRIPT = <section> Gibt optional den Sektionsnamen mit einem Script an. Das Script wird vor dem Programmaufruf ausgeführt und kann dazu verwendet werden, die Aufrufparameter anzupassen.

SHOWSTATE = <number>

Legt die Anzeige des aufgerufenen Programmes auf dem Desktop fest.

<number>	Beschreibung
0	Keine Anzeige. Die Anwendung wird versteckt. Falls Sie die Überwachung als Dienst ausführen, sollten Sie diese Einstellung wählen.
1	Normale Anzeige. Die Anwendung wird als oberste Anwendung auf dem Desktop angezeigt.
2	Minimierte Anzeige. Die Anwendung wird minimiert auf dem Desktop dargestellt.
3	Normale inaktive Anzeige. Die Anwendung wird normal auf dem Desktop angezeigt, ohne die aktive Anwendung zu unterbrechen. Evtl. ist das Fenster der gestarteten Anwendung von anderen Fenstern verdeckt.

Skripte ausführen

Scripte werden vor jedem Programmaufruf ausgeführt und können Parameter im Environment verändert und neu setzen. Das Environment ist der Namensraum der %NAME% - Variablen, aus denen ein Programmaufruf zusammengesetzt werden kann.

Skripte bieten Ihnen somit die Möglichkeit, komplexe Parameter zu extrahieren und an die folgende Anwendung zu übergeben.

Das Script wird in einer eigenen Sektion mit beliebigen Namen erstellt. Der Sektionsname wird im Parameter SCRIPT einer Aktion in der Sektion [ACTIONSECTION] zugeordnet. Scripte, die nicht zugeordnet sind, werden auch nicht ausgeführt. Ein Script wird immer zeilenweise von oben nach unten ausgeführt.

Bei der Auswertung von Texten können komplexe Such- und Ersetzungsmuster, sogenannte Reguläre Ausdrücke verwendet werden.

Syntax Extract - Befehl

EXTRACT <name> = <value>,<match>,<regexpr>

Parameter	Beschreibung
<name>	Name einer Environment - Variablen, in der das Ergebnis abgelegt wird.
<value>	Der durchsuchender String. Befinden sich in <value> Parameter, so werden diese durch den aktuellen Parameterwert im Environment ersetzt.
<match>	Index des gefundenen Teilausdruckes in <regexpr>. Ein Teilausdruck im Regulären Ausdruck wird durch eine runde Klammerung (...) definiert. <match> gibt also die von 1 aufwärts zählende Klammerung an. Wird 0 angegeben, wird der gesamte gefundene Ausdruck zurückgegeben.
<regexpr>	Ein Reguläre Ausdruck. Verwenden Sie das Programm "RexTutor.exe", um Ihren Regulären Ausdruck vorher zu testen.

Beispiel:

Aus einem Dateinamen soll der mit einem Punkt separierte Teilstring vor der Dateiextension extrahiert werden. Der Dateiname steht in der Variable %1 zur Verfügung. Der Dateiname lautet z.B. "c:\pfad\langer pfad\afilename.searched-string.prn". Um den Text "searched-string" in die Variable "astring" zu übernehmen:

  EXTRACT astring = %1,1,.*\.(.*)\.prn$

Syntax Zuweisung =

  <name> = <value>

Weist der Environment - Variable mit Namen <name> den neuen Wert <value> zu. Befinden sich in <value> Parameter (%NAME%), so werden diese durch den aktuellen Parameterwert im Environment ersetzt.

Syntax IFMATCH - Befehl

  IFMATCH <value> = <regexpr>

Sucht in <value> den ersten Teilausdruck (die erste runde Klammer). Falls der Suchausdruck zutreffend ist, wird der erste Teilausdruck der Variable <value> zugewiesen. Trifft der Suchausdruck nicht zu, wird <value> nicht verändert. Im <regexpr> muss mindestens ein Teilausdruck (runde Klammern) enthalten sein. Vor dem IFMATCH - Befehl sollte ein EXTRACT - Befehl oder eine Zuweisung (=) angegeben werden.

Minimale Installation, Einbindung in Applikationen

Die Installation von directPRINT/Service erfordert das Kopieren der folgenden Programmdateien in ein beliebiges Verzeichnis:

"dcp32.exe" - die Programmdatei
"dcpsvr.exe" - der Windows - Dienst
"dcp32.chm" - die Hilfe-Datei
"dcpsvr.ini" - die Konfigurationsdatei

Zur Registration des Dienstes muss einmalig der folgende Aufruf erfolgen: "dcp32.exe /INSTALL".