Viewing a background process log

You can display the content of the current physical log and archived log files that are associated with the background process you selected on the Background Process Monitor screen.

Each background process generates a log file. The log file has the same name as the background process with an extension of .log. The background process log file is saved in the directory where the application server starts. You can specify a different log file directory using the BkgLogDirectory parameter in the alwf_appl_parameters table. The value is the full path of the log directory.

See the Infor Expense Management System Administration Tool User Guide - Application Parameters for the BkgLogDirectory parameter.

You can define the directory by adding the BkgLogDirectory property to the Infor.cfg file, if your system includes multiple application servers that run on different machines and communicate to one database. The value is the full path of the log directory.

A list of current and archive log files is displayed at the top of the screen. New information is appended to the file until the specified size limit is reached. The log file is then renamed to the same name with a timestamp appended to the file and a new log file is created.

Note:  The limitation of the size for the log file is specified in the alco_background_process table.

The first log file listed at the top is the current physical log. The second log file and the subsequent log files are archived log files. These files have a timestamp as a part of the file name. For example, ReportAllocationBkg.7001.log.201110231630 is the archive log file created for the ReportAllocationBkg for server port 7001 created on October 23, 2011 at 4:30 p.m.

You can change the number of the log lines that display, by modifying the BkgLogDisplayLines parameter.

See the Infor Expense Management System Administration Tool User Guide - Application Parameters.

Note: You must have permission to view all the application parameters. You can contact the Super Administrator of the company, if you cannot view an application parameter you want to modify.

These are the log types in the log file:

  • E: Error messages provide information on processing errors that terminate the processing of a document or the entire process. You must review the error messages and resolve issues (if any).
  • W: Warning messages provide information on unusual conditions that can affect the processing of one document. For example, a warning message is displayed when the work item for a document cannot be checked out. The processing continues. However, you must review the warning messages and resolve issues (if any) to complete the processing of all the documents.
  • I: Information messages log status information about the process. These messages are not the result of the processing errors. For example, an information al message is displayed when the background process starts or stops.
  1. Select Manage > Servers > Background Process Monitor.
  2. Select a background process.
  3. Click Refresh to display the background processes.
  4. Click View Log.
  5. Review the log file. You can click a column name to sort the list.
    The log file is a text file with a timestamp and a message. The log file contains start and stop messages, as well as other information and error messages generated by the background process.

    To navigate through the logs files:

    • Click Previous, to display the previous set of log lines from the log file. If there are no previous set, only the first set of log lines is displayed.
    • Click Next to display the next set of log lines from the log file. If no logs are available, a message is displayed.
  6. Click Done to navigate through the logs files.