Modifying logging behavior

This procedure describes how to modify logging behavior. Log default settings are coded into Control‑M/EM API and these settings can be overridden by values supplied from an outside source.

You can supply additional parameters to extend logging capabilities. Any logging configuration information that you enter in the emapi_log.cfg file or in your project code must conform to Log4J specifications (as described in the Log4J documentation).

To modify the logging procedure:

• Do one of the following:
  • Create a file called emapi.log.cfg in the working directory of your application or project.

    When this file is present, the Control‑M/EM API automatically passes the information contained in the file to Log4J. For an example, see Sample log configuration file.

  • Use your own code to pass information to Log4J. Control‑M/EM API uses the com.bmc.ctmem.emapi logging category to log data.

If you are modifying logging behavior, you need to indicate the priority of messages recorded in the log in your configuration file.