Error codes and exceptions

The following topics describe the errors and exceptions, which may occur when the Control‑M/EM API is being used. Errors and exceptions can be divided into the following groups:

• Errors and exceptions that are caused by Control‑M/EM API
• Errors and exceptions that are caused by faulty formatting in the XML request file
• Errors and exceptions that are caused by the presence of incorrect data in the XML request file
• Errors and exceptions that are caused by Control‑M/EM or the Control‑M installation

  NOTE: Control‑M/EM API errors are also listed in the EMAPIMessages.txt file located in the home directory of the Control‑M/EM installation.

Each error is composed of the following information:

• Major code

  Integer that represents a family of related errors or exceptions.

• Minor code

  ID code unique to each error.

• Severity

  Indicates how critical the error is. Severity also determines the way that the Control‑M/EM API handles the error.

• Description

  Text description of the error, returned as a string when an exception is thrown.