FEBRUARY 23, 1981

RBTSPY AND RBTDMP TOGETHER ARE A PACKAGE TO HELP USERS TROUBLESHOOT
VARIOUS AND SUNDRY COMMUNICATIONS PROBLEMS. RBTSPY HOOKS INTO THE I/O
SYSTEM AND RECORDS DATA TRANSFER IN A FILE CALLED 'DSCTRACE' IN WHATEVER
ACCOUNT IT IS RUN. RBTDMP TAKES THIS FILE AS INPUT (THRU DCB F:1),
AND FORMATS A REPORT SHOWING WHAT TRANSPIRED DURING THE TIME RBTSPY WAS
RUNNING.

TO LOAD BOTH PROGRAMS, BATCH OFF THE JOB 'LOADRBTSPY'.

TO USE RBTSPY, SIMPLY INVOKE IT VIA '!RBTSPY.'. WHEN PROMPTED FOR
THE DCT INDEX, ENTER THE DECIMAL DCT INDEX CORRESPONDING TO THE ADDRESS
OF THE PODC (MODEL 7605, ETC) YOU WANT TO SPY ON (ANLZ'S 'DI DCT' COMMAND
WILL GIVE YOU THE DCT INDEX). MONITORING WILL BEGIN WHEN YOU HIT RETURN
AFTER ENTERING THE DCT INDEX. THE MESSAGE 'TRACE STARTED' IS YOUR INDICATION
THAT IT IS RUNNING. THE MESSAGE 'CAN'T GET PAGE' INDICATES IT WAS UNABLE
TO ACQUIRE A PAGE FROM THE MONITOR (IN THE LOWER 128K). IN A NORMALLY
ACTIVE SYSTEM, ANOTHER GO AT IT SHOULD NET YOU THE PAGE NEEDED.

*** W A R N I N G ***
****                   RBTSPY WILL HOG A CPU MOSTLY TO ITSELF, THEREBY
****                   SEVERELY DEGRADING OTHER USERS' RESPONSE TIME.
****                   IT SHOULD ONLY BE RUN FOR SHORT PERIODS; JUST
****                   ENOUGH TO GATHER REPRESENTATIVE DATA (UNLESS OF
****                   COURSE THERE'S NO ONE ELSE ON THE SYSTEM!).

WHEN YOU FEEL YOU HAVE CAPTURED THE ELUSIVE BITS YOU ARE HUNTING,
SIMPLY HIT BREAK OR CONTROL-Y, AND SAY QUIT. THE MESSAGE 'TRACE COMPLETED'
IS YOUR INDICATION IT HAS CLEANED UP AFTER ITSELF AND HAS EXITED.

RBTDMP MAY THEN BE USED TO CONVERT THE TRAPPED DATA INTO A FORM MORE
SUITABLE FOR VIEWING. DATA INPUT IS THRU F:1, REPORT OUTPUT THRU F:108,

WIDE/NARR   -  ENTER WIDE IF YOU ARE GOING TO THE LINE PRINTER OR ARE
               LUCKY ENOUGH TO BE RUNNING ONLINE AT A 132 CHAR WIDE TERMINAL.
               OTHERWISE ENTER NARR.

SKIP #      -  ENTER THE NUMBER OF RECORD (FROM THE BEGINNING OF THE FILE)
               YOU WISH TO SKIP IN THE REPORT. A ZERO STARTS AT THE BEGINNING.


THE OUTPUT FROM RBTDMP IS SELF-EXPLANATORY. NOTE THAT RBTSPY IS NOT
INFALLIBLE; RECORDS CAN BE MISSED ON A VERY BUSY SYSTEM - ALWAYS CHECK
FOR 'LOST ENTRIES' MESSAGES IN THE PRINTOUT IF YOU THINK SOMETHING IS MISSING.


THIS HANDY TOOL WAS DEVELOPED AT CUMMINS YEARS AGO, AND HAS PROVEN TO
BE VALUABLE IN SITUATIONS WHERE A LINE MONITOR CANNOT BE SCROUNGED UP.
IT IS BEING DISTRIBUTED ON THE SST AS AN AID TO THE TAC IN ANALYZING
COMMUNICATIONS-RELATED PROBLEMS. NO SUPPORT IS EXPRESSED OR IMPLIED.
