RunCC.exe

Last modified by Sabrina V. on 2026/07/30 11:33

The RunCC.exe file is created on a machine every time the ACMP Agent is installed, but not when using the OneScanClient (see Installing Clients).

This file is used to execute Client Commands. This allows you to call a Client Command, for example, from a login script. Such a call also requires the ID of a Client Command. Specifying variables is optional.

You also have the option to use an additional parameter to make RunCC.exe wait for n seconds if, for example, RunCC.exe is included in a login script and the Client service has not yet reached the “Started” status.

The syntax is as follows:

runcc.exe   Client-Command-GUID  [/v:variable nname= variable value] [/acmpclientservicetimeout=n] [/additionalwaittime=m]

Hinweis  Note:  

Please note that before a Client Command can be launched via RunCC, it must be enabled for interactive use. You can enable interactive use either in the Client Command Properties or within the Client Command itself by right-clicking and selecting Allow Interactive Use.

Hinweis  Note:  

If the client service reaches the “Started” status earlier, RunCC does not wait for the MaxTimeout to elapse but continues to run immediately.

Hinweis  Note:  

The /additionalwaittime parameter can be used to specify an additional wait time before the Client Command is executed. If no value is specified, the default value (0 seconds) is used. If values are specified for both /acmpclientservicetimeout and /additionalwaittime, the wait time is equal to the sum of both values.

Examples:

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  Note:  

The ID can be viewed in the properties of each Client Command.

When executing Client Commands to install or uninstall software, be sure to specify the variable ACTION=uninstall or ACTION=install. If you specify the parameter INSTALLMODE=uninstall instead, the CC script will trigger an installation.

Hinweis  Note:  

The ACTION variable is part of all Client Commands that were created using the Package Wizard or are available through the package cloud.

After you execute RunCC.exe from the command line, you will receive an exit code and a brief error message.

The following returns are accepted:

Exit-CodeError message
-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
© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community