samlog_viewer(1)samlog_viewer(1)NAME
samlog_viewer - a tool for viewing and saving the SAM logfile
SYNOPSIS
mmddhhmm[[cc]yy]] mmddhhmm[[cc]yy]] user] ofile] [file]
DESCRIPTION
The command enables the viewing of part or all of the SAM logfile (or
another file containing data in the same format) at varying levels of
detail. This tool is run by SAM whenever the option is chosen. It can
also be run independently of SAM, in either interactive or noninterac‐
tive mode.
The command executes in either interactive or noninteractive mode,
depending on the options given. In noninteractive mode, filters the
source file and writes the resulting data either to stdout or to a des‐
tination file. In interactive mode, displays a graphical user inter‐
face enabling you to try different combinations of filtering, save one
or more versions of the source file to other files, scroll back and
forth among the logfile entries, etc.
Under no circumstances is destructive to the contents of the SAM log‐
file (or whatever source file is specified by file). The contents of
the source file are filtered and displayed (or output) according to the
settings of the available filters. Multiple instances of can be run
simultaneously without harmful effects.
Filters
supports three types of filters: level of detail, date/time, and user
filters. These filters can be used in combination to provide highly
selective logfile viewing.
The level of detail filters control how much detail is displayed. The
SAM logfile may contain entries of many different types. The entry
types currently supported are: summary, detail, verbose, error, and
note. The level of detail filters display some or all of these entry
types, depending on which filter is chosen. The level of detail fil‐
ters are:
Displays only the higher level messages.
These include summary, error, and note
(warnings, other entries worthy of special
attention) entry types.
Includes level of detail, and adds detail log
entries. If no level of detail is speci‐
fied, this is the default.
Includes level of detail, and adds verbose log
entries.
Displays only the literal commands that were executed.
These commands may include HP-UX commands as
well as SAM commands and scripts.
The date/time filters are used to ask for entries written since a spe‐
cific date/time, before a specific date/time, or both.
The user filters are for viewing only those entries written by a par‐
ticular user. If invoked with the option, its argument is used as the
user whose entries should be shown.
If user filtering is selected by the option, displays only entries made
by that user and disallows any changes to the user filtering. This is
useful for allowing nonprivileged users to run and see only those
entries that pertain to them. Otherwise, allows the user filtering to
be changed, or completely disabled, from its interactive filtering
screen.
Options
The following options enable you to set up filtering and other
attributes. If runs interactively, these attributes may also be set
and modified in the various supported menus and displays. The avail‐
able options are:
The option sets the start date/time filter
to the date/time given by its argument.
The date/time is specified in the same
way as it is for the command (see
date(1)):
mm Month specified as a two digit
number (e.g.,
dd Day specified as a two digit
number.
hh Hour specified as a two digit
number (24-hour clock form).
mm Minute specified as a two digit
number.
cc Century minus one. cc is
optional when specifying the
year.
yy The last two digits of the
desired year. If this is not
specified, the current year is
used.
To specify a year in two digits,
the valid ranges are 70-99 (20th
century) and 00-37 (21st cen‐
tury).
To specify a year in four dig‐
its, the valid range is
1970-2037.
If no start time is given, the begin‐
ning of the log is used as the start
time.
The option sets the end date/time filter to
the date/time given by its argument.
The date and time is specified as
described above for the option. If no
end time is given, then an end
date/time of infinity (no end time) is
used.
The option sets the desired level of
detail. One of the letters must be
specified as the required argument.
The level of detail is set as follows:
If the option is not specified, the
level of detail is used by default.
The option sets the user filter to the user
name or user ID specified by user.
Only entries logged by this user are
displayed. If the option is omitted,
entries logged by all users are dis‐
played by default.
The option causes the filtered output to be
written to the output file ofile. The
option implies the option described
below. If ofile is the output is writ‐
ten to stdout. If is omitted, the out‐
put is written to either stdout (if is
specified) or to the interactive dis‐
play (if is omitted).
The option enables automatic timestamping.
If specified, each log entry is tagged
with the time of day at which it was
written. Timestamping is disabled by
default.
The option forces noninteractive behavior.
If specified, runs noninteractively,
using the default or specified values
for all supported options and
source/destination files.
file Specifies the name of the file from
which log data is read. The format of
the data in the specified file must be
the same as that used for raw SAM log‐
file data. If omitted, the SAM logfile
is read. If file is stdin is read and
runs noninteractively. If given, file
must be the last argument specified on
the command line.
EXAMPLES
Capture the current contents of the SAM logfile using default filter‐
ing, and put into the file
The following example does the same thing:
View only the commands executed by SAM on behalf of user between 8am
June 5, 1994 and 10pm August 14, 1994, and view the data interactively:
Noninteractively read data from stdin, timestamp it, and save the
result in a file called
Do the same as above, but instead have the data appear on stdout:
or
FILES
SAM logfile.
Archived version of
created when the logfile is automatically trimmed by SAM when
its size becomes too large. Its contents are included in the
log entries read by
Temporary files used by
SEE ALSO
sam(1M).
samlog_viewer(1)
