SIG/M volume 13 a) MITS to CP/M file conversion system b) HELP file system c) related system support programs d) FIG-FORTH 1.1 system number name size description 13.1 MITSCNVT.ASM 28K MITS to CP/M file conversion 13.2 MITSCNVT.COM 7K / 13.3 MITSCNVT.CPM 3K / 13.4 MITSCNVT.DOC 7K / 13.5 MITSCNVT.HEX 8K / 13.6 ABORTSUB.COM 2K HELP file system 13.7 HELP.ASM 13K / 13.8 SYSLIB.HLP 37K / 13.9 SYSLIB.REL 9K / 13.10 HELP.COM 2K / 13.11 MASM.SUB 1K / 13.12 PHELP.COM 2K / 13.13 PHELP.MAC 6K / 13.14 HELP.DOC 4K / 13.15 SD-2/6.ASM 18K updated SUPER DIRECTORY display 13.16 SD.COM 2K / 13.17 ENTAB.ASM 6K space suppression program 13.18 ENTAB.COM 1K / 13.19 UTIL.FOR 2K FORTRAN array handling subroutine 13.20 LOOPBAK1.BAS 2K PMMI loop back test 13.21 FORTH11.ASM 40K FIG-FORTH version 1.1 13.22 FORTH11.COM 23K / 13.23 FORTH11.DOC 4K / FORTH.DOC NOTE from CALAMITY CLIFFS COMPUTER CENTER - 9/1/80 The FORTH11.ASM file as it stands is apparently set up to run on a HEATH system. We have no information on the function of any of the labels in the source listing, and as there is no (or very little) useful commenting in the source listing regarding what code is hard- ware dependent and how it should be modified for use on other systems, we offer this program with the advice: ****** CAUTION >>>> CAVEAT EMPTOR <<<< CAUTION ****** Before attempting to use or modify the program, it is advised that the complete documentation be procured from the FORTH INTEREST GROUP. In addition it might be a good idea to contact Rick Schaeffer for clari- fication concerning the uncertain function of much of the code in the program. The only thing that we can attest to at the present time is that we have successfully assembled the code, as you see it here, with the CP/M 2.2 Digital Research assembler without error. We have not tried to run the program, as the hardware dependencies have not been identified with certainty. In addition, we have no idea whether or not it will run successfully under CP/M 2.2. -Calamity Cliffs Computer Center THIS DOCUMENTATION SUPPLEMENTS THE ASSEMBLER SOURCE FOR FIG-FORTH WHICH RESIDES HERE AS FORTH11.ASM. THIS SOURCE IS PROVIDED THROUGH THE COURTESY OF THE FORTH INTEREST GROUP, P.O. BOX 1105, SAN CARLOS, CA. 94070 AND WAS ENTERED AND DEBUGGED BY RICK SCHAEFFER, 2011 AZTEC DR. BLACKFOOT #1 NORTH LITTLE ROCK, AR. 72116. THIS COPY OF FIG-FORTH HAS BEEN DE-BUGGED IN THAT IT IS RUNNING ON MY H8 SYSTEM UNDER CP/M VERSION 1.43. AFTER SEVERAL ABORTIVE ATTEMPTS, I SUCCEEDED IN DOWN LOADING IT TO MICRONET BUT I HAVE NO WAY OF KNOWING IF THERE WERE ANY ERRORS IN TRANSMISSION SINCE I DO NOT HAVE ANY WAY OF HAND SHAKING WITH MNET. ON THE VERSION THAT I HAVE RUNNING, I HAVE CHANGED SOME OF THE ADDRESSES TO MAKE ROOM FOR MORE DISK BUFFERS, HOWEVER, THIS COPY IS INTACT AS PRINTED IN THE FIG-FORTH ASSEMBLY LISTING. THIS SHOULD MAKE IT RELATIVELY EASY FOR INTERESTED USERS TO GET THE SYSTEM RUNNING EVEN IF SOME OF THE DATA WAS LOST IN TRANSMISSION BECAUSE THE ASSEMBLED ADDRESSES SHOULD BE THE SAME AS THEY APPEAR IN THE FIG LISTINGS (THIS IS FOR FIG-FORTH VERSION 1.1....BY THE WAY). YOU SHOULD HAVE THE FIG MODEL MANUAL AND THE FIG ASSEMBLY SOURCE LISTING BEFORE ATTEMPTING TO USE THIS. HOPEFULLY, AT LEAST THIS SAVES A *LOT* OF TYPING FOR SOMEONE! GOOD LUCK! RICK SCHAEFFER (70120,174) OK Program HELP SOURCE LANGUAGE CP/M ASSEMBLER.. HARDWARE REQUIRED CRT 24x80.. MEMORY REQUIRED Depends on HELP File Loaded (56K Max).......... DESCRIPTION OF WHAT IT DOES: HELР i progra whic provide a interactiv onlin documen tatio system Wit th supplie HEL Files HEL display selecte sec tion o th HEL File t th use on scree displa a time Al outpu i oriente fo displa o 2 lin 8 colum CRT. Tw type o HEL File ar supporte b th HEL program Thes ar indexe an non-indexed Wit non-indexe HEL File HELР display th entir fil t th use on screen-displa a time Wit a indexe HELР File HEL display men o th section o thi HEL Fil t th use an allow hi t selec a item Single-characte inpu i employed Onc selected HEL jump t tha sectio an display i on screen-displa a time. Th use ma retur t CP/ a an time an wit a indexe HEL Fil ma retur t th men a an time Th fil HELP.HL tell th use ho t writ hi ow HEL Files. Al HEL File hav nam o th for 'filename.HLP'. HOW TO USE IT: HELP is invoked by CP/M commands of the following forms -- HELP HELP d:filename Th for withou fil nam simpl give basi built-i intro ductio t th HEL progra i th fil HELP.HL i no o thi disk I HELP.HLР i o thi disk i i rea an displayed Th secon for dis play th content o th indicate HEL nam 'filename.HLP' Th dis driv paramete 'd: i optional. SPECIA NOTE Th HEL comman an som o th associate *.HL file supplie wit thi submissio ar bein distribute wit product markete b Supersof Associate o Champaign IL a th autho o th enclose program an *.HL files a placin the i th publi domain thes program an *.HLР file ar simpl bein include i markete package an no bein sol o an b themselves. Program HELP (Details on another disk) Program PHELP Library SYSLIB Program ABORTSUB SOURCE LANGUAGE M80 Assembler HARDWARE REQUIRED Hard Copy MEMORY REQUIRED Varies with HELP File (56K Max) ............... DESCRIPTION OF WHAT IT DOES: PHELР i companio t th HEL progra (als submitte t SIG/M) PHEL print th content o HEL fil o th CP/ LST device Th outpu i paged eac pag containin on scree displa a i woul be generated by the HELP program. HOW TO USE IT: PHELP is invoked by the following CP/M command line -- PHELP d:filename
PHELР wil prin th indicate HEL Fil name 'filename.HLP' Th dis specificatio 'd: an th I thi wer th 5t entr i director secto zer i woul fil numbe 5. Movin alon i th exampl eac dat fil begin wit forma i whic th dat ar embedded. The format is as follows: Byte Description (For Sequential files) ----------------------------------------------------------- 00 Track number +80h. This high order bit must be set for every track number. The physical track is identified in every sector on that track in this manner. 01 Physical sector number of each sector. Every sector is identified this way. Sectors are numbered 0-31. 02 File number. If =0 then this sector is NOT in use at this time. (When a file is deleted you have to wait for each sector in the chain to be rewritten so that the file number can be set to zero). 03 Number of data bytes written in this sector 04 Checksum of all data in the sector except bytes 0,1,4 and 136. Byte 135 is also not used in the checksum calculation. The checksum is the sum of all of the data without regard to overlow as done in an eight bit register. 05 Track number of the NEXT data sector in the chain. 06 Sector number of the next data sector in the chain. If track and sector number are both zero there is no more file (EOF). 07-134 128 words of data. If the first byte is ffh then the file is binary. If the first byte is other than ffh then the file is ASCII. The first byte is the first byte of the first sector of the file - not the first byte of any sector. 135 Check byte - always ffH. This is used to ensure that everything else in the sector was in the right place. -------------------------------------------------------------- Eac o th byte i thes sector ar linke t th othe sector i "forward directio unti byte 5+ ar zero Thi signal tha th curren dat bloc i th las bloc i th file Th director sector ar locate i trac 70 Eac director secto begin i th 8t byt o th physica secto (th firs byte ar garbage). USE OF THE PROGRAM: __________________ Th progra accept tw type o input Th firs typ o inpu i dis numbe prefixe b a equal sign Thi wil resul i recover o th MIT director o tha dis an th listin o tha directory A a example: =5 wil resul i selectio o dis an th recover o th directorie o tha dis whic wil b listed. Th secon typ o inpu i CP/ fil nam followe b fil type a equa sig an MIT fil nam an dis number Thi wil searc th director o th specifie MIT disk locat th fil an writ i o th CP/ dis specified A examples: (1) CPMFILE.MIT=ZCTABLE,0 (2) DIET.BAS=DIET,0 (3) OCTOCT.ASM=&OCTOCT,2 I exampl (1 th fil 'ZCTABLE locate o MIT dis zer i copie ont th CP/ dis a fil CPMFILE.MIT I th nex example (2) fil DIEԠ o dis zer i copie t CP/͠ fil DIET.BAS I th las example MIT fil &OCTOC o MITӠ dis tw i copie t CP/ fil OCTOCT.ASM Thu th MIT file ar alway o th righ sid o th equal sig an th CP/͠ file ar o th lef han side Not tha a ambiguou fil nam i no permitte becaus th CP/ file ar ope fo writing. Becaus th file ar accepte i lis form th progra ma b use a submi job Problem wit thi progra ma b submitte i writin t th author Th progra i copyrigh 198 b th author Us i permitte i non-commercia environment Commercia us license ma b obtaine fro th autho a reasonabl cost Conversion ca b performe betwee othe har secto format an cp/ format Contac u fo details. CP/ I TRADEMAR O DIGITA RESEARCH PACIFI GROV CA MITS ALTAIR PCà MA٠ B REGISTERE TRADEMARKӠ OƠ PERTEà COMPUTE CORP. CHATSWORT CA.