Garbo

home *** CD-ROM | disk | FTP | other *** search

/ Garbo / Garbo.cdr / pc / termprog / tm301_3.zoo / telemate.doc next >

Wrap

Text File | 1992-01-03 | 197.9 KB | 4,674 lines

====== Telemate 3.01 ============================== Order Form ====== Please send cheque or money order payable to "White River Software" in US or CAD. Overseas order in money order, please. (Note that the current postage from US to Canada is $0.40.) White River Software P.O.Box 938, Unit 105 St. Catharines, Ontario L2R 6Z4 Canada --------------------------------------------------------------------- Qty. Item US/CAD Amount ___ Telemate Registration in 5.25 disk @ $45/$50 $________ (with registered version and document on disk) ___ Telemate Registration in 3.5 disk @ $45/$50 $________ (with registered version and document on disk) Less ___% discount for over 10 registrations $(______) Shipping and handling outside US and Canada @ $4 $________ Subtotal $________ Ontario orders please add Prov. Sales Tax (8%) $________ Canadian orders please add Goods & Services Tax (7%) $________ Total US$________/CAD$________ Signature ______________________________ Name ____________________________________________________________ Address ____________________________________________________________ ____________________________________________________________ Country _____________________ Phone (______)_____________________ Where did you first hear about Telemate ? ___________________________ Comments ____________________________________________________________ _____________________________________________________________________ ===================================================================== ▌█████████ ▌██████ ▌█▌ ▌██████ ▌█████████▌ ▌███████▌ ▌█████████ ▌██████ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█████▌ ▌█▌ ▌█████▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌▌████▌ ▌█▌ ▌█████▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌██████ ▌██████ ▌██████ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌██████ Version 3.01 By Tsung Hu, White River Software Documentation By Allan Smith Copyright (c) 1988-1992 White River Software. All rights reserved. TELEMATE 3.01 TABLE OF CONTENTS i TABLE OF CONTENTS INTRODUCTION 1 What's Special? . . . . . . . . . . . . . . . . . . . . . . . . 1 REGISTRATION 2 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Multi-user License . . . . . . . . . . . . . . . . . . . . . . 3 International Edition . . . . . . . . . . . . . . . . . . . . . 3 Evaluation Diskettes . . . . . . . . . . . . . . . . . . . . . 3 Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . 3 GETTING STARTED 4 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 4 Installing Telemate on a Floppy Disk System . . . . . . . . . . 4 Installing Telemate on a Hard Disk System . . . . . . . . . . . 4 THE INSTALLATION PROGRAM 6 Com Parameter . . . . . . . . . . . . . . . . . . . . . . . . . 6 Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Alarm Song . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Window Displays . . . . . . . . . . . . . . . . . . . . . . . . 12 Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Back Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Selecting Colors . . . . . . . . . . . . . . . . . . . . . . . 13 Ending your installation . . . . . . . . . . . . . . . . . . . 13 EXECUTING TELEMATE 14 Executing Telemate on a Dual 360K Floppy Disk System . . . . . 14 Executing Telemate on a 720K or 1.2M Floppy Disk System . . . . 15 Executing Telemate on a Hard Disk System . . . . . . . . . . . 15 Command Line Options . . . . . . . . . . . . . . . . . . . . . 15 Terminal Option /T . . . . . . . . . . . . . . . . . . 15 Already Online Option /O . . . . . . . . . . . . . . . . . . 15 No Init Option /N . . . . . . . . . . . . . . . . . . 16 Auto Dial Option /D . . . . . . . . . . . . . . . . . . 16 Full Screen Option /F [Alt -] . . . . . . . . . . . . . . 16 Load Phone Directory /= . . . . . . . . . . . . . . . . . . 16 Auto Script . . . . . . . . . . . . . . . . . . . . . . . . 16 IF YOU HAVE A MOUSE 17 Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Three Button Mice . . . . . . . . . . . . . . . . . . . . . . . 17 Two Button Mice . . . . . . . . . . . . . . . . . . . . . . . . 17 The Window Borders . . . . . . . . . . . . . . . . . . . . . . 18 The Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . 18 TELEMATE 3.01 TABLE OF CONTENTS ii USING TELEMATE'S WINDOWS [Alt W] 19 Starting a Window . . . . . . . . . . . . . . . . . . . . . . . 19 Selecting a Window . . . . . . . . . . . . . . . . . . . . . . 19 Pull Down Menus . . . . . . . . . . . . . . . . . . . . . . . . 19 Zooming a Window . . . [Alt Z] . . . . . . . . . . . . . . . . 19 Moving a Window . . . . . . . . . . . . . . . . . . . . . . . . 19 Resizing a Window . . . . . . . . . . . . . . . . . . . . . . . 20 Closing a Window . . . . . . . . . . . . . . . . . . . . . . . 20 GETTING HELP WHEN YOU NEED IT 21 SYSTEM FUNCTIONS 22 DOS Command . . . . . . [Alt R] . . . . . . . . . . . . . . . . 22 Jumping to DOS . . . . [Alt J] . . . . . . . . . . . . . . . . 23 File Directory . . . . [Alt F] . . . . . . . . . . . . . . . . 23 Clipboard . . . . . . . [Alt K] . . . . . . . . . . . . . . . . 24 Printing a file . . . . . . . . . . . . . . . . . . . . . . . . 24 Ending Telemate session [Alt X] . . . . . . . . . . . . . . . . 24 THE DIAL WINDOW [Alt D] 25 Directory Functions . . . . . . . . . . . . . . . . . . . . . . 25 Dialing Functions . . . . . . . . . . . . . . . . . . . . . . . 26 The Dial Menu . . . . . . . . . . . . . . . . . . . . . . . . . 26 Save Dial List . . . . [F2] . . . . . . . . . . . . . . . . . 26 Load Phone Directory . [F3] . . . . . . . . . . . . . . . . . 27 Find . . . . . . . . . [F4] . . . . . . . . . . . . . . . . . 27 Next . . . . . . . . . [F5] . . . . . . . . . . . . . . . . . 27 Edit . . . . . . . . . [F6] . . . . . . . . . . . . . . . . . 27 Goto . . . . . . . . . [F7] . . . . . . . . . . . . . . . . . 27 Manual Dial . . . . . . [F8] . . . . . . . . . . . . . . . . . 27 Revise Script . . . . . [F9] . . . . . . . . . . . . . . . . . 27 Append Entries . . . . [F10] . . . . . . . . . . . . . . . . . 27 Remove Entry . . . . . . . . . . . . . . . . . . . . . . . . . 27 Hang Up . . . . . . . . [Alt H] . . . . . . . . . . . . . . . . 27 Learn Script . . . . . [Alt N] . . . . . . . . . . . . . . . . 28 Phone Entry Dialog . . . . . . . . . . . . . . . . . . . . . . 28 THE TERMINAL WINDOW [Alt T] 32 The Terminal Menu . . . . . . . . . . . . . . . . . . . . . . . 32 Sending files . . . . . [Page Up] . . . . . . . . . . . . . . . 32 The Protocol Menu . . . . . . . . . . . . . . . . . . . . . . . 32 The File Input Box . . . . . . . . . . . . . . . . . . . . . . 33 The File Transfer Window . . . . . . . . . . . . . . . . . . . 33 Receiving Files . . . . [Page Down] . . . . . . . . . . . . . . 33 Logging Sessions . . . [Alt L] . . . . . . . . . . . . . . . . 33 Using Scripts . . . . . [Alt S] . . . . . . . . . . . . . . . . 34 Learning Script . . . . [Alt N] . . . . . . . . . . . . . . . . 34 Pasting . . . . . . . . [Alt P] . . . . . . . . . . . . . . . . 34 Quoting . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 34 Image Files . . . . . . [Alt I] . . . . . . . . . . . . . . . . 35 Command Stack . . . . . [Alt Y] . . . . . . . . . . . . . . . . 35 TELEMATE 3.01 TABLE OF CONTENTS iii Chat Mode . . . . . . . [Alt C] . . . . . . . . . . . . . . . . 35 Originate Mode . . . . [Alt G] . . . . . . . . . . . . . . . . 36 Answer Mode . . . . . . [Alt A] . . . . . . . . . . . . . . . . 36 Doorway Mode . . . . . [Alt =] . . . . . . . . . . . . . . . . 36 Hang Up . . . . . . . . [Alt H] . . . . . . . . . . . . . . . . 36 Clear Text . . . . . . [Ctrl Home] . . . . . . . . . . . . . . 36 Break Signal . . . . . [Ctrl End] . . . . . . . . . . . . . . 36 Printer Log . . . . . . [Ctrl PrtSc] . . . . . . . . . . . . . 36 THE EDIT WINDOW [Alt E] 37 Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Moving Around . . . . . . . . . . . . . . . . . . . . . . . . . 37 Deleting Text . . . . . . . . . . . . . . . . . . . . . . . . . 37 CUA Conventions . . . . . . . . . . . . . . . . . . . . . . . . 38 Wordstar Conventions . . . . . . . . . . . . . . . . . . . . . 38 Margins . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 The Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . 39 Mark . . . . . . . . . [F10] . . . . . . . . . . . . . . . . . 39 Copy . . . . . . . . . [Alt C] [Shift Alt C] . . . . . . . . . 39 cUt . . . . . . . . . [Alt U] [Shift Alt U] . . . . . . . . . 39 Tag . . . . . . . . . [Alt G] [Shift Alt G] . . . . . . . . . 40 Paste . . . . . . . . . [Alt P] . . . . . . . . . . . . . . . . 40 Quote . . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 40 Write . . . . . . . . . [Alt A] . . . . . . . . . . . . . . . . 40 New . . . . . . . . . . [Alt N] . . . . . . . . . . . . . . . . 40 Saving Files . . . . . [F2] . . . . . . . . . . . . . . . . . 40 Loading Files . . . . . [F3] . . . . . . . . . . . . . . . . . 40 Find . . . . . . . . . [F4] . . . . . . . . . . . . . . . . . 41 Next . . . . . . . . . [F5] . . . . . . . . . . . . . . . . . 41 Replace . . . . . . . . [F6] . . . . . . . . . . . . . . . . . 41 Goto . . . . . . . . . [F7] . . . . . . . . . . . . . . . . . 41 Filter . . . . . . . . [F8] . . . . . . . . . . . . . . . . . 41 Reformat . . . . . . . [F9] . . . . . . . . . . . . . . . . . 41 Auto Indent . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Backup Source . . . . . . . . . . . . . . . . . . . . . . . . . 41 Macro Keys . . . . . . . . . . . . . . . . . . . . . . . . . . 42 THE VIEW WINDOW [Alt V] 43 The View Menu . . . . . . . . . . . . . . . . . . . . . . . . . 43 Quote . . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 43 THE BACK WINDOW [Alt B] [Center] [Ctrl Up]/[Ctrl Down] 44 The Back Scroll Menu . . . . . . . . . . . . . . . . . . . . . 44 Write . . . . . . . . . [Alt A] . . . . . . . . . . . . . . . . 44 Quote . . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 45 Scroll Lock . . . . . . [Scroll Lock] . . . . . . . . . . . . . 45 Capture . . . . . . . . [Ins] . . . . . . . . . . . . . . . . . 45 Clear . . . . . . . . . [Alt N] . . . . . . . . . . . . . . . . 45 TELEMATE 3.01 TABLE OF CONTENTS iv THE MACRO WINDOW [Alt M] 46 The Macro Table . . . . . . . . . . . . . . . . . . . . . . . . 46 The Keypad Table . . . . . . . . . . . . . . . . . . . . . . . 46 The Alt-Keypad Table . . . . . . . . . . . . . . . . . . . . . 46 The Keyboard Table . . . . . . . . . . . . . . . . . . . . . . 46 The Macro Window . . . . . . . . . . . . . . . . . . . . . . . 47 The Macro Menu . . . . . . . . . . . . . . . . . . . . . . . . 47 Defining Macros . . . . . . . . . . . . . . . . . . . . . . . . 48 Macro Symbols . . . . . . . . . . . . . . . . . . . . . . . . . 48 The '^-' Keystroke Simulation Macro Symbol . . . . . . . . . . 49 The '^=' Hot Key Macro Symbol . . . . . . . . . . . . . . . . . 50 The '^\' Run Script Macro Symbol . . . . . . . . . . . . . . . 51 Redefining the Keyboard . . . . . . . . . . . . . . . . . . . . 51 Loading and Saving Macros, Keypads and Keyboard . . . . . . . . 51 THE OPTION DIALOGS [Alt O] 52 The Options Menu . . . . . . . . . . . . . . . . . . . . . . . 52 Saving and Loading Options . . . . . . . . . . . . . . . . . . 53 Saving Windows . . . . . . . . . . . . . . . . . . . . . . . . 53 How to Make Changes . . . . . . . . . . . . . . . . . . . . . . 53 General Options . . . . . . . . . . . . . . . . . . . . . . . . 54 Mouse & Keyboard Options . . . . . . . . . . . . . . . . . . . 57 Dial Options . . . . . . . . . . . . . . . . . . . . . . . . . 57 Directories and files . . . . . . . . . . . . . . . . . . . . . 59 Terminal Options . . . . . . . . . . . . . . . . . . . . . . . 60 Communication Options . . . . . . . . . . . . . . . . . . . . . 62 Protocol Options . . . . . . . . . . . . . . . . . . . . . . . 63 External Protocol Options . . . . . . . . . . . . . . . . . . . 64 APPENDIX A: KEYBOARD SCAN CODE 66 APPENDIX B: KEYBOARD ASSIGNMENT IN TERMINAL EMULATIONS 67 APPENDIX C: FILE TRANSFER PROTOCOLS 69 APPENDIX D: DEFINING EXTERNAL PROTOCOLS 71 APPENDIX E: USAGE LOG 72 APPENDIX F: THE PHONE DIRECTORY 73 APPENDIX G: MEMORY MANAGEMENT 74 How Telemate uses EMS and XMS . . . . . . . . . . . . . . . . . 74 How Telemate uses EGA/VGA video RAM . . . . . . . . . . . . . . 74 Optimizing Memory Usage . . . . . . . . . . . . . . . . . . . . 75 Running under DOS 5.0 . . . . . . . . . . . . . . . . . . . . . 76 Running under QEMM386.SYS . . . . . . . . . . . . . . . . . . . 76 Running under DESQView/386 . . . . . . . . . . . . . . . . . . 77 Running under Windows 386 Enhanced Mode . . . . . . . . . . . . 77 APPENDIX H: ERROR MESSAGES 79 APPENDIX I: TELEMATE SUPPORT BBS 80 INDEX 81 TELEMATE 3.01 INTRODUCTION 1 INTRODUCTION In the past, I have used several communication packages but I was not satisfied. Each one lacked basic features which I considered essential to telecommunications, so I decided to write my own one. I hope that you find Telemate useful and support it. What's Special? Integrated Environment: Telemate is much more than a communication program; it is a full featured and flexible communication program with an easy-to-learn and easy-to-use integrated environment. With Telemate, you don't need to use a separate editor, viewer and mouse driver to make a smooth communication. All these features are built into Telemate and they are all accessible through the menus and windows. Multithreading: Telemate has multithreading (or internal multi- tasking) built-in. While you are dialing or downloading, you can prepare messages, view files, scroll back to the last connection. Or you can have all of them at the same time, each clearly runs in its own window. Mouse support: While the other communication programs still require a mouse-menu TSR to emulate their function keys, Telemate considers the mouse as an input device from the very beginning and, therefore, designs an environment suitable for both mouse and keyboard. Built-in Editor and Viewer: The editor allows you to prepare your messages, edit documents or type letters. And the viewer can display files as references without influencing the editor. Back Scroll: The very large back scroll buffer works just like an editor, you can save parts of the content to files, find text, tag filenames and even quote a message by pressing several keys. Clipboard: Through the clipboard, you can cut and paste text among windows. You can prepare a message in the editor and then copy and paste it to the terminal or you can tag file names from the back scroll buffer and paste it to the terminal. Protocols: Telemate has the most popular protocols built-in, including Zmodem, Ymodem-G, Xmodem, Kermit and CompuServe QuickB. And there are eight slots for external protocols. Easy-to-learn Script Language: Writing a Telemate script program is as simple as writing a BASIC program. If you don't have any experience on programming, the Learn Script mode can generate script files for you. Enhanced Video support: Without any additional hardware, Telemate lets you select a screen height from 25 to 32 lines on your normal CGA adapter and 7 choices of screen height on an EGA or VGA adapter. TELEMATE 3.01 REGISTRATION 2 REGISTRATION Telemate is not free. You must register after the 30-day evaluation period. Telemate is a Shareware product. It is distributed through public access channels so that perspective buyers can have the opportunity to evaluate the product before making a decision to buy. If you decide to use this software, then you are under both legal and moral obligation to register it with the author. But if you decide not to use it after evaluating the software, you are under no obligation. It is fully protected by State, Federal and International copyright laws. If you continue to use Telemate after the 30-day evaluation period you must register it. Registration Fee : $ 45.0 US or $ 50.0 CAD To register your copy of Telemate, fill in the order form and mail along with your cheque or money order in US or CAD to the address indicated in the form. Because of the high service charge by the bank to collect cheque from overseas, we only accept overseas order with international money order. When you register, you will receive the program diskettes of the current version with your registration number on it. Registration entitles you continue using the current version and all future versions. The registration number will remove any annoying functions in the un-registered version of the current and the future releases. As a registered user, you can write to us or call the support BBS's if you have questions or problems. We appreciate suggestions and ideas; most new Telemate features come from user feedback. License You are free to copy and distribute Telemate for NON-COMMERCIAL use IF: NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION, AND IT IS NOT MODIFIED IN ANY WAY. Computer user groups or clubs may make copies of Telemate for distribution to members for a fee that covers copying and other administrative costs. Bulletin Board Systems (BBS) that operate through subscription fees may post Telemate for download by its subscribers. Shareware distributors may distribute Telemate, which includes the utility programs and the documents, for a fee under US$8 which covers copying and other administrative costs. Otherwise, distributors have to obtain a written permission from the author. TELEMATE 3.01 REGISTRATION 3 Multi-user License Telemate offers multi-user licenses to schools, companies and associations. Orders for 10 or less users include the same amount of Telemate programs on disk. For orders of 11 or more users, a master copy of Telemate is provided and the licensee is responsible for copying the disks. The price are as follows: Number of Users: Price (US) Discount 1 - 10 @ $ 45 (no discount) 11 - 20 @ $ 40 10 % 21 - 50 @ $ 36 20 % 51 - 100 @ $ 31 30 % 101 - 200 @ $ 22 50 % 200+ $ 6500 (one time fee) International Editions Telemate is also available in German and other European languages from our dealer in German. Please call MicroServe GmbH for details. MicroServe GmbH Postfach 1368 2804 Lilienthal Germany Tel: +49 (04298)30 557, Fax: +49 (04298)30 558 BBS: +49 (04298)30 086 Evaluation Diskettes Telemate is distributed on three diskettes which contain the current version of Telemate and its companion utility programs. These diskettes are available for US$8/CAD$9 per copy. This fee covers the cost of postage, diskettes, and handling but does not include registration. Disclaimer This program is provided AS IS without any warranty, expressed or implied, including but not limited to fitness for a particular use. Trademarks Telemate is a trademark of White River Software. Many specific products found in this manual are trademarks of specific companies. TELEMATE 3.01 GETTING STARTED 4 GETTING STARTED Requirements Telemate requires an IBM PC/AT/fully compatible computer, PC-DOS or MS-DOS version 3.01 or greater, a minimum of 500K of memory and a modem. (Actually a modem is optional. Telemate can be used to connect two computers directly via a cable or a null modem.) Optional: Telemate makes full use of a mouse if present and run on Monochrome, CGA, EGA or VGA systems. Up to 8M expanded memory (EMS 3.2 or up) and 8M extended memory with XMS driver is supported. IMPORTANT: Before doing anything else MAKE A COPY of the disk containing the Telemate program. Store the original copy in a safe place and use the copy as your working diskette. Installing Telemate on a Floppy Disk System Installation for floppy disk system is simple. You should unpack the package to different diskettes. And 1) Put Telemate disk #1 in drive A 2) Type TMINST and press [Enter] to run the installation program. Installing Telemate on a Hard Disk System To install Telemate on your hard disk please execute the following steps: 1) Check to be sure you are logged on the C drive and on the root directory. To be sure you're at the root directory type CD \. 2) Make a subdirectory for the Telemate files by typing MD \TM. If you already have a directory you wish to contain the program, skip this step and change to that directory. 3) Change to the Telemate directory by typing CD \TM . 4) Place the Telemate disk #1 in drive A and copy the Telemate files to this directory by typing COPY A:\*.* C:\TM 5) Place the disk #2 in drive A and copy the Telemate files to this directory by typing COPY A:\*.* C:\TM 6) Place the disk #3 in drive A and copy the Telemate files to this directory by typing COPY A:\*.* C:\TM 7) Remove the disk in drive A and type CD \TM to go to the Telemate directory. 8) To start the installation program type TMINST and press [Enter]. TELEMATE 3.01 GETTING STARTED 5 Moreover, adding the line SET TMCFG=C:\TM\TM.CFG in your AUTOEXEC.BAT batch file will help Telemate to locate the configuration file so that you can run Telemate from any directory or from a menu system. If your COMMAND.COM is not located in the root directory, you should also include the line SET COMSPEC=C:\DOS\COMMAND.COM in AUTOEXEC.BAT, assuming COMMAND.COM is in C:\DOS directory. TELEMATE 3.01 THE INSTALLATION PROGRAM 6 THE INSTALLATION PROGRAM The installation program, TMINST.EXE, creates the configuration file TM.CFG and the phone directory TM.FON. Some options must be defined before you run Telemate, for example, the memory usage and the window colors. Some options can be defined in the Option dialogs inside Telemate. When you first run TM.EXE, it will automatically chain to TMINST.EXE such that you can select the options. If you want to change some options later, you can run TMINST.EXE separately. Once you have started the installation program the following will appear on your screen. ┌─── Main Menu ────┐ │ COM Parameter │ │ Display │ │ Mouse │ Telemate Installation Program │ Printer │ │ Memory │ Version 3.01 │ Alarm Song │ │ Menu Bar │ Copyright (c) 1988-1992, White River Software │ Menu │ │ Help Window │ All rights reserved. │ Dial Window │ │ Terminal Window │ │ Transfer Window │ │ Edit Window │ │ View Window │ │ Back Window │ │ Macro Window │ │ Stack Window │ │ Dos Window │ │ Option Dialog │ │ End Installation │ └──────────────────┘ Com Parameter ┌── COM Para ──┐ │ COM Port │ When you select "Com Parameter", a second │ Baud Rate │ menu appears for you to install Telemate │ Parity │ to work with your equipment. │ Data Bits │ │ Stop Bits │ │ Dial Prefix │ │ Dial Suffix │ │ Protocol │ │ Flow Control │ │ Base Address │ │ Interrupt │ │ IRQ │ └──────────────┘ TELEMATE 3.01 THE INSTALLATION PROGRAM 7 Com Port ┌───────┐ │ COM 1 │ Telemate supports the use of up to 8 COM │ COM 2 │ ports. Most users have their modems │ COM 3 │ connected to COM1 or COM2. │ COM 4 │ │ COM 5 │ You should refer to the computer and modem │ COM 6 │ document for the COM port you are using. │ COM 7 │ If later you find out it is a wrong setup, │ COM 8 │ you can run TMINST.EXE again to change it. └───────┘ Baud Rate ┌────────┐ │ 300 │ Baud rate refers to the speed at which │ 1200 │ communications take place. Check your modem │ 2400 │ manual if you are unsure which speed it is. │ 4800 │ │ 9600 │ Most modems use 2400 baud. High speed modems │ 19200 │ use a baud rate from 9600 to 38400. │ 38400 │ │ 57600 │ If two computers are connected via a cable │ 119200 │ or a null modem, the baud rate can be as └────────┘ high as 119200. Parity ┌───────┐ The vast majority of BBS's are set up for │ None │ no parity with 8 data bits. │ Odd │ │ Even │ Some online services use even parity and │ Space │ 7 data bits. │ Mark │ └───────┘ Data Bits / Stop Bits ┌─────┐ ┌─────┐ Data bits refer to how much data is sent │ 7 │ │ 1 │ before a stop bit is sent. Data is normally │ 8 │ │ 2 │ sent in chunks of 9 bits, 8 data bits and └─────┘ └─────┘ 1 stop bit. Dial Prefixes and Dial Suffixes ┌───────────────┐ │ ATDP │ Dial Prefixes refer to the string Telemate │ ATDT │ sends just prior to dialing a number. │ ATDT 001, │ If you have a pulse phone, (check with your │ ATDT 9, │ phone company if you are not sure) choose └───────────────┘ "ATDP". If you have touch tone phone service, then select "ATDT". Dial Suffixes refer to the signal Telemate sends after the phone number. Usually, it is simply a carriage return "^M". The content of the prefixes and suffixes can be modified in Option/Dial Setup dialog. TELEMATE 3.01 THE INSTALLATION PROGRAM 8 Protocol ┌────────────────┐ │ Zmodem │ Protocol refers to the method Telemate │ Ymodem │ uses to transfer data. This option allows │ Ymodem-G │ you to choose a default protocol, but │ Batch Ymodem │ you can use any of the protocols. The │ Xmodem │ default setting is only your first choice. │ Xmodem-1K │ │ Xmodem Relaxed │ Zmodem is recommanded because it is both │ Telink │ fast and safe. A description of the │ SEAlink │ protocols can be found in the appendix. │ Modem7 │ │ Kermit │ │ CIS Quick B │ │ ASCII │ └────────────────┘ Flow control ┌────────────────┐ XON/XOFF software flow control is usually │ XON/XOFF OFF │ used by networks while the RTS/CTS hardware │ RTS/CTS OFF │ control is used by high speed modems. │ 16550 FIFO ON │ └────────────────┘ If the modem is an error correction modem, such as a MNP modem, RTS/CTS should be ON, XON/XOFF should be off. 16550 FIFO refers to the First In/First Out data buffer of NS16550AN UART chip. If your serial adapter is equipped with the chip, you should turn it ON which prevent data overrun due to disk access or overhead of multitasker. Base Address, Interrupt & IRQ The default setting for COM1 to COM4 is probably suitable for most modems. For details on the setting of your modem, please refer to the modem document. Usually, the interrupt number is the IRQ number plus 8. For example, IRQ5 uses the interrupt number 13. The setting being selected corresponds to the current COM port you selected. You can select different setting for the other COM port by selecting other COM port. If the setting your modem using is not listed in the menu, you can modify the lines: COMx=3f8,12,4 in your configuration file, TM.CFG. The first item is the base address, the second is the interrupt number and the third the IRQ number. TELEMATE 3.01 THE INSTALLATION PROGRAM 9 Displays ┌─── Display ────┐ Telemate supports a variety of video displays. │ Video Type │ You can use Telemate with Mono, CGA, EGA or │ Video Height │ VGA adapters. │ Scroll Bar ON │ │ Snow Check OFF │ Telemate allows you to choose from 4 video │ Date Format │ types: Default determines what adapter you have └────────────────┘ and adjusts accordingly. If you are using a CGA with a black and white monitor, you should chooseB&W to override the color setup. If you are using a laptop, LCD may suit you better. Video Height ┌────────────────┐ Telemate lets you choose from a variety │ 25 │ video heights. Video heights refers to the │ 26 CGA,EGA,VGA │ number of lines of text on your screen. │ 27 CGA,EGA,VGA │ 28 lines is recommended: 1 line for │ 28 CGA,EGA,VGA │ the menu bar, 1 for the bottom status │ 29 CGA │ line and 26 for the text. │ 30 CGA │ │ 31 CGA │ Note: The Terminal window has at least │ 32 CGA │ 24 lines though only 23 lines may be │ 35 EGA,VGA │ visible. The window will be shift up │ 43 EGA,VGA │ or down automatically to adjust to the │ 50 EGA,VGA │ visible region. └────────────────┘ Scroll Bar, Snow Check and Date Format Telemate uses a graphics scroll bar allowing you to scroll through files using a mouse. If you don't plan to use a mouse with Telemate you may wish to turn this feature off. ┌─── Display ────┐ Original CGA display adapters exhibit 'snow' │ Video Type │ while accessing the video memory. In this case, │ Video Height │ the Snow Check option should be ON. Newer │ Scroll Bar ON │ CGA adapters have the problem eliminated and │ Snow Check OFF │ display speed will be improved if this option │ Date Format │ is OFF. Note: This option applies to CGA only. └────────────────┘ Telemate supports 9 date formats which can be divided into 3 group. The first group uses '-' as the separator, the second uses the '/' and the third '.'. These formats should support virtually any countries. Mouse ┌─── Mouse ───┐ Telemate is designed to work intuitively │ Mouse Type │ with a mouse. To insure that Telemate works │ Mouse Port │ properly with your mouse you need to tell │ Mouse Speed │ Telemate what kind of mouse you are using, └─────────────┘ what port it is connect to, and whether you want it accelerated or not. TELEMATE 3.01 THE INSTALLATION PROGRAM 10 Mouse Type ┌──────────────┐ │ None │ Telemate supports two types of mice but │ Mouse System │ almost every mouse emulates one of │ MS Mouse │ these two, and many emulate both. └──────────────┘ Mouse Port ┌───────┐ Mouse port refers to which serial port │ None │ your MouseSystem mouse is connected to. │ COM 1 │ If your mouse is a Microsoft mouse, │ COM 2 │ there is no need to select a port because └───────┘ the mouse driver will take care of that. Mouse Speed ┌────────┐ If you find that the mouse cursor is too │ Fast │ fast, you can slow it down by selecting │ Medium │ the Slow option. On the other hand, │ Slow │ some mice need to speed up, then select └────────┘ the Fast option. Printer ┌───────┐ Telemate supports both the printer port. │ LPT 1 │ Most users have their pointer connected │ LPT 2 │ to LPT 1. └───────┘ Memory If there is extra memory, such as extended memory and/or expanded memory, Telemate will use them to store data and, therefore, reduces the memory requirement of the conventional memory. Please refer to the appendix for description on these memory specifications and details on optimizing the memory usage. ┌─── Memory ────┐ If the Xms Himem options is ON, Telemate will │ Xms Himem ON │ use the 64K in the High Memory Area as if it │ Xms Limit │ is conventional memory. The High Memory Area │ Ems Limit │ is available only if you have more than 1M │ EGA/VGA Ram │ memory and have the XMS driver HIMEM.SYS └───────────────┘ installed. XMS Limit ┌──────┐ You can limit the usage of extended memory by │ 0K │ selecting a lower value. │ 16K │ │ 32K │ If you are not sure how much extended memory │ 48K │ you have, simply select 8M and Telemate will │ 64K │ use as much extended memory as possible. │ 80K │ TELEMATE 3.01 THE INSTALLATION PROGRAM 11 │ 128K │ If you want to specify the XMS limit which is │ 256K │ not listed in this menu you can modify the │ 512K │ line │ 1M │ XmsLimit=8096 │ 2M │ in your configuration file TM.CFG to the │ 4M │ amount of memory you want. │ 8M │ └──────┘ EMS Limit ┌──────┐ Telemate can address up to 8M bytes of EMS │ 0K │ memory. It supports both EMS 3.2 or above. If │ 16K │ you are not sure how much expanded memory you │ 32K │ have, simply select 8M and Telemate will use │ 48K │ as much memory as possible. │ 64K │ │ 80K │ If you want to specify the EMS limit which │ 128K │ is not listed in this menu you can modify │ 256K │ the line │ 512K │ EmsLimit=8096 │ 1M │ in your configuration file TM.CFG to the │ 2M │ the amount of memory you want. Make sure │ 4M │ that the amount is a multiple of 16. │ 8M │ Otherwise, it will be round down to the └──────┘ nearest multiple of 16. EGA/VGA Ram ┌─── Memory ────┐ When Telemate is running in 43 or 50 lines │ Xms Himem ON │ mode about 30K extra memory is required to │ Xms Limit │ store the windows. The best way to obtain │ Ems Limit ┌─────┐ the extra memory is from the EGA/VGA adapter │ EGA/VGA Ram│ 0K │ itself because it has 64K to 512K equipped. └─────────── │ 32K │ │ 64K │ In 32K mode, Telemate will use 8 pages of └─────┘ video memory for video buffer and data storage. In 64K mode, 16 pages of video memory is used. However, it is not compatible with any pop-up memory resident programs because the address of the video buffer is changed. Unless Telemate is in 43 or 50 lines mode and you are very low in memory, the 32K mode should be selected for compatibility. Please refer to the appendix for technique reference. If Telemate is running under Windows, DESQView or in 132 columns mode, this option is forced to 0K automatically in order to maintain compatibility. TELEMATE 3.01 THE INSTALLATION PROGRAM 12 Alarm Song ┌────── Alarm Song ───────┐ If you find that the default │ Play Song ON │ alarm song, buzzer, is too │ Buzzer │ boring or not loud enough │ Adams Family │ you can change it to one of │ Auld Lang Syne │ the songs listed in the alarm │ Beverly Hills Cop │ song menu. │ Beverly Hillbillies │ │ Deck the Halls │ If the first item, Play Song, │ Flight of the Bumblebee │ is turned to ON, the song will │ Folk Song │ be played when you select it. │ I'm A Little Teapot │ If this option is OFF, the │ James Bond Theme │ installation program will │ Jeopardy Theme │ remain silent. │ Leave it to Beaver │ │ London Bridge │ │ Maple Leaf Rag │ │ My Darling Clementine │ │ Ramblin' Wreck │ │ The Entertainer │ │ Violin Sonata #6 │ │ Well-Tempered Clavier │ │ William Tell Overture │ └─────────────────────────┘ Window Displays The remaining options allow you to change the window colors and size. If you have a black and white monitor the only setting that you can change is the Zoom option. If you have a color monitor you can customize the colors of every portion of every window to suit your tastes. We use just one window to illustrate. ┌──── Edit ─────┐ When you select a window to change a small │ Normal Text │ menu appears to allow you to change the colors │ Border │ of the various elements that constitute that │ Marked Text │ window. In the Edit window you can alter the │ Status Line │ color of the normal text, the window border, │ Error Message │ marked text, the status line, and the error │ Zoom OFF │ message. │ Indent OFF │ │ Backup OFF │ The Zoom option lets you select if you want └───────────────┘ the window to be in full size when it is first invoked. Several options are unique to their menu and are described below. Edit Menu If the Indent option is on, the editor will start at Auto-indent mode such that pressing [Enter] will place the cursor at the first non- blank column instead of the beginning of the line. This is useful for programming Telemate scripts as well as the other languages. TELEMATE 3.01 THE INSTALLATION PROGRAM 13 If the Backup option is on, the editor will make a backup copy, with the extension .BAK, of the editing file when the file is being saved. Back Menu If the Scroll Lock option is on, the cursor in the Back window will stay at the previous position when the Back window is being brought to the top of the screen. If this option is off, Telemate will start at the bottom of the Back window instead. If the Capture option is on, incoming data will be put to the back scroll buffer. If you are using floppy system, this option may need to set to off in order to prevent disk access. Selecting Color ┌───── Color Pattern ──────┐ │ │ │ x x x x x x x x │ Of course none of colors │ x x x x x x x x │ or patterns show up on │ x x x x x x x x │ this black & white page, │ x x x x x x x x │ but we hope you get the │ x x x x x x x x │ general idea. │ x x x x x x x x │ │ x x x x x x x x │ A sample window on the │ x x x x x x x x │ the order side shows the │ x x x x x x x x │ actual result of the │┌───┐x x x x x x x │ color. ││ x │x x x x x x x │ │└───┘x x x x x x x │ │ x x x x x x x x │ └──────────────────────────┘ Ending your installation ┌──── End ────┐ │ Save Setup │ The last choice you have to make is whether │ Abort │ to abort or save the changes to the └─────────────┘ configuration file. Your installation is complete; you are now ready to run Telemate. TELEMATE 3.01 EXECUTING TELEMATE 14 EXECUTING TELEMATE Telemate only requires the following files for ANSI-BBS terminal emulation. TM.EXE - Telemate main program TM.OVL - overlay module TM.CFG - configuration file TM.RES - resource file TM.FON - phone directory TM.MEM - memo field (if any) ANSI.MAC - ANSI terminal macro ANSI.PAD - ANSI terminal keypad If you run script files, the following should be included also. TMS.EXE - the script compiler *.SCR - the script you write *.TMS - the compiled script generated by TMS.EXE After the *.TMS is generated, both TMS.EXE and *.SCR can be removed if you do not modify the script at all. Three files may be created in run-time in the virtual memory directory and will be deleted when Telemate exit. It is very important to prepare enough disk space, 128K is suggested, for those files. If the 'Swap to disk' option is on, another 128K is required. TM.VM? - virtual memory in disk TM.SWP - image of the swap partition (in DOS shell) TMCLIP.$$$ - image of clipboard for printing OVRL????.$$$ - image of the Telemate (in Max DOS shell) Executing Telemate on a Dual 360K Floppy Disk System When using a floppy disk system, you should lower the back scroll limit to 50 or 100 such that no disk access is required to capture the back scroll content. Otherwise, the disk access will slow down the operation and may cause lost of data - enabling the XON/XOFF flow control may help preventing data lost. You should define the 'Virtual Memory Directory' to 'A:\' and keep as less files in drive A: as possible. Do not change the disk indicated in the virtual memory directory. A:\ TM.OVL, TM.CFG, TM.FON, TM.MEM, TM.CFG, TM.RES, ANSI.MAC, ANSI.PAD, TMS.EXE, *.SCR, *.TMS B:\ TM.EXE To save disk space, the phone directory should only contain non-empty entries. You could use the phone maintenance program TMPHONE.EXE to delete the empty entries. TELEMATE 3.01 EXECUTING TELEMATE 15 After putting the files in the diskettes, you should 1) Place Telemate disk #1 in A: drive and disk #2 in B: drive. 2) Type B:TM on the DOS command line because the main program TM.EXE is in disk #2. After loading Telemate, you may replace disk #2 with a working disk for downloading, file editing and so on. You should not remove or change the diskette in drive A: because Telemate requires disk space as virtual memory. The overlay module of Telemate is on the diskette too. Caution: Changing the diskette in drive A: may corrupted the file directory of the new diskette. Executing Telemate on a 720 or 1.2M Floppy Disk System Like the 360K floppy disk system, you should make as much space as possible for the virtual memory directory. You may put the TM.EXE in A: since there should be enough memory. The documents should be excluded. If you have only two floppy drive, you should place a blank disk in drive B: and set the 'Virtual Memory Directory' to 'B:\'. Executing Telemate on a Hard Disk System To execute Telemate on a hard disk system 1) Type CD \TM to change to the Telemate directory 2) Type TM on the DOS command line Command Line Options Telemate accepts several command line options. These options tell Telemate to carry out certain commands when the program is loaded. Below is the description of the command line options: Terminal Option /T If the Terminal Option is used, Telemate starts at the Terminal window instead of the Dial window. Already Online Option /O If you have already been online before executing Telemate, you should use 'TM /O' at the DOS prompt to start Telemate. The modem initialization string is not sent. And the current COM port parameters are used. TELEMATE 3.01 EXECUTING TELEMATE 16 No Init Option /N Similar to the '/O' option, except that it uses the COM port parameters in the configuration. Auto Dial Option /D Telemate starts dialing automatically with the saved dial list after sending the modem initialization string. Full Screen Option /F [Alt -] If the Full Screen Option is on, the menu bar is hid. If you are, for example, editing a file and need the extra line, this option gives you back that extra line. Pressing [Alt -] in Telemate toggles the status line and the menu bar. On some foreign keyboards, [Alt +] is the equivalent key. Load Phone Directory /=<.FON phone directory> To load a different phone directory on the command line, the name of the phone directory should be placed after the '/=' command switch. For example, typing "TM /=NEW" will load the NEW.FON and NEW.MEM to the Dial window. Auto Script <.SCR script file> To execute a script file automatically, the name of the script file should be placed after the "TM" on the command line. For example typing "TM host" at the DOS command line starts Telemate in the Host mode. TELEMATE 3.01 IF YOU HAVE A MOUSE 17 IF YOU HAVE A MOUSE We consider both keyboard and mouse as primary input devices. All the function can be easily accessed with a keyboard as well as a mouse. You can fully use Telemate's power and shortcut keys to speed you through all the functions. If, on the other hand, you do have a mouse you will find Telemate extremely easy and fun to use. Telemate can operate with both two button and three button mice and support Microsoft mouse and MouseSystem mouse. To use a MouseSystem compatible mouse with Telemate, simply start the program. There is no need to load a mouse driver for MouseSystem mouse. If your mouse is a Microsoft mouse or compatible,you will need to load your mouse driver program before starting Telemate. Terminology Clicking: refers to depressing the mouse button one time and releasing. Dragging: means to hold the mouse button down and simultaneously move the mouse, thus "dragging" something on screen to a different screen position. Pointing: refers to moving the mouse so that the mouse cursor rests on or "points" at something on screen. Three Button Mice A three button mouse operates in the following manner: The Left Button (the main button): MARK text in the Edit, View, Back windows SELECT in the Dial & Macro windows, and Menus CUT and PASTE text in Terminal window The Middle Button is the [Esc] key. The Right Button: COPY and PASTE text between the other windows and the Terminal window. Two Button Mice If your mouse has only two buttons, the left button is the main button and the right button becomes the [Esc] button. TELEMATE 3.01 IF YOU HAVE A MOUSE 18 The Window Borders In Telemate, the window borders are mouse sensitive. Clicking the main mouse key on the window borders performs various functions: Top Border : Move window Top-Left corner : Close window Top-Right corner : Zoom window Bottom-Right corner : Resize window Bottom Border: Scroll horizontally Right Border: Scroll vertically The Scroll Bar When the scroll bar option is turned on, the top window has an enlarged right side and bottom border, called scroll bars. To scroll vertically with the mouse, point at "scroll box" (the dark box inside the scroll bar); and while holding down the left mouse button drag it to a position in the scroll bar that corresponds to the general location in the file to which you wish to go. The same process can be used to scroll horizontally in a file using the dark box on the bottom scroll bar. To scroll one line or one character at a time, click on the arrows at either end of the scroll bars. To scroll one page at a time, click on the region between the scroll box and the arrows at end of the scroll bar. TELEMATE 3.01 USING THE TELEMATE'S WINDOWS 19 USING THE TELEMATE'S WINDOWS [Alt W] Telemate uses a window system to present various information and perform different functions in different windows. The major windows are listed in the menu bar on the top of the screen. They are: Dial, Terminal, Edit, View, Back and Macro. The time is displayed in the upper right corner. Starting a Window Each major window in Telemate has an accompanying pull down menu. To use a window, simply type the first letter in the name of the window while holding down the [Alt] key. For example, to use the Edit window type [Alt E]. Mouse: With the mouse cursor on the name of the window, clicking the left button also activates the window. Selecting a Window When a window is already on the screen, pressing the [Alt] key and the first letter of the window name moves that window to the top and make it the top window and has the input focus. Mouse: You can select a window by moving the mouse cursor inside the window and clicking. Pull Down Menus Typing the Alt-letter sequence twice brings up the pull down menu for the corresponding window. For example, if you hit the [Alt E] twice, the first strike causes the Edit window to appear, the second brings up the Edit menu. Mouse: With the window open, click on the Window menu a second time and the pull down menu appears. Zooming a Window [Alt Z] Zooming in on a window can be accomplished in two ways. The fastest method is to hit the [Alt Z] key. Immediately the top window fills the screen. Invoking the Window menu by striking [Alt W] and select the Zoom command have the same effect. Mouse: Clicking the mouse on the top right hand corner of the window immediately invokes the Zoom command. Moving a Window When you have more than one window open at a time, one window may cover the other window. If you want to check the information behind the top window, you can move the window to a new position. To move a window, strike the [Alt W] key to call up the Window menu and select the Move command. The window border is highlighted and you can use the cursor keys to move it to where you want it. Then hit [Enter]. TELEMATE 3.01 USING THE TELEMATE'S WINDOWS 20 Mouse: Position the mouse cursor on the top border of the window border. Drag the outline of the window to the position desired and release. The window appears at the new location. Resizing a Window The steps needed to resize a window are similar to moving a Window: invoke the Window menu by hitting [Alt W] then select the Resize command. Again the Window border is highlighted and you can use the cursor keys to resize it. Then strike the [Enter] key. Mouse: Position the mouse cursor on the lower right hand corner of the window border. Drag the outline of the window until the outline is the size you desire, then release. Closing a Window To close a window, simply strike the [Esc] key. Mouse: Hitting the [Esc] button or clicking on the upper left corner of the border close the window. TELEMATE 3.01 GETTING HELP WHEN YOU NEED IT 21 GETTING HELP WHEN YOU NEED IT [F1] Whenever you need Help, press [F1] and a context sensitive help appears on screen. Mouse: Point at the '≡' symbol on the left end of the main menu bar and click. There is usually more help than is visible in the window. Press [PgDn] for more details and [F1] again for the next topic. ╔═══════════════════════════════ Help ═════════════════════════════╗ ║ Line 350 Col 1 Total 501 TM.HLP HELP ║ ║ Back [PgDn] for more, F1 for next topic] ║ ║ ---- ║ ║ Find text . . . . . . . . . . . . . . . . . . . . . . [F4] ║ ║ Repeat last find . . . . . . . . . . . . . . . . . . [F5] ║ ║ Go to a specified line . . . . . . . . . . . . . . . [F7] ║ ║ Filter - strip high bit . . . . . . . . . . . . . . . [F8] ║ ║ Reformat paragraph . . . . . . . . . . . . . . . . . [F9] ║ ║ Mark/Unmark text . . . . . . . . . . . . . . . . . [F10] ║ ║ Copy marked text to clipboard . . . . . . . . . . .[Alt C] ║ ║ Copy marked text to clipboard and delete it . . . .[Alt U] ║ ║ Tag file names to clipboard . . . . . . . . . . . .[Alt G] ║ ║ Write (append) marked text to file . . . . . . . .[Alt A] ║ ║ Delete marked text . . . . . . . . . . . . . . . . [Del] ║ ║ ║ ║ The amount of text the Back Scroll window can handle can ║ ╠══════════════════════════════ Status ════════════════════════════╣ ║ Name: User To User Script: PCBOARD ║ ║ Memo: Telemate support BBS File Log: Off ║ ║ Alarm: File transfer complete Printer Log: On ║ ║ Free Memory:128034 bytes Date: 2-12-1989 Online: 00:11:02 ║ ║ Port: COM1:2400N81,ANSI Time: 4:25:06pm Offline: 00:08:55 ║ ╚══════════════════════════════════════════════════════════════════╝ The lower portion of the Help window is the Status window: Name: Name of the phone directory entry to which you are connected. Memo: The memo of directory entry you have connected. Alarm: The last message displayed in the Alarm dialog. Free Memory: Number of bytes of in free memory. Port: COM port, parameters and terminal emulation. Script: Displays the name of the script file or "Off" if none. File Log: Displays the name of the log file or "Off" if none. Printer Log: "On" if Telemate sending the session to the printer. Date: Today's date . Time: Current time. Online: Time currently online. Offline: Time currently offline. TELEMATE 3.01 SYSTEM FUNCTIONS 22 SYSTEM FUNCTIONS There are several functions that do not belong to any task and have their own window or dialog. DOS Command [Alt R] This is a full screen DOS command function. Several DOS commands can be executed without shelling to DOS and three commands are added. If an external command or a program name is entered, Telemate will shell to DOS, execute it and return as quick as possible. The screen is preserved and shown in the window. This window also stores the last 10 commands. You can recall them by pressing [Up] keys. The [Left] and [Right] keys allow you to edit the command line. ╒═══════════════╤════════════════════════════════════════════════╕ │ Command │ Description │ ├───────────────┼────────────────────────────────────────────────┤ │ A:,B:, .... │ Change drive │ │ CD │ Change directory │ │ CLS │ Clear DOS window │ │ COPY │ Copy files (exclude '+' and /A/B option) │ │ DEL,ERASE │ Delete files │ │ DIR │ Display directory │ │ REN,RENAME │ Rename a file (single file) │ │ TYPE │ Type a file │ ├───────────────┼────────────────────────────────────────────────┤ │ MOVE │ Move files among directories or disk │ │ INS, INSIDE │ Display content of a ZIP, PAK, ARC, LZH, │ │ │ ARJ or ZOO files │ │ ; │ Quick DOS shell (no swapping) │ │ ;command │ Quick execute command (no swapping) │ ╘═══════════════╧════════════════════════════════════════════════╛ The COPY command does not accept parameters such as '/a', '/b' and it does not support CON as a file. The DEL command supports the '/p' options. The DIR command only supports the '/p' and '/w' options. The REN command can only rename one file each time. In case if one or more options are not supported, Telemate will shell to DOS automatically and execute the command. If there is enough memory, no swapping will be performed such that a simple DOS command can be executed as quickly as possible. The INS command accepts '/p' as a parameter which pauses then the screen is full. TELEMATE 3.01 SYSTEM FUNCTIONS 23 ╒═════════════════════╤══════════════════════════════════════════╕ │ Example │ Description │ ├─────────────────────┼──────────────────────────────────────────┤ │ MOVE \DL\*.* \UL │ Different directory │ │ MOVE C:\*.ZIP D:\DL │ Different drive │ ├─────────────────────┼──────────────────────────────────────────┤ │ INS TM*.ZIP │ Search all TM*.ZIP │ │ INS *.ZI? │ Search all *.ZI? files, including │ │ │ xxxxxxxx.ZI1, xxxxxxxx.ZI2, etc. │ │ INSIDE * /P │ Without the extension, it searches all │ │ │ ZIP, PAK, ARC, LZH, ARJ and ZOO files │ │ │ and pauses when the screen is full │ ├─────────────────────┼──────────────────────────────────────────┤ │ ; │ Jump to DOS (no swapping) │ │ ;CHKDSK │ Run CHKDSK (no swapping) │ ├─────────────────────┼──────────────────────────────────────────┤ │ TMPHONE │ Run TMPHONE (swap if options on) │ ╘═════════════════════╧══════════════════════════════════════════╛ Jumping to DOS [Alt J] Pressing [Alt J] lets you jump to a DOS shell. You see the DOS prompt and it is able to execute any DOS command or program. To return to Telemate, type 'EXIT' and press [Enter]. File Directory [Alt F] The File Directory function is also called the File dialog which is used to load or save files. There are two ways to specify the file you want to load: 1) Type the name of the file or directory in the text box, then press [Enter]. 2) Press the [Tab] key to move the cursor to the file list box, then use the arrow keys to move through the list box until the file or the directory you want is highlighted. Press [Enter] to select the file or change to the directory. Mouse: Point at the file name you want to load in the list box, then double click the mouse button. When uploading files, you can select multiple files by pressing [Spacebar] in the file list box. Mouse: For multiple files, point at the file name and click the mouse button while holding down the [Shift] key. When the File dialog appears, the file names and directories are displayed in columns in the list box. You can display all the information of the files, say the size, transfer time, and date and time of the files by turning on the 'Display All Information' option. TELEMATE 3.01 SYSTEM FUNCTIONS 24 Mouse: Point at the check box prompted 'Display All Information' and click the mouse button. [Ctrl Y] clears the File Name box. You may type in the full DOS path and file name. [Ctrl Left] clears the filename partition. Pressing [Ctrl Left] again will clear the preceding directory. [Up Arrow] in the file name box recalls the name of the last file you worked with. Mouse: Clicking the File Name box recalls the names of files too. Clicking on a directory takes you to that directory. Clipboard [Alt K] This command lets you view, print the content of the clipboard or tag the file names inside the clipboard. When the print function is selected, the clipboard content will be saved in a temporary file named TMCLIP.$$$ in the virtual memory directory. Printing Files The Print file function allows you to print a text file while the other tasks are running concurrently. You can select it in the Window menu and choose the name of the file to print. Telemate sends the designated file to the printer. Ending Telemate session [Alt X] To exit Telemate and return to DOS, strike [Alt X] or select the Exit command in the Window menu. TELEMATE 3.01 THE DIAL WINDOW 25 THE DIAL WINDOW [Alt D] When Telemate is first loaded the phone directory appears on the screen unless you override it by the '/T', '/O' or '/N' command line option. The phone directory can hold up to 1000 entries and you can have multiple directories. Default is 100 entries. You could change the size with the phone directory maintenance program TMPHONE.EXE. Directory Functions A phone directory entry consists of: Name, Password, Phone number, Script, Log, Parameters, Total, Last Connect date, and Memo. Not all fields are displayed on the screen. You can press the [Right] or [Left] keys to display other fields. Enter Dial List: Press [Spacebar] to toggle the entry under the dial bar. A check mark is placed at the selected entries. Typing the number corresponding to the directory entry also selects the entry. You may enter more than one choice by separating them by a space. Hit [Enter] to accept this choice and start dialing. [Enter]: The directory entry you previously chose reappears. Hit [Enter] again to redial. To change the entry simply type in the number of the entry you wish to dial. [Left], [Right]: The phone directory is wider than the screen. Hitting the [Left] or [Right] keys show you the portions of the directory not currently on the screen. [Up], [Page Up]; [Down], [Page Down]: Using the up and down arrows you move the dial bar to the previous or next entry. By using the [PgUp] and [PgDn] keys you move through the directory one page at a time. [Home], [End]: These keys take you to the first and last entries, respectively, in the directory. The [Ctrl PgUp] and [Ctrl PgDn] are equivalent to [Home] and [End] respectively. [Esc]: The [Esc] key hides the Dial window. Mouse: Clicking on a directory entry sends that entry to the dial list. Clicking once in the top portion of the Dial window or double clicking an entry will start dialing. Dialing Functions After you have selected the numbers, Telemate starts dialing and the top section of the Dial window lists the following functions: Attempt #: This tells you how many attempts made so far to reach a certain number. You can define the maximum number of attempt that Telemate should perform through the Options/Dial Setup dialog. TELEMATE 3.01 THE DIAL WINDOW 26 Elapsed Time: The first number listed is the amount of time which has elapsed on this attempt. The second number is the amount of time Telemate waits before terminating the attempt. Telemate continues to dial a number until a connection is made or until the process is aborted or the break string is received. You can change the dial time by pressing the [+] or [-] keys. Last Attempt: A message appears in this area which gives the result of the last dialing attempt. [+], [-]: These two keys adjust the the amount of time, in seconds, Telemate waits while attempting to make a connection. [Space]: The [Spacebar] key cancels the current attempt and recycle to the next entry in the dial list. [Esc]: Striking the [Esc] key aborts the dialing process. [Enter]: Hitting [Enter] has the same effect as [Esc] except that the line is not disconnected. This is useful when making voice calls: when the connection is made, you can pick up the phone and hit [Enter]. [Del]: The [Del] key deletes the current entry from the dial list. Mouse: While dialing, a click will perform a recycle function. The Dial Menu In the Dial window, hitting [Alt D] again displays the menu: ╒════════════════════════════╕ │ Save dial list F2 │ │ Load directory F3 │ To invoke one of these │ Find F4 │ functions press the │ Next F5 │ key(s) indicated on the │ Edit F6 │ right side of the menu. │ Goto F7 │ │ Manual dial F8 │ │ Revise script F9 │ │ Append entries F10 │ │ Remove entry │ │ ────────────────────────── │ │ Hang Up Alt-H │ │ Learn script Alt-N │ ╘════════════════════════════╛ Save Dial List [F2] [F2] saves the dial list into the configuration file. Next time you run Telemate, the dial list is restored. This also saves your phone directory window display. For example, if you want Telemate to display the directory password fields in all session, scroll sideways until the password field is visible, then press [F2]. TELEMATE 3.01 THE DIAL WINDOW 27 Load Phone Directory [F3] Telemate allows you to access multiple phone directories using the [F3] key. Find [F4] Selecting this item, you will see the prompt "Find: _". Type in the text you wish to find. The search is case insensitive. It is best to use the [Home] to go to the top of the directory before starting the search. Next [F5] Hitting [F5] finds the next occurrence of the find text. Edit [F6] Selecting the Edit function allows you to modify your phone directory. Pressing [F6] brings the entry under the dial bar to the Phone Entry dialog shown at the end of this section. Goto [F7] When you select this option you are asked "Goto # _". Type in the entry number you wish to see and hit [Enter]. This is very useful for large directories. Typing in "150" quickly takes you to entry #150. Manual Dial [F8] Choosing this option causes the following to appear at the top of the Dial window "Manual Dial: _". Type in the phone number you wish to reach exactly as if you were dialing it from your phone. When you are finished hit [Enter] and Telemate dials the number for you with the current dial prefix and suffix. Revise Script [F9] This function calls the editor to load the link-script in the script field. If the editor is already in use, you will be asked if you want to save the editing file. Append Entries [F10] This function appends 10 entries to the phone directory such that new entries can be added. To add more entries, use the phone maintenance program TMPHONE.EXE. Remove Entry This function clears the entry under the selection bar. Hang Up [Alt H] This function hangs up the phone. TELEMATE 3.01 THE DIAL WINDOW 28 Learn Script [Alt N] Selecting this function will enter the learn script mode using the link-script in the script field. This is identical to the one under the Terminal menu. Telemate will enter learn script mode automatically if the link-script in the script field is not found. Caution: The old script file will be erased. Phone Entry Dialog ┌─────────────────────────────────────────────────────────────────────────┐ │ │ │ Name ______________________________ │ │ Phone ____________________ │ │ Password _______________ Script ________ │ │ Memo ______________________________ Log ________ │ │ │ │ ┌ COM Port ─────┐ ┌ Baud Rate ────┐ ┌ Parity ────┐ ┌ Data Bits ┐ │ │ │ (*) Default │ │ ( ) Default │ │ (*) None │ │ ( ) 7 │ │ │ │ ( ) COM1 │ │ ( ) 300 │ │ ( ) Even │ │ (*) 8 │ │ │ │ ( ) COM2 │ │ ( ) 1200 │ │ ( ) Odd │ └───────────┘ │ │ │ ( ) COM3 │ │ ( ) 2400 │ └────────────┘ ┌ Stop Bits ┐ │ │ │ ( ) COM4 │ │ ( ) 4800 │ │ (*) 1 │ │ │ │ ( ) COM5 │ │ ( ) 9600 │ │ ( ) 2 │ │ │ │ ( ) COM6 │ │ ( ) 19200 │ └───────────┘ │ │ │ ( ) COM7 │ │ (*) 38400 │ ╔═══════════╗ ┌────────┐ │ │ │ ( ) COM8 │ │ ( ) 57600 │ ║ Next Page ║ │ Cancel │ │ │ └───────────────┘ │ ( ) 115200 │ ╚═══════════╝ └────────┘ │ │ └───────────────┘ │ └─────────────────────────────────────────────────────────────────────────┘ For detailed description on using dialog, please refer to the 'How to Make Changes' in the 'THE OPTION DIALOGS' section. Note: You can copy [Alt C] the name and phone number from the Back window and paste [Alt P] it into the corresponding field. Name: Type in the name of the remote system. Phone: Type in the phone number needed to make the connection. If the number has extra information, you can make use of the dial prefix and dial suffix. Password: Telemate helps you keep track of your passwords by making them part of your phone directory. Type in the password you use with the specific BBS. Telemate comes with a special macro '^&' assigned to the [F3] key by default. The '^&' macro symbol refers to the password field in the phone directory and you can send your password to a BBS press [F3]. Memo: This space allows you to enter a reminder to yourself. It can include any information you need, but not longer than 30 characters. TELEMATE 3.01 THE DIAL WINDOW 29 Script: A script is program which Telemate automatically executes once the connection is made. Scripts are useful for automatically logging onto the remote system. You should type in the script file name, without extension. If the script you specified does not exist in the script directory, Telemate will enter Learn Script mode when the connection is made. Log: Telemate allows you to have individual log files for each directory entry. Type in the name of the log file, without the extension. When you open the log file, Telemate appends the incoming text to the file you have designated. Port: Port refers to the communications port to which your modem is attached. Telemate supports up to 8 different ports. If this option is set to 'Default', Telemate will use the current COM port. Baud Rate: Baud rate refers to the speed used to transfer data electronically. If this option is set to 'Default', Telemate will use the current baud rate. Parity: The vast majority of BBS's are set up for no parity. Some online service uses Even parity. Data Bits and Stop Bits: Data bits refers to how many bits of data are sent before a stop bit is sent. Data is normally sent is chunks of 9 bits, 8 data bits and 1 stop bit. When you press [Enter], Telemate takes you to the next option screen. You can press [Esc] to cancel the changes. ┌─────────────────────────────────────────────────────────────────────────┐ │ ┌ Terminal ─────────┐ ┌ Toggles ───────────────┐ ┌ Protocol ──────┐ │ │ │ (*) ANSI │ │ [ ] Add Line Feed │ │ ( ) Zmodem │ │ │ │ ( ) Avatar │ │ [ ] Add Return │ │ ( ) Ymodem │ │ │ │ ( ) Prism │ │ [ ] Auto Log │ │ (*) Ymodem-G │ │ │ │ ( ) TTY │ │ [X] Auto Wrap │ │ ( ) Ymodem-B │ │ │ │ ( ) VT52 │ │ [X] Destructive BS │ │ ( ) Xmodem │ │ │ │ ( ) VT102 │ │ [X] Guess Initial │ │ ( ) Xmodem-R │ │ │ └───────────────────┘ │ [ ] Local Echo │ │ ( ) Xmodem-1K │ │ │ ┌ Connection ───────┐ │ [ ] Long Distance │ │ ( ) Telink │ │ │ │ ( ) BIOS │ │ [ ] Strip High Bit │ │ ( ) SEAlink │ │ │ │ ( ) Computer │ │ (*) Space Between Tag │ │ ( ) Modem7 │ │ │ │ ( ) Fossil │ │ ( ) CR Between Tag │ │ ( ) Kermit │ │ │ │ (*) Modem │ │ ( ) Comma Between Tag │ │ ( ) CIS QB │ │ │ └───────────────────┘ └────────────────────────┘ │ ( ) ASCII │ │ │ ┌ Prefix ┐ ┌ Suffix ┐ └────────────────┘ │ │ │ ( ) 1 │ │ (*) 1 │ │ │ │ (*) 2 │ │ ( ) 2 │ ╔════╗ ┌────────┐ │ │ │ ( ) 3 │ │ ( ) 3 │ ║ OK ║ │ Cancel │ │ │ │ ( ) 4 │ │ ( ) 4 │ ╚════╝ └────────┘ │ │ └────────┘ └────────┘ │ └─────────────────────────────────────────────────────────────────────────┘ TELEMATE 3.01 THE DIAL WINDOW 30 Terminal: Telemate gives you the choice of the six terminal emulations: ANSI, Avatar, Prism, TTY, VT52 and VT102. Connection: Normally, the connection should be Modem. If the COM port is linked to a host computer directly via a cable, then you should select Computer; Telemate will not check the carrier signal and will assume it is connected and does not dial the phone number. BIOS connection only supports upto 9600 baud but you may experience data lost at 2400 or higher. FOSSIL driver supports upto 38400 baud. If there is any conflict, Telemate will switch to Modem connection. Dial Prefix: Dial prefix is the string to be sent before the phone number. Normally, pulse phone uses a prefix ATDP and touch-tone phone uses ATDT. You can define the content of the prefix and the suffix in the Options/Dial Setup dialog. Dial Suffix: Dial suffix is the string to be sent after the phone number. Usually it is simply a carriage return. But some phone companies offer phone card and required the card number follow the phone number. The card number should be put in the suffix. Add Line Feed: Usually, most BBS's add a line feed automatically at the end of each line of data. If this particular entry does not add line feeds, you can the tell Telemate to add a line feed to the end of each line. Add Return: If this options is on, a carriage return [Ctrl M] is supplied after a line feed is received. Auto Log: If this option is turned on, the log file will be opened automatically once the connection is made and closed when the carrier signal is lost. Auto Wrap: If this option is turned on, after a character reaches column 80, the next character is wrapped to the new line. Otherwise, the cursor stays at column 80. Destructive BS: If this option is on, backspace [Ctrl H] will destroy the character on the left. Otherwise, backspace only moves the cursor to the left. Guess Initial: If this option is turned on, Telemate scans the incoming data and looks for 'From:' or 'Name:' and remember the initials of the following name. If there is any chance that there is a wrong guess, the guessing initial will be emptied. Local Echo: If it is on, the character being typed from the keyboard is displayed on screen. This is sometimes called half duplex. Most BBS's echo the character you typed. This is called full duplex. In this case, you should leave this option off. Otherwise, the character will appear twice on screen. Long Distance: You should turn on this option if the phone is a long distance called. This field will help other utilities, such as TMSTAT.EXE, to analysis your long distance phone bill. TELEMATE 3.01 THE DIAL WINDOW 31 Strip High Bit: If this option is on, the 8th bit of the incoming data will be filter out. This option is very useful when the actual link is 7E1 but you use 8N1 as COM parameter. Space Between Tag: If this is on, space will be used as the tag separator. CR Between Tag: If this is on, carriage return will used as the tag separator. Comma Between Tag: If this is on, comma ',' will used as the tag separator. Protocol: Different BBS's offer different protocols. You should select the one you use most on that BBS as the default protocol. See the appendix for more details on protocols. TELEMATE 3.01 THE TERMINAL WINDOW 32 THE TERMINAL WINDOW [Alt T] The Terminal is the heart of any communications programs. It is where the actual communication with other computers is carried on. The Terminal Menu ╒════════════════════════╕ │ Send PgUp │ │ Receive PgDn │ │ Log session Alt-L │ │ Script Alt-S │ │ learn script Alt-N │ │ ────────────────────── │ │ Paste Alt-P │ │ Quote Alt-Q │ │ Image Alt-I │ │ Command stack Alt-Y │ │ ────────────────────── │ │ Chat mode Alt-C │ │ Originate mode Alt-G │ │ Answer mode Alt-A │ │ Doorway mode Alt-= │ │ ────────────────────── │ │ Hang up Alt-H │ │ Clear text c-Home │ │ Break signal c-End │ │ printer log c-PrtSc │ ╘════════════════════════╛ Sending files [PgUp] After you have made your connection and told the other computer or BBS that you are going to upload a file, choose the send files option from the Terminal menu. You then see the protocol menu: ╒═════════════════════╕ Select the protocol you wish │ Zmodem Z │ to use to send the file(s). │ Ymodem Y │ │ Ymodem-G G │ A brief discussion of the │ Batch Ymodem B │ various types of protocols │ Xmodem X │ and what they do can be found │ Xmodem-1K O │ in the appendix. │ Xmodem Relaxed R │ │ Telink T │ │ SEAlink S │ Note: The 8 external protocols │ Modem7 M │ can be setup in the Options/ │ Kermit K │ External Protocol dialog. │ CIS Quick B C │ │ ASCII A │ ╘═════════════════════╛ TELEMATE 3.01 THE TERMINAL WINDOW 33 The File Input Box ┌────────────────────────────────────────────────────────┐ │ Enter filename(s) to send, [Enter] for directory │ │ │ │ a:\tm300-1.zip b:\tm300-?.zip │ └────────────────────────────────────────────────────────┘ Once you have chosen the protocol you wish to use, you must next enter the name of file(s) you wish to send. Enter the complete DOS path and file name. If you do not include the path, Telemate will search the upload path. If you are not sure of the file, strike [Enter] and a File dialog will appear. In the file list box, you can press [Spacebar] to select multiple files. The File Transfer Window The File Transfer window keeps you informed regarding the progress of an Upload or Download. ╔═════════ Zmodem Upload ══════════╗ ║ ║ ║ File name : SAMPLE.ZIP ║ ║ Bytes to send : 40960 ║ ║ Bytes sent : 27648 ║ ║ Transfer time : 00:05:42 ║ Notes on the ║ Time remaining : 00:02:51 ║ progress of the ║ Error correction : CRC-32 ║ upload and any ║ Number of errors : 1 ║ problems appear ║ Average CPS rate : 125 ║ here -------> ║ > Retry from 1024 ║ ║ ║ ║┌────────────────────────────────┐║ Graphic of upload ║│ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │║ Progress --> ║└────────────────────────────────┘║ ╚══════════════════════════════════╝ Receiving Files [PgDn] To download or receive a file with Telemate you follow much the same procedure as you do when you send files. As in uploading files, a protocol menu appears after you hit [PgDn]. Select the protocol you want to use. If the protocol requires a file name, the File Input Box will appear. Logging Sessions [Alt L] Logging session records the incoming text into a file. If the 'Log Filter' option is enabled, all control codes will be filtered out. If the 'Log Heading' option is turned on, a brief message is inserted to the log file indicating the date and time the log is open. Log file usually uses the extension .LOG. Pressing [Alt L] again closes the log file. TELEMATE 3.01 THE TERMINAL WINDOW 34 Using Scripts [Alt S] A script file is text file containing a series of instructions which usually are some repetitive functions such as a logon script. Script files end with the extension .SCR for the source file, or .TMS for the compiled file. Telemate comes with its own script language. TMSCRIPT.DOC contains a detailed discussion of Telemate's script language. If the compiled script file does not exist or is not up-to-date, Telemate will execute the external program the script compiler, TMS.EXE, to compile the source script to a compiled script. To terminate the script execution, press [Alt S] again. Learning Script [Alt N] If you are not familiar in writing script files, let Telemate write it for you. To learn a script, press [Alt N] and enter a new name. This script name should end in the extension .SCR. Then Telemate remembers the words you typed, automatically generates a script file and stops learning when you press [Alt N] again or when it is offline. The generated file might not perform exactly what you need and need some modifications before it is invoked next time. Pasting and Quoting Telemate allows you to mark and copy text while in the Edit, View and Back windows. Marked text is copied to the clipboard. Once the text is copied to the clipboard, the Terminal window can handle it in either of two ways: Pasting [Alt P] Pasting text sends the content of the clipboard to the remote system. If the expand blank line option is turned on and blank lines are encountered, the blank lines are expanded to lines containing a space. This is very similar to ASCII upload. If you want to send a prepared message to the remote system, you can use this function instead of ASCII upload. Quoting [Alt Q] [Alt Q] functions almost the same as [Alt P]. [Alt Q] is designed for quoting messages into BBS message areas and the quote prefix is added to each line. To quote a message, you should mark the text from the Back window and Copy to the clipboard, then position the cursor where you want the text to go in the remote system and hit [Alt Q]. The quoted message is truncated at the quote margin. If the Initial Guessing option is enabled, the '@' character in the quote prefix is replaced by the initials of the closest name. TELEMATE 3.01 THE TERMINAL WINDOW 35 Image Files [Alt I] You can capture the current screen into a file with this function. Command Stack [Alt Y] The command stack provides a convenient way to recall the previously entered commands or prepare a short note. You can use the command stack in several ways: ╒════════════════╤═══════════════════════════════════════════════╕ │ Usage │ Description │ ├────────────────┼───────────────────────────────────────────────┤ │ Recall command │ It stores the previous commands which you │ │ │ typed in the Terminal window such that you │ │ │ can recall it by pressing [Alt Y] [Up]. │ ├────────────────┼───────────────────────────────────────────────┤ │ Type-ahead │ Some systems are charged by connect time. │ │ │ While you are waiting for a command prompt, │ │ │ you could type the next command here and │ │ │ simply press [Enter] when the prompt appears. │ ├────────────────┼───────────────────────────────────────────────┤ │ Chat mode │ It allows you to type and edit the whole line │ │ │ before sending it to the remote system. │ │ │ That means it is a line based chat mode. │ ├────────────────┼───────────────────────────────────────────────┤ │ Prepare short │ You could prepare a short multi-line message │ │ note │ in this window. See the following example. │ ╘════════════════╧═══════════════════════════════════════════════╛ For example, to write a three-lines note, you could type [Ctrl Home]THIS IS THE FIRST LINE [Ctrl Enter] THIS IS THE SECOND ONE [Ctrl Enter] THIS IS THE LAST ONE [Ctrl Enter] [Up] [Up] [Up] [Enter] [Enter] [Enter] The [Ctrl Home] clears the window and let you start from the top. The [Ctrl Enter] performs a line feed but does not send the line. To send these lines, you could move the cursor to the first line and press [Enter] three times. Copy and Paste functions are allowed in this window. The Copy [Alt C] function copies the current line to the clipboard. The Paste [Alt P] function paste the clipboard text to this window. If there is more than one line in the clipboard, text will be inserted until the cursor reaches the bottom of the window. Chat Mode [Alt C] The chat mode splits the screen for online conversations. Text coming from the remote system appears on the top half of the screen. Characters you type appear on the lower half of the screen and are sent to the remote system immediately. To terminate the chat mode, press [Alt C] again. To edit the line before sending it to the remote system, you should use the Command Stack [Alt Y] function instead. TELEMATE 3.01 THE TERMINAL WINDOW 36 Originate Mode [Alt G] This is the "normal" mode. You use this mode to call a BBS or a remote system. The communication originates from your computer terminal. When you start Telemate, you are in this mode. If you switched to Answer Mode, you should press [Alt G] to switch back to this mode by sending the Modem Init string to the modem. Answer Mode [Alt A] When you select Answer mode you tell Telemate to send the Auto Answer string to the modem which turns on the modem's Auto Answer feature. The modem then answers the phone for you. Pressing [Alt G] returns you to the Originate mode. NOTE: Auto answer is designed to receive calls from other computers. It does not handle voice calls. Doorway Mode [Alt =] When you select Doorway mode, Telemate sends the keyboard scan code when a key is pressed. That means not only the ASCII characters can be sent, but also the function keys and [Alt] keys. For example, if the [Alt T] is pressed, the keyboard scan code is sent to the remote system and the Terminal menu will not be pulled down. To terminate the Doorway mode, you must press [Alt =] again or use your mouse to select the Doorway mode item. The Doorway program requires exactly 25 lines in the Terminal window, you should press [Alt -] to toggle the menu bar and the status line. On some foreign keyboards, [Alt accent '] is equivalent to [Alt =]. Hang Up [Alt H] Pressing [Alt H] hangs up the phone by sending the Modem Hangup string. Including the "^#" macro symbol in the string drops the DTR signal which is the fastest way to hang up the phone. If the Confirm Hang Up option is on, you will be asked if you want to hang up the modem. Clear Text [Ctrl Home] This function clear the screen and reset Telemate to its default colors. Break Signal [Ctrl End] A break is a space between signals on the line. It is often used to get the attention of the remote unit with which you are communicating. Pressing [Ctrl End] sends the break signal through the line to the remote unit. Printer Log [Ctrl PrtSc] This feature sends all of your communication activity to the printer. If you need a written copy of an on screen conversation turning this feature on sends all the communications activity to the printer as it occurs. Pressing [Ctrl PrtSc] a second time turns this feature off. TELEMATE 3.01 THE EDIT WINDOW 37 THE EDIT WINDOW [Alt E] Telemate multithreading ability shines most brightly in the editing area and the backscroll area. You can transfer files in the background while, simultaneously, editing a file in the foreground. To begin editing, press the [Alt E] or click the mouse at the Edit item in the menu bar which brings up the Edit window. Status Line The first line of the Edit window is the Status line. It consists of six items: Line 6 Col 1 Total 74 Insert FEB89.LTR Marking \ / \ / | | | Cursor Location Total # of Mode File Appears by line and lines in indicator Name when column number the file. marking When the editor is in the Insert mode, new characters you enter move text to the right rather than type over old text. Pressing the [Ins] key changes from the Insert to the Overwrite mode. In Overwrite mode, new text type over existing text. When you are in the Overwrite mode the word "Insert" is removed from the status line. Moving Around The following keys can be used to move quickly around the Edit window: Vertical Movement Horizontal Movement [Up] Up one line [Left] Left one space [Down] Down one line [Right] Right one space [PgUp] Up one screen [Ctrl Left] Left one word [PgDn] Down one screen [Ctrl Right] Right one word [Ctrl Home] Top of screen [Home] Beginning of line [Ctrl End] Bottom of screen [End] End of line [Ctrl PgUp] Top of file [Ctrl PgDn] End of file Deleting Text You can delete text in the Edit window in the following ways: [Del] deletes character at the cursor or block [Backspace] deletes character to the left [Ctrl T] deletes word right [Ctrl Y] deletes an entire line [Ctrl Q]+[Ctrl Y] deletes from the cursor to end of line Use the Mark [F10] and the [Del] key to delete larger blocks of text. Telemate will ask you "Do you want to delete the block? (Y/N)". TELEMATE 3.01 THE EDIT WINDOW 38 CUA Conventions Telemate supports the CUA interface which make marking and copying text easier. You can use the [Shift] key in conjunction with the cursor-movement keys to select text. [Ctrl Insert] copies the marked text to the clipboard [Ctrl Del] cuts the marked text to the clipboard [Shift Insert] pastes the marked text from the clipboard Normally, the clipboard will be erased before copying or cutting. If you press [Ctrl Insert] or [Ctrl Del] while holding down the [Shift] key, the clipboard will not be erased and the marked text is appended to the clipboard. Note: The CUA guideline uses [Shift Del] to cut the text but Telemate uses [Ctrl Del] to make it possible to use the [Shift] combo described above. Wordstar Conventions Telemate also supports several Wordstar key combinations into its editor: [^E] Up one line [^S] Left one space [^X] Down one line [^D] Right one space [^R] Up one screen [^A] Left one word [^C] Down one screen [^F] Right one word [^Q^E] Top of screen [^Q^S] Begin of line [^Q^X] Bottom of screen [^Q^D] End of line [^Q^R] Top of file [^Q^F] Find [^Q^C] Bottom of file [^Q^A] Replace [^T] Del word right [^L] Repeat Find/Replace [^Y] Delete line [^Q^Y] Del to End of line Margins The left margin in the Edit window is a fixed margin; it cannot be changed. To change the right margin, go to the Options/General dialog. Telemate performs a word wrap when the characters reach the right margin. When you are writing scripts or programs, you should set the right margin to a larger value, say 200, to prevent word wrap. TELEMATE 3.01 THE EDIT WINDOW 39 The Edit Menu ╒═════════════════╕ │ Mark F10 │ The functions are available through the │ Copy Alt-C │ Edit menu or the shortcut keys. To access │ cUt Alt-U │ the menu, press [Alt E] a second time. │ Tag Alt-G │ │ Paste Alt-P │ │ Quote Alt-Q │ │ Write Alt-A │ │ ─────────────── │ │ New Alt-N │ │ Save F2 │ │ Load F3 │ │ ─────────────── │ │ Find F4 │ │ Next F5 │ │ Replace F6 │ │ Goto F7 │ │ filter F8 │ │ reformat F9 │ │ ─────────────── │ │ √Auto Indent │ │ Backup Source │ ╘═════════════════╛ Mark [F10] Before you can work with a a block of text you must first define where the text block begins and ends. Hit [F10] once and use the cursor keys to highlight the text you want copied. Hitting [F10] again unmarks the selected text. Mouse: Pressing the left button of your mouse and dragging the mouse over the desired text quickly marks large blocks of text. Copy [Alt C] [Shift Alt C] Once the text is marked, strike [Alt C] to place the marked text tn the clipboard. The text in the clipboard can then be pasted or quoted into other windows or to other portions of the file. If you hold down the [Shift] key while you press [Alt C], the marked text will be appended to the clipboard without erasing the clipboard. Mouse: Holding down the [Shift] key while selecting the Copy item from the menu has the same effect as [Shift Alt C]. cUt [Alt U] [Shift Alt U] The cUt function allows you to move marked text from the file you are editing. As with the Copy option, text must first be marked using [F10] before it can be cut. The text can be pasted into other sections of the file using the paste feature. If you hold down the [Shift] key while you press [Alt U], the marked text will be appended to the clipboard without erasing the clipboard. TELEMATE 3.01 THE EDIT WINDOW 40 Mouse: Holding down the [Shift] key while selecting the cUt item from the menu has the same effect as [Shift Alt U]. Tag [Alt G] [Shift Alt G] The tag feature allows you to select the file names in the marked text and put them into the clipboard. The file names are separated by the tag separator which can be a space, a carriage return or a comma. If you hold down the [Shift] key while you press [Alt G], the file names will be appended to the clipboard without erasing the clipboard. This function is very useful when you want to download a file. Mouse: Holding down the [Shift] key while selecting the Tag item from the menu has the same effect as [Shift Alt G]. Paste [Alt P] Text which is first marked [F10] and Copied [Alt C] or cUt [Alt U] to the clipboard can then be pasted [Alt P] into another window, another section of the same file, or into an entirely different file. After marking and copying the text, position the cursor where you want the text and press [Alt P]. The text is pasted at the new location. You can use the cut function with paste to move text within a file. If you wish to copy text to a new file, mark and copy the text first; load the new file and position the cursor where you want the text to begin, then press [Alt P]. Quote [Alt Q] [Alt Q] functions much the same as [Alt P]. [Alt Q] is designed for quoting text into BBS message areas. This function allows you to prepare messages with quotation in the Edit window. Quoting text is exactly like pasting except that every line is preceded by the quote prefix. The text is truncated at the quote margin. Write [Alt A] The Write function allows you to write or append the marked text to a file. New [Alt N] Pressing [Alt N] starts a new edit file. If the file in the editor has been edited, you will be asked if you want to save the file first. Saving Files [F2] [F2] brings up the File dialog and you can type in the name of the file you want to save to. Loading Files [F3] Loading files is very similar to saving a file, the [F3] key loads a file to the Edit window. TELEMATE 3.01 THE EDIT WINDOW 41 Find [F4] When you select this function, you see the "Find: _" prompt. Type in the text you wish to find or press [Up] to recall the last search string. The function is case insensitive. For example, "big" finds "BIG" or "BiG", etc. Next [F5] Hitting [F5] finds/replaces the next occurrence of the find text. Replace [F6] When you select this option you see the "Find: _" prompt. After typing in the find text you are prompted "Replace with: _". Type in the text that should replace the find text. If the text is found you are asked "Replace [Yes,No,Replace All,Quit] ? _". Press 'Y' to confirm the replacement, 'N' to ignore, 'Q' to abort or 'R' to repeat the replacement until the no more text is found or [Esc] is hit. Goto [F7] Invoking the Goto command causes "Goto #" to appear in the upper left corner of the View window. Type in the line number you wish to go to. Filter [F8] Some word processors, such as WordStar, use the 8th bit for special purpose, you can filter out the 8th bit by press [F8]. The 8th bit is hid but not removed. Reformat [F9] To reformat a paragraph, move the cursor to the beginning of the paragraph and press [F9]. You can change the right margin setting through the Options/General dialog. By holding the [F9] key, Telemate reformats a series of paragraphs or even a whole file. Auto Indent If this option is on, when [Enter] is pressed, the cursor will be placed at the first non-empty position of the previous line. This option is useful when you are using the editor for programming. If it is off, the cursor will be moved to the beginning of the line. Backup Source If this option is on, when the editing file is saved, a backup copy, with the extension of .BAK, will be produced. TELEMATE 3.01 THE EDIT WINDOW 42 Macro Keys The editor recognizes the following keys as marco keys. Function key: [F11] , [F12] Alt key: [Alt F1] - [Alt F12] Shift key: [Shift F1] - [Shift F12] Ctrl key: [Ctrl F1] - [Ctrl F12] Alt Number: [Alt 1] - [Alt 0] If the macro symbol '^M' is included in these keys, it will be translated to a carriage return. Other macro symbol are not translated. TELEMATE 3.01 THE VIEW WINDOW 43 THE VIEW WINDOW [Alt V] When you select the View item on the menu bar, the first thing you see is the File dialog. Select the file you want to view. Moving around in the View window is the same as in the Edit window. However, Wordstar conventions are not accepted. Instead, characters typed in the View window are forwarded to the Terminal window. This gives you the ability to issue a command to the remote system without leaving the View window. The View Menu ╒═════════════════╕ │ Mark F10 │ Pressing [Alt V] a second time invokes │ Copy Alt-C │ the View menu. To choose a function, │ Tag Alt-G │ press the key indicated on the right │ Quote Alt-Q │ side of the menu. │ Write Alt-A │ │ ─────────────── │ Only the Quote function performs │ New Alt-N │ differently from that in the Edit │ Load F3 │ window. │ ─────────────── │ │ Find F4 │ │ Next F5 │ │ Goto F7 │ │ filter F8 │ ╘═════════════════╛ Quote [Alt Q] When you select this function, the marked text will be quoted to the terminal immediately but not pasted into the View window. TELEMATE 3.01 THE BACK WINDOW 44 THE BACK WINDOW [Alt B] [CENTER] [CTRL UP]/[CTRL DOWN] Effective telecommunications require constant access to information. In a later portion of your communications session, you may need access to information that previously passed through your screen. You can recall the information via the Back (scroll) window. You open the Back window by pressing [Alt B], [Center] (the FIVE key in the keypad), [Ctrl Up] or click the mouse button at the Back item in the menu bar. The optional [Center] or [Ctrl Up] keys, combined with the [Scroll Lock] key, provide a very convenient way to access the back scroll buffer. When the Back window is already in the top of the screen, pressing [Center] again or [Ctrl Down] hides the window as if [Esc] is pressed. Characters typed in the Back window are forwarded to the Terminal window as if they were typed in the Terminal window. Therefore, you can operate in both the Back and the Terminal windows. The back scroll limit can be set in the Options/General dialog. The Back Scroll Menu ╒═════════════════╕ │ Mark F10 │ The Back menu is almost identical to the │ Copy Alt-C │ Edit menu. The functions are summarized │ cUt Alt-U │ in the Edit menu section. │ Tag Alt-G │ │ Quote Alt-Q │ The Quote functions works slightly │ Write Alt-A │ different and the Write function has a │ ─────────────── │ new meaning in this window. │ Find F4 │ │ Next F5 │ │ Goto F7 │ │ filter F8 │ │ ─────────────── │ │ √Scroll Lock │ │ √Capture Ins │ │ Clear Alt-N │ ╘═════════════════╛ Write [Alt A] There are two ways to record a communications session. You can open a log file at the beginning of a session which records the entire session. The second way is to use the Write function in the Back window. When you see information that you want to remember, simply mark it and write (append) it to a file. This is an alternative to the Log function in the Terminal window. TELEMATE 3.01 THE BACK WINDOW 45 Quote [Alt Q] [Alt Q] is designed for quoting text into BBS message areas. While you are in the Back window, you can place the cursor at the replying message and press [F10] to start marking. Then you can move the cursor to the end of the message and hit [Alt Q]. The marked text is sent to the remote system with the quote prefix leading each line. If a line is longer than the quote margin, the extra words will be cut off at the quote margin. Scroll Lock [Scroll Lock] When the Back window is moved to the top of the screen, the cursor will either stay at (or 'lock' at) the previous position or move to the bottom of the back scroll buffer. If Scroll Lock is on, the cursor will stay at the previous position. The [Scroll Lock] key can be pressed at any time to toggle this option. The item 'SLK' will be displayed on the status line if this option is enabled. Note: Turning on or off the LED light on the keyboard may cause data overrun in some computers. So Telemate controls the state of the LED and switches it only if the COM port is idle for a certain time. As a result, the LED may not reflect the current status. You should check the 'SLK' item on the status line instead. Capture [Ins] If this option is on, the incoming data is put into the back scroll buffer. As Telemate stores the back scroll buffer to disk, it may be slow on a floppy disk system. In this case, you should turn the Capture function off or set a smaller value to the Back Scroll Limit, say 100, under the Options/General dialog. Clear [Alt N] This function clears the back scroll buffer. TELEMATE 3.01 THE MACRO WINDOW 46 THE MACRO WINDOW [Alt M] Telemate lets you assign text to a key so that the text is sent to the remote system when that key is pressed. This is called a keyboard macro. Macros, when properly used, can save you from typing hundreds of keystrokes. Pressing [Alt M] the first time brings up the Macro window. Hitting [Alt M] twice gives you access to the Macro menu. Telemate keeps four key definitions tables in memory at all times, the macro table, keypad table, the alt-keypad table and the keyboard table. The Macro Table The macro table contains all the function keys and the shifted function keys. For example, [F2], [Ctrl F2], [Shift F2] and [Alt F2]. When a terminal is selected, the corresponding macro table is loaded. For example, if the VT102 terminal is selected, the VT102.MAC macro table is loaded. By default, the [F1] key is the help key but you can redefine it to suit you need. The Keypad Table The keypad table is used for terminal emulation key assignments. Therefore, for each terminal there is a keypad definition file. Similar to the macro table, when a terminal is selected, the corresponding keypad table is loaded. The keypad keys which are definable include the following keys: [BackSpace] [Grey /] [Home] [Up] [PgUp] [Ctrl PgUp] [Grey *] [Ctrl Left] [Left] [Right] [Ctrl Right] [Grey -] [End] [Down] [PgDn] [Ctrl PgDn] [Grey +] [Ins] [Del] [Enter] By default, the [PgUp] key is the upload key and the [PgDn] key is the download key but you can redefine them to suit your need. The Alt-Keypad Table The 101-keyboard has an extra set of cursor keys. It is called the alternated keypad. You can define them separately but only if you have a 101-keyboard and you have turned on the Enhanced Keyboard option under the Options/Mouse & Keyboard dialog. The Keyboard Table This is sometimes called the translation table because it changes the incoming or outgoing characters to another value. For every character in the ASCII set, the table defines what it should be changed to. This table allows you to completely redefine your keyboard when using TELEMATE 3.01 THE MACRO WINDOW 47 Telemate. The Macro Window The Macro window displays the first four characters of the macro definition. These macros are designed so that they can be accessed by pointing with the mouse and clicking. They can also be invoked by pressing the key(s) indicated. ╔═══════════════════════════════════╗ The keys in the ║ N1 │ N9 │ Enter │ Home ║ The keys in upper left are ║ N2 │ N0 │ Space │ End ║ the 3 top- the [Alt]+[No.s ║ N3 │ Ctrl-C │ BackSp │ C-PgUp ║ right col.s 0 to 9]. ║ N4 │ Ctrl-K │ Escape │ C-PgDn ║ are constants. ║ N5 │ Ctrl-S │ Up │ C-Left ║ They are for The lower left ║ N6 │ Ctrl-Q │ Down │ C-Rght ║ use with the macros are the ║ N7 │ Ctrl-X │ Left │ Insert ║ mouse. If you Function keys. ║ N8 │ Ctrl-Z │ Right │ Delete ║ need to send a ║────────┼────────┼────────┼────────║ Ctrl-C, point The A1, A2, A3, ║ F1 │ A1 a 1^│ S1 a 11│ C1 a 21║ with the mouse etc. column ║ F2 ^CS~│ A2 a 2^│ S2 a 12│ C2 a 22║ at Ctrl-C and refers to the ║ F3 ^&^M│ A3 a 3^│ S3 a 13│ C3 a 23║ click. [Alt] +[Fn Key] ║ F4 │ A4 a 4^│ S4 a 14│ C4 a 24║ combinations. ║ F5 m^M │ A5 a 5^│ S5 a 15│ C5 a 25║ The lower-right ║ F6 f^M │ A6 a 6^│ S6 a 16│ C6 a 26║ column refers The 3rd column ║ F7 =^M │ A7 a 7^│ S7 a 17│ C7 a 27║ to the [Ctrl] + has the [Shift] ║ F8 a^M │ A8 a 8^│ S8 a 18│ C8 a 28║ [Fn Key] +[Fn Key] ║ F9 rnn^│ A9 a 9^│ S9 a 19│ C9 a 29║ combinations. combinations. ║F10 n^M │A10 a 10│S10 a 20│C10 a 30║ ║F11 │A11 │S11 │C11 ║ ║F12 │A12 │S12 │C12 ║ ╚════════╧════════╧════════╧════════╝ The Macro Menu ╒════════════════╕ │ Function key │ Press [Alt M] again when in the Macro │ Alt key │ window and the pull down menu appears. │ Shift key │ It is divided into two sections: │ Ctrl key │ the top section is for key definitions, │ alt Number │ the lower - for loading and saving │ Keypad │ macros. │ alT keypad │ │ Keyboard │ Function key: refers to the keys F1-F12 │ ───────────────│ Alt key: [Alt] + the keys F1-F12 │ Load macro │ Shift key: [Shift] + the keys F1-F12 │ Save macro │ Ctrl key: [Ctrl] + the keys F1-F12 │ Load keypad │ Alt Number: [Alt] + numbers 0-9 │ Save keypad │ Keypad: Numeric keypad │ Load keyboard │ Alt Keypad: The alternated keypad │ Save keyboard │ Keyboard: The Qwerty Keyboard, ABC, etc. ╘════════════════╛ TELEMATE 3.01 THE MACRO WINDOW 48 Defining Macros To define a macro, select the type of keys you wish to redefine A macro definition window will open as shown: ┌─────────────────────────────────────────────────────┐ │ │ │ Ctrl-F1 TYPE IN BESIDE EACH KEY__________ │ │ Ctrl-F2 COMBINATION THE TEXT YOU WANT THAT__ │ │ Ctrl-F3 KEY COMBINATION TO SEND._______ │ │ Ctrl-F4 ______________________________________ │ │ Ctrl-F5 ______________________________________ │ │ Ctrl-F6 IF YOU WANT Ctrl-F10 TO SEND THE_____ │ │ Ctrl-F7 NAME "Snigglefritz" THEN YOU WOULD___ │ │ Ctrl-F8 TYPE "Snigglefritz" NEXT TO Ctrl-F10__ │ │ Ctrl-F9 LIKE THIS:__________________ │ │ Ctrl-F10 Snigglefritz__________________________ │ │ Ctrl-F11 ______________________________________ │ │ Ctrl-F12 ______________________________________ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └─────────────────────────────────────────────────────┘ Macro Symbols In addition to accepting standard alpha-numeric text, Telemate also uses certain symbols which when passed through the phone lines perform specific functions. For example, the character "^M" in a macro translates as [Enter] on the other end. Below is a table of symbols you can incorporate in your macros: ╒════════╤═════════════════╕ ╒════════╤════════════════════════╕ │ Symbol │ ASCII │ │ Symbol │ Function │ ├────────┼─────────────────┤ ├────────┼────────────────────────┤ │ ^@ │ Null │ │ ~ │ Pause 0.5 second │ │ ^A │ Ctrl A │ │ ^# │ Drop DTR │ │ ... │ │ │ ^% │ Send break signal │ │ ^M │ Carriage Return │ │ ^$ │ Send memo │ │ ^J │ Line feed │ │ ^& │ Send password │ │ ^L │ Form feed │ │ ^* │ Send hang up string │ │ ... │ ... │ │ ^( │ Send init string │ │ ^Z │ Ctrl Z │ │ ^) │ Send answer string │ │ ^[ │ Esc │ │ ^- │ Keystroke simulation * │ │ ^^ │ ^ │ │ ^= │ Execute command * │ │ ^~ │ ~ │ │ ^\ │ Run script file * │ ╘════════╧═════════════════╛ ╘════════╧════════════════════════╛ * This macro symbol must appear at the beginning of the macro. TELEMATE 3.01 THE MACRO WINDOW 49 The '^-' Keystroke Simulation Macro Symbol This macro symbol simulates keystrokes as if they are generated by the keyboard, including [Alt] keys. This macro symbol must appear at the beginning of the macro. The syntax is '^-' [keystroke] [keystroke] [...] [keystroke] is in the following format: 1. Normal character: For normal characters, there is no special prefix character. For example, "^-abc" generates the three character "abc". 2. Control character: For control characters from [Ctrl A] (ASCII 1) to [Ctrl Z] (ASCII 26) and [Esc] (ASCII 27), the '^' character is used as the prefix character. For example, "^-Robinson^M^[" generates the word "Robinson" follows by an [Enter] and then an [Esc]. Note: in the Terminal window, "^H" is not the same as the [BackSpace] key, "^H" generate the character ASCII 8, [BackSpace] generates the string defined in the keypad table. 3. The ^ character itself: Two consecutive '^' generates one '^' character. For example, "^-^^" generates a '^'. 4. [Alt] and function key: An [Alt] or function key is represented by an accent '`' follows by the keyboard scan code in 4 hexadecimal characters. The list of the keyboard scan code is in the appendix. 5. The accent ` character itself: Two consecutive accent ` generates one accent ` character. For example, "^-``" generates a `. Caution: It is a <`> but not a <'>. For example, the macro sequence "^-`1200`2e00`1400`1900" generates [Alt E] [Alt C] [Alt T] [Alt P] which switch to the editor, copy the marked text to the clipboard, switch to the terminal and paste the content in the clipboard to the remote system. There are certain limitation on the other macro symbols that you can use. The macro symbols that are supported are '^A' - '^Z', '^[' and '^^'. All other symbols are interpreted as if they are typed in the keyboard. For example, '^~' generates '^~', '~' generates '~' (not pause 0.5 second) and '^#' generates '^#' instead of dropping DTR. For example, the sequence "^-^@^~~^#^%^$^&^*^(^)^-^=^\" generates exactly "^@^~~^#^%^$^&^*^(^)^-^=^\". If you need the special macro symbol to work, you have to put them in an other function key and generate the scan code for that function key. The '^-' macro symbol can nest function keys. For example, suppose the [F3] key is defined as "^&^M" which sends the password and the a carriage return. You can define "^-Robinson^M`3d00^[^[^[" which send the word "Robinson", an [Enter], a [F3] key and then three [Esc] keys. TELEMATE 3.01 THE MACRO WINDOW 50 Note: You should avoid using the [Shift Fn] key to simulate the Copy [Alt C], Cut [Alt U] and Tag [Alt G] keys because it will provide the result for [Shift Alt C], [Shift Alt U] and [Shift Alt G] respectively and the clipboard is not cleared before adding new data. On the other hand, you must use the [Shift Fn] key to produce the keys [Shift Alt C], [Shift Alt U] and [Shift Alt G]. The '^=' Hot Key Macro Symbol With the hot key macro symbol, you can define as many DOS commands or external protocols as the number of the function keys. This macro symbol must appear at the beginning of the macro. The syntax is '^=' [command] ['^='] ['^M'] ['^['] [command] can be a DOS commands, external editors, external protocols, a batch file or whatever you like. ['^='] is optional. If specified, it will be converted to baud rate and COM port information in the same order as those parameters passed to an external protocol. ['^M'] is optional. If specified, it enforces the command to execute immediately. Otherwise, the command line dialog [Alt R] will prompt you for more information. ['^['] is optional. If specified after the ^M above, the DOS window will be hid after the command is executed. This symbol has no effect on commands using with /P (pause) option. ╒═════════════════════╤══════════════════════════════════════════╕ │ Example │ Description │ ├─────────────────────┼──────────────────────────────────────────┤ │ ^=COPY │ Brings you to the DOS command window and │ │ (without ^M) │ prompts you for more information │ ├─────────────────────┼──────────────────────────────────────────┤ │ ^=DIR *.SCR^M^[ │ Shells to DOS and display all the *.SCR │ │ (with ^M) │ files, the '^M' enforces the execution │ │ │ of the command, then hide the window │ ├─────────────────────┼──────────────────────────────────────────┤ │ ^=MLINK-D ^=^M │ Works exactly the same as an external │ │ (with another ^= │ protocol by passing baud rate and │ │ and ^M) │ COM port information to the batch file │ │ │ MLINK-D.BAT │ ├─────────────────────┼──────────────────────────────────────────┤ │ ^=MLINK-U ^= │ Brings you to the DOS command window │ │ (with another ^=) │ and waits for the file name │ ╘═════════════════════╧══════════════════════════════════════════╛ TELEMATE 3.01 THE MACRO WINDOW 51 The '^\' Run Script Macro Symbol With this macro symbol, a script file can be started by pressing one function key. For example, if you define [F10] as "^\HOST", then the HOST.SCR in the script directory will be run by pressing [F10]. This macro symbol must appear at the beginning of the macro. Redefining the Keyboard Sometimes it is necessary for certain incoming or outgoing characters to be changed to another value or stripped altogether. For this purpose, Telemate keeps in memory an incoming and an outgoing character 'keyboard table'. For each character in the ASCII set, the table defines what the character should be changed to. By default, no character translation is performed. Suppose that both incoming and outgoing translations are turned on and Original In Out ═══════════════════════ 65:A » 65:B » 65:C When the character 'A' is received from the remote system, the character 'B' is displayed on the screen. When the character 'A' is typed from the keyboard, the character 'C' is sent to the remote system. Loading and Saving Macros, Keypads and Keyboards Although you can only have a limited number of macros active at any one time, Telemate actually gives you access to an unlimited number of macros. You can store one set of macros in one file and have a completely different set in a different macro file. These files can be saved and loaded whenever you need them through the Macro menu. Once you have defined some macros you need to save them. Access the Macro menu, highlight the "Save Macro" option and press [Enter]. Telemate uses the default extension ".MAC" for macros, ".PAD" for keypad and ".KEY" for keyboard. To load a macro, keypad or keyboard file select the appropriate option from the Macro menu. The File dialog opens displaying those files with the corresponding extension (.MAC, .PAD, or .KEY). Then you can select the file you want to load. TELEMATE 3.01 THE OPTION DIALOG 52 THE OPTION DIALOGS [Alt O] The Options dialog allows you to quickly change many of Telemate options. When you have made your changes, you can save them to the configuration file so they automatically load on your next session. The Options Menu ╒═════════════════════╕ │ General │ │ Mouse & keyboard │ │ Dial setup │ │ dIrectory │ │ Terminal │ │ Communication │ │ Protocol │ │ External Protocol │ │ ─────────────────── │ │ Load options │ │ Save windows │ │ Save options │ ╘═════════════════════╛ Through the Options menu you can affect how Telemate operates in 8 areas: General Dialog: includes such things as your display setup, scroll buffer size, delays, sound and alarm. Mouse & Keyboard Dialog: includes mouse setup and enhanced keyboard selection. Dial Setup Dialog: allows you to change dial prefixes, time, dial cancel string and pause time between dialing attempts. Directory Dialog: sets the default directories for your main Telemate files, Upload and Download directories, as well as the Edit, View, Write, Script, Image and Log directories. Terminal Dialog: allows you to select the type of terminal Telemate emulates, line feeds, local echo and the type of connection you are using Telemate with. Communication Dialog: allows you to alter the strings or signals Telemate sends to initialize your modem, hang up the phone, turn on the auto-answer feature, etc. You may also change your communications port, baud rate, parity, and other COM parameters through this menu. Protocol Dialog: allows you to select the ASCII, Kermit and Zmodem options and other general protocol features. External Protocol Dialog: allows you to set up the external protocols. NOTE: Most of Telemate's default settings are probably appropriate to your needs. On the other hand, don't be afraid to experiment with some of the items. TELEMATE 3.01 THE OPTION DIALOG 53 Saving and Loading Options When you select the Save or Load menu item Telemate calls up the File dialog. By default Telemate displays those files which end in the extension .CFG. Saving Windows When you select this function, the positions of all the windows will be saved to the configuration file. How to Make Changes When a dialog box is open, pressing the [Tab], [Shift Tab] or using the arrow keys moves the cursor from choice to choice. ╒════════════════╤══════════════════════╕ │ Key │ Function │ ├────────────────┼──────────────────────┤ │ Tab │ Next group │ │ Shift Tab │ Previous group │ │ Down │ Next item │ │ Up │ Previous item │ │ Spacebar │ Turn on/off option │ │ Enter │ Accept changes │ │ Esc │ Abort changes │ ╘════════════════╧══════════════════════╛ There are 3 types of choices in a dialog box: Circular Buttons: ┌─ Mouse Type ───────┐ │ ( ) None │ │ ( ) MicroSoft │ │ (*) MouseSystem │ └────────────────────┘ Circular buttons refer to black dots inside the parenthesis ( ) that you see in the Mouse selection box. Press [Spacebar] and the button jumps from button to button and only one item can be selected in each group. Check Boxes: ┌──────────────────────┐ │ [X] Music │ │ [ ] Bell │ └──────────────────────┘ Some options are simple yes or no type choices. These appear as a pair of brackets: [ ]. Press the [Spacebar] and an 'X' appears in the brackets: [X] which means "yes, I want this option turned on". An empty bracket means "No." TELEMATE 3.01 THE OPTION DIALOG 54 Text Boxes: ┌─────────────────────────────────────────────────┐ │ Download Directory C:\TM\DOWNLOAD\_______ │ └─────────────────────────────────────────────────┘ There are some options which require you to type in your choice. You can use [Ins] to toggle the insert mode, [Ctrl Y] or [Ctrl Left] to erase the whole field, [Alt P] to paste text from the clipboard and [Alt C] to copy text to the clipboard. General Options ┌──────────────────────────────────────────────────────────────┐ │ ┌ DOS Shell ───────────────────────────────────────────┐ │ │ │ [X] Swap Telemate to EMS/XMS │ │ │ │ [X] Swap Telemate to Disk │ │ │ │ [ ] Maximum DOS Shell │ │ │ └──────────────────────────────────────────────────────┘ │ │ ┌ Display ─────────────────┐ ┌ Log ──────────────────┐ │ │ │ [X] Scroll Bars │ │ [X] Log Filter │ │ │ │ [X] Menu Bar │ │ [ ] Log Heading │ │ │ │ [X] Status Line │ │ [X] Usage Log │ │ │ │ [ ] 24 Hour Format │ └───────────────────────┘ │ │ │ Date Format 0 │ ┌ Sound ────────────────┐ │ │ │ Scroll Back 100_ │ │ [X] Music │ │ │ │ Editor Margin 65_ │ │ [X] Bell │ │ │ │ Message Pause 1_ │ │ [ ] External Alarm │ │ │ │ Error Pause 3_ │ │ Alarm Sound 3_ │ │ │ │ Screen Saver 10 │ │ Alarm Time 3_ │ │ │ └──────────────────────────┘ └───────────────────────┘ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────┘ Swap Telemate To EMS/XMS: When this option is on, Telemate will swap itself to XMS or EMS while jumping to DOS and, therefore, leaving more memory to the DOS shell. If both XMS and EMS memory are present, Telemate will swap to XMS if there is enough memory. If the swapping is unsuccessful, Telemate will swap to EMS memory. Swap Telemate To Disk: Similar to the "Swap Telemate To EMS/XMS", Telemate will swap itself to a disk file named TM.SWP in the virtual memory directory while jumping to OS if this option is on. If both the 'Swap' options are on, Telemate will swap to XMS/EMS when there is enough memory, if the swapping is unsuccessful, Telemate will swap to disk. TELEMATE 3.01 THE OPTION DIALOG 55 Maximum Dos Shell: This option must be used with the 'Swap' options above. When it is turned on, Telemate occupies only 5K bytes in the main memory such that you have a large DOS shell to run other applications. The disadvantage is that Telemate will disable the COM port and incoming data will be lost because the routine to handle the transmission is no longer in the memory. If the RTS/CTS flow control is used, Telemate will lower the RTS signal to prevent data lost. If this option is off, Telemate will only swap part of itself out for continuing transmission until the buffer is full. Scroll Bars: If this option is on, the top window has the scroll bars for use with mouse. For detailed descriptions on the scroll bars and mouse operations, please refer to the IF YOU HAVE A MOUSE section. Menu Bar: If this option is on, a menu bar is shown on the top of the screen. If you have a mouse, you can click on the item on the menu bar to access the corresponding window or menu. Pressing [Alt -] toggles the status line and the menu bar. On some foreign keyboards, [Alt +] is the equivalent key. Status Line: If this option is on, a status line is shown on the bottom of the screen. The status line provides immediate information on terminal emulation, baud rate, parity, data bits, stop bits, COM port, script file, log file, printer status and the current remote system. Pressing [Alt -] toggles the status line and the menu bar. On some foreign keyboards, [Alt +] is the equivalent key. 24 Hour Format: If this option is on, time is displayed on a 24-hour format. Otherwise, it is displayed on a 12-hour format. Date Format: Telemate supports 9 date formats which can be divided into 3 group. The first group uses '-' as the separator, the second uses the '/' and the third '.'. The code is as follows: 0: MM-DD-YY 1: DD-MM-YY 2: YY-MM-DD 3: MM/DD/YY 4: DD/MM/YY 5: YY/MM/DD 6: MM.DD.YY 7: DD.MM.YY 8: YY.MM.DD Note: The date format does not affect the date format used in the script language. Scroll Back Limit: This is the number of lines the scroll back buffer can contain. Setting the limit to 0 will disable the scroll back function and it minimizes the size of the virtual memory file. On floppy disk system, this value should be 100 or less in order reduce disk access and speed up the display. Editor Margin: This is the right margin of the editor. The words you typed after this margin are wrapped to the next line. The margin also bounds the right side during reformatting. Message Pause: This is the amount of time, in seconds, that the Message Box appears when an action is being taken. Error Pause: This is the amount of time, in seconds, that the Error Box appears when an error is encountered. TELEMATE 3.01 THE OPTION DIALOG 56 Screen Saver: This is the amount of time, in minutes, that Telemate will wait for keyboard or mouse input before activating the screen saver. A message is displayed in random position on the screen when the screen saver is active. A zero in this field will disable the screen saver feature. Log Filter: If this option is on, all the control codes are filter out during the recording of the communication session. Log Heading: If this option is on, a brief message is inserted into the log file which indicate the date and time the log is open. Usage Log: If this option is on, actions, such as connecting to a remote system, upload/download status, online/offline status, are be recorded in the usage file TM.USE. Music: Some BBS's send ANSI music instructions via phone line. If this options is turned on, Telemate interprets those instructions and plays the music. Bell: The ASCII code 7 is the bell code. To keep Telemate silent, turn off this option. External Alarm: If turned on, the batch file TMALARM.BAT will be executed as an external alarm under the following conditions: 1. Both Alarm Sound and Alarm Time are greater than 0 2. You are in the Terminal, Dial or Stack windows Five parameters are passed to the batch file as %1, %2, %3, %4 and %5. They are %1 = Alarm Type = 0 if Transfer success = 1 if Transfer failure = 2 if Connected to a BBS = 3 if Script alarm = 4 if Warning (e.g. not enough disk space) %2 = Alarm Sound (no. of seconds the alarm should sound) %3 = Alarm Time (no. of seconds the alarm should display) %4 = BBS # connected to %5 = Current baud rate (300 to 115200) Alarm Sound: This is the amount of time, in seconds, that the alarm song plays when the Alarm appears. To turn off the alarm sound, set this value to 0. Alarm Time: This is the amount of time, in seconds, that the Alarm dialog waits before disappearing from your screen. Setting the value to 0 turns off the visible Alarm dialog box. TELEMATE 3.01 THE OPTION DIALOG 57 Mouse & Keyboard Options ┌─────────────────────────────────────────────────────────────┐ │ ┌ Mouse Type ──────┐ ┌ Port ─────┐ ┌ Speed ──────┐ │ │ │ ( ) None │ │ (*) None │ │ ( ) Slow │ │ │ │ (*) MicroSoft │ │ ( ) COM1 │ │ (*) Medium │ │ │ │ ( ) MouseSystem │ │ ( ) COM2 │ │ ( ) Fast │ │ │ └──────────────────┘ └───────────┘ └─────────────┘ │ │ │ │ [ ] Swap Left/Right Buttons ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ [ ] Enhanced keyboard ╚════╝ └────────┘ │ └─────────────────────────────────────────────────────────────┘ Mouse Type: Telemate supports two types of mice, MicroSoft Mouse and MouseSystem, but almost every mouse emulates one of these two, and many emulate both. Mouse Port: It refers to which serial port your mouse is connected to. If your mouse is a Microsoft mouse, there is no need to select a port. Due to PC's limitation, you cannot have mouse in COM1 and modem in COM3 or mouse in COM2 and modem in COM4. But you can put mouse in COM1 and modem in COM2 or mouse in COM2 and modem in COM3, etc. Mouse Speed: If the mouse pointer seems to move too slow or too fast, you can adjust the speed with this option. Swap Left/Right Buttons: If this option is on, the function in the left and right buttons are exchanged. Enhanced Keyboard: If this option is off, the alternated keypad in the 101-keyboard is treated as the normal keypad. If this option is on, the alternated keypad uses the separated definition. Dial Options ┌──────────────────────────────────────────────────────────────────┐ │ ┌ Dial Prefix ─────────────────┐ ┌ Connect String ────────┐ │ │ │ ( ) 1 AT D________________ │ │ CONNECT_____________ │ │ │ │ (*) 2 AT DT_______________ │ │ ____________________ │ │ │ │ ( ) 3 AT DP_______________ │ │ ____________________ │ │ │ │ ( ) 4 ATDT 9,_____________ │ │ ____________________ │ │ │ └──────────────────────────────┘ └────────────────────────┘ │ │ ┌ Dial Suffix ─────────────────┐ ┌ Busy String ───────────┐ │ │ │ (*) 1 ^M__________________ │ │ NO CARRIER__________ │ │ │ │ ( ) 2 ^M__________________ │ │ BUSY________________ │ │ │ │ ( ) 3 ^M__________________ │ │ VOICE_______________ │ │ │ │ ( ) 4 ^M__________________ │ │ NO DIAL TONE________ │ │ │ └──────────────────────────────┘ └────────────────────────┘ │ │ Break String RING^M____ [ ] Auto Baud Detect │ │ Cancel String ^M________ [X] Auto Redial │ │ Dial Time 32_ [X] Multiple line │ │ Redial Pause 2__ ╔════╗ ┌────────┐ │ │ Redial Attempt 0__ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────────┘ TELEMATE 3.01 THE OPTION DIALOG 58 Dial Prefix: Dial prefix is the string to be sent before the phone number. Normally, pulse phone uses a prefix ATDP and touch-tone phone uses ATDT. Dial Suffix: Dial suffix is the string to be sent after the phone number. Usually it is simply a carriage return. But in some phone companies offer phone card which required the phone card number follow the phone number and the number should be put in the suffix. Connect Strings: These are the strings which the modem sends upon getting a connection, for example, "CONNECT". There is no need to define different strings for different baud rates. The extra connect strings are designed for connection with some communication services. Busy Strings: These are the four strings which the modem sends when it has failed to make a connection while dialing, for example "NO CARRIER". Break String: When this string is received during dialing, the redial cycle is broken. For example, someone calls you when you are dialing out, the modem reports RING and the redial cycle is broken. Cancel String: This is the string Telemate should send to the modem to cancel the dialing attempt, for example, the carriage return "^M". Dial Time: This is the number of seconds that Telemate should wait for a connection while dialing. Redial Pause:This is the number of seconds that Telemate should wait between attempts while dialing. Redial Attempt: This is the number of attempts that Telemate should perform the dialing procedure. Setting this number to 0 will allow the redial attempts to go on until aborted manually or until a connection. Auto Baud Detect: If this option is turned on, Telemate checks the modem connect string for a baud rate indication and switches to the new baud rate. This options only works with Hayes compatible modems. Auto Redial: If this option is turned on, Telemate will automatically redial the current dial list upon carrier drop. To use this function, the carrier signal must reflect the actual online status. Multiple Line: If this option is on and a connection is made, the board names identical to or similar to the one just connected are removed from the dial list. Similar board names are compared by not checking the last 5 characters and the board names must be longer than 10 characters. TELEMATE 3.01 THE OPTION DIALOG 59 Directories and files ┌────────────────────────────────────────────────────────────────┐ │ │ │ Telemate C:\TM\__________________________________ │ │ Upload C:\TM\UL\_______________________________ │ │ Download C:\TM\DL\_______________________________ │ │ Script C:\TM\__________________________________ │ │ Edit C:\ED\__________________________________ │ │ View C:\ED\__________________________________ │ │ Write C:\ED\__________________________________ │ │ Image C:\TM\__________________________________ │ │ Log C:\TM\__________________________________ │ │ Virtual Memory C:\_____________________________________ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └────────────────────────────────────────────────────────────────┘ DOS's ability to make and use subdirectories provides an effective way to manage your files. Below are suggested subdirectories and the corresponding files which should be placed in those directories. There should be 128K in the virtual memory directory, 256K if you have the "Swap Telemate to Disk" option turned on and 512K if you have the "Maximum DOS shell" option turned on. If you have a RAM disk, you should define the virtual memory directory to the RAM disk. This will speed up the back scroll process dramatically. Hard disk system: Dir Name Directory Files -------- --------- ---------------------------------- Telemate C:\TM\ *.FON, *.MEM, *.MAC, *.KEY, *.PAD, TM.HLP, TM.CFG, TM.RES, TM*.EXE, *.BAT Upload C:\TM\UL\ Download C:\TM\DL\ Script C:\TM\ *.SCR, *.TMS Edit C:\ED\ View C:\ED\ Write C:\ED\ Image C:\TM\ *.IMG Log C:\TM\ *.LOG, TM.USE Virtual- C:\ TM.VM, TM.SWP, TMCLIP.$$$ memory Floppy disk system: You must not replace the diskette in drive A: because it is where Telemate stores data and loads the overlay. The main program TM.EXE should be put in drive B:. If you don't need the help function, you can remove the help file TM.HLP. TELEMATE 3.01 THE OPTION DIALOG 60 Dir Name Directory Files -------- --------- ---------------------------------- Telemate A:\ *.FON, *.MEM, *.MAC, *.KEY, *.PAD, TM.HLP, TM.CFG, TM.RES, TMS.EXE Upload B:\ Download B:\ Script A:\ *.SCR, *.TMS Edit A:\ View A:\ Write A:\ Log A:\ *.LOG, TM.USE Virtual- A:\ TM.VM, TM.SWP, TMCLIP.$$$ memory B:\ TM.EXE Terminal Options ┌──────────────────────────────────────────────────────────────┐ │ ┌ Terminal ────────┐ ┌ File Tag Separator ─────────┐ │ │ │ (*) ANSI │ │ (*) Space │ │ │ │ ( ) Avatar │ │ ( ) Carriage Return │ │ │ │ ( ) Prism │ │ ( ) Comma ',' │ │ │ │ ( ) TTY │ └─────────────────────────────┘ │ │ │ ( ) VT52 │ ┌ Quote ──────────────────────┐ │ │ │ ( ) VT102 │ │ [X] Initial (@) Guessing │ │ │ └──────────────────┘ │ Prefix @>________ │ │ │ ┌ Connection ──────┐ │ Margin 65_ │ │ │ │ ( ) BIOS │ └─────────────────────────────┘ │ │ │ ( ) Computer │ ┌ Toggles ────────────────────┐ │ │ │ ( ) Fossil │ │ [ ] Add Line Feed │ │ │ │ (*) Modem │ │ [ ] Add Return │ │ │ └──────────────────┘ │ [ ] Auto Wrap │ │ │ ┌ Flow Control ────┐ │ [X] Confirm Hang Up │ │ │ │ [ ] XON/XOFF │ │ [ ] Destructive BS │ │ │ │ [X] RTS/CTS │ │ [ ] Local Echo │ │ │ └──────────────────┘ │ [ ] Strip High Bit │ │ │ └─────────────────────────────┘ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────┘ Terminal: Telemate gives you the choice of the six terminal types: ANSI, Avatar, Prism, TTY, VT102 and VT52. When a terminal type is selected, the corresponding macro file .MAC and keypad file .PAD is loaded. For example, VT102.MAC and VT102.PAD is loaded when VT102 is selected. Connection: Normally, the connection should be Modem. Telemate determines online and offline status by inspecting the carrier signal of the modem. Therefore, you should not force the carrier signal always true. If the COM port is linked to a host computer directly via a cable or a null modem, you should select Computer and Telemate will not check the carrier signal and will assume it is connected and does not dial the phone number. You can also select BIOS or FOSSIL driver. BIOS only supports upto 9600 baud but you may experience data TELEMATE 3.01 THE OPTION DIALOG 61 lost at 2400 or higher. BIOS connection does not support RTS/CTS flow control. FOSSIL driver supports upto 38400 baud. If the baud rate is over the limit, Telemate will automatically switch to Modem connection. XON/XOFF flow control: When this option is on, XOFF [Ctrl S] causes the terminal to stop transmitting characters until a XON [Ctrl Q] is received. RTS/CTS flow control: High speed modems use hardware handshaking to control the flow of data. If your modem supports hardware flow control, this option should be on. BIOS connection does not support RTS/CTS flow control. File Tag Separator: The tag feature allows you to select the file names in the marked text and put them into the clipboard. The file names are separated by the tag separator which can be a space, a carriage return or a comma depend on the remote system you are using. Initial Guessing: If this option is turned on, Telemate scans the incoming data and looks for 'From:' or 'Name:' and remember the initials of the following name. If there is any chance that there is a wrong guess, the guessing initial will be emptied. Quote Prefix: This is the string to be sent before each quoted line. If the character '@' is in the string, it is replaced by the guessing initial if the Initial Guessing feature is enabled. Otherwise, it is rejected. Quote Margin: This field defines the margin which the quote function will use to cut the quoted text. Add Line Feed: Some BBS's do not add a line feed at the end of each line of data, you should turn this option on to add a line feed. Add Return: If this option is on, a carriage return [Ctrl M] is supplied after a line feed is received. Auto Wrap: If this option is on, after a character reaches column 80, the cursor is wrapped to a new line. Otherwise, the cursor stays at column 80. Confirm Hang Up: If this option is on and the hangup command [Alt H] is issued, you will be asked for confirmation. Destructive Backspace: If this option is on, backspace [Ctrl H] will destroy the character on the left. Otherwise, backspace only moves the cursor to the left. Local Echo: If the remote system does not send the characters you typed back, you should turn this on and the characters you echo to the terminal automatically. Strip High Bit: If this option is on, the 8th bit of the incoming data will be filter out. This option is very useful when the actual link is 7E1 but you use 8N1 as COM parameter. TELEMATE 3.01 THE OPTION DIALOG 62 Communication Options ┌──────────────────────────────────────────────────────────────────┐ │ │ │ Modem Init String ATZ^M__________________________________ │ │ Modem Hangup String ^#~~~+++~~~AT H0^M~____________________ │ │ Auto Answer String ~~~+++~~~AT S0=1^M~____________________ │ │ Answer Back String _______________________________________ │ │ │ │ ┌ COM Port ─┐ ┌ Baud Rate ──┐ ┌ Parity ───┐ ┌ Data Bits ┐ │ │ │ (*) COM1 │ │ ( ) 300 │ │ (*) None │ │ ( ) 7 │ │ │ │ ( ) COM2 │ │ ( ) 1200 │ │ ( ) Even │ │ (*) 8 │ │ │ │ ( ) COM3 │ │ ( ) 2400 │ │ ( ) Odd │ └───────────┘ │ │ │ ( ) COM4 │ │ ( ) 4800 │ └───────────┘ ┌ Stop Bits ┐ │ │ │ ( ) COM5 │ │ ( ) 9600 │ │ (*) 1 │ │ │ │ ( ) COM6 │ │ ( ) 19200 │ │ ( ) 2 │ │ │ │ ( ) COM7 │ │ (*) 38400 │ └───────────┘ │ │ │ ( ) COM8 │ │ ( ) 57600 │ ╔════╗ ┌────────┐ │ │ └───────────┘ │ ( ) 115200 │ ║ OK ║ │ Cancel │ │ │ └─────────────┘ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────────┘ Modem Init String: This string is sent to the modem when Telemate first starts or switches to the originate mode. The '^(' macro symbol refers to this string. Modem HangUp String: This string is sent to the modem to hang up the phone. The '^*' macro symbol refers to this string. The '^#' macro symbol should be included in this string such that it will drop DTR to hangup. Auto Answer String: This string is sent to the modem when Telemate switches to the Answer mode. The '^)' macro symbol refers to this string. Answer Back string: This string is sent to the remote system when the ASCII code ENQ is received. However, this string will not be sent if CIS Quick B transfers are selected because ENQ is used as part of that protocol. Port: Port refers to the communications port to which your modem is attached. Telemate supports up to 8 different port. Baud Rate: It is the speed at which communications take place. Check your modem manual if you are unsure regarding what speed it is. Parity: It is a form of error checking. You can choose between None, Even, Odd, Mark and Space. The vast majority of BBS's are set up for No parity. Data Bits and Stop Bits: Data bits refers to how many bits of data are sent before a stop bit is sent. Most BBS's use 8 data bits and 1 stop bits. TELEMATE 3.01 THE OPTION DIALOG 63 Protocol Options ┌──────────────────────────────────────────────────────────────────┐ │ ┌ General ───────────────────┐ ┌ Paste/ASCII Upload ───────────┐ │ │ │ [X] Filename Guessing │ │ [X] Expand Blank Line │ │ │ │ [X] Check Disk Space │ │ Line Pacing 0_ │ │ │ └────────────────────────────┘ │ Char Pacing 0_ │ │ │ ┌ Zmodem ────────────────────┐ │ Pace Character 0__ │ │ │ │ [ ] Recovery │ └───────────────────────────────┘ │ │ │ [X] Auto-Download │ ┌ Macro/Script ─────────────────┐ │ │ │ [ ] ASCII-Upload │ │ Extended Pacing 0_ │ │ │ └────────────────────────────┘ └───────────────────────────────┘ │ │ ┌ Kermit ────────────────────┐ ┌ ASCII ────────────────────────┐ │ │ │ Control Quote Char 35_ │ │ Upload Download │ │ │ │ Start Of Packet Char 1__ │ │ [ ] [ ] Strip High Bit │ │ │ │ End Of Line Char 13_ │ │ [ ] [ ] Translation │ │ │ │ Padding Char 0__ │ │ [ ] [ ] Strip CR │ │ │ │ Number Of Pad 0_ │ │ [ ] [ ] Strip LF │ │ │ │ Max Packet Size 80 │ │ [ ] [ ] Add CR Before LF │ │ │ │ 8th Quote Char 0__ │ │ [ ] [ ] Add LF After CR │ │ │ └────────────────────────────┘ └───────────────────────────────┘ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────────┘ Filename Guessing: Some protocols, such as Xmodem, require you to supply a download file name. If this option is on, Telemate guesses the possible file name based on the incoming text and puts it in the file selection box if the protocol requires a download file name. Check Disk Space: If this option is on, a warning message is displayed if the size of the downloading file is larger than the free disk space. If the message appears , you should use the MOVE function in the DOS command window [Alt R] to make room for the downloading file. Zmodem Recovery: When this is on, Zmodem resumes an interrupted transfer at a later time. Zmodem Auto-Download: If this option is on, Telemate automatically takes over the reception without your having to strike a single key or enter file names. Zmodem ASCII-Upload: If this option is on, Telemate sends the remote system a signal to indicate the file is an ASCII file and requires end-of-line conversion. Caution: This option should be turned off unless the remote system requests it to be turned on; otherwise, the upload will not success. Kermit Options: Please refer to the document of the host computer to for the details of these options. TELEMATE 3.01 THE OPTION DIALOG 64 Expand Blank Line: If this is on, during ASCII transfers, pasting or quoting and there is a blank line, Telemate adds a space to that line. This is very useful for systems that assume a blank line means "end of message", such as pasting a message to most bulletin boards. Line/Character Pacing: During ASCII transfers, pasting or quoting to the remote system, it may be necessary to wait between each character or each line. Line pace is the amount of time, in 1/20 seconds, that Telemate should wait after sending each line while character pace is the time delay that Telemate should wait between each character. Pace Character: During an ASCII upload or pasting marked text, some remote systems send a special character, such as ASCII 13, when it is ready to receive the next line. Such character is called a pace character. If this value is 0, Telemate upload/paste without waiting for the character. Extended Pacing: Similar to character pacing, an extended pace is the time delay, in 1/20 seconds, that Telemate should wait between each character in a macro or in a string PUT by a script file. ASCII Upload/Download: A number of options are available for ASCII transfers. If 'Strip High Bit' is on, the 8th bit will be stripped. If 'Translation' is on, the keyboard table will be used to translate the incoming or ongoing characters. If 'Strip CR' is on, the carriage return character is rejected. If 'Strip LF' is on, the line feed character is rejected. If 'Add CR before LF' is on, the carriage return character is inserted before the line feed character. If 'Add LF after CR' is on, the line feed character is inserted after the carriage return character. External Protocol Options ┌──────────────────────────────────────────────────────────────────┐ │ │ │ Protocol Upload Download Prompt Auto-Download │ │ Name Key Batch Batch DL Name Sequence │ │ ──────── ─── ──────── ──────── ─────── ───────────── │ │ 1. ________ _ ________ ________ [ ] _____________ │ │ 2. ________ _ ________ ________ [ ] _____________ │ │ 3. ________ _ ________ ________ [ ] _____________ │ │ 4. ________ _ ________ ________ [ ] _____________ │ │ 5. ________ _ ________ ________ [ ] _____________ │ │ 6. ________ _ ________ ________ [ ] _____________ │ │ 7. ________ _ ________ ________ [ ] _____________ │ │ 8. ________ _ ________ ________ [ ] _____________ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └──────────────────────────────────────────────────────────────────┘ TELEMATE 3.01 THE OPTION DIALOG 65 Protocol Name: This is the name of the corresponding external protocol. Key: This is the key used to invoke the corresponding external protocol in the protocol menu. Upload Batch: This is file name of the batch file for upload with the corresponding external protocol. For detail on the format of the batch file, please refer to the appendix. Download Batch: This is the file name of the batch file for download with the corresponding external protocol. For detail on the format of the batch file, please refer to the appendix. Prompt Download Name: If this option is on, you will be asked to enter a file name before downloading with the corresponding external protocol. Auto-Download Sequence: New external protocols have the ability to start the download automatically by detecting a specific data sequence. Telemate scans the incoming data for the auto-download sequence and executes the corresponding external protocol. This feature is disabled if 'Prompt Download Name' option is ON or the Terminal window, Command Stack window or the Chat window is not the top window. In addition, this feature is disabled within 15 seconds after the external protocol is executed. The carriage return '^M' and line feed '^J' character must not present in the sequence. The following are protocols that support this feature and their auto- download sequence. Bimodem ^H ^H ^H ^H ^H ^H HS/Link ^BR Puma ^V^H^V^H^VPuma^V^H^V^H^V Mpt ^V^H^V^H^VMpt ^V^H^V^H^V Zmodem *^XB00 Note: To use an external Zmodem driver, you must turn off the Zmodem Auto-download option in the Options/Protocol dialog. Otherwise, the internal Zmodem will take over. TELEMATE 3.01 APPENDIX A: KEYBOARD SCAN CODE 66 APPENDIX A: KEYBOARD SCAN CODE The following the keyboard scan code used by the "^-" keyboard simulation macro symbol. All numbers are in hexadecimal form. The numbers in parenthesis represent the scan codes for keys on the alternate keypad. [F1] 3B00 [Shift F1] 5400 [Ctrl F1] 5E00 [Alt F1] 6800 [F2] 3C00 [Shift F2] 5500 [Ctrl F2] 5F00 [Alt F2] 6900 [F3] 3D00 [Shift F3] 5600 [Ctrl F3] 6000 [Alt F3] 6A00 [F4] 3E00 [Shift F4] 5700 [Ctrl F4] 6100 [Alt F4] 6B00 [F5] 3F00 [Shift F5] 5800 [Ctrl F5] 6200 [Alt F5] 6C00 [F6] 4000 [Shift F6] 5900 [Ctrl F6] 6300 [Alt F6] 6D00 [F7] 4100 [Shift F7] 5A00 [Ctrl F7] 6400 [Alt F7] 6E00 [F8] 4200 [Shift F8] 5B00 [Ctrl F8] 6500 [Alt F8] 6F00 [F9] 4300 [Shift F9] 5C00 [Ctrl F9] 6600 [Alt F9] 7000 [F10] 4400 [Shift F10] 5D00 [Ctrl F10] 6700 [Alt F10] 7100 [F11] 8500 [Shift F11] 8700 [Ctrl F11] 8900 [Alt F11] 8B00 [F12] 8600 [Shift F12] 8800 [Ctrl F12] 8A00 [Alt F12] 8C00 [Alt A] 1E00 [Home] 4700 (47E0) [Alt 1] 7800 [Alt B] 3000 [Up] 4800 (48E0) [Alt 2] 7900 [Alt C] 2E00 [PgUp] 4900 (49E0) [Alt 3] 7A00 [Alt D] 2000 [Left] 4B00 (4BE0) [Alt 4] 7B00 [Alt E] 1200 [Center] 4C00 [Alt 5] 7C00 [Alt F] 2100 [Right] 4D00 (4DE0) [Alt 6] 7D00 [Alt G] 2200 [End] 4F00 (4FE0) [Alt 7] 7E00 [Alt H] 2300 [Down] 5000 (50E0) [Alt 8] 7F00 [Alt I] 1700 [PgDn] 5100 (51E0) [Alt 9] 8000 [Alt J] 2400 [BackSpace] 0E08 [Alt 0] 8100 [Alt K] 2500 [Insert] 5200 (52E0) [Alt -] 8200 [Alt L] 2600 [Delete] 5300 (53E0) [Alt =] 8300 [Alt M] 3200 [Ctrl PrtSc] 7200 [Alt N] 3100 [Ctrl Left] 7300 [Alt O] 1800 [Ctrl Right] 7400 [Alt P] 1900 [Ctrl End] 7500 [Alt Q] 1000 [Ctrl PgDn] 7600 [Alt R] 1300 [Ctrl Home] 7700 [Alt S] 1F00 [Ctrl PgUp] 8400 [Alt T] 1400 [Ctrl Up] 8D00 [Alt U] 1600 [Ctrl Down] 9100 [Alt V] 2F00 [Ctrl Ins] 9200 [Alt W] 1100 [Ctrl Del] 9300 [Alt X] 2D00 [Grey /] E02F [Alt Y] 1500 [Grey *] 372A [Alt Z] 2C00 [Grey -] 4A2D [Grey +] 4E2B [Grey Enter] E00D TELEMATE 3.01 APPENDIX B: KEYBOARD ASSIGNMENT IN TERMINAL EMULATION 67 APPENDIX B: KEYBOARD ASSIGNMENT IN TERMINAL EMULATIONS VT102 & VT52 TERMINAL EMULATIONS The pre-defined keyboard layout is best suit for 101-key keyboard with the alternative keypad. 84-key keyboard users may have to redefine a few keys. The keyboard layout for the actual VT102 and VT52 keyboard is as follows: ┌───────┬───────┬───────┬───────┐ │ PF1 │ PF2 │ PF3 │ PF4 │ │ │ │ │ │ ├───────┼───────┼───────┼───────┤ │ 7 │ 8 │ 9 │ - │ │ │ │ │ │ ├───────┼───────┼───────┼───────┤ │ 4 │ 5 │ 6 │ , │ │ │ │ │ │ ├───────┼───────┼───────┼───────┤ │ 1 │ 2 │ 3 │ E │ │ │ │ │ N │ ├───────┴───────┼───────┤ T │ │ 0 │ . │ E │ │ │ │ R │ └───────────────┴───────┴───────┘ In the following, the keys on the 101-key keyboard are mapped into the keys in the parenthesis. In Telemate, the [5] key is reserved for Backscroll and cannot be redefined. The [Ctrl Up] is used to emulate the [5] key in the actual terminal. ┌───────┬───────┬───────┬───────┐ ┌───────┬───────┬───────┬───────┐ │ Num │ / │ * │ - │ │ F1 │ F2 │ F3 │ F4 │ │ Lock │ (PF1) │ (PF2) │ (-) │ │ (PF1) │ (PF2) │ (PF3) │ (PF4) │ ├───────┼───────┼───────┼───────┤ └───────┴───────┴───────┴───────┘ │ 7 │ 8 │ 9 │ │ │ (7) │ (8) │ (9) │ + │ ├───────┼───────┼───────┤ │ ┌───────┬───────┬───────┬───────┐ │ 4 │ 5 │ 6 │ (,) │ │ F5 │ F6 │ F7 │ F8 │ │ (4) │ │ (6) │ │ │ (up) │ (down)│ (left)│(right)│ ├───────┼───────┼───────┼───────┤ └───────┴───────┴───────┴───────┘ │ 1 │ 2 │ 3 │ E (E │ │ (1) │ (2) │ (3) │ N N │ ├───────┴───────┼───────┤ T T │ ┌───────┐ ┌───────┐ │ 0 │ . │ E E │ │Ctrl Up│ │ F10 │ │ (0) │ (.) │ R R)│ │ (5) │ │ (del) │ └───────────────┴───────┴───────┘ └───────┘ └───────┘ On the 101-key keyboard, there is an extra set of cursor keys and they are pre-defined to emulate the associated functions. The 84-key keyboard does not have the extra cursor keys. As a result, the [F5] - [F8] keys are used to emulate the arrow keys and [F10] to emulate the [Del] key. TELEMATE 3.01 APPENDIX B: KEYBOARD ASSIGNMENT IN TERMINAL EMULATION 68 By default, the [Backspace] is defined as ASCII 8 [Ctrl H]. Some terminals require the [Backspace] to be defined as ASCII 127. You can redefine the [Backspace] under the Macro/Keypad dialog. Or you can use the pre-defined [Delete] key on the alternative cursor keypad. TELEMATE 3.01 APPENDIX C: FILE TRANSFER PROTOCOLS 69 APPENDIX C: FILE TRANSFER PROTOCOLS Xmodem: This was the most popular protocol in use today, but it is being replaced by quicker and more reliable protocols. Error checking is a checksum or a the Cyclic Redundancy Check. The Xmodem protocol requires a setup of no parity, 8 data bits, and 1 stop bit, If it is not the current COM port setup, Telemate changes it to 8N1 temporarily and changes it back after the transmission. Xmodem-1K: This is a variation of Xmodem which uses blocks that may be 128 bytes or 1024 bytes in size. Some BBS softwares refer to Xmodem-1K as Ymodem. Ymodem sends the name, size and date of the file but Xmodem-1K does not. If the file name 'UNKNOWN.$$$' shows in the File Transfer window during a Ymodem transfer, it is likely that the BBS software is using Xmodem-1K, in this case, you should select Telemate's Xmodem-1K protocol. Relaxed Xmodem: This is the same as Xmodem except that it has a longer delay time. This is for use with remote services that can not tolerate strict timing during Xmodem transfers. Ymodem: This is a variation of the Xmodem which uses blocks that may be 128 bytes or 1024 bytes in size and keeps the correct name, size, and date. Batch Ymodem: This protocol is a variation on Ymodem, which allows multiple files to be sent per transfer. Ymodem-G: This protocol is a variation on Batch Ymodem. It achieves very high transfer rates by sending blocks one after another without waiting for acknowledgement. This however means that an error-free link such as an error-correcting modem or null modem cable between two computers is needed. If an error is detected by the receiver, the transfer is aborted. It allows transferring multiple files. Zmodem: This advanced protocol is both fast and reliable, and offers many features. Zmodem can transfer a group of files in one batch, while keeping the exact file size and dates. Zmodem detects and recovers from errors quickly. The Zmodem Recovery feature can resume an interrupted transfer. Telink: This protocol is primarily found on Fido BBS systems. It is basically the Xmodem protocol using CRC checking with an extra block sent ahead of the file telling its name, size, and date. This protocol allows more than one file to be sent at a time. SEAlink: SEAlink is a advanced version of Xmodem developed by System Enhancement Associates. It is a sliding window protocol. SEAlink passes a name, size, and date of the transferring file and allows multiple files to be transfered. Modem7: Modem7 is a relative of Xmodem. It passes the file name before starting the transfer. It is common on CP/M systems. This protocol allows more than one file to be sent at a time. TELEMATE 3.01 APPENDIX C: FILE TRANSFER PROTOCOLS 70 Kermit: This protocol is designed to permit computers of different types to send files to each other. Almost any computer using Kermit can be set up to send files to another computer using Kermit. CIS Quick B: This protocol is used only on the CompuServe Information Service (CIS). It is fast and specially suited for the networks used in accessing CIS, which have large turnaround delays. A CIS Quick B transfer, both sending and receiving, is totally controlled by Compuserve. Therefore, you should select this protocol before telling CIS what files to send or receive. You should select this protocol in the dial entry for CIS so each time it is connected to CIS, the protocol will be used as default. If you select this protocol in the transfer menu, Telemate displays the message "CIS Quick B ready" and monitors the incoming data for the auto-transfer sequence. ASCII: This protocol acts as if the sender is typing the characters and the receiver is recording them. However, there is no error detection in this protocol. Although you can use this protocol to upload your message, you are suggested to use the Paste [Alt P] command to send the prepared message. TELEMATE 3.01 APPENDIX D: DEFINING EXTERNAL PROTOCOLS 71 APPENDIX D: DEFINING EXTERNAL PROTOCOLS Telemate allows users to define as many as 4 external protocols using DOS batch files. Some external protocol drivers require an large amount of memory, you should turn on the 'Swap Telemate to XMS/EMS' and 'Swap Telemate to disk' options on. When the external protocol is selected, Telemate executes the batch file and pass to it 3 or more parameters. Sometimes the third parameter is blank. Parameter Description ───────── ─────────── %1 the baud rate %2 the com port number (1 - 8) %3 the first file to transfer %4 the second file to transfer .. ... The batch file should call a driver program for the protocol, using the supplied parameters. For example, the batch file for upload may contain the command: DSZ speed %1 port %2 sz %3 %4 %5 %6 %7 %8 %9 NOTE: You can find various protocol drivers in many public BBS's. TELEMATE 3.01 APPENDIX E: USAGE LOG 72 APPENDIX E: USAGE LOG As you use Telemate on a daily basis, Telemate keeps a record of your communications activities. This record is stored in a file called TM.USE. Below is an excerpt from a TM.USE file. The TM.USE file is divided into three parts: Comments in brackets [ ] are our explanatory notes. TIME DATE DESCRIPTION [COMMENTS] -------- ------- ---------------------- 22:52:53 1-24-89 Begin session [Telemate is loaded] 22:57:24 1-24-89 Online [Carrier is found] 22:57:30 1-24-89 Connect to CompuServe [Remote system name] 23:10:34 1-24-89 Offline [Carrier lost] 23:11:32 1-24-89 Online 23:11:38 1-24-89 Connect to SouthWest Connect 23:36:37 1-24-89 Receive-Z TM200-1.ZIP (171K) success, transfer | | | [Zmodem successfully receive the file TM200-1.ZIP] 23:37:16 1-24-89 Offline 23:37:39 1-24-89 End session [Exit to DOS] Telemate comes with a small program called TMSTAT.EXE. TMSTAT.EXE takes the information in TM.USE and produces a useful statistical report on your usage of Telemate. For details, please refer to TMSTAT.DOC. TELEMATE 3.01 APPENDIX F: THE PHONE DIRECTORY 73 APPENDIX F: THE PHONE DIRECTORY Telemate utility program TMPHONE.EXE helps you maintain the phone directory. It changes the size of the phone directory, inserts entries, deletes entries, reorder entries, sorts directory, clears total, zaps connect date, changes the phone directory size and prints directory. To maintain a phone directory, at the DOS command line, type TMPHONE [<name of phone directory>] and press [Enter]. If no phone directory name is supplied, TM.FON and TM.MEM will be used in the maintenance program. Although you can insert and delete an entry of the phone directory using an editor, you will lose track of the memo field. Therefore, you should always use this utility program to maintain the phone directory. The file TMFON.H contains the format of the phone directory such that you can write your own maintenance program or even a conversion program. Each entry in the phone directory requires 131 bytes and the number of entries in a directory can be calculated by (file size of the phone directory) / 131 TELEMATE 3.01 APPENDIX G: MEMORY MANAGEMENT 74 APPENDIX G: MEMORY MANAGEMENT How Telemate uses EMS and XMS If EMS is present, Telemate maps 3 logical pages (48K) into the page frame and uses it as if it is conventional memory. The rest of Expanded Memory stores the phone directory, the backscroll buffer, clipboard buffer, editor file, viewer file and phone directory. Telemate can also swap itself to EMS while in DOS shell. If XMS is present, Telemate requests the 64K High Memory Area and uses it as if it is conventional memory. The rest of Extended Memory stores the phone directory, the backscroll buffer, clipboard buffer, editor file and viewer file. Telemate can swap itself to XMS while in DOS shell. When both XMS and EMS are present, both the 64K High Memory Area and the 3 EMS logical pages (48K) are used as if they are conventional memory. Telemate uses XMS memory prior to EMS memory to store the other data unless it is overrided by the XMS Limit in the configuration file. You can define the XMS Limit in the installation program TMINST.EXE. Software EMS emulators or simulators are not recommended when using Telemate. Though these simulators provide a way to use Extended Memory as Expanded Memory, the overhead of these simulators is very high. Note that 386 memory managers, such as QEMM and 386MAX, are not considered as software EMS emulators because they use specific 386 memory hardware. How Telemate uses EGA/VGA video RAM Telemate can also use EGA/VGA video RAM as data storage and benefit all line modes. When Telemate is running in 43 or 50 lines mode, about 30K extra memory is required to store the windows. The best way to obtain the extra memory is from the EGA/VGA adapter itself because it has 64K to 1024K equipped. EGA and VGA adapters provide 32K video memory in text mode. The video memory is divided into multiple screen images, called pages. In 25 line mode, each page is 4K so that there are a total of 8 display pages. Telemate uses the first pages as the active display page and the other display pages, 28K, to store data such as the windows image. The 32K video buffer mentioned above begins at B8000 in text mode for compatibility with the CGA video buffer. This leaves a large part of video RAM unused. Telemate doubles the size of the video buffer to 64K by moving the video buffer starting address to A0000 and uses the extra 32K to store data. TELEMATE 3.01 APPENDIX G: MEMORY MANAGEMENT 75 Unfortunately, the 64K mode is not compatible with any pop-up memory resident programs because the address of the video buffer is changed. Unless Telemate is in 43 or 50 lines mode and you are very low in memory, the 32K mode should be selected for compatibility. If Telemate is running under DESQView, Windows or in 132 columns mode, only the first page, i.e. EGA/VGA Ram=0, is used for compatibility. Optimizing Memory Usage 640K Conventional + 384K Extended Memory You should set up a RAM disk in the extended memory. DOS's VDISK.SYS can use the extended memory if the following line is in the CONFIG.SYS DEVICE=VDISK.SYS /e /s384 this will create a RAM drive, say D:. And you MUST define the 'Virtual Memory Directory' to 'D:\' under the Options/Directory dialog. Then save the options and run Telemate again. After connected to a BBS, the file D:\TM.VM is created which contain the content of the back scroll buffer and the other buffers. When you shell to DOS, a part of Telemate is stored in the file D:\TM.SWP. DO NOT delete these two files. 640K Conventional + 1M or more Extended Memory You should install HIMEM.SYS, the XMS driver, by putting DEVICE=HIMEM.SYS in your CONFIG.SYS. Telemate uses the first 64K High Memory Area as if it is conventional memory and the rest to store data and the program image during the DOS shell. This may take up to 768K. The remaining 384K could be used to set up a disk cache. For example, Microsoft's SmartDrive, SMARTDRV.SYS, is compatible with HIMEM.SYS. Together in CONFIG.SYS should be the lines FILES=20 BUFFERS=5 SHELL=COMMAND.COM /p /e:1000 DEVICE=HIMEM.SYS DEVICE=SMARTDRV.SYS 384 640K Conventional + 1M or more Extended Memory and Expanded Memory Some computers come with an Expanded Memory Manager, such as EMM412C.SYS, which can turn part of the Extended Memory into Expanded Memory. You should include both HIMEM.SYS and EMMxxxx.SYS in the CONFIG.SYS. Telemate uses the 64K High Memory Area and 48K Expanded Memory as if they are conventional memory. A disk cache will improve the overall performance of your system. The following lines in CONFIG.SYS assume that you split the 1M (1024K) Extended Memory into 704K Expanded Memory, 64K High Memory Area and a 256K disk cache, TELEMATE 3.01 APPENDIX G: MEMORY MANAGEMENT 76 FILES=20 BUFFERS=5 SHELL=COMMAND.COM /p /e:1000 DEVICE=EMM412C.SYS 704 DEVICE=HIMEM.SYS DEVICE=SMARTDRV.SYS 256 The parameter '704' may vary for different Expanded Memory Managers. For example, the command line for QEMM.SYS should be DEVICE=QEMM.SYS EXTMEM=320 which define 320K as Extended memory. 640K Conventional + 1M or more Expanded Memory Some systems allow only Expanded Memory. Then the CONFIG.SYS will look like FILES=20 BUFFERS=5 SHELL=COMMAND.COM /p /e:1000 DEVICE=EMM412C.SYS DEVICE=SMARTDRV.SYS /a256 Note that the '/a' after SMARTDRV.SYS tells SmartDrive to use Expanded Memory. Running under DOS 5.0 Telemate is fully compatible with DOS 5.0. However, some PC's does not report correct information to HIMEM.SYS and causes problem if you load DOS to high memory. In case of doubt, if you have DOS=HIGH in your CONFIG.SYS, you should run TMINST.EXE and try the following setup one by one: Xms Himem OFF Xms Limit 0 Ems Limit 0 EGA/VGA RAM 0 Normally, Telemate disables the use of extra memory automatically when it detects any conflict. However, if the hardware does not report correct inforation, you have to turn disable them manually. Running under QEMM386.SYS Sophisticated 386 Memory Manager, such as QEMM386.SYS, will optimize the usage of memory. But at the same time, it may bring potential problem. In case of doubt, you should run TMINST.EXE and try the following setup one by one: Ems Limit 0 Xms Himem OFF Xms Limit 0 EGA/VGA RAM 0 TELEMATE 3.01 APPENDIX G: MEMORY MANAGEMENT 77 Then you should consult the manual of the 386 memory manager and check if there is any potential incompatibility problem with your hardware. For example, if you have a SCSI drive, you should use the DISKBUF parameter and the EXCLUDE parameter. Running under DESQView/386 If you run Telemate under DESQView with QEMM.SYS, you SHOULD NOT include HIMEM.SYS in the CONFIG.SYS. It seems that DESQView requests the High Memory Area via QEMM.SYS and, therefore, conflicts with HIMEM.SYS. The CONFIG.SYS will look like FILES=20 BUFFERS=5 SHELL=COMMAND.COM /p /e:1000 DEVICE=QEMM.SYS DEVICE=SMARTDRV.SYS /a256 The following is a sample PIF setup for DV386: Memory Size (in K): 640 Writes text directly to screen.......: [N] Displays graphics information........: [N] Virtualize text/graphics (Y,N,T).....: [N] Uses serial ports (Y,N,1,2)..........: [Y] Requires floppy diskette.............: [N] Maximum Program Memory Size (in K)..: 640 Maximum Expanded Memory Size (in K): 1024 Text Pages: 1 Graphics Pages: 0 Close on exit (Y,N,blank)........: [Y] Allow Close Window command.......: [N] Uses math coprocessor............: [N] Share CPU when foreground........: [Y] Can be swapped out (Y,N,blank)...: [N] Uses its own colors..............: [Y] Runs in background (Y,N,blank)...: [Y] Keyboard conflict (0-F)..........: [0] Share EGA when foreground/zoomed.: [Y] Protection level (0-3)...........: [0] Running under Windows 386 Enhanced Mode The following is a sample PIF for Windows 386 Enhanced Mode: Program Filename: TM.EXE Window Title: Telemate Optional Parameters: none Start-up Directory: C:\TM3 (This is the directory where your Telemate files are stored; change as appropriate) TELEMATE 3.01 APPENDIX G: MEMORY MANAGEMENT 78 Memory Requirements KB Required: 640 KB Desired: 640 Display Usage: Windowed Execution: Background Close Window on Exit: yes ADVANCED OPTIONS Multitasking Options Background Priority: 50 Foreground Priority: 100 Detect Idle Time: yes Memory Options EMS Memory KB Required: 0 KB Limit: 0 XMS Memory KB Required: 0 KB Limit 1024 Use High Memeory Area: yes Display Options Video Memory: Text Monitor Ports: High Graphics Emulate Text Mode: yes Other Options Allow Fast Paste: yes TELEMATE 3.01 APPENDIX H: ERROR MESSAGES 79 APPENDIX H: ERROR MESSAGES The following messages are the most common error messages. "Cannot open configuration file" If the configuration file TM.CFG is not in the current directory Telemate will display this message. If you see this message, you should use TMINST.EXE to generate a new configuration file and set the DOS environment string 'TMCFG' to the directory containing TM.CFG. For example, if the Telemate directory is "C:\TM" then the following line should be added to the AUTOEXEC.BAT file: SET TMCFG=C:\TM\TM.CFG "Problem opening resource file" If the resource file TM.RES is not in the Telemate directory or the resource file is invalid, Telemate will display this message. If the directory is incorrect, you can edit TM.CFG and locate the line DirTelemate="" and add the Telemate directory to it and make sure that the TM.RES is in the Telemate directory. "Cannot open TM.FON" The phone directory TM.FON is not in the Telemate directory or has not been created. Execute TMINST.EXE and copy TM.FON to the Telemate directory. "Not enough memory to open dialog" When you encounter this message, you are very low in memory and you should exit Telemate immediately and restart Telemate with the '/O' or '/N' command line option. "RTS/CTS flow control is turned off because CTS is off." When Telemate starts, it checks the RTS/CTS option with the hardware. If the RTS/CTS option is on but the CTS signal is off, Telemate will turn off the RTS/CTS option if the CTS signal is still off after 10 seconds. Otherwise, no communication can go through the line. This message indicates that you may not have your modem turned on or your modem/cable does not have a CTS line. "TMS Compile error" It may be one of the two reasons. . Error is detected in the script file . Not enough memory to execute TMS.EXE. You should exit Telemate and compile the script file in DOS command line. The script compiler will give you detailed information such that you can locate the error in your script. TELEMATE 3.01 APPENDIX I: TELEMATE SUPPORT BBS 80 APPENDIX I: TELEMATE SUPPORT BBS We appreciate suggestions and ideas; most new Telemate features come from users' feedback. In order to provide a means of support, we have made an agreement with several Bulletin Board Systems such that you can find the latest version and a Telemate message area on these BBS's. Board Phone Number Network Baud Location ───────────────── ──────────── ───────── ──────── ─────────────── H.P Systems 313-364-5157 FidoNet 14400DS Michigan USA PC Connect 416-733-9052 SmartNet 2400 Toronto Canada Late Night BBS 315-592-7300 Genesis 14400DS New York USA SouthWest Connect 519-352-7010 14400DS Chatham Canada User To User #1 214-492-6565 RelayNet 14400DS Dallas USA User To User #2 214-492-5695 FidoNet 14400V42 Dallas USA If you have questions, problems or suggestions, you can leave messages to 'WINFRED HU' on these Telemate Support BBS's. Echomail conferences have been set up by these BBS's in FidoNet, GDNet, ILink, IntelecNet, RelayNet and SmartNet, ask your sysop to join them. Telemate National FidoEcho is also available as 'Telemate' from the backbone in region 11. It can be obtain through normal channels in other regions. And you can file request 'telemate' from 1:2202/1. For the international editions, you may contact MicroServe Information eXchange at Board Phone Number Network Baud Location ───────────────── ──────────── ───────── ──────── ─────────────── M.I.X. BBS +49-4298-30086 UUCP 9600 V32 Lilienthal FRG In addition, you can reach the author on the following networks: CompuServe [72070,3515] InterNet 72070.3515@compuserve.com I want to express my appreciation to William Pendergast and Kevin Carr of User To User, John Scarfone of PC Connect, Avery Wegg of SouthWest Connect and Carter Downer of PRISM software for their generous support. I am grateful to Chris Brinker and Michael Cody of Home Plate BBS for starting the Telemate FidoEcho. Also I thank Marko Kohtala of Airline BBS for his contribution and, of course, our registered users and all beta testers. TELEMATE 3.01 INDEX 81 INDEX [Alt -], 16, 55 ASCII protocol, 70 [Alt =], 36 ASCII transfer, 64 [Alt A], 36, 40, 44 Add CR before LF, [Alt B], 44 Add LF after CR, [Alt C], 35, 39 Strip CR, [Alt D], 25 Strip high bit, [Alt E], 37 Strip LF, [Alt F], 23 Translation, [Alt G], 36, 40 Auto answer string, 36, 62 [Alt H], 27, 36 Auto baud detect, 58 [Alt I], 35 Auto dial option, 15 [Alt J], 23 Auto download sequence, 65 [Alt K], 24 Auto indent, 12, 41 [Alt L], 33 Auto log option, 31 [Alt M], 45 Auto redial, 58 [Alt O], 52 Auto script, 16 [Alt P], 34, 40 Auto wrap, 30, 61 [Alt Q], 34, 40, 43, 45 [Alt S], 34 B [Alt T], 32 [Alt U], 39 Back window, 44 [Alt V], 43 Backup source, 13, 41 [Alt W], 19 Batch upload, 33 [Alt X], 24 Batch Ymodem protocol, 69 [Alt Y], 35 Baud rate, 7, 29, 62 [Alt Z], 19 Bell, 56 [Center], 44 BiModem protocol, 69 [Ctrl Up], 44 Break signal, 36, 48 [Ctrl Down], 44 Break string, 58 [Ctrl Left], 24 Busy strings, 58 [Scroll Lock], 45 [Shift Alt C], 40 C [Shift Alt G], 40 [Shift Alt U], 40 Cancel string, 58 Capture, 13, 45 16550 FIFO, 8 Carrier signal, 30, 58, 60 12/24 hour format, 55 CD, 22 CGA, 1, 9 A Character pacing, 64 Chat mode [Alt C], 35 Add line feed, 30, 61 Check boxes, 53 Add return, 30, 61 Check disk space, 63 Alarm, 21, 56 Circular buttons, 53 Alarm song, 12 CIS Quick B protocol, 70 Alarm sound, 56 Clear backscroll buffer, 45 Alarm time, 56 Clear text, 36 Already online options, 15 Clipboard, 24 Alt-keypad table, 46 Closing window, 20 Append entries, 27 CLS, 22 Answer mode, 36, 62 Connect Strings, 58 Answer back string, 62 Color, 13 ASCII code, 48 Com parameter, 6, 29, 62 TELEMATE 3.01 INDEX 82 Com port, 7, 21, 62 E Command line options, 15 Command stack, 35 Edit, 37 Communication options, 62 Edit directory, 59 Confirm hang up, 61 Edit menu, 12, 39 Connection, 30, 50 Edit window, 37 COPY, 22 Editor margin, 30, 38, 55 Copy, 35, 39 EGA, 1, 9, 74 cUt, 39 EMS, 1, 11, 74 EMS Limit, 11 D Ending session, 24 Enhanced keyboard, 46, 57 Data bits, 7, 29, 62 ERASE, 22 Date format, 9, 55 Error messages, 79 Default baud rate, 29 Error pause, 55 Default COM port, 29 Evaluation disks, 3 DEL, 22 Executing Telemate, 14 Deleting text, 37 Expand blank line, 34, 64 Desqview, 77 Expanded memory, 1, 11, 74 Destructive Backspace, 30, 61 Extended memory, 1, 10, 74 Dial menu, 26 Extended pacing, 64 Dial options, 57 External alarm, 56 Dial prefixes, 7, 30, 58 External protocol dialog, 64 Dial setup dialog, 57 External protocols, 71 Dial suffix, 7, 30, 58 Dial time, 58 F Dial window, 25 Dialing functions, 26 File directory, 23 DIR, 22 Filename guessing, 63 Directory dialog, 56 Filter, 41 Directory functions, 25 Find, 27, 41 Directories and files, 59 Format of phone directory, 73 Disclaimer, 3 Full screen option, 16 Doorway mode, 36 DOS command window, 22 G CD COPY General dialog, 54 CLS General options, 54 DIR Goto, 27, 41 DEL Guess initial, 30 ERASE INS, INSIDE H MOVE REN, RENAME Hang up, 27, 36, 48, 50, 62 TYPE Help, 21 Download batch, 65 Hot key macro symbol, 50 Download directory, 59 Downloading files, 33 TELEMATE 3.01 INDEX 83 I Message pause, 55 Modem init string, 48, 62 Image directory, 59 Modem hangup string, 48, 62 Image file, 35 Modem7 protocol, 69 Initial guessing, 30, 34, 61 Monochrome, 9 Installation program, 6 Mouse, 1, 9, 17, 57 INS, INSIDE, 22 Mouse port, 10, 57 International edition, 3, 80 Mouse type, 10, 57 Mouse speed, 10, 57 J MOVE, 22 Moving windows, 19 Jump to DOS, 23 Multiple line, 58 Multithreading, 1 K Multi-user license, 3 Music, 56 Kermit protocol, 63, 70 Key (external protocol), 65 N Keyboard table, 46 Keypad table, 46 Name (external protocol), 65 Keystroke macro symbol, 49 New, 40 Next, 27, 41 L O Learning script, 34 License, 2 Option dialogs, 52 Line pacing, 64 Originate mode, 36, 48 Load phone directory, 16, 27 Loading files, 40 P Loading macros, 51 Loading options, 53 Pace character, 64 Local echo, 30, 61 Parity, 7, 29, 62 Log directory, 59 Password, 35, 48 Log filter, 33, 56 Paste, 40 Log heading, 33, 56 Phone directory, 73 Logging sessions, 33 Clear total Long distance, 30, 72 Copy entry Create new directory M Delete entry Insert entry Macro menu, 47 Print directory Macro symbols, 48 Reorder entries Macro table, 46 Sort directory Macro window, 46 Zap connect date Manual dial, 27 Printer log, 36 Margins, 38 Printing files, 24 Mark, 39 Prompt download name, 65 Maximum DOS shell, 55 Protocol, 8, 32, 63, 64 Memo, 21, 28 Protocol options, 53 Menu, 19 Puma protocol, 65 Menu bar, 19, 55 TELEMATE 3.01 INDEX 84 Q T Quote, 34, 40, 43, 45 Tag, 24, 40 Quote margin, 34, 40 Tag separator, 31, 40 61 Quote prefix, 61 Telemate directory, 59 Telink protocol, 69 R Terminal command stack, 35 Terminal options, 60 Recalling command, 35 Terminal types, 30, 60 Receiving files, 33 Terminal window, 32 Redefining the keyboard, 51 Text Boxes, 54 Redial attempt, 58 TMPhone, 27, 73 Redial pause, 58 TMStat, 30, 72 Reformat, 41 Translation, 46 Registration, 2 Transferring files, 32 Relaxed Xmodem protocol, 69 TYPE, 22 REN, RENAME, 22 Type ahead, 35 Replace, 41 Resizing windows, 20 U Revise script, 27 RTS/CTS flow control, 8, 61 Upload batch, 65 Upload directory, 59 S Uploading files, 32 Usage log, 56, 72 Save dial list, 26 Using scripts, 34 Saving files, 40 Saving keyboards, 51 V Saving keypads, 51 Saving macros, 51 VGA, 1, 9, 74 Scroll lock, 45 Video displays, 9 Saving options, 53 Video height, 9 Saving Windows, 53 Video RAM, 1, 11, 74 Screen saver, 56 View directory, 59 Script, 34 View window, 43 Script compile error, 79 Virtual memory, 1, 59, 74 Script directory, 59 Scroll bars, 9, 18, 55 W Scroll back limit, 55 SEAlink protocol, 69 Windows, 19 Selecting windows, 19 Closing Sending files, 32 Moving Shareware, 2 Resizing Snow checking, 9 Selecting Starting windows, 19 Starting Status line, 37, 55 Zooming Strip high bit, 31, 61 Wordstar convention, 39 Stop bits, 7, 29, 62 Write, 41, 44 Support BBS, 80 Write directory, 59 Swap left/right buttons, 57 Swap Telemate to disk, 54 Swap Telemate to Xms/Ems, 54 TELEMATE 3.01 INDEX 85 X Xmodem protocol, 69 Xmodem protocol, Relaxed, 69 Xmodem-1K protocol, 69 XMS, 1, 10, 74 XMS himem, 10 XMS limit, 10 XON/XOFF flow control, 8, 61 Y Ymodem protocol, 69 Ymodem protocol, Batch, 69 Ymodem-G protocol, 69 Z Zooming windows, 19 Zmodem protocol, 69 Zmodem ascii-upload, 63 Zmodem auto-download, 63 Zmodem recovery, 63