Home » Personal collection » Acorn ADFS disks » Electron » Utilities_1.ADF » UTILITIES/!ReadMe

UTILITIES/!ReadMe

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 » Personal collection » Acorn ADFS disks » Electron » Utilities_1.ADF
Filename: UTILITIES/!ReadMe
Read OK:
File size: 1144 bytes
Load address: FFFFFF00
Exec address: FFFFFFFF
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
	Utility commands
	================

Most of these utilities have an embedded version number of date in them at
the end of them.  If you *DUMP them, you can check the version to see if
its newer than a version you already have.


*Assem <afsp>
See text file T/Assem.


*Break (^)<text>
Puts a message on the Break key, using the BIV.  If the '^' parameter is
given, the string appears at the top of the screen.  If there if no '^'
parameter, the message appears just before the filing system message.  You
can use any string that can be put on a function key, ie you can use '|'
to specify control characters.


*CLoad <afsp> (<char>)
Loads in a set of character definitions, starting at the character
specified in hexadecimal, or character &80 (128) if not.


*CSave <fsp> <start char> <end char>
Saves a set of character definitions, as specified by the given parameters
in hexadecimal.


*FileInfo


*lp <afsp>
Lists a file to the screen, expanding any TAB characters, and converting
LF characters to CR,LF.


*Machines
An Econet command to list the stations connect to the network.  To work on
the Master, the network *OPT6,1 needs to be set.


*MDump


*MIDIon (<addr>|OFF)
See text file T/MIDIon.


*PrList


*REPAIR
Attempts to repair a bad program, prompting you through the actual repair. 
Only works on non-Tube machines.


*Roms (C) (V)
Lists the roms in the machine.  If the 'C' parameter is given, the
copyright message is displayed.  If the 'V' parameter is given, the
version message is display.  To run on a machine with a built-in *ROMS
command, use */ROMS.


*ScrLoad <afsp>
Loads in a compressed screen picture saved with *ScrSave with its palette
information.  Works with shadow screen on: Master, Aries-B32 and Watford
32k Ram Card.  If a shadow screen mode is selected, then any mode change
will be a shadow mode.  On a B+ non-shadow modes are forced.  Shadow
screen cannot be supported on the B+ as the hardware only allows the VDU
driver code between &C000 and &DFFF to access the shadow screen memory.


*ScrSave <fsp>
Saves a screen picture, and attempts to compress it.  If compressing it
would make a longer file (as a very detailed picture would), then the
picture is saved without compressing it.  The palette information and mode
is saved in the load and execution addresses of the file, and if the file
is compressed, the execution address is set to the &0000xxxx with the load
address set to &FFFFxxxx.  With a sixteen colour screen mode, the first
four bytes of the file are replaced with palette colours 8 to 15.  On
loading with *ScrLoad, these four bytes are set to the same as the
following four bytes.  Works with shadow screen on: Master, Aries-B32 and
Watford 32k Ram Card.  The palette and other information is stored as
follows:

Load address:      &FFFFabbbb
a:   currently unused and ignored
bbb: colours 4 to 7 held as %777666555444 in sixteen colour mode

Execution address: &iiiimcccc
iiii: 0000 for compressed, FFFF for uncompressed
m:    screen mode
ccc:  colours 0 to 3 held as %333222111000

In sixteen colour mode, the first four bytes of file hold colours 8 to 15,
8/10/12/14 in the low nybbles and 9/11/13/15 in the high nybbles.


*SrLoad <afsp> (<rom>) (R) (P)
Loads a rom image into sideways ram.  If the rom number is not given, the
highest available ram bank is used.  If the 'R' parameter is given, the
rom is entered as a language.  If the 'P' parameter is given, the command
pauses, giving the message 'Press space to load', allowing you to change
disk, etc., before loading.  The rom image is loaded into main memory at
&FFFF3000 to &FFFF6FFF before being copied into sideways ram, and will
therefore corrupt anything in that memory.


*SrSave <fsp> <rom> (P)
Save a sideways rom image.  If the 'P' parameter is present, the command
pauses, giving the message 'Press space to save', allowing you to change
disk, etc., before saving.  If the rom being saved has a second processor
relocation address, then the load and execution address of the saved file
is set to this, otherwise, they are set to &FFFF8000.


*Stations
An Econet command to list the stations connected to the network, and the
users that they are logged on as.  To run on the Master, the network
*OPT6,1 needs to be set.  If you are not logged onto a fileserver, you
will get a 'Not logged on' or 'Not listening' error.


*Stats


*VList
Lists out the variables currently defined in Basic.
00000000  09 55 74 69 6c 69 74 79  20 63 6f 6d 6d 61 6e 64  |.Utility command|
00000010  73 0d 09 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |s..=============|
00000020  3d 3d 3d 0d 0d 4d 6f 73  74 20 6f 66 20 74 68 65  |===..Most of the|
00000030  73 65 20 75 74 69 6c 69  74 69 65 73 20 68 61 76  |se utilities hav|
00000040  65 20 61 6e 20 65 6d 62  65 64 64 65 64 20 76 65  |e an embedded ve|
00000050  72 73 69 6f 6e 20 6e 75  6d 62 65 72 20 6f 66 20  |rsion number of |
00000060  64 61 74 65 20 69 6e 20  74 68 65 6d 20 61 74 0d  |date in them at.|
00000070  74 68 65 20 65 6e 64 20  6f 66 20 74 68 65 6d 2e  |the end of them.|
00000080  20 20 49 66 20 79 6f 75  20 2a 44 55 4d 50 20 74  |  If you *DUMP t|
00000090  68 65 6d 2c 20 79 6f 75  20 63 61 6e 20 63 68 65  |hem, you can che|
000000a0  63 6b 20 74 68 65 20 76  65 72 73 69 6f 6e 20 74  |ck the version t|
000000b0  6f 20 73 65 65 20 69 66  0d 69 74 73 20 6e 65 77  |o see if.its new|
000000c0  65 72 20 74 68 61 6e 20  61 20 76 65 72 73 69 6f  |er than a versio|
000000d0  6e 20 79 6f 75 20 61 6c  72 65 61 64 79 20 68 61  |n you already ha|
000000e0  76 65 2e 0d 0d 0d 2a 41  73 73 65 6d 20 3c 61 66  |ve....*Assem <af|
000000f0  73 70 3e 0d 53 65 65 20  74 65 78 74 20 66 69 6c  |sp>.See text fil|
00000100  65 20 54 2f 41 73 73 65  6d 2e 0d 0d 0d 2a 42 72  |e T/Assem....*Br|
00000110  65 61 6b 20 28 5e 29 3c  74 65 78 74 3e 0d 50 75  |eak (^)<text>.Pu|
00000120  74 73 20 61 20 6d 65 73  73 61 67 65 20 6f 6e 20  |ts a message on |
00000130  74 68 65 20 42 72 65 61  6b 20 6b 65 79 2c 20 75  |the Break key, u|
00000140  73 69 6e 67 20 74 68 65  20 42 49 56 2e 20 20 49  |sing the BIV.  I|
00000150  66 20 74 68 65 20 27 5e  27 20 70 61 72 61 6d 65  |f the '^' parame|
00000160  74 65 72 20 69 73 0d 67  69 76 65 6e 2c 20 74 68  |ter is.given, th|
00000170  65 20 73 74 72 69 6e 67  20 61 70 70 65 61 72 73  |e string appears|
00000180  20 61 74 20 74 68 65 20  74 6f 70 20 6f 66 20 74  | at the top of t|
00000190  68 65 20 73 63 72 65 65  6e 2e 20 20 49 66 20 74  |he screen.  If t|
000001a0  68 65 72 65 20 69 66 20  6e 6f 20 27 5e 27 0d 70  |here if no '^'.p|
000001b0  61 72 61 6d 65 74 65 72  2c 20 74 68 65 20 6d 65  |arameter, the me|
000001c0  73 73 61 67 65 20 61 70  70 65 61 72 73 20 6a 75  |ssage appears ju|
000001d0  73 74 20 62 65 66 6f 72  65 20 74 68 65 20 66 69  |st before the fi|
000001e0  6c 69 6e 67 20 73 79 73  74 65 6d 20 6d 65 73 73  |ling system mess|
000001f0  61 67 65 2e 20 20 59 6f  75 0d 63 61 6e 20 75 73  |age.  You.can us|
00000200  65 20 61 6e 79 20 73 74  72 69 6e 67 20 74 68 61  |e any string tha|
00000210  74 20 63 61 6e 20 62 65  20 70 75 74 20 6f 6e 20  |t can be put on |
00000220  61 20 66 75 6e 63 74 69  6f 6e 20 6b 65 79 2c 20  |a function key, |
00000230  69 65 20 79 6f 75 20 63  61 6e 20 75 73 65 20 27  |ie you can use '|
00000240  7c 27 0d 74 6f 20 73 70  65 63 69 66 79 20 63 6f  ||'.to specify co|
00000250  6e 74 72 6f 6c 20 63 68  61 72 61 63 74 65 72 73  |ntrol characters|
00000260  2e 0d 0d 0d 2a 43 4c 6f  61 64 20 3c 61 66 73 70  |....*CLoad <afsp|
00000270  3e 20 28 3c 63 68 61 72  3e 29 0d 4c 6f 61 64 73  |> (<char>).Loads|
00000280  20 69 6e 20 61 20 73 65  74 20 6f 66 20 63 68 61  | in a set of cha|
00000290  72 61 63 74 65 72 20 64  65 66 69 6e 69 74 69 6f  |racter definitio|
000002a0  6e 73 2c 20 73 74 61 72  74 69 6e 67 20 61 74 20  |ns, starting at |
000002b0  74 68 65 20 63 68 61 72  61 63 74 65 72 0d 73 70  |the character.sp|
000002c0  65 63 69 66 69 65 64 20  69 6e 20 68 65 78 61 64  |ecified in hexad|
000002d0  65 63 69 6d 61 6c 2c 20  6f 72 20 63 68 61 72 61  |ecimal, or chara|
000002e0  63 74 65 72 20 26 38 30  20 28 31 32 38 29 20 69  |cter &80 (128) i|
000002f0  66 20 6e 6f 74 2e 0d 0d  0d 2a 43 53 61 76 65 20  |f not....*CSave |
00000300  3c 66 73 70 3e 20 3c 73  74 61 72 74 20 63 68 61  |<fsp> <start cha|
00000310  72 3e 20 3c 65 6e 64 20  63 68 61 72 3e 0d 53 61  |r> <end char>.Sa|
00000320  76 65 73 20 61 20 73 65  74 20 6f 66 20 63 68 61  |ves a set of cha|
00000330  72 61 63 74 65 72 20 64  65 66 69 6e 69 74 69 6f  |racter definitio|
00000340  6e 73 2c 20 61 73 20 73  70 65 63 69 66 69 65 64  |ns, as specified|
00000350  20 62 79 20 74 68 65 20  67 69 76 65 6e 20 70 61  | by the given pa|
00000360  72 61 6d 65 74 65 72 73  0d 69 6e 20 68 65 78 61  |rameters.in hexa|
00000370  64 65 63 69 6d 61 6c 2e  0d 0d 0d 2a 46 69 6c 65  |decimal....*File|
00000380  49 6e 66 6f 0d 0d 0d 2a  6c 70 20 3c 61 66 73 70  |Info...*lp <afsp|
00000390  3e 0d 4c 69 73 74 73 20  61 20 66 69 6c 65 20 74  |>.Lists a file t|
000003a0  6f 20 74 68 65 20 73 63  72 65 65 6e 2c 20 65 78  |o the screen, ex|
000003b0  70 61 6e 64 69 6e 67 20  61 6e 79 20 54 41 42 20  |panding any TAB |
000003c0  63 68 61 72 61 63 74 65  72 73 2c 20 61 6e 64 20  |characters, and |
000003d0  63 6f 6e 76 65 72 74 69  6e 67 0d 4c 46 20 63 68  |converting.LF ch|
000003e0  61 72 61 63 74 65 72 73  20 74 6f 20 43 52 2c 4c  |aracters to CR,L|
000003f0  46 2e 0d 0d 0d 2a 4d 61  63 68 69 6e 65 73 0d 41  |F....*Machines.A|
00000400  6e 20 45 63 6f 6e 65 74  20 63 6f 6d 6d 61 6e 64  |n Econet command|
00000410  20 74 6f 20 6c 69 73 74  20 74 68 65 20 73 74 61  | to list the sta|
00000420  74 69 6f 6e 73 20 63 6f  6e 6e 65 63 74 20 74 6f  |tions connect to|
00000430  20 74 68 65 20 6e 65 74  77 6f 72 6b 2e 20 20 54  | the network.  T|
00000440  6f 20 77 6f 72 6b 20 6f  6e 0d 74 68 65 20 4d 61  |o work on.the Ma|
00000450  73 74 65 72 2c 20 74 68  65 20 6e 65 74 77 6f 72  |ster, the networ|
00000460  6b 20 2a 4f 50 54 36 2c  31 20 6e 65 65 64 73 20  |k *OPT6,1 needs |
00000470  74 6f 20 62 65 20 73 65  74 2e 0d 0d 0d 2a 4d 44  |to be set....*MD|
00000480  75 6d 70 0d 0d 0d 2a 4d  49 44 49 6f 6e 20 28 3c  |ump...*MIDIon (<|
00000490  61 64 64 72 3e 7c 4f 46  46 29 0d 53 65 65 20 74  |addr>|OFF).See t|
000004a0  65 78 74 20 66 69 6c 65  20 54 2f 4d 49 44 49 6f  |ext file T/MIDIo|
000004b0  6e 2e 0d 0d 0d 2a 50 72  4c 69 73 74 0d 0d 0d 2a  |n....*PrList...*|
000004c0  52 45 50 41 49 52 0d 41  74 74 65 6d 70 74 73 20  |REPAIR.Attempts |
000004d0  74 6f 20 72 65 70 61 69  72 20 61 20 62 61 64 20  |to repair a bad |
000004e0  70 72 6f 67 72 61 6d 2c  20 70 72 6f 6d 70 74 69  |program, prompti|
000004f0  6e 67 20 79 6f 75 20 74  68 72 6f 75 67 68 20 74  |ng you through t|
00000500  68 65 20 61 63 74 75 61  6c 20 72 65 70 61 69 72  |he actual repair|
00000510  2e 20 0d 4f 6e 6c 79 20  77 6f 72 6b 73 20 6f 6e  |. .Only works on|
00000520  20 6e 6f 6e 2d 54 75 62  65 20 6d 61 63 68 69 6e  | non-Tube machin|
00000530  65 73 2e 0d 0d 0d 2a 52  6f 6d 73 20 28 43 29 20  |es....*Roms (C) |
00000540  28 56 29 0d 4c 69 73 74  73 20 74 68 65 20 72 6f  |(V).Lists the ro|
00000550  6d 73 20 69 6e 20 74 68  65 20 6d 61 63 68 69 6e  |ms in the machin|
00000560  65 2e 20 20 49 66 20 74  68 65 20 27 43 27 20 70  |e.  If the 'C' p|
00000570  61 72 61 6d 65 74 65 72  20 69 73 20 67 69 76 65  |arameter is give|
00000580  6e 2c 20 74 68 65 0d 63  6f 70 79 72 69 67 68 74  |n, the.copyright|
00000590  20 6d 65 73 73 61 67 65  20 69 73 20 64 69 73 70  | message is disp|
000005a0  6c 61 79 65 64 2e 20 20  49 66 20 74 68 65 20 27  |layed.  If the '|
000005b0  56 27 20 70 61 72 61 6d  65 74 65 72 20 69 73 20  |V' parameter is |
000005c0  67 69 76 65 6e 2c 20 74  68 65 0d 76 65 72 73 69  |given, the.versi|
000005d0  6f 6e 20 6d 65 73 73 61  67 65 20 69 73 20 64 69  |on message is di|
000005e0  73 70 6c 61 79 2e 20 20  54 6f 20 72 75 6e 20 6f  |splay.  To run o|
000005f0  6e 20 61 20 6d 61 63 68  69 6e 65 20 77 69 74 68  |n a machine with|
00000600  20 61 20 62 75 69 6c 74  2d 69 6e 20 2a 52 4f 4d  | a built-in *ROM|
00000610  53 0d 63 6f 6d 6d 61 6e  64 2c 20 75 73 65 20 2a  |S.command, use *|
00000620  2f 52 4f 4d 53 2e 0d 0d  0d 2a 53 63 72 4c 6f 61  |/ROMS....*ScrLoa|
00000630  64 20 3c 61 66 73 70 3e  0d 4c 6f 61 64 73 20 69  |d <afsp>.Loads i|
00000640  6e 20 61 20 63 6f 6d 70  72 65 73 73 65 64 20 73  |n a compressed s|
00000650  63 72 65 65 6e 20 70 69  63 74 75 72 65 20 73 61  |creen picture sa|
00000660  76 65 64 20 77 69 74 68  20 2a 53 63 72 53 61 76  |ved with *ScrSav|
00000670  65 20 77 69 74 68 20 69  74 73 20 70 61 6c 65 74  |e with its palet|
00000680  74 65 0d 69 6e 66 6f 72  6d 61 74 69 6f 6e 2e 20  |te.information. |
00000690  20 57 6f 72 6b 73 20 77  69 74 68 20 73 68 61 64  | Works with shad|
000006a0  6f 77 20 73 63 72 65 65  6e 20 6f 6e 3a 20 4d 61  |ow screen on: Ma|
000006b0  73 74 65 72 2c 20 41 72  69 65 73 2d 42 33 32 20  |ster, Aries-B32 |
000006c0  61 6e 64 20 57 61 74 66  6f 72 64 0d 33 32 6b 20  |and Watford.32k |
000006d0  52 61 6d 20 43 61 72 64  2e 20 20 49 66 20 61 20  |Ram Card.  If a |
000006e0  73 68 61 64 6f 77 20 73  63 72 65 65 6e 20 6d 6f  |shadow screen mo|
000006f0  64 65 20 69 73 20 73 65  6c 65 63 74 65 64 2c 20  |de is selected, |
00000700  74 68 65 6e 20 61 6e 79  20 6d 6f 64 65 20 63 68  |then any mode ch|
00000710  61 6e 67 65 0d 77 69 6c  6c 20 62 65 20 61 20 73  |ange.will be a s|
00000720  68 61 64 6f 77 20 6d 6f  64 65 2e 20 20 4f 6e 20  |hadow mode.  On |
00000730  61 20 42 2b 20 6e 6f 6e  2d 73 68 61 64 6f 77 20  |a B+ non-shadow |
00000740  6d 6f 64 65 73 20 61 72  65 20 66 6f 72 63 65 64  |modes are forced|
00000750  2e 20 20 53 68 61 64 6f  77 0d 73 63 72 65 65 6e  |.  Shadow.screen|
00000760  20 63 61 6e 6e 6f 74 20  62 65 20 73 75 70 70 6f  | cannot be suppo|
00000770  72 74 65 64 20 6f 6e 20  74 68 65 20 42 2b 20 61  |rted on the B+ a|
00000780  73 20 74 68 65 20 68 61  72 64 77 61 72 65 20 6f  |s the hardware o|
00000790  6e 6c 79 20 61 6c 6c 6f  77 73 20 74 68 65 20 56  |nly allows the V|
000007a0  44 55 0d 64 72 69 76 65  72 20 63 6f 64 65 20 62  |DU.driver code b|
000007b0  65 74 77 65 65 6e 20 26  43 30 30 30 20 61 6e 64  |etween &C000 and|
000007c0  20 26 44 46 46 46 20 74  6f 20 61 63 63 65 73 73  | &DFFF to access|
000007d0  20 74 68 65 20 73 68 61  64 6f 77 20 73 63 72 65  | the shadow scre|
000007e0  65 6e 20 6d 65 6d 6f 72  79 2e 0d 0d 0d 2a 53 63  |en memory....*Sc|
000007f0  72 53 61 76 65 20 3c 66  73 70 3e 0d 53 61 76 65  |rSave <fsp>.Save|
00000800  73 20 61 20 73 63 72 65  65 6e 20 70 69 63 74 75  |s a screen pictu|
00000810  72 65 2c 20 61 6e 64 20  61 74 74 65 6d 70 74 73  |re, and attempts|
00000820  20 74 6f 20 63 6f 6d 70  72 65 73 73 20 69 74 2e  | to compress it.|
00000830  20 20 49 66 20 63 6f 6d  70 72 65 73 73 69 6e 67  |  If compressing|
00000840  20 69 74 0d 77 6f 75 6c  64 20 6d 61 6b 65 20 61  | it.would make a|
00000850  20 6c 6f 6e 67 65 72 20  66 69 6c 65 20 28 61 73  | longer file (as|
00000860  20 61 20 76 65 72 79 20  64 65 74 61 69 6c 65 64  | a very detailed|
00000870  20 70 69 63 74 75 72 65  20 77 6f 75 6c 64 29 2c  | picture would),|
00000880  20 74 68 65 6e 20 74 68  65 0d 70 69 63 74 75 72  | then the.pictur|
00000890  65 20 69 73 20 73 61 76  65 64 20 77 69 74 68 6f  |e is saved witho|
000008a0  75 74 20 63 6f 6d 70 72  65 73 73 69 6e 67 20 69  |ut compressing i|
000008b0  74 2e 20 20 54 68 65 20  70 61 6c 65 74 74 65 20  |t.  The palette |
000008c0  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 61 6e 64 20  |information and |
000008d0  6d 6f 64 65 0d 69 73 20  73 61 76 65 64 20 69 6e  |mode.is saved in|
000008e0  20 74 68 65 20 6c 6f 61  64 20 61 6e 64 20 65 78  | the load and ex|
000008f0  65 63 75 74 69 6f 6e 20  61 64 64 72 65 73 73 65  |ecution addresse|
00000900  73 20 6f 66 20 74 68 65  20 66 69 6c 65 2c 20 61  |s of the file, a|
00000910  6e 64 20 69 66 20 74 68  65 20 66 69 6c 65 0d 69  |nd if the file.i|
00000920  73 20 63 6f 6d 70 72 65  73 73 65 64 2c 20 74 68  |s compressed, th|
00000930  65 20 65 78 65 63 75 74  69 6f 6e 20 61 64 64 72  |e execution addr|
00000940  65 73 73 20 69 73 20 73  65 74 20 74 6f 20 74 68  |ess is set to th|
00000950  65 20 26 30 30 30 30 78  78 78 78 20 77 69 74 68  |e &0000xxxx with|
00000960  20 74 68 65 20 6c 6f 61  64 0d 61 64 64 72 65 73  | the load.addres|
00000970  73 20 73 65 74 20 74 6f  20 26 46 46 46 46 78 78  |s set to &FFFFxx|
00000980  78 78 2e 20 20 57 69 74  68 20 61 20 73 69 78 74  |xx.  With a sixt|
00000990  65 65 6e 20 63 6f 6c 6f  75 72 20 73 63 72 65 65  |een colour scree|
000009a0  6e 20 6d 6f 64 65 2c 20  74 68 65 20 66 69 72 73  |n mode, the firs|
000009b0  74 0d 66 6f 75 72 20 62  79 74 65 73 20 6f 66 20  |t.four bytes of |
000009c0  74 68 65 20 66 69 6c 65  20 61 72 65 20 72 65 70  |the file are rep|
000009d0  6c 61 63 65 64 20 77 69  74 68 20 70 61 6c 65 74  |laced with palet|
000009e0  74 65 20 63 6f 6c 6f 75  72 73 20 38 20 74 6f 20  |te colours 8 to |
000009f0  31 35 2e 20 20 4f 6e 0d  6c 6f 61 64 69 6e 67 20  |15.  On.loading |
00000a00  77 69 74 68 20 2a 53 63  72 4c 6f 61 64 2c 20 74  |with *ScrLoad, t|
00000a10  68 65 73 65 20 66 6f 75  72 20 62 79 74 65 73 20  |hese four bytes |
00000a20  61 72 65 20 73 65 74 20  74 6f 20 74 68 65 20 73  |are set to the s|
00000a30  61 6d 65 20 61 73 20 74  68 65 0d 66 6f 6c 6c 6f  |ame as the.follo|
00000a40  77 69 6e 67 20 66 6f 75  72 20 62 79 74 65 73 2e  |wing four bytes.|
00000a50  20 20 57 6f 72 6b 73 20  77 69 74 68 20 73 68 61  |  Works with sha|
00000a60  64 6f 77 20 73 63 72 65  65 6e 20 6f 6e 3a 20 4d  |dow screen on: M|
00000a70  61 73 74 65 72 2c 20 41  72 69 65 73 2d 42 33 32  |aster, Aries-B32|
00000a80  20 61 6e 64 0d 57 61 74  66 6f 72 64 20 33 32 6b  | and.Watford 32k|
00000a90  20 52 61 6d 20 43 61 72  64 2e 20 20 54 68 65 20  | Ram Card.  The |
00000aa0  70 61 6c 65 74 74 65 20  61 6e 64 20 6f 74 68 65  |palette and othe|
00000ab0  72 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 69 73  |r information is|
00000ac0  20 73 74 6f 72 65 64 20  61 73 0d 66 6f 6c 6c 6f  | stored as.follo|
00000ad0  77 73 3a 0d 0d 4c 6f 61  64 20 61 64 64 72 65 73  |ws:..Load addres|
00000ae0  73 3a 20 20 20 20 20 20  26 46 46 46 46 61 62 62  |s:      &FFFFabb|
00000af0  62 62 0d 61 3a 20 20 20  63 75 72 72 65 6e 74 6c  |bb.a:   currentl|
00000b00  79 20 75 6e 75 73 65 64  20 61 6e 64 20 69 67 6e  |y unused and ign|
00000b10  6f 72 65 64 0d 62 62 62  3a 20 63 6f 6c 6f 75 72  |ored.bbb: colour|
00000b20  73 20 34 20 74 6f 20 37  20 68 65 6c 64 20 61 73  |s 4 to 7 held as|
00000b30  20 25 37 37 37 36 36 36  35 35 35 34 34 34 20 69  | %777666555444 i|
00000b40  6e 20 73 69 78 74 65 65  6e 20 63 6f 6c 6f 75 72  |n sixteen colour|
00000b50  20 6d 6f 64 65 0d 0d 45  78 65 63 75 74 69 6f 6e  | mode..Execution|
00000b60  20 61 64 64 72 65 73 73  3a 20 26 69 69 69 69 6d  | address: &iiiim|
00000b70  63 63 63 63 0d 69 69 69  69 3a 20 30 30 30 30 20  |cccc.iiii: 0000 |
00000b80  66 6f 72 20 63 6f 6d 70  72 65 73 73 65 64 2c 20  |for compressed, |
00000b90  46 46 46 46 20 66 6f 72  20 75 6e 63 6f 6d 70 72  |FFFF for uncompr|
00000ba0  65 73 73 65 64 0d 6d 3a  20 20 20 20 73 63 72 65  |essed.m:    scre|
00000bb0  65 6e 20 6d 6f 64 65 0d  63 63 63 3a 20 20 63 6f  |en mode.ccc:  co|
00000bc0  6c 6f 75 72 73 20 30 20  74 6f 20 33 20 68 65 6c  |lours 0 to 3 hel|
00000bd0  64 20 61 73 20 25 33 33  33 32 32 32 31 31 31 30  |d as %3332221110|
00000be0  30 30 0d 0d 49 6e 20 73  69 78 74 65 65 6e 20 63  |00..In sixteen c|
00000bf0  6f 6c 6f 75 72 20 6d 6f  64 65 2c 20 74 68 65 20  |olour mode, the |
00000c00  66 69 72 73 74 20 66 6f  75 72 20 62 79 74 65 73  |first four bytes|
00000c10  20 6f 66 20 66 69 6c 65  20 68 6f 6c 64 20 63 6f  | of file hold co|
00000c20  6c 6f 75 72 73 20 38 20  74 6f 20 31 35 2c 0d 38  |lours 8 to 15,.8|
00000c30  2f 31 30 2f 31 32 2f 31  34 20 69 6e 20 74 68 65  |/10/12/14 in the|
00000c40  20 6c 6f 77 20 6e 79 62  62 6c 65 73 20 61 6e 64  | low nybbles and|
00000c50  20 39 2f 31 31 2f 31 33  2f 31 35 20 69 6e 20 74  | 9/11/13/15 in t|
00000c60  68 65 20 68 69 67 68 20  6e 79 62 62 6c 65 73 2e  |he high nybbles.|
00000c70  0d 0d 0d 2a 53 72 4c 6f  61 64 20 3c 61 66 73 70  |...*SrLoad <afsp|
00000c80  3e 20 28 3c 72 6f 6d 3e  29 20 28 52 29 20 28 50  |> (<rom>) (R) (P|
00000c90  29 0d 4c 6f 61 64 73 20  61 20 72 6f 6d 20 69 6d  |).Loads a rom im|
00000ca0  61 67 65 20 69 6e 74 6f  20 73 69 64 65 77 61 79  |age into sideway|
00000cb0  73 20 72 61 6d 2e 20 20  49 66 20 74 68 65 20 72  |s ram.  If the r|
00000cc0  6f 6d 20 6e 75 6d 62 65  72 20 69 73 20 6e 6f 74  |om number is not|
00000cd0  20 67 69 76 65 6e 2c 20  74 68 65 0d 68 69 67 68  | given, the.high|
00000ce0  65 73 74 20 61 76 61 69  6c 61 62 6c 65 20 72 61  |est available ra|
00000cf0  6d 20 62 61 6e 6b 20 69  73 20 75 73 65 64 2e 20  |m bank is used. |
00000d00  20 49 66 20 74 68 65 20  27 52 27 20 70 61 72 61  | If the 'R' para|
00000d10  6d 65 74 65 72 20 69 73  20 67 69 76 65 6e 2c 20  |meter is given, |
00000d20  74 68 65 0d 72 6f 6d 20  69 73 20 65 6e 74 65 72  |the.rom is enter|
00000d30  65 64 20 61 73 20 61 20  6c 61 6e 67 75 61 67 65  |ed as a language|
00000d40  2e 20 20 49 66 20 74 68  65 20 27 50 27 20 70 61  |.  If the 'P' pa|
00000d50  72 61 6d 65 74 65 72 20  69 73 20 67 69 76 65 6e  |rameter is given|
00000d60  2c 20 74 68 65 20 63 6f  6d 6d 61 6e 64 0d 70 61  |, the command.pa|
00000d70  75 73 65 73 2c 20 67 69  76 69 6e 67 20 74 68 65  |uses, giving the|
00000d80  20 6d 65 73 73 61 67 65  20 27 50 72 65 73 73 20  | message 'Press |
00000d90  73 70 61 63 65 20 74 6f  20 6c 6f 61 64 27 2c 20  |space to load', |
00000da0  61 6c 6c 6f 77 69 6e 67  20 79 6f 75 20 74 6f 20  |allowing you to |
00000db0  63 68 61 6e 67 65 0d 64  69 73 6b 2c 20 65 74 63  |change.disk, etc|
00000dc0  2e 2c 20 62 65 66 6f 72  65 20 6c 6f 61 64 69 6e  |., before loadin|
00000dd0  67 2e 20 20 54 68 65 20  72 6f 6d 20 69 6d 61 67  |g.  The rom imag|
00000de0  65 20 69 73 20 6c 6f 61  64 65 64 20 69 6e 74 6f  |e is loaded into|
00000df0  20 6d 61 69 6e 20 6d 65  6d 6f 72 79 20 61 74 0d  | main memory at.|
00000e00  26 46 46 46 46 33 30 30  30 20 74 6f 20 26 46 46  |&FFFF3000 to &FF|
00000e10  46 46 36 46 46 46 20 62  65 66 6f 72 65 20 62 65  |FF6FFF before be|
00000e20  69 6e 67 20 63 6f 70 69  65 64 20 69 6e 74 6f 20  |ing copied into |
00000e30  73 69 64 65 77 61 79 73  20 72 61 6d 2c 20 61 6e  |sideways ram, an|
00000e40  64 20 77 69 6c 6c 0d 74  68 65 72 65 66 6f 72 65  |d will.therefore|
00000e50  20 63 6f 72 72 75 70 74  20 61 6e 79 74 68 69 6e  | corrupt anythin|
00000e60  67 20 69 6e 20 74 68 61  74 20 6d 65 6d 6f 72 79  |g in that memory|
00000e70  2e 0d 0d 0d 2a 53 72 53  61 76 65 20 3c 66 73 70  |....*SrSave <fsp|
00000e80  3e 20 3c 72 6f 6d 3e 20  28 50 29 0d 53 61 76 65  |> <rom> (P).Save|
00000e90  20 61 20 73 69 64 65 77  61 79 73 20 72 6f 6d 20  | a sideways rom |
00000ea0  69 6d 61 67 65 2e 20 20  49 66 20 74 68 65 20 27  |image.  If the '|
00000eb0  50 27 20 70 61 72 61 6d  65 74 65 72 20 69 73 20  |P' parameter is |
00000ec0  70 72 65 73 65 6e 74 2c  20 74 68 65 20 63 6f 6d  |present, the com|
00000ed0  6d 61 6e 64 0d 70 61 75  73 65 73 2c 20 67 69 76  |mand.pauses, giv|
00000ee0  69 6e 67 20 74 68 65 20  6d 65 73 73 61 67 65 20  |ing the message |
00000ef0  27 50 72 65 73 73 20 73  70 61 63 65 20 74 6f 20  |'Press space to |
00000f00  73 61 76 65 27 2c 20 61  6c 6c 6f 77 69 6e 67 20  |save', allowing |
00000f10  79 6f 75 20 74 6f 20 63  68 61 6e 67 65 0d 64 69  |you to change.di|
00000f20  73 6b 2c 20 65 74 63 2e  2c 20 62 65 66 6f 72 65  |sk, etc., before|
00000f30  20 73 61 76 69 6e 67 2e  20 20 49 66 20 74 68 65  | saving.  If the|
00000f40  20 72 6f 6d 20 62 65 69  6e 67 20 73 61 76 65 64  | rom being saved|
00000f50  20 68 61 73 20 61 20 73  65 63 6f 6e 64 20 70 72  | has a second pr|
00000f60  6f 63 65 73 73 6f 72 0d  72 65 6c 6f 63 61 74 69  |ocessor.relocati|
00000f70  6f 6e 20 61 64 64 72 65  73 73 2c 20 74 68 65 6e  |on address, then|
00000f80  20 74 68 65 20 6c 6f 61  64 20 61 6e 64 20 65 78  | the load and ex|
00000f90  65 63 75 74 69 6f 6e 20  61 64 64 72 65 73 73 20  |ecution address |
00000fa0  6f 66 20 74 68 65 20 73  61 76 65 64 20 66 69 6c  |of the saved fil|
00000fb0  65 0d 69 73 20 73 65 74  20 74 6f 20 74 68 69 73  |e.is set to this|
00000fc0  2c 20 6f 74 68 65 72 77  69 73 65 2c 20 74 68 65  |, otherwise, the|
00000fd0  79 20 61 72 65 20 73 65  74 20 74 6f 20 26 46 46  |y are set to &FF|
00000fe0  46 46 38 30 30 30 2e 0d  0d 0d 2a 53 74 61 74 69  |FF8000....*Stati|
00000ff0  6f 6e 73 0d 41 6e 20 45  63 6f 6e 65 74 20 63 6f  |ons.An Econet co|
00001000  6d 6d 61 6e 64 20 74 6f  20 6c 69 73 74 20 74 68  |mmand to list th|
00001010  65 20 73 74 61 74 69 6f  6e 73 20 63 6f 6e 6e 65  |e stations conne|
00001020  63 74 65 64 20 74 6f 20  74 68 65 20 6e 65 74 77  |cted to the netw|
00001030  6f 72 6b 2c 20 61 6e 64  20 74 68 65 0d 75 73 65  |ork, and the.use|
00001040  72 73 20 74 68 61 74 20  74 68 65 79 20 61 72 65  |rs that they are|
00001050  20 6c 6f 67 67 65 64 20  6f 6e 20 61 73 2e 20 20  | logged on as.  |
00001060  54 6f 20 72 75 6e 20 6f  6e 20 74 68 65 20 4d 61  |To run on the Ma|
00001070  73 74 65 72 2c 20 74 68  65 20 6e 65 74 77 6f 72  |ster, the networ|
00001080  6b 0d 2a 4f 50 54 36 2c  31 20 6e 65 65 64 73 20  |k.*OPT6,1 needs |
00001090  74 6f 20 62 65 20 73 65  74 2e 20 20 49 66 20 79  |to be set.  If y|
000010a0  6f 75 20 61 72 65 20 6e  6f 74 20 6c 6f 67 67 65  |ou are not logge|
000010b0  64 20 6f 6e 74 6f 20 61  20 66 69 6c 65 73 65 72  |d onto a fileser|
000010c0  76 65 72 2c 20 79 6f 75  0d 77 69 6c 6c 20 67 65  |ver, you.will ge|
000010d0  74 20 61 20 27 4e 6f 74  20 6c 6f 67 67 65 64 20  |t a 'Not logged |
000010e0  6f 6e 27 20 6f 72 20 27  4e 6f 74 20 6c 69 73 74  |on' or 'Not list|
000010f0  65 6e 69 6e 67 27 20 65  72 72 6f 72 2e 0d 0d 0d  |ening' error....|
00001100  2a 53 74 61 74 73 0d 0d  0d 2a 56 4c 69 73 74 0d  |*Stats...*VList.|
00001110  4c 69 73 74 73 20 6f 75  74 20 74 68 65 20 76 61  |Lists out the va|
00001120  72 69 61 62 6c 65 73 20  63 75 72 72 65 6e 74 6c  |riables currentl|
00001130  79 20 64 65 66 69 6e 65  64 20 69 6e 20 42 61 73  |y defined in Bas|
00001140  69 63 2e 0d                                       |ic..|
00001144
UTILITIES/!ReadMe.m0
UTILITIES/!ReadMe.m1
UTILITIES/!ReadMe.m2
UTILITIES/!ReadMe.m4
UTILITIES/!ReadMe.m5