IBM Enterprise Console manual Format File, Starting the Adapter, UnmatchLog

If a file truncates while the adapter is active, the adapter automatically resets its internal pointer to the beginning of the file. If during the polling interval the file is overwritten, removed, or recreated with more lines than the previous poll, only the number of lines greater than the previous line count is read. For example, the file has one line. After the poll interval elapses, the file is overwritten with two lines. Only the second line is read on the next polling.

UnmatchLog

Specifies a file to log discarded events that cannot be parsed into an IBM Tivoli Enterprise Console event class by the adapter. The discarded events can then be analyzed to determine if modifications are needed to the adapter format file.

Format File

The format file contains message format descriptions and their mapping to BAROC events. The message fields of an OS/2 event are matched against the format descriptions in this file and when a match succeeds, the corresponding IBM Tivoli Enterprise Console event is generated by the adapter. The format file contains predefined mappings for some common OS/2 events and can be customized to add any new messages.

The OS/2 adapter extracts the following information from an FFST event:

vDate of the event

vName of the host that issued the event

vProcess name associated with the event

vSeverity of the event

vProbe ID

vModule name

vMessage text

For details about format files, see “Format File” on page 17 and Appendix B, “Format File Reference” on page 145.

Starting the Adapter

By default, the adapter is started when OS/2 is started. To manually start the adapter, perform the following steps from the OS/2 desktop:

1.Open the System folder.

2.Open the Startup folder.

3.Double-click the TEC Adapter icon.

Note: The endpoint version of the adapter is started when the adapter configuration profile (ACP) is distributed using the Adapter Configuration Facility (ACF). Non-TME adapters are started during adapter installation.

80IBM Tivoli Enterprise Console: Adapters Guide