USADACS@SIMTEL20.ARPA (Al McIntosh) (06/11/88)
This is an edited version of the documentation contained in PD2:<CPM.C128> on Simtel20: @TITLE = C128 PROGRAMS @DISK LABEL = 12001 801PRT.ARC - is a file printer program designed with the Commodore MPS-801 printer in mind. It has always annoyed me that the MPS-801's buffer must be "flushed out" with a carriage return. All the file listers I've used tend to drop the last line of a file when sending it to the printer. This program sends two extra carriage returns to the printer after it print the file, to make sure the last lines are printed. It also filters out linefeeds. 801PRT10 is designed for the Commodore MPS-801, MPS-803, and 1525 printers. However, it should work with any printer that does not require linefeeds. ASCIISYS.ARC - is a program which will modify the 12/6/85 CPM+.SYS to accomodate standard ascii printers and print buffers. ***THIS PROGRAM WILL NOT WORK WITH OTHER CPM+.SYS RELEASES*** The C128 CP/M operating system contains two features which cause problems in many standard ascii printers. ASCIISYS patches three bytes in the CPM+.SYS file associated with printer operations. To use the program, put a copy (not your original!) of the 12/6/86 CPM+.SYS, CCP.COM, and ASCIISYS.COM on a disk.Type "ASCIISYS X" at the CP/M prompt. ASCIISYS will alter the CPM+.SYS file on the disk. After ASCIISYS is done, if all goes well, you'll get a message saying that you can reboot with the new CPM+.SYS; a standard ascii printer should work correctly now. If there is a problem of some sort and ASCIISYS does not find the bytes which it expects, it will put an error message on the screen and terminate operation.In this case,the CPM+.SYS file on the disk will be unreliable and should not be used to boot up the 128. BIOSR3.ARC - This file is an attempt to explain the relationships between the various modules in the C-128 BIOS. There are thirteen ASM files, and five LIB files that comprise the source code to the C-128 BIOS. Each file relates to specific areas of the operating system. CXKRNL.ASM is the root module for the BIOS. This file is supplied by Digital Research and should not be modified at all, except to add a RET to unimplemented calls. CXKRNL.ASM calls all of the other modules. CXIO.ASM contains the character I/O tables, the time routines (CXTIME), and the RS-232 code. In the version I have supplied here the Drive Search Chain and the Temporary drive are initailized, the cursor is set up, and the feel and repeat are set up. Note that the BIOS I have supplied here will only work on North American C-128s (NTSC), all code pertaining to PAL has been removed. CXINTR.ASM is the interupt Driver, it reads the pseudo RS-232 port and the keyboard storing the characters in a buffer. The modifications I made were to delete the 40 column cursor flash routine. CXKEY.ASM is the keybord handler. Changes here were to add a screen dump, delete all 40 column code. This module is called by CXIO in order to read and interpret the keyboard. All special funtion code is here too. CXEM.ASM is the ADM-3A/ADM-31 terminal emulation. This module handles all 80 column screen output. Changes were to delete the 40 column code. CX80.ASM is the rest of the 80 column screen driver as well as the initialization routines. The status line handling code is here also. Changes here were to delete the 40 column code. CXPRINTE.ASM is the print driver. Currently it is only set up for two printers, selected by the DEVICE command, the default printer is selected during system initialization in CXIO. This routine has been rewritten to remove all ASCII conversion code, as well as make it easier to define the device address and secondary addresses. CXDISK.ASM is the Disk handling code, this code handles all disk I/O via the 8502 BIOS (FAST8502.ASM). Currently it supports three 15x1's as A, B, and C. Changes here were to remove the 40 column status code, drive E:, and drive D:. CXRAMDSK.ASM is the RamDisk driver for the 1700/1750 Ram Expander. The Ramdisk is defined as drive D:. Only a small change was made to the code that removes the pointer in the DRVTBL to this code if the 1700/1750 is not present. CXEXT.ASM contains the DRVTBL. It is here that you make the changes in drive assignment names. Also here is the 6551 drivers (you can actually make a 6551 based serial port and this code will drive it). CXSCB.ASM is the System Control Block, which is a storage area for various system information (see the DRI manual for a definition). Changes here were to add labels for the drive search chain and the temporary drive. CXKYCODE.ASM is the character code definition table, funtion keys are defined here also. FAST8502.ASM is the 8502 BIOS code that is stored in bank 0, it contains the code that calls the 6502 code print and disk drivers. Z80.LIB contains macros that define Z80 Assembler code for RMAC. MODEBAUD.LIB contains equates for the character I/O modules. CXEQU.ASM contains all of the general equates for all of the modules, as well as important memory locations to the system. X6502.ASM contains macros for 6502 assembler code for RMAC & MAC. CPM3.LIB contains macros for the CP/M+ disk definitions. GENCPM.DAT contains information for GENCPM to generate te system with. CXSYS.GET is a batch file that builds a system for you automaticly. The system these file generate assumes the following hardware:C- 128 (of course); 80 col. monitor, color of monochrome; Two printers, one as device 4, the other as device 5-this can be changed in the print driver CXPRINTE.ASM; Up to three disk drives either 1541 or 1571s; 1750 ram expader; Modem interfaced to the user port. Max speed 1200 baud. A 6551 (UART) card interfaced to the expansion port (note that this has not been tested with the 1750 at the same time), to allow for speeds up to 19.2 Kbaud. NOTE that the virtual disk (DRIVE E:) is _NOT_ supported. BYE.ARC - BYE5 insert for Commodore C128, external modem - 7/21/86 change MDCARCK to correct the actual PORT check. Note all the I/O in the C=128 is located in Bank 0, and can be read and written useing the Z80's IN and OUT with 16bit pointers. BYE128.ARC - THESE ARE THE DOC'S ON INSTALLING THE BYE510C R CP/M SYSTEM ON THE C=128 COMPUTER. THE MODEM USED WAS THE C=1670 STOCK UNIT. MANY THANKS ARE GIVEN TO IRV HOFF WHO ASSISTED THE WRITER WITH THE INSTALLATION. WHAT'S INCLUDED: 1. BYE128.LBR; 2. BYE128.DOC (THIS FILE). BYE1670E.ARC - This file is a set up for BYE510 to work with the C128 and the 1670 modem. I have included a list of the equates that you must set when setting up BYE to run. The list of equates and the coments are from Dave Giunti, he has done alot of work with BYE and the C128. I have added my comments for the 1670 Modem. If you are going to set up your own equates then by all means read the equate file carefully and then you should have no problems in getting BYE to run the 1670 modem. In order to use the equates pick up the BYE510 library along with the insert for the C128 that is available on most of these systems. For those that wish to just plug it in a run, I have included here both BYE.COM and B5-driv3.COM. These two programs will allow you to run BYE on your C128 and 1670 modem. NEWSYS.ARC - To Enable Downloading In The Commodore 128 CP/M Mode Converting NEWSYS.COM and IMP.COM to CP/M Format. This Text will explain how you will be able use the "CP/M Mode" of your Commodore 128 for telecommunication via the modem (user port). MEX.ARC - is a telecommunications program (MODEM program) for commecting to remote computers and down loading or uploading files. Also has provisions for buffer capture, automatic dialing and supports handshake protocols. WORDSTAR.INF - Patching Information For WORDSTAR 3.30 On the techniques involved in copying your master disk and running the WINSTALL program. If you are using version 2.2x of Wordstar, your installation and patching commands may be slightly different. The address labels will be the same except where noted, however, and the general procedure is the same. Please see your manual for more information. If you need more basic information in terminal setup, etc., there are many texts within the CP/M section of most public databases with more extensive instructions on Wordstar patching. @DISK LABEL = 12002 FORMAT.ARC - C128 CP/M FORMAT PROGRAM - Released by Commodore 1 May 1986 Formats the following disk types: C64 single sided; C128 double sided; C128 single sided; IBM Single Sided; IBM Double Sided; KAYPRO II; KAYPRO IV; EPSON QX10 512 byte sectors; OSBORNE Double Density. TVXC128.ARC - This version of TVX was compiled and linked with Aztec C II Release 1.05 on the Commodore 128 computer. The source consists of include files VX_DEFS.IC, TVX_GLBL.IC, and TVX_TERM.IC; plus C source files TVX_1.C, TVX_2.C, TVX_IO.C, TVX_LEX.C, and TVX_LIB.C. The make file MAKEFILE defines the dependencies among the source modules, and directs compilation using the Aztec C compiler. This assumes you have a make program. If you don't, just compile the 5 C source files and link them to generate TVX.COM. Use whatever compiler you love most; I tried it with MIX C, but it came out so large as to be nearly useless. NOTE: This version of TVX is essentially Bruce Wampler's 1/30/86 version with a slight modification so that the text buffer will automatically adapt to the available TPA. This version is pre- EMACS/VI emulation capability - I doubt the newer version with EMACS and VI interfaces would fit into a 58K TPA with any reasonable text buffer size (the text buffer is already only about 14000 bytes as it is.) Neither the configuration file capability (-c option), nor full help is supported in the interest of space. CPMPRMR.ARC - CP/M Mini-Primer *** Easy Handling of DIRectories. Disk and File Attributes - Time/Date Stamping - Password Protection. The CP/M environment is a lot different from the Commodore operating system (and a bit slower on our 128's than in most CP/M machines), it is nonetheless an interesting and powerful world. This month we will add to that power and discuss ways to speed up the system and generally make life easier for you thru the use of key configurations and batch processing of commands in a variety of ways. This is a collection of files that discusses some of the different capabilities of the C128 and differences between the CBM and CP/M operating procedures. M7.ARC - Modem 7 overlays for the C1660 and C1770 modems on the C1228 computer. Must be assembled using the MAC assembler in the CPM package obtainable from Commodore. M7-C1660 (MDM) C1660 and C1650 overlay for C128 31 Oct 85. M7-C1670 (MDM) 1670 or HAYES overlay for C128 31 Oct 85. MISC.ARC - is a collection of miscallenous programs and documentation files related to the C128. Some of the files are "crunched" and must be uncrunched before theycan be used. This program is avaliable in the RAMPAK.ARC file. RAMPAK.ARK - is an archive of utility programs for the C128 operated in CP/M mode. Briefly, these programs are: 1571.COM; CONF2.COM; CRUNCH23.COM - file compression program; D.COM directory porgram; FILTX.COM; FINDBAD.COM finds bad sectors on a disk; LBR.COM makes library files; LLIST.COM printing program; LT18.COM; LU3.COM classic library program; MEX.COM modem program ready to go; NFORMAT.COM disk formatter(?); NSWEEP.COM; PROFILE.SUB; READCBM.COM; READMSDS.COM; SQ111.COM file compression program; UNARC.COM extracts programs and data file from archives; UNCR.COM "uncrunches" "crunched" files; UNERASE.COM; UNIDRIVE.COM; UNSQZ.COM unsqueezes squeezed files; VDE.COM; VINST25.COM. @DISK LABEL = 12003 C128BYE.ARK - is a collection of BYE programs for remote access control of your computer when using a modem for communications. CONF.ARC - This ARC contains the Commodore C128 CP/M configure program, dated 21-Jan-86. This version replaces earlier CONF programs. Rename CONF2.COM to CONF.COM after downloading to your disk. Rename CONF2.HLP to CONF.HLP after downloading to your disk. An error in PRINTER.HLP has been corrected. This file gives helpful hints on configuring the CP/M system printer device for regular and Commodore ASCII. C128MUST.LBR - is a collection of programs for conversion from CBM to CPM. C128SYS.ARK - The new CCP.COM file has a time prompt; example [12:23] A14, with user number. The PROFILE.SUB file automatically loads DATE.COM and SET.COM files and will ask you for the date time, if those files are on the disk. Since they are Digital Research files they are not in this library. FILECOPY.ARC - So who needs another file copy utility for CP/M? Commodore 128 users with a single 1571 drive, that's who! This program, unlike PIP or SWEEP, buffers several files between disk swaps, in an effort to minimize disk swapping. It utilizes virtual drive E: to do this. The buffer size is such that a full native 1571 diskette full of files can be copied in about 7 pairs of swaps. If there are more than 7 files on the diskette, this is a distinct advantage over PIP or SWEEP. Nothing fancy here. Self prompting program - just run it with no command line arguments and it will prompt you through the copy. CP4.ARC - This version of Kermit has been setup to use several features of the Commodore 128 CP/M+ operating system. Please understand, I used the fastest way I knew of at the time to get it running on the 128, which is using the AUXIN: and AUXOUT: BDOS calls. I hope to change this to direct BIOS calls in a few weeks, but I am currently a college student, and have little or no time. To use Kermit on the 128, you must have the CPM+.SYS file dated 4 Dec 85 or later. Additional installation information is contained in the ARC file. KEY128-2.ARK - Commodore has included a nice program called KEYFIG with C128 CP/M that allows you to assign strings to your function keys (or any other key) or to completely redefine your keyboard. You could easily create a Dvorak keyboard if you wanted. The problem is that it's not so easy to change the key assignments if you'd like to have one set of function keys set up for NewWord or WordStar, another set for SuperCalc, a third for dBase II, and maybe a fourth for general utilities like taking disk directories. You've got to call up KEYFIG and change each key individually before loading your application program, or you've got to have several boot disks--one for each set of function key assignments. SAVEKEY will save the current key assignments at anytime to a small 1K file so you never have to recreate that set of assignments again. LOADKEY will load any file of key assignments into your CP/M BIOS within a couple of seconds after you enter a two-word command at the CP/M prompt. PBBS8COM.ARK - Public Bulletin Board System for the C128. There is only one message folder named GENERAL in this instalation. Every thing goes on A: drive except uploads and downloads, which is B: drive. To install you will first have to run PINSTAL.COM on the system user area A14:. You will be asked to log your self in during this operation, and you will automatically be set at SYSOP access level. If you are converting an existing user file this information will be replaced with your converted record. Please read appendix A in the doc files in the PBBS03.LBR for further information. When you finish with the questions in PINSTAL.COM, go back to A0: and run BYE.COM. Wait, it will jump down 2 times after a few minutes. Now do a CONTROL and it will show four commands. Choose the 'E' execute a COM file. It will load PBBS.COM file. procede with normal sign-on, you should have been set as SYSOP in the PINSTAL program. Select the 'M' option to go to the MAIL menu. Enter some sort of welcome message or one that describes some of the system functions. The reason that this must be a public message and must be entered AFTER you have set your level to 9 is so that you have 0 for days to deletion in your user record. This is transferred to the message in the database. This is only important when you use option 4 in PBBSMNT to pack the message files. If pack is used on an empty file it will do strange things. Save this message to the 'GENERAL folder so that all users may read it . After saving the message select option 'Q' to end the session. Because you are running locally, without a carrier, BYE PBYE will update the user file, and return you to BYE, which will load the PBBS.COM file and wait for the next call. Since you signed on locally PBYE will not ask you to leave a comment like it would a regular caller, as PBYE knows you are the SYSOP, upon exit. Also, if you exit the system by typing BYE from the CP/M prompt, BYE will not allow PBYE to run, and thus you will not get session statistics. Both of these situations are normal and are not a reason for concern. RAMPAKD.ARK - Documentation files for programs contained in the RAMPAK.ARK (disk 12002). The doc files are: KFINDBAD.DOC, LLIST.DOC, MEX.DOC, READMS.DOC, UNERASE.DOC, UNIDRIVE.DOC, and VDE25.DOC. RDCBM20.ARC - corrects a serious flaw in RDCBM10. In addition to working properly, this version is also 10K smaller and quite a bit faster. Please remove any copies of RDCBM10 which you may have and replace them with this version. RDMSDOS.ARC - is the Commodore 128 CP/M adaptation of RDMS (version 2.33 of 7 May 86). It allows reading of any of the 4 MSDOS format diskettes on the C128. MSDOS format is that produced by the IBM-PC and it's clones, when running the PC-DOS or MS-DOS operating system. When using this program on the C128, after the MSDOS drive is specified, the C128 bios will display a diskette format selection at the bottom of the screen. The user must use the right/left arrow keys to make this format match the type of MSDOS diskette in the drive; valid choices are MSDOS-1 DS or MSDOS-1 SS (the 8 sector/track formats from older MSDOS versions), and MSDOS-2 DS or MSDOS-2 SS (the newer 9 sector/track formats). When the correct format is displayed, the return key should be pressed to continue with the program. If the incorrect format is selected, the program will still indicate the correct format, but part of the directory, and all files, will be read incorrectly. Note that the default double side strategy is "cylinder" mode, so none of the flags mentioned in the documentation need ever be used - just use RDMS or RDMS UNIDRIVE.ARC - is (c) Copyright 1986 by Frank Prindle. This program may be freely distributed in both source and object form, but may not be sold for profit. UNIDRIVE-128 is a utility for the Commodore 128 running CP/M Plus, with one or more Commodore 1571 disk drives. UNIDRIVE-128 enhances the C-128 CP/M implementation by allowing the 1571 disk drive(s) to read or write CP/M 5.25" MFM disk formats other than the seven MFM formats supported by the standard Commodore supplied BIOS. UNIDRIVE-128 is menu driven and simple to use; select the MFM format(s) to be supported (up to 10) by pressing the menu letter, then press RETURN to enable use of those formats. The standard 7 formats are pre-selected, but may be de-selected by pressing their menu letter if more than 3 additional formats are required (not real likely). To abort without changing the current formats supported, press the ESCape key. Once a set of formats have been selected and enabled, and UNIDRIVE-128 has terminated, an MFM CP/M diskette in any of the selected formats may be inserted into any 1571 drive on the system (including virtual drive E:) and logged in. If the diskette being logged could possibly be one of several different formats selected, the Commodore BIOS will display a potential disk format at the bottom of the screen; use the right arrow key to change this display (if necessary) until the format displayed corresponds to the format of the disk in the drive, then press RETURN. If the diskette being logged could only match one selected format, no menu selection will be required. If the diskette being logged does not match any selected format, "missing" will be displayed and pressing RETURN will report a disk error. When multiple formats have been selected, each drive in the system may be logged in with a different MFM format; the three Commodore GCR formats are unaffected and always available. UNIDRIVE-128 Version 1.0 supports only 24 CP/M disk formats (chosen pretty much at random) on one menu screen, and does not support diskette formatting. Future versions will support many more formats, and will support formatting. Only "double density" MFM formats are currently supported since it is not known if the 1571 can read or write in single density (nor do I have a source of single density diskettes with which to test); perhaps this will be ironed out in future versions. VDE-C128.ARC - is an install file for the VDE (Video Display Editor) for the Commodore 128. @DISK LABEL = 12004 SIGMV800.ARK - Programs from the SIG/M catalog. C128.DOC - Explains how to update C128 CPM; NEWSYS.COM - Program to update C128 CPM; 64CONV; CONFIG.COM - believed to be configuration program; IMP-C128.COM - IMP modem program for C128; MEX128.COM - MEX modem program for C128; I2C8-1.ASM Overlays for C128 modem programs; M7-C1660.ASM, M7C167.ASM, MXM-C128.ASM, MXO-C128.ASM; SIG.CAT - SIG/M Directory Volumes 256 -- 151. -------