TRS-80 Software
Total Page:16
File Type:pdf, Size:1020Kb
REGISTRATION NUMBER 00000001 NEWDOS 8O FOR THE TRS-80 MODEL I / III / 4 MICRO COMPUTER Apparat Incorporated takes pleasure in presenting NEWDOS/80, Version 2.5. Above is the registration number of your NEWDOS/80. This registration number must be the same as the registration number you find on your diskette label and the enclosed registration card. If they are not, return them to the dealer from whom you purchased your NEWDOS/80 to be reissued. This registration Number is your assurance of receiving any corrections or minor revisions to NEWDOS/80 that may be released. The registration card should be completed and returned to Apparat at your earliest convenience. PLEASE RETURN THE CARD IT IS IMPORTANT! It our only method of determining who has purchased this copy of the system. This number should be included in all correspondence with Apparat. Apparat, Inc 4401 So. Tamarac Parkway • Denver, Colorado 80237 HELPFUL HINTS IN USING YOUR NEWDOS/80 VERSION 2.5 We suggest using the following checklist as a guide to setting up software on your Hard Disk System: 1. Carefully read through all related documentation. 2. Make hardware installation as directed by instructions supplied with your Hard Drive Unit. 3. Boot on your NEWDOS/80 Version 2.5 original master diskette and make backup copy or copies. Refer to Chapter 1, Section 1.4 of the NEWDOS/80 Version 2.0 manual for details if unfamiliar with the procedure. 4. Designate one of your backups as a working copy an d boot (or reset) on it. Use this diskette for the remainder of this procedure. 5. Use HDFMTAPP/CMD. Refer to Section 4 in the NEWDOS/80 Version 2.5 manual (Appendix C). 6. Set up your PDRIVE definitions for the Hard Drive Volumes according to Section 3 & 6 of the NEWDOS/80 Version 2.5 manual. 7. Use DOS command FORMAT on each defined volume of the Hard Disk. This has not been very clear to some of our users. HDFMTAPP/CMD is only a "media format" utility that allows the hard drive to be used with NEWDOS/80 (or other DOS system). DOS command FORMAT, although does not prepare the media as HDFMTAPP/CMD, is important for checking the media and preparing the directory (DIR/SYS) and the boot sectors (BOOT/SYS) on the hard drive volumes. If the volume was not prepared with FORMAT, it will seem to operate correctly with COPY, OPEN, and CLOSE (ie. normal file operations), but HDBACKUP/CMD and DIRCHECK/CMD will not function. 8. (Optional) Move NEWDOS/80 Version 2.5 to Hard Disk Volume. Refer to Section 5 of the NEWDOS/80 Version 2.5 manual. Don't forget to move your PDRIVE definitions to appropriate new slots. Follow procedure to create Boot Diskette. 9. Install application software and related data files. Table of Contents Chapter 1. INTRODUCTION 1.1. Registration. .................................................. 1-1 1.2. Trademark Credits. ............................................. 1-1 1.3. What Is Apparat's DOS/80 Version 2? ............................ 1-1 1.4. Duplicate and Specify the System. .............................. 1-2 1.5. Apply Outstanding Zaps. ........................................ 1-4 1.6. Commence Using NEWDOS/80. ...................................... 1-5 1.7. Apparat Thanks Its Beta Testers. ............................... 1-5 Chapter 2. DOS LIBRARY COMMANDS 2.1. Notation Conventions and General Information. .................. 2-1 2.2. APPEND Append one file onto the end of another. ............. 2-2 2.3. ATTRIB Assign attributes to a file. ......................... 2-3 2.4. AUTO Define the DOS command to be executed at reset. ...... 2-5 2.5. BASIC2 Activate non-disk BASIC (Model I only). .............. 2-5 2.6. BLINK Enable/disable cursor blinking. ...................... 2-5 2.7. BOOT Reset the computer. .................................. 2-6 2.8. BREAK Enable/disable the BREAK key. ........................ 2-6 2.9. CHAIN Shift to keyboard input from disk. ................... 2-6 2.10. CHNON Alter chaining state. ................................ 2-7 2.11. CLEAR Clear user memory routes, timer and logical enqueues. 2-8 2.12. CLOCK Display the time every second. ....................... 2-9 2.13. CLS Clear the display. ................................... 2-9 2.14. COPY Copy single or multiple files or a full diskette ..... 2-9 2.15. CREATE Pre-allocate a disk file. ............................ 2-18 2.16. DATE Set computer's current date. ......................... 2-19 2.17. DEBUG enable or disable the DEBUG facility. ................ 2-20 2.18. DIR Display a diskette's directory information. .......... 2-20 2.19. DO Shift to keyboard input from disk. ................... 2-22 2.20. DUMP Dump memory contents to disk. ........................ 2-22 2.21. ERROR Display DOS error message. ........................... 2-24 2.22. FORMAT Format a diskette for use with the NEWDOS/80 system. 2-24 2.23. FORMS (Model III only) Set printer parameters. ............. 2-26 2.24. FREE Display free granule count of each mounted diskette .. 2-27 2.25. HIMEM Set DOS's high memory value. ......................... 2-27 2.26. JKL Send current contents of display to the printer. ..... 2-27 2.27. KILL delete a file. ....................................... 2-28 2.28. LC Set keyboard a-z toggle switch to specified state. ... 2-29 2.29. LCDVR (Model I only) Lower case driver. .................... 2-29 2.30. LIB Display NEWDOS/80 library commands. .................. 2-30 2.31. LIST List a text file on the display. ..................... 2-30 2.32. LOAD Load a Z-80 machine language file into RAM. .......... 2-31 2.33. MDBORT Terminate MINI-DOS and go to DOS READY. .............. 2-31 2.34. MDCOPY Copy a file while under MINI-DOS. .................... 2-32 2.35. MDRET Exit from MINI-DOS and return to main program. ....... 2-32 2.36. PAUSE Display message and pause waiting on ENTER. .......... 2-33 2.37. PDRIVE Assign default attributes to a physical drive. ....... 2-33 2.38. PRINT List a text file on the printer. ..................... 2-39 2.39. PROT Alter some diskette control data. .................... 2-40 iii 2.40. PURGE Selectively kill files from a diskette. ..............2-41 2.41. R Repeat the previous DOS command. .....................2-41 2.42. RENAME Rename a file. .......................................2-42 2.43. ROUTE Route one device to or from another ..................2-42 2.44. SETCOM (Model III only) Set RS-232 interface parameters. ....2-44 2.45. STMT Display specified message. ...........................2-45 2.46. SYSTEM Change system options. ...............................2-45 2.47. TIME Set the real time clock. .............................2-50 2.48. VERIFY Require verify read after every disk write. ..........2-51 2.49. WRDIP Write directory sectors protected. ...................2-52 Chapter 3. DOS ROUTINES 3.1. Specifications Defined .........................................3-1 3.2. 402DH No-Error Exit ........................................3-1 3.3. 4030H Error-already-displayed DOS Error Exit ...............3-2 3.4. 4400H No-Error Exit. Performs identical to 402DH. ..........3-2 3.5. 4405H Enter DOS and execute a command ......................3-2 3.6. 4409H DOS Error Exit .......................................3-2 3.7. 440DH Enter DEBUG ..........................................3-3 3.8. 4410H Enquene a user timer interrupt routine. ..............3-3 3.9. 4413H Dequeue a user timer interrupt routine. ..............3-4 3.10. 4416H Keep drives rotating .................................3-4 3.11. 4419H DOS-CALL Execute a DOS command and return. ..........3-4 3.12. 441CH Extract a filespec ...................................3-5 3.13. 4420H Open a FCB to a new or existing disk file ............3-5 3.14. 4424H OPEN a FCB to an existing file .......................3-6 3.15. 4428H CLOSE a FCB. Conditions 3.1.A, B and C hold ..........3-7 3.16. 442CH Kill the FCB's associated file .......................3-7 3.17. 4430H Load a program file ..................................3-7 3.18. 4433H Load and commence execution of a program file ........3-7 3.19. 4436H Read sector or logical record from disk ..............3-7 3.20. 4439H Write sector or logical record to disk ...............3-8 3.21. 443CH Write sector or logical record to disk with verify ...3-9 3.22. 443FH Position FCB to start of file ........................3-9 3.23. 4442H Position FCB to a specified file record ..............3-9 3.24. 4445H Position FCB back one record .........................3-9 3.25. 4448H Position FCB to EOF ..................................3-9 3.26. 444BH Allocate file space ..................................3-10 3.27. 444EH Position FCB to the specified RBA ....................3-10 3.28. 4451H Write the EOF value from the FCB to the directory ....3-10 3.29. 445BH Select and power up the specified drive ..............3-10 3.30. 445EH Test for mounted diskette ............................3-10 3.31. 4461H *Name routine enqueue ................................3-10 3.32. 4464H *name routine dequeue ................................3-11 3.33. 4467H Send message to the display ..........................3-11 3.34. 446AH Send message to the printer ..........................3-11 3.35. 446DH Convert clock time to HH:HM:SS character format ......3-11 3.36. 4470H Convert the date to MM/DD/YY character format ........3-11 3.37. 4473H Insert default name extension into filespec ..........3-12 3.38. 0013H Read a byte from a disk file .........................3-12 3.39. 001BH Write a byte to a disk file ..........................3-12 3.40. 447BH Model III only (performs as Model I 4410H) ...........3-12