FAQ TFORMer Server

Spool Fehlermeldungen (Errors)

Die häufigsten in der Praxis auftretenden Fehlercodes finden Sie nachfolgend erklärt. TFORMer Server spezifische Fehlercodes sind im Manual TFORMer Spooladmin.pdf (Fernwartung) enthalten. Event-Log Fehlercodes finden Sie im TFORMer Server.pdf.

Spool zeigt Error Code 0000006e oder 00000002

• Spool zeigt Error 0000006e mit normalen Drucker (Drucker konnte nicht initialisiert werden).
• Spool zeigt Error 00000002 mit PDF (Drucker konnte nicht initialisiert werden).

Diese Fehlermeldung kann auftreten wenn im Report ein Bild (Imagedatei) enthalten ist, das von TFORMer nicht gefunden wird. Das Verhalten bei fehlenden Bildern (abort/ignore/print) kann im TFORMerSDK_Config\TFORMer.xml eingestellt werden.

Spool zeigt Error Code 8002802b oder 000010D8

Die Fehlercodes bedeuten: 8002802b = Element not found, 000010D8 = Object not found.

Der Fehler tritt üblicherweise auf, wenn:

• Ein Datenfeld in den Importdaten (z.B. im Print-Server Script) keine Entsprechung im Formular aufweist – das übergebene Datenfeld wird also im Formular bzw. im Repository nicht verwendet.
• Prüfen Sie das Formular bzw. die Liste der Projekt-Datenfelder im Repository und vergleichen Sie mit der Liste der an den TFORMer Server übergebenen Datenfelder.

Man kann solche überzähligen Datenfelder ignorieren indem man im Repository die Einstellung Common – Undefined Datafields auf 0-Ignore setzt (z.B. für einen Datenbank-Select mit optionalen Werten).

Spool zeigt Error Code 800710D2

In den meisten Fällen entsteht dieser Fehler wenn ein neues Datenfeld im Formular eingefügt wurde (z. B. ein neues Barcode Datenfeld), aber das neue Datenfeld in der importierten Datei noch nicht enthalten ist.

Spool zeigt Error Code 8007000D

Das bedeutet dass die von Ihnen eingegebenen "Daten nicht zulässig bzw. ungültig" sind. Der TFORMer Server startet zwar den Druckvorgang, kann diesen aber nicht beenden. Zum Beispiel "30 von 54 Seiten wurden gedruckt".

Das Problem entsteht wenn Sie Daten eingeben die TFORMer nicht verarbeiten kann. In den meisten Fällen werden ungültige Daten für die Erzeugung eines Barcodes übergeben.

Zum Beispiel: ChargenNummer = "A1234 !" ; Die Chargen Nummer wird in einem Barcode mit dem Typ Code39 verschlüsselt. Das nicht zulässige Zeichen, in diesem Falle ein Rufzeichen "!", verursacht die Fehlermeldung. Das Verhalten bei Fehlern im Barcode kann im TFORMerSDK_Config\TFORMer.xml eingestellt werden.

Spool zeigt Error Code 8007001C

Der Fehlercode 8007001C bedeutet, dass sich im Drucker kein Papier mehr befindet.

Spool zeigt Error Code 3F5

Ursache: Sie versuchen ein bereits initialisiertes Datenfeld nachträglich zu ändern (Berechnungen davor/Berechnungen danach). Berechnete Datenfelder sind intern verwaltete Datenfelder und können von außen nicht übergeben werden (und umgekehrt).

Spool zeigt Error Code 8004300C

Im TFORMer Monitor wird der Fehlertext Aufgrund eines Fehlers wurde die angegebene Job-Datei nicht angenommen angezeigt. Im Event-Log findet sich ein Eintrag Fehler beim Schreiben der Ausgabedatei; Fehler: 80070050, die Datei ist vorhanden.

Ursache: Temporäre TFORMer Jobdateien (TECxxxx.tmp Dateien) können nach dem Einspoolen nicht gelöscht werden und bleiben im Temp Verzeichnis liegen. Sobald das Temp Verzeichnis mehr als 65535 Einträge (TFORMer Dateien) aufweist, bekommt man obige Fehlermeldung. Der Fehler tritt auf, wenn in der Jobdatei ein Fehler ist und diese nicht in das JobError Verzeichnis verschoben werden kann (evtl. fehlendes JobError Verzeichnis oder fehlende Rechte auf dieses). Weiters können auch fehlende Rechte auf den temporären Ordner die Ursache sein.

Spool zeigt Fehlercode 6D68

Der Fehler 6D68 (Drucker konnte nicht initialisiert werden) tritt üblicherweise bei der Schachtauswahl auf.

• Es ist ein Schachtname im TFORMer Layout oder in den Schachtzuordnungen definiert, den es auf dem Drucker nicht gibt.
• Es ist ein Format im TFORMer Layout oder in den Schachtzuordnungen definiert, den es auf dem Drucker nicht gibt.

Wenn es den Schacht oder Formatnamen auf dem Drucker nicht gibt, löst das einen Fehler bei der Druckerinitialisierung aus.

Lösungsmöglichkeiten:

• Es könnte sein, dass der Druckertreiber sprachspezifisch ist, d.h. man wählt „Fach 2“ und der Treiber kennt aber nur „Tray 2“ oder umgekehrt. In diesem Fall den Treiber mit der richtigen (einheitlichen) Sprache installieren.
• Statt mit Fach (Tray) 1, 2, 3 mit Formaten (DINA4, etc) arbeiten. Dafür sorgen, dass bei allen Druckern die gewünschten Formate verfügbar sind. Gegebenenfalls unter Druckservereigenschaften eine neues Formular (Papierformat) definieren.
• Im TFORMer individuelle Schachtzuordnungen hinterlegen (je Druckermodell/Gruppe eine separate Zuordnungstabelle) und beim Drucken die Zuordnung in der Jobdatei mitangeben. In der Zuordnung ist dann der richtige Schachtname je Druckermodell einstellbar. Siehe TFORMer Handbuch „Schachtzuordnungen“.

Spool zeigt Fehlercode 6

• Spool zeigt Error 00000006 (Drucker konnte nicht initialisiert werden), das Problem tritt bei allen Druckern auf.

Prüfen Sie bitte ob es im Master Repository Verzeichnis eine Datei "TFORMerServer.tfs_lock“ gibt. Wenn es diese gibt, bitte alle geöffneten TFORMer Designer schließen und diese Datei (wenn immer noch vorhanden) löschen. Weiters dafür Sorge tragen, dass nach dem Beenden des Printserver.exe Prozesses keine *.tfs_lock" Datei im Production Repository mehr liegt. Danach den Server (bzw. nur den Prozess) neu starten und prüfen ob das Problem immer noch auftritt.

Die „tfs_lock“ Datei sperrt das Repository zur Bearbeitung sobald ein TFORMer Designer oder TFORMer Server das Repository öffnet. Ein nicht ordnungsgemäß geschlossener Designer kann diese Datei stehen lassen und dann beim nächsten Start des Servers das Öffnen des Repositories blockieren.

Systemspezifische Fehlercodes

Fehlercodes, die über Betriebssystemaufrufe rückgemeldet werden (Windows Error Codes) sind bei Microsoft ersichtlich: System Error Codes

Wie kann ich das Logging aktivieren?

Das Logging wird in der Registry aktiviert:

Logging Printserver (Jobs empfangen, Jobs verwalten, Jobs in Druck geben)

Registry:

• HKEY_LOCAL_MACHINE\SOFTWARE\TEC-IT\PrintServer\CurrentVersion\TRACE
• TRACEFILE auf 1 setzen.
• TRACELEVEL auf 1b (Hexadezimal) setzen

Auf 64 Bit Systemen den SOFTWARE\Wow6432Node Key beachten!

Zusätzlich in Versionen vor V6

Logging TECLabelPrint (Datenfelder setzen, Druckvorgang durchführen)

Registry:

• HKEY_LOCAL_MACHINE\SOFTWARE\TEC-IT\TECLabelPrint\CurrentVersion\TRACE
• TRACEFILE auf 1 setzen.
• TRACELEVEL auf 1b (Hexadezimal) setzen.

Die Registryeinstellungen werden nur nach einem Prozess-Neustart gelesen. Entweder den TEC-Launcher Service beenden (30 Sek. warten bis Printserver.exe Prozess im Taskmanager verschwindet) und wieder neu starten oder den Printserver.exe Hauptprozess im Taskmanager beenden (wenn gerade nichts gedruckt wird!). Im eingestellten Trace-Pfad (z.B. C:\ProgramData\TEC-IT\TFORMer Server\6.1\Log\) sollten danach zwei Logdateien sichtbar werden. Der Wert von TRACEPATH muss mit einem Backslash abgeschlossen werden.

Neustart Probleme mit HP Universal Print Driver

Folgendes Problem kann auftreten, wenn zuvor über einen HP Universal Print Treiber ausgedruckt wurde und ein Prozess hpmup081.bin im Taskmanager aktiv ist.

Nach einem Neustart über Spooladmin oder über TECLauncher Service Restart kommt der Print Server nicht mehr hoch. Im Eventlog finden sich Meldungen wie:

• PrintServer is already running. The just started instance is exiting. Please check if the DCOM-rights are adjusted correctly.
• Could not create "User Listener Mailslot". Mailslot: \\.\mailslot\PSMS_To Error : 800700B7, Cannot create a file when that file already exists.

Ursache: Der vom HP Treiber aktivierte hpmup081.bin Prozess übernimmt die Mailslot- Handles des Printservers und gibt diese nicht mehr frei. Sind diese Mailslots bereits belegt, kann der Printserver nicht hochstarten.

Workaround: Den Prozess hpmup081.bin im Taskmanager beenden und danach den Printserver restarten. Als Lösung die Version 4.7.2+ des HP Universal Treibers installieren. Die neue Version behebt explizit dieses Problem.

Wie kann ich TFORMer Server Remote neu starten?

Entweder über DCOM mit diesem Script (TFORMer Monitor muss auf dem Client installiert sein):

VBScript:

Dim ps
set ps = CreateObject("PrintServer.COMPrintServer", ServerNameOrIPAddress)
ps.Restart

VB:

Dim ps As PrintServerLib.ComPrintServer ‘References auf Printserver Library muss eingestellt sein
Set ps = CreateObject("Printserver.ComPrintServer", ServerNameOrIPAddress)
ps.Restart

Oder über eine Druckjobdatei mit diesem Inhalt (ab V6.0.1):

DefineScript;
ENDSERVER;

Bitte beachten Sie: Der TECLauncher Dienst muss auf dem betroffenen Server laufen, um den TFORMer Server nach dem Herunterfahren wieder neu zu starten.

Die Lizenzdatei wird nicht gelesen

Die PrintServer.ini Datei ist an die TFORMer Server Version und an die Anzahl der freigeschalteten Drucker angepasst. Zur Lizenzierung die INI Datei in den folgenden Pfad kopieren und dann den TFORMer Server neu starten:

C:\ProgramData\TEC-IT\TFORMer Server\8

Wie kann ich bei einem PDF Druckertyp den Dateinamen dynamisch steuern?

Hierfür zeigen wir Ihnen zwei verschiedene Möglichkeiten:

a) Den Dokument Namen über eine Expression im Formular setzen: Dabei holt man sich über die Systemvariable Device das Verzeichnis und ergänzt dann den Dateinamen über einen variablen Ausdruck.

• Unter Eigenschaften ➔ Gerät das Prefix für den Pfad setzen.
• Danach über eine Expression in der Formular/Reporteigenschaft Dokument Name (im Layout) einen dynamischen Dateinamen anhängen.
• Zum Beispiel kann man einen Zeitstempel dazuhängen, woraufhin der Dokumentenname den vollen Pfad ergibt: Device + Format(Now(), "yymmdd-HHmmss") + ".pdf"
• Um Überschreibungen zu verhindern, kann man eine Zusatzidentifikation (als Prefix, Suffix, im Prinzip jedes Datenfeld möglich) dazugeben.

b) Den Dokument-Namen über ein externes Datenfeld tfDokumentName von außen setzen:

• Der tfDokumentName ist ein System-Datenfeld, das nicht extra angelegt werden muss.
• Dieses externe Datenfeld wird automatisch an das Device angehängt.

Wie kann ich feherhafte Jobdateien regelmässig löschen?

Enthält das JobError Verzeichnis mehr als 65535 Dateien, können fehlerhafte Dateien nicht mehr aus dem überwachten Spool-In Verzeichnis heraus verschoben werden. Das führt zu Stabilitätsproblemen, da fehlerhafte Jobs stehen bleiben und mehrfach eingelesen werden.

Richten Sie im Windows Task Scheduler ein Clean-Up Script ein, in dem Sie das Verzeichnis regelmässig von alten TMP Dateien befreien - hier ein Beispiel, das alle Dateien älter als 60 Tage löscht: