RunCC.exe

1

Die Datei RunCC.exe wird bei jeder Installation des ACMP Agenten auf einem Rechner hinterlegt, jedoch nicht bei der Nutzung des [[OneScanClient>>doc:ACMP.68.Arbeiten mit der ACMP Console.Clients erfassen.OneScanClient.WebHome]] (siehe Installation von Clients).

2

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.

3

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.

4

5

Die Syntax lautet wie folgt:

6

7

{{{runcc.exe Client-Command-GUID [/v:Variablenname=Variablenwert] [/acmpclientservicetimeout=n] [/additionalwaittime=m]}}}

8

9

10

Wird der Status "Started" vom Client Dienst schon eher erreicht, so wartet RunCC nicht den MaxTimeout ab, sondern läuft direkt weiter.

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}

20

21

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

22

23

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

24

25

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

26

27

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

28

29

30

Die ID ist in den Eigenschaften jedes Client Command einzusehen.

31

32

33

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.

34

35

36

Die Variable ACTION ist Bestandteil aller Client Commands, die mit dem [[Package Wizard>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Paket Wizard.WebHome]] erstellt wurden oder über die Package Cloud zu beziehen sind.

37

38

39

Nachdem Sie die RunCC.exe über die Befehlszeile ausgeführt haben, erhalten Sie einen Exit-Code sowie eine kurze, englischsprachige Fehlermeldung.

40

41

Folgende Rückgaben sind möglich:

42

43

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

44

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

45

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

46

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

47

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

48

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

49

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

50

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

51

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

52

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

53

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

54

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

55

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

56

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

57

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

58

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

59

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

60

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

61

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

62

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

63

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

64

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

65

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

66

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

67

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

68

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

69

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

70

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

71

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

72

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

73

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

74

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

75

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

76

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

77

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

78

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

79

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

80

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

81

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

82

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

83

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

84

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

85

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

86

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

87

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

88

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

89

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

90

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

91

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

92

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

93

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

94

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

95

|(% 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.

96

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

97

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

98

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

99

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

100

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

101

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

102

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

103

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

104

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

105

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

106

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

107

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

108

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

109

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

110

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

111

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

112

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

113

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

114

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

115

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

Wiki source code of RunCC.exe

Navigation