Personal brain dump of knowledge about KDF9’s workings

David Holdsworth

This info is from personal memory, and for the most part is not in books in my possession (SRLM, Programming Manual). Where I have doubts about the accuracy, this doubt is indicated. You may find it helpful to open the order-code listing in another window/tab.

Nesting Stores

The programmer sees two push-down stores, each with 16 cells, which are implemented so as to give register-speed access. Arithmetic takes place on the upper cells (known as N1, N2, etc), e.g. the + instruction adds the values in N1 and N2 leaving the result in N1. The contents of N3 are moved into N2, N4 into N3, and so on. Any attempt to remove information that it not there (e.g. ding + with only one cell occupied) causes a program interrupt, and is treated as a failure by director. What happens next depends entirely on what the director does. The EE directors output a verbose console message and a query offering a restart at word 4, or program termination. The Eldon2 director had a facility for a program to request that in the event of any failure a word 4 restart would occur without any operator intervention — or awareness.

In a multiprogramming KDF9, there were facilites for multiprogramming between four programs, including four nesting stores, four SJNSs and four sets of Q-stores.

In order to see how the machine operated it is best first to take the view as seen by director, and then the program-mode view becomes clear.

There are four core store stacks, each with 16 cells. Which one is used depends on the two bit register that specifies which set is used (I cannot remember where it is exactly, but it is part of the =K3 instruction -- which almost certainly explains why =K instructions do not nest up).

When something new is put in the nest, the contents of W3 are pushed into into the appropriate stack, the contents of W2 go into W3, and the contents of W1 go into W2. W1 takes the new data.

If you look at the code in P0 of director just after label 30:
              http://sw-pres.computerconservationsociety.org/KDF9/EDNTSD990.htm
                    you will see that after obeying =K3 to swap the nest, there are three cells removed (and one from SJNS which has a single flip-flop register) before obeying EXITD. This has the effect of taking the program’s info from its own core stack and sliding it up into W1-3 ready for the program to use.

Director programming involves taking great care not to use more than 3 cells before deciding to borrow the programmer’s nest and SJNS by calling P1 to dump them to memory. Notice that there is a second loop of ERASEs to flush out any data that might have got put there while doing a FAIL 00N. Presumably data was written in with an or process and read out destructively.

The other place to look is P29 which gives director access to the program’s nest. At this stage, the nest of the interrupted program is in the V-stores of P1, but the other three nests have to be acesses by use of the =K3 instruction. Judging by the slightly puerile style of the comment at the head pf P29, I made extensive modifications to EE’s original.

Peripheral Instructions

In the early days, the practice was to use mnemonics which indicated the type of device in the first letter, e.g. PREQ7 for a paper tape read to end-message using the parameters in Q7, or MFRQQ7 for a mag-tape forward read, or MBRQQ7 for a mag-tape backward read. Some time around 1965 EE seems to have got fed up of putting in new mnemonics for new types of peripheral like disk drives, and introduced new “mnemonics”, all begining with PI for peripheral input, PO for peripheral output and PM for peripheral manipulation/messing-about. So far so good, but the third letter was then just chosen in some sort of order (perhaps numerical order). The fourth letter was always Q. PIAQ5 (124,120) does a read on anything, mag-tape, paper tape, disk drive. The older mnemonics PRQ5, MFRQ5 (the ones in my book) both assembled to the same machine code as PIAQ5.

Disc drive

Our KDF9 in Leeds had two discs, both on the same pseudo-mag-tape channel. I recollect that there was capacity for 4 discs and the two bits in the upper part of the counter field of the Q-store (i.e. above the device number) indicated which disc.
PIAQq 124 20q read forwards (no special treatment of end-message) e.g. MFRQq, PRQq
read data from the moving head area of the disc
PIBQq 125 20q read forwards (upto and including end-message) e.g. MFREQq, PREQq
PICQq     reads fixed head on disk, may be same as MBREQq
PMAQq 134? 20q? set head position of a moving head on the disc
PMAQq 134 20q forward skip mag tape
Set seek address on disk - the address is in the upper bits of Cq
The seek actually happens when the data transfer is initiated
PMBQq 120 20q + 10 test beginning of mag tape
PMEQq 136 20q + 10 rewind mag tape or backskip???

Programming conventions in director

It would appear that there was a convention of not putting in enough comments. I plan to add in lots of commentary — marked to show that it is a later addition.

Immediately after loading director is entered at word 4, i.e. P200. This part of the code is free to use any registers and finishes by jumping into the tail end of the main director path which is entered on interrupt via word 0.

There is a short path in which the choice of next program to run can be made very quickly. This occurs for peripheral termination and lock-out violation relating to transfers on peripherals owned by user programs. The short path is the first part of the main program, and ends with the EXITD instruction immediately before label 35.

Other events cause much more computational fun -- called the long path.

I will add to these jottings when I have a bit of spare time. Please feed in any questions, contradictions that occur to you.

The long path

This starts at label 1 in P0. There is various worrying about program failure (especially nesting store failure) and calculation of ludicrously small amounts of time. Unless there has been a nesting store failure, the nest, SJNS and Q4, Q6 and Q7 of the interrupted program are dumped into core store by JSP1. Q5 was dumped earlier. This gives director some registers to work in. At label 20 it starts to look why the interrupt happened and calls the appropriate subroutines to service the interrupt.

P5 is of particular importance. It is called whenever a director-initiated transfer ends (EDT). Activities inside director that are not processed without interruption (e.g. disc transfers, waiting for mag tape to be loaded), are managed by a system of 10 “subprograms”, numbered 0 to 9. Subprograms 0 and 1 are used by the system (especially for implementing TINTs -- operator commands). Subprograms 2 and 3 are involved in servicing requests for program in priority 0. Subprograms 4 and 5 are involved in servicing requests for program in priority 1, etc. Priority 0 program is run if not held up. If it is held up priority 1 program is run if it is not held up, etc. Each program is given a program letter, P, Q, R or S. Program P runs on register set 0, through to S which runs on register set 3. When subprogram 2 is active, priority 0 is inhibited from running (held up), but subprogram 3 can run concurrently with the user program 0. Subprograms 4 and 5 have a similar relationship to the priority 1 program, while 6 and 7 relate to priority 2 and 8 and 9 to priority 3.

Much of the information relating to individual programs is held in the V-stores of P104. This are arranged in quartets. For the most part the relevant program priority is in M5. When executing code in a subprogram C4 holds the subprogram number, and M4 points at its memory area (which resides in the V=stores of P11). In order to enter subprogram mode it is only necessary to call P30. This sets up Q4, so that when a routine is called which causes the subprogram to be suspended awaiting anything, the relevant info is stored in the correct V-stores in P11. Subprogram suspension is normally by calling P10, when the subprogram’s SJNS is put in E30M4 and control returned to P11. A program keeps the same register set throughout its existence, but its priority can be swapped (TINT V), and when this happens all the corresponding V-stores in P104 are swapped over, and lots more besides, see P105;

Much more to follow — but first I think that I need to put lots of comments into the director source listing, comments that I should have put there in 1967-70!

Disc geometry

The Eldon2 paper from Computer Journal wrongly states that 640 words was used as the block size because it was one revolution of the disk. The real reason is that it was the same size as used by the english Electric PROMPT system, and we operated with exactly the same file format.

The disc (from Data Products) had individually addressable sectors of 40 words each (perhaps reflecting the zeitgeist where card images were commonly stored on magnetic media). There were 96 sectors on a track. There were 16 actual discs each with an independently moving head. There was also a set of fixed heads giving another 96 sectors for which no seek was involved.

The vanilla EE system allocated actual disks as work area, and reserved some as system disks.

The Eldon2 system reorganised the disk in terms of logical cylinders, each of which was composed of one track on each of the 16 discs. A quantitly of cylinders were reserved as the system area, and the rest claimable by programs for their own work area. The Eldon2 multi-access system used such space as swap area, with 19 sectors per teletype, i.e. 5 work areas per track (one sector wasted). A logical user disk had 8 tracks, i.e. half a cylinder.

Both regimes used the 640 word block as the allocation unit in the system disk area, i.e. 16 to one track.

The fixed heads held the ASL (Allocated Space List -- a bit map one bit per block, not a FAT), and the directory of binary programs loadable directly by director.

Operators’ Console

This was a Freiden Flexowriter with a few mods. The output to the console stopped on a sem-colon and switched to an input — much used for operator queries.

Director

I think that we have 4 director versions between us:
          1. The binary paper tape KKT40E007UPU, which I believe will turn out to be vanilla English Electric
          2. The Oxford director dated 13/2/69, just a lineprinter listing in my possession
          3. The Eldon2 director as used at Leeds -- just memories in my head
          4. The Eldon2 director as used at NPL -- the source text in a file with typos, many thanks to Hans Pufal

These four are probably in chronological order. While at Oxford, I put some improvements into the English Electric director (e.g. the output spooling - OUT8). I took that with me to Leeds in 1967, and there was interchange between Leeds and Oxford, before Oxford decided to go for EGDON rather then Eldon2. NPL took up the Eldon2 route, and there was interchange between Leeds and NPL. The NPL machine outlived the Leeds machine, and there were enhancements at NPL that did not make the journey northwards. In 3 and 4 above there were extra OUTs concerned with JobOrganiser (a name cribbed from EGDON and held in a file called EDNJOGN--UPU). This program was loaded whenever memory became free and a level was available. It then transformed itself into a new job.

The Eldon2 multi-access system ran in level 0 as a systems program, allowing it to modify the files in the system area. It used the INTQq instruction when waiting for peripheral transfers, and included a module that printed the contents of the output well (OUT8 tapes). This meant that the peripheral transfers on the tape deck and printer only invoked the director short path, and we did not have to use a precious program level to a printer program (often called a de-streamer).

The Leeds machine was redeployed into a student facility in about 1972, and cafeteria facilities were added to the director, so that a cafeteria reader (card or paper tape) had a program associated with it, and director kept a read active when there was no job using that reader. When the read was satisfied the associated program was loaded. I believe that director left something in the nest which was used to access the data just read in. The paper tape reader was associated with a WALGOL system, and the card reader with Leeds's own FORTRAN system.