Home » CEEFAX disks » telesoftware14.adl » 27-03-89/Edit

27-03-89/Edit

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » CEEFAX disks » telesoftware14.adl
Filename: 27-03-89/Edit
Read OK:
File size: 0A98 bytes
Load address: 0000
Exec address: FFFFFFFF
File contents
                      SECTOR EDITOR INSTRUCTIONS


This is a brief outline of the workings of the sector editor. To use it to
its fullest potential requires a knowledge of the workings of the BBC disc
system, and the 8271 chip in particular, beyond the scope of these basic
notes, and a suitable text should be consulted, such as Macmillans 'The
complete disc manual for the BBC micro computer'.

Note that the program is for DFS systems on a BBC B, using the 8271 chip.
Also it is written in Basic, largely to allow easy modification, and that
inevitably slows things down.

The basic function of the program is to allow direct editing of a disc,
altering sectors and tracks directly. That makes it extremely powerful,
and you should only use it to work on backed up discs, or on otherwise
irretrievably corrupted discs. YOU HAVE BEEN WARNED.

On CHAINing the program, you will be asked for the drive and track to be
viewed. After a short while, the first sector will be displayed, along
with its physical and logical indices, and whether the data was stored as
deleted or was corrupted.

Any Disc read errors will be diplayed as they occur, and five retries
performed before the program reads the sector as best it can. In such
cases the data accuracy will of course be questionable.

The following keys control the program:

S     Display next sector. If the sector is bigger than 256 bytes, the
      sector is displayed in parts, and this command refers to the part
      sector.

D     Display previous sector/part sector

T     Next track

R     Previous track

J     Jump to track - number prompted for

P     Display track info - sector numbers, data type, logical track nos
      etc

I     Display instructions

H     Toggle between hex and ascii diplay

E     Edit sector. Cursor keys move around sector,
                   in Hex mode, enter hex values
                   in ascii, enter ascii (including control codes)
      CTRL-@ hex/asci, to exit type COPY.
      On exiting you will be asked whether you want to write the
      sector, and if so the form in which it is to be written.

W     Write track. You will be asked which track you want to write,
      whether you want to change the sector sizes, numbers, data types
      and so on. Complicated, and you should know what you are doing
      if you hope to be able to use the disc. Note that only 256 byte
      sectors of convential data type, and where the logical and physical
      track numbers match, will be accepted by the DFS.


Good luck!. I'd advise messing around with it for some time before you use
it in anger. Even so, always make a backup before you work on a disc.
Unexpected things can and will happen.

R.I.M.Sadek.
00000000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000010  20 20 20 20 20 20 53 45  43 54 4f 52 20 45 44 49  |      SECTOR EDI|
00000020  54 4f 52 20 49 4e 53 54  52 55 43 54 49 4f 4e 53  |TOR INSTRUCTIONS|
00000030  0d 0d 0d 54 68 69 73 20  69 73 20 61 20 62 72 69  |...This is a bri|
00000040  65 66 20 6f 75 74 6c 69  6e 65 20 6f 66 20 74 68  |ef outline of th|
00000050  65 20 77 6f 72 6b 69 6e  67 73 20 6f 66 20 74 68  |e workings of th|
00000060  65 20 73 65 63 74 6f 72  20 65 64 69 74 6f 72 2e  |e sector editor.|
00000070  20 54 6f 20 75 73 65 20  69 74 20 74 6f 0d 69 74  | To use it to.it|
00000080  73 20 66 75 6c 6c 65 73  74 20 70 6f 74 65 6e 74  |s fullest potent|
00000090  69 61 6c 20 72 65 71 75  69 72 65 73 20 61 20 6b  |ial requires a k|
000000a0  6e 6f 77 6c 65 64 67 65  20 6f 66 20 74 68 65 20  |nowledge of the |
000000b0  77 6f 72 6b 69 6e 67 73  20 6f 66 20 74 68 65 20  |workings of the |
000000c0  42 42 43 20 64 69 73 63  0d 73 79 73 74 65 6d 2c  |BBC disc.system,|
000000d0  20 61 6e 64 20 74 68 65  20 38 32 37 31 20 63 68  | and the 8271 ch|
000000e0  69 70 20 69 6e 20 70 61  72 74 69 63 75 6c 61 72  |ip in particular|
000000f0  2c 20 62 65 79 6f 6e 64  20 74 68 65 20 73 63 6f  |, beyond the sco|
00000100  70 65 20 6f 66 20 74 68  65 73 65 20 62 61 73 69  |pe of these basi|
00000110  63 0d 6e 6f 74 65 73 2c  20 61 6e 64 20 61 20 73  |c.notes, and a s|
00000120  75 69 74 61 62 6c 65 20  74 65 78 74 20 73 68 6f  |uitable text sho|
00000130  75 6c 64 20 62 65 20 63  6f 6e 73 75 6c 74 65 64  |uld be consulted|
00000140  2c 20 73 75 63 68 20 61  73 20 4d 61 63 6d 69 6c  |, such as Macmil|
00000150  6c 61 6e 73 20 27 54 68  65 0d 63 6f 6d 70 6c 65  |lans 'The.comple|
00000160  74 65 20 64 69 73 63 20  6d 61 6e 75 61 6c 20 66  |te disc manual f|
00000170  6f 72 20 74 68 65 20 42  42 43 20 6d 69 63 72 6f  |or the BBC micro|
00000180  20 63 6f 6d 70 75 74 65  72 27 2e 0d 0d 4e 6f 74  | computer'...Not|
00000190  65 20 74 68 61 74 20 74  68 65 20 70 72 6f 67 72  |e that the progr|
000001a0  61 6d 20 69 73 20 66 6f  72 20 44 46 53 20 73 79  |am is for DFS sy|
000001b0  73 74 65 6d 73 20 6f 6e  20 61 20 42 42 43 20 42  |stems on a BBC B|
000001c0  2c 20 75 73 69 6e 67 20  74 68 65 20 38 32 37 31  |, using the 8271|
000001d0  20 63 68 69 70 2e 0d 41  6c 73 6f 20 69 74 20 69  | chip..Also it i|
000001e0  73 20 77 72 69 74 74 65  6e 20 69 6e 20 42 61 73  |s written in Bas|
000001f0  69 63 2c 20 6c 61 72 67  65 6c 79 20 74 6f 20 61  |ic, largely to a|
00000200  6c 6c 6f 77 20 65 61 73  79 20 6d 6f 64 69 66 69  |llow easy modifi|
00000210  63 61 74 69 6f 6e 2c 20  61 6e 64 20 74 68 61 74  |cation, and that|
00000220  0d 69 6e 65 76 69 74 61  62 6c 79 20 73 6c 6f 77  |.inevitably slow|
00000230  73 20 74 68 69 6e 67 73  20 64 6f 77 6e 2e 0d 0d  |s things down...|
00000240  54 68 65 20 62 61 73 69  63 20 66 75 6e 63 74 69  |The basic functi|
00000250  6f 6e 20 6f 66 20 74 68  65 20 70 72 6f 67 72 61  |on of the progra|
00000260  6d 20 69 73 20 74 6f 20  61 6c 6c 6f 77 20 64 69  |m is to allow di|
00000270  72 65 63 74 20 65 64 69  74 69 6e 67 20 6f 66 20  |rect editing of |
00000280  61 20 64 69 73 63 2c 0d  61 6c 74 65 72 69 6e 67  |a disc,.altering|
00000290  20 73 65 63 74 6f 72 73  20 61 6e 64 20 74 72 61  | sectors and tra|
000002a0  63 6b 73 20 64 69 72 65  63 74 6c 79 2e 20 54 68  |cks directly. Th|
000002b0  61 74 20 6d 61 6b 65 73  20 69 74 20 65 78 74 72  |at makes it extr|
000002c0  65 6d 65 6c 79 20 70 6f  77 65 72 66 75 6c 2c 0d  |emely powerful,.|
000002d0  61 6e 64 20 79 6f 75 20  73 68 6f 75 6c 64 20 6f  |and you should o|
000002e0  6e 6c 79 20 75 73 65 20  69 74 20 74 6f 20 77 6f  |nly use it to wo|
000002f0  72 6b 20 6f 6e 20 62 61  63 6b 65 64 20 75 70 20  |rk on backed up |
00000300  64 69 73 63 73 2c 20 6f  72 20 6f 6e 20 6f 74 68  |discs, or on oth|
00000310  65 72 77 69 73 65 0d 69  72 72 65 74 72 69 65 76  |erwise.irretriev|
00000320  61 62 6c 79 20 63 6f 72  72 75 70 74 65 64 20 64  |ably corrupted d|
00000330  69 73 63 73 2e 20 59 4f  55 20 48 41 56 45 20 42  |iscs. YOU HAVE B|
00000340  45 45 4e 20 57 41 52 4e  45 44 2e 0d 0d 4f 6e 20  |EEN WARNED...On |
00000350  43 48 41 49 4e 69 6e 67  20 74 68 65 20 70 72 6f  |CHAINing the pro|
00000360  67 72 61 6d 2c 20 79 6f  75 20 77 69 6c 6c 20 62  |gram, you will b|
00000370  65 20 61 73 6b 65 64 20  66 6f 72 20 74 68 65 20  |e asked for the |
00000380  64 72 69 76 65 20 61 6e  64 20 74 72 61 63 6b 20  |drive and track |
00000390  74 6f 20 62 65 0d 76 69  65 77 65 64 2e 20 41 66  |to be.viewed. Af|
000003a0  74 65 72 20 61 20 73 68  6f 72 74 20 77 68 69 6c  |ter a short whil|
000003b0  65 2c 20 74 68 65 20 66  69 72 73 74 20 73 65 63  |e, the first sec|
000003c0  74 6f 72 20 77 69 6c 6c  20 62 65 20 64 69 73 70  |tor will be disp|
000003d0  6c 61 79 65 64 2c 20 61  6c 6f 6e 67 0d 77 69 74  |layed, along.wit|
000003e0  68 20 69 74 73 20 70 68  79 73 69 63 61 6c 20 61  |h its physical a|
000003f0  6e 64 20 6c 6f 67 69 63  61 6c 20 69 6e 64 69 63  |nd logical indic|
00000400  65 73 2c 20 61 6e 64 20  77 68 65 74 68 65 72 20  |es, and whether |
00000410  74 68 65 20 64 61 74 61  20 77 61 73 20 73 74 6f  |the data was sto|
00000420  72 65 64 20 61 73 0d 64  65 6c 65 74 65 64 20 6f  |red as.deleted o|
00000430  72 20 77 61 73 20 63 6f  72 72 75 70 74 65 64 2e  |r was corrupted.|
00000440  0d 0d 41 6e 79 20 44 69  73 63 20 72 65 61 64 20  |..Any Disc read |
00000450  65 72 72 6f 72 73 20 77  69 6c 6c 20 62 65 20 64  |errors will be d|
00000460  69 70 6c 61 79 65 64 20  61 73 20 74 68 65 79 20  |iplayed as they |
00000470  6f 63 63 75 72 2c 20 61  6e 64 20 66 69 76 65 20  |occur, and five |
00000480  72 65 74 72 69 65 73 0d  70 65 72 66 6f 72 6d 65  |retries.performe|
00000490  64 20 62 65 66 6f 72 65  20 74 68 65 20 70 72 6f  |d before the pro|
000004a0  67 72 61 6d 20 72 65 61  64 73 20 74 68 65 20 73  |gram reads the s|
000004b0  65 63 74 6f 72 20 61 73  20 62 65 73 74 20 69 74  |ector as best it|
000004c0  20 63 61 6e 2e 20 49 6e  20 73 75 63 68 0d 63 61  | can. In such.ca|
000004d0  73 65 73 20 74 68 65 20  64 61 74 61 20 61 63 63  |ses the data acc|
000004e0  75 72 61 63 79 20 77 69  6c 6c 20 6f 66 20 63 6f  |uracy will of co|
000004f0  75 72 73 65 20 62 65 20  71 75 65 73 74 69 6f 6e  |urse be question|
00000500  61 62 6c 65 2e 0d 0d 54  68 65 20 66 6f 6c 6c 6f  |able...The follo|
00000510  77 69 6e 67 20 6b 65 79  73 20 63 6f 6e 74 72 6f  |wing keys contro|
00000520  6c 20 74 68 65 20 70 72  6f 67 72 61 6d 3a 0d 0d  |l the program:..|
00000530  53 20 20 20 20 20 44 69  73 70 6c 61 79 20 6e 65  |S     Display ne|
00000540  78 74 20 73 65 63 74 6f  72 2e 20 49 66 20 74 68  |xt sector. If th|
00000550  65 20 73 65 63 74 6f 72  20 69 73 20 62 69 67 67  |e sector is bigg|
00000560  65 72 20 74 68 61 6e 20  32 35 36 20 62 79 74 65  |er than 256 byte|
00000570  73 2c 20 74 68 65 0d 20  20 20 20 20 20 73 65 63  |s, the.      sec|
00000580  74 6f 72 20 69 73 20 64  69 73 70 6c 61 79 65 64  |tor is displayed|
00000590  20 69 6e 20 70 61 72 74  73 2c 20 61 6e 64 20 74  | in parts, and t|
000005a0  68 69 73 20 63 6f 6d 6d  61 6e 64 20 72 65 66 65  |his command refe|
000005b0  72 73 20 74 6f 20 74 68  65 20 70 61 72 74 0d 20  |rs to the part. |
000005c0  20 20 20 20 20 73 65 63  74 6f 72 2e 0d 0d 44 20  |     sector...D |
000005d0  20 20 20 20 44 69 73 70  6c 61 79 20 70 72 65 76  |    Display prev|
000005e0  69 6f 75 73 20 73 65 63  74 6f 72 2f 70 61 72 74  |ious sector/part|
000005f0  20 73 65 63 74 6f 72 0d  0d 54 20 20 20 20 20 4e  | sector..T     N|
00000600  65 78 74 20 74 72 61 63  6b 0d 0d 52 20 20 20 20  |ext track..R    |
00000610  20 50 72 65 76 69 6f 75  73 20 74 72 61 63 6b 0d  | Previous track.|
00000620  0d 4a 20 20 20 20 20 4a  75 6d 70 20 74 6f 20 74  |.J     Jump to t|
00000630  72 61 63 6b 20 2d 20 6e  75 6d 62 65 72 20 70 72  |rack - number pr|
00000640  6f 6d 70 74 65 64 20 66  6f 72 0d 0d 50 20 20 20  |ompted for..P   |
00000650  20 20 44 69 73 70 6c 61  79 20 74 72 61 63 6b 20  |  Display track |
00000660  69 6e 66 6f 20 2d 20 73  65 63 74 6f 72 20 6e 75  |info - sector nu|
00000670  6d 62 65 72 73 2c 20 64  61 74 61 20 74 79 70 65  |mbers, data type|
00000680  2c 20 6c 6f 67 69 63 61  6c 20 74 72 61 63 6b 20  |, logical track |
00000690  6e 6f 73 0d 20 20 20 20  20 20 65 74 63 0d 0d 49  |nos.      etc..I|
000006a0  20 20 20 20 20 44 69 73  70 6c 61 79 20 69 6e 73  |     Display ins|
000006b0  74 72 75 63 74 69 6f 6e  73 0d 0d 48 20 20 20 20  |tructions..H    |
000006c0  20 54 6f 67 67 6c 65 20  62 65 74 77 65 65 6e 20  | Toggle between |
000006d0  68 65 78 20 61 6e 64 20  61 73 63 69 69 20 64 69  |hex and ascii di|
000006e0  70 6c 61 79 0d 0d 45 20  20 20 20 20 45 64 69 74  |play..E     Edit|
000006f0  20 73 65 63 74 6f 72 2e  20 43 75 72 73 6f 72 20  | sector. Cursor |
00000700  6b 65 79 73 20 6d 6f 76  65 20 61 72 6f 75 6e 64  |keys move around|
00000710  20 73 65 63 74 6f 72 2c  0d 20 20 20 20 20 20 20  | sector,.       |
00000720  20 20 20 20 20 20 20 20  20 20 20 20 69 6e 20 48  |            in H|
00000730  65 78 20 6d 6f 64 65 2c  20 65 6e 74 65 72 20 68  |ex mode, enter h|
00000740  65 78 20 76 61 6c 75 65  73 0d 20 20 20 20 20 20  |ex values.      |
00000750  20 20 20 20 20 20 20 20  20 20 20 20 20 69 6e 20  |             in |
00000760  61 73 63 69 69 2c 20 65  6e 74 65 72 20 61 73 63  |ascii, enter asc|
00000770  69 69 20 28 69 6e 63 6c  75 64 69 6e 67 20 63 6f  |ii (including co|
00000780  6e 74 72 6f 6c 20 63 6f  64 65 73 29 0d 20 20 20  |ntrol codes).   |
00000790  20 20 20 43 54 52 4c 2d  40 20 68 65 78 2f 61 73  |   CTRL-@ hex/as|
000007a0  63 69 2c 20 74 6f 20 65  78 69 74 20 74 79 70 65  |ci, to exit type|
000007b0  20 43 4f 50 59 2e 0d 20  20 20 20 20 20 4f 6e 20  | COPY..      On |
000007c0  65 78 69 74 69 6e 67 20  79 6f 75 20 77 69 6c 6c  |exiting you will|
000007d0  20 62 65 20 61 73 6b 65  64 20 77 68 65 74 68 65  | be asked whethe|
000007e0  72 20 79 6f 75 20 77 61  6e 74 20 74 6f 20 77 72  |r you want to wr|
000007f0  69 74 65 20 74 68 65 0d  20 20 20 20 20 20 73 65  |ite the.      se|
00000800  63 74 6f 72 2c 20 61 6e  64 20 69 66 20 73 6f 20  |ctor, and if so |
00000810  74 68 65 20 66 6f 72 6d  20 69 6e 20 77 68 69 63  |the form in whic|
00000820  68 20 69 74 20 69 73 20  74 6f 20 62 65 20 77 72  |h it is to be wr|
00000830  69 74 74 65 6e 2e 0d 0d  57 20 20 20 20 20 57 72  |itten...W     Wr|
00000840  69 74 65 20 74 72 61 63  6b 2e 20 59 6f 75 20 77  |ite track. You w|
00000850  69 6c 6c 20 62 65 20 61  73 6b 65 64 20 77 68 69  |ill be asked whi|
00000860  63 68 20 74 72 61 63 6b  20 79 6f 75 20 77 61 6e  |ch track you wan|
00000870  74 20 74 6f 20 77 72 69  74 65 2c 0d 20 20 20 20  |t to write,.    |
00000880  20 20 77 68 65 74 68 65  72 20 79 6f 75 20 77 61  |  whether you wa|
00000890  6e 74 20 74 6f 20 63 68  61 6e 67 65 20 74 68 65  |nt to change the|
000008a0  20 73 65 63 74 6f 72 20  73 69 7a 65 73 2c 20 6e  | sector sizes, n|
000008b0  75 6d 62 65 72 73 2c 20  64 61 74 61 20 74 79 70  |umbers, data typ|
000008c0  65 73 0d 20 20 20 20 20  20 61 6e 64 20 73 6f 20  |es.      and so |
000008d0  6f 6e 2e 20 43 6f 6d 70  6c 69 63 61 74 65 64 2c  |on. Complicated,|
000008e0  20 61 6e 64 20 79 6f 75  20 73 68 6f 75 6c 64 20  | and you should |
000008f0  6b 6e 6f 77 20 77 68 61  74 20 79 6f 75 20 61 72  |know what you ar|
00000900  65 20 64 6f 69 6e 67 0d  20 20 20 20 20 20 69 66  |e doing.      if|
00000910  20 79 6f 75 20 68 6f 70  65 20 74 6f 20 62 65 20  | you hope to be |
00000920  61 62 6c 65 20 74 6f 20  75 73 65 20 74 68 65 20  |able to use the |
00000930  64 69 73 63 2e 20 4e 6f  74 65 20 74 68 61 74 20  |disc. Note that |
00000940  6f 6e 6c 79 20 32 35 36  20 62 79 74 65 0d 20 20  |only 256 byte.  |
00000950  20 20 20 20 73 65 63 74  6f 72 73 20 6f 66 20 63  |    sectors of c|
00000960  6f 6e 76 65 6e 74 69 61  6c 20 64 61 74 61 20 74  |onvential data t|
00000970  79 70 65 2c 20 61 6e 64  20 77 68 65 72 65 20 74  |ype, and where t|
00000980  68 65 20 6c 6f 67 69 63  61 6c 20 61 6e 64 20 70  |he logical and p|
00000990  68 79 73 69 63 61 6c 0d  20 20 20 20 20 20 74 72  |hysical.      tr|
000009a0  61 63 6b 20 6e 75 6d 62  65 72 73 20 6d 61 74 63  |ack numbers matc|
000009b0  68 2c 20 77 69 6c 6c 20  62 65 20 61 63 63 65 70  |h, will be accep|
000009c0  74 65 64 20 62 79 20 74  68 65 20 44 46 53 2e 0d  |ted by the DFS..|
000009d0  0d 0d 47 6f 6f 64 20 6c  75 63 6b 21 2e 20 49 27  |..Good luck!. I'|
000009e0  64 20 61 64 76 69 73 65  20 6d 65 73 73 69 6e 67  |d advise messing|
000009f0  20 61 72 6f 75 6e 64 20  77 69 74 68 20 69 74 20  | around with it |
00000a00  66 6f 72 20 73 6f 6d 65  20 74 69 6d 65 20 62 65  |for some time be|
00000a10  66 6f 72 65 20 79 6f 75  20 75 73 65 0d 69 74 20  |fore you use.it |
00000a20  69 6e 20 61 6e 67 65 72  2e 20 45 76 65 6e 20 73  |in anger. Even s|
00000a30  6f 2c 20 61 6c 77 61 79  73 20 6d 61 6b 65 20 61  |o, always make a|
00000a40  20 62 61 63 6b 75 70 20  62 65 66 6f 72 65 20 79  | backup before y|
00000a50  6f 75 20 77 6f 72 6b 20  6f 6e 20 61 20 64 69 73  |ou work on a dis|
00000a60  63 2e 0d 55 6e 65 78 70  65 63 74 65 64 20 74 68  |c..Unexpected th|
00000a70  69 6e 67 73 20 63 61 6e  20 61 6e 64 20 77 69 6c  |ings can and wil|
00000a80  6c 20 68 61 70 70 65 6e  2e 0d 0d 52 2e 49 2e 4d  |l happen...R.I.M|
00000a90  2e 53 61 64 65 6b 2e 0d                           |.Sadek..|
00000a98
27-03-89/Edit.m0
27-03-89/Edit.m1
27-03-89/Edit.m2
27-03-89/Edit.m4
27-03-89/Edit.m5