Troubleshooting Eclipse Forms

Use the Administrator application to help troubleshoot form printing issues, such as when a form or document fails to print. Use the server status information available in the Administrator application to view error logs, which you can copy and paste and send to Eclipse personnel for troubleshooting purposes. In most cases, Eclipse personnel will walk you through the troubleshooting process.

For information about additional administrative features available in the Administrator application, see the online help provided with the Administrator application. The online help is viewable only if you use Internet Explorer.

Note: If your e-mail server generates a "502 Command Not Implemented" error, the Eclipse user does not see the error. The e-mail is still successfully sent.

To troubleshoot Eclipse Forms:

  1. From anywhere in the Administrator application, click the Runtime Servers tab to display a list of runtime servers.

  2. Select the process related to the form type that did not print. For example, if an invoice failed to print, select the queue specific to invoices.

  3. Do one of the following:

To...

Do this...

stop the Eclipse Forms server

click Stop.

Important: All forms at your site stop printing if you stop the Eclipse Forms server.

To restart the server, click Start.

view the log for a process

click Show to display the server's summary information. Use the submenu across the top to view different aspects of the server and its activity.

monitor process activity

click Show and then the Processes submenu

clear the selected error for a process from the list after it has been fixed

click Clear Error.

Clearing errors from the lists allows you to better see further errors or warnings that occur. Clearing an error from this list does not clear it from the log file.

stop the selected process

click Stop Selected. To restart the process, select the process in the list and clickStart Selected.

filter the processes shown

select the time frame you want to view in the Show Status For field and click Refresh.

  1. If you are receiving errors that you want to send to Eclipse personnel, copy the information, and send it in an email to your Eclipse support representative.

Note: To copy only a few lines in the Live Log Monitor window, click Pause first to freeze the contents of the window.

Using the Log Error Analyzer

The Eclipse Forms Activity Log Analyzer downloads the activity logs for Eclipse Forms and provides further details to review all in one area. When the system receives an error, such as an invoice failing, you can review why the transaction did not complete.

To display the Log Error Analyzer:

  1. From the System > System Files > Printer Setup > Eclipse Forms menu, select Eclipse Forms Diagnostics to display the diagnostics window.

  2. Click Error Log Analysis.

  3. Use the Start Date and End Date fields to indicate which time frame you want to review.

  4. If you want to limit the queue to a specific document type, in the Document Type field, select the document you want to see.

  5. Click Check for Errors Now.

The system displays the following columns for each error that it finds:

Column

Description

Document

Displays the type of documentation

Date

The day and time the system processed the document.

Time

User

The user who processed the document.

Error

The error received, such as "No Printer Specified."

  1. Double-click a line item to view the raw log and further information.

  2. Click Start Monitor Mode to Closedcomplete the fields to run the error log continuously to check the system for errors.

    • Run Indefinitely - Select to continuously run the error log to gather log data.

    • End Date / End Time - Enter a time frame for which to gather log data. For example, if you have issues with transactions during morning hours, you can have the system gather data during the 6:00AM to 10:00AM hours.

    • Load Interval (Mins) - Enter a minute interval by which to gather information.

Important: Continuous monitoring may slow down printing. We recommend caution when selecting the Run Indefinitely check box.

  1. Exit the window.

See Also:

Accessing the Eclipse Forms Administrator Home Page

Working with Logs in Eclipse Forms

Eclipse Forms Overview