SYNOPSIS
/usr/openv/netbackup/bin/vxlogview [options] [-l Locale] [-d DisplayOp-
tion[,...]]
/usr/openv/netbackup/bin/vxlogview [-w queryString] [-l Locale] [-d
DisplayOption[,...]]
/usr/openv/netbackup/bin/vxlogview -a [-l Locale] [-d DisplayOp-
tion[,...]]
/usr/openv/netbackup/bin/vxlogview -v
/usr/openv/netbackup/bin/vxlogview -h
DESCRIPTION
Use the vxlogview utility to view the logs that unified logging gener-
ates. Search criteria can be specified with command-line options to
view specific logs.
Unified logging uses a standardized naming format for log files, as
follows:
productID-originatorID-hostID-date-rotation.log
For more information about the unified logging naming format, and the
logging originator ID's, refer to the NetBackup Troubleshooting Guide
for UNIX, Windows, and Linux.
OPTIONS
Specify the logs you want to view.
-A, --audit
Display audit messsages.
-a, --all Display all log messages from log files that multiple Syman-
tec products generated.
-b, --stdate
Display the messages that logged that start at the given
start time. The date format is set from the current locale at
run-time and is locale-specific NOTE: In UNIX, use single
quotes to enclose the date/time argument. In Windows, use
double-quotes.
-C, --crit
Display application log messages having a severity of criti-
cal.
-D, --debug
p - Display process ID
t - Display thread ID
P - Display product ID
O - Display originator ID
c - Display context token
s - Display application log entry severity
u - Display application or diagnostic Unique Message ID
x - Display actual log message text
w - Display who logged the diagnostic or debug message
i - Display short name for a product
o - Display short name for an originator
all - Display all fields of the log record
If -d is not specified, the following fields are displayed by
default.
- Date
- Time
- Who (for diagnostic and debug messages only)
- Severity (application messages only)
- UMI (application and diagnostic messages only)
- message text
-E, --err Display application log messages having a severity of error.
-e, --endate
Display messages that are logged up to a given end time. If
an end time is not specified, it displays messages from the
given start time to the end of the log. If the date is not
specified, it takes the current date as default. The date
format is set from the current locale at run-time and is
locale-specific NOTE: In UNIX, use single quotes to enclose
the date/time argument. In Windows, use double-quotes.
-F, --info
Display diagnostic log messages.
-i --fileid FileID
Display messages that a given file ID or shared originator ID
logged.
-K, --hostname
Display messages that the specified host name logged.
-L, --app Display application log messages.
-l, --locale Locale
Display messages in the locale that Locale provides. The
messages appear in the current system locale if this option
is not given. If the messages cannot appear in the wanted
locale, the messages appear in English.
-M, --emerg
Display application log messages having a severity of emer-
gency.
-N, --level
Display debug and diagnostic log messages for a given level.
-n, --days NumberOfDays
Display the messages that were logged for last NumberOfDays
days.
-o, --orgid OriginatorID
Display the messages that the given originator logged, which
a given originator ID identified. Instead of an identifier,
the user can provide the abbreviated name of the product.
-P, --pid ProcessID
Display the messages that were logged by a given process ID.
-p, --prodid ProductID
Display the messages that the product (identified by a given
product ID) logged. Instead of an identifier, the user can
provide the abbreviated name of product.
-R, --resdir dir
Use resources from a given directory instead of a configured
localization resource directory.
-r, --res Result
Display audit messages having the specified Result. Result
should be either 0 or 1.
-W, --warning
Display application log messages having a severity of warn-
ing.
-w, --where QueryString
Specify a WHERE clause to use when you query the log mes-
sages such that a subset of messages can be displayed. For
more detail on QueryString, refer to the "Using Logs and
Reports" chapter of the NetBackup Troubleshooting Guide.
-X, --ctx ContextToken
Display messages that belong to the given context instance.
Context tokens identify context instances. If the context
token specified is "all," it displays all of the context
names and associated tokens.
-y Display the hostname with each displayed log message. Use
this option if log files are coming from different hosts and
you want to display which message came from which host.
-z, --timezone
Display messages with time adjusted as per the given time-
zone.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
-1 An error occurred.
EXAMPLES
Note The following examples are valid for UNIX, which uses single
quotes to enclose option arguments. In Windows, use double-
quotes.
Example 1
This example displays the log messages for all the installed products:
vxlogview --all
Example 2
This example displays the log messages for NetBackup. It displays only
the date, time, message type, and message text:
vxlogview --prodid NB --display D,T,m,x
Example 3
This example displays the log messages that were logged within the last
hour:
vxlogview --tail 1:00:00
Example 6
This example displays the audit log messages that have a result of 0:
vxlogview --audit -r 0
Example 7
This example displays the context log messages for the "job_context"
instance:
vxlogview --ctx 'jobid=4'
SEE ALSO
vxlogcfg(1), vxlogmgr(1)
04 Jan 2007 vxlogview(1)