Log File

Log file

REPORTER creates a log file as it runs. This log file shows how REPORTER is trying to run programs, how it is creating images, and so on. If any errors or warnings are encountered, they will be written to the log file. This helps you solve any problems. The log file is accessible from Logfile in the Help menu. A typical log file window is shown below.

Clicking Clear will empty the log file contents. You can save the contents of the log to a text file using the Save As... option.

When generating a report (or page, or selected items), if Check for errors during report generation is checked (the default), then if an error is encountered, the Logfile window will appear. This gives you the opportunity to examine the error before choosing whether to Stop , Continue , or Continue to end :

You can navigate up and down through the errors and warnings in the log file using the controls provided. If you choose Stop , the report generation will stop, allowing you to fix the error immediately. If you choose Continue , generation will continue, and the Logfile window will reappear if another error occurs. If you choose Continue to end , generation will continue to the end without showing you the Logfile window again if further errors occur.

You can prevent the Logfile window from appearing when an error occurs by unchecking Check for errors during report generation . In this case, you will still be asked at the end of generation if you would like to inspect the log file:

The Logfile window also has some additional options for PRIMER , D3PLOT , and T/HIS items. Selecting Include debug information from PRIMER , D3PLOT , and T/HIS will request extra debug messages to be sent back to the REPORTER log file during generation. This can help debug problematic items. Selecting Don't automatically exit from PRIMER , D3PLOT , and T/HIS after item generation will mean that those programs will remain open, allowing you to check what has happened before manually exiting them to proceed with the rest of the report generation.

The following options are automatically saved to your REPORTER preferences upon selection:

• Include debug information from PRIMER , D3PLOT , and T/HIS
• Don't automatically exit from PRIMER , D3PLOT , and T/HIS after item generation
• Check for errors during report generation