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 22.
Figure 22. Log Viewer
with sample log.
The User Configuration Options, General properties dialog box displays (see Figure 23).
Figure 23. 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 24).
Figure 24. 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 25).
Figure 25. 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 toolbar.
Several options are available for controlling Log Viewer output. In the File menu, there are options for print previewing, printing, saving, refreshing the display, sending to an email recipient, and determining the style for page setup, headers and footers. The variables for header and footers are:
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 menu bar. The Filter Settings dialog displays categories that correspond to the parameters of the logging message format. Message format parameters are listed in Table 9.
Table 9. 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 10. |
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 select the specific items that you want to display from each category, and then 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 all the displayed items, or to 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 10 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. |