;****************************************************************************
;*									    *
;*  COPYRIGHT (c) 1982                                                      *
;*  By WESTERN ELECTRIC COMPANY, DALLAS WORKS.				    *
;* 									    *
;*  THIS SOFTWARE IS FURNISHED WITHOUT LICENSE AND MAY BE USED AND  COPIED  *
;*  ONLY WITH THE INCLUSION OF THE ABOVE COPYRIGHT NOTICE.		    *
;* 									    *
;*  THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE  WITHOUT  NOTICE  *
;*  AND  SHOULD  NOT  BE  CONSTRUED  AS  A COMMITMENT BY WESTERN ELECTRIC.  *
;* 									    *
;*  WESTERN ELECTRIC ASSUMES NO RESPONSIBILITY FOR THE USE OR  RELIABILITY  *
;*  OF THIS SOFTWARE.  							    *
;*									    *
;****************************************************************************
;
;	Image:		Sysdpy
;	Version:	1.8
;	Date:		September 30th, 1982
;	Author:		Stuart B. Renes,	Western Electric Co.
;			Dept. 477
;			3000 Skyline Drive
;			Mesquite, Texas  75149
;			1-214-288-2286
;
;
;	To build Sysdpy:
;
;	$ Link sysdpy,dpylib/incl=(Sysdpy,dpy,dpyday,syslow),sys$system:-
;	sys.stb/sel
;
; Sysdpy runs in EXEC mode and requires WORLD,GROUP and LOG_IO privileges to
; get information about processes in the system other than the
; process running Sysdpy.  To allow Sysdpy to be run by non-privileged
; users, put Sysdpy.exe in [SYSEXE] and put the following in the
; system startup file, [SYSMGR]SYSTARTUP.COM:
;
;	$ RUN SYS$SYSTEM:INSTALL	!Run the INSTALL utility
;	Sysdpy/SHARED/HEAD/PRIV=(CMEXEC,WORLD,GROUP,LOG_IO) !Install Sysdpy
;					! with privileges
;	^Z
;
;	and then put
;	$Assign/system sys$system:sysdpy sysdpy
;					!in your System-wide login.com
;
;
;
1 SYSDPY
Dynamically displays the status of all VAX/VMS interactive users.

Format:

	R SYSDPY

2 Display 

	The following items are displayed and updated by SYSDPY:

	o A header showing VMS version, current Daytime,
	  incremental system Idle time, Users and Uptime.

	A line for each logged-in user showing:

	o The terminal id
	o The process name (or optionally, username) of the user logged in
	o The currently executing image
	o The current process state
	o The current physical memory in use
	o The total (or optionally, incremental) amount of I/O (direct+buffered)
	o The total number of open files
	o The total (or optionally, incremental) number of page faults
	o The current process priority
	o The total (or optionally, incremental %) amount of CPU time
	o The time the process was created

2 Terminal Support

	SYSDPY supports the following types of CRT terminals:

	Digital VT52	Digital VT100	Lear-Siegler ADM3A
	Infoton I100	Hazeltine 1500	Hewlett-Packard 2645

	Please note that the entire VT100 family of terminals is
	supported under the class-name of "VT100".
	This includes the VT100,101,102,125,131 and VT132.
	(VT55 type terminals are treated as VT52's)

	If your terminal is set as a member of the DEC family of CRT's,
	SYSDPY will force the terminal in the proper mode before starting
	the display.

	Also, SYSDPY recognizes the DEC family of hard-copy terminals, i.e.
	LA12,24,34,36,38,100 and LA120.
	(SYSDPY also supports any hard-copy terminal that
	has an 80 character format - type HCPY)

	If the terminal is set as UNKNOWN, SYSDPY will prompt you
	for the type of terminal.

2 Commands

	The following commands can be executed while SYSDPY is running:

		R	to refresh the display
		Snn	to set the sleep interval to nn seconds (*)
		<Sp>	to wake the Display
		H	to display Help on the commands
		+	to scroll the display forward one screenfull
		-	to scroll the display backward one screenfull
		A	to toggle auto-scroll of all users
		I	to toggle incremental or cumulative display
		L	to toggle display logging in SYSDPY.LOG
		O	to toggle display of allocated terminals
		P	to toggle priority and swapmode (*)
		T	to toggle granularity of the cputime display
		U	to toggle display of Username or Process Name
		^C	to exit Sysdpy (cursor to bottom of screen)
		^Z	to exit Sysdpy (cursor to top of screen)

	(*) - privileged command

3 Notes

o The default sleep interval is 3 seconds.
  (CMKRNL privilege required to set sleep interval < 3 seconds)
 
o ALTPRI/PSWAPM privileges required to alter priority and swapmode.
  (this allows running Sysdpy at priority 16 with swapping disabled)
 
o In modes (A,+ or -), Sysdpy will try to display up to 22 users
  (a full screen), so the amount of forward or backward scroll will
  vary from a minimum of 1 to a maximum of 22 users.
 
o Default Cpu Time display is hh:mm:ss.

o Toggled Cpu Time display is mm:ss.cc.
 
o Items that are displayed incrementally are I/O's, page faults and
  cputime.
 
o Processes that have multiple terminals allocated will have
  incremental statistics displayed for the FIRST terminal only.

