Google
 

Trailing-Edge - PDP-10 Archives - BB-F494Z-DD_1986 - 10,7/klbpa.man
There are 4 other files named klbpa.man in the archive. Click here to see a list.



                       KLBPA %1(1) users reference manual




















Copyright (C) 1979
Digital Equipment Corporation, Maynard, Massachusetts, U.S.A.

This software is furnished under a license and may be used and  copyed  only  in
accordance  with  the  terms of such license and with the inclusion of the above
copyright notice.  This software or any other copies thereof may not be provided
or  otherwise  made available to any other person.  No title to and ownership of
the software is hereby transferred.

The information in this software is subject to change without notice and  should
not be construed as a commitment by Digital Equipment Corporation.

Digital assumes no responsibility for the use or reliability of its software  on
equipment which is not supplied by Digital.
KLBPA %1(1) Users Reference Manual                                        Page 1
Introduction


     KLBPA (KL-10 Background Performance Analysis) is a program to  control  the
gathering  of  general  "background" system performance statistics of a 7-series
TOPS-10 monitor via the performance meter available on all KL-10 cpus.  As such,
KLBPA is meaningful only for KL-10 based TOPS-10 systems.

     In order to use KLBPA you must be running under the OPR account.
KLBPA %1(1) Users Reference Manual                                        Page 2
Background Performance Analysis Overview.


     KL-10 processors come equipped with  a  very  powerful  and  very  flexible
analytical  tool  called  the  "Performance Meter" or "Performance Meter Board",
hereinafter referred to as simply the "meter".  The meter allows measurement  of
a  wide  variety  of  operating  conditions or events which take place under the
control of the KL-10 cpu.

     The meter operates in one of two modes - duration mode or event  mode.   In
duration  mode  the  meter  measures  the  amount  of  time  (the duration of) a
condition occurs.  In event mode the meter counts  how  many  times  (events)  a
condition occurs.

     The meter can measure user mode  versus  executive  mode,  interrupt  level
processing, RH20 channel to memory usage, memory usage (from which the cache hit
ratio can be calculated), and a number of other conditions.  The meter can  even
measure  a  microcode-controlled  condition, enabling the KL-10 to, for example,
count the number of times an ILDB instruction is executed (or the amount of time
spent  executing  ILDB  instructions).  To use the microcode in conjunction with
the meter requires modifying the microcode.

     For details  on  exact  meter  operation  read  the  DECsystem-10  Hardware
Reference Manual.

     The meter is available to user programs via the PERF.  monitor  call.   For
details  on  how  to  use  the PERF.  monitor call read the TOPS-10 7.00 Monitor
Calls Manual.

     Starting with the 7.00 release of the TOPS-10 monitor  the  monitor  itself
can use the meter to gather system-wide operating statistics independent of user
programs.  If a specific user program has a cpu's meter in use then the  monitor
can  not  use that cpu's meter (when the job releases the meter the monitor will
automatically resume its background usage, if enabled).

     If the meter is available to the monitor then the monitor will  (on  orders
from,  for  example,  KLBPA)  enable  the  meter  and  leave  it running "in the
background" gathering statistics.

     The monitor has a command table (in the COMMON module) which contain  meter
commands.   The  monitor  will  round-robin  through  the  command table passing
successive conditions to the meter.  A user-settable sampling interval  controls
how often the meter command is changed.

     At the end of a sample interval the monitor reads the meter value  and  the
elapsed  time  and adds them into a CDB variables subtable (GETTAB item %CCBPA),
then steps to the next command, reenables the meter, and continues.  The monitor
sampling is driven by the monitor clock interrupt service, which, running at the
APR PI level (the highest ever used by  the  monitor),  gives  a  very  accurate
sampling interval.

     It is important to note that the monitor has no  idea  what  the  meter  is
doing,  the  monitor  merely  picks  up  the 36-bit meter command from the meter
command table, passes the command to the meter, then later reads what the  meter
has  "counted",  as  well  as the interval for which the meter was enabled.  Any
interpretation of the statistics so gathered is left to user programs.
KLBPA %1(1) Users Reference Manual                                        Page 3
Background Performance Analysis Overview.


     With the 7.00 release of the  monitor  the  meter  commands  table  has  16
(decimal) entries, the first eight of which watch the RH20 to MBOX interactions,
and the second eight of  which  watch  the  amount  of  time  spent  at  various
interrupt levels.  All sixteen entries are duration mode.  

     KLBPA  itself  does  not  do  anything  with  the  background   performance
statistics,  the  ONLY  function  of  KLBPA  is  to  control whether or not said
statistics are gathered.  SYSDPY %434(562) will display these statistics as part
of  the "system" display for any cpu which is enabled to maintain them.  See the
SYSDPY manual for details.
KLBPA %1(1) Users Reference Manual                                        Page 4
Commands


     KLBPA will prompt the user with a "/" character.  At this  point  the  user
may  type  in  a  single command to KLBPA.  Commands to KLBPA are of the form of
action keywords, optionally followed by any arguments (similar to BACKUP).

     The commands to KLBPA are:

[NO]ALL         Enable [Disable] all cpus.  The "ALL" command instructs KLBPA to
                turn  on  the performance meter for all cpus in the system.  The
                NOALL command instructs KLBPA to turn off the performance  meter
                for all cpus in the system.

[NO]CLEAR       Do [not] zero the statistics tables when enabling  a  cpu.   The
                CLEAR  command  instructs  KLBPA  to  have  the monitor zero the
                per-cpu statistics table when the cpu is enabled for performance
                measurements.   The NOCLEAR command instructs KLBPA to not cause
                the per-cpu statistics  table  to  be  cleared  when  a  cpu  is
                enabled.   The  [NO]CLEAR  command is a status switch which will
                affect all subsequent enable/disable commands.

[NO]CPU0        Enable [Disable] only CPU0.  The CPU0 command enables background
                performance  statistics  gathering  only  for  CPU0.  The NOCPU0
                command disables  background  performance  statistics  gathering
                only for CPU0.

[NO]CPU1        Enable [Disable] only CPU1.  The CPU1 command enables background
                performance  statistics  gathering  only  for  CPU1.  The NOCPU1
                command disables  background  performance  statistics  gathering
                only for CPU1.

[NO]CPU2        Enable [Disable] only CPU2.  The CPU2 command enables background
                performance  statistics  gathering  only  for  CPU2.  The NOCPU2
                command disables  background  performance  statistics  gathering
                only for CPU2.

[NO]CPU3        Enable [Disable] only CPU3.  The CPU3 command enables background
                performance  statistics  gathering  only  for  CPU3.  The NOCPU3
                command disables  background  performance  statistics  gathering
                only for CPU3.

[NO]CPU4        Enable [Disable] only CPU4.  The CPU4 command enables background
                performance  statistics  gathering  only  for  CPU4.  The NOCPU4
                command disables  background  performance  statistics  gathering
                only for CPU4.

[NO]CPU5        Enable [Disable] only CPU5.  The CPU5 command enables background
                performance  statistics  gathering  only  for  CPU5.  The NOCPU5
                command disables  background  performance  statistics  gathering
                only for CPU5.

TICKS:nnn       Set measurement cycling interval to nnn clock ticks.  The  TICKS
                command  sets  the interval between successive samples read from
                the performance meter.  The TICKS command  is  a  status-setting
                command  which  affects  all  subsequent enabling commands.  The
                default value for the sampling interval is one clock tick.