Logtool Specifications

Hewlett-Packard STM: Logtool ERS * Revision 1.17
- Page 33 - Printed: 02/04/99 3:38 PM
4.3.2. Display --> Raw
This command is used to select the filter criteria that will be used by Logtool to
select which entries in the raw log file to display. 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
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 entries from all the files will be integrated together and
treated as one file.
Once one or more items has been selected, subsequent Raw Log commands
under the View menu will only display 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 more than one item in a field is
selected, any entry must only match one of the items. 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.
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 displayed. The user can
modify either or both of these fields as desired.
In addition to providing filtering on each of the header fields, the user may want
to enter a specific hex pattern to search for which can be used to further narrow
the entries to the exact ones that are of interest. If a search pattern is specified, it
will be applied in addition to any other fields that have been specified, but only
to the data portion of each entry. Thus, for a raw display operation, one could
search for the occurrence of a specific hex pattern using this facility. The user is
cautioned that specifying a search pattern may result in a noticeable delay
because each entry must be converted to its hex display and the search pattern
applied. When a search pattern is not used, entries whose header contents do not
pass the filter are not converted to their hex display in order to save time.
The following figure shows the screen that is displayed in the GUI when this
command is selected. The figures 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.