INDICATE E Use the INDICATE command to display, at the console, the use of and
contention for the major system resources of processor and storage. The
users of this command include the general user and the system analyst.
The general user can display the use of and contention for the major system resources of processor and storage. He can also display the number of I/O requests his virtual machine has made and the total amount
of resources he has used during his terminal session. If he uses the
INDICATE command before and after the execution of a program, the
command indicates the execution characteristics of that program in terms
of resource usage.
The system analyst can identify the users in queue1 and queue2, the I/O devices they are queued up on, the paging devices that may have been
filled, or the execution characteristics of any user and the total amount of resources used by him. The system analyst can use the data on system resource use and
contention to monitor the performance of his system. He can thus be
aware of heavy load conditions or low performance situations that may require the use of more sophisticated data collection, reduction, and
analysis techniques to resolve these conditions. The format of the
Class E INDICATE com.and is:
1
r , I INDicate ILOAD I I I r , I I IUSER I! II I I luserid II I I L .J I I IQueues I I 11/0 I I I r , I I IPAGing II I I IALL II I I L .J I I L .J I LOAD provides an indication on the operating load of Vft/370 by
displaying values on: the number of users in queue 1 and queue
2, the usage of real storage, and the ratio of active ·users to
users being serviced. USER [ * ]
[userid]
allows a system analyst to find out more about the resources
used and occupied by his virtual machine, and events that have
taken place. USERID allows the system analyst to determine the
activity of virtual machines in terms of the resources used and
occupied and events that have taken place. Class E users can
access data from the VHBLOK of any user currently logged on to
the system in their attempts to understand an overload or poor
performance situation. The output of this operand is the same 80 V!/370 Operator's Guide

as that of the INDICATE USER * option. For detailed discussion
of the class G INDICATE command, see fo£ QUEUES displays the active users, the queues that they are in, the
storage that they are occupying, and the status that they are
in. The display indicates those users currently dominating main storage. Users waiting in eligible lists are included in the
response because they are contending for main storage and it is
only by chance that they were not occupying main storage at the
time of the command. I/O provides information about conditions leading to possible
contention within the system. The response gives the userids of
all the users in I/O wait state at that instant in time, as well
as the address of the real device to which the most recent virtual SIO was mapped. The response, however, does not show
the queue of users who issue SIOF to busy devices. Because the
response indicates only an instantaneous sample, use the command
several times before assuming a condition to be persistent. If
it is persistent, use the SEEKS operand of the MONITOR command
to conduct a thorough investigation of the suggested condition.
PAGING WAIT is provided for installations that have 2305s as primary paging
devices and other direct access devices as secondary paging
devices. A full primary device and subsequent allocation of
paging space on the slower device may be responsible for
degradation of the system's performance. Use the PAGING WAIT operand when the QUEUES operand shows that a significant
proportion of the users in queue 1 and queue 2 are persistently
in page wait. The response to the command gives the userids of
those users currently in page wait and the number of page frames allocated on drum storage and on disk storage.
PAGING ALL
displays the page residency data of all users of the system (including the system nucleus and pageable routines). The
format of the reply message is identical to that of the PAGING WAIT operand ..
The intent of the INDICATE command is twofold:
1. Provide the operator with a "snapshot" of system activities.
2. Provide a means of determining the execution characteristics of a
program with respect to the resources it uses.
In respect to the latter, INDICATE USER should be invoked before and
after the execution of a program. If the INtICATE USER command is
issued during the execution of the subject program and the program is
issuing spooling I/O requests, the may questionable. The
reason this occurs is that S08e fields (specifically, the PCB=nnnnnnn,
PTR=nnnnnn and RDR=nnnnnn fields) in the response to the INDICATE USER co •• and are once (either at the beginning or at the end of an
operation). Other fields in the response are uFdated more dynamically. Consequently, you should avoid to halting or aborting any spooling
operation before its normal termination if the INDICATE USER command is
to be issued. Section 3. CP Commands 81