comm * d a t aP *T " i cnmpuiEfl house, inc.

COMPUTERSOFTWARE

COMMAND INDEX• - j«< Q>_ ;!i30 ont I ' n a y r ' ju s ;, ; . ' : . i t ill T XA<1t .i.-'tgo '-'S c l 242 - ^ b n & u -•* nr j.t,! : sv»z OJ

COMMAND NAME ? :il, \ ' ENTERED AS ‘ EXPLAINED PAGE----- —r----rsMA'tdw-' ji, ..v-r>j ': ■ ■ an.T 1 ;•.ft* T3ATf,

. ...-I ■ 11 ba sic t o o l s -

W p f N D 3P°.? v-'P'V APP 4 LO/VO PROGRAM ' , ;vri5T - - f . =.■

STOP A P P E N D .......... STAP: • ' „i a or

AUTO . . . ............. AUTO Si (3)

CHANGE’ . . . . W . . CHANGE/lstr/rsfr/.nl-n^Dr"

(3) -t: • *-»fR

CHANG* . . . . ......... CHANG*"lstr/rstr\nl-n2 (3)

DE L E T E ............. .. . DELETE nl-n2 (3)

FIND . . . . ...........•0 •.> :'3‘ FIND/lstr/,nl-n2’.T: ~ (3)

FUNCTION KEYS ON . . . .j,, ioa 576t *-

FKEYON {5} n i \ . r ^FUNCTION KEYS OFF . . . FKEYOFF - (57 ;;

. * SET FUNCTION KEY STRING .«r-: • ,^nf .;uo"rvi5*>? : *r ~

FKEYx'strg* ’ : 'ir- - .. ’<3 3r . &c ; -mt '2 '

' (5) _ ; ; '2i

* 'PAUSE; . i •. inofifbbf.Zr C.^OqS j-”m 3>?:i Ifc.'tS fl

PAtfSF1;; fm-tvr, rn-5 ons.Tnoj .-A *iil gnrvr

{'-'•( 4 )-6 . <3-j v j L'3cr;i

9“» PAUSE OFF-:. ‘I’'. PAiftoFF''f _ 'w : * 0;

RENUMBER........... V RENUM nl, si ’(4)

t r a c e on \ 2:1 .'.1 •• -f V!

m e e • ;--gnfief <3 rr» ans :

TRACE OFF . . '.■ T2-' ■ LG. i. O'Oi- -.£ !.

TRAeOFF (4)

•n " DEC TO HEX CONVERSION. . #decrttpb?r & $hexnumber !i^ (6 )

D.A.S (Disk Access System)-"'1130 “IQ nf&ii " r . ; C!f‘ l6' „ „

•: f l l i ,

nl ^ QTTne ;numbef start rarfge * *,n 2 i n e ounifili^ erfd o f ° r a n g e r l . . - V 1s^r6= m > i r i ^ f o locate rstr = string to replace ,sl = incremental step size■ lC?» 1} I ?"» ?Qr Z :1 r 0:f ,-tBJ2$i33?.

snob . (ftMtterr ®By tTavftf Gaihache1 - " 3•o5 ! I -3. ,:0 '

Copyright 1983 by Comm*Dafa Computer.House Inc. 320 Summit Ave. Milford MI 48042

(313) 685-0113

Page 1

BASIC, TOOLSBASIC TOOLS is a package of very useful and debugging tools developed

to save time in writing, editing and modifying BASIC programs. This program houlcli be goaded right 'after;-you turn on the compter - BEFORE YOU START PROGRAMMING IN BASIC or LDAEf ANY BASIC PROGRAMS! Use-of RUN/STOP-RE-STORE should jjotqaf^t BASJC TOOLS, but in some. ins.t^nces TOOLS will te rendered inoperative^

To load BASIC TOOLS - Disk version: LOAD"*",6,1 (return)

When the screen clears and READY with a blinking curser is displayed, you may start programming and using TOOLS.

the end of .the main program residing in memory. This command allows you to build subroutine libraries, then add the appropriate subroutines to

Usage: APP (return) - The comp|utec<will respon^ with LOAD FjfcLE - JO BEAPPENDED. At this time ldad one "program file (subroutine) from disk or tape,>by the normal LOAD command. Additional subrouting jHay be added by giving the APP command "”aga in ‘after the first append is complete and repeating the pr.qc#S£. when a 1 1 ttie subroutines are added into the main program, use the STAP command to terminate the appending process and return BASIC.

Note: APPend does NOT merge pi^apr^ms - it merely adds new programmaterial to the end of existing^program material. The lowest line number of a program file to ^6 ga.pf^nded MUST BE HIGHER than the highest line number of the main“program residing in your computer's memory. Use the RENUMber .MpQftWl.fjjf neccessary to allowTthis to be true before attempting to ao an'append.

APPend command is used.

Usage: Enter STAP (return); wbfiQ $9 4 -»r^gCpinplet|ly done APPending programfiles, you may then resume normal' prog ramming in BASIC.

Example: STAP, (return) ■ a fjgj j:,yJ-;YnP:

Tape version: LOAD (return) f

BASIC TOOLS COMMANDS:

APPEND: Used to attach program files together. Append adds subroutines to

programs yp>u are creating. •)/ . vh .

Example: LOAD"MAIN.PROG" (load malrt proAPP (return)LOAD FILE TO BE APPENDED (computer,J,s response)LOAD "SUBR0UTINE2*.;tI,oad the s^i^utine:which is to be

oj * "-213sr ■ ■'•s.tr * . TOf * 'g

STAP: This command is neccessary to assure proper return to BASIC after the

* ri’S ,3v--£ IIG-c8d ic,i

Page 3

AUTO: This command will automatically place the SASIC line numbers on the screen for you when programming. It is very useful when first entering (keying in) a program into the computer's memory.

Usage: Enter AUTO si (return) with si being the number of lines toincrement after each BASIC instruction is entered. YOU must enter thefirst Tine number and yotjr line of BASIC program - BASIC TOOLS puts inthe rest automatically. To disable AUTO numbering, enter AUTO (return) with no line increment number, i

*Example: AUTO 10 (return) - (iine number?® will automatically

appear inHncrements of 1 0 as you enter eacifBASIC line of instruction

~ a n d press^ceturn).tp' p * c?-

CHANGE: This command allows you to search througff your BASIC text for anyString of text and replace it with.^a new sfring of text. This is especially useful jfn globally changing ?electAparts of. string variables within your progra®. -4 Sr

'#> <»•Usage: Enter CHANGE /lstr/rstr/,nl-n2 (ortCHA.NGE "lstf/rstr",,i?l-n2) where

lstr is the “string to locate, r-str is fhe-replacejijent string, nl is the line.number of your program to start searching and replacing at, and n23issthe i€ine numfc'er to stop the $HMK»j£ operation at. the placement of'the / (back slashes) , (p.8fcBJ§%j and (quote marks) is criticTI or an error message wjpj pccdg |fCHAN§€ ||?1 only Change the first .pcQfranice a s|.ring within 9ny lijp » y$e*§HAN@* 'In its plftce if you-wish to^change multiple occurrences within any single lifle.

gr 5 w ® &Example: -150 PSltT "TfST FOR CARS" (orig 'line of'flASIC)

; ” CtiANljE"ISARS/ggAT;SIPP-2Q0 (return) w l50 R R W T “TfST (after chang,®»operation)~i -J- ••*> J® . JS 'S> t SR, % US«» fi _3 . •- jsv rt? i<- ' ■£

DELETE: This .command .allows tBe delgtion (ej^s^ng) of any continuous segment,large pr snail,"of-^fsyr BA§?C prigiam, *Jt3sliminates the need to sit and type in a,,ser-iesse§ M n e nsnbers ritf’erasfc them from your program.

r p x • % ' S - * **• c -Usage: Enter DECETJ l»n2^ith 'nl Oeing"\he lowest line (number) and n2

being tjhe^Mghesrpr ending 1 4 % to be deleted. The range (nl^n2)must be entered'or the-command will not operate properly.

,g» .»» s '•'? ' o c5f "*? ' ■ExampIS; DELETE 100-390 (retyrfi) (this^wlll delete lines 100

,t 7 .5“T" ~ 5 through lop inclusive)

v <& a •«» *•» st is •& ©FIND: Very useful for'iofatin|Jstri^|^of tgxt.t Spiriables, or program

statement? withifl your BASj|; prpgf^. Easier than scrolling, FIND will display only the Tines in which the searched for item occurs.

?, s*. jt «£. c *> /$■

Page 4

Usage: Enter FIND/1str/,nl-n2 (or FIND"lstr",nl*n2) where l$tr is thestring to locate, nl is the line number of your program to start the search at, and n2 is the line number to end the FIND operation at. The placement of the / (back slashes) , (commas) and " (quote marks) is critical or an error message will occur. You may completely omtt the ,nl-n2 (comma and line numbers) if you wish to search the entire program.

Example: FIND"TEST",20-500 (return)110 'T'Ht'S IS A TEST"438 INPUT "TEST";A$ (this example located all

occurrences of the word TEST)

PAUSE: Used to freeze action on the computer. This command will freeze aprogram listing or actual program execution.

PAUSOFF: Disables the pause control.

USAGE: Enter PAUSE (return) to enable - the COMMODORE key is then usedf^p pause control, depressing the key once will stop the computer until the key is depressed a second time. Entering PAUSOFF (return) disables pause control.

Example: PAUSE (return)PAUSE ENABLED (computer's message - you may now use

the COMMODORE key for pause control)PAUSOFF (return)PAIJSE DISABLED (computers message)

RENUM: A powerful tool that allows the programmer to resequence line numbers.A njust to rearrange BASIC programs. Combined with the APPEND command, theability to modularize subroutines and move them in and out of programs is available. Also, it enables the programmer to place a line between twoconsecutive lines when no space is available, (for example, between 10 and11). RENUM will renumber the program and will take care of statementssuch as GOTO and G0SUB by putting in the new line number(s) of thesubroutine or goto.

USAGE: Enter RENUM pi,si (return) where pi is the new starting linenumber for the program and si is the incremental step size.

Example: RENUM 500,10 (return) (will renumber your programto begin at line 500 and be insteps of 10 ex= 500-510-520-etq)

TRACE: A debugging utility that is useful for tracing exactly which lines arebeing executed, and the order of execution, during actual program operation.

TRAC0FF: Disables the TRACE command.

USAGE: Enter TRACE (return) and then RUN your program. During execution,TRACE w til output to the top tine of the screen,, the current line number -being executed by'SASIC'1''ih. reverie videxu jftp distinguish it

fl rw froto the n%rmaTspirogram’ o tout)5.02 Since; tfi!e prbgrahr can'ixecute the•arij T- BASIC 'pHjgi-am faSttsr than^ou tan ri> d ,: usfe the C0>JT| L. % (CTRL)

interm ittently1 sW#*tifre W'ograMil 1 PAi&E may aisq.‘‘be liiifid in conjunction with TRACE to b itte r' follow program exeo/tibW.

Example:" TRACE (return) (enable,? Trace) jRUN (return) (starts the program running - line

numbers’’4^j 1 be displayed at the ‘ j tip'"’ of- tfie' screen as executed)

STOP (return) (stops program-expewfeionj TRACOFF (return) (disables^Trace)

Page 5

FUNCTION KEYS: When BASIC TOOLS is loaded in,Jjp,your computer, the. fourFunction keys may be activated to give you additional single keystroke commands. The uppercase (F2, F4, F6 , and F8 ) Function keys are user definable for strings of text,or program. H , ,0

USAGE: Enter FKEYON (return) to dctiy'ate!’tfie‘J?unction keys H- you will nowhave the following single keystroke commands at your disposal. BASIC TOOLS sets the function keys on at start&p. Function keys can be enabled and disabled when necessary by the user. Enter FKEYOFF (return) to disable the Function keys. ( X: •

FI - (will automatically list your,|r^graj*)J!

F3 - (will automaticalfy‘run your prbgram)“

F5 - (changes, the border and character color)ijOOt JlfAo win Jf:

F7 - (changes the screen back^fbund color)

By Entering FKEYx"strg“ f^eturnj function keys F2, El,'.F6 , and F8 (x can be 2, 4, 6 , or 8) canHbe preprogrammed with up to 40 .characters (strg) per key. Up to 80 characters can be preprogrammed if only F2and F6 ace used. This could eliminate repetitious typing in acommonly used statemeWti J£ek locations, poke locations, etc. TheseFunction keys carf‘afso;§e {used within your BASIC program to display amessage on the scte^n.wlrei^depressed. q,

If the British pound stgn/'^j1 fs used at the, end of the string - F K EY x^ sf rg E"J€ ^ Jre\urrnWil'l be suppress,edrand the computer will allovf yo.u to aiirf^^he js»»i’:pf ‘tp,'S^tn.a'(and press return yourself).

Enteririgj^KEYx1' \ s i J ? 4 { S i n g l ! ^ ^ q u o ' t e s in the text string will be interpreted'by tAStC TOOLS a£ double quotes on output. ExampleFKEYxKL0AD ' $ 1 ,8 ” yil I output as''LOAD "$",8 . - ,

•( .vr-'1 -9 j i: n ' i ' riT'U.13-;.. Hbf • :C{C3) (nit "> aff o--9t t :: v :

s ..! eidszrb) {- n)s>i. .■

A, program has been included.on your.BASIC TOOLS diskette or tape to ' make the uploading of ,the keys faster and easier. Load the

„f<, /.•• KE£*tQAD" 'program, them \ist and replace designated buffers with'p.. . ypur 'user defined string. , st,! the prograjp again Ahen RUN it. If the

fubcXJpn key configuration Is to b e usedragain later, the new program 1 fyjp Should be saved onto a, s6parate diskettepriape. ,

Examples: FKEYON (return.) ^enables the Functi«n-.-keys)r , o-ri - PKEY4"F0RA= ito20QjNEXjTAg (return)

. ,4 , , (every time Function key 4 is pressed, 3V6 Mci- ^ F0RA=n020D:NEXTA will be printed)

FK.EY6 "PRINT‘H E L L O (return) ,T;,....(every time Function key 6 is pressed

PRINT"HELL0" will be printed and entered)

HEXIDECIMAL/DECIMAL CONVERSES: BASIC TOOLS has a built in Hexidecimal to Decimal and Decimal to Hexidecimal converter.

Usage: Enter $hhhh where hhhh is a Hexidecimal number (from 0000 to FFFF)or enter #nnnn where*nnnn is a Decimal number (from 0 to 65535) - the

' J computer will respond with your conversion. When converting from Hexto Dec,all four digits must be used otherwise a syntax error will result,: ■-,

Example: #32768 (return)$8000 (computer response) -f<$6000 (return)#24576 (computer .response) ,,.s

■ * S ->c-D.A.S.: Disk Access System, built into BASIC TOOLS disk version, which allows

limited keystroke disk commands.

USAGE: Use as a prefix the greater than symbol (>) for direct commands,the backslash (/) for a LOAD command, and the up arrow for a LOADand RUN command. - . - \

f »s£- >rr»TExamples: /GAME (return) (load the program named “GAME")

^ or £ (return) (interrogate error channel)>10 (return) (initialize,^drive^Q)>S0:TEMP (return) (scratch file named “temp")>i (return), (read directory)>T0:BASIC* (return) (read directory and,search

For filenames beginning with word BASIC)GAME (return) (load and run the' prog. “GAME")%GAME (return) (without relocat,ing-lqad"GAME",8 ,l)TEST (return) (save the program oaip&d: “TEST")

>N0:<fiskname,id (return) (format a disk)>RO:newnime=planame (return) (rename a file)>V0 (return) (validate drive 0 )>C0:newfile=oldfile (return) (copy oldfile to newfile)>Q (returnf (disable D.A.S.)

Page 6

S S \ cnmm * datagm i,f campuTER house, inc.320 Summit Ave., Milford, Ml 48042

ADDITIONAL OPTIONS/FEATURES J

& <..* -■••• ■ •*r' !fc "■ •£■.. , 1 A y * l..* :•« .*• £ 5-«**• *J- >.? |*j»

To 'enable. : the d i sk access commainds on th6 tape v e r s i o n , ' o r t rf e - e n a.bl e them on; the chi s k v^ers i din, types LO AD" $ " , 8 r- ( return ) '.then $7562449. £ f r 1 * •' ;T " c

<*%

T o ’activate the tape verision type RUN then press;(§hy key w h e n the 'Togo scr|^n, appjearrs; ; , '* J ' 4 ';’ -,

An *a.d d i t i on a 1 :*c omrtamj ha!* been added.-s ..■$-*? r«v .A y> yy t "‘5" ... JS* • f" f.; £ _ - Ip 5 ^ !£. l ': . f ■’? , ■ ' • ' ,v*v H I L I T E : j JCaus§s£ a 1£^remack;' statements to be

Switched- to rese rve v i d e o ” : When saved and ^%iSeloa^eii^;!thfi0r^mar|:^ w i l l . s t i l l be in ?|3^ reve^se^v^ideo even wfth the Baltic Too l l -■; program not p res e n t u n t i l p't h ey -are e d i ted*

comm * DATACZrFuTcP rOi.5E inc.

tAJ =ese-*-c

s . : »*ac-^nes- inc.

S i d e 1 o r