************************** * TRANSFER DOCUMENTATION * ************************** by David Koski P.O. Box 1078 Fort Bragg, CA 95437-1078 I. INTRODUCTION TRANSFER is a utility that provides an easy method of transfering files to and from MS/DOS compatable disks with a CP/M host system. Written com- pletely in Turbo Pascal, it includes these features: - Full Access of directory of MS/DOS with ambiguous file reference - Access to CP/M directory with ambiguous file reference - Display of MS/DOS FAT (File Allocation Table) - FAT recovery from backup FAT (Careful!) - File transfer to and from MS/DOS using PIP-like ambiguous (wild card) file references - Source code - - of course II. INSTALLAtTION After making a working copy of the distribution disk, with your original disk in a safe place you should have the following files: TRANSFER.COM TRANS-00.INC TFR-INST.COM TRANSFER.DOC TRANS-01.INC TFR-INST.MSG TRANSFER.PAS TRANS-02.INC TFR-INST.DTA TRANSFER.DOC TRANS-03.INC TRANS-04.INC TRANS-05.INC TRANS-06.INC For screen functions use TFR-INST, a GINST-made instalation program. Install TRANSFER the same way you install TURBO PASCAL. TFR-INST.MSG and TFR-INST.DTA are used by TFR-INST.COM. Now the BIOS in your system must know that your MS-DOS disk is "foreign". Many systems come with a utility to accomplish this. Your BIOS usually not only must know the sector size of the MS-DOS disk (usually 512) but the Density (Double). In short You must "tell" your BIOS that the drive with the MS-DOS disk in it is "IBM-PC DS" or something similar. For reasons mentioned above, TRANSFER is system BIOS dependent. If that wasn't enough, each different BIOS likes to do the BIOS function call Sectran it's own way. Some systems need TRANSFER to call Sectran before each sector read. Also, in some systems a sector bias needs to be applied to each BIOS call from TRANSFER. These variations are accomplished by patching the constants in the source TRANSFER.PAS and recompiling. Some experimenting may be necessary. For example some Kaypros need "SO = 4" to give a sector bias of 4. This is because of 4 CP/M records (128 bytes) are in each 512 byte MS- DOS sector. Many systems automaticly identify newly logged on disks. The trouble is they usually come up with the wrong identity for the MS-DOS disk and often think it is single sided. If you are unable to patch your BIOS to prevent this then you may be able to use single sided MS-DOS disks only, or trick your system by logging on to a standard double sided disk first. Then without warmbooting, bring up TRANSFER. Systems with single sided drives can of coarse only transfer single sided disks and TRANSFER may need minor modification. Addendum - by C.B. Falconer =========================== TRANSFER (nov ver 1.1) now expects to operate in conjuction with DSKDRIVE system. To install this for your system you will need DSKDRV16.LBR and RSX12.LBR (latest versions as of 86/Oct/14). You will have to create the appropriate physical driver for systems other than the Kaypro. The outlines are completely specified. The resultant system will function correctly with any CPM 2.2 system. TRANS-00.INC and TRANS-06.INC files contain material split off from the original TRANSFER.PAS file. See also the notes re the sectran operation, in TRANSFER.PAS. Should you have other physical mechanisms available to you, TRANSFER need only be modified in the CHECKDRIVER routine (module #01) to accept it. Be warned that TFR-INST may not run on your system. It requires a large TPA. The distributed TRANSFER.COM file will work with Kaypro's and ADM-3a terminals and look-alikes. For others I recommend re-compiling. This file was compiled under TURBO 3.01A. Files are now protected by CCITCRC checksums. CCITCRC *.* should produce a 00 00 FIRST checksum, in both crunched and uncrunched form. C.B. Falconer, 680 Hartford Tpk., Hamden Conn. 06517. (203) 281-1438