[ ENTER PR~CESSOR NAMe
STATS COMMAND SUMMARY
Table 28 contains a summary of commands. Table 29 con-tains a summary of interactive statements. The Interactive statements are used in conjunction with the commands for defining the tasks that STATS is to perform.
Create a display of performance data and output it to the line printer. (The report would be printed on the user·s
~erminal if the ISET M:lO LP command were omitted.) No permanent file of performance data is generated.
lSET M:l 0 LP
e
~STATS €;
STATS [)1)O HERE
::..A8
ENTI~R ITEMS TO HE AnnED
LA1.r.
l,!~ -2END ~~-D1 (~-;'
ENTER :::NTER7AL '[~ MINUTES
~2 ~"T)
ENTER 4ft OF INTERVAlS
.210
~)-..:.ENDCm)
~PRII-';T ~,~
The IPRINT command releases the listing to the printer.
Example 2.
Create snapshot files on-I ine.
!STATS t§
3TATS DOO 'lERE
~F8----FNTER INTERVAL IN t-11NUTES
?') ~,
-I:NTER 1ft OF INTERVALS
~2 0~
SNAPSHOT FI1~S OPENED
RECoRi)#l~-': {~: 10 JUL 21. '75 REeORO if 2, 14:.!2....}JD~~
SNAPSHOT FILE COMPLETED ,:E
0")
98 STATS
Example 3.
Run STATS as a ghost job. Every 15 minutes, snapshot records are added to the SNAPSHOT .:STATS file. The job will "sleep" between times.
The job is initiated by the operator via the key-in lGJOB STATS @
The fi Ie GHOSTSI contains the following instructions to STATS:
'1( STATS SLEEPING GHOST INPUT FILE TO CREATE SHAPSHOT FILES
'1( KEY-IN ' GJOB STATS' AT THE BEGINNING OF EACH DAY
'1( AND AFTER EACH SYSTEM RESTART OR RECOVERY.
'1( TIlE FOLLOWING FILES ARE CREATED AND/OR UPDATED
*
SNAPSHOT.:STATS - KEYED SNAPSHOT FILE~.( GHOSTDO. : STATS - INTERACTIVE OUTPUT
~.( GHOSTLO. : STATS - REPORT OUTPUT
-k SNAPSHOT FILE MAY BE SAVED WEEKLY TO SAVE FILE SPACE F
15
*
96 96 INTERVALS AT 15 MINUTES DURATION COVERS 24 HOURS •• EDIT TO SUIT ENDA message is typed on the operator's console to verify that the snapshot file is opened. At the conclusion, another message is typed on the operator's console to verify that the snapshot file is closed.
Message
BUILD LIST ERROR
Table 27. STATS Error Messages Description
The BUILD list number is missing or is not in the range 0-7.
I--~-~-------.---.. -.---.---1 CANNOT MAINTAIN INTERVAL During operation of a DISPLAY or FILE command, the
output device is unable to complete one display in time to print the next display. (The interval is too short. )
I--~---.---.-... --.-.--.. - - - . - - . - . - - - . - - - i
GHOSTDO FILE ERROR, M:DO - RESTART STATS is being nm as a ghost job and has attempted to create disk fi Ie 'GHOSTDO' that is in error. The error is due either to lack of fi Ie space or to interfer-ence from anoth~~r user. (Printed on operator's console .)
I--~---.--- ---.---. .--.-- .. ---.---... ----GHOSTLO FILE ERROR, M:LO - RESTART STATS is being nm as a ghost job and has attempted to
create a disk file 'GHOSTLO' that is in error. The error is due either to lack of file space or to inerference from another user. (Printed on operator's console.) 1 - - - _ . __ .. _---- ----.---.---. -_.-- .---.. -.-... -.. ---.--.
--.-.--GHOSTSI FILE ERROR, M:SI - RESTART STATS is being nm as a ghost job and the disk fi Ie
"GHOSTSI' is in error. Commands and responses to interactive questiions and statements may only be input via GHOSTSI when STATS is run as a ghost job.
(Printed on operator's console.)
' - - - ' - - - , - - -
---_._---90 116 74H-1 (11/76) STATS 99
Table 27. STATS Error Messages (cont.)
Message Description
ILLEGAL COMMAND The user's response to a command level prompt (-) is
not a legal command. (If this is a batch job, the com-mands may be out of sequence.)
MONITOR ACCESS REQUIRES PRIV
=
80 The user account must be reauthorized to allow the user to read monitor performance data.NO SUCH NAME An invalid name was used when entering items for an
ADD or DROP command. Only the item names in Table 26 are valid. The standard display numbers are not val id for the DROP command.
NOT ENOUGH CORE AUTHORIZED The number of pages allocated in the user account is not sufficient since STATS only maps onto those pages in which the required data resides and obtains the cor-responding virtua I pages, the processor and its acquired pages should be executable in 16K of core.
PROBLEM GETTING PRIVATE PAGE In a multiprocessing system, an error has been encoun-tered in attempting to map onto the private data page of the secondary CPUs. This may be due to a system or program error and, genera lIy, shou Id not occur.
PROCESSOR #n name Extended monitoring is being performed for the
proces-sor specified by 'name' which hasthe index number n.
PROCESSOR MONITORING STOPPED STATS is no longer performing extended monitoring for a processor.
PROCESSOR NOW BEING MONITORED Extended monitoring is being performed for the proces-sor named in the message which follows this message.
REPLACED A PROCESSOR BEING MONITORED Extended monitoring was a I ready being performed for a processor when the SETPROC command was issued.
SETPROC REQUIRES CO PRIVILEGE An attempt has been made to establish extended mon-itoring of a processor when running in an account that has less than CO privi lege.
STATS LOADED WITH WRONG MONSTK STATS has been loaded with a MONSTK that is dif-ferent from the system MONSTK. The processor must be re loaded.
STATS SNAPSHOT FILE ERROR An error has occurred during creation of a SNAPSHOT file entry. File space may have been exhausted or another user in the account may have interfered.
UNEXPECTED CHANGE IN TIME - REPORT SKIPPED This is either a user error, system error, or MONSTK problem since C:TIC and C:TINC should result in ever increasing values.
100 STATS
Table 28. STATS Command Summary
Command Description
---_.
-A [DD] Turns on the print flags for the specified items. An item may be the name of ENTER ITEMS TO BE ADDED any item in Table 26.
~item
2item
· ·
2:END
BREAK (i.e. 9) Interrupts any current STATS operation and leaves control at the STATS com-' mand level. The PROCEED command is used to resume execution from the point of interrupt.
~---'"
B[UILD] n Turns on the print flags for the standard dIsplay specified by n where n is a num-ber in the range 0-7. See Table 26 for the numbers of the standard displays.
BUILD 0 resets all the flags to off.
C[ONTROLl] Displays all control parameters critical to system perfc)rmance whether or not their print flags are on •
..
-DI[SPL.AY] Displays those items (from the group of itenns listed in Table 26) that have their print flags on. A snapshot file- may be generated during DISPLAY command ex-ecution if the SNAPSHOT flag is on.
~---D[ROP] Turns off the print flags for the specified 'items. An item may be the name of ENTER ITEMS TO BE DROPPED any item in Table 26.
~item
~item
· ·
2:END
·
-.---~-
-E[ND] Causes an exit to TEL..
END Terminates a DROP or ADD command list ..
-F[ILE] Creates snapshot records for the SNAPSHOT file. An on-line report may be generated simultaneously by t'urning the REPORT flag and the desired print flags on.
H[ELP] Briefly describes STATS commands and DeB usage.
---
._-._--L[IST] Lists the STATS flags (other than standard display numbers) and their current status (on or off) •
---
-P[ROCEED] Continues STATS operation from the point· at which the processor was interrupted by the BREAK key.
-S[ETPROC] Estab I ishes the processor for extended monitoring.
-.
TIME
Lists the time and date.STATS 101
Table 29. STATS Interactive Statements
Statement Description of Response
ENTER INTERVAL IN MINUTES Enter an integer (without a decimal point and without leading or embedded blanks) • This number defines the length of the sample for the DISPLAY or FILE command.
ENTER ITEMS TO BE ADDED Enter a list of display items, display groups, or pri nt flags to be added for sub-sequent report format control.
ENTER ITEMS TO BE DROPPED Enter a list of display items or print flags to be dropped for subsequent report format control.
ENTER # OF INTERVALS Enter an integer (without a decimal point and without leading or embedded blanks) • This integer defines the number of intervals to be used for the DISPLAY or FILE command.
-
--ENTER PROCESSOR NAME Enter the name of a shared processor to be monitored. The name must be less than 8 characters in length and must be the name by which the processor is identified in the P:NAME table •
. SUMMARY
The Summary processor provides a global view of system performance by formatting and displaying the statistical data collected by STATS. The input data for Summary is the SNAPSHOTS files created by STATS. The output I isti ngs are genera Ily large and therefore shou Id
be output to a fi Ie or on the I ine printer. The DC B s used by Summary are I isted in Table 30.
The Summary processor allows the user to
1. Specify a fi Iter to remove undesired snapshots from the sample for subsequent reports.
2. Request a chronological listing of filtered snapshot data for one or more display groups.
3. Request fi Itered, sorted, ordered, and averaged I ist-ings of snapshot data for one or more display groups.
4. Request means, minimums, maximums, and standard deviations for all display groups computed using the snapshots which pass the filter and a user specified intensity range. Correlation coefficients are included in this report that are estimates of the linear depend-ence between any pair of monitored variables.
Summary can be run in either the batch or on-line modes.
In the batch mode, Summary is called with the SUMMARY control command. The series of cards that follow require an anticipation of the interaction that occurs when Summary is run on-line. This point is explained in the fourth ex-ample of the section "Sex-ample Summary Sessions". The rest of this discussion of Summary will assume that the processor
is being run on-line.
102 Summary
In the on-I ine mode, Summary is called by entering its name as a TEL command. Summary responds by typing SUMMARY HERE. Summary uses two prompt characters. The highest level prompt character is a single dash (-). The secondary prompt character is the Igreater than ' character (».
Example:
I SUMMARY @) SUMMARY HERE .::.
Control can be returned to TEL in three ways:
1. Depressing the BREAK key four times.
2. Depressing the CONTROL and Y keys.
3. Responding with an X or END to a yes/no type question from Summary.