Logtool Specifications

Hewlett-Packard STM: Logtool ERS * Revision 1.17
- Page 15 - Printed: 02/04/99 3:38 PM
4. Detailed Command Descriptions
4.1. Commands within the File Menu
4.1.1. Select Raw
This command displays the names of the raw log files that are currently on the
system and allows the user to select one or more of them for viewing, filtering or
formatting. The initial file filter is set to the default location and naming
convention for raw log files and the default file selection defaults to the current
raw logfile, if there is one. Users can access the default file, specify a file from
the files list presented, or they can specify a file of their own choosing. In this
case, caution should be exercised since only log files that were generated on the
host system should be formatted on that system. Attempts to format log files
from other systems may result in formatting problems or incorrect formatted
output. Once a formatted log is generated, it may be moved to other systems and
displayed without any problems.
When a raw log file is selected, it is automatically read and summarized by
Logtool, which may cause a short delay if the file is large or several files have
been selected. The summary data reflects totals of all log entries from all
selected files integrated together and treated as one file. This summary
information is then automatically displayed to the user. The summary can be
displayed independently at any time via the Raw Summary command under the
View menu. This summary information is used by Logtool to determine
appropriate values for fields that can be set in the raw display filter as well as in
the format filter. If the log file to which the logger is currently logging,
logn.raw.cur, is selected, the output of subsequent commands such as the Raw
Log command under the View menu or the Format Raw command under the File
menu may reflect additional records and/or counts that weren’t displayed
initially. This is because more errors may have been logged to the currently
active file since it was initially selected and read.
The following figure shows the screen that is displayed in the GUI when the
Select Raw command is selected. Note the current raw log file in this example
is shown as log2.raw.cur. If desired, users can enter a new file filter in the Filter
box and click on the Filter button when done. The new filter will then be applied
and a list of files that match will be displayed.
Users can change directories by simply clicking on the directories listed in the
Directories box. Once the correct directory has been selected, a file is selected
by clicking on its name in the Files box and clicking the OK button at the bottom
of the screen.