INDICATE

CMS Commands

indicate.helpcmd.txt
INDICATE                                                 CP Privilege Class:  G

Use the INDICATE command to display, at your terminal, the use of and
contention for major system resources.  The format of the ATTN command is:
+----------+------------------------------------------------------------------+
| INDicate | [LOAD|USER]                                                      |
+----------+------------------------------------------------------------------+
where:

LOAD     displays CPU use, CPU contention, main storage use and main storage
         contention.

USER     displays the amounts of system resources used by your virtual machine
         in the current terminal session.


Usage notes:

1.  Use INDICATE LOAD to display system load conditions.

2.  Use INDICATE USER to display the total amount of certain resources used by
    your virtual machine during the current terminal session.  Use the INDICATE
    USER command before and after the execution of a program to indicate the
    execution characteristics of that program in terms of the resources used.

Responses:

Response for INDICATE LOAD
   CPU-nnn%  APU-nnn%  Q1-nn  Q2-nn  STORAGE-nnn%  RATIO-n.n
where:

CPU-nnn% (in AP and UP modes) nnn is a value rounded to the nearest whole
         number; it indicates the percentage of time that the main processor is
         executing.

APU-nnn% (in AP mode) nnn is a value rounded to the nearest whole number; it
         indicates the percentage of time that the attached processor is
         executing.  In uniprocessor mode of operation, VM/370 indicates this
         response field as zero.

Q1-nn Q2-nn
         indicates the contention for CP.  nn is a value rounded to the nearest
         whole number; it represents the numbers of interactive users (Q1) and
         non-interactive users (Q2).

STORAGE-nnn%
         is a measurement of the use of real storage.  nnn is a value rounded
         to the nearest whole number and represents the ratio of the sum of the
         estimated working sets of the users in Q1 and Q2 (the runlist) to the
         number of pageable pages in the system, expressed as a percentage.
         Because the criterion for allowing a user on the eligible list to
         enter a queue is that at least 75 percent of his working set size must
         fit in the available page frames, the value of STORAGE can be more
         than 100 percent.

RATO-n.n
         represents the contention for real storage.  It is defined as
                    E+M
            RATIO = ---
                     M
         where:

         E   is the number of users that are eligible to become active when
             enough storage becomes available.

         M   is the number of users currently active.

         Thus, RATIO is the ratio of potential users to users currently active.
         It is 1.0 for optimum response.  Optimum response occurs when enough
         storage exists to accommodate all potenial users, assuming the system
         at this time is not CPU-bound.

         If E and M are both 0, the value of RATIO is set to 1.0.

         Given the values of RATIO and M (M = Q1 + Q2), the number of users
         waiting to become active can be calculated as follows:
            E = M (RATIO - 1)

Responses for INDICATE USER
   PAGES: RES-nnnn WS-nnnn READS=nnnnnn WRITES=nnnnnn MH-nnnn FH-nnnn
   VTIME=mmm:ss TTIME=mmm:ss SIO=nnnnnn RDR-nnnnnn PRT-nnnnnn PCH-nnnnnn
where:

RES-nnnn is the current number of your virtual storage pages resident in main
         storage.  This number is taken at an instant of time during the
         execution of the INDICATE command.

WS-nnnn  is the most recent system estimate of your working set size.

READS=nnnnnn
         is the total number of page reads that have occurred for you since you
         logged on or since the last ACNT command was issued for your virtual
         machine.

WRITES=nnnnnn
         is the total number of pages written for you since you have logged on
         or since the last ACNT command was issued for your virtual machine.

DISK-nnnn
         is the current number of virtual pages allocated for you on the system
         paging disk(s).  This number is taken at an instant in time during the
         execution of the INDICATE command.

DRUM-nnnn
         is the current number of virtual pages allocated for you on the system
         paging drum(s).  This number is taken at an instant in time during the
         execution of the INDICATE command.

VTIME=mmm:ss
         is your total virtual machine time since you logged on or since the
         last ACNT command was issued for your virtual machine.

TTIME=mmm:ss
         is your total virtual machine time plus total processor time (virtual
         plus overhead) that you have used since you logged on or since the
         last ACNT command was issued for your virtual machine.

SIO=nnnnnn
         is the total number of nonspooled I/O requests that you have issued
         since you logged on or since the last ACNT command was issued for your
         virtual machine.

RDR-nnnnnn
         is the total number of virtual cards read since you logged on or since
         the last ACNT command was issued from your virtual machine.

PRT-nnnnnn
         is the total number of virtual lines printed since you logged on or
         since the last ACNT command was issued for your virtual machine.

PCH-nnnnnn
         is the total number of virtual cards punched since you logged on or
         since the last ACNT command was issued for your virtual machine.