README.md
312,315 COLLECTION

SAN DIEGO, FALL 1979

THIS AREA CONTAINS SUBMISSIONS FROM G. EVERHART, RCA,
SINCE THE SAN FRANCISCO COLLECTION (12/1978).
PROGRAMS ARE AS FOLLOWS:

DDT22.MAC A SYMBOLIC DEBUGGER ENHANCED OVER THE DECUS LIBRARY
VERSION. THIS VERSION OF DDT WILL ATTACH THE CONSOLE AND
RETAINS THE DSW IN SYMBOL "$DSW" FOR EXAMINING DSW STATUS
DURING BREAKPOINTS WITHOUT THE USUAL ODT IS.SUC STATUS FROM
THE CONSOLE QIO$. IN ADDITION, THIS VERSION OF DDT HAS BEEN
CALLED DDT-22 BECAUSE IT SUPPORTS FULL 22 BIT PDP11 ADDRESSING
IF ASSEMBLED TO DO SO. THE INITIAL PART OF DDT CONTAINS A LIST
OF CONDITIONALS; READ IT TO FIND OUT HOW TO ASSEMBLE DDT.
THE 22 BIT MODE REQUIRES I/O PAGE ACCESS BUT DOES NOT
DEPEND ON THE OPERATING SYSTEM. IF HOWEVER RSX11M IS IN USE,
ONE MAY ASSEMBLE DDT TO EXAMINE/MODIFY ANOTHER TASK BY NAME
(THE COMMAND LOOKS LIKE $UL'TSKNAM') IF THE TASK IS IN MEMORY.
OTHERWISE, DDT WILL JUST ALLOW YOU TO FILL IN VIRTUAL PAR'S
(ASSUMING ALL PDR'S ARE SET TO 4K R/W MODE) AND USE THEM FOR
ADDRESSING. THESE ARE NAMED PAR0 THROUGH PAR7. NOTE THAT THE
REAL APR'S ARE MODIFIED ONLY TRANSIENTLY (AT PPRIORITY 7)
AND RESTORED SO THE OPERATING SYSTEM CANNOT FIND OUT ABOUT
THE CHANGES.
A FEW OTHER BELLS AND WHISTLES ARE ALSO ADDED. MOST
NOTABLY, DDT CAN NOW EXECUTE MACROS. THERE IS A COMMAND TO
FILL IN A LINE OF DDT COMMANDS, WHICH MAY THEN BE EXECUTED
WITH OR WITHOUT ECHOING OF THE COMMANDS ENABLED. CONTROL
RETURNS TO THE CONSOLE WHEN THE MACRO IS USED UP, OR ON
COMMAND FROM INSIDE THE MACRO (A GOOD IDEA...).
THE DDT SYMBOL TABLE MAY BE EXTENDED NOW BY ADDING
SYMBOLS TO .PSECT .SYMS$ WITH A TERMINATOR CONSISTING OF
3 ZERO WORDS A THE END. A SEPARATELY ASSEMBLED MODULE, IF
IT APPEARS AFTER DDT IN THE COMMAND TO TKB, WILL ADD MORE SYMBOLS
TO THE DDT SYMBOL TABLE. TO ENABLE THESE SYMBOLS, PUT
177777 IN THE SYMBOLIC LOCATIONS SYMEND AND SYMEND+2 WITH
DDT. ALL YOUR USER SYMBOLS WILL THEN BE AVAILABLE TO DDT.
NPUT.MAC NPUT IS A FORTRAN-CALLABLE FIELD MOVE SUBROUTINE.
IT ALLOWS A FIELD OF N BITS LENGTH (N LESS THAN 65536)
TO BE MOVVED FROM A LOCATION STARTING AT ANY BIT ANYWHERE
IN YOUR VIRTUAL ADDRESS SPACE TO A NON-OVERLAPPING FIELD
STARTING ANYWHERE ELSE (I.E., ON ANY BIT.) IT SHOULD BE
USEFUL FOR UNPACKING DATA FROM FOREIGN FORMAT STORAGE
DEVICES.
FPEM.MAC LOS ALAMOS SUBMITTED A PARTIAL RSX11M FLOATING
POINT UNIT EMULATOR SOME TIME AGO TO THE SIG TAPES.
IT WOULD NOT HANDLE ERRORS CORRECTLY. THIS IS A VERSION
THAT HANDLES ERRORS AND EMULATES AN FP11-C ON A (MAPPED)
RSX11M CONFIGURATION. TO USE IT, BE SURE YOUR RSX11M
SYSTEM IS SYSGENED FOR NO FLOATING POINT, AND THAT YOUR
VERSION OF THE F4P RUNTIME SYSTEM IS THE NON-FPP VERSION.
THEN TASKBUILD WITH THE /FP SWITCH. ONCE YOU FIX THE
FPEM TASK (BUILD ACCORDING TO INSTRUCTIONS IN THE SOURCE)
AND RUN IT (AT THE BOTTOM OF THE PARTITION!!! IT IS A
DISASTER TO HAVE IT SHUFFLED AND MOVED!), YOUR TASKS
THAT USE FLOATING POINT INSTRUCTIONS WILL WORK AS IF YOUR
MACHINE HAD AN FPU BOX. ILLEGAL INSTRUCTIONS WILLL CONTINUE
TO BE TREATED NORMALLY.
LISTRS.MAC THIS VERSION OF LIST/RSX ALLOWS OUTPUT FILES TO
BE APPENDED TO, AND CAN SPOOL THE OUTPUTS. THIS IS TO
WORK WITH THE RSX11M SPOOLER MAINLY, BUT IT CAN REDUCE
REDUNDANT BANNER SHEETS GENERATED BY THE SYSTEM. ALSO,
A SWITCH TO REMOVE MULTIPLE SPACES IS ADDED, AND A FEW
OTHER MINOR BELLS AND WHISTLES.
WNDMNG.MAC THIS FILE CONTAINS SOME ROUTINES THAT ASSUME THEY
ARE MAPPED TO THE I/O PAGE. THEY WILL PERFORM THE
EQUIVALENT OF A MAP$ OPERATION IN RSX11M (TESTED IN V3.1)
MUCH MORE QUICKLY THAN THE REAL RSX11M CAN WHERE FAST
MAPPINGS ARE NEEDED. THE VERSION HERE SETS UP A REGION
ALSO, AND ASSUMES PDR'S ARE PREVIOUSLY SET UP AS ALL
4K READ/WRITE MEMORY.