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:
v Date of the event
v Name of the host that issued the event
v Process name associated with the event
v Severity of the event
v Probe ID
v Module name
v Message 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.
80 IBM Tivoli Enterprise Console: Adapters Guide