Skip to end of metadata
Go to start of metadata

Errors during Execution

There are different kinds of errors during the execution of a plan or a component method:

  • 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 host or instance specific job 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:

DomainErrorOccurs if...Catchable
 HostHost initialization

... 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.(error)
 Host Locking

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

 Agent Update

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

ExecutionFailed 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.(error)
 Invalid Substitution... if a substitution cannot be resolved because the variable does not exist on the host, host type, or instance.(tick)
 Raise statement... if a raise statement is executed.(tick)
 Limit to Host Set... if during plan or component method execution the "limit to host set" restriction is no longer valid.(tick)
 Plan execution... if a plan no longer exists when execution starts.(tick)
 Redirect host

... if a parent host could not be determined.

... if the root host could not be determined.

ComponentComponent method execution

... if a method should return a value, but it doesn't.

... if the method signature does not match with the caller.

 Component installation

... 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.(tick)
 Uninstall component

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

 Component references

... if a component reference cannot be resolved.

... if the installation of an abstract component reference is attempted.

 Component dependencies

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

 Variable Error

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

 Targetable host

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

 Resource handling

... if errors occur during the preparation of resource transfer to the agent, e.g. checksum failures.

CancellationExpired process or job timeouts... if the job was cancelled by job timeout or process timeout.(error)
 User cancellation... if the job was cancelled manually.(error)
MiscellaneousNesting depth... if the maximum nesting depth of the call hierarchy is reached.(error)




  • No labels