Log Viewer allows you to see messages contained in the log file and the trace file for the connector. You can sort and filter the output display as well as print, save, and email copies of the file. Logging and tracing options, as well as the location of the generated files, are specified as a properties in the connector's configuration file.
To start Log Viewer, you can do either of the following:
Using the Log Viewer menu options, you can perform the following tasks:
Log Viewer, displaying a sample log file is shown in Figure 24.
Figure 24. Log Viewer with sample log.
The User Configuration Options, General properties dialog box displays (see Figure 25).
Figure 25. Log Viewer User Configuration Options, General Properties screen.
This dialog lets you specify how to display the log file when you open it. The available choices are:
The User Configuration Options, Format properties dialog box displays (see Figure 26).
Figure 26. Log Viewer User Configuration Options, Format Properties screen.
This dialog lets you specify how to display the log messages. The available choices are:
The User Configuration Options, Columns properties dialog box displays (see Figure 27).
Figure 27. Log Viewer User Configuration Options, Columns Properties screen.
This dialog lets you specify which columns display in Log Viewer as follows:
The View menu contains additional options to change Log Viewer displays. From that menu, you can:
The filtered output can be toggled on or off with the Filter Toggle button on the view's toolbar.
Several options are available for controlling Log Viewer output. The File menu contains options for print previewing, printing, saving, refreshing the display, sending email, and determining the style for page setup, headers, and footers. The variables for header and footers are as follows:
Variable name | Description |
---|---|
$F | Name of file |
$A | Application name |
$P | Page number |
$N | Total number of pages |
$D | Date (can be followed by additional parameters (for example $D{%y:%h:%m}) |
To filter the messages that will be displayed in Log Viewer, choose
View->Filter->Use Filterfrom the Log Viewer view's
drop-down menu. The Filter Settings dialog displays categories that
correspond to the parameters of the logging message format. Message
format parameters are listed in Table 10.
Table 10. Message format parameters for log file.
Variable | Description |
---|---|
Time | Timestamp: the date of logging in the format year/month/date time. |
System | For connectors using the WMQI integration broker, system is the application-specific component of the connector. |
Thread | Thread name and thread ID. |
Name | The name of the component, such as ClarifyConnector. |
MsgType | Indicates the severity of the message. See Table 11. |
MsgID | The message number. |
SubSystem | The connector name. |
BO | The business object name. |
MsgText | The associated text for the message number. |
BOD | Business object dump. The data contained in the business object. |
In the Filter Settings dialog you first choose the filtering categories that you want to use. Then you select the specific items that you want to display from each category and choose which filters you want to activate for your current Log Viewer display.
Follow these steps:
You can use the buttons below the list box to select or deselect all the displayed items or to invert your current selection choices.
Note that in addition to filtering according to the categories, you can also display only those messages that contain a specific text string. To do so, select Messages under Set up Filters, enter the specific text for which you want to show messages, and check the box for Message under Activate Filters.
Table 11 describes the types of messages issued by WebSphere Business Integration Adapters.
Message type | Description |
---|---|
Info | Informational only. You do not need to take action. |
Warning | A default condition chosen by InterChange Server. |
Error | A serious problem that you should investigate. |
Fatal Error | An error that stops operation and should be reported. |
Trace | Tracing information for the trace level specified. |
Flow Trace | Flow tracing information for business objects. |
Internal Error | A serious internal problem that should be investigated. |
Internal Fatal Error | An internal error that stops operation. It should be reported. |