CSRCurrent de:Exit Codes

Exit-Codes

Jede Anwendung erzeugt einen sogenannten Exit-Code, wenn sie beendet wird. Dieser gibt an, ob die Anwendung korrekt beendet wurde oder ob ein Fehler aufgetreten ist. Allgemein wird der Exit-Code '0' verwendet, wenn die Anwendung ohne einen Fehler beendet wurde. In allen anderen Fällen wird ein Code ungleich '0' verwendet. Dies ermöglicht es einem Entwickler, bei bestimmten Exit-Codes eine benutzerfreundliche Hinweisnachricht für den Benutzer anzuzeigen. Bei einem Exit-Code 0 wurde in jedem Fall ein Transfer erstellt, der abrufbar ist. Jedoch kann es sein, dass Fehler aufgetreten sind. So können beispielsweise Dateien durch die Vorverarbeitung entfernt worden oder andere Probleme aufgetreten sein. Sollen diese Fälle anders behandelt werden als ein vollständig erfolgreicher Transfer, kann der "strict"-Modus aktiviert werden. Dieser hat zur Folge, dass teilweise vollständige Transfers zu einem eigenen Fehlercode führen.

Wie Exit-Codes in Skripten verwendet werden können

Windows

Auf Windows-Systemen wird der Exit-Code in die 'Umgebungsvariable '%errorlevel%' geschrieben. Prüfen Sie diese Variable nach Ausführung des Robot, um zu ermitteln, ob ein Fehler aufgetreten ist oder nicht.

Exit-Code auf der Windows Kommandozeile ausgeben

echo %errorlevel%

Linux

Auf Linux-Systemen wird der Exit-Code in die Variable '$?' geschrieben. Prüfen Sie diese Variable nach Ausführung des Robot, um zu ermittlen, ob ein Fehler aufgetreten ist oder nicht.

Exit-Code auf einer Linux Konsole ausgeben

echo $?

Liste der vorhandenen Exit-Codes

Die Exit-Codes für den Cryptshare Robot können in 3 Kategorien unterteilt werden:

1. Exit-Codes für Fehler, die auf Serverseite aufgetreten sind
2. Exit-Codes für Fehler, die auf Clientseite (Robot) aufgetreten sind
3. Exit-Codes für Fehler, die aufgrund eines Syntaxfehlers in der Kommandozeile aufgetreten sind

Nachfolgend werden alle im Cryptshare Robot vorhandenen Exit-Codes aufgelistet.

---

The following table lists all exit codes which can occur when the Cryptshare Robot runs into an error.

Kategorie	Exit-Code	Kürzel	Beschreibung
1	10	NOT_LICENSED	The Cryptshare Server license does not grant the use of the Cryptshare Robot.
1	30	WRONG_USE	Wrong use of the Cryptshare service. The request cannot be handled.
1	40	MISSING_PARAMETER	The submitted request is missing a configuration parameter.
1	41	INVALID_DATA	The given data is not valid.
1	60	NOT_VERIFIED	This client or sender is not verified, and the requested operation is only allowed for verified clients and senders.
2	105	INIT_WSDL	Error initializing the client due to an invalid WSDL file that could not be parsed. This error can occur when the client is trying to access the Cryptshare Server using the HTTP protocol, but the server has "Force secure connection" enabled and therefore requires HTTPS access to get the valid WSDL file.
2	110	INIT_ERROR	Error initializing the client.
2	115	CLIENT_ID_ERROR	Error generating a Client ID.
2	120	INIT_WEBSERVICE_OPERATION_ERROR	Error initializing the web service.
2	130	PERFORM_WEBSERVICE_OPERATION_ERROR	Error performing the requested web service operation.
2	140	PASSWORD_ERROR	Error when generating a password.
2	170	INVALID_STORE	The Robot verification store has an error.
3	190	ILLEGAL_ARGUMENT_ERROR	Illegal argument error.
1	220	NOT_AUTHORIZED	The client is not authorized to use the requested service.
1	230	SERVER_ERROR	The Crypshare Server encountered an unspecified error. Check the server logs.
1	240	MAIL_ERROR	The Cryptshare Server encountered an error while trying to send or load the requested e-mail.
1	250	NO_SESSION	The specified session could not be found. The request is invalid.
1	260	PROCESSING_ERROR	A file processing error occured.
2	310	PROPERTY_FAILURE	The Robot detected a wrong or missing configuration parameter.
3	320	COMMANDLINE_PARSE	An error occurred while trying to parse the command line arguments.
2	330	CONNECTION_FAIL	Error connecting to the Cryptshare Server.
2	340	CRYPT_FAIL	An error occurred while trying to encrypt/decrypt a password.
3	350	URL_SYNTAX	Wrong URL syntax.
3	360	MISSING_OPTION	A command line option was missing.
2	370	PASSWORD	The password requirements are not fulfilled.
2	380	INVALID_FILE	The specified file could not be found or read.
2	400	NOFILES	No valid files are specified for the transfer.
2	410	INVALID_JAVA_VERSION	Incompatibe Java Runtime Version.
2	420	SERVER_QUERY_FAIL	An error occurred while trying to query something from the server.
2	430	TRANSFER_FAIL	An error occurred during the transfer of the files.
2	440	PARTIAL_TRANSFER_FAIL	An partial error occurred during the transfer of the files. This code will only be returned if the "strict"-mode is enabled.
2	-1	UNDEFINED	The cause for this error could not be determined. The Cryptshare Robot logs should be checked.
1	5000	UNKNOWN_ERROR	The cause for this error could not be determined. The Cryptshare Server logs should be checked.

---