@L}5 _$% l0$)$$Hȱ$ UhL" `e$$%`$%`  R@P!( 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- 160ɛ+,' 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 D8u Chameleon Terminal Emulator T} Version 4.02 User's Guide U} 17 November 1984 (c) 1984 JV}ohn Howard Palevich Distributed by the W} NOVATARI PROGRAM EXCHANGE 4408 Manor Hall Lane FX}airfax, Virginis 22033 Chameleon User's Guide Y} Table of Contents ================= 1. IntroZ}duction...4 1.1 Overview...4 1.2 Required Accessories...5 1.3 Optional Accessories...5 2. Getting Sta[}rted...5 2.1 Attaching an RS-232C Device to the Interface Module...5 2.2 Loading Chameleon into Computer Memory..\}.5 2.3 Chameleon's Device Menu...6 3. The Main Menu...7 3.1 The Main Menu Keys...7 3.1.1 Selecting an]} item -- OPTION key...7 3.1.2 Selecting a value for an item -- SELECT key...8 3.1.3 Entering a file name...8 ^} 3.1.4 Moving to terminal mode -- START key...8 3.1.5 Dial a number -- D...8 3.1.6 Utility menu -- U...8 3_}.1.7 Pick up the phone -- P...8 3.1.8 Hang up the phone -- H...9 3.1.9 Save the main menu settings -- S...9 `} 3.1.10 Restore the main menu settings -- R...9 3.1.11 Quit Chameleon -- CTRL-Q...9 3.2 Menu Items...9 3.2.a}1 Terminal...9 3.2.2 Back S is...11 3.2.3 Left Margin...11 3.2.4 Line Length...11 3.2.5 Cursor...12 b} 3.2.6 Scroll...12 3.2.7 File Transfer Protocol...12 3.2.8 File Name...13 3.2.9 File Type...13 3.c}2.10 Dialing Method...13 3.2.11 Modem Mode...13 3.2.12 R: Device...14 3.2.13 Baud Rate...14 3.2.14 Pad}rity...14 3.2.15 Duplex...14 3.2.16 Flow Control...15 3.3 Example: Settings for Communication with Compusere}ve...15 4. Dial Menu...16 4.1 Dial Menu Keys...17 4.1.1 Selecting an item -- OPTION key...17 4.1.2 Enf}tering a phone number...17 4.1.3 Dialing a number -- START key...18 4.1.4 Dialing a sequence of numbers - A key..g}.18 4.1.5 Save the phone numbers -- S...19 4.1.6 Restore the phone numbers -- R...19 4.1.7 Return to the mah}in menu -- ESC...20 5. Utility Menu...20 Page 2 Chameleon i} User's Guide 5.1 Disk Directory -- A...20 5.2 Return to the main menu -- B...2j}1 5.3 Copy a file -- C...21 5.4 Delete file(s) -- D...21 5.5 Rename file(s) -- E...21 5.6 Lock file(sk}) -- F...21 5.7 Unlock file(s) -- G...21 5.8 Format Diskette -- I...21 5.9 Set Default Communication Devicel} -- Z...22 6. Terminal Mode...22 6.0.1 Recalling the main menu -- OPTION key...22 6.0.2 Vertical and horizom}ntal scrolling...23 6.0.2.1 Vertical Scrolling -- SELECT key...23 6.0.2.2 Horizontal scrolling -- START and SHIFTn} + START keys...24 6.0.2.3 Combining vertical and horizontal scrolling...24 6.0.2.4 Locking the Cursor for Fastero} Data Entry...24 6.0.2.5 File Transfer Protocol and the Virtual Screen...25 6.0.2.6 When is the Virtual Screen Clp}eared?...25 6.0.3 System Reset and Break Keys...25 6.0.4 Sending a "Break" Signal to the Host Computer...25 q} List of Figures =============== Figure 2-1: Der}vice Menu Screen...6 Figure 4-1: Dial Menu Screen...16 Figure 5-1: Utility Menu Screen...20 Figure 6-1: Ters}minal Mode Screen...22 List of Tables ============== t} Table 3-1: VT-52 Alt. Keypad Mode...10 Table 4-1: Valid Phone Numbers...18 Table 4-2: Invalid Phone Nu}umbers...18 Page 3 Chameleon v} User's Guide 1. Introduction w}=============== 1.1 Overview ------------ Chameleon converts your Atari computer into a powerful cox}mputer terminal. It emulates six terminals: "Glass TTY" (that is, a video terminal with the same features as a py}rinting terminal), Lear Siegler's ADM-3A, Digital Equipment Corporation's VT-52, a non-standard extension to the z}VT-52 called the VT-52XL, the IBM 3031 ASCII terminal, and a Test terminal, useful for debugging. For every termi{}nal type besides Test, Chameleon supports tab, backspace, line feed, form feed, and a visual bell signal. For th|}e Glass TTY it supports word-wrapping. For the ADM-3A, the VT-52, and the VT-52XL, it also supports cursor addressing }}and basic editing features. For the VT-52XL, it supports character and line insert and delete, as well as revers~}e video. A termcap entry is provided for use with unix operating systems. Chameleon doesn't support the special} graphics character set of the VT-52 or some rarely used ADM-3A features. Chameleon's major features are: } 1. a 24-line, 40-, 80-, or 132-column character display (displaying 40 columns at a time) with a cursor lock feature f}or automatic horizontal scrolling 2. a buffer that saves up to nine previous pages of text 3. continuous }communications at baud rates of 75 to 1200 baud and non-continuous (requires flow control) communication at rates of } 1800 to 9600 baud 4. selectable parity 5. a BREAK 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 Atari and most other computers, using either flow controlled, Modem, o}r Kermit protocols 10. using one of the supported modems, the ability to automaticly dial any of sixteen s}tored phone numbers, and to keep dialing Page 4 Chameleon } User's Guide numbers until a carrier tone is detected 11. a ram-resident disk utilt}iy program, allowing most of the functions provided by the DOS 2 menu 1.2 Required Accessories -----}------------------- - 48K RAM - a disk drive - at least one of the following: * Atari 850 In}terface Module, and a standard RS-232C modem * Atari 835 Modem * Atari 1030 Modem * Atari 1}450 computer (which contains a modem) 1.3 Optional Accessories ------------------------ - Wit}h the Atari 850, a Hayes Smartmodem, or other Hayes compatable modem - Printer } 2. Getting Started ================== 2.1 Attaching an RS-232C Device to} the Interface Module ------------------------------------------------------- If you are using an Atari 850, rat}her than one of the standard Atari modems, you will have to attach your RS-232C device to the Atari 850. Chamele}on talks to Port 1 of the Atari 850. (This is the default behavior -- you can use the R: Device menu line to make} Chameleon talk to any one of the four ports.) Only "Transmit Data", "Receive Data", and "Ground" need to be con}nected. "Data Terminal Ready" and "Request to Send" are set high (+12V = true) when Chameleon starts. This is done as} a convenience to devices requiring these signals. Chameleon ignores all other signals. 2.2 Loading} Chameleon into Computer Memory ------------------------------------------ To load Chameleon into computer memor}y: 1. Remove all cartridges from your Atari computer. 2. Make sure all equipment is turned off. } 3. Turn on all your peripherals. Page 5 Chameleon } User's Guide 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 Chameleon's device menu appears. 2.3 Chameleon's} Device Menu --------------------------- Chameleon can talk to a number of Atari devices, but it has to kn}ow which one it should use. The first thing Chameleon will do is ask you which device to use. Below is an illus}tration of the device menu, which is the first screen you will see the first time you run an un-modified copy of }Chameleon 4.0. If your copy of Chameleon has been customized (by using command Z from the utilities menu), Chameleon w}ill try to use the device you specified in the Z command. If you have never used the Z command, or if that devic}e doen't exist, you'll get this screen: Chameleon Term}inal 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 com}patible modem) 3 - Atari 835 modem 4 - Atari 1030 modem 5 - At}ari 1450 internal modem ------------------------------------- Which device to use (0-}5)? _ ------------------------------------- Figure 2-1: } Device Menu Screen You should type in the number of the device you want to use (or 0 if you don'}t have any device, but still want to investigate Chameleon). Then press the RETURN key. Chameleon will try to f}ind the specified device. If it can, you will shortly see the main menu screen. Otherwise, you will be told that Cham}eleon failed to find the device, and you will be asked for another device. If this happens, make sure that your }communications device is plugged in to the wall, connected to your Atari, and turned on! } Page 6 Chameleon User's Guide } 3. The Main Menu ================ 3.1 The Main Menu Keys } ---------------------- After Chameleon finds a communications device, it presents you with its main menu. }This is the menu which lets you control Chameleon's actions. It looks like this: } Chameleon (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 }Dialing Method Pulse Modem Mode Originate R: Device 1 Ba}ud Rate 300 Parity None Duplex Full Flow Control ^S/^Q } ------------------------------------- OPTION -move cursor to next parameter } SELECT -change parameter's value START -begin terminal emulation D - dial }a number U -utility menu P - pick up phone H -hang up phone S - save options } R -restore options CTRL-Q - quit Chameleon Figure 3}-1: Main Menu Screen 3.1.1 Selecting an item -- OPTION key -------------------------------}------ Each time you press the OPTION key, the arrow moves down one line so that you can select the next item in} the menu. You return to the first menu item after reaching the last one. You can also reverse the order by hol}ding down the SHIFT key while pressing the OPTION key, which causes the arrow to move to the previous menu item. } With this method, you return to the last menu item after reaching the first one. } Page 7 Chameleon User's Guide 3.1.2 Selecting }a value for an item -- SELECT key ------------------------------------------------- Each time you press the SELE}CT key, a new value displays for the current menu item. Again, to reverse the order, hold down the SHIFT key whi}le pressing the SELECT key, which causes the previous value to display. 3.1.3 Entering a file name -}------------------------- The "File Name" line of the menu displays the file currently selected for file transfe}r operations. When you press the SELECT or SHIFT-SELECT keys, a blinking cursor replaces the old file name. Typ}e in your new file name, using the BACK S key to correct any errors. Press RETURN to remove the cursor. If you }always keep the "File Transfer Protocol" set to "None", then you can safely ignore the "File Name" line. 3}.1.4 Moving to terminal mode -- START key ------------------------------------------ Press the START key to move} from the main menu to the terminal mode. See the chapter on terminal mode for details. 3.1.5 Dial a numb}er -- D ------------------------ If you have an Atari 835, 1030, 1450, or hayes Smartmodem compatable mode}m, Chameleon can dial the other computer's number for you. Type D from the main menu to go to the dial menu. See } the chapter on the dial menu for more information. 3.1.6 Utility menu -- U ----------------------- } Chameleon will let you perform many of the functions of the DOS-II DUP program from within Chameleon. Type U from th}e main menu to go to the utility menu. See the chapter on the utility menu for more information. 3.}1.7 Pick up the phone -- P ---------------------------- If you have an Atari 835, 1030, 1450, or Hayes Smartmode}m compatable modem, and you have manually dialed another computer, typing P in the main menu will make Chameleon }pick up the phone line and attempt to establish communications with the other computer. If, after thirty seconds}, Chameleon hasn't established communication, it will hang up the phone and return to the main } Page 8 Chameleon User's Guide menu. Type Q to q}uit waiting for the other computer before the thirty seconds are up. If Chameleon does establish communication, }it will enter terminal mode. 3.1.8 Hang up the phone -- H ---------------------------- If you have }an Atari 835, 1030, 450, or Hayes Smartmodem compatable modem, and you wish to terminate a phone connection with }another computer, type H in the main menu. Chameleon will hang up the phone and return to the main menu. Hayes Smartm}odem compatable modems take up to ten seconds to do this. If you get impatient, you may type Q to return to the }main menu. 3.1.9 Save the main menu settings -- S -------------------------------------- Chameleon }can save the current menu item settings in a disk file called LIZARD40.OPT. Current menu settings may be saved any tim}e you are in the main menu. Just insert a DOS-II formatted writable disk in drive 1 and press the S key. Every }menu item except the File Name will be saved into the file D:LIZARD32.OPT. 3.1.10 Restore the main menu se}ttings -- R ------------------------------------------ Saved menu settings may be restored any time you are in t}he menu. Just insert a DOS-II formatted disk containing the LIZARD40.OPT file into drive 1 and press the R key. C}hameleon will try to read the saved options out of D:LIZARD40.OPT. If the file does not exist, or cannot be read}, then Chameleon uses its standard defaults. If the file is read correctly, then menu items (except for the fil}e name) are set to the stored values. Chameleon tries to read in the stored defaults when it is booted. This mak}es it easy to customize Chameleon to your application. 3.1.11 Quit Chameleon -- CTRL-Q -------------------}------------ Typeing CTRL-Q from the main menu will exit Chameleon and return you to DOS. If you are using an 8}50 and DOS 2.0, you must power-cycle your Atari before running Chameleon again. (Because DUP.SYS writes over the }R: drivers.) 3.2 Menu Items -------------- 3.2.1 Terminal -------------- }Use the first item to select the kind of terminal you want to Page 9 Chamel}eon User's Guide emulate. Your choices are: GLASS TTY -- Thi}s value simulates a typical printing terminal with tabs every eight columns, line feed, form feed, backspace, car}riage 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 enough to be used with m}any computer instalations. However, it isn't sufficient for time-sharing computers capable of sending special ch}aracters for cursor control, character editing, and so on. Select one of the video terminal values to communicat}e with such computers. VT-52 -- This value simulates the DEC VT-52 terminal, except for the keypad and the} special graphics character set. Chameleon doesn't support the Enable Graphics and Disable Graphics commands. N}ormal mode lowercase characters print in place of graphics. While the alternate keypad mode isn'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 ES}C ?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 } grey ESC R ESC R Table 3-1: VT-52 Alt. Keypad Mode } VT-52XL -- This terminal is just like a VT-52, except that four additional escape sequences have been defined to }aid editing. Page 10 Chameleon U}ser's Guide See the chapter on character and contol codes for more details. ADM-3A -- This value simula}tes 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 this 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 cu }rsor reaches the right margin, it moves down to the next line. When the cursor reaches the bottom of the screen, } it scrolls the whole screen upward one line. thus, the last several thousand characters sent to Chameleon will }be visible on the screen. This mode is useful for debugging new time-sharing systems because it lets you find 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 controls which character is sent to the other computer wh }en you type the BACK S key. The choices are: CTRL-H -- This choice 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 type t }he BACK S key. To get BS you type CTRL-H. 3.2.3 Left Margin ----------------- Many TV sets o }verscan. making the left two character positions of the screen un-readable. This item lets you select your left }margin. Your choices 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 Length ----------------- The line length of Chameleon can be adjusted to suit your prefer }ences. The choices are 40, 80, and 132 characters long. Page 11 Chameleon } User's Guide 3.2.5 Cursor ------------ This item cont }rols the behavior of the cursor. There are two ways the cursor can behave: FREE -- The cursor is free to }travel off the screen. ON SCREEN -- The cursor 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 Chameleon does a line feed at the bottom of the screen, it has to move the text up one line, to make room for th }e new line. It can move the 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 ugly. 3.2.7 File Transfer } Protocol ---------------------------- This item controls which type of file transfer Chameleon will do. S }ee the chapter on transferring files for more information. The choices are: NONE -- No file transfer is selecte }d. SNAPSHOT -- Transfer characters from the screen to an Atari device. SEND -- Transfer characters from a }n Atari device to another computer RECEIVE -- transfer characters from the other computer to an Atari devi }ce MODEM SEND -- Transfer files from an Atari device to another computer using the MODEM2 protocol MODEM }RECEIVE -- Transfer files from another computer to an Atari device using the MODEM2 protocol KERMIT SEND -- Tran }sfer files from an Atari device to another computer using the Kermit protocol KERMIT RECEIVE -- Transfer files f }rom another computer to an Page 12 Chameleon } User's Guide Atari device using the Kermit protocol 3.2.8 File Name --------------- } The file transfer modes need a file name. If you have "File Transfer Protocol" set to "None", you needn't consi }der this line. Pressing the SELECT or SHIFT-SELECT keys for this item causes a blinking cursor to appear. Type i !}n the name of the file you want to use. use the BACK S key to correct typing mistakes. Type RETURN to finish en "}tering the file name. See the chapter on transfering files for more information. 3.2.9 File Type -- #}------------- Use this type to tell Chameleon what kind of file you play to transfer. Chameleon needs this info $}rmation to decide waht to do with end-of-line and tab characters. The choices are: TEXT -- This choice tries to %} map ASCII CR/LF to ATASCII EOL, and ASCII TAB to ATASCII TAB. During sending, EOL is converted to CR. During r &}eceiving, CR is converted to EOL and LF is ignored. Use this mode when transfering text files between your computer '} and another brand of computer. BINARY -- In this choice, all characters are sent and received as is. Use thi (}s mode when transfering text files 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 Hayes Smartmodem compatable modem, you can choose which dialing method to use when a +}uto-dialing. The other modems that Chameleon supports can only pulse dial. 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 compatable modem, you can choose to set your modem's com .}munication mode. In any modem based communication, one of the modems must be set in originate mode, and the other in a /}nswer mode. ORIGINATE -- This mode is used to communicate with most Page 0}13 Chameleon User's Guide time-sharing systems, bulliten board 1}s, etc.. ANSWER -- This mode is used to communicate with another computer which has it's modem in orginate mode. 2} 3.2.12 R: Device ---------------- If you are not using an Atari 850 nterface Module, you may ignor 3}e this tem. If you are using an 850, this tem selects which of the four RS-232C orts Chameleon will use for ommu 4}nication. Most people use only ort number one, but the choices are 1, 2, 3, or 4. 3.2.13 Baud Rate 5} ---------------- Use this item to select the baud (data transmission) rate. The values are in bits per se 6}cond. Consult the manual or authorities for the system you're using for appropriate baud rates. Continuous trans 7}mission choices are: 75, 110, 134.5, 150, 300, 600, or 1200 baud. Non- continuous transmission (i.e. you'll nee 8}d flow control, or you'll lose characters) is available at 1800, 2400, 4800, and 9600 baud. 3.2.14 Parity 9} ------------- Use this item to select the kind of parity check sent from Chameleon to the other computer, :}and the kind of parity Chameleon expects from the other system. Consult the manual or authorities for the system ;} you're using. NONE -- There is no parity bit; all eight bits of the character are considered to be data. with o <}dd parity. Received parity is ignored. EVEN -- Characters are sent with even parity. 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 control where the characters you type are sent. FULL -- Keyboa ?}rd characters go to the other system. HALF -- keyboard characters go to both the other system and the screen. U @}se this mode to talk to systems requiring half duplex. Page 14 Chameleon A} User's Guide 3.2.16 Flow Control ------------------- T B}his item selects the way in which Chameleon controls the flow of data between itself and the other computer. The choic C}es are: NONE -- which means that the other computr has no means of flow control. When None is selected, the Fil D}e Transfer Protocol modes send and receive, and baud rates in excess of 1200 baud, will probably lose characters. E} ^S/^Q -- Which means that the other computer will stop sending when it receives an ASCII XOFF(^S, code 19) and F}resume sending when it receives an ASCII XON(^Q, code 17). When Chameleon is Sending a file, it will pause on a G}^S/^Q pair sent by the other computer. ECHO -- Echo acts just like None, except during Sending, when Chame H}leon waits for the character sent to the other computer to come back (or "echo"). This mode is designed to allow sendi I}ng text to slow time sharing systems that do not support the ^S/^Q protocol. If a character doesn't echo within J}one quarter of a second, then the sending continues anyway. SHORT DELAY -- Acts just like None, except during Se K}nding, Modem Sending, Kermit Sending and Kermit Receiving, when it inserts a 1/60th of a second delay between eac L}h character sent to the other computer. This delay allows slow computers enough time to process each character. M} MEDIUM DELAY -- Acts just like Short Delay, except the delay is for 1/15th of a second. LONG DELAY -- Act N}s just like Short Delay, except the delay is for 1/4th of a second. If the other computer still can't keep up, a O}nd Echo mode doesn't work either, then you might as well type the information in by hand! 3.3 Example: Set P}tings for Communication with Compuserve ------------------------------------------------------- If you want to c Q}all ComuServe, or MicroNET through CompuServe, your settings typically would be a follows: R} Page 15 Chameleon User's Guide S} Terminal Glass TTY Back S is CTRL-H T} Left Margin 2 Line Length 80 Cursor Free U} Scroll Smoothly File Transfer Protocol None File Name V} File Type Text Dialing Method Pulse Modem M W}ode Originate R: Device 1 Baud Rate 300 Pari X}ty Even Duplex Full Flow Control ^S/^Q F Y}igure 3-2: Typical Main Menu 4. Dial Menu = Z}=========== Chameleon uses the dial menu to automaticly dial a computer's phone number for you. You must have e [}ither an Atari 835, 1030, 1450, or Hayes Smartmodem compatable modem for the dial menu to work. To get to the di \}al menu, type D from the main menu. The dial menu looks like this: ]} Computer Name (baud rate) # 555-1212 ------------------------------------- -> ^} ------------------ _}------------------- ------------------------------------- OPTION - m `}ove cursor to next number SELECT - enter new number START - dial number a} A - dial all numbers S - save numbers R - restore numbers b} ESC - go back to main menu Figure 4-1: Dial Menu Screen c} Page 16 Chameleon User's Guide d} 4.1 Dial Menu Keys ------------------ 4.1.1 Selecting an item -- OPTION key ------------------- e}------------------ Each time you press the OPTION key, the arrow moves down one line so that you can select the f}next phone number in the menu. You return to the first phone number after reaching the last one. You can also re g}verse the order by holding down the SHIFT key while pressing the OPTION key, which causes the arrow to move to th q}b%DOS SYSb*)DUP SYSbSCHEMUSERDOCbAUTORUN SYSB"DISPLAY BASe previous phone number. With this method, you return to the last phone number after reaching the first one. r} 4.1.2 Entering a phone number ----------------------------- To enter a phone number, use OPTION to move the s}arrow to a blank line (or a line containing a phone number you wish to replace) and press SELECT. A blinking cur t}sor appears. Type in your new phone number, using the BACK S key to correct any errors. Press RETURN to finish u}entering the phone number. A valid phone number has three parts: NAME -- This is the name of the computer. It v}is ignored by Chameleon. It's what you use to remember which number calls what computer. The name can contain a w}ny printing characters except for '#' and '('. (BAUD) -- This is the baud rate of the other computer's modem. x} If this part of the phone number is missing, the baud rate from the main menu is used. The only two valid baud rat y}es for this are "(300)" and "(1200)". If your modem can't actually communicate at 1200 baud, Chameleon will use z}300 baud no matter what you say. #DIGITS -- This is the actual number to dial. It can consist of any numb {}er of digits and the characters " ()-,". Digits are dialed in order. The characters " ()-" are ignored, and the "," |} character causes Chameleon to pause for three seconds -- which is useful when you're going through a private tele }}phone system. Here are some imaginary but valid phone number entries. Note that the last one simply picks up th ~}e phone and waits for a carrier. Page 17 Chameleon } User's Guide Joe's BBS & Grill(1200)#9,1800555 }1212 Molly's Sine City (300) # 555-1212 Annoy the Opertor # 0 Long Dist }ance # 1 (617)253-1000 # 411 # Table 4-1: Valid Phone Numb }ers Here are some imaginary but invalid phone number entries, along with the reasons they're invalid: } 555-1212 -- need a '#' before the digits A#1 BBS # 555-1212 -- can't have a '#' in the name Touc }hie's # 555-1212 * 444 -- can't dial the '#' or '*' tones (Secret Agent) # 555-0007 -- can't have a '(' in the name } Fogey (110) # 555-1212 -- can't choose a 110 baud rate Table 4-2: Invalid Phone Numbers } After you enter a number, be sure to use the S command to save the numbers to diskette! Any time you exit th }e dial menu, and changes you may have made since the last S command will be lost! 4.1.3 Dialing a number - }- START key ----------------------------------- Press the START key to dial the phone number you've selected. } Check the status line (located between the list of phone numbers and the instructions) to follow the progress of yo }ur call. Type a 'Q' to quit dialing. If, after thirty seconds, Chameleon can't establish communication with the } other computer, it will return to the dial menu. If Chameleon succeeds in establishing communications with the }other computer, it'll go to terminal mode. (See the terminal mode chapter for details.) 4.1.4 Dialing a s }equence of numbers - A key ------------------------------------------- It's a universal law: "A good computer's }number is busy." If the computer you're trying to reach is a popular one, it's likely that the phone number will } be busy when you call it. If you'd like, you can have Chameleon dial a group of telephone numbers in sequence u }ntil it finally establishes communication with another computer. All you have to do is position the arrow next to the } first number you'd like to try and press the 'A' key. Chameleon will then try each number in turn until it finds } another computer. Blank lines are skipped, so if you want it to try the Page 1 }8 Chameleon User's Guide same number over and over again, blan }k out the other lines by pressing SELECT then RETURN for each one. When it finds another computer, it will enter }terminal mode. Since none of the modems Chameleon works with can detect a busy signal, Chameleon must wait 30 se }conds after dialing a phone number before it gives up. Sorry 'bout that. *-*-*-*-*-*-*-*-*-*-*- }*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- * Please be careful when you use the A command. If you a }ccidentally annoy a telephone user by repeatedly dialing their number, your phone company will probably } take away your telephone connection. *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*- * } 4.1.5 Save the phone numbers -- S --------------------------------- Chameleon can save the current } phone numbers in a disk file called D:LIZARD40.NUM. Just insert a DOS-II formatted writable disk in drive 1 and } press the S key. 4.1.6 Restore the phone numbers -- R ------------------------------------ Saved p }hone numbers may be restored any time you are in the dial menu. Just insert a DOS-II formatted disk containing the } LIZARD40.NUM file into drive 1 and press the R key. If the file does not exist, or cannot be read, then Chameleon use }s its standard defaults. If the file is read correctly, then the phone numbers are set to the stored values. } Chameleon tries to read in the stored defaults whenever it enters the dial menu. } Page 19 Chameleon User's Guide r 4. }1.7 Return to the main menu -- ESC ------------------------------------ Typing the ESC key will return you to th }e main menu without trying to dial a phone number. 5. Utility Menu } =============== Typing a U while in the main menu gets you the ram resident disk utili }ties. This is a menu modeled upon the standard DOS 2.0 menu, and it provides many of the more useful (and not co }incidentally easiest to implement) features of the DOS 2.0 menu. Here's what it looks like: } Ram Resident Disk Utilities 2.0s A. Disk Directory E. Rename File(s) } B. Go To Main Menu F. Lock File(s) C. Copy File G. Unlock File(s) D. Del }ete File(s) I. Format Diskette Z. Set Default Communication Device } Select 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 with the utility menu. Some of the options }are missing, and others, like the C command, don't have the options that are available on the DOS 2.0 menu. This } menu is intended to allow you to do the most important DOS functions while remaining within Chameleon. If you f }ind that the functions provided aren't enough, you'll have to quit Chameleon, use the real DOS menu, and restart }Chameleon. All utility menus are selected by typing the letter of the utility then the RETURN key. Most of the }utilities will ask for an additional line of input, which you should type in, ending with the RETURN key. If you } change your mind about executing a utility, type the BREAK key rather than the RETURN key. 5.1 Disk Direc }tory -- A ----------------------- The A command is used to get a disk directory. If you want to see all t }he files on disk 1, just type RETURN when you are asked for a "Search spec". Otherwise, type in the search specificati }on you want. The directory will be shown on the screen. Page 20 Cham }eleon User's Guide 5.2 Return to the main menu -- B -------- }------------------------ The B command returns you to Chameleon's main menu. 5.3 Copy a file -- C - }------------------- The C command copies a single file. This command can be used (like it's DOS 2.0 counterpart) } to send a file to the screen or the printer, as well as transfer a file from one diskette to another. It cannot }, however, append one file to another, nor can it copy multiple files from one place to another. 5.4 Delet }e file(s) -- D ----------------------- The D command deletes all files that match the "Delete file spec". } All the files will be deleted at once -- you will NOT be asked about each one. (i.e. the /N option is always in effe }ct.) 5.5 Rename file(s) -- E ----------------------- The E command renames all files matching the s }earch spec before the comma to match the search spec after the comma. Remember that the device specifier is incl }uded only for the spec before the comma. 5.6 Lock file(s) -- F --------------------- The F co }mmand locks all files matching the search spec. Locked files cannot be deleted, renamed, or over-written. Locked file }s appear with an asterisk before their names in a directory listing. 5.7 Unlock file(s) -- G - }---------------------- The G command unlocks all files matching the search spec. Unlocked files are the ordinary } kind that can be deleted, renamed, and overwritten. 5.8 Format Diskette -- I ---------------------- }-- The I command asks you which drive you wish to format, makes sure that you want to format it, then formats th }at drive. Be careful not to format a diskette containing information that you wish to keep. } Page 21 Chameleon User's Guide 5.9 }Set Default Communication Device -- Z ----------------------------------------- The Z command sets the default c }ommunication device by saving the device number you select in the file D:LIZARD40.DEV. When Chameleon is booted, } it looks in the file D:LIZARD40.DEV for a device number, and tries to boot that device first. If the default de }vice is connected and turned on, Chameleon will boot it and go to the main menu automaticly. If the device doesn }'t respond, Chameleon will tell you so and stay in device menu. If you regularly use only one particular communi }cations device, setting a default communication device will save you some time and effort. } 6. Terminal Mode ================ Terminal mode is the mo }de you use to actually communicate with another computer. It's a grey screen with (some of the time) a line of i }nverse-video text at the top. When you first enter terminal mode, the screen will look like this: } Terminal mode... (OPTION - quits) ----------------------------------- }- [] Figure 6-1: T }erminal Mode Screen The terminal mode consists of two parts, the status line (in reverse video), a }nd the terminal display, which is twenty four lines of grey text. Located at the left margin of the top line of }the terminal display is a green box. This is the terminal display's cursor. 6.0.1 Recalling the main menu } -- OPTION key ------------------------------------------- When you're in terminal mode, you can recall the main } menu by pressing the OPTION key. The arrow will point to the last menu item you selected. Characters sent to yo }u while you're in the main menu will be lost. Page 22 Chameleon } User's Guide 6.0.2 Vertical and horizontal scrolling ----------- }---------------------------- Most time sharing system programs format text for 80 column wide printing terminals }. Since the Atari video screen is only 40 characters wide, and only 24 lines high, you can't see all the text at } one time. Your Atari can, however, keep much more text in its memory than it can show on the screen. Chameleon } uses this ability to give you most of the benefits of an 80 column screen as well as most of the benefits of a p }rinting terminal. In essence, when you are in the terminal mode Chameleon shows you a 24 x 40 character window o }nto a much larger "virtual" screen. This virtual screen is as wide as the Line Length item of the menu, which is }to say between 40 and 132 characters wide, and as long as it can be and still fit in your Atari'S memory. The vi }rtual screen is always between 24 and 255 lines long, depending upon the amount of memory your Atari has, the File Tran }sfer Protocol, the Baud Rate, and the Line Length. You navigate around the virtual screen with aid of the START, } SELECT, and SHIFT keys. To try horizontal and vertical scrolling, use the main menu to set the Terminal Type to } Glass TTY, the Cursor to Free, the Duplex to Half, the File Transfer Protocol to None and Line Length to 80. Pr }ess START to enter the terminal mode. 6.0.2.1 Vertical Scrolling -- SELECT key --------------------- }----------------- If you type some text and then type the RETURN key repeatedly, you'll soon notice that the cur }sor moves down to the bottom line of the screen and remains there, while the text you've typed in scrolls off the } top of the screen. If you press and hold the SELECT key, the screen will scroll down and the text you typed wil }l return to view. As this happens, the cursor changes to an arrow pointing down to its "true" position. As you contin }ue to hold down the SELECT key, the text you typed will continue to scroll down, and if you have enough memory, i }t will even disappear from view off the bottom of the screen. Eventually, though, you'll bump into the upper scr }een. Press and hold the RETURN key, and in a little while the text you typed will scroll off the top of the virt }ual screen, too. Once it does this it has been erased from the Atari's memory and can never be retrieved. To re }turn to the bottom of the virtual screen, press the SHIFT+SELECT keys and hold them down. The screen will scroll } up and bring the cursor back into view. Page 23 Chameleon } User's Guide 6.0.2.2 Horizontal scrolling -- START and SHIFT + START keys }---------------------------------------------------------- Type a sentence (such as, "The quick brown fox jumped over } the...") until you reach the right-hand side of the line. If you continue to type, you'll notice the cursor has }become an arrow pointing right, off the edge of the screen, toward where the next character should display. Pres }s the START key and watch the characters scroll leftward, until the screen is blank and the cursor has changed ba }ck into a small square on the left-hand edge of the screen. You've just used the START key to scroll, character- }by- character, to the rightmost 40 columns of the 80-column display. To return to the first 40 columns, press SH }IFT+START. You can use START and SHIFT+START to center the cursor on whatever column you wish. When the cursor }is positioned in its true location, it displays as a square. When it is located in a screen area other than its }true location (i.e., in the previous page buffer or on columns across the screen), it displays as an arrow pointing } towards its true position. 6.0.2.3 Combining vertical and horizontal scrolling ------------------------ }--------------------------- You can use the SELECT and SHIFT+SELECT keys and the START and SHIFT+START keys to p }osition yourself anywhere on the virtual screen. If characters are typed by you or sent by the remote computer w }hile the cursor is off the screen, they will be displayed in the correct spot, but you won't see them until you r }eturn to the portion of the screen that contains the cursor. 6.0.2.4 Locking the Cursor for Faster Data Entry } ------------------------------------------------ Set the CURSOR item of the menu to ON SCREEN. This causes }Chameleon to keep the cursor on the screen at all times. If characters sent to the screen would cause the cursor to mo }ve off the screen, Chameleon will scroll automatically to keep the cursor square on the screen. This feature is }useful when you have a lot of information to type in. You can type faster when Chameleon keeps track of the curs }or on the screen, because you won't have to stop every few words to reposition the cursor with the START and SHIF }T+START keys. For long printouts, many people prefer to control scrolling themselves (CURSOR LOCK OFF), since th }em can them move the screen around to read the text at their own reading rate as well as back up to reread a sect }ion. Page 24 Chameleon User's } Guide 6.0.2.5 File Transfer Protocol and the Virtual Screen ------------------------------------------ }----------- All the file transfer protocols except Snapshot work more smoothly when there is a large amount of m }emory to buffer text. When File Transfer Protocol is set to any of these modes the virtual screen is reduced to 2 }4 lines (the height of the actual screen). When the File Transfer Protocol is set to None or Snapshot, Chameleon } does not need to buffer text, and so the virtual screen again expands to fill all of the memory. 6.0.2.6 }When is the Virtual Screen Cleared? ------------------------------------------- The virtual screen is cleared of } all the text it contains whenever its size or shape is altered. In particular the screen will clear if: } - you change from one the the buffered File Transfer Protocol modes to one of the unbuffered File Trans }fer Protocol modes - you change the baud rate - you change the Line Length The most important case }where the virtual screen will NOT clear is when you change File Transfer Protocol from None to Snapshot, which ma }kes it easy to copy a portion of your virtual screen to file. 6.0.3 System Reset and Break Keys ---- }----------------------------- If you press the SYSTEM RESET key, you'll have to power-cycle your Atari to regain } control. Chameleon has disabled the computer console's BREAK key in menu or terminal mode because it's so easy }to press mistakenly and because the interface module software would stop sending data in that case. When a } file I/O is in progress (for example, when you're entering or leaving menu mode, or during File Transfer Protocol mode }), you can use the 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 co }mputer-- to tell it to stop sending data. To do so, press the SHIFT+Atari keys. Each time you press these keys, Chamel }eon will send a half-second of BREAK signal to the other computer. Page 25 } Chameleon User's Guide } Page 26 Guide A7K8P?@     Y`  Y0 l `7L 䙣ލ}Ȏ!"` !"H h`lDD SAB.YALPSID:D"NUR䙣ލ m Z[/ABBELIFNTOTBLRLINLHALMAOUSCREELTWAIdA7} @ @` @ @r @f@3@s&}Ad##*****************************n##* NOVATARI DOCUMENT *x##* DISPLAY PROGRAM *##* }BY JOE WATERS *##* JULY, 1985 *##***************************** ADISPLAY TITL }E A DISPLAY DOCUMENT##*****************************CHECK FOR KEYPRESSAdAU"!}F:Ad,"AU" A0AdAU$##*****************************SEND LINES TO PRINTERB:"},"6.  @"$'##*****************************,SPLIT B$ INTO TWO LINES6 6-@   (#} AJ-&6@T7<,0  A`^' Ah r6-%@ A |!(7@<$},!(7%@,"F:Ad,AU" A$##*****************************READ DOCUMENT FILE +%}AR@ A` @@-@@ A A`&} -%@@ A@ A` AB:," A&.-@'}B:,!7<,0 $'. A0 :( AD 6.7,6-B:,N AX b&-%@@f(}&@l A@v A`  AP@$##*****************************JJW)}RITE TITLE / MODIFIED FOR GAG BY ED KALUSH+@%@+-@+(@GE*}NESEE )-@@)(@ATARI )-@@)(@GROUP ,-@@,(@ +}Ӡ,-@@,(@ chameleon4-@@4(@terminal emulator0-@@ ,}0(@ -@A &&;@,;A,;@8, 6.ΠҧӠ-}6.D1:CHEMUSER.DOC 6-@6-@` 6-@*6-@r4 6-&>6-P:'@,H6-@8.}&R-@A \ +AR@f+'-P:+@@&B:,,'@,@+(p_(_(TThe doc/}umentation for this file is formatted for a standard 80-column printer.zR(R(GYou can, however, view the documen- 0} tation on the if you wish.c(c(XWould you like to display the docu- mentation file on the or on the 1}?((Enter OR : 0#@@K:0)@@(>:,4S)>:,4P(>:2},( A `i%2A@@9-@@= _2i A &6-3}>:,4S&6-@ ApI+@%@/0@@@I0@64}-@1-1(@1) TURN INTERFACE ON0-@%@0(@ (IF NEEDED)U-%@5}U(@02) POSITION PRINT HEAD AT TOP OF PAGE.7-%@ 7(@3) TURN PRINTER OND6}-%@D(@4) PRESS ANY KEY TO START A$ +AR@. A8#7}#@@P:B A L'-@@'( CHECK PRINTERV-@@` `'-@8}@'( ˠj-@@` t@~ B ApI+@%@/0@@9}@I0@6-@-##(@DOCUMENTATION WILL##(@BE SCRO:}LLED ACROSS(@ YOUR SCREEN. (@ !!(@TO STOP OR START!!(@SCROLLING, PRESS;}((@ANY KEY.((@ $$(@ź YOU CANNOT GO!!(@BACKWARDS, ONLY %(@<} FORWARDS.%(@ !!(@press any key to(@ to start now. A($ D:DISPLAY.BAS=}D1:CHEMUSER.DOC now. press any key to(@ to start now. A($ D:DISPLAY.BAS