UTILITY man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

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 ALSO
       scopeux(1), extract(1), midaemon(1).

								    UTILITY(1)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net