Trailing-Edge - PDP-10 Archives - BB-JR93N-BB_1990 - 10,7/sysdpy/sysdpy.hlp
There are 22 other files named sysdpy.hlp in the archive. Click here to see a list.
Displaying System Statistics Using SYSDPY


The SYSDPY program allows you to display system status and the  status
of  network links and user jobs, formatted for your particular type of
terminal.  SYSDPY features a display-oriented output format with  many
commands  for  controlling  the types of information to include in the

When you first start the SYSDPY program, it displays the status of the
user  jobs  and  the  system  statistics.  It is ready to receive user
commands at any time.  Your commands are not echoed on the screen, but
are reflected in the changes in the display.


To start the SYSDPY program,  type  the  R  command  followed  by  the
special  version of SYSDPY that is designed for your type of terminal.
The different versions of SYSDPY and the terminal types for which they
are designed are:

     Version      Terminal

     SYSDPB       DIGITAL VT05B (2400 baud)
     SYSDPY       DIGITAL VT06 (Datapoint 3300)
     SYSVBX       DIGITAL VB10C graphics display
     SYSV50       DIGITAL VT50
     SYSV52       DIGITAL VT52
     SYSV61       DIGITAL VT61
     SYSANS       DIGITAL VT100 or other ANSI terminal
     SYSDLT       Delta Data Telterm
     SYSHLZ       Hazeltine 2000

Any unprivileged user can run SYSDPY, but the output of certain system
statistics  is  restricted to privileged jobs only.  If you are logged
in as [1,2], or your job has SPY privileges, you can use all available
SYSDPY commands.

When SYSDPY first starts running,  it  displays  the  normal  job  and
system  status  (equivalent  to  the N command).  At any time, you can
type any of the one-letter  commands  described  below,  which  change
either  the type of information displayed, or allow you to control the
display of information.   The  file  DOC:SYSDPY.MAN  contains  a  full
description  of  the  information in the various displays.  You do not
need to press RETURN after you type a SYSDPY command.   To  exit  from
SYSDPY, type <CTRL/Z> or <CTRL/C>.

If you need help, type H.  This prints a short  listing  of  available

Commands to SYSDPY are:

A       Changes SYSDPY's normal scroll setting to  no-scroll.   SYSDPY
        usually  scrolls  through the display, advancing one screenful
        each update pass.  (Refer to the + and - commands.)

C       Displays the DECnet link status for  all  open  links  on  the

E       Displays  Ethernet  status.   This   includes   all   Ethernet
        channels,  all  KLNI  controllers, and enabled protocol types.
        The E command summarizes datagram traffic and the  free  queue

F       Lists file system statistics for each disk unit in the system.
        This   information   includes  I/O  counts,  error  summaries,
        structure membership, and a summary of swapping units.

H       Lists the help text.

I       Lists incremental statistics, which  are  changes  in  certain
        values  since  the  last update cycle.  The values incremented
        are:  system uptime, job runtimes, disk reads and writes,  CPU
        statistics,  network  I/O  (byte)  counts, TTY I/O counts, and
        network message counts.  A + (plus sign) immediately preceding
        the uptime value indicates incremental mode.

J       Lists jobs only, without any system statistics.  The jobs  are
        listed in columns.

K       Displays CI network information, including open paths to nodes
        on  the  CI network, packet transmission and reception counts,
        and port recoverable error counts.

L       Writes   the   contents   of   the   screen   to   the    file
        LPT:SYSDPY.LOG[-].   SYSDPY  logs  the  screen each time it is
        updated.  If this log file already exists, SYSDPY appends  the
        new  data  to  it.  A form feed separates each screen.  Typing
        <CTRL/Z> to SYSDPY closes the file.

M       Lists normal job data and an expanded memory  summary  showing
        both virtual and physical job memory usage.  The M job display
        does not show system statistics.

N       Lists the default statistics, which include a  column  of  job
        status information, and a column of system status information.
        Some of the system statistics listed are  CPU  idle  and  lost
        time, and available disk structures.

O       Suppresses statistics from [1,2] jobs for  the  J,  N,  and  M
        displays.  A second O command resumes display of [1,2] jobs.

Q       Lists the system queues, just as the QUEUE program  does,  but
        in DPY mode.  This command requires GALAXY Version 4 or later.

R       Refreshes the entire screen immediately.  SYSDPY automatically
        refreshes  the  screen  at various intervals, depending on the
        terminal in use.  The R command resets the  automatic  refresh

S       Changes the SYSDPY display from the default to the disk reads,
        disk  writes,  and  the user name for all jobs listed in the N
        display.  SYSDPY resumes displaying system statistics when you
        type the S command a second time.

T       Displays ANF network topology and the NCL  numbers  associated
        with each node.  This display requires PEEK or SPY privileges.

V       Attempts to lock SYSDPY  in  memory  and  run  it  in  a  high
        priority  run  queue  (HPQ).   In addition, SYSDPY updates the
        screen once per second, unless you previously set  the  update
        time  to  another  value  (using  the  W command).  A second V
        command clears the lock and  HPQ  setting,  and  restores  the
        update  time  to ten seconds.  If you issued a SET HPQ command
        before running SYSDPY,  the  V  command  locks  the  job,  but
        doesn't change the HPQ.

        SYSDPY automatically clears the  V  state  after  1000  update
        cycles,  or  if  you  issue  a Q command.  The system does not
        issue an error message if SYSDPY fails to lock or run in  HPQ.
        This command requires LOCK or HPQ privileges.

nW      Sets the wait time between screen updates to n  seconds.   The
        default  update  time is ten seconds, and one second for the V
        display.  You may specify n as any number between  0  and  60.
        Zero  means  one  clock  tick.   If you do not specify a time,
        SYSDPY assumes the default wait time of ten seconds.

Z       Lists all known LAT servers and some LAT traffic statistics.

\       Displays ANF network statistics.   This  information  includes
        the  number of network messages sent and received according to
        message type (such as DATA or NEIGHBORS), a histogram  of  the
        data  messages sent and received as a function (log base 2) of
        the data message size, and network free core usage.

*       Displays the DECnet node status for all nodes  in  the  DECnet
        network.   Use  the  A  command to change the display from all
        network nodes to just those nodes with active links.  Use  the
        ^  command  (described  below)  to change the display from all
        known nodes to only those nodes with which the local node  has
        had contact.

n+      Advances the screen by n lines or n  jobs,  depending  on  the
        current display.  If you do not specify n, SYSDPY advances one
        screen.  When you type the + command,  you  clear  auto-scroll
        (refer to the A command).

n-      Scrolls the screen backwards by n lines or jobs, depending  on
        the current display.  If you do not specify n, SYSDPY reverses
        one  screen.   When  you  type  the  -  command,   you   clear
        auto-scroll (refer to the A command).

!       Displays idle jobs or DECnet nodes, depending on  the  current
        display.   Typing  the  !  command again stops display of idle
        jobs or nodes.

#       Changes the listing in the "Where" column of the  job  display
        from  the  PTY  number  to the controlling job number of a job
        being controlled by another job.

%       Changes the listing in the "Runtime" column of the job display
        from  the actual runtime to the percentage of the CPU that the
        runtime represents.

^       Eliminates certain statistics from the  display.   For  the  N
        display,   the   first  part  of  the  system  statistics  are
        eliminated, for a DECnet display, non-valid delay  time  nodes
        are   not   shown,  and  for  the  F  display,  error  summary
        information is not included.

<ESC>   Freezes the current screen until you type another command.

SPACE   Updates the screen display immediately, but  does  not  change
        any SYSDPY parameters.


The SYSDPY program:

     Destroys your core image.

     Requires LOGIN.

     Places your terminal at user level.