UTILITY(1)UTILITY(1)NAME
utility - is a general purpose program to manage Performance Agent (PA)
log files.
SYNOPSIS
To scan a log file and produce a report on its contents:
utility -xs [<logfile>] [-v] [-dD] [-b <date> <time>]
[-e <date> <time>] [-f <filename>]
To check the syntax of a scopeux parameter file:
utility -xp <parmfile> [-v] [-f <filename>]
To check the syntax of an alarm definitions file:
utility -xc <alarmdef> [-f <filename>]
To analyze a log file against an alarm definitions file:
utility -xa [-dD] [-f <filename>]
To check if the license is Permanent, Trail or Expired:
utility -licheck
To change the size of raw log files:
utility -xr [glob|appl|proc|dev|tran|LS]
[size=<nnn>|days=<nnn>]
[empty=<nnn>|space=<nnn>]
[yes|no|maybe]
To run interactively:
utility [-v] [-dD] [-lf <filename] [-b <date> <time>]
[-e <date> <time>]
DESCRIPTION-b <date> <time> Sets starting date and time
-e <date> <time> Sets ending date and time
-l <logfile> Specifies input log file
-f <file> Sends output to a specific output file.
-D Enables detail for scan, analyze, and parm file
checking
-d Disables detail for scan, analyze, and parm file
checking
-v Selects verbose output
-xp <parmfile> Syntax checks a parameter file.
-xc <alarmdef> Syntax checks an alarm definitions file and sets the
alarmdef file name.
-xa Analyzes a log file against the alarm definitions
file
Note: The log file data is accessed through the coda
daemon or the repository servers. You must make sure
that data sources and log files are defined in the
data source configuration file (datasources file).
-xs <logfile> Scans the log files and produces a report
-xr GLOB [SIZE=nnn] [EMPTY=nnn] [YES ] Resizes a raw log file
APPL [DAYS=nnn] [SPACE=nnn] [NO ]
PROC [MAYBE]
DEV
LS
NOTE: LS data types are supported only on VMware ESX Server, HPVM
and AIX.
TRAN
NOTE: TRAN data types are not supported in Tru64 UNIX.
? Displays command line syntax
where:
<date> Specifies a date in native language syntax. (The default
format is MM/DD/YY, as in 12/31/02)
Or specifies one of the special keywords "TODAY", "FIRST",
or "LAST" to select the current date, the first date in the
log file, or the last date in the log file respectively.
Or specifies keyword "TODAY-nnn" where nnn is a number
specifying the number of days before today
Or specifies keyword "FIRST+nnn" where nnn is a number
specifying the number of days after the first date in the
log file.
Or specifies keyword "LAST-nnn" where nnn is a number spec‐
ifying the number of days before the last date in the log
file.
<time> Specifies a time in native language syntax. (The default
format is hh:mm AM or hh:mm PM, where hh is 12-hour hours,
mm is minutes.)
<logfile> Names a raw or extracted log file; can be fully qualified
with a path name. The default log file is
/var/opt/perf/datafiles/logglob.
<parmfile> Names a scopeux parameter file; can be fully qualified with
a path name. (The default parm file is parm.)
<alarmdef> Names an alarm definitions file; can be fully qualified
with a path name. (The default alarm definitions file is
alarmdef.)
GLOB Specifies resizing the raw global log file (logglob).
APPL Specifies resizing the raw application log file (logappl).
PROC Specifies resizing the raw process log file (logproc).
DEV Specifies resizing the raw device log file (logdev).
TRAN Specifies resizing the raw transaction log file (logtran).
(Not supported in Tru64 UNIX.)
LS Specifies resizing the raw logical system log file(logls).
(Supported only on VMware, HPVM and AIX)
(For a discussion on the remaining options in the -xr argu‐
ment, see the online help topic "RESIZE".)
EXAMPLES
The normal input and output redirection is allowed (<,>,2>). If input
is redirected or if a command line input is being processed, the pro‐
gram is running in "batch" mode, and any nonrecoverable error results
in a program abort. Interactive input allows the user to correct any
problem and reexecute the command.
Example: To scan the log file "barkley" starting on December 31, 2002
and ending at 5:00 PM yesterday, producing a detailed report,
enter:
utility -l barkley -b 12/31/02 -e today-1 5:00 PM -D -xs
DEPENDENCIES
Raw log files must be named logglob, logappl, logproc, logdev, logtran,
and logindx and must be stored together under the same directory. Sets
of raw log files can be kept under different directories. Utility
assumes that a file by any other name is a PC format file. (logtran is
not supported in Tru64 UNIX.)
AUTHOR
Developed by Hewlett-Packard Company.
FILES
rxlog - PC format file.
logglob, logappl, logproc, logdev, logtran, logindx
- raw log files (logtran is not supported in Tru64 UNIX).
utility.help
- help catalog
parm - scopeux parameter file
alarmdef
- alarm definitions file
utilengine
- process that performs the work for analyze and
checkdef commands
SEE ALSOscopeux(1), extract(1), midaemon(1).
UTILITY(1)