HP-UX Reference (11i v1 05/09) - 1 User Commands N-Z (vol 2)

s
samlog_viewer(1) samlog_viewer(1)
NAME
samlog_viewer - a tool for viewing and saving the SAM logfile
SYNOPSIS
/usr/sam/bin/samlog_viewer
[-s mmddhhmm[ccyy]] [-e mmddhhmm[ccyy]] [
-l SDVC]
[
-u user][-o ofile][
-t][-n][file]
DESCRIPTION
The
samlog_viewer
command enables the viewing of part or all of the SAM logfile (or another file con-
taining data in the same format) at varying levels of detail. This tool is run by SAM whenever the
View
SAM Log
option is chosen. It can also be run independently of SAM, in either interactive or noninterac-
tive mode.
The samlog_viewer
command executes in either interactive or noninteractive mode, depending on the
options given. In noninteractive mode,
samlog_viewer
filters the source file and writes the resulting
data either to stdout or to a destination file. In interactive mode,
samlog_viewer
displays a graphical
user interface 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
samlog_viewer
destructive to the contents of the SAM logfile (or whatever
source file is specified by file). The contents of the source file are filtered and displayed (or output) accord-
ing to the settings of the available filters. Multiple instances of
samlog_viewer
can be run simultane-
ously without harmful effects.
Filters
samlog_viewer 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 filters are:
Summary Displays only the higher level messages. These include summary, error, and
note (warnings, other entries worthy of special attention) entry types.
Detail Includes Summary level of detail, and adds detail log entries. If no level of
detail is specified, this is the default.
Verbose Includes Detail level of detail, and adds verbose log entries.
Commands Only 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 specific date/time, before a specific
date/time, or both.
The user filters are for viewing only those entries written by a particular user. If invoked with the
-u
option, its argument is used as the user whose entries should be shown. If -u is not specified, then the
value of the environment variable
SAM_RESTRICTED_USER
is used as the name of the user. If neither
-u or SAM_RESTRICTED_USER is present, then no user filtering is done and entries from all users are
shown. If both -u and SAM_RESTRICTED_USER are in effect, the -u option overrides the setting of the
environment variable.
If user filtering is selected, either by the
SAM_RESTRICTED_USER environment variable or by the -u
option, samlog_viewer displays only entries made by that user and disallows any changes to the user
filtering. This is useful for allowing nonprivileged users to run samlog_viewer
and see only those
entries that pertain to them. Otherwise,
samlog_viewer 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 samlog_viewer runs
interactively, these attributes may also be set and modified in the various supported menus and displays.
The available options are:
-s mmddhhmm[ccyy ] The -s 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 date
command (see date(1)):
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1−−859