Logtool Specifications

Hewlett-Packard STM: Logtool ERS * Revision 1.17
- Page 30 - Printed: 02/04/99 3:38 PM
4.3. Commands within the Filters Menu
4.3.1. Format
This command is used to select the filter that will be used by Logtool to select
which entries in the selected raw log file(s) to format. In order to set the filter,
the user should first select a raw log file or files via the Select Raw command
under the File menu. If a file was not selected in this way then the current raw
log file, if there is one, is used as the default. Once a raw log file has been
selected, it is automatically summarized and only the items which actually occur
in the log file will be displayed as selections for filtering. These items will be
displayed in a dialog screen and the user can select as many items as desired. If
more than one file was selected, all the log entries from all the files will be
integrated together and treated as one file.
Once one or more items has been selected, subsequent Format Raw commands
(under the File menu) will only format entries which match the filter criteria. An
entry is considered to be a match for a particular filter field if it matches any of
the selected items that were set in that field. If a field has no items selected, any
entry will match that field. In order for an entry to pass through the filter, it must
match the criteria for all of the filter fields.
For example, if the user selects a product of Flex Disk and a product qualifier of
HPC2254B, only entries for HPC2254B Flex Disks will be formatted/displayed.
If the user selects a device path of 52 and a product of Flex Disk, no entries will
be formatted/displayed if there is not a disk drive associated with path 52. If the
user selects paths 52 and 0/28.2.0 and does not select items in any of the other
filter fields, all entries for paths 52 and 0/28.2.0 will be formatted/displayed.
The starting and ending date/time fields will initially contain the date/time of the
first and last log entries. All log entries which are logged on or after the starting
date/time and on or before the ending date/time will be formatted. The user can
modify either or both of these fields as desired.
The following figure shows the screen that is displayed in the GUI when the
Format command is selected. The figure is in two separate boxes for
documentation purposes only. The GUI displays the screen in one box with
scroll bars available if needed. The user can select various filter items and then
click on the OK button to return to the main menu. If the user wishes to exit
without changing the filter settings, the Cancel button should be used. The
Defaults button will undo any changes that have been selected.