RunCC.exe

1

The RunCC.exe file is created on a machine every time the acmp Agent is installed, but not when using the [[OneScanClient>>doc:ACMP.610.Arbeiten mit der ACMP Console.Clients erfassen.OneScanClient.WebHome]] (see Installing Clients).

2

3

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.

4

5

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.

6

7

The syntax is as follows:

8

9

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

10

11

12

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>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.Client Command Eigenschaften .WebHome||anchor="HOptions"]] or within the Client Command itself by right-clicking and selecting //Allow Interactive Use//.

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

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}

26

27

runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Dir=Temp

28

29

runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Var1=25 /v:Var2=“D:\“ /acmpclientservicetimeout=45

30

31

runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Pfad=“C:\Programme\ACMP“ /acmpclientservicetimeout=30

32

33

runcc.exe {3504E24A-0AC7-4BA6-B434-A8C4C0D4B6D2} /v:Pfad=“C:\Programme\ACMP“ /acmpclientservicetimeout=30 /additionalwaittime=10}}}

34

35

36

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

37

38

39

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.

40

41

42

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

43

44

45

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

46

47

The following returns are accepted:

48

49

|(% style="width:113px" %)**Exit-Code**|(% style="width:1251px" %)**Error message**

50

|(% style="width:113px" %)-3|(% style="width:1251px" %) A request is already in progress

51

|(% style="width:113px" %)-2|(% style="width:1251px" %) Client is retired

52

|(% style="width:113px" %)-1|(% style="width:1251px" %) Unspecified error

53

|(% style="width:113px" %)0|(% style="width:1251px" %) OK / Sucessfull execution

54

|(% style="width:113px" %)1|(% style="width:1251px" %) Header is improperly formatted

55

|(% style="width:113px" %)2|(% style="width:1251px" %) Authenticationheader is improperly formatted

56

|(% style="width:113px" %)3|(% style="width:1251px" %) Invalid encryption

57

|(% style="width:113px" %)4|(% style="width:1251px" %) Invalid ClientID

58

|(% style="width:113px" %)5|(% style="width:1251px" %) Session timed out

59

|(% style="width:113px" %)6|(% style="width:1251px" %) IP-Address and session do not match

60

|(% style="width:113px" %)7|(% style="width:1251px" %) Invalid SessionID

61

|(% style="width:113px" %)8|(% style="width:1251px" %) FunctionID is missing

62

|(% style="width:113px" %)9|(% style="width:1251px" %) FunctionID is unknown

63

|(% style="width:113px" %)11|(% style="width:1251px" %) Sendertype is not allowed

64

|(% style="width:113px" %)12|(% style="width:1251px" %) Authentication is required

65

|(% style="width:113px" %)13|(% style="width:1251px" %) Not enough rights

66

|(% style="width:113px" %)14|(% style="width:1251px" %) Already logged in

67

|(% style="width:113px" %)15|(% style="width:1251px" %) Username and/or password is invalid

68

|(% style="width:113px" %)16|(% style="width:1251px" %) Server is busy

69

|(% style="width:113px" %)17|(% style="width:1251px" %) Outdated sender has been denied

70

|(% style="width:113px" %)18|(% style="width:1251px" %) Internal error

71

|(% style="width:113px" %)19|(% style="width:1251px" %) Database error

72

|(% style="width:113px" %)21|(% style="width:1251px" %) IP has been refused

73

|(% style="width:113px" %)22|(% style="width:1251px" %) Fileversions do not match

74

|(% style="width:113px" %)23|(% style="width:1251px" %) User is not licesned

75

|(% style="width:113px" %)25|(% style="width:1251px" %) Webinterface is not active

76

|(% style="width:113px" %)26|(% style="width:1251px" %) Client does not exist

77

|(% style="width:113px" %)27|(% style="width:1251px" %) Client not licensed for action

78

|(% style="width:113px" %)28|(% style="width:1251px" %) Failed to connect to acmp Server

79

|(% style="width:113px" %)29|(% style="width:1251px" %) Operation was aborted by user

80

|(% style="width:113px" %)30|(% style="width:1251px" %) Selected object could not be found. It was probably deleted from the server.

81

|(% style="width:113px" %)31|(% style="width:1251px" %) Element is locked by another user

82

|(% style="width:113px" %)32|(% style="width:1251px" %) Licensed amount of elements reached, action aborted.

83

|(% style="width:113px" %)33|(% style="width:1251px" %) Operation has been aborted

84

|(% style="width:113px" %)34|(% style="width:1251px" %) No new data version found

85

|(% style="width:113px" %)35|(% style="width:1251px" %) Invalid request

86

|(% style="width:113px" %)36|(% style="width:1251px" %) Element already exists

87

|(% style="width:113px" %)37|(% style="width:1251px" %) Upload failed

88

|(% style="width:113px" %)38|(% style="width:1251px" %) Compression failed

89

|(% style="width:113px" %)39|(% style="width:1251px" %) Max amount for this element type has been reached

90

|(% style="width:113px" %)40|(% style="width:1251px" %) Action is prohibited because multi tenancy is acitve

91

|(% style="width:113px" %)41|(% style="width:1251px" %) Result contains too many items

92

|(% style="width:113px" %)42|(% style="width:1251px" %) acmp license is invalid

93

|(% style="width:113px" %)43|(% style="width:1251px" %) Partial stages of the request were successful

94

|(% style="width:113px" %)44|(% style="width:1251px" %) Could not delete selected element

95

|(% style="width:113px" %)100|(% style="width:1251px" %) Nothing done.

96

|(% style="width:113px" %)101|(% style="width:1251px" %) Client has been closed unexpectedly.

97

|(% style="width:113px" %)102|(% style="width:1251px" %) Syntax error. Command requires at least one parameter.

98

|(% style="width:113px" %)103|(% style="width:1251px" %) Syntax error. Variable parameters are incorrect.

99

|(% style="width:113px" %)104|(% style="width:1251px" %) First parameter must be a GUID. Please type a command GUID after the run-command.

100

|(% style="width:113px" %)105|(% style="width:1251px" %) Could not find an acmp Client. Maybe the client is not started.

101

|(% style="width:113px" %)106|(% style="width:1251px" %) Client Command execution is not possible on Windows NT 4.0, if acmp client is running as application.

102

|(% style="width:113px" %)107|(% style="width:1251px" %) The following parameter is a system variable and can not be edited by a Client Command.

103

|(% style="width:113px" %)108|(% style="width:1251px" %) Invalid parameter

104

|(% style="width:113px" %)109|(% style="width:1251px" %) acmp Client is not in a Container

105

|(% style="width:113px" %)110|(% style="width:1251px" %) acmp Client service is not running

106

|(% style="width:113px" %)1001|(% style="width:1251px" %) Error during Client Command execution

107

|(% style="width:113px" %)1002|(% style="width:1251px" %) Execution skipped. Condition evaluated to false

108

|(% style="width:113px" %)1003|(% style="width:1251px" %) Client Command was not marked as interactive

109

|(% style="width:113px" %)1004|(% style="width:1251px" %) Client Command was not available for execution

110

|(% style="width:113px" %)1005|(% style="width:1251px" %) Not enough licenses to execute Client Command

111

|(% style="width:113px" %)1006|(% style="width:1251px" %) Unexpected error

112

|(% style="width:113px" %)1007|(% style="width:1251px" %) Empty or unknown

113

|(% style="width:113px" %)1008|(% style="width:1251px" %) Unexpected server error during Client Command execution

114

|(% style="width:113px" %)1009|(% style="width:1251px" %) Unexpected error during Client Command execution

115

|(% style="width:113px" %)1010|(% style="width:1251px" %) Server is busy

116

|(% style="width:113px" %)1011|(% style="width:1251px" %) Client Command execution was canceled by user

117

|(% style="width:113px" %)1012|(% style="width:1251px" %) Execution timed out

118

|(% style="width:113px" %)1013|(% style="width:1251px" %) Script was disabled

119

|(% style="width:113px" %)1014|(% style="width:1251px" %) Client update is necessary

120

|(% style="width:113px" %)1015|(% style="width:1251px" %) No released Client Command Version available on Distributed File Repository

121

|(% style="width:113px" %)1016|(% style="width:1251px" %) No Distributed File Repository available for this Client

Wiki source code of RunCC.exe

Navigation