SPY.DOC SPY VS02.0 10/23/79 Aeronautical Research Associates of Princeton (A.R.A.P.) Box 2229, Princeton, NJ 08540 (609) 452-2950 Author: J.D. Leonard SPY is an interactive display program written in the spirit of DEMO and similar to the display's available on the VAX. SPY will dynamically display timesharing task activity on an IAS system. It was developed on IAS VS3.0, so some changes may need to be made for IAS VS2.0. SPY will run on terminals which support direct cursor addressing. Refer to SPYBLD.DOC and SPYIN.FTN to build SPY for various terminal types. The default is VT52. SPY uses about 5700 words for a 32 terminal 8 batch stream system and about 5200 words for a 16 terminal 4 batch stream system. CPU requirements are on the order of DEMO for similar update intervals. SPY will display itself while running so you can see how much of the system it is using. SPY currently offers a choice of 2 displays. Future versions will hopefully display information on disk activi- ty. Display #1 shows the percent of CPU time spent in Batch, Interactive or terminals, Swap time, Null time, and Real time or System time. Percent, # of ticks accumulated over last interval, and bar graphs showing the percentages are updated at the specified interval. The percentages are the same as those displayed in the new DECUS DEMO program. Display #2 shows timesharing job activity on a per-terminal basis. Each line shows the TI, username, jobs running (up to 3), total ticks accumulated for the job(s), ticks used since last display update, percent utilization of elaplsed time, and a bar graph of the percentage used. Up to 70% is shown on the graph. The display is updated at the specified interval, a'la DEMO. The command line to initiate $$$SPY is as follows - PDS> SPY[display #] [terminal type] where - display # is either 1 or 2. If not supplied the default display (task build parm) will be run. terminal type is a 4 character mneumonic to des- cribe the type of terminal SPY will be running on. This is to set the proper escape sequences if they differ from the default. See SPYIN.FTN to define terminal types other than the VT52. e.g. PDS> SPX1 PDS> SPX BEEHIVE PDS> SPX2 ADM SPY.DOC -2- SPY VS02.0 10/23/79 The following commands are available while SPY is run- ning. Input is processed as it is in DEMO. Dn where n = 1 changes to display 1 and n = 2 changes to display 2 In where n is the time between display updates in seconds, like DEMO. C Clear screen and refresh display. X or ^Z Cause SPY to exit. The following command descriptions pertain only to display number 2. Ln where n is the number of lines to display, normal- ly 24. e.g. may set to 14 if on VT100 in 132 col mode. The value of L is shown at the bottom of display 2 (L=n). R range1,range2, ....rangen Set the range of terminals to display where range1 through rangen can be any one of the following - DEF - set range to default setting specified at task build time. ALL - set range for all possible terminals to dis- play. Will set to display MAXTT terminals and MAXBA batch streams. See SPYBLD.DOC and SPY.CMD. TTn or BAn - for a single terminal where n is the octal unit number. TTn-m or BAn-m - for an inclusive range of termi- nals where n,m are the octal unit numbers. m must be .GE. to n. Any combination of the above is valid, presuming the unit numbers are within the upper limits set by MAXTT and MAXBA. e.g. R TT1-6,BA0-2,TT15,TT20 R ALL R DEF,BA5 SPY.DOC -3- SPY VS02.0 10/23/79 ** Notes on display 2 ** If the selected range encompasses more terminals than there is room to display them, SPY will - 1) Try to display terminals with only users logged on, if this exceeds the display area then - 2) SPY will select those logged on with jobs running or suspended. If this number is less than the display area, some terminals only logged on will also be shown, to fill out the display. If the number of terminals with jobs running is greater than the display area then - 3) SPY will select the jobs with the largest percent use- age and display only those jobs. Setting L to a small number will force this deduction to take place. Also shown on display 2 is 'SF', the swap flag indicator. If this is '*' then one of the jobs running from that termi- nal was swapped out when SPY 'looked' at it. Time of day and ticks elapsed since last update are displayed on the top line. On the bottom line is the sum of all timesharing jobs CPU useage divided by elapsed time to give percent utiliza- tion. UNS is the number of users (logged on) not shown if they exceed the number of lines to display, and JNS which is jobs not shown if there are some of those not displayed.