RunCC.exe
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 beispielsweise 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.
Nachdem Sie die RunCC.exe über die Befehlszeile ausgeführt haben, erhalten Sie einen Exit-Code sowie eine kurze, englischsprachige Fehlermeldung.
Folgende Rückgaben sind möglich:
| Exit-Code | Fehlermeldung |
| -3 | A request is already in progress |
| -2 | Client is retired |
| -1 | Unspecified error |
| 0 | OK / Sucessfull execution |
| 1 | Header is improperly formatted |
| 2 | Authenticationheader is improperly formatted |
| 3 | Invalid encryption |
| 4 | Invalid ClientID |
| 5 | Session timed out |
| 6 | IP-Address and session do not match |
| 7 | Invalid SessionID |
| 8 | FunctionID is missing |
| 9 | FunctionID is unknown |
| 11 | Sendertype is not allowed |
| 12 | Authentication is required |
| 13 | Not enough rights |
| 14 | Already logged in |
| 15 | Username and/or password is invalid |
| 16 | Server is busy |
| 17 | Outdated sender has been denied |
| 18 | Internal error |
| 19 | Database error |
| 21 | IP has been refused |
| 22 | Fileversions do not match |
| 23 | User is not licesned |
| 25 | Webinterface is not active |
| 26 | Client does not exist |
| 27 | Client not licensed for action |
| 28 | Failed to connect to ACMP Server |
| 29 | Operation was aborted by user |
| 30 | Selected object could not be found. It was probably deleted from the server. |
| 31 | Element is locked by another user |
| 32 | Licensed amount of elements reached, action aborted. |
| 33 | Operation has been aborted |
| 34 | No new data version found |
| 35 | Invalid request |
| 36 | Element already exists |
| 37 | Upload failed |
| 38 | Compression failed |
| 39 | Max amount for this element type has been reached |
| 40 | Action is prohibited because multi tenancy is acitve |
| 41 | Result contains too many items |
| 42 | ACMP license is invalid |
| 43 | Partial stages of the request were successful |
| 44 | Could not delete selected element |
| 100 | Nothing done. |
| 101 | Client has been closed unexpectedly. |
| 102 | Syntax error. Command requires at least one parameter. |
| 103 | Syntax error. Variable parameters are incorrect. |
| 104 | First parameter must be a GUID. Please type a command GUID after the run-command. |
| 105 | Could not find an ACMP Client. Maybe the client is not started. |
| 106 | Client Command execution is not possible on Windows NT 4.0, if ACMP client is running as application. |
| 107 | The following parameter is a system variable and can not be edited by a Client Command. |
| 108 | Invalid parameter |
| 109 | ACMP Client is not in a Container |
| 110 | ACMP Client service is not running |
| 1001 | Error during Client Command execution |
| 1002 | Execution skipped. Condition evaluated to false |
| 1003 | Client Command was not marked as interactive |
| 1004 | Client Command was not available for execution |
| 1005 | Not enough licenses to execute Client Command |
| 1006 | Unexpected error |
| 1007 | Empty or unknown |
| 1008 | Unexpected server error during Client Command execution |
| 1009 | Unexpected error during Client Command execution |
| 1010 | Server is busy |
| 1011 | Client Command execution was canceled by user |
| 1012 | Execution timed out |
| 1013 | Script was disabled |
| 1014 | Client update is necessary |
| 1015 | No released Client Command Version available on Distributed File Repository |
| 1016 | No Distributed File Repository available for this Client |