Logtool Specifications

Hewlett-Packard STM: Logtool ERS * Revision 1.17
- Page 17 - Printed: 02/04/99 3:38 PM
4.1.2. Format Raw
This command is used to format any raw log files that were previously selected
via the Select Raw command under the File menu. If no files were selected, the
current raw log file, if there is one, is used as the default. Depending on how
much data is in the selected files, the Format Raw command may take several
minutes to complete. If more than one file was selected, all the log entries from
all the files will be formatted on a per-file basis and concatenated in one
continuous flow into one formatted file.
The entries in the raw log will first be filtered according to any Format filter
settings. If no filters have been selected, all entries will be formatted. Refer to
the Filters Menu Section for more information. Entries which do not match the
filter will not be formatted. If the user wishes to format entries which were
previously filtered out, the filter should be changed and the log reformatted.
The header portion of each entry is architected and will be interpreted and
formatted into text by Logtool. The data portion of each entry is not architected
and will be interpreted and formatted into text by the appropriate log decoding
routine. If an appropriate log decoding program cannot be located for a particular
entry, the data portion of the entry will be formatted for display in hex by
Logtool.
The output file name is selected automatically based on the raw log file name.
The raw log file log1.raw becomes log1.fmtn where n is incremented every time
a format is done on log1.raw. This file naming convention for formatted log
files allows the user to generate several different formatted versions of a raw log
file, all presumably generated using different filters, and easily tell from which
raw log file they were generated. For example, log1.fmt1 and log1.fmt2 were
both formatted from the same raw log file --log1.raw. In the case where
multiple files were selected to be formatted together, the filename will have a
plus sign, “+”, in it. For example, log1.raw and log2.raw would be formatted
into the file log1+.fmt1.
When the OK button is selected, the user then selects a directory into which to
place the formatted log file. The default log directory is supplied. The format
process is then invoked and once the format process is complete, the filename
where the output was placed will be displayed in Logtool’s main window. Once
formatting is complete the formatted log summary is automatically displayed.
The formatted file automatically becomes the selected formatted file that will be
displayed or summarized by the Formatted Summary and Formatted Log
commands under the View menu. See the following figures for samples of the
dialog screens presented during the Format Raw process.