OUTLINE OF THIS FILE I. Liz Deal's Contributions A. Pre-SuperScript B. Keytrix C. Supermon D. Disk Utilities E. Spooling F. Machine Language G. Others II. Gord Campbell's Programs III. The CBM 8032 Emulator IV. Manfred Mager's Monitor ----------------------------- I. Liz Deal's Contributions A. Pre-SuperScript CompuServe name: PRESSC.BIN Original name: "pre-superscript" (Basic program) SuperScript II, one of the very best word processing programs ever written for any brand of computer, was designed for the British version of the B128, the Commodore 700. Even after four years this is the only software for any microcomputer known to permit column moves (aside from dedicated wordprocessors), and many other advanced features are also included. Yet two major problems occur when running SuperScript on the B128: keybounce (a letter prints twice when you touch a key just once) and erratic cursor movement (the cursor will only move four or five places when you hold down the cursor key, then it pauses for a second before resuming). Both problems are due to the British use of 50 cycle AC, while American computers are plugged into a 60 cycle network. Liz Deal wrote this program, which will fix both bugs if you run it before loading SuperScript. This magic is accomplished by a machine language routine which intercepts the hardware interrupts, and which is a separate file on CompuServe: CompuServe name: IRQ400.BIN Rename to: "+ta irq.400" (machine language program) Another CompuServe file contains a thorough explanation of what creating this patch involved: CompuServe name: IRQRTE.BIN Original name: "b128 irq rate" (Basic program) Although this is a Basic program, it cannot be run: just load it and LIST to read the explanation. ---------------------------------------- B. Keytrix CompuServe name: KEYTRX.BIN Original name: "keytrix v4" (Basic program) Keytrix is an indispensible aid for anyone programming the B128 in Basic. Several keywords are added to Commodore's Basic 4.0 commands, allowing the user to do such things as renumber a program, list a program from disk without loading it into memory, read sequential files from disk without disturbing the program in memory, merge programs on disk (including subroutines stored as program files) with the program in memory, find specified keywords, variable names, and/or strings in the program in memory and automatically change them if desired, and other useful functions. What's more, Keytrix uses the function keys F9 and F10 to scroll back and forth through the program in memory, ending the need to use LIST every time you have to check on a line which has scrolled off the screen. Keytrix uses 3 machine language routines to accomplish its lightning-fast work. These 3 routines need to be on the same disk as Keytrix, and must have the exact name specified in the program. B128 users will need these 3 files: CompuServe name: Rename to: 1128.BIN "+b1 kxb128.v4" (machine language program) 15128.BIN "+b15kxb128.v4" (machine language program) 15128P.BIN "+b15kxb128.v4+" (machine language program) B256 users will need these 3 files for Keytrix: CompuServe name: Rename to: 1256.BIN "+b1 kxb256.v4" (machine language program) 15256.BIN "+b15kxb256.v4" (machine language program) 15256P.BIN "+b15kxb256.v4+" (machine language program) Brief instructions for the use of Keytrix are provided in the next file: CompuServe name: KEYINS.BIN Original name: "keytrix v4.ins" (Basic program) -------------------------------------------------------- C. Supermon CompuServe name: SUPMON.BIN Original name: "supermonb v5" (Basic program) Liz Deal has adapted the famous Supermon program for the B128. Supermonitor offers machine language programmers an alternative to the built-in monitor provided by Commodore. Once again, it operates through machine language. The following four files are needed to run the program above: CompuServe name: Rename to: SMB04.BIN "+smb v5.0400" (machine language program) SMB0E.BIN "+smb v5.e000" (machine language program) SMB04P.BIN "+smb v5.0400+" (machine language program) SMBE0P.BIN "+smb v5.e000+" (machine language program) Brief instructions for the use of Supermon are provided in the next file: CompuServe name: SMBINS.BIN Original name: "supermonb v5.ins" (Basic program) --------------------------------------------------------------- D. Disk Utilities Liz Deal has provided several disk utilities for the B128, most of them adaptations of programs by Jim Butterfield. CompuServe name: DSKLOG.BIN Original name: "disk logger.b128" (Basic program) If you want to see a directory of the files on your disk, you can just issue the DIRECTORY or CATALOG command, or you can get a real fancy directory by running this program. It needs one machine language routine: CompuServe name: LOG400.BIN Rename to: "+disklog.400" (machine language program) As before, the name of the machine language program must be exactly as specified in the Basic program which calls it. CompuServe name: DSKMOD.BIN Original name: "diskmod.b128" (Basic program) With this program you can choose any track and sector on your disk that you want to modify. The bytes will be shown (in hexadecimal) on the screen; use the screen editor to change any bytes to whatever you want, and the program will make the same changes on your disk for you. CompuServe name: DSKVEW.BIN Original name: "disk view.b128" (Basic program) This program is similar to the previous one in that it displays whichever disk track and sector you specify, but it protects you against making unintentional changes on your disk. CompuServe name: COPALL.BIN Original name: "copy-all b128.3" (Basic program) This program is intended to allow you to copy any number of files from one disk to another, in whatever order you choose, but it requires a machine language routine which is not available on CompuServe. CompuServe name: CHGDEV.BIN Original name: "change dev#" (Basic program) Commodore disk drives are pre-set at the factory to be device number 8. If you have more than one drive unit, you can use this program to fool your computer into thinking one of them has a different device number. CompuServe name: BIGREL.BIN Original name: "big rel file" (Basic program) The 8050 disk drive can handle the same jumbo-sized relative files as the 8250. Run this program to command your 8050 to use the 8250 relative file routines. CompuServe name: EXPREL.BIN Original name: "8250 expand rel" (Basic program) This program came from the 8250 demo disk. Unless you have that disk, you cannot run it because it needs a DOS machine language routine found on a certain block of that disk. --------------------------------------- E. Spooling CompuServe name: SPOOL.BIN Original name: "spool b128" (Basic program) Spooling is a technique which allows the computer to be free to run programs while the disk drive is in use, typing out a file on the printer. Liz Deal wrote this one for the B128. Of course, any program you run will not be able to access the disk drive while it is in use. CompuServe name: WSPOOL.TXT Original name: "w.b128 spool" (sequential file) This is a SuperScript II sequential file which explains how spooling works. ------------------------------------------------------------------------------ F. Machine Language CompuServe name: DCLPAL.BIN Original name: "dcl b128.pal" (Basic program--load & list) This is a detailed memory map for the B128, formatted for use in the PAL assembler. CompuServe name: WXCALL.DOC Original name: "w.b128 xcalls" (sequential file) An extensive discussion of machine language programming in the B128, and in particular the setup needed before code in a nonsystem bank can access the Kernal routines, or in fact any routines outside its own bank. CompuServe name: BTXFER.BIN Rename to: "+btxfer.fe48" (machine language program) Here's the transfer of execution code essential for bank-hopping, as explained in the file above. CompuServe name: XCALL.BIN Original name: "xcall" (Basic program--load and list) Liz Deal wrote this program to demonstrate how to create a pseudo-jump table in a machine language routine. Details are given in WXCALL.DOC, above. This file is actually the source code for an assembly language program, and it contains a commented disassembly of the machine code. ----------------------------------------------------- G. Others CompuServe name: WEXP15.BIN Original name: "w.exp15" (sequential file) A text file which explains how you can adapt your CalcResult cartridge to serve as extra RAM in bank 15. CompuServe name: CON128.BIN Original name: "configure b128" (Basic program) Liz wrote this little program for those who don't use Keytrix or Supermon. It will relocate the Basic program text area to $401, where it resides in the PET/CBM computers. CompuServe name: PRIMES.BIN Original name: "pr...
Amiga7878