Webseiten-Werkzeuge

Benutzer-Werkzeuge


Hilfsprogramm c4pRemote.exe

Anforderung

In großen convert4print-Installationen sind oft Verwaltungs- und Überwachungssysteme vorhanden, die auch mit convert4print zusammenarbeiten sollen.

Die Überwachung der einzelnen convert4print-Netzwerkdienste wie Konverter/Gateway-Service und Management-Konsole ist in der Regel kein Problem, weil es sich um normale Dienste innerhalb des Windows-Systems handelt, für die es Standardmethoden der Überwachung und Steuerung (Starten, Beenden, Neustart, etc) gibt.

Auch die Überwachung der Fehlermeldung dieser Dienste ist eine Standardaufgabe, weil alle convert4print-Dienste Meldungen in der Ereignisanzeige des Windows-Systems absetzen. Auch dafür gibt es Standardmethoden der Überwachung.

Will man aber den Status eines einzelnen Konverter oder Gateways zu ermitteln und gegebenenfalls auch zu ändern, helfen die Bordmittel von Windows nicht weiter.

Realisierung

Für diesen Zweck liegt der convert4print-Installation ein kleines Hilfsprogramm c4pRemote.exe bei. Dieses Hilfsprogramm befindet sich standardmässig innerhalb des Installationsverzeichnisses. Das Programm muss immer auf dem Rechner ausgeführt werden, auf dem auch der abzufragende oder zu steuernde Konverter/Gateway-Service läuft.

Ein Aufruf des Programms über die Kommandozeile (DOS-Box (Eingabeaufforderung)) zeigt eine kurze Beschreibung, die möglichen Parameter und ein paar beispielhafte Aufrufe an. Auch die Rückkehrwerte des Programms sind aufgelistet.

c4pRemote V3.1  (c) 2010 by SPE Systemhaus GmbH

Description:
 Allows remote control of convert4print Converter/Gateway Server.
 Must run on the same machine as the Converter/Gateway Server.

Program options are:
 -[SsTtaq]  Remote command
            S - Start all converters/gateways
            s - Start single converter/gateway (-n)
            T - Terminate all converters/gateways
            t - Terminate single converter/gateway (-n)
            A - Abort all converters/gateways
            a - Abort single converter/gateway (-n)
            q - Query single converter/gateway (-n)
            m - Query main console
            b - Query backup console
 -n<name>   Full name of converter/gateway

Return codes:
    0 - Success
    1 - Not all converters/gateways started
    2 - Not all converters/gateways terminated

Return codes for query:
  100 - stopped, grey flag
  101 - idle, yellow flag
  102 - printing, green flag
  103 - waiting on license, cyan flag
  104 - waiting for printer, magenta flag
  105 - special operation mode, white flag
  106 - error, red flag
  110 - intervention required, blue flag
  111 - paper jam, blue flag
  112 - load paper, blue flag
  113 - toner low, blue flag
  114 - cover open, blue flag
  115 - offline, blue flag
  116 - network lost, blue flag
  117 - outbin full, blue flag

Return codes for console check:
  200 - functional, green flag
  201 - license ends soon, check it, green flag
  202 - red key must be reactivated, green flag
  203 - red key expired, update license file, green flag
  210 - not functional, red flag
  214 - lease time ends soon, red flag
  215 - console is incompatible, red flag
  216 - activate at least one console, red flag
  217 - license file needs an update, red flag
  220 - not configured, white flag

Return codes in case of error:
  -10 - No access rights for registry
  -11 - Service not running
  -12 - Converter or gateway not found
  -14 - Unknown program option
  -15 - Program option must start with a minus
  -16 - Can't access registry
  -17 - Can't start a single converter or gateway
  -18 - Can't terminate a single converter or gateway

Examples:
 c4pRemote -s -n"Labelprinter Production"
 c4pRemote -T
 c4pRemote -q -n"Systemprinter"
 c4pRemote -m
 c4pRemote -b

convert4print (R)  is a registered trademark
                   of SPE Systemhaus GmbH


Dieses Programm kann als Teil von Skripten und Agenten zur Remote-Steuerung aus Überwachungs- und Steuerungssystemen heraus eingesetzt werden.

Bemerkungen

  • Das Programm c4pRemote arbeitet ohne Wissen eines möglicherweise offenen Kontrollfeldes. Von daher können sich im Kontrollfeld recht ungewöhnliche Statusänderungen zeigen, die durch das im Hintergrund aufgerufene Programm verursacht sind. Insofern sollte man sich als Nutzer des Kontrollfeldes der Fremdsteuerung bewusst sein.
  • Das Programm c4pRemote selbst erkennt zur Zeit keine Mehrfachaufrufe. Sind mehrere Verwaltungs- oder Überwachungssysteme gleichzeitig im Einsatz, kann es zu unerwarteten Reaktionen kommen, da keine zeitliche Synchronisation beim Zugriff auf den Dienst stattfindet. Solche Fälle sollten grundsätzlich vermieden oder durch geeignete organisatorische Massnahmen ausgeschlossen werden.
  • Möchte man einen Konverter oder ein Gateway von einem anderen Rechner aus überwachen, kann das Programm c4pRemote.exe mit Hilfe des Tools 'PsExec' aus den Sysinternal Tools von Microsoft auch von diesem Rechner aus aufgerufen werden, wobei die Programmausführung von c4pRemote.exe dann immer noch auf dem Rechner stattfindet, auf dem der Konverter/Gateway-Service arbeitet.
convert4print/tips/tip22.txt · Zuletzt geändert: 2018-04-06 16:52 (Externe Bearbeitung)