Viewing and configuring logging

The role M3BE-FndAdmin is required for configure logging and log levels for jobs for other users. Users with the role M3BE-FndUser can view their own jobs and job logs but require the role M3BE-LogEnabler to also configure logging and log levels.

  1. Click Administration Tools > Business Engine Jobs.
  2. Right-click or mark a job from the list and select Logging > Configure Logging to modify, add, or delete log configuration for the job.
    1. On the Log Content tab, under Log levels, select the levels to enable logging for.
    2. On the Log Content tab, under Components, select the components to enable logging for.
    3. On the Log Content tab, under Concepts, select Enable concepts to enable concept logging and use the drop-down to select the concept names to enable.
    4. On the Advanced tab, select Show source location [Program.method:line] on each log line to include the Business Engine program, method, and line number that each log entry originates from.
    5. On the Advanced tab, specify filter entries to log only the calls that match one of the entries. Filtering is optional. If you specify no entries, everything is logged. Click Add filter entry to add an entry, and click the delete icon on an entry to remove it. You can specify a maximum of 20 entries. For each entry, specify these fields:
      • Program: the Business Engine program to match, for example MMS100.
      • Method: the method to match, for example PBCHK.
      • Line: the line number within the method. This field requires a method to be specified. Leave it blank to match all lines.
      • Depth: the maximum call depth from the log statement. Leave it blank for no limit.

      Each entry must specify at least a program, a method, or a line number. A blank field matches any value. In the Program and Method fields, you can use an asterisk to match any sequence of characters and a question mark to match a single character.

      For example, MMS* matches all programs with names that start with MMS, and *CHK matches all methods with names that end with CHK. The values are case-sensitive.

    6. On the Advanced tab, use Backlog size to select the number of log entries to keep in the backlog.
    7. Select Log to file to save all log entries to a file on the host where the job is running. The file contains all log entries, not only the backlog, and is prefixed by JOBLOG-. You can download the file on the Business Engine Logs page.
    8. Click Save to save the log configuration or click Delete to delete an existing log configuration.
  3. Right-click or mark a job that has logging configured and select Logging > View log to view the backlog of the job.
    1. Optionally, you can disable the Refresh automatically check box to stop refreshing the backlog while viewing it.
    2. Filter by Time, Level, or Message to display specific log entries.
    3. Click Export to download the displayed log entries as text file.