Click on FTP to download from the FTP archives.
![[FTP]](http://www2.encompassus.org/hidedecus/graphics/i_ftp.gif)
----------
Author:
-------
The program was written at Brandeis University, Waltham,
Massachusetts, USA by Vadim Gorokhovsky.
E-mail: gorokhovsky@binah.cc.brandeis.edu
Acknowledgments:
----------------
The author gratefully acknowledges generous help he received from
all Feldberg staff. Special thanks to Rich Schofield and David King
whose assistance and encouragement were invaluable to this project.
Description:
------------
PSTAT is a utility which helps regular users and system managers
analyze and control processes on OpenVMS systems. Sample uses for
PSTAT are:
o Selection of processes by various characteristics -
for example,
$ PSTAT /USER=SM*TH /IMAGE=MA*L /BEFORE=TODAY /FULL
will display detailed information about processes created
before TODAY of users matching the specified username who
run the image set by the /IMAGE qualifier, and
$ PSTAT /TYPE=(DIALUP, REMOTE) /IMAGE=SPSS
will display information about dialup and remote processes
whose current image is matched by the /IMAGE qualifier.
o Continuous monitoring of a process with a single keystroke
deletion feature:
$ PSTAT /CONTINUOUS /USERNAME=SMITH /TYPE=INTERACTIVE
If there is a single process matching the specified
characteristics, PSTAT will enter the continuous update mode.
CTRL-D may be used to delete the currently displayed process,
if the user who activated PSTAT has sufficient privilege to
stop the process.
o Deletion of multiple processes with similar characteristics:
$ PSTAT /NODE=* /BEFORE=YESTERDAY /RATIO=LESS_THAN=0.01 /DELETE
PSTAT will display and attempt to delete processes that were
created before YESTERDAY with the connect to CPU time ratio
less than 0.01 on all nodes in the cluster. The program will
ask for the confirmation from the user for every deletion
operation and output log messages indicating the status of the
deletions.
$ PSTAT /TYPE=DETACHED /PROCESS=SSV$LTA* /DELETE /NOCONFIRM
The program will display and attempt to delete all matching
processes as well as output log messages indicating the status
of the deletions.
o Quick detection and deletion of run-away processes by
using the CPU time to connect time ratio and the continuous
update mode.
In the continuous update mode, the following keys are defined:
------------------------------------------------------------------------
Key Action
------------------------------------------------------------------------
CTRL-D Stop (delete) currently displayed process.
CTRL-W Refresh screen.
CTRL-Z, F10 Exit PSTAT.
-------------------------------------------------------------------------
Please read the PSTAT.HLP file for more information about the
advanced features of PSTAT.
Privs. required:
----------------
No special privileges are required for personal use of PSTAT. For
system-wide use PSTAT needs to be installed with the WORLD priv.
When run system-wide with the image installed with the WORLD priv,
PSTAT will check privileges of the calling process before allowing
any process deletions.
Installation:
-------------
Run the make.com file. It will define PSTAT$EXE logical enabling
PSTAT.CLD to recognize the current location of PSTAT.EXE. For further
personal use you should either edit PSTAT.CLD or define PSTAT$EXE in
LOGIN.COM. You may also use a foreign command to run PSTAT.
To install PSTAT system-wide, please follow your local site
software installation guidelines.
Known Problems:
---------------
PSTAT may not report the correct time on a remote cluster node when
the clocks on the host node and the remote node are not synchronized.
PSTAT may not detect a process on a remote cluster node if it is
suspended or is in a miscellaneous wait state. This is due to the
inability of the $GETJPI system routine to detect such processes on the
remote cluster nodes.
Warranty:
---------
There is no warranty of any kind either explicit or implied. Use
it at your own risk. This program is free software; you can
redistribute it and/or modify it under the terms of the GNU General
Public License as published by the Free Software Foundation; either
version 1, or (at your option) any later version. This program is
distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
To receive a copy of the GNU General Public License write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
Misc.:
------
I would appreciate if you could let me know of any modifications made
to the program. Please feel free to contact me with any suggestions,
questions, or bug reports at <gorokhovsky@binah.cc.brandeis.edu>
Click on FTP to download from the FTP archives.