@L}5 _$% l0$)$$Hȱ$ UhL" `e$$%`$%`  R@W!( L(1   Y I`  d  Ld M * @  $ % CC$$)%1 Udߥ$9%: !0 S$% DD˙`  }J)Lr d M * @  $ % CC$$)%1 Udߥ$9%: !0 S$%} DD˙`  }J)Lr J  ((  p L ()   J}L= ( L 0q A    IB JC;? D W } LL  ` W )LA!  ߰")-݆ p" } $G@LL 08`Q")<2Q0 -G$Ș݆ UL# ; p8(()(0ʥ)NQ` }$GȘ݆LU )L ݆ L GȘ ݆LL )W>Z   HH)H }p h  hyhy D L> L JJ    ! LA*` BF }7'8  M HN H` 8 Z  \LdJJ!"! GFE@F (!L }EE !E^ ^ E E7EȩEdE/EȩE  D } .L }  ;F d  ;?F7F? ( .   Z D LL d } . D  L    p  E` , d)  D L) 0BM݊L݉} ML  N݆ L NLML [ TEqEHȱEqEh 0Gȹ G} HLL GɛL  LFREE SECTORS G) *Gȩ GȽG GȌ*jj >G} C8jJ3j2CD( C202C ԠBX` N 1? l LlD:RAMDISK}.COMLu L1 L ;LHL  T`  `8  ɐ     `TU  } L ? .  t`GBJ ~DEHI B V0dV!}QDEHI VF9 ,0 ,0 s0hhL  L` H hDHEh"}DEL8HI4 0 HI,0 0  9 .G VLO#},0 L4*IJ`llD1:AUTORUN.SYSNEED MEM.SAV TO LOAD THIS FILE.D8:MEM.SAV J y08 B|DEHI$} V0 0`B;DEL`?<0LV`@ʆ v s? F0Ξ05: [ BDEHI%} VY8 B V  @  /DE `E:D8:DUP.SYSERROR-SAVING USER MEMORY ON DISKTYPE Y TO &}STILL RUN DOS B;DE J  (` 9 V⪍ ઍ  -'}LLu ÝDEHILV 9 .l 9 .l  `` s$B BH(}I|DE V BLV nB,DE JLV B V BLVDEIʩ BꭝLu } 3E:}DISK OPERATING SYSTEM II VERSION COPYRIGHT 1984 ATARI CORP.A. DISK DIRECTORY I. FORMAT DISKB. RUN CARTRIDG*}E J. DUPLICATE DISKC. COPY FILE K. BINARY SAVED. DELETE FILE(S) L. BINARY LOADE. RENAME FILE M. RUN AT ADDRES+}SF. LOCK FILE N. CREATE MEM.SAVG. UNLOCK FILE O. DUPLICATE FILEH. WRITE DOS FILES P. FORMAT SINGLEL !N',}#"&))9(&*)/h)''-&؆莟R'S  vL/ˢ L }Insert DOS 2.0s, type Y Λx -}DEfHI 1莏#q! @ y0ɛ8A0,' ȅ 1 1ild! 1L!NO SUCH ITEMSELECT.} ITEM OR FOR MENU! 0 .z:*{}.|{ 1 0 0JB 18L%|DL/}%DIRECTORY--SEARCH SPEC,LIST FILE?[# 0 0 &|D3" 1L!NOT A DISK FILEN !B 1L!E# 1 !BD0}ED:}:1BJ|DE 1DEBHI 1 h0ߢ 0.1}  0?詛 1 y0YЛ 1 ;#L" ;#L! BL1TYPE "Y" TO DELETE...DELETE FILE SPEC2}COPY--FROM, TO?OPTION NOT ALLOWED697 FREE SECTORS COPYING---D8:COPY32.COMl# 0|D .L/%#3}##JB|DE 1BHID#E 1#0: B 1L!#͑### B 1#c$0SY4}S1}:## # # .#Ƚ# # 𩛙## 1,#PD#ELJ- <.BJD#E 5}1 1HH 0hh|DL%1}:̳# L% #D#EL% 1 0 . .0O% 1L!WILD CARDS NOT A6}LLOWED IN DESTINATION 0 <.|K}N 2 FORMAT. t* 5) 1L!`) 0NΞ 0 L1) 1 L!BAD LOAD FILELOAD FROM WHAT FILE?) 0 ?}0#B 1L!WHAT FILE TO LOCK?) 0 0$B 1L!WHAT FILE TO UNLOCK?DUP DISK-SOURCE,DEST DRIVES?TYPE "Y" IF OK TO US@}E PROGRAM AREACAUTION: A "Y" INVALIDATES MEM.SAV.FE! +L1   `*  70 2 2A} 0.* 1 y0 0)INSERT BOTH DISKS, TYPE RETURN^, 1 y038逍 N, 1L! ,B}C, t*  Lx+, 0 ^, 1 y0 , ,0,0 ,L+ ,I0 ,Vǭ0C}Ξ, 0 }, 1 y0C,ШC, 0K'!" H H 'h h Lx+!EF 5L1L!D,I,HhD}` NOT ENOUGH ROOMINSERT SOURCE DISK,TYPE RETURNINSERT DESTINATION DISK,TYPE RETURNE}`  `8 rL1`-* 1P* 1 y0Y`hhL!NAME OF FILE TO MOVE?- 0 0|DL% <.F},^ 1 70 0 .@L# .BJ 1  DEHIB V L1 ,} 1 70,L.  G}JB|,#P#DE 1 HI BDEHHII 1 B 1 ,^ 1 70,0La- B V,#PH},^ 1 70 0L#L!-* 1P* 1 y0Yj383}mm ݭI}}`8}``|* ? ɛ,`|:-)| / 1L!`DESTINATION CANT BE DOJ}S.SYS0 0H{ 24Δ 28/L!/) 2 Π 2 0 ξK}hAΞB,0 J 1 BDEHI,HÝDE 1HIHIDELSAVE-GIVE L}FILE,START,END(,INIT,RUN)O S0 1`BDEPHI V` S0H 1 L!M}0 0 1L~0`PLEASE TYPE 1 LETTER,0`hhL! 70 1L0L<1 ,;ɛ7,"ɛ:ݦ1ݥN}A"D|ݤD|ȩ:|ȩ|ɛ,,(/+.ީ1 1,ɛ`轤{NAMEO} TOO LONG B VL!` L1I H1EΝDL1|mDiE` V0`8d/8 i:222 1 LP}!ERROR- 164ɛ+,' 20*.. өr2 1``2TOO MANY DIGITSINVALID HEXAQ}DECIMAL PARAMETER800 0 8 00`,0'D800 H,ɛh`2L1NEED D1 THRU D8uR} ECIMAL PARAMETER800 0 8 00`,0'D800 H,ɛh`2L1NEED D1 THRU D8u05  15 2 2151^116115ύ011$r2ԭ5 3)5)5ԭx GT}@@L00)+& 2 L0=ɛ -L!1LV1L1 /3 3ȹ441L-4 v3 25 2H 2h͔5U}L3L3 2 k3U hh`DOC`QL3P1Lk0S1H /3h0B k3@ VL0LU!#$53 1181118V}1111Ε5 1Lk0552 1Ȍ1i111i11115Lk0pppB4f5&&&&&&&&^6f^6&&&&&W}&&A1@BJ D2ELVK@BHILV^Щ6 2BD2EJ VBD5EHI0 V0%5X}5 2iХiL[2 25 25`D:*.*` i@`8 ``@i `8@`0 BLV525<4Y}5`HH i ԍΗ552 ԍhh@ Lح1Э1Ѣ 24.4 24Z}4`D4E` 2BJ k3LVRH` 2BD4EhK)I JLV333 BASIC language TUR > TURBO BASIC OBJ| f}COM > MACHINE language DOC > DOCumentation PIC|MIC|FNT|MVM > Graphics AMS|MUS|MBD > Music LST > BASIC g} LISTing -Some MACHINE language programs can only be run by loading the MENU without BASIC! ------- -For s h}ome programs, XL/XE models may require a "TRANSLATOR" program (available from BELLCOM) to be loaded first! -Most i}programs are relatively self-explanatory; however, some may have separate DOCumentation files. Some BASIC programs m j}ay contain instructions in their program listings. LIST to read. -To view DOCumentation files one page at a time, k} press [START], [Return], or the Joystick Trigger to display the highlighted DOC file. Pressing the [Esc] key cau l}ses a return to MENU. -To print out a hard-copy of any DOCumentation file, [Q]uit the MENU, boot DOS, and then from m} DOS, use the (C)Copy command: D:Filename.DOC,P: -To use this great MENU program on your own disks, simply n} copy the file "AUTORUN.SYS". D:Filename.DOC,P: -To use this great MENU program on your own disks, simply ! Chameleon Terminal Emulator Version 4.02 User's Guide 17 November 1984 (C)19p}84 John Howard Palevich1. Introduction1.1 Overview Chameleon converts your Ataricomputer into a powerful computerteq}rminal. It emulates six terminals:"Glass TTY" (that is, a video terminalwith the same features as a printingterminal), Ler}ar Siegler's ADM-3A,Digital Equipment Corporation's VT-52,a non-standard extension to the VT-52called the VT-52XL, the IBMs} 3031 ASCIIterminal, and a Test terminal, usefulfor debugging. For every terminaltype besides Test, Chameleon supportstat}b, backspace, line feed, form feed,and a visual bell signal. For theGlass TTY it supports word-wrapping.For the ADM-3A, tu}he VT-52, and theVT-52XL, it also supports cursoraddressing and basic editing features.For the VT-52XL, it supports characv}terand line insert and delete, as well asreverse video. A termcap entry isprovided for use with unix operatingsystems. w}Chameleon doesn't supportthe special graphics character set ofthe VT-52 or some rarely used ADM-3Afeatures. Chameleon'sx} major features are: 1. a 24-line, 40-, 80-, or 132-column character display (displaying 40 columns ay}t a time) with a cursor lock feature for automatic horizontal scrolling 2. a buffer that saves up to z} nine previous pages of text 3. continuous communications at baud rates of 75 to 1200 baud and non-continu{}ous (requires flow control) communication at rates of 1800 to 9600 baud 4. selectable parity 5. a B|}REAK signal 6. the full ASCII standard character set 7. selectable duplex 8. the ability to copy text }} from the screen and the previous page buffer to a file 9. the ability to transfer files between the At~}ari and most other computers, using either flow controlled, Modem, or Kermit protocols 10. using one of }the supported modems, the ability to automaticly dial any of sixteen stored phone numbers, and to kee}p dialing numbers until a carrier tone is detected 11. a ram-resident disk utiltiy program, allowing mos}t of the functions provided by the DOS 2 menu 1.2 Required Accessories - 48K RAM - a disk drive - a}t least one of the following: * Atari 850 Interface Module, and a standard RS-232C modem} * Atari 835 Modem * Atari 1030 Modem * Atari 1450 computer (which contains a m}odem) 1.3 Optional Accessories - With the Atari 850, a Hayes Smartmodem, or other Hayes compatable modem }- Printer 1.4 Contacting the Author Users wishing to contact the authorabout Chameleon way write to him at: John H. Pa}levich175 Calvert Drive #F211Cupertino, CA 950142. Getting Started2.1 Attaching an RS-232C Device to the Interfa}ce Module If you are using an Atari 850,rather than one of the standard Atarimodems, you will have to attach yourRS-232C} device to the Atari 850.Chameleon talks to Port 1 of the Atari850. (This is the default behavior-- you can use the R: Dev}ice menu lineto make Chameleon talk to any one ofthe four ports.) Only "TransmitData", "Receive Data", and "Ground"need }to be connected. "Data TerminalReady" and "Request to Send" are sethigh (+12V = true) when Chameleonstarts. This is done} as a convenienceto devices requiring these signals.Chameleon ignores all other signals.2.2 Loading Chameleon into Comput}er Memory To load Chameleon into computermemory: 1. Remove all cartridges from your Atari computer. 2.} Make sure all equipment is turned off. 3. Turn on all your peripherals. 4. When the BUSY light goes } out on yur disk drive, open the disk drive door and insert the Chameleon diskette with the label in } the lower right hand corner nearest to you. 5. Turn on your computer and TV screen and wait until Cham}eleon's device menu appears. 2.3 Chameleon's Device Menu Chameleon can talk to a number ofAtari devices, but it h}as to knowwhich one it should use. The firstthing Chameleon will do is ask youwhich device to use. Below is an illustr}ation of thedevice menu, which is the first screenyou will see the first time you run anun-modified copy of Chameleon 4.0.} Ifyour copy of Chameleon has beencustomized (by using command Z fromthe utilities menu), Chameleon willtry to use the d}evice you specified inthe Z command. If you have never usedthe Z command, or if that devicedoen't exist, you'll get this }screen: Chameleon Terminal Emulator version 4.0 (c) 1984 John Howard Palevich---------------------}---------------- 0 - no device (demonstration mode) 1 - Atari 850 with any modem 2 - Atari 850 with Hayes Smartmodem } (or compatible modem) 3 - Atari 835 modem 4 - Atari 1030 modem 5 - Atari 1450 internal modem----------}--------------------------- Which device to use (0-5)? _------------------------------------- Figure 2-1: Devi}ce Menu Screen You should type in the number of thedevice you want to use (or 0 if youdon't have any device, but still w}antto investigate Chameleon). Then pressthe RETURN key. Chameleon will try tofind the specified device. If it can,you }will shortly see the main menuscreen. Otherwise, you will be toldthat Chameleon failed to find thedevice, and you will be} asked foranother device. If this happens, makesure that your communications deviceis plugged in to the wall, connectedt}o your Atari, and turned on!3. The Main Menu3.1 The Main Menu Keys After Chameleon finds acommunications device, it }presents youwith its main menu. This is the menuwhich lets you control Chameleon'sactions. It looks like this:Chameleo}n (c)1984 John H. Palevich------------------------------------- ->Terminal Glass TTY Back S is CTRL-H Left Margin 2} Line Length 80 Cursor Free Scroll Smoothly File Transfer Protocol None File Name File Type Text Di}aling Method Pulse Modem Mode Originate R: Device 1 Baud Rate 300 Parity None Duplex Full Flow Control ^S/^}Q-------------------------------------OPTION -move cursor to next parameterSELECT -change parameter's valueSTART -begin }terminal emulation D - dial a number U -utility menu P - pick up phone H -hang up phone S - save options R -restore optio}ns CTRL-Q - quit Chameleon Figure 3-1: Main Menu Screen3.1.1 Selecting an item -- OPTION key Each time yo}u press the OPTION key,the arrow moves down one line so thatyou can select the next item in themenu. You return to the fi}rst menuitem after reaching the last one. Youcan also reverse the order by holdingdown the SHIFT key while pressing theO}PTION key, which causes the arrow tomove to the previous menu item. Whiththis method, you return to the lastmenu item aft}er reaching the firstone.3.1.2 Selecting a value for an item -- SELECT key Each time you press the SELECT key,a} new value displays for the currentmenu item. Again, to reverse theorder, hold down the SHIFT key whilepressing the SELEC}T key, which causesthe previous value to display.3.1.3 Entering a file name The "File Name" line of the menudisplays }the file currently selectedfor file transfer operations. Whenyou press the SELECT or SHIFT-SELECTkeys, a blinking cursor }replaces theold file name. Type in your new filename, using the BACK S key to correctany errors. Press RETURN to remove}the cursor. If you always keep the "FileTransfer Protocol" set to "None", thenyou can safely ignore the "File Name"line}.3.1.4 Moving to terminal mode -- START key Press the START key to move from themain menu to the terminal mode. } Seethe chapter on terminal mode fordetails.3.1.5 Dial a number -- D If you have an Atari 835, 1030,1450, or hayes S}martmodem compatablemodem, Chameleon can dial the othercomputer's number for you. Type Dfrom the main menu to go to the d}ialmenu. See the chapter on the dialmenu for more information.3.1.6 Utility menu -- U Chameleon will let you perform} manyof the functions of the DOS-II DUPprogram from within Chameleon. Type Ufrom the main menu to go to theutility menu.} See the chapter on theutility menu for more information.3.1.7 Pick up the phone -- P If you have an Atari 835, 1030,}1450, or Hayes Smartmodem compatablemodem, and you have manually dialedanother computer, typing P in the mainmenu will ma}ke Chameleon pick up thephone line and attempt to establishcommunications with the othercomputer. If, after thirty second}s,Chameleon hasn't establishedcommunication, it will hang up thephone and return to the main menu.Type Q to quit waiting }for the othercomputer before the thirty seconds areup. If Chameleon does establishcommunication, it will enter terminalm}ode.3.1.8 Hang up the phone -- H If you have an Atari 835, 1030,1450, or Hayes Smartmodem compatablemodem, and you wi}sh to terminate aphone connection with anothercomputer, type H in the main menu.Chameleon will hang up the phone andretur}n to the main menu. HayesSmartmodem compatable modems take upto ten seconds to do this. If you getimpatient, you may typ}e Q to return tothe main menu.3.1.9 Save the main menu settings -- S Chameleon can save the current menuitem settings} in a disk file calledLIZARD40.OPT. Current menu settingsmay be saved any time you are in themain menu. Just insert a DO}S-IIformatted writable disk in drive 1 andpress the S key. Every menu itemexcept the File Name will be savedinto the fil}e D:LIZARD32.OPT.3.1.10 Restore the main menu settings -- R Saved menu settings may be restoredany time you are} in the menu. Justinsert a DOS-II formatted diskcontaining the LIZARD40.OPT file intodrive 1 and press the R key.Chamele}on will try to read the savedoptions out of D:LIZARD40.OPT. If thefile does not exist, or cannot beread, then Chameleon u}ses its standarddefaults. If the file is readcorrectly, then menu items (except forthe file name) are set to the storedv}alues. Chameleon tries to read in thestored defaults when it is booted.This makes it easy to customizeChameleon to your} application.3.1.11 Quit Chameleon -- CTRL-Q Typeing CTRL-Q from the main menuwill exit Chameleon and return you toDO}S. If you are using an 850 and DOS2.0, you must power-cycle your Ataribefore running Chameleon again.(Because DUP.SYS wri}tes over the R:drivers.)3.2 Menu Items3.2.1 Terminal Use the first item to select thekind of terminal you want to e}mulate.Your choices are:Glass TTY This value simulates a typical printing terminal w}ith tabs every eight columns, line feed, form feed, backspace, carriage } return, and a visual bell signal. In addition, words typed at the} end of the line are wrapped ont the next line, making it easier to read text} formatted for very long lines. Glass TTY is sophisticated e}nough to be used with many computer instalations. However, it isn't } sufficient for time- sharing computers capable of sending special char}acters for cursor control, character editing, and so on. Select one of } the video terminal values to communicate with such computers.VT-52 Thi}s value simulates the DEC VT-52 terminal, except for the keypad and the } special graphics character set. Chameleon doesn't support the Enab}le Graphics and Disable Graphics commands. Normal mode lowercase } characters print in place of graphics. While the alternate keypad mode is}n't supported, you may type sequences from the following table to } emulate the keypad: Key Normal Appl. 0 0 ESC ?p 1 } 1 ESC ?q 2 2 ESC ?r 3 3 ESC ?s 4 } 4 ESC ?t 5 5 ESC ?u 6 6 ESC ?v 7 7 } ESC ?w 8 8 ESC ?x 9 9 ESC ?y - minus ESC} ?m , comma ESC ?l . period ESC ?n ENTER RETURN ESC ?M} up ESC A ESC A down ESC B ESC B right ESC C ESC C } left ESC D ESC D blue ESC P ESC P red ESC Q ESC Q gre}y ESC R ESC R Table 3-1: VT-52 Alt. Keypad ModeVT-52XL This terminal is just like a VT-52, }except that four additional escape sequences have been defined to aid } editing. See the chapter on character and contol codes for more det}ails.ADM-3A This value simulates a Lear Siegler ADM-3A terminal. It supports } Option A (24 lines) and Option No. 1 (lowercase characters). How}ever, it won't beep when the cursor crosses the 72nd character } position.IBM 3031 This value simulates an IBM 3031 ASCII teminal. Basicly, } it's a Glass TTY with half duplex, and the Kermit protocol checks t}his value to determine if you are talking to an IBM mainframe.Test } Characters sent to the screen while Chameleon is in Test mode are printed }as is. None of the control characters (even CR) are treated specially. } When the cursor reaches the right margin, it moves down to the nex}t line. When the cursor reaches the bottom of the screen, it scrolls } the whole screen upward one line. thus, the last several thousand cha}racters sent to Chameleon will be visible on the screen. This mode is } useful for debugging new time-sharing systems because it lets you fi}nd all padding characters (like nulls and rub outs) or other control } characters the other system might be sending you.3.2.2 Back S is This item cont}rols which characteris sent to the other computer when youtype the BACK S key. The choices are:CTRL-H This choi}ce sends an ASCII BS (8) when you type the BACK S key. To get RUB you type } SHIFT-BACK S. RUB OUT This choice sends an ASCII RUB (127) when you t}ype the BACK S key. To get BS you type CTRL-H.3.2.3 Left Margin many TV sets overscan.} making theleft two character positions of thescreen un-readable. This item letsyou select your left margin. Yourchoice}s are:0 This choice lets you see a full forty characters across.1 } This choice gives you a one character margin.2 This choice gives you } a two character margin (like BASIC).3.2.4 Line LengthThe line length of Chameleon can be } adjusted to suit your preferences. The choices are 40, 80, an}d 132 characters long.3.2.5 Cursor This item controls the behavior ofthe cursor. There are two ways t}hecursor can behave:Free The cursor is free to travel off the screen.On Screen The curs}or is forced to remain on the screen at all times. On Screen is useful } for editing text when the line length is set to 80 or 132.3.2.6 Scroll When C}hameleon does a line feed atthe bottom of the screen, it has tomove the text up one line, to makeroom for the new line. I}t can movethe text up in two different ways:Smoothly which takes about an eighth of a second, } but looks pretty.Coarsly which takes almost no time at all, but looks ug}ly.3.2.7 File Transfer Protocol This item controls which type offile transfer Chameleon will do. Seethe chapter on t}ransfering files formore information. The choices are:None No file transfer is selectedSnaps}hot Transfer characters from the screen to an Atari deviceSend Transfer c}haracters from an Atari device to another computerReceive transfer characters } from the other computer to an Atari deviceModem Send Transfer files from an} Atari device to another computer using the MODEM2 protocolModem Receive }Transfer files from another computer to an Atari device using the MODEM2 prot}ocolKermit Send Transfer files from an Atari device to another computer using } the Kermit protocolKermit Receive Transfer files from another computer to an Atari }device using the Kermit protocol3.2.8 File Name The file transfer modes need a filename. If you have }"File TransferProtocol" set to "None", you needn'tconsider this line. Pressing theSELECT or SHIFT-SELECT keys for thisit}em causes a blinking cursor toappear. Type in the name of the fileyou want to use. use the BACK S keyto correct typing m }istakes. TypeRETURN to finish entering the filename. See the chapter on transferingfiles for more information.3.2.9  }File Type Use this type to tell Chameleon whatkind of file you play to transfer.Chameleon needs this information todecid }e waht to do with end-of-line andtab characters. The choices are:Text This choice tries to map } ASCII CR/LF to ATASCII EOL, and ASCII TAB to ATASCII TAB. During sending, EO }L is converted to CR. During receiving, CR is converted to EOL } and LF is ignored. Use this mode when transfering text files between your c}omputer and another brand of computer.Binary In this choice, all c}haracters are sent and received as is. Use this mode when transfering text fi}les between your computer and another Atari computer, or when } transfering non-text files between your computer and any other computer.}3.2.10 Dialing Method If you have an Atari 1030, or HayesSmartmodem compatable modem, you canchoose which dialing method }to usewhen auto-dialing. The other modemsthat Chameleon supports can only pulsedial.Pulse use pulse dialing } (which is universal)Tone use pone dialing (which is faster)3.2.11 Modem Mode} If your have an Atari 835, 1030,1450, or Hayes Smartmodem compatablemodem, you can choose to set yourmodem's communicati}on mode. In anymodem based communication, one of themodems must be set in originate mode,and the other in answer mode.O}riginate This mode is used to communicate with most time-sharing systems, } bulliten boards, etc..Answer This mode is used to communicate with another comp}uter which has it's modem in orginate mode.3.2.12 R: Device If you are not using an Ata}ri 850Interface Module, you may ignore thisitem. If you are using an 850, thisitem selects which of the four RS-232Cport}s Chameleon will use forcommunication. Most people use onlyport number one, but the choices are1, 2, 3, or 4.3.2.13 B}aud Rate Use this item to select the baud(data transmission) rate. The valuesare in bits per second. Consult themanual} or authorities for the systemyou're using for appropriate baudrates. Continuous transmissionchoices are: 75, 110, 134.5}, 150,300, 600, or 1200 baud. Non-continuous transmission (i.e. you'llneed flow control, or you'll losecharacters) is av }ailable at 1800,2400, 4800, and 9600 baud.3.2.14 Parity Use this item to select the kind ofparity check sent from Cha!}meleon tothe other computer, and the kind ofparity Chameleon expects from theother system. Consult the manual orauthorit"}ies for the system you'reusing.None There is no parity bit; all eight bits of t#}he character are considered to be data.Odd Characters are sent with odd parity.$} Received parity is ignored.Even Characters are sent with even p%}arity. Received parity is ignored.Off Characters are sent with &}the parity bit set to zero. Received parity is ignored.3.2.15 Duplex Use this item to c'}ontrol where thecharacters you type are sent.Full Keyboard characters go to the other system.(}Half keyboard characters go to both the other system and the screen. )} Use this mode to talk to systems requiring half duplex.3.2.16 Flow Control This item*} selects the way in whichChameleon controls the flow of databetween itself and the other computer.The choices are:None +} which means that the other computr has no means of flow control. Wh,}en None is selected, the File Transfer Protocol modes send and receive, and b-}aud rates in excess of 1200 baud, will probably lose characte.}rs.^S/^Q Which means that the other computer will stop sending when it /} receives an ASCII XOFF(^S, code 19) and resume sending when it receives0} an ASCII XON(^Q, code 17). When Chameleon is Sending a file, it 1} will pause on a ^S/^Q pair sent by the other computer.Echo Echo acts just li2}ke None, except during Sending, when Chameleon waits for the 3}character sent to the other computer to come back (or "echo"). THis mode is d4}esigned to allow sending text to slow time sharing systems that do not 5} support the ^S/^Q protocol. If a character doesn't echo within one6} quarter of a second, then the sending continues anyway.Short Delay Act7}s just like None, except during Sending, Modem Sending, Kermit Sending and Ke8}rmit Receiving, when it inserts a 1/60th of a second delay between 9} each character sent to the other computer. This delay allows slow compu:}ters enough time to process each character.Medium Delay Acts just like Short ;} Delay, except the delay is for 1/15th of a second.Long Delay Acts just like Short<} Delay, except the delay is for 1/4th of a second. If the ot=}her computer still can't keep up, and Echo mode doesn't work either, then you>} might as well type the information in by hand!3.3 Example: Settings for ?} Communication with Compuserve If you want to call ComuServe, orMicroNET through CompuServe, yoursettings typically woul@}d be a follows:Terminal Glass TTY Back S is CTRL-H Left Margin 2 Line Length 80 Cursor Free Scroll SmoothlyFile TransA}fer Protocol None File Name File Type TextDialing Method PulseModem Mode OriginateR: Device 1Baud Rate 300Parity EvenB}Duplex FullFlow Control ^S/^Q Figure 3-2: Typical Main Menu4. Dial Menu Chameleon uses the dial menu toautomatiC}cly dial a computer's phonenumber for you. You must have eitheran Atari 835, 1030, 1450, or HayesSmartmodem compatable moD}dem for thedial menu to work. To get to the dialmenu, type D from the main menu. Thedial menu looks like this:ComputerE} Name (baud rate) # 555-1212------------------------------------- ->-----------------------------------------------F}--------------------------- OPTION - move cursor to next number SELECT - enter new number START - dial number A - dG}ial all numbers S-save numbers R- restore numbers ESC - go back to main menu Figure 4-1: Dial Menu Screen4.1 H}Dial Menu Keys4.1.1 Selecting an item -- OPTION key Each time you press the OPTION key,the arrow moves down one line sI}o thatyou can select the next phone numberin the menu. You return to the firstphone number after reaching the lastone. J}You can also reverse the orderby holding down the SHIFT key whilepressing the OPTION key, which causesthe arrow to move toK} the previousphone number. With this method, youreturn to the last phone number afterreaching the first one.4.1.2 EntL}ering a phone number To enter a phone number, use OPTIONto move the arrow to a blank line (ora line containing a phone nuM}mber youwish to replace) and press SELECT. Ablinking cursor appears. Type in yournew phone number, using the BACK S keyN}to correct any errors. Press RETURNto finish entering the phone number.A valid phone number has three parts: - Name O} This is the name of the computer. It is ignored by Chameleon. It's what you use to remember which numberP} calls what computer. The name can contain any printing characters except for '#' and '('. - (Baud)Q} This is the baud rate of the other computer's modem. If this part of the phone number is missing, the baR}ud rate from the main menu is used. The only two valid baud rates for this are "(300)" and "(1200)". IfS} your modem can't actually communicate at 1200 baud, Chameleon will use 300 baud no matter what you say.T} - #Digits This is the actual number to dial. It can consist of any number of digits and the characteU}rs " ()-,". Digits are dialed in order. The characters " ()-" are ignored, and the "," character causesV} Chameleon to pause for three seconds -- which is useful when you're going through a private telephone syW}stem. Here are some imaginary but validphone number entries. Note that thelast one simply picks up the phone andwaitX}s for a carrier.Joe's BBS & Grill(1200)#9,18005551212Molly's Sine City (300) # 555-1212Annoy the Opertor # 0Long DistancY}e # 1 (617)253-1000# 411# Table 4-1: Valid Phone Numbers Here are some imaginary but invalidphone number entries,Z} along with thereasons they're invalid:555-1212-- need a '#' before the digitsA#1 BBS # 555-1212-- can't have a '#' in [}the nameTouchie's # 555-1212 * 444-- can't dial the '#' or '*' tones(Secret Agent) # 555-0007-- can't have a '(' in the n\}ameFogey (110) # 555-1212-- can't choose a 110 baud rate Table 4-2: Invalid Phone Numbers After you enter a number,]} be sure touse the S command to save the numbersto diskette! Any time you exit thedial menu, and changes you may havemad^}e since the last S command will belost!4.1.3 Dialing a number -- START key Press the START key to dial thephone numbe_}r you've selected. Checkthe status line (located between thelist of phone numbers and theinstructions) to follow the prog`}ressof your call. Type a 'Q' to quitdialing. If, after thirty seconds,Chameleon can't establishcommunication with the oa}ther computer,it will return to the dial menu. IfChameleon succeeds in establishingcommunications with the othercomputerb}, it'll go to terminal mode.(See the terminal mode chapter fordetails.)4.1.4 Dialing a sequence of numbers - A kec}y It's a universal law: "A goodcomputer's number is busy." If thecomputer you're trying to reach is apopular one, it's d}likely that thephone number will be busy when youcall it. If you'd like, you can haveChameleon dial a group of telephonee}numbers in sequence until it finallyestablishes communication with anothercomputer. All you have to do isposition the arrf}ow next to the firstnumber you'd like to try and press the'A' key. Chameleon will then try eachnumber in turn until it fig}nds anothercomputer. Blank lines are skipped, soif you want it to try the same numberover and over again, blank out theoq}B%DOS SYSB*)DUP SYSB SAUTORUN SYSB_HELP DOCBoCHAMELEODOCther lines by pressing SELECT thenRETURN for each one. When it findsanother computer, it will enterterminal mode. Sincer} none of the modems Chameleonworks with can detect a busy signal,Chameleon must wait 30 seconds afterdialing a phone numbes}r before it givesup. Sorry 'bout that.-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-* Please be careful when you use the Acommat}nd. If you accidentally annoy atelephone user by repeatedly dialingtheir number, your phone company willprobably take awau}y your telephoneconnection. -*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*4.1.5 Save the phone numbers -- S Chameleon can sav}ve the current phonenumbers in a disk file calledD:LIZARD40.NUM. Just insert a DOS-IIformatted writable disk in drive 1 aw}ndpress the S key.4.1.6 Restore the phone numbers -- R Saved phone numbers may be restoredany time you are in the diax}l menu.Just insert a DOS-II formatted diskcontaining the LIZARD40.NUM file intodrive 1 and press the R key. If thefile doy}es not exist, or cannot beread, then Chameleon uses its standarddefaults. If the file is readcorrectly, then the phone nuz}mbers areset to the stored values. Chameleon tries to read in thestored defaults whenever it enters thedial menu.4.{}1.7 Return to the main menu -- ESC Typing the ESC key will return youto the main menu without trying todial a phone numbe|}r.5. Utility Menu Typing a U while in the main menugets you the ram resident diskutilities. This is a menu modeledu}}pon the standard DOS 2.0 menu, and itprovides many of the more useful (andnot coincidentally easiest toimplement) features~} of the DOS 2.0menu. Here's what it looks like:Ram Resident Disk Utilities 2.0sA. Disk Directory E. Rename File(s)B. G}o To Main Menu F. Lock File(s)C. Copy File G. Unlock File(s)D. Delete File(s) I. Format DisketteZ. Set Default Comm}unication DeviceSelect item or RETURN for menu_ Figure 5-1: Utility Menu Screen If you have used the DOS 2.0 menu,}you shouldn't have any trouble withthe utility menu. Some of the optionsare missing, and others, like the Ccommand, don'}t have the options thatare available on the DOS 2.0 menu.This menu is intended to allow you todo the most important DOS fu}nctionswhile remaining within Chameleon. Ifyou find that the functions providedaren't enough, you'll have to quitChamele}on, use the real DOS menu, andrestart Chameleon. All utility menus are selected bytyping the letter of the utility then}the RETURN key. Most of the utilitieswill ask for an additional line ofinput, which you should type in,ending with the RE}TURN key. If youchange your mind about executing autility, type the BREAK key ratherthan the RETURN key.5.1 Disk Direct}ory -- A The A command is used to get a diskdirectory. If you want to see all thefiles on disk 1, just type RETURN when}you are asked for a "Search spec".Otherwise, type in the searchspecification you want. The directorywill be shown on the }screen.5.2 Return to the main menu -- B The B command returns you toChameleon's main menu.5.3 Copy a file -- C The C} command copies a single file.This command can be used (like it'sDOS 2.0 counterpart) to send a file tothe screen or the p}rinter, as well astransfer a file from one diskette toanother. It cannot, however, appendone file to another, nor can it }copymultiple files from one place toanother.5.4 Delete file(s) -- D The D command deletes all files thatmatch the "Del}ete file spec". All thefiles will be deleted at once -- youwill NOT be asked about each one.(i.e. the /N option is alway}s ineffect.)5.5 Rename file(s) -- E The E command renames all filesmatching the search spec before thecomma to match t}he search spec afterthe comma. Remember that the devicespecifier is included only for thespec before the comma.5.6 Lock} file(s) -- F The F command locks all filesmatching the search spec. Lockedfiles cannot be deleted, renamed, orover-wri}tten. Locked files appearwith an asterisk before their names ina directory listing.5.7 Unlock file(s) -- G The G comma}nd unlocks all filesmatching the search spec. Unlockedfiles are the ordinary kind that canbe deleted, renamed, and overwr}itten.5.8 Format Diskette -- I The I command asks you which driveyou wish to format, makes sure thatyou want to format }it, then formatsthat drive. Be careful not to formata diskette containing information thatyou wish to keep.5.9 Set Defa}ult Communication Device -- Z The Z command sets the defaultcommunication device by saving thedevice number you selec}t in the fileD:LIZARD40.DEV. When Chameleon is booted, it looksin the file D:LIZARD40.DEV for adevice number, and tries} to boot thatdevice first. If the default deviceis connected and turned on, Chameleonwill boot it and go to the main menu}automaticly. If the device doesn'trespond, Chameleon will tell you soand stay in device menu. If you regularly use onl}y oneparticular communications device,setting a default communication devicewill save you some time and effort.6. Term}inal Mode Terminal mode is the mode you use toactually communicate with anothercomputer. It's a grey screen with(some o}f the time) a line ofinverse-video text at the top. Whenyou first enter terminal mode, thescreen will look like this: }Terminal mode... (OPTION - quits)------------------------------------- [] Figure 6-1: Terminal Mode Screen Th}e terminal mode consists of twoparts, the status line (in reversevideo), and the terminal display,which is twenty four lin}es of greytext. Located at the left margin ofthe top line of the terminal displayis a green box. This is the terminaldi}splay's cursor.6.0.1 Recalling the main menu -- OPTION key When you're in terminal mode, youcan recall the main }menu by pressingthe OPTION key. The arrow will pointto the last menu item you selected.Characters sent to you while you'r}e inthe main menu will be lost.6.0.2 Vertical and horizontal scrolling Most time sharing system programsformat }text for 80 column wideprinting terminals. Since the Atarivideo screen is only 40 characterswide, and only 24 lines high,} youcan't see all the text at one time. Your Atari can, however, keep muchmore text in its memory than it canshow on th}e screen. Chameleon usesthis ability to give you most of thebenefits of an 80 column screen aswell as most of the benefit}s of aprinting terminal. In essence, when you are in theterminal mode Chameleon shows you a 24x 40 character window ont}o a muchlarger "virtual" screen. This virtualscreen is as wide as the Line Lengthitem of the menu, which is to saybetwee}n 40 and 132 characters wide,and as long as it can be and still fitin your Atari'S memory. The virtualscreen is always be}tween 24 and 255lines long, depending upon the amountof memory your Atari has, the FileTransfer Protocol, the Baud Rate, a}ndthe Line Length. You navigate around the virtualscreen with aid of the START, SELECT,and SHIFT keys. To try horizont}al andvertical scrolling, use the main menuto set the Terminal Type to Glass TTY,the Cursor to Free, the Duplex toHalf, t}he File Transfer Protocol toNone and Line Length to 80. PressSTART to enter the terminal mode.6.0.2.1 Vertical Scrollin}g--SELECT key If you type some text and then typethe RETURN key repeatedly, you'll soonnotice that the cursor moves down }tothe bottom line of the screen andremains there, while the text you'vetyped in scrolls off the top of thescreen. If you} press and hold theSELECT key, the screen will scrolldown and the text you typed willreturn to view. As this happens, the}cursor changes to an arrow pointingdown to its "true" position. As youcontinue to hold down the SELECT key,the text you }typed will continue toscroll down, and if you have enoughmemory, it will even disappear fromview off the bottom of the scr}een. Eventually, though, you'll bump intothe upper screen. Press and hold theRETURN key, and in a little while thetext} you typed will scroll off the topof the virtual screen, too. Once itdoes this it has been erased from theAtari's memory }and can never beretrieved. To return to the bottom ofthe virtual screen, press theSHIFT+SELECT keys and hold them down.T}he screen will scroll up and bringthe cursor back into view.6.0.2.2 Horizontal scrolling--START and SHIFT + START} keys Type a sentence (such as, "The quickbrown fox jumped over the...") untilyou reach the right-hand side of theline. } If you continue to type, you'llnotice the cursor has become an arrowpointing right, off the edge of thescreen, toward whe}re the nextcharacter should display. Press theSTART key and watch the charactersscroll leftward, until the screen isblan}k and the cursor has changed backinto a small square on the left-handedge of the screen. You've just usedthe START key to} scroll,character-by- character, to therightmost 40 columns of the 80-columndisplay. To return to the first 40 columns,}press SHIFT+START. You can use STARTand SHIFT+START to center the cursoron whatever column you wish. When thecursor is }positioned in its truelocation, it displays as a square.When it is located in a screen areaother than its true location (i}.e., inthe previous page buffer or on columnsacross the screen), it displays as anarrow pointing towards its trueposition}.6.0.2.3 Combining vertical and horizontal scrolling You can use the SELECT andSHIFT+SELECT keys and the START }andSHIFT+START keys to position yourselfanywhere on the virtual screen. Ifcharacters are typed by you or sent bythe remo}te computer while the cursoris off the screen, they will bedisplayed in the correct spot, but youwon't see them until you }return to theportion of the screen that containsthe cursor.6.0.2.4 Locking the Cursor for Faster Data Entry Se}t the CURSOR item of the menu toON SCREEN. This causes Chameleon tokeep the cursor on the screen at alltimes. If charact}ers sent to thescreen would cause the cursor to moveoff the screen, Chameleon will scrollautomatically to keep the cursor}square on the screen. This feature isuseful when you have a lot ofinformation to type in. You can typefaster when Chamel}eon keeps track ofthe cursor on the screen, because youwon't have to stop every few words toreposition the cursor with the} STARTand SHIFT+START keys. For long printouts, many peopleprefer to control scrolling themselves(CURSOR LOCK OFF), sin}ce them can themmove the screen around to read thetext at their own reading rate as wellas back up to reread a section.}6.0.2.5 File Transfer Protocol and the Virtual Screen All the file transfer protocolsexcept Snapshot work more smo}othlywhen there is a large amount of memoryto buffer text. When File TransferProtocol is set to any of these modesthe vi}rtual screen is reduced to 24lines (the height of the actualscreen). When the File TransferProtocol is set to None or Sna}pshot,Chameleon does not need to buffertext, and so the virtual screen againexpands to fill all of the memory.6.0.2.6 W}hen is the Virtual Screen Cleared? The virtual screen is cleared of allthe text it contains whenever its sizeor s}hape is altered. In particularthe screen will clear if: - you change from one the the buffered File Transfer } Protocol modes to one of the unbuffered File Transfer Protocol modes - you change the baud rate - you cha}nge the Line Length The most important case where thevirtual screen will NOT clear is whenyou change File Transfer Prot}ocol fromNone to Snapshot, which makes it easyto copy a portion of your virtualscreen to file.6.0.3 System Reset and B}reak Keys If you press the SYSTEM RESET key,you'll have to power-cycle your Atarito regain control. Chameleon has disa}bled the computerconsole's BREAK key in menu orterminal mode because it's so easy topress mistakenly and because theinter}face module software would stopsending data in that case. When a file I/O is in progress (forexample, when you're enteri}ng orleaving menu mode, or during FileTransfer Protocol mode), you can usethe BREAK key to abort the I/O.6.0.4 Sending} a "Break" Signal to the Host Computer You'll sometimes want to send a"break" signal to the host computer--to tell }it to stop sending data. Todo so, press the SHIFT+Atari keys.Each time you press these keys,Chameleon will send a half-se}cond ofBREAK signal to the other computer. Table of Contents1. Introduction 11.1 Overv}iew 11.2 Required Accessories 11.3 Optional Accessories 11.4 Contacting th}e Author 12. Getting Started 22.1 Attaching an RS-232C Device 2 to the Interface Mo}dule2.2 Loading Chameleon into 2 Computer Memory2.3 Chameleon's Device Menu 23. The Main Menu } 33.1 The Main Menu Keys 3 3.1.1 Selecting an item 3 -- OPTION key } 3.1.2 Selecting a value for 3 an item -- SELECT key 3.1.3 Entering a file name 3 3.1.4 Moving} to terminal 3 mode -- START key 3.1.5 Dial a number -- D 3 3.1.6 Utility menu -- U } 3 3.1.7 Pick up the phone -- P 3 3.1.8 Hang up the phone -- H 3 3.1.9 Save the main menu 3 } settings -- S 3.1.10 Restore the main menu 3 settings -- R 3.1.11 Quit Chameleon 3} -- CTRL-Q3.2 Menu Items 4 3.2.1 Terminal 4 3.2.2 Back S is } 4 3.2.3 Left Margin 4 3.2.4 Line Length 4 3.2.5 Cursor } 5 3.2.6 Scroll 5 3.2.7 File Transfer Protocol 5 3.2.8 File Name 5 } 3.2.9 File Type 5 3.2.10 Dialing Method 5 3.2.11 Modem Mode 5 3.2.1}2 R: Device 5 3.2.13 Baud Rate 5 3.2.14 Parity 6 3.2.15 Duplex} 6 3.2.16 Flow Control 63.3 Example: Settings for 6 Communication with Com}puserve4. Dial Menu 74.1 Dial Menu Keys 7 4.1.1 Selecting an item }7 -- OPTION key 4.1.2 Entering a phone 7 number 4.1.3 Dialing a number 7 } -- START key 4.1.4 Dialing a sequence of 7 numbers - A key 4.1.5 Save the phone numbers }8 -- S 4.1.6 Restore the phone 8 numbers -- R 4.1.7 Return to the main 8 } menu -- ESC5. Utility Menu 95.1 Disk Directory -- A 95.2 Return to the main menu} -- B 95.3 Copy a file -- C 95.4 Delete file(s) -- D 95.5 Rename file(s) -- E } 95.6 Lock file(s) -- F 95.7 Unlock file(s) -- G 95.8 Format Diskette -- I 95.9 }Set Default Communication 9 Device -- Z6. Terminal Mode 10 6.0.1 Recalling the main } 10 menu -- OPTION key 6.0.2 Vertical and 10 horizontal scrolling 6.0.2.1 }Vertical 10 Scrolling-- SELECT key 6.0.2.2 Horizontal 10 } scrolling-- START and SHIFT + START keys 6.0.2.3 Combining }10 vertical and horizontal scrolling 6.0.2.4 Locking the } 10 Cursor for Faster Data Entry 6.0.2.5 File Transfer 1}0 Protocol and the Virtual Screen 6.0.2.6 When is the 1}1 Virtual Screen Cleared? 6.0.3 System Reset and Break 11 Keys 6.0}.4 Sending a "Break" 11 Signal to the Host Computer List of FiguresFigure 2-1: }Device Menu Screen 2Figure 3-1: Main Menu Screen 3Figure 3-2: Typical Main Menu 6Figure 4-1: Dial Men}u Screen 7Figure 5-1: Utility Menu Screen 9Figure 6-1: Terminal Mode 10 Screen } List of TablesTable 3-1: VT-52 Alt. Keypad 4 ModeTable 4-1: Valid Phone Numbers 7Table 4-}2: Invalid Phone 7 Numbers 4 ModeTable 4-1: Valid Phone Numbers 7Table 4-4