Errors during Execution
- Catchable errors
These errors are catchable by a try-catch statement, but it is not necessary. If the error is caught then the execution continues in the associated catch statement. If the error is not caught immediately it will escalate up the call hierarchy. If there is no try-catch statement in the call hierarchy the host or instance specific job will have the status "failed".
Catchable errors are expected in the sense that they are runtime errors which may occur.
- Uncatchable errors
These errors are not catchable by a try-catch statement. The error will escalate up the hierarchy and the or specific will have the status "failed".
Uncatchable errors are unexpected in the sense that they should not occur during execution but may for technical reasons.
The following table lists errors which may occur and shows if the error is catchable:
... if the operating system information could be retrieved from the agent but could not be saved successfully.
... if the agent has the wrong version number after having been initialized.
|Invalid Substitutions in agent scripts||... if an agent script could not be parsed successfully during host initialization.|
... if a host no longer exists after a lock has been released.
... if a host cannot be connected after a lock has been released.
... if a deadlock occurs.
... if a gateway is not initialized when evaluating the path to the agent.
... if the agent must be updated but this the automatic update is either deactivated on server or agent configuration
... if the update fails due to technical reasons or communication fails.
|Execution||Failed execNative execution|
... if the successCriteria of the execNative fails, e.g. return code or output mismatch the expected value.
... if the working directory of the execNative does not exist.
|Process execution abortion||... if the process execution is aborted due to technical errors or communication errors.|
|Invalid Substitution||... if a substitution cannot be resolved because the variable does not exist on the host, host type, or instance.|
|Raise statement||... if a raise statement is executed.|
|Limit to Host Set||... if during plan or component method execution the "limit to host set" restriction is no longer valid.|
|Plan execution||... if a plan no longer exists when execution starts.|
... if a parent host could not be determined.
... if the root host could not be determined.
|Component||Component method execution|
... if a method should return a value, but it doesn't.
... if the method signature does not match with the caller.
... if the requested component could not be retrieved during installation.
... if the variable set could not be retrieved during component installation.
|System Service installation||... if the manual installation of a system service is attempted.|
... if the uninstallation of an instance failed because the targetable host could not be deleted, e.g. it does not exist.
... if the uninstallation of an instance failed because the instance could not be deleted, e.g. there are still references to the instance.
... if a component reference cannot be resolved.
... if the installation of an abstract component reference is attempted.
... if a component dependency is not met during checkDependency.
... if a component dependency could not be created with createDependency.
... if createDependency creates a duplicate dependency.
... if there are duplicate variables with the same name in the current context.
... if the access to a variable marked as a password was attempted.
... if a variable cannot be resolved because it was not initialized.
... if the modification of a non-mutable variable was attempted.
... if a targetable host cannot be created, e.g. duplicate host name.
... if a targetable host cannot be deleted, e.g. it is still being referenced.
... if errors occur during the preparation of resource transfer to the agent, e.g. checksum failures.
|Cancellation||Expired process or job timeouts||... if the job was cancelled by job timeout or process timeout.|
|User cancellation||... if the job was cancelled manually.|
|Miscellaneous||Nesting depth||... if the maximum nesting depth of the call hierarchy is reached.|