Die Datei RunCC.exe wird bei jeder Installation des ACMP Agenten auf einem Rechner hinterlegt, jedoch nicht bei der Nutzung des OneScanClient (siehe Installation von Clients). Diese Datei dient dazu, Client Commands auszuführen. Dadurch haben Sie die Möglichkeit, ein Client Command z.B. aus einem Loginskript heraus aufzurufen. Ein solcher Aufruf benötigt zusätzlich die ID eines Client Command. Die Angabe von Variablen ist optional. Sie haben ebenfalls die Möglichkeit, RunCC.exe mit einem zusätzlichen Parameter n Sekunden lang warten zu lassen, wenn RunCC.exe z.B. in einem Login Skript eingetragen ist und der Client Dienst noch nicht auf "Started" steht. Die Syntax lautet wie folgt:
runcc.exe Client-Command-GUID [/v:Variablenname=Variablenwert] [/acmpclientservicetimeout=n] [/additionalwaittime=m]
Hinweis: |
Wird der Status "Started" vom Client Dienst schon eher erreicht, so wartet RunCC nicht den MaxTimeout ab, sondern läuft direkt weiter. |
Hinweis: |
Mit dem Parameter /additionalwaittime kann eine zusätzliche Wartezeit vor der Ausführung des Client Commands angegeben werden. Gibt man keinen Wert an, wird der Standardwert (0 Sekunden) genutzt. Gibt man sowohl einen Wert für /acmpclientservicetimeout und /additionalwaittime an, so ist die Wartezeit gleicher der Summe beider Werte. |
Ein paar Beispiele:
runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2}
runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Dir=Temp
runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Var1=25 /v:Var2=“D:\“ /acmpclientservicetimeout=45
runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Pfad=“C:\Programme\ACMP“ /acmpclientservicetimeout=30
runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Pfad=“C:\Programme\ACMP“ /acmpclientservicetimeout=30 /additionalwaittime=10
Hinweis: |
Die ID ist in den Eigenschaften jedes Client Command einzusehen. |
Wenn man Client Commands zur Installation / Deinstallation einer Software aufruft, ist darauf zu achten das dafür die Variable ACTION=uninstall bzw. ACTION=install angegeben wird. Gibt man stattdessen den Parameter INSTALLMODE=uninstall an, so wird aufgrund des CC-Skripts eine Installation durchgeführt.
Hinweis: |
Die Variable ACTION ist Bestandteil aller Client Commands, die mit dem Package Wizard erstellt wurden oder über die Package Cloud zu beziehen sind. |
Rückgabewerte
Nach dem Ausführen von RunCC.exe über die Befehlszeile erhalten Sie immer einen Rückgabe-Code und eine kurze Beschreibung.
Folgende Rückgaben sind möglich:
Rückgabe-Code |
Beschreibung |
0 |
Client Command erfolgreich ausgeführt |
1 |
Unbekannter Fehler auf dem Client |
2 |
Bedingung für das Client Command nicht vollständig |
3 |
Das gewählte Client Command darf keine interaktiven Dialoge anzeigen |
4 |
Das gewählte Client Command konnte auf dem Server nicht gefunden werden |
5 |
Die verfügbaren Lizenzen reichen nicht aus, um das Client Command auf diesem Client auszuführen |
6 |
Unerwarteter Fehler, z.B. TCP Probleme |
7 |
Client Command ist unbekannt oder leer |
8 |
Server %s wurde nicht gefunden |
9 |
Ein Fehler trat während der Client Command Ausführung auf |
10 |
Der ACMP Server ist beschäftigt |
11 |
Ausführung durch den Benutzer abgebrochen |
12 |
Zeitüberschreitung der Verbindung |
13 |
Client Command ist keine ausführbare Version |
14 |
Der ACMP Client muss ein Update durchführen, bevor das Client Command ausgeführt werden kann |
100 |
Es ist nichts passiert |
101 |
Client wurde unerwartet geschlossen |
102 |
Syntaxfehler: Das Client Command erfordert einen Parameter |
103 |
Syntaxfehler: Die Variablen sind falsch |
104 |
Der erste Parameter muss die GUID sein. Bitte geben Sie ein gültigen Command ein. |
105 |
ACMP Client konnte nicht gefunden werden. |
106 |
Client Command Ausführung ist unter Windows NT 4.0 nicht möglich, wenn der ACMP Client als Anwendung ausgeführt wird. |
107 |
Der folgende Parameter ist eine systemvariable und kann durch ein Client Command nicht geändert werden. |
110 |
Der ACMP Client Service ist nicht aktiv |
Zuletzt bearbeitet am 02.02.2017