Programmer 7500

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

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / TM211_3.ZIP / TELEMATE.DOC < prev next >

Wrap

Text File | 1990-05-25 | 202.4 KB | 4,624 lines

====== Telemate 2.11 ============================== Order Form ====== Please send cheque or money order payable in US or CAD to "Tsung Hu", overseas order in money order. (Note that the current postage from US to Canada is $0.30.) Mr. Tsung Hu P.O.Box 938, Unit 105 St. Catharines, Ontario L2R 6Z4 Canada --------------------------------------------------------------------- Qty. Item US/CAD Amount ___ Telemate Registration @ $40/$48 $________ (with registered version and document on disk) ___ Evaluation disk @ $8/ $9 $________ (not registration) Less ___% discount for over 10 registrations $(______) Add $1 per copy for 3.5 disk $________ Shipping and handling outside US and Canada @ $4 $________ Total US$________/CAD$________ Signature ______________________________ Name ____________________________________________________________ Address ____________________________________________________________ ____________________________________________________________ Country _____________________ Phone (______)_____________________ Where did you obtain Telemate ?______________________________________ Comments ____________________________________________________________ _____________________________________________________________________ ===================================================================== ▌█████████ ▌██████ ▌█▌ ▌██████ ▌█████████▌ ▌███████▌ ▌█████████ ▌██████ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█████▌ ▌█▌ ▌█████▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌▌████▌ ▌█▌ ▌█████▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█ ▌█▌ ▌██████ ▌██████ ▌██████ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌█▌ ▌██████ Version 2.11 By Tsung Hu Documentation By Allan Smith Copyright (c) 1988-1990 Tsung Hu. All rights reserved. TELEMATE 2.11 TABLE OF CONTENTS i TABLE OF CONTENTS INTRODUCTION 1 What's Special? . . . . . . . . . . . . . . . . . . . . . . . . 1 REGISTRATION 2 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Multi-user License . . . . . . . . . . . . . . . . . . . . . . 3 German 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Alarm Song . . . . . . . . . . . . . . . . . . . . . . . . . . 11 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 Auto Dial Option /D . . . . . . . . . . . . . . . . . . 15 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 2.11 TABLE OF CONTENTS ii USING TELEMATE'S WINDOWS [Alt W] 19 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Starting a Window . . . . . . . . . . . . . . . . . . . . . . . 19 Pull Down Menus . . . . . . . . . . . . . . . . . . . . . . . . 19 Zooming a Window . . . [Alt Z] . . . . . . . . . . . . . . . . 19 Moving a Window . . . . . . . . . . . . . . . . . . . . . . . . 20 Resizing a Window . . . . . . . . . . . . . . . . . . . . . . . 20 Closing a Window . . . . . . . . . . . . . . . . . . . . . . . 20 Selecting 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] . . . . . . . . . . . . . . . . . 26 Find . . . . . . . . . [F4] . . . . . . . . . . . . . . . . . 26 Next . . . . . . . . . [F5] . . . . . . . . . . . . . . . . . 26 Edit . . . . . . . . . [F6] . . . . . . . . . . . . . . . . . 26 Goto . . . . . . . . . [F7] . . . . . . . . . . . . . . . . . 31 Manual Dial . . . . . . [F8] . . . . . . . . . . . . . . . . . 31 Revise Script . . . . . [F9] . . . . . . . . . . . . . . . . . 31 Append Entries . . . . [F10] . . . . . . . . . . . . . . . . . 31 Hang Up . . . . . . . . [Alt H] . . . . . . . . . . . . . . . . 31 Learn Script . . . . . [Alt N] . . . . . . . . . . . . . . . . 31 THE TERMINAL WINDOW [Alt T] 32 The Terminal menu . . . . . . . . . . . . . . . . . . . . . . . 32 Sending files . . . . . [Page Up] . . . . . . . . . . . . . . . 32 The Protocol Selection Menu . . . . . . . . . . . . . . . . . . 32 The File Selection Box . . . . . . . . . . . . . . . . . . . . 33 The File Transfer Window . . . . . . . . . . . . . . . . . . . 33 Receiving Files . . . . [Page Down] . . . . . . . . . . . . . . 33 Logging Sessions . . . [Alt L] . . . . . . . . . . . . . . . . 34 Using Scripts . . . . . [Alt S] . . . . . . . . . . . . . . . . 34 Learning Script . . . . [Alt N] . . . . . . . . . . . . . . . . 34 Paste . . . . . . . . . [Alt P] . . . . . . . . . . . . . . . . 35 Quote . . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 35 Image Files . . . . . . [Alt I] . . . . . . . . . . . . . . . . 35 Command Stack . . . . . [Alt Y] . . . . . . . . . . . . . . . . 35 TELEMATE 2.11 TABLE OF CONTENTS iii Originate Mode . . . . [Alt G] . . . . . . . . . . . . . . . . 36 Answer Mode . . . . . . [Alt A] . . . . . . . . . . . . . . . . 36 Chat Mode . . . . . . . [Alt C] . . . . . . . . . . . . . . . . 36 Doorway Mode . . . . . [Alt =] . . . . . . . . . . . . . . . . 37 Hang Up . . . . . . . . [Alt H] . . . . . . . . . . . . . . . . 37 Clear Text . . . . . . [Ctrl Home] . . . . . . . . . . . . . . 37 Break Signal . . . . . [Ctrl End] . . . . . . . . . . . . . . 37 Printer Log . . . . . . [Ctrl PrtSc] . . . . . . . . . . . . . 37 THE EDIT WINDOW [Alt E] 37 Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Moving Around . . . . . . . . . . . . . . . . . . . . . . . . . 37 Deleting Text . . . . . . . . . . . . . . . . . . . . . . . . . 38 Working With Text Blocks . . . . . . . . . . . . . . . . . . . 38 Mouse Movements . . . . . . . . . . . . . . . . . . . . . . . . 38 Margins . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Wordstar Conventions . . . . . . . . . . . . . . . . . . . . . 39 The Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . 39 Mark . . . . . . . . . [F10] . . . . . . . . . . . . . . . . . 40 Copy . . . . . . . . . [Alt C] [Shift Alt C] . . . . . . . . . 40 cUt . . . . . . . . . [Alt U] [Shift Alt U] . . . . . . . . . 40 Paste . . . . . . . . . [Alt P] . . . . . . . . . . . . . . . . 40 Quote . . . . . . . . . [Alt Q] . . . . . . . . . . . . . . . . 40 Write . . . . . . . . . [Alt A] . . . . . . . . . . . . . . . . 41 New . . . . . . . . . . [Alt N] . . . . . . . . . . . . . . . . 41 Saving Files . . . . . [F2] . . . . . . . . . . . . . . . . . 41 Loading Files . . . . . [F3] . . . . . . . . . . . . . . . . . 41 Find . . . . . . . . . [F4] . . . . . . . . . . . . . . . . . 41 Next . . . . . . . . . [F5] . . . . . . . . . . . . . . . . . 41 Replace . . . . . . . . [F6] . . . . . . . . . . . . . . . . . 41 Goto . . . . . . . . . [F7] . . . . . . . . . . . . . . . . . 42 Filter . . . . . . . . [F8] . . . . . . . . . . . . . . . . . 42 Reformat . . . . . . . [F9] . . . . . . . . . . . . . . . . . 42 Macro Keys . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Auto Indent . . . . . . . . . . . . . . . . . . . . . . . . . . 42 Backup Source . . . . . . . . . . . . . . . . . . . . . . . . . 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] . . . . . . . . . . . . . . . . 44 Scroll Lock . . . . . . [Scroll Lock] . . . . . . . . . . . . . 45 Capture . . . . . . . . [Ins] . . . . . . . . . . . . . . . . . 45 Clear Buffer . . . . . [Alt N] . . . . . . . . . . . . . . . . 45 TELEMATE 2.11 TABLE OF CONTENTS iv THE MACRO WINDOW [Alt M] 46 The Macro Table . . . . . . . . . . . . . . . . . . . . . . . . 46 The Keypad Table . . . . . . . . . . . . . . . . . . . . . . . 46 The Keyboard Table . . . . . . . . . . . . . . . . . . . . . . 46 The Macro Window . . . . . . . . . . . . . . . . . . . . . . . 46 The Macro Menu . . . . . . . . . . . . . . . . . . . . . . . . 47 Defining Macros . . . . . . . . . . . . . . . . . . . . . . . . 47 Macro Symbols . . . . . . . . . . . . . . . . . . . . . . . . . 48 The '^=' Hot Key Macro Symbol . . . . . . . . . . . . . . . . . 49 The '^\' Run Script Macro Symbol . . . . . . . . . . . . . . . 49 Redefining the Keyboard . . . . . . . . . . . . . . . . . . . . 49 Loading and Saving Macros, Keypads and Keyboard . . . . . . . . 50 THE OPTION DIALOGS [Alt O] 51 The Options Menu . . . . . . . . . . . . . . . . . . . . . . . 51 Saving and Loading Options . . . . . . . . . . . . . . . . . . 52 Saving Windows . . . . . . . . . . . . . . . . . . . . . . . . 52 How to Make Changes . . . . . . . . . . . . . . . . . . . . . . 52 General Options . . . . . . . . . . . . . . . . . . . . . . . . 53 Dial Options . . . . . . . . . . . . . . . . . . . . . . . . . 55 Directories and files . . . . . . . . . . . . . . . . . . . . . 56 Terminal Options . . . . . . . . . . . . . . . . . . . . . . . 58 Communication Options . . . . . . . . . . . . . . . . . . . . . 60 Protocol Options . . . . . . . . . . . . . . . . . . . . . . . 61 APPENDIX A: FILE TRANSFER PROTOCOLS 64 APPENDIX B: DEFINING EXTERNAL PROTOCOLS 66 APPENDIX C: USAGE LOG 67 APPENDIX D: THE PHONE DIRECTORY 69 APPENDIX E: MEMORY MANAGEMENT 70 APPENDIX F: ERROR MESSAGES 77 APPENDIX G: TELEMATE SUPPORT BBS 78 INDEX 79 TELEMATE 2.11 INTRODUCTION 1 INTRODUCTION In the past I have used several communication software packages but I was not satisfied with their performance. Each one lacked basic features which I considered essential to telecommunications, therefore I decided to write my own one. I hope that you find Telemate exciting, and that you use it and support it. What's Special? Integrated Environment: Telemate is much more than a tele- 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. Multitasking: Telemate has multitasking features 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 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. Protocols: Telemate has the most popular protocols built-in, including Zmodem, Ymodem-G, SEAlink and CompuServe QuickB. And there are four slots for external protocols. Easy-to-learn Script Language: Writing a Telemate's script program is as simple as writing a BASIC program. If you don't have any experience on programming, don't worry. 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. There must be one that will fit your eyes. EMS, XMS, Video Ramsupport: Telemate uses expanded memory,extended memory and EGA/VGA video RAM as virtual memory to store data. TELEMATE 2.11 REGISTRATION 2 REGISTRATION Telemate is not free. You must register after the 30-day evaluation time 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 time period you must register it. Registration Fee : $ 40.0 US or $ 48.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. 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. Disk distributors of Shareware or User-Supported software 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, the distributors have to obtain a written permission from the author. TELEMATE 2.11 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 @ $ 40 (no discount) 11 - 20 @ $ 36 10 % 21 - 50 @ $ 32 20 % 51 - 100 @ $ 28 30 % 101 - 200 @ $ 20 50 % 200+ $ 6000 (one time fee) German Edition Telemate German Edition is also available from MicroServe GmbH. Please call for details. MicroServe GmbH Lehrer-Laempel-Weg 41 D-2800 Bremen West 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 the author. Many specific products found in this manual are trademarks of specific companies. TELEMATE 2.11 GETTING STARTED 4 GETTING STARTED Requirements Telemate requires an IBM PC/AT/fully compatible computer, PC-DOS or MS-DOS versions 2.11 or greater, a minimum of 480K of memory and a modem. (Actually a modem is optional. Telemate can be used to connect two computers directly to each other at the maximum baud rate of 115200.) 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 up to 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 TELEMATE 2.11 GETTING STARTED 5 6) Place the disk #3 in drive A and copy the Telemate files to this directory by typing COPY A:\*.* C:\TM The Telemate files will be copied to the Telemate directory. After the files are successfully copied remove the disk from drive A and place it in a safe place. 7) To start the installation program type TMINST and press [Enter]. Moreover, adding the line SET TMCFG=C:\TM\TM.CFG in your AUTOEXEC.BAT batch file will help Telemate in locating the configuration file such 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 assuming COMMAND.COM is in C:\DOS directory. TELEMATE 2.11 THE INSTALLATION PROGRAM 6 THE INSTALLATION PROGRAM One of Telemate's great strengths is its flexibility. Telemate gives you control over many of its features. With the installation program TMINST.EXE you can individualize such things as window colors; turn features on or off; select a default communications protocol, etc. Once you have started the installation program the following will appear on your screen. ┌─── Main Menu ────┐ │ COM Parameter │ Telemate Installation Program │ Display │ │ Mouse │ Version 2.11 │ Memory │ │ Alarm Song │ Copyright (c) 1988-1990 Tsung Hu. │ Menu Bar │ │ Menu │ All rights reserved. │ Help Window │ │ Dial Window │ │ Terminal Window │ │ Transfer Window │ │ Edit Window │ │ View Window │ │ Back Window │ │ Macro Window │ │ Option Dialog │ │ End Installation │ └──────────────────┘ Com Parameter ┌── COM Para ──┐ When you select "Com Parameter" │ COM Port │ a 2nd menu appears to enable │ Baud Rate │ you to install Telemate so that │ Parity │ it works perfectly with your │ Data Bits │ equipment. │ Stop Bits │ │ Dial Prefix │ To choose a selection highlight │ Dial Suffix │ the option desired and press │ Protocol │ [Enter]. │ Flow Control │ └──────────────┘ Com Port ┌── COM Para ──┐ Telemate supports the use of up to │ COM Port │ 8 communications ports. Most users │ Baud Rat┌───────┐ have their modems connected to │ Parity │ COM 1 │ COM 1, the computer's serial port. │ Data Bit│ COM 2 │ If you have an external modem it │ Stop Bit│ COM 3 │ probably connected to COM1. If │ Dial Pre│ COM 4 │ you are using an internal modem │ Dial Suf│ COM 5 │ it will probably be COM2 or COM3. │ Protocol│ COM 6 │ │ Flow Con│ COM 7 │ └─────────│ COM 8 │ └───────┘ TELEMATE 2.11 THE INSTALLATION PROGRAM 7 Baud Rate ┌── COM Para ──┐ │ COM Port │ Baud rate refers to the speed at │ Baud Rate │ which communications take place. │ Parity ┌────────┐ Check your modem manual if you are │ Data Bit│ 300 │ unsure regarding what speed it is. │ Stop Bit│ 1200 │ If you are using Telemate to connect │ Dial Pre│ 2400 │ computers directly together without │ Dial Suf│ 4800 │ modems, it is possible to use the │ Protocol│ 9600 │ maximum baud rate of 119,200. │ Flow Con│ 19200 │ └─────────│ 38400 │ │ 57600 │ │ 119200 │ └────────┘ Parity ┌──────┐ Telemate's default setting is None. │ None │ The vast majority of BBS's are set │ Odd │ up for no parity. To change this │ Even │ setting highlight the choice you └──────┘ desire and press [Enter]. Data Bits / Stop Bits ┌─────┐ ┌─────┐ Data bits refer to how much data is │ 7 │ │ 1 │ sent before a stop bit is sent. Data │ 8 │ │ 2 │ is normally sent in chunks of 9 bits, └─────┘ └─────┘ 8 data bits and 1 stop bit. Some BBS's computers may however be set up for 7 data bits and 2 stop bits. Dial Prefixes and Dial Suffixes ┌── COM Para ──┐ Dial Prefixes refer to the signal Telemate │ COM Port │ sends just prior to dial a number for you. │ Baud Rate │ If you have a pulse phone (check with your │ Parity │ phone company if you are not sure) choose │ Data Bits │ "ATDP". If you have touch tone phone │ Stop Bits │ service then select "ATDT". │ Dial Prefix │ │ Dial Suffix │ Dial Suffixes refer to the signal │ Protocol┌──────────────────────┐ Telemate sends after the phone │ Flow Con│ ATDP │ number. └─────────│ ATDT │ │ ATDT 001, │ Both prefixes and suffixes can be │ ATDT 9, │ modified in Telemate's option └──────────────────────┘ dialog. TELEMATE 2.11 THE INSTALLATION PROGRAM 8 Protocol ┌────────────────┐ │ Zmodem │ Protocol refers to the method Telemate │ SEAlink │ uses to transfer data. This option allows │ Telink │ you to choose a default protocol, but │ Ymodem │ you can use any of the protocols to │ Ymodem-G │ download data. The default setting │ Batch Ymodem │ is only your first choice. Telemate's │ Xmodem │ default setting is Zmodem as it is │ Modem7 │ both fast and safe. A description │ Relaxed Xmodem │ of the different protocols can be │ ASCII │ found in the Appendix. │ CIS Quick B │ └────────────────┘ Flow control ┌── COM Para ──┐ XON/XOFF software flow control is usually │ COM Port │ used by networks while the RTS/CTS hardware │ Baud Rate │ control is used by high speed modems. │ Parity │ │ Data Bits │ If the modem is an error correction modem, │ Stop Bits │ such as a MNP modem, RTS/CTS should be │ Dial Prefix │ ON, XON/XOFF should be off. │ Protocol │ │ Flow Control │ 16550 FIFO refers to the first in/first out └─────────┌────────────────┐ data buffer of NS16550AN UART chip. │ XON/XOFF OFF │ If your serial adapter is equipped │ RTS/CTS OFF │ with the chip, you should turn it ON │ 16550 FIFO ON │ to prevent data overrun due to disk └────────────────┘ access or overhead of multitasker. Displays ┌─── Display ────┐ Telemate supports a variety of video displays. │ Video Type │ You can use Telemate with Mono, Color, EGA or VGA │ Video Height │ adapters. │ Scroll Bar ON │ │ Snow Check ON │ Telemate allows you to choose from 3 video types: └────────────────┘ Default determines what adapter you have and adjusts accordingly. If you are using a CGA with a black and write monitor, you should choose B&W to override the color setup. TELEMATE 2.11 THE INSTALLATION PROGRAM 9 Video Height ┌─── Display ────┐ │ Video Type │ Telemate lets you choose from │ Video Height │ a variety of video heights. │ Scroll B┌────────────────┐ Video heights refers to the │ Snow Che│ 25 │ number of lines of text on your └─────────│ 26 CGA,EGA,VGA │ screen. I personally use 27 lines: │ 27 CGA,EGA,VGA │ 1 line for the menu bar, 1 for │ 28 CGA,EGA,VGA │ the bottom status line and 25 │ 29 CGA │ for the text. │ 30 CGA │ │ 31 CGA │ Note: The terminal window has at │ 32 CGA │ least 24 lines though only 23 lines │ 35 EGA,VGA │ may be displayed. The window will │ 43 EGA,VGA │ be shift up or down automatically │ 50 EGA,VGA │ to adjust to the display region. └────────────────┘ Scroll Bar and Snow Check 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 ON │ display speed will be improved if this option └────────────────┘ is OFF. Note: This option applies to CGA only. Mouse ┌─── Mouse ───┐ Telemate is designed to work │ Mouse Type │ intuitively with a mouse. │ Mouse Port │ To insure that Telemate works │ Mouse Speed │ properly with your mouse └─────────────┘ you need to tell Telemate what kind of mouse you are using, what port it is connect to, and whether you want it accelerated or not. Mouse Type ┌─── Mouse ───┐ Telemate supports only two │ Mouse Type │ types of mice but almost every │ Mouse Po┌──────────────┐ mouse ever made emulates one │ Mouse Sp│ None │ of these two, and many emulate └─────────│ Mouse System │ both. │ MS Mouse │ └──────────────┘ TELEMATE 2.11 THE INSTALLATION PROGRAM 10 Mouse Port ┌── Mouse ───┐ Mouse port refers to which │ Mouse Type │ serial port your mouse is │ Mouse Port │ connected to. If your mouse is │ Mouse Sp┌───────┐ a Microsoft mouse there is no └─────────│ None │ need to select a port. │ COM 1 │ │ COM 2 │ └───────┘ Mouse Speed ┌─── Mouse ───┐ If you find that the mouse cursor │ Mouse Type │ is too fast, you can slow it down │ Mouse Port │ by selecting the Slow option. On │ Mouse Speed │ the other hand, some mice need to └─────────┌────────┐ speed up, then select the Fast option. │ Fast │ │ Medium │ │ Slow │ └────────┘ 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 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 you │ 48K │ have, simply select 8M and Telemate will use as │ 64K │ much extended memory as possible. │ 80K │ │ 128K │ If you want to specify the XMS limit which is not listed │ 256K │ in this menu you can modify the line │ 512K │ │ 1M │ XmsLimit=8096 │ 2M │ │ 4M │ in your configuration file, TM.CFG, to the amount of │ 8M │ memory you want. └──────┘ TELEMATE 2.11 THE INSTALLATION PROGRAM 11 EMS Limit ┌──────┐ Telemate can address up to 8M bytes of EMS memory. │ 0K │ It supports both EMS 3.2 or 4.0 driver. If you are │ 16K │ not sure how much expanded memory you have simply │ 32K │ select 8M and Telemate will use as much memory as │ 48K │ possible. │ 64K │ │ 80K │ If you want to specify the EMS limit which is not listed │ 128K │ in this menu you can modify the line │ 256K │ │ 512K │ EmsLimit=8096 │ 1M │ │ 2M │ in your configuration file, TM.CFG to the amount of memory │ 4M │ you want. Make sure 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 mode, │ Xms Himem ON │ about 30K extra memory is required to store │ Xms Limit │ the windows. The best way to obtain the │ Ems Limit ┌─────┐ 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, the 32K mode should be selected for compatibility. Please refer to Appendix for technique reference. If Telemate is running under DESQView or in 132 columns mode, this option is forced to 0K automatically in order to maintain compatibility. Alarm Song If you find that the default ┌────── Alarm Song ───────┐ alarm song, buzzer, is too │ Play Song ON │ boring or not loud enough │ Buzzer │ you can change it to one of │ Adams Family │ the songs listed in the alarm │ Auld Lang Syne │ song menu. │ Beverly Hills Cop │ │ Beverly Hillbillies │ If the first item, Play Song, is │ Deck the Halls │ turned to ON, the song will be │ Flight of the Bumblebee │ played when you select it. If │ Folk Song │ this option is OFF, the │ I'm A Little Teapot │ installation program will remain │ James Bond Theme │ silent. │ Jeopardy Theme │ │ Leave it to Beaver │ │ London Bridge │ TELEMATE 2.11 THE INSTALLATION PROGRAM 12 │ Maple Leaf Rag │ │ My Darling Clementine │ │ Ramblin' Wreck │ │ The Entertainer │ │ Violin Sonata #6 │ │ Well-Tempered Clavier │ │ William Tell Overture │ └─────────────────────────┘ Window Displays The remaining options on the Installation Menu are designed to allow you to change Telemate's window colors and size. If you have a black & 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. ┌─── Main Menu ────┐ │ COM Parameter │ │ Display │ When you select a window to change │ Mouse │ a small menu appears to allow you │ Memory │ to change the colors of the various │ Alarm Song │ elements that constitute that │ Menu Bar │ window. In the Edit window you can │ Menu │ alter the color of the normal text, │ Help Window │ the window border, marked text, the │ Dial Window │ status line, and the error message. │ Terminal Window │ The Zoom option lets you determine │ Transfer Window │ how big you want the window to be │ Edit Window │ when it is first invoked. │ View W┌──── Edit ─────┐ Telemate's default setting is │ Back W│ Normal Text │ for the Terminal and Dial │ Macro │ Border │ windows to be full size with │ Option│ Marked Text │ the other windows half sized. │ End In│ Status Line │ Use the [Enter] key to toggle └───────│ Error Message │ the Zoom option. │ Zoom OFF │ │ Indent OFF │ Several options are unique to │ Backup OFF │ 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 left margin instead of the beginning of the line. This is useful for programming Telemate scripts as well as the other languages. 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. TELEMATE 2.11 THE INSTALLATION PROGRAM 13 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 should be set to OFF in order to prevent disk access. Selecting Color ┌───── Color Pattern ──────┐ │ │ 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 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 x x x x x x x │ └──────────────────────────┘ Ending your installation ┌──── End ────┐ │ Save Setup │ The last choice you have to make is │ Abort │ whether to save the changes you have made └─────────────┘ to the configuration file and create a phone directory TM.FON if it is not already exist or to abort the changes. Highlight the choice you desire and press [Enter]. Your installation is complete; you are now ready to run Telemate. TELEMATE 2.11 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.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 run *.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 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. A:\ TM.OVL, TM.CFG, TM.FON, TM.MEM, TM.CFG 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 editor to delete the empty entries. After putting the files in the diskettes, you should 1) Place Telemate disk #1 in A: drive and disk #2 in B: drive. 2) Press B:TM on the DOS command line because the main program TM.EXE is in disk #2. TELEMATE 2.11 EXECUTING TELEMATE 15 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: as 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 on, 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. Auto Dial Option /D Telemate starts the dialing procedure after sending the modem initialization string. TELEMATE 2.11 EXECUTING TELEMATE 16 Full Screen Option /F [Alt -] If the Full Screen Option is on, Telemate's windows hide the menu bar. If you are, for example, editing a file and need the extra line, this option gives you back that extra line. In addition, pressing [Alt -] 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 "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 2.11 IF YOU HAVE A MOUSE 17 IF YOU HAVE A MOUSE Telemate is designed so that most of its functions can be easily accessed by using a mouse,without ever having to touch the keyboard. If you do not have a mouse you needn't worry: You can fully use Telemate's power and shortcut keys to speed you through Telemate's many functions. If, on the other hand, you do have a mouse you will find Telemate extremely easy and fun to use. Telemate has been tested with a variety of mice without problems. It can operate with both two button and three button mice and has been successfully tested with the Microsoft Mouse and the MouseSystem Mouse. To use a MouseSystem compatible mouse with Telemate, simply start the program. YOU DO NOT NEED TO LOAD A MOUSE DRIVER. If your mouse is a Microsoft Mouse or is not MouseSystem compatible you will need to load your mouse driver program before starting Telemate. Then grab your mouse and go! 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, Backscroll windows SELECT in the Dial & Macro windows, and Menus CUT and PASTE text in Terminal windows 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 2.11 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 edges makes things happen! 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 active window (the one most recently opened) has an enlarged right side and bottom border. These borders are the window's scroll bars. To scroll vertically with the mouse, point at "scroll box" (the dark box on right side 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. For example if you wish to go to a point approximately halfway through your file, drag the dark box halfway to the bottom of the scroll bar and release. 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 2.11 USING THE TELEMATE'S WINDOWS 19 USING THE TELEMATE'S WINDOWS [Alt W] The secret behind Telemate's ease of use is its windows. Each major function is performed in a separate window. The main 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 hand corner. Basics Windows in computer programs function somewhat like their real-life namesakes - they allow you to see into the program's information. And just as in real-life there may be more on the other side of the wall than you see through the window, so also with computer windows. A window allows you to see and interact with the data on the other side; how much you can see and interact with is limited by the size and position of the window. To gain access to more information you can resize, move or zoom the windows. 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. Pull Down Menus If you type the Alt-letter sequence twice the pull down menu for that window also appears on the screen. If, while depressing the [Alt] key, you hit the letter 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. Click on the option you desire. Zooming a Window [Alt Z] Zooming in on a window (i.e., to have a window take up the entire screen) can be accomplished in two ways. The fastest method is to hit the [Alt Z] key. Immediately the window you are in fills the screen. Invoking the Window menu by striking [Alt W], using the cursor key to move the highlight bar over the command "Zoom", and then hitting the [Enter] key also accomplishes this. Mouse: Clicking the mouse on the top right hand corner of the window immediately invokes the "Zoom" feature. TELEMATE 2.11 USING THE TELEMATE'S WINDOWS 20 Moving a Window It is inevitable, when you have more than one window open at a time, that one window may cover up other information on the screen. For example, if you are downloading a file the status box showing your progress may be covered up by the Edit window. In order to see how the download is progressing you can move and/or resize the Edit window. To move a window, strike the [Alt W] key to call up the Windows menu. Move the bar over the word "Move" and hit [Enter]. The window border becomes larger. Simply use the cursor keys (arrow keys) to move it to where you want it and hit [Enter]. 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. With the window open, invoke the Window menu by hitting [Alt W]. Next type the letter R for Resize (or move the highlight bar over the word "Resize" and hit [Enter].) Again the Window border is enlarge. Using Arrow keys to resize it and 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. The last window opened disappears from the screen. Mouse: Hit the [Esc] button. Clicking on the upper left corner of the window also closes the window. Selecting a Window When a window is already on the screen, pressing the [Alt] key and the first letter of the window's name (for example [Alt E], for the Edit window) moves that window to the top of all the other windows -- making it the "active" window. Mouse: You can select a window by moving the mouse cursor inside the window and clicking. TELEMATE 2.11 GETTING HELP WHEN YOU NEED IT 21 GETTING HELP WHEN YOU NEED IT [F1] Whenever you need Help, it is just a keystroke away. Anytime you need help press [F1] and a context sensitive help appears on screen. Using a mouse, point at the '≡' symbol on the left end of the main menu bar and click. There is usually more help than is immediately visible in the window at any one time. Scroll downward in the window for more details. Pressing the [F1] key again brings you to the next topic. ╔═══════════════════════════════ Help ═════════════════════════════╗ ║ Line 350 Col 1 Total 501 TM.HLP HELP ║ ║ Back ║ ║ ---- ║ ║ 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] ║ ║ 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: Script: PCBOARD ║ ║ Memo: File Log: Off ║ ║ Alarm: Printer Log: On ║ ║ Port: COM2 Date: 2-12-1989 Online: 00:00:00 ║ ║ Para: 2400N81,ANSI Time: 4:25:06pm Offline: 00:08:55 ║ ╚══════════════════════════════════════════════════════════════════╝ The Help Window consists of two sections. The upper section is a text window in which the Help file appears. You can page through this file using your mouse and the scroll bar on the right side of the window, or with your [PgUp], [PgDn] keys. The lower portion of Telemate's help window is a communications Status Center. It displays: 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 Window. 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. Port: COM port you are connected to. Para: COM parameters and terminal emulation. Date: Today's date . Time: Current time. Online: Time currently online. Offline: Time currently offline. TELEMATE 2.11 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 Window [Alt R] This is a full screen DOS command function. Several DOS commands can be executed without shelling to DOS and three commmands 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 will be preserved and shown in the window. This window also stores the last 10 commands. You can recall them by pressing [Up] keys. ╒═══════════════╤════════════════════════════════════════════════╕ │ 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 │ │ │ or .LZH 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 REN command can only rename one file each time. In these cases, 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. ╒═════════════════════╤══════════════════════════════════════════╕ │ 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 * │ Without the extension, it searches all │ │ │ .ZIP, .PAK, .ARC and .LZH files │ TELEMATE 2.11 SYSTEM FUNCTIONS 23 ├─────────────────────┼──────────────────────────────────────────┤ │ ; │ Jump to DOS (no swapping) │ │ ;CHKDSK │ Run CHKDSK (no swapping) │ ├─────────────────────┼──────────────────────────────────────────┤ │ TMSTAT TM.USE │ Run TMSTAT (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 the File Dialog appears, the file names and directories are displayed in columns in the list box. However, you can display all the information of the files, say the size, transfer time, and date and time of the files. Press the [Tab] key to move the cursor to the check box prompted "Display All Information", then press [Spacebar] to toggle the display. After that, all the information of the files are shown in rows in the list box. Mouse: Point at the check box prompted "Display All Information" and click the mouse button. TELEMATE 2.11 SYSTEM FUNCTIONS 24 Short-cuts [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] will clear the File Name box. [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 the "..\" takes you to the parent directory and eventually to the root directory. You can navigate from there and retrieve any file on your hard disk. Clipboard [Alt K] This command lets you view or print the content of 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" item in the Window menu. TELEMATE 2.11 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' or '/O' command line option. Telemate's phone directory can hold up to 1000 entries. Default is 100 entries. You could change the size by using TMPHONE.EXE. Directory Functions Telemate's phone directory has that rare combination of power, flexibility and ease of use. Each phone directory can handle 1000 entries; and you can have multiple directories. Each directory listing is wider than your screen. A directory entry consists of: Name, Password, Phone number, Script, Log, Parameters, Total, Last Connect date, and Memo. On a standard screen you can see only the four entries, i.e., Name, Total, Last and Memo. To see the other entry categories simply hit the [Right] or [Left] arrow keys. Input Entry Number - Type the number corresponding to the directory entry you wish to dial. Press [Spacebar] will select the entry under the dial bar. Hit [Enter] to accept this choice. You may enter more than one choice; to do so separate them by a space. [Enter]: The directory entry you previously chose reappears. Hit [Enter] 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 computer's screen. Hitting the left or right arrows show you the portions of the directory not currently on the screen. Using these arrows you display exactly the portions of the directory you are interested in. The first column (the names) always remains on screen so you know what entry you are dealing with. [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 exits you from the phone directory. Mouse: Clicking on a directory entry sends that entry's number to the top of the Dial window to be dialed. Click on multiple entries and Telemate properly spaces them. Click once in the top portion of the Dial window and Telemate starts dialing. TELEMATE 2.11 THE DIAL WINDOW 26 Dialing Functions After you have selected the numbers, Telemate starts dialing and the top section of the Dialing Window lists the following Dialing Functions: Attempt #: This tells you how many attempts you've made so far to reach a certain number. The name of the person or place you are attempting to call appears beside the Attempt #. You can define the maximum number of attempt that Telemate should perform through the Options/Dial Setup dialog. 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 a break signal is sent. See below. Last Attempt: A message appears in this area which gives the result of the last dialing attempt. [+], [-]: The amount of time Telemate waits while attempting to make a connection can be set during the installation process. It can also be altered using the Option Menu [Alt O] . If you want to change the dial time temporarily you may do this by simply hitting the [+] and [-] keys. One second is added to the dial time each time you hit [+]. Conversely, one second is subtracted for each [-]. [Space]: Hitting the [Spacebar] causes the dialing process to start over again before the dial time has elapsed. If you have entered a series of numbers to dial the program will go on to the next number. [Esc]: Striking the [Esc] key aborts the dialing process and returns you to the phone directory. If the phone is ringing hitting [Esc] will, in effect, hang up the phone. [Enter]: Hitting [Enter] has the same effect as [Esc] (see above) with the exception that if the phone is ringing Telemate will not disconnect the line. This is extremely useful when making voice calls. Telemate redials the number for you until a connection is made. Once the connection is made, pick up the phone and hit [Enter]. [Del]: The [Del] key, when struck, deletes the current number from the list of those you are dialing. If, for example, you are dialing entry numbers 1,2,4,and 7, and Telemate is currently attempting to make a connection with #2. Hitting the [Del] key removes #2 from the dial list and goes on to the next attempt. Mouse: While dialing, click once will perform a redial function. TELEMATE 2.11 THE DIAL WINDOW 27 The Dial Menu When in the directory window, hitting [Alt D] again displays the following pull down 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 │ │ ──────────────────── │ │ Hang Up Alt-H │ │ Learn script Alt-N │ ╘══════════════════════╛ Save Dial List [F2] The phone numbers you are currently dialing are saved and automatically recalled at your next Telemate session. This also saves your phone directory window display. If you would like Telemate to display the directory password fields, scroll sideways in the phone directory until the password field is visible, then press [F2]. Load Phone Directory [F3] Telemate allows you to have multiple phone directories. To load a different phone directory follow the simple guidelines given in the section "File Directory". Find [F4] Selecting this item, you will see the prompt "Find:". Type in the text you wish to find. Telemate's search function is case insensitive, i.e. "big" finds "Big", "BIG", or "big". It is best to use the [Home] combination to go to the top of the directory before starting the search as Telemate's search function starts from its current cursor position and searches downward through the file. 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 edit entry dialog shown below. Mouse: Double clicking a directory entry will edit the entry. TELEMATE 2.11 THE DIAL WINDOW 28 ┌───────────────────────────────────────────────────────────────┐ │ │ │ Name _________________________________ │ │ Phone ___________________ │ │ Password ________________ Script _________ │ │ Memo _________________________________ Log _________ │ │ │ │ Port (*) Default │ │ ( ) COM1 ( ) COM3 ( ) COM5 ( ) COM7 │ │ ( ) COM2 ( ) COM4 ( ) COM6 ( ) COM8 │ │ │ │ Baud Rate ( ) 300 ( ) 4800 ( ) 38400 │ │ ( ) 1200 ( ) 9600 ( ) 57600 │ │ (*) 2400 ( ) 19200 ( ) 115200 │ │ │ │ Parity (*) None ( ) Even ( ) Odd │ │ Data Bits ( ) 7 (*) 8 │ │ Stop Bits (*) 1 ( ) 2 │ │ │ │ ╔═══════════╗ ┌────────┐ │ │ ║ Next Page ║ │ Cancel │ │ │ ╚═══════════╝ └────────┘ │ └───────────────────────────────────────────────────────────────┘ Telemate is designed to give you choices! With any directory entry you can override the programs Setup Options. For example, assume you have a 9600 baud modem and your normal set-up is for 8 data bits and 1 stop bit, BUT one of your favorite BBS's is a 1200 baud board which uses 7 data bits and 1 stop bit. Rather than reset your entire program, you set this individual entry exactly the way you want it and Telemate makes the connection. Moving Around: The [Tab] and [Shift Tab] key moves the cursor from entry to entry. The [Spacebar] moves the '*' from one choice to another. Striking the [Enter] key takes you directly to the <Next Page> box. Hit [Enter] again advances to the next screen. For detailed description on dialog, please refer to the 'How to Make Changes' in the 'THE OPTION DIALOGS' session. Name: Type in the new name and strike [Tab] when finished. Phone: Type in ONLY as much of the phone number as is needed to make the connection. If the number is long distance include the appropriate area code and select the correct dialing prefix. 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 BBS's you contact and you need never worry about a forgotten password again. Telemate comes with a special macro '^&' assigned to the [F3] key. The '^&' macro symbol refers to the password field in the phone directory. To send your password to a BBS press [F3]. Telemate looks in the phone directory and sends the password you have assigned to this entry. Memo: This space allows you to enter a reminder to yourself. It can include any information you desire, but cannot be longer than 30 characters long. TELEMATE 2.11 THE DIAL WINDOW 29 Script: A script is a short text file which Telemate automatically executes once the connection is made. Script files are useful for automatically logging onto BBS's or major Online Services such as Compuserve*. You should type in the script filename, without extension. Telemate will go to the Script Directory and load the compiled script file. Press [Tab] to move to next field. 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 turn Telemate's log feature on, Telemate appends the session to the file you have designated. Hit [Tab] when you are finished. Port: Port refers to the communications port to which your modem is attached. Telemate supports up to 8 different port. The ordinary PC user normally uses COM1 or COM2. If this option is set the 'Default', Telemate will use the COM port defined in the configuration file. Baud Rate: Baud rate refers to the speed used to transfer data electronically. Telemate's default setting is for 2400 baud. Use the [Spacebar] to move the '*' between selections. Strike [Tab] when you are satisfied with your choice. Parity: Default is None. You may use the [Spacebar] to choose between None, Even or Odd. 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. Data is normally sent is chunks of 9 bits, 8 data bits and 1 stop bit. Some BBS's or computers may however be set up for 7 data bits and 2 stop bits. Use the [Spacebar] to make your selection and hit [Tab] when you are finished. Hitting [Enter] at any time takes you directly to the <Next Page> box. Telemate is asking you whether you want it to accept and advance to the next page. Hit [Enter] again and your changes are accepted. If you aren't satisfied with your set-up use the [Tab] key to move to items you wish to change. Make the changes and hit [Enter] to move back to the <Next Page> box. If you wish to cancel this modification altogether [Tab] over to the "Cancel" box and strike [Enter]. When you press [Enter] on the <Next Page> box, Telemate takes you to the next Option screen. TELEMATE 2.11 THE DIAL WINDOW 30 ┌────────────────────────────────────────────────────┐ │ │ │ Terminal ( ) TTY (*) ANSI ( ) VT102 ( ) VT52 │ │ │ │ Connection (*) Modem ( ) Computer │ │ │ │ [ ] Add Line Feed [X] Auto Wrap │ │ [X] Add Return [X] Destructive BS │ │ [ ] Local Echo [ ] Auto Log │ │ │ │ Dial Prefix ( ) 1 (*) 2 ( ) 3 ( ) 4 │ │ Dial Suffix (*) 1 ( ) 2 ( ) 3 ( ) 4 │ │ │ │ Default Protocol │ │ (*) Zmodem ( ) Telink ( ) CIS QB │ │ ( ) SEAlink ( ) Modem7 ( ) BiModem │ │ ( ) Ymodem ( ) Ymodem-B ( ) Jmodem │ │ ( ) Xmodem ( ) Ymodem-G ( ) Kermit │ │ ( ) ASCII ( ) Xmodem-R ( ) Lynx │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └────────────────────────────────────────────────────┘ Terminal: Telemate gives you the choice of the four most popular terminal types: TTY, ANSI, VT102 and VT52. Default is ANSI. Connection: Is this connection being made via a modem and directly to a computer? If 'Computer' is selected, Telemate does not check the carrier signal during file transfers. Moreover, when it is connected to a computer, Telemate assumes it is connected already and does not dial the phone number. Add Line Feed: Most BBS's add a line feed at the end of each line of data. If this particular entry does not add line feeds, you can use the [Spacebar] to tell Telemate to add a line feed to the end of each line of data. Add Return: If this options is on, a carriage return (Ctrl-M) is supplied after a line feed is received. Local Echo: Default is off. If it is on, the character being typed from the keyboard is displayed on screen. This is sometimes called half duplex. Most remote systems will echo the character you typed and the screen may display each character twice. In this case, you should leave this option off. This is called full duplex. 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. TELEMATE 2.11 THE DIAL WINDOW 31 Auto Open Log: If this option is turned on, the log file will be opened automatically once a connection is made. Dial Prefix: Dial prefix is the string to be sent before the phone number. Dial prefixes come in two basic varieties: pulse or tone. Check with your local phone company if you are unsure as to which type you have. 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. The dial suffixes are built for this usage. Default Protocol: Different BBS's may offer different protocols. You should select the one you are going to use most on the BBS. This protocol will be the default when you select Send or Receive in the terminal menu. See Appendix A for more details on protocols. 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 "50" quickly takes you to entry #50. Manual Dial [F8] Choosing this option causes the following to appear at the top of the dialing 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. Hitting the [Esc] key aborts the dial; striking the [Spacebar] recycles or restarts the dialing process. 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. Hang Up [Alt H] To hang up the phone strike [Alt H] or use your mouse to click on this choice. 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. TELEMATE 2.11 THE TERMINAL WINDOW 32 THE TERMINAL WINDOW [Alt T] The Terminal is the heart of any communications programs. It is in this portion of the program that actual communication with other computers is carried on. The Terminal menu ╒════════════════════════╕ │ Send PgUp │ │ Receive PgDn │ │ Log session Alt-L │ │ Script Alt-S │ NOTE: The various functions │ learn script Alt-N │ can be accessed by hitting │ ────────────────────── │ the hot key combinations, │ Paste Alt-P │ for example, [Alt P] or by │ Quote Alt-Q │ moving the highlight bar │ Image Alt-I │ over the menu option and │ Command stack Alt-Y │ striking [Enter]. │ ────────────────────── │ │ Chat mode Alt-C │ │ Originate mode Alt-G │ To use the mouse, simply │ Answer mode Alt-A │ click on the menu choice │ Doorway mode Alt-= │ desired. │ ────────────────────── │ │ 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 following protocol selection 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 │ Relaxed Xmodem R │ in Appendix A. │ SEAlink S │ │ Telink T │ As different computers and BBS's │ Modem7 M │ use a variety of various protocols │ ASCII A │ Telemate also offers you a wide │ CIS Quick B C │ variety to choose from. │ BiModem I │ │ Jmodem J │ Note: The last four protocols are │ Kermit K │ external protocols. Use the │ Lynx L │ Options/Protocol dialog to define │ ─────────────────── │ them. │ Disk space 12740K │ ╘═════════════════════╛ TELEMATE 2.11 THE TERMINAL WINDOW 33 The File Selection Box ┌────────────────────────────────────────────────────────┐ │ Enter filename(s) to send, [Enter] for directory │ │ │ │ a:\tm210-1.zip b:\tm210-?.zip │ └────────────────────────────────────────────────────────┘ Once you have chosen the protocol you wish to use, you must next enter the name of file(s) you wish to send. (Some protocols allow you to send multiple files.) 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 which designate the upload directory. The File Transfer Window The File Transfer Window keeps you informed regarding the progress of an Upload or Download. ╔═════════ Zmodem Upload ══════════╗ ║ ║ ║ File name : SAMPLE.ARC ║ ║ Bytes to send : 40960 ║ ║ Bytes sent : 27648 ║ ║ Blocks to send : 320 ║ ║ Blocks sent : 216 ║ ║ Transfer time : 00:05:42 ║ Notes on the ║ Time remaining : 00:02:51 ║ progress of the ║ Remote system : ║ upload and any ║ Error correction : CRC-32 ║ problems appear ║ Number of errors : ║ here ║ Average CPS rate : 125 ║ ----------> ║ > ║ ║ ║ ║┌────────────────────────────────┐║ 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. To choose this function use the arrow keys to move the highlight bar to the"Receive" option then press [Enter] or press [PgDn] when in the terminal window. As in uploading files, a protocol box appears. Use the arrow keys to move the highlight bar to the option you want to select and press [Enter]. The file transfer window appears on your screen to keep you informed of the process of the download and any problems encountered. When the file transfer has been completed Telemate sounds an alarm to notify you. TELEMATE 2.11 THE TERMINAL WINDOW 34 Logging Sessions [Alt L] When you log a communications session you are simply recording all that occurs during that session and filter out the control codes if the log filter is turned on. Selecting this option opens the File Dialog. You are asked to identify which file to use as the log file. The file box shows all the files with a .LOG extension. Type in the correct name or use the [Tab] key to move the cursor to the file name you desire to use. You can create a new log file by typing in a new name; you should, preferably, use the extension "log". Pressing [Alt L] again closes the log file. NOTE: If you forgot to turn on the Log feature; you can still record the session by using the Write feature [Alt A] in the Back window. (See Back window for details.) Using Scripts [Alt S] A script file is a file which contains a series of instructions which usually are some repetitive functions such as a log on script. Telemate can compile complex scripts and comes with its own script language. TMSCRIPT.DOC contains a detailed discussion of Telemate's script language. Selecting this option opens the File Dialog and you are asked to identify which script file is to be executed. Script files end in the extension .SCR, the source file, or .TMS, the compiled file. Telemate will execute the external program TMS.EXE, the script compiler, to compile the .SCR source script file to a .TMS compiled script file if the compiled script file is not up-to-date. To terminate the script execution, press [Alt S] again. If the 'Out of Memory' is displayed while compiling the .SCR files, you should shell to DOS or exit Telemate and type TMS MYSCRIPT on the DOS command line. 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] to open the File Dialog and you are asked to identify which script file is to be generated. 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. TELEMATE 2.11 THE TERMINAL WINDOW 35 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 marked text 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 should use this function instead of ASCII upload. Quoting [Alt Q] [Alt Q] functions much the same as [Alt P]. [Alt Q] is designed for quoting text 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 Quote function will reformat the message according the editor margin if necessary. If the initial guessing option under Options/Terminal dialog is enabled, the '@' character in the quote prefix is replaced by the initials of the closest name. Image Files [Alt I] Many BBS's and some on-line service incorporate graphics into their screens. Telemate has the ability to capture such graphics images and save them to an image file. Pressing [Alt I] while in the terminal window opens the Image file window. Use the cursor keys to highlight the file name you wish to use in saving the image. If you wish to create a new file move to the top portion of the window and enter the file name you wish to use to save the image. Command Stack [Alt Y] The command stack provides a convenient way to recall the previously entered commands or prepare a short note. There are several usages. ╒════════════════╤═══════════════════════════════════════════════╕ │ 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. │ TELEMATE 2.11 THE TERMINAL WINDOW 36 ├────────────────┼───────────────────────────────────────────────┤ │ 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] Chat mode conveniently splits the screen for Online conversations. Messages coming from the remote system appear on the top half of the screen. Messages you type appears on the lower half of the screen. The characters you typed are sent to the remote system immediately. To terminate the chat mode, press [Alt C] again. If you would like to edit the line before sending it to the remote system, you should use the Command Stack [Alt Y] function instead. Originate Mode [Alt G] This is the "normal" mode. You use this mode to call BBS's, other computers, etc. The communication originates from your computer terminal. When you start Telemate you are in this mode. If you switched to Answer Mode, you must press [Alt G] to switch back to this mode before dialing the other BBS's. Answer Mode [Alt A] When you select Answer mode you tell Telemate to send a specific string to the modem which turns on the modem's Auto Answer feature. Telemate now answers the phone for you. The Auto Answer string can be modified through the Options menu. If you use an external modem you will see the Auto Answer light is now "on". Pressing [Alt G] returns you to the Originate mode. NOTE: Auto answer is designed to receive calls from other computers. It cannot handle voice calls. TELEMATE 2.11 THE TERMINAL WINDOW 37 Doorway Mode [Alt =] When you select Doorway mode Telemate sends the keyboard scan code if 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] while in the Terminal or Dial windows hangs up the phone. Including the "^#" macro symbol in this 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] From time to time your computer's screen becomes cluttered with messages from your communications sessions. You can clear the screen and reset Telemate to its default colors by pressing [Ctrl Home]. 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 2.11 THE EDIT WINDOW 38 THE EDIT WINDOW [Alt E] Telemate's multitasking ability shines most brightly in the editing area and the backscroll area. With Telemate you can transfer files in the background using fast protocols and a high speed modem while, simultaneously, editing a file in the foreground. Telemate gives you both speed and convenience. To begin editing point with your mouse at the word "Edit" on the top menu bar and click; or use the hot key combination [Alt E]. When you first open the Edit window it is empty and ready for you to begin typing. Status Line The first line of the Edit window is the Status line. It consists of six parts. 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 (effectively erasing) 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 Arrow] Up one line [Left] Left one space [Dn Arrow] 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 to the right or block [Bksp] 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 TELEMATE 2.11 THE EDIT WINDOW 39 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) Wordstar Conventions Telemate has incorporated some Wordstar key combinations into its editor for the ease of the users of that venerable program. [^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 Mouse Movements If you use your mouse with Telemate you can move quickly around any file you are editing by using the window borders. Point at the dark box on the right border and drag it to the approximate location on the bar that corresponds to where you wish to go in the file. For example dragging the box to the midpoint of the bar would take you half way through your file. The same procedure can be used on the bottom border to move horizontally in a file. Clicking your mouse near the border ends scrolls up or down through a file. By adjusting the location of the mouse cursor on the vertical border you can scroll one line at a time or one screen at a time. 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. Change the Editor margin setting to whatever number you wish. 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. If you wish to make the changes permanent then save the changes. When you return to the Edit window the new margin setting is in effect. TELEMATE 2.11 THE EDIT WINDOW 40 The Edit Menu ╒═════════════════╕ │ Mark F10 │ The Edit window's more advanced functions │ Copy Alt-C │ are available through the Edit menu. To │ cUt Alt-U │ access the menu press [Alt E] a 2nd time │ Paste Alt-P │ or point at the Edit option with your │ Quote Alt-Q │ mouse and click. │ 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 highlighted strike [Alt C] to place the marked text on the clipboard. The text in the clipboard can 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 content. 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] Telemate's cUt feature 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 moved or cUt. Cut 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 content. TELEMATE 2.11 THE EDIT WINDOW 41 Mouse: Holding down the [Shift] key while selecting the cUt item from the menu has the same effect as [Shift Alt U]. 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 feature 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. To quote text mark the text and copy to the clipboard. To insert into a BBS message position the cursor where you want the text to go and hit [Alt Q]. If necessary, the text will be reformated according to the editor margin during the quoting process. Write [Alt A] The Write function allows you to write or append the marked text to a file. After you have marked your text and selected this function the File Dialog appears asking you for the name of the 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] Pressing [F2] when in the Edit window brings up the File Dialog. [Ctrl Y] clears the File Name box and you can type in the name of the file. Press [Enter] to accept or [Esc] to cancel this operation. Loading Files [F3] Except for the invocation key [F3] you load a file to edit in exactly the same way as you save one. You can type the file name in using the correct DOS path and file name; or you can tab to the lower portion of the File Dialog and highlight the file you wish to load. Find [F4] When you select this option by pressing [F4] you see the "Find:" prompt. Type in the text you wish to find or press [Up] to recall the last search string. Telemate's search function is case insensitive. Typing "big" finds "BIG" or "BiG", etc. TELEMATE 2.11 THE EDIT WINDOW 42 Next [F5] Hitting [F5] finds/replaces the next occurrence of the find text. As with the above you can select this option through the pull-down menu or use the short cut key [F5]. 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 [Esc] is pressed. 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] Telemate even has something for you diehard WordStar fans, a built in filter which strips out WordStar's high bits and allow you to view WordStar files without seeing all the hidden bits. Reformat [F9] To reformat a paragraph move the cursor to the beginning of the paragraph and press [F9]. You could change the right margin setting through the Options/General dialog. By holding the [F9] key, Telemate will reformat 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. 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. Macro Keys The editor will recognize 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. TELEMATE 2.11 THE VIEW WINDOW 43 THE VIEW WINDOW [Alt V] When you select the View option 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 ╒═════════════════╕ Pressing [Alt V] a 2nd │ Mark F10 │ time invoke the View │ Copy Alt-C │ window menu. To choose a │ Quote Alt-Q │ function press the key │ Write Alt-A │ indicated on the right │ ─────────────── │ side of the menu. Only the │ Load F3 │ Quote option performs │ ─────────────── │ different functions from │ Find F4 │ that in Edit window. │ 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 2.11 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 terminal. Telemate gives you instant access to all the information that has appeared on your computer screen during your communications session. It does this via the Back (scroll) window. You open the Back Window by clicking on the "Back" option at the top of your screen or by pressing [Alt B], [Center] (the FIVE key in the keypad) or [Ctrl Up]. 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] hide the window as if [Esc] is pressed. The Back window operates exactly like Telemate's other windows. You may resize it, move it, or scroll through it using your mouse or via the pull down menu. Pressing [Alt B] a second time pulls down the Back menu. 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 number of lines that the Back window can contain can be set in the Options/General dialog. The Back Scroll Menu ╒═════════════════╕ │ Mark F10 │ The Back Window Menu is │ Copy Alt-C │ almost identical to the Edit │ cUt Alt-U │ Window Menu. The functions │ Quote Alt-Q │ are summarized in the Edit │ Write Alt-A │ Menu Section. However, the │ ─────────────── │ Quote function works slightly │ Find F4 │ different. And the Write │ Next F5 │ function has a new meaning │ Goto F7 │ in this window. │ filter F8 │ │ ─────────────── │ │ √Scroll Lock │ │ √Capture Ins │ │ Clear Alt-N │ ╘═════════════════╛ Write [Alt A] There are two ways to record a communications session. You can turn on Telemate's log at the beginning of a session. This 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 2.11 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 editor margin, the extra words will be wrapped to the next line automatically. 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. Therefore, Telemate controls the status 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 2.11 THE MACRO WINDOW 46 THE MACRO WINDOW [Alt M] Telemate lets you assign text to a key so that it is sent to the com port when that key is pressed. This is called a keyboard macro. Macros, when properly used, can save you from typing 100's of keystrokes. You type the keystrokes into Telemate's Macro window one time. They are recorded and assigned to a specific key, for example [F2]. When you want to send that series of keystrokes through your terminal you press the key they are assigned to. Telemate actually keeps three key definitions tables in memory at all times, the macro table, keypad table and the keyboard table. The Macro Table The macro table, once defined by you, usually remains constant. You might want to assign your name to the F2 key, your address or key phrases to the [Ctrl]+[Fn keys]. These types of definition would be put in the macro table. 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. The Keypad Table The keypad table is used for terminal emulation function 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] [Home] [Up] [Ctrl PgUp] [Ctrl Left] [Left] [Right] [Ctrl Right] [End] [Down] [Ctrl PgDn] [Ins] [Del] 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. By default, no character translation is performed but it can be changed through the Macro menu. This table allows you to completely redefine your computer's keyboard when using Telemate. The Macro Window Telemate's 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. TELEMATE 2.11 THE MACRO WINDOW 47 ╔═══════════════════════════════════╗ 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, ║ Enter │ 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. │ Keyboard │ │ ───────────────│ Function key: refers to the keys F2-F12 │ Load macro │ Alt key: [Alt] + the keys F1-F12 │ Save macro │ Shift key: [Shift] + the keys F1-F12 │ Load keypad │ Ctrl key: [Ctrl] + the keys F1-F12 │ Save keypad │ Alt Number: [Alt] + numbers 0-9 │ Load keyboard │ Key pad: Numeric keypad │ Save keyboard │ Keyboard: The Qwerty Keyboard, ABC, etc. ╘════════════════╛ NOTE: If you have an AT keyboard you may use the Function keys F11 & F12. If you don't have these keys don't worry, you probably won't need that many macros anyway. Defining Macros To define a macro, highlight the type of keys you wish to redefine (Function, Alt Number, etc.) and press [Enter]. A macro definition window will open (see below). TELEMATE 2.11 THE MACRO WINDOW 48 ┌─────────────────────────────────────────────────────┐ │ │ │ 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 │ │ │ ╚════╝ └────────┘ │ └─────────────────────────────────────────────────────┘ When you've finished defining your macro, press the [Tab] key to move to the OK box and hit [Enter] to accept them. If you've decided against the macros you've defined, [Tab] to the Cancel box and press [Enter]. Each of the first six entries on the Macro menu (Function Key - Keypad) are defined in this manner. 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 │ │ ... │ ... │ │ ^* │ Send hang up string │ │ ^Z │ Ctrl Z │ │ ^( │ Send init string │ │ ^[ │ Esc │ │ ^) │ Send answer string │ │ ^^ │ ^ │ │ ^= │ Execute command │ │ ^~ │ ~ │ │ ^\ │ Run script file │ ╘════════╧═════════════════╛ ╘════════╧═════════════════════╛ TELEMATE 2.11 THE MACRO WINDOW 49 The '^=' Hot Key Macro Symbol With the hot key macro symbol you can define as many DOS commands, external editors or external protocols as the number of the function keys. The syntax is '^=' [command] ['^='] ['^M'] [command] can be a DOS commands, external editors, external protocols 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. ╒═════════════════════╤══════════════════════════════════════════╕ │ 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 │ ├─────────────────────┼──────────────────────────────────────────┤ │ ^=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 filename │ ╘═════════════════════╧══════════════════════════════════════════╛ 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]. 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 every character in the ASCII set, the table defines what the character should be changed to. By default, no character translation is performed. TELEMATE 2.11 THE MACRO WINDOW 50 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. All the files with the corresponding ending in the Telemate directory are listed. Save your macros to this file or create another file. If, for example, you created a set of macros to use on Compuserve you might save them in a file called "Compu.mac". To load a macro, keypad or keyboard file select the appropriate option from the Macro menu. A File Dialog opens displaying those files with the corresponding extension (.MAC, .PAD, or .KEY). Use the tab and arrow keys to highlight the file you wish to load, then press [Enter]. TELEMATE 2.11 THE OPTION DIALOG 51 THE OPTION DIALOGS [Alt O] Options ..Choices ..Variety ..Freedom .. This feature was designed to give you all of these. The Options Dialog allows you to quickly change many of Telemate's basic features. Do you want to change the Edit window margin? Options can do it. You want to quickly switch from COM1 to COM2? Options can handle it. You can change almost all the essentials quickly and easily through the Options Dialog. 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 │ │ Dial setup │ │ Directory │ │ Terminal │ │ Communication │ │ Protocol │ │ ─────────────── │ │ Load options │ │ Save windows │ │ Save options │ ╘═════════════════╛ Through the Options Menu you can affect how Telemate operates in 6 areas: General Dialog: includes such things as your mouse setup, display setup, scroll buffer size, delays, sound and alarm. Dial Setup Dialog: allows you to change dial prefixes, time, dial cancel string and pause time between dialing attempts. Directory Dialog: sets the default DOS directories for your main Telemate files, Upload and Download directories, as well as Script 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 Zmodem options, filename guessing feature and external protocols setup. 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 2.11 THE OPTION DIALOG 52 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 window will be saved to the configuration file. How to Make Changes To change one of Telemate's features highlight the appropriate menu item and press [Enter]. An Options Dialog opens to enable you to make the desired changes. There are 3 types of choices you face in the Options Dialog area. Pressing the [Tab], [Shift Tab] or using the Arrow keys moves you from choice to choice. ╒════════════════╤══════════════════════╕ │ Key │ Function │ ├────────────────┼──────────────────────┤ │ Tab, Down │ Next tiem │ │ Shift Tab,Up │ Previous item │ │ Spacebar │ Turn on/off option │ │ Enter │ Accept changes │ │ Esc │ Abort changes │ ╘════════════════╧══════════════════════╛ 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 in each group can be selected. 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 feature turned on". An empty bracket means "No." TELEMATE 2.11 THE OPTION DIALOG 53 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, [Alt C] to copy text to the clipboard and [Shift Alt C] to append text to the clipboard. If a tailing space is required, the string should be enclosed by two quotation mark, '"'. For example, "ATDT " add a tailing space to the string 'ATDT'. The following are the descriptions of all options in the Option dialogs. General Options ┌─────────────────────────────────────────────────────────┐ │ ┌─ DOS Shell ───────────────────────────────────────┐ │ │ │ [X] Swap Telemate to XMS/EMS │ │ │ │ [X] Swap Telemate to disk │ │ │ └───────────────────────────────────────────────────┘ │ │ ┌─ Mouse ───────────────────────────────────────────┐ │ │ │ Type ( ) None ( ) MicroSoft (*) MouseSystem │ │ │ │ Port ( ) None (*) COM1 ( ) COM2 │ │ │ │ Speed ( ) Slow (*) Medium ( ) Fast │ │ │ └───────────────────────────────────────────────────┘ │ │ ┌─ Display ──────────────┐ ┌─ Log ────────────────┐ │ │ │ [X] Scroll Bars │ │ [X] Log Filter │ │ │ │ [ ] Menu Bar │ │ [X] Usage Log │ │ │ │ [ ] Status Line │ └──────────────────────┘ │ │ │ [ ] 24 hour format │ ┌─ Sound ──────────────┐ │ │ │ Scroll Back _100 │ │ [X] Music │ │ │ │ Editor Margin _70 │ │ [X] Bell │ │ │ │ Message Pause _1 │ │ Alarm Sound _1 │ │ │ │ Error Pause _2 │ │ Alarm Time _3 │ │ │ └────────────────────────┘ └──────────────────────┘ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └─────────────────────────────────────────────────────────┘ Swap Telemate To XMS/EMS: When this option is On, Telemate will swap part of itself to XMS or EMS while jumping to OS and, therefore, leaving more memory to the OS 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. TELEMATE 2.11 THE OPTION DIALOG 54 Swap Telemate To Disk: Similar to the "Swap Telemate To EMS" option, Telemate will swap part of 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 or EMS when there is enough memory, if the swapping is unsuccessful, Telemate will swap to disk. Mouse Type: Telemate supports two types of mice, MicroSoft Mouse and MouseSystem, of mice 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. Mouse Speed: If the mouse pointer seems to move too slow or too fast, you can adjust the speed using this option. Scroll Bars: If this option is on, the active window has an enlarged right side and bottom borders. 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 -] quickly 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 -] quickly 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. 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 2.11 THE OPTION DIALOG 55 Log Filter: If this option is on, all the ANSI codes will be filter out during the recording of the communication session. Usage Log: If this option is on, actions, such as connecting to a remote system, upload/download status, online/offline status, will be recorded in the usage file. 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. 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. Dial Options ┌────────────────────────────────────────────────────────────────┐ │ │ │ Prefix ( ) 1 "ATDT "________________________________ │ │ (*) 2 "AT &Q5 DT "___________________________ │ │ ( ) 3 "AT &Q0 DT "___________________________ │ │ ( ) 4 ATDT 9,________________________________ │ │ │ │ Suffix (*) 1 ^M_____________________________________ │ │ ( ) 2 ^M_____________________________________ │ │ ( ) 3 ^M_____________________________________ │ │ ( ) 4 ^M_____________________________________ │ │ │ │ Connect String CONNECT______ [ ] Auto Baud Detect │ │ _____________ │ │ _____________ Dial Time _32 │ │ _____________ Redial Pause __2 │ │ Busy String NO CARRIER___ Redial Attempt __0 │ │ BUSY_________ │ │ NO CONNECT___ ╔════╗ ┌────────┐ │ │ NO DIALTONE__ ║ OK ║ │ Cancel │ │ │ Cancel String ^M___________ ╚════╝ └────────┘ │ │ │ └────────────────────────────────────────────────────────────────┘ Dialing Prefix: A Dialing prefix is what Telemate sends to the modem when dialing, before the number. Dialing Suffix: This is the string Telemate should send after the number when dialing. TELEMATE 2.11 THE OPTION DIALOG 56 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. 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. 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". Cancel String: This is the string Telemate should send to the modem to cancel the dialing attempt, for example, the carriage return "^M". Directories and files ┌──────────────────────────────────────────────────────────┐ │ │ │ Telemate C:\TM\__________________________________ │ │ │ │ Upload C:\TM\UL\_______________________________ │ │ │ │ Download C:\TM\DL\_______________________________ │ │ │ │ Script C:\TM\__________________________________ │ │ │ │ Edit C:\ED\__________________________________ │ │ │ │ Log C:\TM\__________________________________ │ │ │ │ V. Memory E:\_____________________________________ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ 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. TELEMATE 2.11 THE OPTION DIALOG 57 There should be 128K in the virtual memory directory, 256K if you have the "Swap Telemate to Disk" 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*.EXE, *.BAT Upload C:\TM\UL\ Download C:\TM\DL\ Script C:\TM\ *.SCR, *.TMS Edit C:\ED\ 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. Dir Name Directory Files -------- --------- ---------------------------------- Telemate A:\ *.FON, *.MEM, *.MAC, *.KEY, *.PAD, TM.HLP, TM.CFG, TMS.EXE Upload A:\ Download A:\ Script A:\ *.SCR, *.TMS Edit A:\ Log A:\ *.LOG, TM.USE Virtual- A:\ TM.VM, TM.SWP, TMCLIP.$$$ memory TELEMATE 2.11 THE OPTION DIALOG 58 Terminal Options ┌────────────────────────────────────────────────────────────────┐ │ │ │ Terminal ( ) TTY (*) ANSI ( ) VT52 ( ) VT102 │ │ │ │ Connection (*) Modem ( ) Computer │ │ │ │ ┌─ Toggles ──────────────┐ ┌─ Paste/ASCII Upload ────────┐ │ │ │ [ ] Add Line Feed │ │ [X] Expand Blank Line │ │ │ │ [X] Add Return │ │ Line Pacing _0 │ │ │ │ [ ] Local Echo │ │ Char Pacing _0 │ │ │ │ [X] Auto Wrap │ │ Pace Character __0 │ │ │ │ [X] Destructive BS │ └─────────────────────────────┘ │ │ │ [ ] Strip High Bit │ ┌─ Macro/Script ──────────────┐ │ │ │ [X] Confirm Hang Up │ │ Extended Pacing _0 │ │ │ └────────────────────────┘ └─────────────────────────────┘ │ │ ┌─ Control ──────────────┐ ┌─ Quote ─────────────────────┐ │ │ │ [ ] XON/XOFF Flow │ │ [X] Initial(@) Guessing │ │ │ │ [X] RTS/CTS Flow │ │ Prefix "@> "______ │ │ │ └────────────────────────┘ └─────────────────────────────┘ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └────────────────────────────────────────────────────────────────┘ Terminal: Telemate gives you the choice of the four most popular terminal types: TTY, ANSI, 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. Telemate emulates the VT102 alternative keypad with the function keys, F1 - F10 Shift F1 - F10 Ctrl F1 - F10 ┌───────┬───────┐ ┌───────┬───────┐ ┌───────┬───────┐ │ │ │ │ │ │ │ PF1 │ PF2 │ │ │ │ │ │ │ │ │ │ ├───────┼───────┤ ├───────┼───────┤ ├───────┼───────┤ │ 7 │ 8 │ │ 9 │ - │ │ PF3 │ PF4 │ │ │ │ │ │ │ │ │ │ ├───────┼───────┤ ├───────┼───────┤ ├───────┼───────┤ │ 4 │ 5 │ │ 6 │ , │ │ │ │ │ │ │ │ │ │ │ │ │ ├───────┼───────┤ ├───────┼───────┤ ├───────┼───────┤ │ 1 │ 2 │ │ 3 │ E │ │ │ │ │ │ │ │ │ N │ │ │ │ ├───────┴───────┤ ├───────┤ T │ ├───────┼───────┤ │ 0 │ │ . │ E │ │ │ │ │ │ │ │ R │ │ │ │ └───────────────┘ └───────┴───────┘ └───────┴───────┘ TELEMATE 2.11 THE OPTION DIALOG 59 Connection: If you are using a 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 you use a cable or a null modem to connect two computers, there is no carrier signal and it will be will online. 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. 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. 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. 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. Strip High Bit: If this option is on, the 8th bit of the incoming data will be filter out. Confirm Hang Up: If this option is on and the hangup command [Alt H] is issued, you will be asked for confirmation. 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. 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/10 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 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/10 seconds, that Telemate should wait between each character in a macro or in a string PUT by a script file. TELEMATE 2.11 THE OPTION DIALOG 60 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. To add a tailing space to the prefix, the quotation mark should be used, for example, "@> " appends a space to '@>'. Communication Options ┌──────────────────────────────────────────────────────────────┐ │ │ │ Modem Init String ATZ^M___________________________ │ │ Modem HangUp String ^#~~~+++~~~ATH0^M_______________ │ │ Auto Answer String ~~+++~~AT S0=1 Q1 E0^M__________ │ │ Answer Back String │ │ │ │ │ │ Port ( ) COM1 ( ) COM3 ( ) COM5 ( ) COM7 │ │ (*) COM2 ( ) COM4 ( ) COM6 ( ) COM8 │ │ │ │ Baud Rate ( ) 300 ( ) 4800 ( ) 38400 │ │ ( ) 1200 ( ) 9600 ( ) 57600 │ │ (*) 2400 ( ) 19200 ( ) 115200 │ │ │ │ Parity (*) None ( ) Even ( ) Odd │ │ Data Bits ( ) 7 (*) 8 │ │ Stop Bits (*) 1 ( ) 2 │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ 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. TELEMATE 2.11 THE OPTION DIALOG 61 Port: Port refers to the communications port to which your modem is attached. Telemate supports up to 8 different port. The ordinary PC user normally uses COM1 or COM2. If this option is set the 'Default', Telemate will use the COM port defined in the configuration file. Baud Rate: It is the speed at which communications take place. Check your modem manual if you are unsure regarding what speed it is. If you are using Telemate to connect computers directly together without modems, it is possible to use the maximum baud rate of 115,200. Parity: It is a form of error checking. You can choose between None, Even, and Odd. 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. Data is normally sent in chunks of 9 bits, 8 data bits and 1 stop bit. Some BBS's or computers may however be set up for 7 data bits and 2 stop bits. Protocol Options ┌─────────────────────────────────────────────────────────────────┐ │ ┌─ ASCII ──────────────────────────┐ │ │ [X] Filename Guessing │ Upload Download │ │ │ [X] Check Disk Space │ [ ] [ ] Strip High Bit │ │ │ │ [ ] [ ] Translation │ │ │ ┌─ Zmodem ────────────┐ │ [ ] [ ] Strip CR │ │ │ │ [X] Recovery │ │ [ ] [ ] Strip LF │ │ │ │ [X] Auto-Download │ │ [ ] [ ] Add CR before LF │ │ │ │ [ ] ASCII-Upload │ │ [ ] [ ] Add LF after CR │ │ │ └─────────────────────┘ └──────────────────────────────────┘ │ │ │ │ ┌─ External Protocols ──────────────────────────────────────┐ │ │ │ Protocol Upload Download Prompt Auto-Download │ │ │ │ Name Key Batch Batch DL Name Sequence │ │ │ │ BiModem I BI-MODEM BI-MODEM [ ] ^H ^H ^H ^H │ │ │ │ Jmodem J JMODEM-U JMODEM-D [X] _____________ │ │ │ │ Kermit K KERMIT-U KERMIT-D [ ] _____________ │ │ │ │ Puma P PUMA-U PUMA-D [ ] ^V^H^V^H^VPum │ │ │ └───────────────────────────────────────────────────────────┘ │ │ │ │ ╔════╗ ┌────────┐ │ │ ║ OK ║ │ Cancel │ │ │ ╚════╝ └────────┘ │ └─────────────────────────────────────────────────────────────────┘ Filename Guessing: Some protocols, such as Xmodem, require you to supply a download filename. If this option is on, Telemate guesses the possible filename based on the incoming text and puts it in the file selection box if the protocol requires a download filename. TELEMATE 2.11 THE OPTION DIALOG 62 Check Disk Space: If this option is on, the free disk space in the download directory will be shown in the protocol selection box and a warning message will be 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. 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. 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 filename 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 EXTERNAL PROTOCOLS. Download Batch: This is the filename 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 EXTERNAL PROTOCOLS. Prompt Download Name: If this option is on, you will be asked to enter a filename before downloading with the corresponding external protocol. TELEMATE 2.11 THE OPTION DIALOG 63 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 the top window. In addition, this feature is disabled within 15 seconds after the sequence is detected and the external protocols is called such that you have time to modify an incorrect batch file for that external protocol. 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' Puma '^V^H^V^H^VPuma^V^H^V^H^V' Zmodem '*^XB000' Note: To use an external Zmodem driver, you should turn off the Zmodem Auto-download option in the Options/Protocol dialog. TELEMATE 2.11 APPENDIX A: FILE TRANSFER PROTOCOLS 64 APPENDIX A: FILE TRANSFER PROTOCOLS Xmodem: This is the most popular protocol in use today, but it is slowly 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. While receiving a file, Telemate accepts both 128 byte and 1024 byte blocks, which is called a Xmodem-1K protocol. While sending a file, Xmodem always uses the 128 byte block. Xmodem-1K: This is a variation of Xmodem which uses blocks that may be 128 bytes or 1024 bytes in size. Telemate supports this protocol indirectly by allow 1K block in Xmodem protocol. 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 filename 'UNKNOWN.$$$' shows in the 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 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. While transferring files, it keeps the correct name, size, and date, and may use 128 or 1024 byte block sizes. 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. 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. 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. TELEMATE 2.11 APPENDIX A: FILE TRANSFER PROTOCOLS 65 Modem7: Modem7 is a relative of Xmodem. It passes the filename before starting the transfer. It is common on CP/M systems. This protocol allows more than one file to be sent at a time. 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. 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. BiModem: This protocol allows simultaneous bidirectional file transfers. In addition, it allows you to chat while the transfer is going on. Automatic recovery continues the download at the point where it left off while the Auto Verification insures that the entire file was accurately transmitted. When using this external protocol, the 'Swap Telemate to XMS/EMS' and 'Swap Telemate to Disk' options should be turned on to allow the working space it requires. Jmodem: This protocol is designed to maximize the amount of data that can be transferred in a given time. It sends very long blocks of data using 16 bit CRC error correction and compressing the data wherever possible. 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. Lynx: This protocol can transfer up to 255 files in a single batch using a block size from 128 bytes to 1024 bytes. Like Zmodem, it uses CRC-32 error checking and the resume option can continue an interrupted transfer. A Run-Length-Encoding compression technique is used for compressible file. MegaLink: The goal of this protocol is to design and implement a protocol that is fast, reliable and inexpensive. Megalink is a full streaming protocol. It uses a block of 512 bytes and a CRC-32 error correction to improve the performance. Puma: This protocol has a full color display of transfer status. It can transfer up to 99 files in a single batch using dynamic block scaling for optimal data throughput. Like Zmodem, the resume option can continue an interrupted transfer. And it can use the RLE technique to compress the file. TELEMATE 2.11 APPENDIX B: DEFINING EXTERNAL PROTOCOLS 66 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 parameters. Sometimes the third parameter is blank. Parameter Description ───────── ─────────── %1 the baud rate %2 the com port number (1 - 8) %3 the file to transfer The batch file should call a driver program for the protocol, using the supplied parameters. For example, Telemate does not have built-in Kermit support. You may, if you wish, install it as a external protocol. The batch file for download may contain the command: CKERMIT -b %1 -l %2 -s %3 You can define the name, the key and the batch files for uploads and downloads. Bimodem, Jmodem, Kermit and Puma are set by default. NOTE: You can find those protocol drivers in many public BBS's. TELEMATE 2.11 APPENDIX C: USAGE LOG 67 APPENDIX C: 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. The format for using TMSTAT.EXE is TMStat [<usage file name>] [/ddd] [/LDnnn.nn] where <usage file name> is the name of the usage file, default is TM.USE and 'ddd' refers to the last ddd days to report on. The '/LD' option estimates how much it cost if 'nnn.nn' dollar per minute is charged in long distance service. For example, if you would like TMSTAT to compile a report with long distance evaluation on your usage for the past week you would type at the DOS command line: TMStat TM.USE /7 /LD0.25 Below is a sample report for a 10 day period. Almost everything in the report is self-explanatory, but a few comments are added in the brackets [ ]. TMStat Version 2.11 Session time 8:24:33 [how long Telemate is executed] Online time 5:07:48 [how long Telemate is online] Receive time 1:40:01 [time used for receiving files] Send time 0:42:16 [time used for sending files] Transfer Receive Receive Send Send Average Protocol Number K bytes Number K bytes CPS -------------------------------------------------------------- Zmodem 4 175 1 180 258 Ymodem-G 8 620 0 0 282 -------------------------------------------------------------- Total: 12 795 1 180 270 TELEMATE 2.11 APPENDIX C: USAGE LOG 68 BBS Name Connection Time Receive Send CPS LD ----------------------------------------------------------------- SouthWest Connect 15 3:46:02 620 180 277 56.50 Southern Reaches 3 1:21:46 175 0 253 20.44 ----------------------------------------------------------------- Total: 2 BBS 18 5:07:48 795 180 270 76.90 Telemate Usage Chart Online ░░░░░░░░░░ Session ▒▒▒▒▒▒▒▒▒▒ ┌──────────────────────────────────────────────────┐ 1.3 │ ▒ │ 1.2 │ ▒ ▒ │ 1.2 │ ░▒ ▒ │ 1.1 │ ░▒ ▒░▒ │ 1.0 │ ░▒ ▒░▒ │ 0.9 │ ░▒ ▒░▒ │ 0.8 │ ░▒ ▒░▒ │ 0.8 │ ▒ ░▒ ▒░▒ │ 0.7 │ ░▒ ▒ ▒ ░▒ ▒░▒ │ 0.6 │ ░▒ ▒ ▒ ░▒ ▒░▒ │ 0.5 │ ░▒░▒ ░▒ ░▒░▒░▒ │ 0.4 │ ░▒░▒ ░▒ ░▒░▒░▒ │ 0.3 │ ░▒ ░▒░▒ ░▒ ▒░▒░▒░▒ ▒ │ 0.2 │ ░▒ ░▒ ░▒░▒ ▒░▒ ▒░▒░▒░▒ ▒ │ 0.2 │ ░▒░▒ ░▒ ░▒░▒░▒░▒ ░▒░▒░▒░▒░▒ │ 0.1 │ ░▒░▒ ░▒ ░▒░▒░▒░▒ ░▒░▒░▒░▒░▒ │ Number │ 1 0 0 0 0 0 0 0 0 0 1 1 1 0 0 0 0 0 0 0 0 0 1 1 │ of Hours │ 2 1 2 3 4 5 6 7 8 9 0 1 2 1 2 3 4 5 6 7 8 9 0 1 │ └──────── AM Hours ───────┴─────── PM Hours ───────┘ TELEMATE 2.11 APPENDIX D: THE PHONE DIRECTORY 69 APPENDIX D: 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 2.11 APPENDIX E: MEMORY MANAGEMENT 70 APPENDIX E: MEMORY MANAGEMENT About this Appendix Below is a description on how Telemate uses XMS, EMS and EGA/VGA RAM to store data. The description of XMS is quoted from XMS.TXT, the official document by Microsoft Corporation, Lotus Development Corporation, Intel Corporation, and AST Research, Inc. The description of EMS is quoted from LIMSIM41.DOC, a transcription of the Lotus/Intel/Microsoft (LIM) Expanded Memory Specification. Extended Memory Specification XMS ==================================== Extended Memory Specification (XMS) allows DOS programs to utilize additional memory found in Intel's 80286 and 80386 based machines in a consistent, machine independent manner. With some restrictions, XMS adds almost 64K to the 640K which DOS programs can access directly. XMS also provides DOS programs with a standard method of storing data in extended memory. Definitions ----------- Extended - Memory in 80286 and 80386 based machines which Memory is located above the 1MB address boundary. High Memory Area (HMA) - The first 64K of extended memory. The High Memory Area is unique because code can be executed in it while in real mode. The HMA officially starts at FFFF:10h and ends at FFFF:FFFFh making it 64K-16 bytes in length. Upper Memory Block (UMB) - Blocks of memory available between DOS's 640K limit and the 1MB address boundary. The number, size and location of these blocks vary widely depending upon the types of hardware adapter cards installed in the machine. Extended Memory Block (EMBs) - Blocks of extended memory located above the HMA which can only be used for data storage. A20 Line - The 21st address line of 80x86 CPUs. Enabling the A20 line allows access to the HMA. XMM - An Extended Memory Manager. A DOS device driver which implements XMS. XMMs are machine specific but allow programs to use extended memory in a machine-independent manner. HIMEM.SYS - The Extended Memory Manager currently being distributed by Microsoft. The following is a helpful diagram. TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 71 Extended Memory Specification (XMS) Memory Diagram -------------------------------------------------- ^ ^ | | | | | | | Possible | | Extended | | Memory Block | | (EMB) | | | 1088K +--------------+ | High Memory | | Area (HMA) | 1024K +--------------+ | | | Possible | | Upper Memory | | Block (UMB) | | | 640K +--------------+ | | | | | Conventional | | Memory | | | | | | | | | 0 +--------------+ Expanded Memory Specification EMS ==================================== The LIM Expanded Memory Specification (EMS) defines the software interface between the Expanded Memory Manager (EMM) and application programs that use expanded memory. Definitions ----------- Expanded - Memory beyond DOS's 640K-byte limit. The LIM memory specification 4.0 supports up to 32M bytes of expanded memory. Physical - Because the 8086, 8088, and 80286 (in real mode) pages microprocessors can physically address only 1M bytes of memory, they access expanded memory through several physical pages which is located in the 1M bytes range. Physical pages are typically 16K of memory. Page - The computer accesses logical pages through a physical frame block of memory called a page frame. The page frame contains multiple physical pages. TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 72 Logical - Expanded memory is divided into segments called logical pages pages. These pages are typically 16K of memory. A logical page of expanded memory can be mapped into any one of the physical pages in the page frame. Thus, a read or write to the physical page actually becomes a read or write to the associated logical page. The following is a helpful diagram for expanded memory. Expanded Memory Specification (EMS) Memory Diagram -------------------------------------------------- 32M +--------------+ / | | / | | / | | / | | / | Expanded | / | Memory | 1024K +--------------+ / | | | / / / / / / | / | | 960K +--------------+ | | | Page Frame | | | | | | | | 12 16K-Byte | | | | Physical | | | | Pages | | | 768K +--------------+ | Divided into | | / / / / / / | \ | logical | 640K +--------------+ \ | pages | | | \ | | | 24 16K-Byte | \ | | | Physical | \ | | | Pages* | \ | | | | \ | | 256K +--------------+ \ | | | | \ | | | / / / / / / | 0+--------------+ | | 0 +--------------+ *Intended for operating system/environment use only How Telemate uses Expanded Memory and Extended Memory In the older EMS 3.2, there are only 4 physical pages located above 640K which is call the standard page frame. In EMS 4.0, there should be 12 physical pages above 640K. However, some EMS 4.0 drivers provide only the standard page frame and some advanced memory management programs use some of those physical pages to enlarge the conventional memory area. To maintain compatibility, Telemate only uses the standard page frame. TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 73 If EMS is present, Telemate maps 3 logical pages (48K) into the page frame and uses it as if it is conventional memory. The remaining 16K- byte physical page arts as a buffer to swap data to and from the conventional memory and Expanded Memory. The data includes the content of the backscroll buffer, clipboard buffer, editor file, viewer file and phone directory. As a logical page contains only 16K bytes, a large phone directory have to be divided into several pages - each contains 125 phone entries. Each phone entry is 131 bytes. Therefore, a 125-entry (16375 bytes) phone directory occupies 1 logical page while a 126-entry (16506 bytes) directory occupies 2 logical pages (32K). Telemate can also swap part of itself to EMS while in DOS shell. XMS requires a driver as an interface between the Extended Memory and the application program. You can find HIMEM.SYS by Microsoft in public domain and you should include the line DEVICE=HIMEM.SYS in the CONFIG.SYS. This line must be the first device driver that uses Extended Memory. RAM disk drivers or other device drivers that use Extended Memory must be placed after this line. Caution: VDISK.SYS from DOS 3.3 and below is not compatible with HIMEM.SYS. If XMS is present, Telemate requests the 64K High Memory Area and uses it as if it is conventional memory. The phone directory is loaded into a Extended Memory Block which is allocated in multiple of 1K-byte. As a result, a 126-entry phone directory occupies only 17K bytes. The rest of Extended Memory is used to store the content of the backscroll buffer, clipboard buffer, editor file and viewer file. Telemate can swap part of 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 always use 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. Firstly, they allocate 64K conventional memory for the 64K standard page frame. Secondly, Telemate stores data in 1K-byte blocks but the simulators have to load a 16K-byte logical page to conventional memory before allowing Telemate to store the data to the page frame. This process is slow and may cause data lost from the modem. As a result, if you have Extended Memory, you should install HIMEM.SYS as the XMS driver. 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 512K equipped. TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 74 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. Only certain types of data can be stored in the extra memory because the video buffer may be destroyed during DOS shell. These types of data include the windows image and file list in the file directory. In 25 line mode, the first 35K are used to store windows image and the rest is used to increase the size of the file list from 100 entries to 300 entries. In 43/50 line mode, all the video ram is occupied by the windows image. 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, the 32K mode should be selected for compatibility. If Telemate is running under DESQView 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 512K. The remaining 512K 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 TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 75 FILES=20 BUFFERS=5 SHELL=COMMAND.COM /p /e:1000 DEVICE=HIMEM.SYS DEVICE=SMARTDRV.SYS 512 Caution: VDISK.SYS in DOS 3.3 or earlier is not compatible with HIMEM.SYS. 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, 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. If installed properly, HIMEM.SYS should report '64K High Memory Area available'. At present, not many softwares support XMS memory. Therefore, you should allow 64K extended memory for use of the XMS High Memory Area and the rest as expanded memory so that most of the application can benefit from your extra 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. TELEMATE 2.11 APPENDIX E: MEMORY MANAGEMENT 76 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=SMARTDRV.SYS /a256 In the following sample setup, the 'Memory Size' requirements may vary from 430 to 500 depend on the back scroll limit and the size of the files you are going to edit or view. Memory Size (in K): 470 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] TELEMATE 2.11 APPENDIX F: ERROR MESSAGES 77 APPENDIX F: ERROR MESSAGES When an error is encountered the Error Box appears for a preset amount of time. The length of time displayed can be altered through the Error Pause item in 'Option/General Dialog'. 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 the message "Cannot open configuration file". 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 "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. "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 2.11 APPENDIX G: TELEMATE SUPPORT BBS 78 APPENDIX G: 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 three Bulletin Board Systems such that you can find the latest version and a Telemate message area on these BBS's. Bulletin Board System Phone Number Network Baud Location ───────────────────── ──────────── ───────── ───── ────────────── PC Connect 416-733-9052 SmartNet 14400 Toronto Canada Southern Reaches 519-973-9841 WWIV(5950) 2400 Windsor Canada SouthWest Connect 519-352-7010 SmartNet 14400 Chatham Canada User To User 214-492-6565 RelayNet 14400 Dallas USA If you have questions, problems or suggestions or have found a bug in Telemate, you can leave messages on these Telemate Support BBS's. Echomail conferences have been set up by these BBS's in SmartNet, RelayNet and WWIVnet, ask your sysop to join them. Telemate National FidoEcho is also available from the backbone in region 11. It can be obtain through normal channels in other regions. For the German edition, you may contact MicroServe Information eXchange at +49 4298 30086 (1200 / 2400 baud) or NUA 26245429823010 through X25 packet switching network. In addition, you can reach the author on the following networks: BIX winfredhu CompuServe [72070,3515] InterNet 72070.3515@compuserve.com I want to express my appreciation to Avery Wagg of SouthWest Connect, Kevin Carr of User To User, Rob Lysy of Southern Reaches and John Scarfone of PC Connect 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, Ron Freimuth of Double AAce, Bruce Guthrie of Maxie's Toy BBS and Bob Farmer of User To User for their contributions. TELEMATE 2.11 INDEX 79 INDEX [Alt -], 16, 54 ASCII protocol, 65 [Alt =], 37 ASCII transfer, 62 [Alt A], 36, 58 Add CR before LF, [Alt B], 44 Add LF after CR, [Alt C], 36, 40 Strip CR, [Alt D], 25 Strip high bit, [Alt E], 37 Strip LF, [Alt F], 23 Translation, [Alt G], 36 Auto answer string, 48, 60 [Alt H], 31, 37 Auto baud detect, 56 [Alt I], 35 Auto dial option, 15 [Alt J], 23 Auto download sequence, 62 [Alt K], 24 Auto indent, 12, 42 [Alt L], 34 Auto log option, 31 [Alt M], 45 Auto script, 16 [Alt O], 50 Auto wrap, 30, 59 [Alt P], 35, 40 [Alt Q], 35, 40, 43, 44 B [Alt S], 34 [Alt T], 32 Back window, 44 [Alt U], 40 Backup source, 12, 42 [Alt V], 43 Batch upload, 33 [Alt W], 19 Batch Ymodem protocol, 63 [Alt X], 24 Baud rate, 7, 29, 60 [Alt Y], 35 Bell, 55 [Alt Z], 19 BiModem protocol, 62, 65 [Center], 44 Break signal, 37, 48 [Ctrl Up], 44 Busy strings, 56 [Ctrl Down], 44 [Ctrl Left], 24 C [Scroll Lock], 45 [Shift Alt C], 40 Cancel string, 56 [Shift Alt U], 40 Capture, 13, 45 Carrier signal, 30, 59 16550 FIFO, 8 CD, 22 12/24 hour format, 54 CGA, 1, 4, 8 Changing options, 52 A Character pacing, 59 Chat mode [Alt C], 35, 36 Add line feed, 30, 59 Check boxes, 52 Add return, 30, 59 Check disk space,61 Alarm, 21, 33 Circular buttons, 52 Alarm song, 11 CIS Quick B protocol, 65 Alarm sound, 55 Clear backscroll buffer, 45 Alarm time, 55 Clear text [Ctrl Home], 37 Already online options, 15 Clipboard [Alt K], 24 Append entries [F10], 31 Closing window, 20 Answer mode, 36, 60 CLS, 22 Answer back string, 60 Connect Strings, 56 ASCII code, 48 Color, 13 TELEMATE 2.11 INDEX 80 Com parameter, 6, 29, 60 E Com port, 6, 29, 61 Command line options, 15 Edit [F6], 37 Command stack [Alt Y], 35 Edit directory, 57 Communication options, 60 Edit menu, 12, 39 Confirm hang up, 59 Edit window, 37 Connection, 30, 59 Editor margin, 35, 39, 54 COPY, 22 EGA, 1, 4, 9 Copy [Alt C], 36, 40 EMS, 1, 4, 11, 70 cUt [Alt U], 40 EMS Limit, 11 Ending session, 24 D Enhanced CGA, 1 ERASE, 22 Data bits, 7, 29, 61 Error messages, 77 DEL, 22 Error pause, 54 Deleting text, 38 Evaluation disks, 3 Desqview, 11,74 Executing Telemate, 14 Destructive Backspace, 30, 59 Expand blank line, 35, 59 Dial menu, 26 Expanded memory, 1, 11, 70 Dial options, 55 Extended memory, 1, 10, 70 Dial prefixes, 7, 31, 55 Extended pacing, 59 Dial setup dialog, 55 External protocols, 66 Dial suffix, 7, 31, 55 Dial time, 22, 55 F Dial window, 25 Dialing functions, 26 File directory [Alt F], 23 DIR, 22 Filename guessing, 61 Directory dialog, 56 Filter [F8], 42 Directory functions, 25 Find [F4], 26, 41 Directories and files, 56 Format of phone directory, 69 Disclaimer, 4 Full screen option, 16 Doorway mode [Alt =], 37 DOS command window, 22 G CD COPY General dialog, 53 CLS General options, 53 DIR German edition, 3, 78 DEL Goto [F7], 31, 42 ERASE INS, INSIDE H MOVE REN, RENAME Hang up, 31, 37, 48, 59, 60 TYPE Help [F1], 21 Download batch, 62 HIMEM.SYS, 70 Download directory, 57 Hot key macro symbol, 49 Downloading files [PgDn], 33 TELEMATE 2.11 INDEX 81 I Message pause, 54 Modem init string, 48, 60 Image file [Alt I], 35 Modem hangup string, 48, 60 Initial guessing, 35, 60 Modem7 protocol, 65 Installation program, 6 Monochrome, 4, 8 INS, INSIDE, 22 Mouse, 1, 9, 17, 38 Mouse port, 10, 54 J Mouse type, 9, 54 Mouse speed, 10, 54 Jmodem protocol, 65 MOVE, 22 Jump to DOS [Alt J], 23 Moving windows, 20 Multitasking, 1 K Multi-user license, 3 Music, 55 Kermit protocol, 65 Key (external protocol), 62 N Keyboard table, 46 Keypad table, 46 Name (external protocol), 62 New [Alt N], 41 L Next [F5], 26, 41 Learning script, 31, 34 O License, 2 Line pacing, 59 Option dialog, 51 Load phone directory, 16, 26 Originate mode, 36, 60 Loading files, 41 Loading macros, 50 P Loading options, 52 Local echo, 29, 59 Pace character, 59 Log directory, 57 Parity, 7, 29, 61 Log filter, 34, 55 Password, 28, 48 Logging sessions [Alt L], 34 Paste [Alt P], 35, 40 Long distance charge, 67 Phone directory, 69 Clear total M Create new directory Delete entry Macro menu, 47 Insert entry Macro symbols, 48 Print directory Macro table, 46 Reorder entries Macro window, 45, 46 Sort directory Manual dial [F7], 31 Zap connect date Margins, 35, 39, 41, 45, 54 Printer log, 37 Mark [F10], 40 Printing files, 24 MegaLink protocol, 65 Prompt download name, 62 Memo, 25 Protocol, 8, 32, 61, 64 Menu, 19 Protocol options, 51 Menu bar, 16, 54 Puma protocol, 65 TELEMATE 2.11 INDEX 82 Q T Quote [Alt Q], 35, 40, 43, 44 Telemate directory, 57 Quote prefix, 60 Telink protocol, 64 Terminal command stack, 35 R Terminal options, 58 Terminal types, 30, 58 Recalling command, 35 Terminal window, 32 Receiving files [PgDn], 33 Text Boxes, 53 Redefining the keyboard, 49 TMPhone, 69 Redial attempt, 56 TMStat, 67 Redial pause, 56 Translation, 46 Reformat [F9], 42 Transferring files, 32 Registration, 2 TYPE, 22 Relaxed Xmodem protocol, 64 Type ahead, 35 REN, RENAME, 22 Replace [F6], 22, 41 U Resizing windows, 20 Revise script [F9], 31 Upload batch, 62 RTS/CTS flow control, 8, 59 Upload directory, 57 Uploading files [PgUp], 32 S Usage log, 55, 67 Using scripts, 34 Save dial list [F2], 26 Saving files [F2], 41 V Saving keyboards, 50 Saving keypads, 50 VGA, 1, 4, 9 Saving macros, 50 Video displays, 8 Scroll lock, 45 Video height, 9 Saving options, 52 Video RAM, 1, 11, 73 Saving Windows, 52 View window, 43 Script [Alt S], 29, 34 Virtual memory, 1, 57, 70 Script compile error, 77 Script directory, 57 W Scroll bars, 9, 18, 54 Scroll back limit, 54 Windows, 19 SEAlink protocol, 64 Closing Selecting windows, 20 Moving Sending files, 32 Resizing Shareware, 2 Selecting Snow checking, 9 Starting Starting windows, 19 Zooming Status line, 37, 54 Wordstar convention, 39 Strip high bit, 59 Write [Alt A], 41, 44 Stop bits, 7, 29, 61 Support BBS, 78 Swap Telemate To Disk, 54 Swap Telemate To Xms/Ems, 53 System requirements, 4 TELEMATE 2.11 INDEX 83 X Xmodem protocol, 64 Xmodem protocol, Relaxed, 64 Xmodem-1K protocol, 64 XMS, 1, 10, 70 XMS driver HIMEM.SYS, 70 XMS himem, 10 XMS limit, 10 XON/XOFF flow control, 8, 59 Y Ymodem protocol, 64 Ymodem protocol, Batch, 64 Ymodem-G protocol, 64 Z Zooming windows, 19 Zmodem protocol, 64 Zmodem ascii-upload, 62 Zmodem auto-download, 62 Zmodem recovery, 62