.\";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
.\"
.\" File:         glance.1
.\" Description:  @(#) GlancePlus man page for Linux
.\" Author:       Lalitha Chandrasekar, OpenView Learning Products, Bangalore
.\" Modified:     August 16, 2005 <chandlal>
.\" Package:      glance
.\"
.\" (c) Copyright 2005, Hewlett-Packard Company, all rights reserved.
.\"
.\";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
.TH glance 1 "Linux"
.ad b
.SH NAME
glance \- GlancePlus system performance monitor for Linux

.SH SYNOPSIS

.BR glance
[\fB-j \fIinterval\fR]
[\fB-p\fR [\fIdest\fR]]
[\fB-f \fIdest\fR]
[\fB-\fIcommand\fR]
.in +4
[\fB-maxpages \fInumpages\fR]
[\fB-nice \fInicevalue\fR]
[\fB-nosort\fR]
[\fB-lock\fR]
.br
[\fB-adviser_off\fR]
[\fB-adviser_only\fR]
[\fB-bootup\fR]
.br
[\fB-iterations \fIcount\fR][\fB-align\fR]
[\fB-syntax \fIfilename\fR]
.br
[\fB-aos \fIfilename\fR [\fI-noscaling\fR]]
.br
[\fB-all_trans\fR]
[\fB-all_instances\fR]
[\fB-no_fkeys\fR]
.br
[\fB-verbose\fR]

.SH DESCRIPTION
GlancePlus is a powerful and easy-to-use online performance
diagnostic tool for Linux systems.  It is distributed in two 
forms:
"xglance", a Motif-based program, and "glance", a character mode 
program.  
The combination allows you to use the appropriate tool 
for your job.  With 
.B xglance 
you get the power and ease-of-use a Motif-based tool.
With 
.B glance 
you can run on almost any terminal or workstation,
over a serial interface and relatively slow data communication 
links, and with lower resource requirements.  Either component 
provides the same rich set of performance information. 

The default Process List screen provides general data on
system resources and active processes.  More specific data is
presented via the CPU, Memory, Disk IO, Network, NFS,
Swap, and System Table screens.  Process workload groups, or
applications can be viewed in the Application List screen.
Specific per-process detail is also available via the individual 
process screens.  Running in a terminal environment, Glance aids
performance problem resolution on all Linux systems.

Definitions and descriptions of each metric are provided in 
GlancePlus online help.  

.SH Options
.TP 15
.B -j \fIinterval\fP
This option allows you to preset the number of seconds between 
screen refreshes in place of the default value of 5 seconds.  
For example, if
.B -j 60
is passed in, the screen update interval would be preset to 60 
seconds.

.TP 15
.B -p \fR[\fIdest\fP]
This option indicates that the continuous Print option should be
enabled when the tool starts.  This can be useful for printing 
screens automatically over a long interval.  The output will be 
directed to the default lp device, unless the \fIdest\fR 
parameter is supplied.  Once GlancePlus is running,
another p command toggles the continuous print off.

.TP 15
.B -f \fIdest\fP
This option indicates that the continuous Print option should 
be enabled when the tool starts.  This can be useful for printing
screens automatically over a long interval.  The output will be 
directed to the specified destination file.  Once GlancePlus is 
running, another p command toggles the continuous print off.

.TP 15
.B -maxpages \fInumpages\fP
This option changes the maximum number of pages that can be 
printed with the p command.  The default maximum is 200 pages.  

.TP 15
.B -\fIcommand\fP
This option can be used to request a different initial screen 
than the Global Summary screen.  This startup option corresponds 
to the keystroke commands that display different detail screens 
once the tool is run.  Only one of the commands in the first 
section of the COMMAND SUMMARY (below) is allowed for this 
option.

.TP 15
.B -nice \fInicevalue\fP
This option allows you to set the nice priority value for the 
GlancePlus process. The default nice value is -10 
(see man-page \fInice(1)\fP).

.TP 15
.B -nosort
This option tells GlancePlus not to sort interesting processes
listed on the Global Summary screen.  This reduces Glance's CPU
overhead.

.TP 15
.B -lock
This option allows Glance to lock itself into memory.
Note that response time may be enhanced by using this option, but
there is the possibility that you will receive the error "Unable
to allocate memory/swap space".  If this happens, you must run 
GlancePlus without using this option.

.TP 15
.B -adviser_off
Allows you to run Glance without the Adviser.

.TP 15
.B -adviser_only
This option allows Glance to run with no screen displays to the
terminal. Only the Adviser will run, sending it's output to 
stdout.  With this option the GlancePlus Adviser can be run in 
the background, with stdout output optionally redirected to a 
file.  If you want to run GlancePlus in "Adviser only" mode at
startup time, you must include the 
.B -bootup
option as well.

.TP 15
.B -bootup
This option allows Glance to ignore the SIGHUP signal. Use this
option along with 
.B -adviser_only or
.B -aos
when you want to run GlancePlus 
in "Adviser only" mode at startup time.

.TP 15
.B -iterations \fIcount\fP
This option allows you to limit the number of intervals that 
Glance will run.  This can be used in conjunction with the 
-adviser_only option which enables GlancePlus to run in the 
background with no terminal screen displays. Glance will execute 
for the number of iterations specified and then terminate.

.TP 15
.B -align
This option aligns the screen update interval to 1 minute if the glance
update interval is set to more than or equal to 60 seconds. If the glance 
update interval is less than 60 seconds, aligns the screen update interval 
to the interval boundary. This option can be used only with the 
-adviser_only mode.

.TP 15
.B -syntax \fIfilename\fP
Use this option to specify a file name which contains the syntax
to be used by the Adviser.  If no syntax file is specified, the 
Adviser will search for a user default file, ~/adviser.syntax.  
If no user syntax file is found, the system default syntax file,
/var/opt/perf/adviser.syntax, will be used.

.TP 15
.B -aos \fIfilename\fP
Use this option as an alternative to 
-adviser_only -syntax \fIfilename\fR option.

.TP 15
.B -noscaling
This option is used to turn off scaling of metric value to
appropriate units like kb/mb/gb. This can only be used in
conjunction with adviser_only mode.

.TP 15
.B -all_trans
This option allows GlancePlus to display all transactions 
registered on your system. If not specified, GlancePlus only 
displays transactions filtered by the values specified in your 
threshold file. 

.TP 15
.B -all_instances
This option allows GlancePlus to display the most recent 2048 
instances in a transaction. If not specified, GlancePlus only 
displays active instances with no stop time.

.TP 15
.B -no_fkeys
This option disables the display of function key labels.

.TP 15
.B -verbose
This option enables the display of error and warning messages
from API libraries.

.ne 45
.SH COMMAND SUMMARY
The following commands are grouped into three sections; top level 
screens, secondary screens, and miscellaneous commands.  The top 
level screen commands are the only ones allowed on the command 
line.
.LP
.RS 3 
.TS
c  l
l  l .

Command	Screen Displayed / Description
-------	------------------------------
a	CPU by Processor 
c	CPU Report
d	Disk Report
g	Process List 
i	File System Capacity
l	Network by Interface  
m	Memory Report
t	System Tables Report 
u	IO by Disk 
w	Swap Space 
A	Application List 
F	Process Open Files 
N	NFS Global Activity 
R	Process Resources
M	Process Memory Regions
Z	Global Thread List
I	Thread Resources
G	Process Thread List
T	Transaction Tracking
H	Alarm History
?	Commands Menu
 
S	Select an Application / Transaction / Logical
V	Select a Logical System List (vMA only)
K	Select a Logical System Report
s	Select a single process 
 
b	Scroll page backward
f	Scroll page forward
h	Online help
j	Adjust refresh interval
o	Adjust process threshold
p	Print toggle
q	Quit GlancePlus
r	Refresh the current screen
<cr>	Update current screen 
y	Renice a process
z	Reset statistics to zero
>	Display next logical screen
<	Display previous screen
!	Invoke a shell
.TE
.RE

.SH EXAMPLES
To choose the default start up options, which start 
.B glance
in the Global Summary screen, updating statistics every five 
seconds, enter:
.IP
.B glance
.PP
To monitor system resource usage overnight, run 
.B glance, 
and print the screen
once every hour until you return and exit the program, enter:
.IP
.B glance -j 3600 -p
.PP
To monitor and print swap utilization once every two hours, 
specifying the lp2 destination printer, enter:
.IP
.B glance -j 7200 -p lp2 -w
.PP
To execute GlancePlus at a higher than normal priority, limit 
the maximum number of pages output by the print command to 10, 
and request that the interesting processes be unsorted, enter:
.IP
.B glance -nice -19 -maxpages 10 -nosort
.SH AUTHOR
.B glance
was developed by Hewlett-Packard.
.SH SEE ALSO
xglance(1) perfstat(1)