PC-Test Pro

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

/ PC-Test Pro / PCTESTPRO.iso / disktool / ripterm / entp / testdriv.exe / RIPTERM.DOC < prev next >

Wrap

Text File | 1995-03-25 | 320.4 KB | 6,859 lines

┌──────────────────────────────────────────────────────────┐ │ │░ │ ──────────────────────────────────────── │░ │ │░ │ RIPterm v2.00 Professional │░ │ │░ │ ──────────────────────────────────────── │░ │ │░ │ │░ │ January 23, 1995 │░ │ │░ │ │░ │ Copyright (c) 1992-95, TeleGrafix Communications, Inc. │░ │ All Rights Reserved │░ │ │░ └──────────────────────────────────────────────────────────┘░ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ RIPterm Documentation Quick Reference ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ For Information On: Section ----------------------------------------------------- ------- Installation Instructions 2.0 Mouse Configuration Problems and Performance Issues 2.0.1 Using RIPterm Without A Mouse 2.0.2 Uploading or Downloading Files 3.2 Menus 3.0 Setup Screens 4.0 The Main RIPterm Features 5.0 Troubleshooting / Common Configuration Problems Appx A Contacting TeleGrafix Technical Support Appx C ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ Table of Contents ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ This documentation is organized into five major sections, plus an appendix. The five major sections are Introduction, Installation, Pull-Down Menu Reference, RIPterm Setup Options, and RIPterm Features. The Appendix contains troubleshooting information, answers to common questions, a keyboard reference of menu shortcuts, and how to contact Technical Support. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Preface ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm Documentation Quick Reference Table of Contents ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Section 1 ■ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ 1.0 ■ Introduction 1.1 ■ Distribution Information 1.2 ■ Limited Warranty / Licensing Agreement 1.3 ■ Trademarks 1.4 ■ Program Requirements 1.5 ■ Glossary of Terms ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Section 2 ■ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ 2.0 ■ Installation 2.0.1 ■ Important Information - Mouse Config and Performance 2.0.2 ■ Using RIPterm Without a Mouse 2.1 ■ Starting Up RIPterm 2.1.1 ■ Video/Mouse Setup 2.1.2 ■ Welcome to RIPterm Setup Screen 2.1.3 ■ Audio Setup Screen 2.1.4 ■ Move Files To Their Correct Directories 2.1.5 ■ Convert RIPscrip v1.x Icons to v2.x Icons 2.2 ■ Getting On-line Help 2.2.1 ■ Help on the Menus 2.3 ■ RIPterm Command Line Options ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Section 3 ■ Pull-Down Menu Reference ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ 3.0 ■ Pull-Down Menus 3.1 ■ The System Menu 3.2 ■ The File Menu (Alt-F) 3.3 ■ The Connect Menu (Alt-C) 3.4 ■ The Options Menu (Alt-O) 3.5 ■ The Setup Menu (Alt-S) 3.6 ■ The Debug Menu (Alt-U) ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Section 4 ■ RIPterm Setup Options ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ 4.0 ■ RIPterm Setup 4.0.1 ■ RIPterm Setup - What Is Saved? 4.1 ■ General Setup 4.2 ■ Video/Mouse Setup 4.3 ■ Audio Setup 4.4 ■ System Font Setup 4.5 ■ Translation Tables 4.6 ■ Modem Setup 4.6.1 ■ Modem Command Strings 4.6.2 ■ Modem Port Settings 4.6.3 ■ Modem General Settings 4.7 ■ Modem Dialing Prefixes 4.8 ■ Modem Hardware Setup 4.9 ■ File Transfer Setup 4.9.1 ■ Protocol Transfer Settings 4.9.2 ■ ASCII Upload Settings 4.9.3 ■ Capture Log Settings ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Section 5 ■ RIPterm Features ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ 5.0 ■ RIPterm Features 5.1 ■ The Status Bar 5.2 ■ The Dialing Directory 5.2.1 ■ Editing Dialing Directory Entries 5.2.2 ■ Editing Dialing Directory Entries Custom Port Settings 5.2.3 ■ Dialing Directory Conversion Utility (DIALCONV.EXE) 5.2.4 ■ Dialing Directory File Format 5.2.5 ■ The Dialing Window 5.3 ■ Keystroke Macro Editor 5.3.1 ■ Control Characters in Keystroke Macros 5.4 ■ View Scrollback Buffer 5.5 ■ External Applications 5.5.1 ■ The Application Editor 5.5.2 ■ Application Text Variables 5.6 ■ Chat Mode 5.7 ■ Text Variables 5.7.1 ■ User-Defined Text Variables 5.7.2 ■ User-Defined Text Variable Data Security ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ Appendices ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Appx A ■ Troubleshooting/Problems A.1 ■ Mouse Doesn't Work A.1.1 ■ "Bus" Mouse Doesn't Work A.1.2 ■ "Serial" Mouse Doesn't Work A.2 ■ Modem Isn't Responding A.3 ■ Noisy Telephone Connections A.4 ■ Performance Issues A.4.0 ■ Symptoms of a Performance Problem A.4.1 ■ Solutions to Data Receive Performance Issues A.4.2 ■ Solutions to Sound Playback Performance Issues A.4.2 ■ Solutions to Video Display Performance Issues A.5 ■ Common Configuration Problems A.5.1 ■ I Can't See What I Type A.5.2 ■ Every Line of Text Lays on Top of the Last A.5.3 ■ My File Transfers Fail Immediately A.5.4 ■ My Modem is Always On-Line (Resuming Previous On-line Session) A.5.5 ■ RIPterm always says "Hang up failed" when I try to hang up. A.5.6 ■ I get the message "CTS is not enabled. Disabling RTS/CTS". A.5.7 ■ I can connect with some BBS's but not others. A.5.8 ■ RIPterm locks up when I start up or seems to be stuck in a loop. Appx B ■ Menu Keyboard Shortcuts Reference Appx C ■ TeleGrafix Technical Support ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ 1.0 ■ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ Thank you for using RIPterm! RIPscrip graphics are a revolutionary new way of graphically interacting with on-line hosts. Use of RIPterm is defined in the Licensing Agreement. You should be familiar with the terms of the licensing agreement. Please read this section carefully. RIPterm Professional version 2.0 comes with 30 days unlimited technical support from your date of purchase. After this time has expired, you will fall under our new paid Technical Support plan. There will be options for paying as you go, 900 number technical support access, and yearly support contracts that can optionally include software updates. Contact TeleGrafix for more information on this program. We expect it will be in place in March 1995. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 1.1 ■ Distribution Information ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm Introduction Release is NOT a freeware or shareware product that can be freely distributed. It is commercial software sold by TeleGrafix Communications, Inc. If you do not have a valid license for RIPterm, please contact TeleGrafix Communications to purchase the software. We need your support to continue to make high quality communications products. Thank you for your continued support. TeleGrafix Communications, Inc. 16458 Bolsa Chica, #15 Huntington Beach, CA 92649 Tech Support: (714) 379-2130 Voice: (714) 379-2131 Fax: (714) 379-2132 BBS: (714) 379-2133 (accepts orders 24 hours a day) ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 1.2 ■ Licensing Agreement ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm Professional Version 2.0 Software Licensing Agreement DISCLAIMER YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE INSTALLING OR USING THIS DISKETTE. INSTALLING OR USING THIS DISKETTE INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH THEM, YOU SHOULD RETURN THIS DISKETTE WITHIN 30 DAYS OF THE ORIGINAL DATE OF PURCHASE, AND THE PRICE OF THE PRODUCT WILL BE REFUNDED TO YOU. DEFINITIONS "You" and "Your" shall be taken as referring to the person or business entity who purchased this License to use this Software or for whom such License was purchased. "Software" shall be taken as referring to the files supplied on the diskette(s) inside the package, and to any and all copies, updates, modifications, functionally-equivalent derivatives, or any parts or portions thereof. LICENSE You may: 1. Install and use one copy of this Software on a single Computer. 2. Copy this Software into machine-readable or printed form, for backup or archival purposes in support of your use of this Software. 3. Transfer this Software and license to another party if the other party agrees to accept the terms and conditions of this Agreement. If the enclosed Software is an update, any transfer must include the updated and all prior versions. If you transfer the Software, you must at the same time either transfer all copies, whether in machine-readable or printed form, to the same party, or destroy any copies not transferred. If this Software package contains both 3.5 and 5.25 disks, only a single Software License is created hereby. All enclosed diskettes are covered under, and restricted by, the terms of this single Software License Agreement. YOU MAY NOT USE, COPY, MODIFY, OR TRANSFER THIS SOFTWARE, OR ANY COPY, MODIFICATION, OR MERGED PORTION, IN WHOLE OR IN PART, EXCEPT AS EXPRESSLY PROVIDED FOR IN THIS LICENSE, OR IN AMENDMENTS SIGNED BY AN OFFICER OF TELEGRAFIX COMMUNICATIONS, INC. ("TeleGrafix"). IF YOU TRANSFER POSSESSION OF ANY COPY OF THIS SOFTWARE, OR ANY FUNCTIONALLY-EQUIVALENT DERIVATIVE, OR ANY PORTION OR MODIFICATION THEREOF, TO ANOTHER PARTY, YOUR LICENSE IS AUTOMATICALLY TERMINATED. TERM This license is effective until terminated. You may terminate it at any time by destroying all copies of the Software covered by this Agreement. It will also terminate upon conditions set forth elsewhere in this Agreement or if you fail to comply with any term or condition of this Agreement. You agree upon such termination to destroy this Software, including all copies, functionally- equivalent derivatives, and all portions and modifications thereof in any form. LIMITED WARRANTY THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (NOT TELEGRAFIX) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. SOME STATES DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO HAVE OTHER RIGHTS WHICH VARY FROM STATE TO STATE. TeleGrafix does not warrant that the functions contained in this software will meet your requirements or that the operation of this Software will be uninterrupted or error-free. However, TeleGrafix does warrant the diskette on which the Software is furnished to be free from defects in materials and workmanship under normal use for a period of ninety (90) days from the date of delivery to you. LIMITATIONS OF REMEDIES TeleGrafix entire liability and your exclusive remedy shall be:. A) The replacement of any diskette not meeting TeleGrafix "Limited Warranty" and which is returned to TeleGrafix , or B) If TeleGrafix is unable to deliver a replacement diskette which is free of defects in materials or workmanship, you may terminate this Agreement by returning this Software and your money will be refunded. IN NO EVENT WILL TELEGRAFIX BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF TELEGRAFIX OR ITS AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY. SOME STATES DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION OR EXCLUSION MAY NOT APPLY TO YOU. GENERAL You may not sublicense, assign or otherwise transfer this License or Software except as expressly provided in this Agreement. Any attempt to otherwise sublicense, assign, or transfer any of the rights, duties or obligations hereunder is expressly prohibited and will terminate this Agreement. All Agreements covering this Software (including but not limited to any and all updates, upgrades, and enhancements to this Software or any portion thereof, bearing the same registration number) shall be deemed to be counterparts of one and the same License Agreement instrument. BY INSTALLING OR USING THIS SOFTWARE, YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU FURTHER AGREE THAT IT IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE AGREEMENT BETWEEN US, WHICH SUPERSEDES ANY PROPOSAL OR PRIOR AGREEMENT, ORAL OR WRITTEN, AND ANY OTHER COMMUNICATIONS BETWEEN US RELATING TO THE SUBJECT MATTER OF THIS AGREEMENT. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 1.3 ■ Trademarks ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm, the RIPterm logo, RIPscrip, RIPaint, TeleGrafix Communications, and the TeleGrafix Communications logo are all trademarks of TeleGrafix Communications, Inc. All other trademarks are trademarks of their respective holders. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 1.4 ■ Program Requirements ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm requires that you be using an 80386 or higher IBM-PC compatible computer system running MS-DOS version 3.0 or higher. You must have at least 2Mb of memory in the system configured as XMS memory (EMS memory is not recognized). A hard disk also required. You must have an EGA or greater video adapter and a modem connected to serial port COM1 through COM4. A mouse and a color monitor are not required, but are strongly recommended. This software is a 32-bit protected mode application that takes advantage of the 80386 microprocessor's features and capabilities. It requires and makes use of extended memory. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 1.5 ■ Glossary of Terms ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ active - The configuration that is currently in use by RIPterm. This setup includes modem, hardware, file transfer, audio, and emulation settings. For a complete list of everything included in the active setup, see Section 4.0.1 ■ RIPterm Setup File. baud - The name used for the speed at which a modem communicates, which is measured in Bits Per Second (BPS). Baud has a more technical definition which is different than BPS, but common usage of baud and BPS has made the terms interchangeable. True bithead computer geeks will use the term BPS instead of baud to be technically accurate. bitmap - Generally refers to the method of storing each individual dot (pixel) in a picture shown on your computer screen in a file on your disk. Photographs that have been scanned in are stored at bitmaps. Another type of graphic file format is a vector graphic file. BPS - Short for Bits Per Second. See definition for BAUD. data - Data compression is a way of squeezing the information being sent compres- out over the modem, to achieve faster transmission of data. sion The common compression protocols are MNP5 and v.42bis. default - The setting to use unless another setting is specified to override the default. For example, RIPterm gets installed into the default C:\RIPTERM directory, unless you have Install put in different directory. dialog - A dialog box is a window appearing on the screen that contains box information, is requesting some input, or is for setting configuration options. A dialog box always has CANCEL and HELP buttons at the bottom, and will usually have some other buttons such as OK. A button hotkey in a dialog box uses Alt + the highlighted letter to select that option, or you can use Tab or Shift-Tab to go forwards/backwards through each dialog item. error - Error correction's job is to make sure that the data transmitted correction by the remote modem is receive perfectly by your modem. Common error correction protocols are MNP2 through MNP4 and v.42. host - refers to any system you are connected to. This can be a BBS, a mainframe, a network application, or whatever. The term "host" is used generically to mean any one of these different types of systems you can dial into. hotkey - a keyboard equivalent for a menu option, keystroke macro, or a button. A menu option will use a combination of the Alt key with a letter (except where noted). A button hotkey in a dialog box uses Alt + the highlighted letter. icon - an icon is a bitmap of varying size. Icon files may end in .BMP, .BMM (mask files), or .BMH (hot icons - used with buttons) JPEG - A compressed graphic file format. JPEG is short for Joint Photographic Experts Group, which is the association that created the JPEG file format. lossy - A type of compression used on bitmap graphic files. JPEG uses a technique of subtly (or drastically) changing the colors in an image to better compress it. The level of compression can be changed to get a good balance between image quality and file size. Lossy is based on the word "loss", because the image loses quality when compressed in this manner. The opposite would be "loss-less" compression, in which nothing is changed. Lossy compression is much more effective than loss-less. The loss in quality can go anywhere from un-noticeable to horrible. pixel - Short for PIcture ELement, it is simply one dot on the screen. A bitmap image is made up of a whole bunch of pixels. RIPscrip - A graphical and interactive multimedia language created by TeleGrafix for efficiently transmitting graphics via any kind of communications link, on any type of computing platform. RIPscrip is short for Remote Imaging Protocol script language. session - This is the main RIPterm screen where all communications with screen whatever you're connected to is displayed, such as RIPscrip graphics and text. It is the screen where you can access the menus, interact with the host, and usually has the Status Bar displayed at the bottom. shrubbery- A small bush, usually decorative; best arranged next to a path. string - a string is a group of characters, a mix of letters, numbers, and/or punctuation characters. UART - The serial port controller microchip in your computer. UART is an acronym for Universal Asynchronous Receiver/Transmitter. vector - The method of storing the instructions to draw a picture, rather than each pixel in the image. For example, if you had a line drawn on your screen, the vector information would be the beginning and ending points of the line, and its color and pattern, rather than each pixel in the image. Vector data is much smaller than pixel data. ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ 2.0 ■ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ RIPterm Professional must be installed via the installation program provided. It will not run if it is just copied off the floppy. Insert the disk into drive A: or drive B:, and then switch to that drive by typing A: or B:, and pressing ENTER. Then type INSTALL and press ENTER. You will be prompted to enter your Serial Number. The Serial Number can be found on the of Disk 1 of 2, on your registration card, or on the Licensing Envelope that contained the disks. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.0.1 ■ Important Information - Mouse Config and Performance ▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The right mouse button brings up the menu bar in RIPterm. You can use the keyboard too, but using the right mouse button is far easier. Complications may arise currently if you have a SERIAL mouse installed. If you get garbage on the screen when you move the mouse, then there is a conflict with the MODEM port and the MOUSE port. Try deleting the file RIPTERM.CNF (RIPterm's configuration file) and restarting RIPterm. Once inside RIPterm, select Modem Setup from the Setup menu and verify that your settings are correct for your PC's configuration. See Appendix A ■ Section A.1 ■ Mouse Doesn't Work for more information and solutions on this issue. RIPterm version 2 implements cutting-edge technology, and sometimes may push your system to try to do more than it can. If you are having problems playing sounds or with losing characters, see Appendix A ■ Section A.4 ■ Performance Issues for more information and troubleshooting hints. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.0.2 ■ Using RIPterm Without a Mouse ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Using the menus: You can navigate through RIPterm without the use of a mouse. Each menu and dialog box item has an associated hotkey. The character for selecting that item is highlighted in yellow. To bring up just the menu bar, type Alt-1 (hold down the Alt key and press the 1 key). Using dialog boxes: While in a dialog box, you can use Alt + the highlighted letter to select that option, or you can use Tab and Shift-Tab to go forwards/backwards through each dialog item. Using the Session Screen: RIPterm also supports the use of the TAB and SHIFT-TAB keys to jump from mouse field to mouse field. When you are on the Mouse Field you wish to select, press ENTER to select it. Press ESC to get out of Mouse Field Select mode. The use of TAB and SHIFT-TAB can be disabled by de-selecting Mouse Field Select from the Options menu, or by pressing Ctrl-Alt-O. Many of the clickable buttons on a RIPscrip screen use hot keys, meaning that by pressing just one key on the keyboard, it behaves EXACTLY the same as if you had clicked on that button with a mouse. A hotkey will have one character underlined, or in a different color, or both! Press that character to activate that button. See Section 3.4 ■ Options Menu for more information on the Button Hotkeys and Mouse Field Select options. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1 ■ Starting Up RIPterm ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Switch to the RIPTERM directory by typing at the DOS prompt: cd \RIPTERM followed by pressing ENTER Then start up the RIPterm software by typing at the DOS prompt: RIPTERM followed by pressing ENTER There are a number of command line options that may be specified for RIPterm. See Section 2.3 ■ RIPterm Command Line Options for details. When starting up RIPterm, you are presented with three to five dialog boxes requesting configuration information. Sections 2.1.1 through 2.1.5 document these dialog boxes. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1.1 ■ Video/Mouse Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm version 2.0 supports 117 different video cards and video modes. If yours is not listed, chances are that your video card supports one or more of the VESA video modes, which were created as a standard way of addressing video hardware from software. Check your video card documentation to see what modes it supports. VESA mode on some video cards may be slower than the native mode -- so if a native mode is available, use it! On some video cards, a memory resident driver (TSR) needs to be loaded for VESA support to work for that video card. The fastest resolution to run at is 640 x 480, because less memory is being addressed. Scrolling especially is affected by the resolution. Most video cards also run faster in 256 color mode than in 16 color mode, usually because of their hardware design. See Appendix A.4.3 ■ Solutions to Video Display Performance Issues for more information. If you have a mouse connected to your computer, you must load the mouse driver before running RIPterm to be able to use the mouse. The mouse driver is usually a file called MOUSE.SYS that is loaded in your CONFIG.SYS, or a file called MOUSE.COM that is loaded in your AUTOEXEC.BAT file. If you're not loading a mouse driver, you can't use the mouse. NOTE: RIPterm doesn't use the center button on three-button mouses for any functions. Refer to Section 4.2 ■ Video / Mouse Setup for a list of video cards supported, and a diagram of the Video/Mouse Setup screen. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1.2 ■ Welcome to RIPterm Setup Screen ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Welcome to RIPterm Setup ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││Welcome to RIPterm setup. In order to get you up and running as quickly ││ ││as possible, we need to ask a few questions about your computer's ││ ││configuration. If you have any doubts about the following questions, ││ ││select the HELP option. It will assist you in answering these questions ││ ││painlessly so you can get online as quickly as possible. ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││ ││ ││ ┌─────────────┬─┐ ┌──────────┬─┐ ││ ││ Modem COM Port │COM1 ││ Printer Port │LPT1 ││ ││ ││ └─────────────┴─┘ └──────────┴─┘ ││ ││ ┌─────────────┬─┐ ┌──────────┬─┐ ││ ││ Modem Baud Rate │19,200 ││ Printer Type │Postscript││ ││ ││ └─────────────┴─┘ └──────────┴─┘ ││ ││ ┌─────────────┬─┐ ││ ││ Flow Control │RTS/CTS (Hard││ ││ ││ └─────────────┴─┘ ││ ││ ││ ││ [X] Port Lock ││ ││ ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ ││ ││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ After configuring your video and mouse settings, the next thing RIPterm needs to know about is the configuration for your modem and printer. The options on the left let you set up your modem connection, and the options on the right set up your printer connection. The most common settings for high speed modems (modems faster than 2400 baud) are Modem Baud Rate set to 38,400, Flow Control set to RTS/CTS, and Port Lock enabled. Modem COM Port tells the computer which communications port the modem is connected to. The valid options are COM1, COM2, COM3, and COM4. If your COM port does not use the standard interrupt (IRQ) and base address settings, you can configure these later by selecting Modem Hardware Setup from the Setup menu. See Section 3.5 ■ The Setup Menu for more info. Modem Baud Rate sets the connection speed between your computer and modem. The valid baud rate settings are 300; 1200; 2400; 4800; 9600; 38,400; 57,600; and 155,200. If you select a baud rate above 2400, RIPterm will automatically enable Port Lock and set Flow Control to RTS/CTS (Hardware). These are the most common settings for high speed modems. Flow Control controls the flow of data to your computer. It is a way for RIPterm to be able to turn the flow of incoming information on and off, like the faucet on a garden hose. The valid settings are RTS/CTS (also know as Hardware Flow Control), Xon/Xoff (also known as Software Flow Control), and None. It is not recommended to set flow control to none. If your modem or modem cable does not support RTS/CTS, at least use Xon/Xoff. It's better than nothing! Some modems and hosts don't support any flow control. Port Lock keeps the speed at which your modem and computer talk to each other at a fixed speed, and lets your modem worry about what speed to is talking to another modem at. This is recommended for high speed modems. For a discussion of the Flow Control and Port Lock features, refer to Section 4.6.3 ■ Modem General Setup. The Printer Port option tells RIPterm which port your printer is connected to. The valid options are LPT1, LPT2, LPT3, and None. If you don't have a printer connected, select None. Printer Types lets RIPterm know what language your printer speaks. The valid types are None, Plain Text, Epson, HP LaserJet, and Postscript. For printing graphics, you must use Epson, HP LaserJet, or Postscript. Plain Text can only print the Scrollback Buffer and the Dialing Directory list. ┌────┐ │ OK │ └────┘ Clicking OK locks in your settings and continues to the next configuration screen. ┌────────┐ │ Cancel │ └────────┘ Clicking Cancel exits RIPterm. ┌──────┐ │ Help │ └──────┘ Clicking Help will create a request for a government study into the effects of bovine methane emissions on software performance. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1.3 ■ Audio Setup Screen ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ A new feature in RIPterm is the support for digitized sound, in the form of .WAV files. The Audio Board Configuration is for configuring RIPterm for your audio hardware. The easiest way to do this is by using Auto-Sense. See Section 4.3 ■ Audio Setup for details on custom configuration. There are some performance issues in doing sound and communications at the same time. RIPterm version 2 implements cutting-edge technology, and sometimes may push your system to try to do more than it can. If you are having problems playing sounds or with losing characters, see Appendix A ■ Section A.4 ■ Performance Issues for more information. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1.4 ■ Move Files To Their Correct Directories ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Move Files To Their Correct Directories ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││ ││ ││ RIPterm needs files to be in certain directories to be able to use them.││ ││ Files in the selected categories were found in the wrong directory. ││ ││ If a category is grayed-out, no files in that category were found. ││ ││ ││ ││ To move all files, click MOVE ALL FILES. SKIP ALL FILES moves nothing. ││ ││ To move just selected files, click the MOVE SELECTED FILES button below.││ ││ To skip moving a category of file, uncheck the box by that category. ││ ││ ││ ││ These files need to be moved into the ICONS directory. ││ ││ ││ ││ [ ] Icon Files (BMP, ICN, etc.) [ ] Sound Files (WAV) ││ ││ [ ] Image Files (JPG) [ ] RIPscrip Files (RIP) ││ ││ ││ ││ These files need to be moved into the FONTS directory. ││ ││ ││ ││ [ ] Font Files (CHR, FF1, FNT) ││ ││ ││ ││ To prompt for each file individually, click on PROMPT FOR EACH FILE. ││ ││ ││ ││ [ ] Prompt for each file in the selected categories individually ││ ││ ││ ││ ┌─────────────────────┐ ┌─────────────────────┐ ││ ││ │ Move All Files │ │ Move Selected Files │ ││ ││ └─────────────────────┘ └─────────────────────┘ ││ ││ ┌─────────────────────┐ ┌─────────────────────┐ ││ ││ │ Skip All Files │ │ Help │ ││ ││ └─────────────────────┘ └─────────────────────┘ ││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm is accompanied by a number of icon files. They must be located in the ICONS\ directory under the RIPterm directory (for example: C:\RIPTERM\ICONS) for RIPterm (and the remote host system) to be able to use them. When you install RIPterm, a ICONS\ sub-directory is created under the RIPTERM directory. RIPterm will try to sense if the icons are easily locatable, and if so, prompt you to move them to the correct location when you run RIPterm. There are other categories of files that must also be in the ICONS sub-directory for RIPterm to be able to use them: File Category File Extension ------------------------------ ---------------- RIPscrip v1.x Icon Files .ICN .MSK .HOT RIPscrip v2.x Icon Files .BMP .BMM .BMH Image Files .JPG Sound Files .WAV RIPscrip Files .RIP There are also font files that are included with RIPterm. Like icons, they too need to be located in their own sub-directory. All font files end in a .CHR, .FNT, or .FF1 file extension, and should be located in the FONTS sub-directory (for example: C:\RIPTERM\FONTS). If you run RIPterm with fonts or icons in the RIPterm directory, you are prompted to have RIPterm move them to the proper directory. If you instruct RIPterm not to move the files, you will receive the message about files being in the wrong place every time you start-up RIPterm until the problem is taken care of. You have a number of options for moving just certain categories of files, to be prompted for each file before moving it, or to not have any files moved at all. NOTE: A host system can have its own ICONS directory containing any of the file type listed as valid for an ICONS directory. See Section 5.2 ■ The Dialing Directory for details on how to set this up. All font files must be in the FONTS directory. RIPterm does NOT scan the host system directories for font files, and ask to move them. ┌─────────────────────┐ │ Move All Files │ └─────────────────────┘ Clicking on MOVE ALL FILES does as it says -- it moves all files into the correct directory. If PROMPT FOR EACH FILE is checked, then you will be asked for each file if you want to have it moved. ┌─────────────────────┐ │ Skip All Files │ └─────────────────────┘ Clicking on SKIP ALL FILES does nothing to the files. But remember, you will be nagged every time you start-up RIPterm to move the files -- until you do something about it. ┌─────────────────────┐ │ Move Selected Files │ └─────────────────────┘ If a file category is grayed out, then no files of that type were found to be moved. You may select or de-select any of the active categories by clicking on the check mark in front of the category. Clicking on the MOVE SELECTED FILES button will move just the files in the categories selected. ┌─────────────────────┐ │ Help │ └─────────────────────┘ Clicking the HELP button will give you useless and meaningless information on the courtship rituals of the lemurs in Madagascar. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.1.5 ■ Convert RIPscrip v1.x Icons to v2.x Icons ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────────────────────────┐│ ││ Convert icon <path/filename> to 2.0 BMP format? ││ │├───────────────────────────────────────────────────────────────────┤│ ││ You have some obsolete RIPscrip 1.x icons installed. These files ││ ││ can be converted to the newer 2.0 format automatically. ││ ││ To convert this icon file, click "OK". ││ ││ If you don't want to convert this icon, click "Cancel". ││ ││ To convert all icon files at once, click "Auto". ││ ││ To Exit to DOS, click "Exit". ││ ││ If you do not wish to convert any files, click "Skip". ││ ││ For more assistance, choose "Help". ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Auto │ │ Skip │ │ Exit │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└───────────────────────────────────────────────────────────────────┘│ └─────────────────────────────────────────────────────────────────────┘ RIPterm v2.0 needs to convert older RIPscrip version 1.x icons to be able to use them. A list of the file types converted are listed below. File Description Icon Mask Hot ------------------------------ ---- ---- ---- RIPscrip v1.x Icon Files .ICN .MSK .HOT RIPscrip v2.x Icon Files .BMP .BMM .BMH The original icon file is deleted after the conversion to the new icon, and the file extension is changed as shown in the table above. The file date and time is preserved from the original file, so that icon update queries will work without a problem. File queries received by RIPterm version 2 with the older icon file extensions are converted on-the-fly by RIPterm to the new extensions. This was necessary for backwards compatibility on file queries. When the conversion process is complete, a count of the number of files converted is displayed. Click OK to continue. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.2 ■ Getting Online Help ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The help system of RIPterm is easy to use. Press Alt-Z from the session screen for the help system Table of Contents. To return to the Table of Contents at any time, click on the "Contents" button at the bottom of the help screen. Many of the dialog boxes in RIPterm have help buttons that take you directly to help on that particular subject. If you have navigated through various help screens, you can back-up to a previous screen by clicking on the "Back" button. Any words or phrases highlighted in light blue are "keywords" which you can select to jump to that help topic. The currently selected keyword is yellow on dark gray. You may use the UP, DOWN, LEFT, and RIGHT arrow keys to navigate through the help screen's keywords. Press <ENTER> selects the current keyword, and takes you to that help screen. RIPterm uses TAB and SHIFT tab to jump from button to button at the bottom of the help screen display. When you are on the button you want to select, press the SPACE bar. Pressing ENTER selects the currently highlighted keyword, not the button you are on. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.2.1 ■ Help on the Menus ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Selecting the "Help on Menus" option from the System menu allows you to view help information on a specific menu option. A window will appear instructing you to select a pull-down menu option for help. Simply click on the right mouse button and pull down the desired menu. Select an option, and a Help Screen will appear on that item. When finished, press the <ESC> key to exit "Help on Menus" mode. You may also select menu options via the keyboard by using the Alt key combinations to activate the menu system. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 2.3 ■ RIPterm Command Line Options ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There are a number of options that you may choose from when starting up RIPterm. These options are specified as "parameters" on the DOS command line. Each option is preceded with either a hyphen (-) or a forward slash (/). Each option is described below: -A ■ Disable digitized audio sounds -B ■ Show start-up checkpoint messages (debug mode) -I ■ Disable auto-icon conversion checking at start-up -M ■ Disable mouse operations -N ■ Disable logo screen -O ■ Do not initialize modem - indicate you're already online -T ■ <DEBUG> Disable 8259 Interrupt Priority rescheduling -Z ■ Disable zooming windows -D<entry#> ■ Dial <entry#> upon start up (from 1-100) -P<file> ■ Use an alternate phone directory file -Rfile ■ Execute the RIPscrip file <file> upon start-up -S<file> ■ Use an alternate setup file Command line options are not case sensitive. You may specify these options together (for single character options), or as separate parameters on the command line. For example, to suppress the intro screen, disable zooming windows and indicate that you are already online, you could execute the following DOS command: RIPTERM -noz Each of these options are described more fully in the following sub-sections: ▒▒▒ -A ■ Disable digitized audio sounds ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option causes RIPterm to act as if there were no audio board config- uration. This is useful if you are having problems with RIPterm and sound. ▒▒▒ -B ■ Show start-up checkpoint messages (debug mode) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This mode if EXTERMELY useful for when you are having problems with RIPterm locking up while it is starting-up. Show start-up checkpoint messages displays a LOT of message during the start-up of RIPterm so that you know EXACTLY what caused RIPterm to lock up. This option is for troubleshooting any video or configuration problems. ▒▒▒ -D<entry#> ■ Dial <entry#> upon start up (from 1-100) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option instructs RIPterm to dial a particular entry in the Dialing Directory immediately after it starts-up and initializes the Modem (if necessary). Whether or not the connection can be established or not is unimportant, RIPterm will remain running regardless. Use this option from within a batch file if you frequently start up RIPterm and need to dial a particular number. You may specify a dialing directory entry from 1-100. An example of using this option is as follows: RIPTERM -D15 The above example starts up RIPterm and places a call to Dialing Directory entry #15 just as if you had selected it manually. ▒▒▒ -I ■ Disable auto-icon conversion checking at start-up ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ RIPterm checks through all the icon files at start-up to see if there are any that need to be converted to RIPscrip v2.0's new icon format: BMP. Using -I disables the check for icons to convert. ▒▒▒ -M ■ Disable mouse operations ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This options makes RIPterm think there is no mouse attached (even of there is). This is for debugging mouse lock-up problems. ▒▒▒ -N ■ Disable logo screen ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ When you choose this option, the start up logo screen is disabled. You will be placed directly into RIPterm's session screen providing there are no configuration problems, or other questions that RIPterm must ask you in order to run properly. ▒▒▒ -O ■ Do not initialize modem - indicate you're already online ▒▒▒▒▒▒▒▒▒▒▒ When you choose this option, RIPterm will not initialize the modem for you. If you are in this state, RIPterm starts up and ask your for an System Dir to use for icons, etc. NOTE: RIPterm auto-senses if you are already online, and will not try to initialize your modem if it detects you're online. ▒▒▒ -P<file> ■ Use an alternate phone directory file ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option instructs RIPterm to load a dialing directory file other than RIPTERM.PHO upon start up. This option is useful if you frequently use a special dialing directory file for certain applications. This option can be used with the command line option to automatically dial a directory entry upon start up. In other words, you can combine the -P and -D parameters together on the same command as in the following example: RIPTERM -Pmyfile.pho -D3 The above example would load RIPterm, load the directory file called MYFILE.PHO, initialize the modem, then automatically dial entry number 3 in the MYFILE.PHO dialing directory file. ▒▒▒ -R<file> ■ Execute the RIPscrip file <file> upon start-up ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option allows you to execute a local .RIP file upon initial start up of RIPterm. This allows you to draw some graphics, or even set up a screen with modem configuration mouse buttons. This allows for a great deal of flexibility. This option also serves as a good mechanism to test RIPscrip graphics for the RIPaint/RIPdraw artist. The RIP file must be in your ICONS directory. ▒▒▒ -S<file> ■ Use an alternate setup file ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option allows you to specify an alternate RIPterm setup file upon start up. By default, RIPterm will load RIPTERM.CNF (or create one if necessary). Use this option if you frequently start up in a particular configuration (e.g., using a COM port other than the standard default port that is recorded in RIPTERM.CNF). This option may be combined with any other command line parameter for RIPterm as in the following example: RIPTERM -nz -Pmyfile.pho -Smysetup.cnf -D10 The above example suppresses the intro logo screen, instructs RIPterm not to use zooming windows, loads the dialing directory file MYFILE.PHO, loads configuration file MYSETUP.CNF and automatically dials directory entry #10 upon start up. This is as complex of a start-up example as you can get. ▒▒▒ -T ■ <DEBUG> Disable 8259 Interrupt Priority rescheduling ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ RIPterm re-arranges the priority of interrupts when it is running to achieve the best performance possible. The -T option disables the re-arrangement of interrupt priorities. ▒▒▒ -Z ■ Disable Zooming Windows ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option will disable the zooming windows feature of RIPterm for the duration of the current RIPterm session. This mode overrides the setup option for zooming windows. If you select Save Setup from the Modem menu, this override will become permanent (until changed and saved). Some people find the zooming windows feature annoying in that it slows down operation of opening and closing windows a little bit. For these power users, you may use this option, or simply disable the Zooming Windows option in your setup and save it. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.0 ■ Pull-Down Menus ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───┬──────┬─────────┬─────────┬───────┬───────┬────────────────────┐ │ ≡ │ File │ Connect │ Options │ Setup │ Debug │ │ └───┴──────┴─────────┴─────────┴───────┴───────┴────────────────────┘ To activate the pull-down menus, press and hold down the right mouse button. The menu bar appears at the top of the screen. Move the mouse pointer to any of these items and a list of menu options will appear below the menu bar. At this point, move the mouse down into this list of items and as you move over different items, they will be selected. To select any given item, release the right mouse button while the desired option is highlighted. You can also click the right mouse button just to bring up the menu bar, and then use either mouse button or the arrow keys to select the menu you want and the options in it. You may access the pull-down menus without the mouse by pressing Alt-1 (hold down the Alt key and press the 1 key). You can also access specific menus by pressing the Alt key + the first letter of the menu name (except the Debug menu, which is Alt-U). When a menu is selected, the menu bar will appear with the first item in that menu selected. Use the RIGHT and LEFT arrow keys to move from menu to menu, and use the UP and DOWN arrow keys to select from the options in that menu. The HOME and END keys work as you would expect them to, moving to the top and bottom of the menu. In the menus, one letter is highlighted in yellow. You can press this letter to jump to that menu option and select it -- all in one step. Pressing ESC with a menu displayed will remove the list of menu options, and return you to the menu bar only. Pressing ESC again will exit the menu bar and return you to your RIPterm session. You can also click the right mouse button anywhere NOT on the menu to exit the menu bar. See Section 2.0.2 ■ Using RIPterm Without a Mouse for additional info. Most menu options have hotkeys. Hotkeys are keyboard short cuts for menu options, so that you do not have to use the menus. Menu hotkeys are shown in the menu, to the right of the menu option it corresponds to. For example, in the System menu shown below, the menu hotkey for System Information is Ctrl-Alt-I (hold down the Control & Alt keys, and press I). Some menu options are "toggle" items. If an option is toggled ON, then you will see a check-mark beside the option indicating that it is active. Select these options to toggle the state ON or OFF. The remaining portion of this section describes each menu, and how each option functions. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.1 ■ The System Menu ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───┐ │ ≡ │ ├───┴─────────────────────────────────┐ │ About RIPterm │ ├─────────────────────────────────────┤ │ License Information │ │ System Information Ctrl-Alt-I │ ├─────────────────────────────────────┤ │ Help Table of Contents Alt-Z │ │ Help on Menus Ctrl-Alt-H │ └─────────────────────────────────────┘ The System Menu is shown in the menu bar as red, green, and blue wavy lines, as seen in the TeleGrafix Communications logo. This menu contains many general RIPterm functions: ┌─────────────────────────────────────┐ │ About RIPterm │ └─────────────────────────────────────┘ This option displays a dialog displaying the version, date, and copyright information for RIPterm, as well as the address and phone number of TeleGrafix Communications, Inc. ┌─────────────────────────────────────┐ │ License Information │ └─────────────────────────────────────┘ This option displays RIPterm's serial number and the name of the user to whom it is registered. ┌─────────────────────────────────────┐ │ System Information Ctrl-Alt-I │ └─────────────────────────────────────┘ This option will display the amount of available memory as well as the amount of disk space free on the hard disk RIPterm is installed on. ┌─────────────────────────────────────┐ │ Help Table of Contents Alt-Z │ └─────────────────────────────────────┘ This option will display the help system's Table of Contents. From here you can get help on all the different parts of RIPterm. ┌─────────────────────────────────────┐ │ Help on Menus Ctrl-Alt-H │ └─────────────────────────────────────┘ This option will allow you to view help information on the menus. A window will appear instructing you to select a menu option. Depress the right mouse button and pull down the desired menu. Select an option, and a help screen will appear for that item. When finished, press <ESC> to exit "Menu Help" mode. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.2 ■ The File Menu (Alt-F) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌──────┐ │ File │ ├──────┴─────────────────────────────────┐ │ Download (Receive) a File PgDn │ │ Upload (Send) a File PgUp │ ├────────────────────────────────────────┤ │ Show Local RIPscrip Query Ctrl-Alt-Q │ │ Show Local RIPscrip File Ctrl-Alt-R │ │ Show Local Image File Ctrl-Alt-B │ ├────────────────────────────────────────┤ │ Edit External Applications │ │ Run External Application Ctrl-Alt-X │ ├────────────────────────────────────────┤ │ Log Text to File Alt-L │ │ Log Text to Printer Alt-P │ ├────────────────────────────────────────┤ │ Printer Setup Ctrl-Alt-P │ │ Print Screen Shift-Ctrl-P │ ├────────────────────────────────────────┤ │ Jump to DOS Alt-J │ ├────────────────────────────────────────┤ │ Exit to DOS Alt-X │ └────────────────────────────────────────┘ ┌────────────────────────────────────────┐ │ Download (Receive) a File PgDn │ └────────────────────────────────────────┘ This command downloads (receives) a file from the host to your system. This is done by using what's called a "file transfer protocol". A protocol is like a language. There are a number of languages like French, English, and Italian. If two people are speaking in different languages, the result is that no communication occurs. The same goes for file transfer protocols. Both the host and the terminal (RIPterm) must use the same protocol if they are to communicate properly. To download a file, instruct the host which file you want to transfer. Select a protocol from the menu of available protocols. When the host says "Ready to download..." or "Ready to send...", choose the download option of RIPterm and SELECT THE SAME PROTOCOL that you chose on the host. Some protocols will prompt you to enter the filename to save to your local hard disk, others know the filename used on the host, and will use it automatically. The file transfer will now commence. When the transfer is complete, you will be returned to the session screen. The file will be in your Download Directory, or in your RIPterm directory if a Download Directory has not been specified. If an error occurred during the transfer, the file will be incomplete or missing entirely. See Section 4.9.1 ■ Protocol Transfer Settings for information on setting your Download Directory. The currently supported protocols are: ┌──────────────────────┐ │┌────────────────────┐│ ││ Download Protocols ││ │├────────────────────┤│ ││ ASCII Text ││ ││ CompuServe QuickB+ ││ ││ Kermit ││ ││ Xmodem ││ ││ Xmodem CRC ││ ││ Xmodem-1K ││ ││ Xmodem-1K (G) ││ ││ Ymodem (Batch) ││ ││ Ymodem (G) ││ ││ Zmodem ││ ││ Exit... ││ │└────────────────────┘│ └──────────────────────┘ ┌────────────────────────────────────────┐ │ Upload (Send) a File PgUp │ └────────────────────────────────────────┘ This command uploads (sends) a file to the host from your system. This is done by using what's called a "file transfer protocol". A protocol is like a language. There are a number of languages like French, English, and Italian. If two people are speaking in different languages, the result is that no communication occurs. The same goes for file transfer protocols. Both the host and the terminal (RIPterm) must use the same protocol if they are to communicate properly. To upload a file, instruct the host to upload (receive) a file, and give the host a filename and whatever other information it may request (file description, keywords, etc.). Select a protocol from the menu of available protocols. When the host says "Ready to upload..." or "Ready to receive...", choose the upload option of RIPterm and SELECT THE SAME PROTOCOL that you chose on the host. Enter the name of the file to send and the file transfer will begin. You can include a full path to the file is not in your Upload Directory (or in your RIPterm directory if an Upload Directory has not been specified). When the transfer is done, you will be returned to the session screen and if there were no errors in transmission, the file will exist on the host. See Section 4.9.1 ■ Protocol Transfer Settings for information on setting your Upload Directory. The currently supported protocols are: ┌──────────────────────┐ │┌────────────────────┐│ ││ Upload Protocols ││ │├────────────────────┤│ ││ ASCII Text ││ ││ CompuServe QuickB+ ││ ││ Kermit ││ ││ Xmodem ││ ││ Xmodem CRC ││ ││ Xmodem-1K ││ ││ Xmodem-1K (G) ││ ││ Ymodem (Batch) ││ ││ Ymodem (G) ││ ││ Zmodem ││ ││ Exit... ││ │└────────────────────┘│ └──────────────────────┘ ┌────────────────────────────────────────┐ │ Show Local RIPscrip Query Ctrl-Alt-Q │ └────────────────────────────────────────┘ A RIPscrip query is a way of requesting information from RIPterm be displayed, or to have RIPterm perform an action. There are a number of built-in text variables in RIPterm, as well as the ability to define more text variables to store text data. For example, to have RIPterm display the date and time, the query to enter would be: $DATE$ $TIME$ RIPterm would display in the text window: 01/16/95 02:13:30 For information on creating or displaying the built-in and user defined text variables, see Section 3.4 ■ Options Menu. For descriptions of the built-in text variables, refer to the RIPscrip Language Specification. ┌────────────────────────────────────────┐ │ Show Local RIPscrip File Ctrl-Alt-R │ └────────────────────────────────────────┘ RIPscrip files can be transmitted from the host, or they can be stored on your local hard disk for the host to call up when they need it. The advantage of storing the RIP file locally is that it only takes one very short command to display the file, rather than streaming the data to RIPterm every time it needs to be displayed. This option lets you view a RIPscrip file stored locally on your hard disk. Just type in the name of the RIP file, and RIPterm displays it for you. If you forget to type .RIP at the end, RIPterm will automatically add it on for you. If you just type in the name of a RIP file, RIPterm looks in the ICONS directory for the file. Full path/filenames can be entered for files residing elsewhere on your system. ┌────────────────────────────────────────┐ │ Show Local Image File Ctrl-Alt-B │ └────────────────────────────────────────┘ This option is for loading a JPG or BMP file from your local hard disk, and displaying it to the screen. The image takes up the entire screen, unless a RIP_IMAGE_STYLE sets up the boundary to fit the image into. Refer to the RIPscrip v2.0 Language Specification for details on the RIP_IMAGE_STYLE command. ┌────────────────────────────────────────┐ │ Edit External Applications │ └────────────────────────────────────────┘ This option allows you to edit up to ten (10) different configurable application programs. The External Applications feature allows you to "plug-in" programs into RIPterm to do various things. From this menu option, you can edit the configurations of all ten slots. You may custom tailor how the programs are run, what slot they are associated with, whether they should be run 'on' particular files that you download, and various other settings that may pertain to running external programs. Refer to Section 5.5 ■ External Applications for more information. ┌────────────────────────────────────────┐ │ Run External Application Ctrl-Alt-X │ └────────────────────────────────────────┘ This option allows you to select an external application to run. When chosen, the "command line" for the program is processed and if any text variables are present it will process them to construct a complete DOS command line. When all processing on the command line is complete, RIPterm will "shell-to-DOS" and run the specified program. Refer to Section 5.5 ■ External Applications for more information. ┌────────────────────────────────────────┐ │ Log Text to File Alt-L │ └────────────────────────────────────────┘ A log file captures text transmitted from the host into a text file. This command can be very powerful on hosts where you want to save data coming across the modem to a file that you can read offline, at your leisure. A log file can be as big as you want, subject to the amount of disk space available. To open a log file, select "Log Text to File" from the menu. You will be prompted for a filename. When a log file is open, the menu option "Open Log File" changes to "Pause/Close Log" and the Status Bar will show the log file name in the third spot from the left, where the terminal emulation is normally displayed. If a log file is currently open, selecting "Pause/Close Log" from the menu will give you the option to either pause the log, or to close the file. Pausing "suspends" logging to disk temporarily so that you can do things without saving them to the log file. If you are currently paused, selecting "Pause/Close Log" again will prompt you to either resume or close the log. ANSI color codes, RIPscrip commands, and Doorway Emulation commands are filtered out for your convenience, but you can capture them by enabling their respective options in File Transfer Setup under the Setup menu. See Section 4.9.3 ■ Capture Log Settings for details on these options. If a log file is open, and you choose Exit RIPterm, it will be closed automatically. ┌────────────────────────────────────────┐ │ Log Text to Printer Alt-P │ └────────────────────────────────────────┘ By toggling this option ON, your current online session will be echoed to your local printer. Any ANSI/ASCII text that is displayed on your screen will also be sent to your local printer on whatever Printer Port (LPT) you have configured RIPterm to use. If RIPterm has not been configured for a printer, then this option will not operate (it will refuse to print). When this mode is active, you will see a message on the Status Bar saying "--LPT1--" or whatever port you have configured for your printer. ┌────────────────────────────────────────┐ │ Printer Setup Ctrl-Alt-P │ └────────────────────────────────────────┘ ┌─────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────┐│ ││ Printer Setup ││ │├───────────────────────────────────────────────┤│ ││ ││ ││ ┌───────────┬─┐ ││ ││ Printer Port │LPT1 ││ ││ ││ └───────────┴─┘ ││ ││ ┌───────────┬─┐ ││ ││ Printer Type │HP LaserJet││ ││ ││ └───────────┴─┘ ││ ││ ││ ││ [X] Eject Page ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└───────────────────────────────────────────────┘│ └─────────────────────────────────────────────────┘ Printer Setup allows you to select the output port of your printer, and the type of printer that is attached. The Printer Ports selectable are LPT1, LPT2, LPT3, and None. The Printer Types selectable are Plain Text, Epson, HP LaserJet, Postscript, and No Printer. The Eject Page option tells RIPterm to send a page eject command to the printer after a full page of data has been sent to the printer. ┌────┐ │ OK │ └────┘ When chosen, OK activates the Printer Setup you have chosen. The changes are not saved to the RIPterm configuration file - you must click SAVE to do that. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel throws out any changes made in the Printer Setup dialog box. Whatever settings were active before entering this dialog box will be restored, and you are returned to the session screen. ┌──────┐ │ Save │ └──────┘ This option closes the dialog box and saves the current selections to the RIPterm configuration file. ┌──────┐ │ Help │ └──────┘ Clicking on Help displays a chart of the migration pattern of coconuts. ┌────────────────────────────────────────┐ │ Print Screen PrintScreen │ └────────────────────────────────────────┘ Print Screen dumps the entire contents of the screen to the printer. You must have selected either the Epson, HP LaserJet, or Postscript printer option. Print Screen does not work with Plain Text printer mode. ┌────────────────────────────────────────┐ │ Jump to DOS Alt-J │ └────────────────────────────────────────┘ The "Jump to DOS" feature allows you to shell out to an MS-DOS command line while remaining in RIPterm. You would use this if you wanted to obtain a DOS directory, or to run an editor, or use DOS in general. To return to RIPterm from the DOS command line, type "EXIT". RIPterm will display a special DOS prompt indicating that are currently running RIPterm, but executing a DOS shell. You may use any disk drive you want, or change directories. When you type "EXIT", RIPterm will return to your default RIPterm directory so that it can re-load files for you. When you return to your RIPterm session, the current session screen is restored as well as any mouse fields, or other parameters. See Section 5.5 ■ External Applications for more details about the DOS Shell feature. ┌────────────────────────────────────────┐ │ Exit to DOS Alt-X │ └────────────────────────────────────────┘ This exits RIPterm and returns you to DOS. If your modem configuration is set to "modem dialing", and you are currently online, a dialog box will appear asking if you wish to hang-up before exiting. If you choose NO at this prompt, you will remain online even after you have exited to DOS. Use this option with caution, since if you forget that you are online, you could charge up a huge phone bill. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.3 ■ The Connect Menu (Alt-C) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌─────────┐ │ Connect │ ├─────────┴─────────────────────┐ │ Dialing Directory Alt-D │ ├───────────────────────────────┤ │ Manual Connect Alt-M │ │ Disconnect (Hang Up) Alt-H │ ├───────────────────────────────┤ │ Initialize Modem Alt-I │ │ Modem Auto-Answer Alt-A │ ├───────────────────────────────┤ │ Send Break Ctrl-END │ └───────────────────────────────┘ The Connect Menu contains the options that handle all the connections the the outside world. From this menu you can make the modem dial-out to other systems, disconnect, and otherwise control your online sessions. ┌───────────────────────────────┐ │ Dialing Directory Alt-D │ └───────────────────────────────┘ This option displays the current dialing directory on your screen. From this dialog box, you may dial, edit or otherwise manipulate any of the dialing directory entries in any way you wish. To dial a system, click on it's name in the list, and click the Dial button at the bottom of the dialog box. To learn how to edit or add entries, or for info on any of the other options available, refer to Section 5.2 ■ The Dialing Directory. ┌───────────────────────────────┐ │ Manual Connect Alt-M │ └───────────────────────────────┘ ┌────────────────────────────────────────────────────────┐ │┌──────────────────────────────────────────────────────┐│ ││ Manual Connect ││ │├──────────────────────────────────────────────────────┤│ ││ ││ ││ ┌────────────────────────────────┐ ││ ││ Phone Number │ │ ││ ││ └────────────────────────────────┘ ││ ││ ┌────────────────────────────────┐ ││ ││ System Dir │ │ ││ ││ └────────────────────────────────┘ ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ │└──────────────────────────────────────────────────────┘│ └────────────────────────────────────────────────────────┘ This command is for accessing a system without the need to add it to your Dialing Directory. This is useful for a system that you are going to call just once, or a system you don't know if you will ever want to call again. You are prompted you to enter the Phone Number to dial, and the name of the System Directory to use for icons and any other files the host needs while you're connected (if any). You may enter any digits from 0-9 for the Phone Number. Hyphens, slashes, and parenthesis are ignored. If you need to obtain a delay in dialing the phone number, you can use a comma (,) for a 2 second pause (depending on your modem), or you can use a tilde (~) to tell RIPterm to insert a 1/2 second delay. For the icon directory, enter the name of the directory that contains the icons this system may need, or a directory that you use for temporary files. If you never call this system again, you won't want to keep its icons hanging around on your hard disk taking up space. ┌────┐ │ OK │ └────┘ After entering the phone number and clicking OK, the Dialing Window will appear showing you the progress of RIPterm as it dials the modem. See Section 5.2.5 ■ The Dialing Window for details on this operation. ┌────────┐ │ Cancel │ └────────┘ Click Cancel to abort connection to the remote system. ┌──────┐ │ Help │ └──────┘ Help is no help whatsoever. Just kidding. ┌───────────────────────────────┐ │ Disconnect (Hang Up) Alt-H │ └───────────────────────────────┘ This option will attempt to disconnect the modem, thus logging you off of whatever host you are connected to. If for some reason, RIPterm was unable to successfully disconnect the modem, the message "Hang-up Failed" will be displayed and your system will beep to indicate a problem has occurred. There are two methods RIPterm can use to disconnect the modem. The fastest and most reliable method is to use one of the connections between your computer and modem called DTR (Data Terminal Ready). RIPterm will toggle DTR to off, and the modem knows to hang up when this happens -- usually. Some modems have to be reconfigured to do this, some modems (old ones) can't do it, and sometimes the cable connecting your computer and modem doesn't have DTR connected (get a new cable). DTR Hangup can be turned on in Modem Setup in the Setup menu. If DTR Hangup is disabled, then RIPterm will use the Modem Hangup string in the Modem Setup dialog box. This is a slower, and not as reliable method of hanging up the modem. It sends a modem command mode break-in sequence (usually +++), followed by the rest of the hang-up string. See Section 4.6 ■ Modem Setup for more details on these settings. ┌───────────────────────────────┐ │ Initialize Modem Alt-I │ └───────────────────────────────┘ Choosing this option resets the modem by sending the Modem Initialization string to the modem. This will effectively reset the modem to the configured default settings. Note: THIS ONLY WORKS IF THE MODEM IS OFFLINE. If you are connected to a host system, you must first disconnect before initializing the modem. Otherwise, your Modem Init string gets transmitted to the remote system. The commands sent to the modem can be altered by changing the Modem Init string in Modem Setup, located in the Setup menu. See Section 4.6 ■ Modem Setup for more details on these settings. ┌───────────────────────────────┐ │ Modem Auto-Answer Alt-A │ └───────────────────────────────┘ This command transmits the Auto-Answer command string to the modem. This command instructs the modem to answer the phone after a certain number of rings (one ring by default). Note: THIS ONLY WORKS IF THE MODEM IS OFFLINE. If you are connected to a host system, you must first disconnect before setting the modem to Auto-Answer. Otherwise, your Auto-Answer string gets transmitted to the remote system. The command sent to the modem can be altered by selecting Modem Setup from the Setup menu. See Section 4.6 ■ Modem Setup for details. ┌───────────────────────────────┐ │ Send Break Ctrl-END │ └───────────────────────────────┘ A Break is a special signal that can be sent from your system to the host. Most hosts simply ignore them, but some use them for aborting operations, or for various purposes. RIPterm will send a break of 250 milliseconds by default. A millisecond is 1/1000 of a second, so 250 milliseconds is one quarter of a second. The Break Duration can be set in the General Setup. See Section 4.1 ■ General Setup to change the Break Duration. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.4 ■ The Options Menu (Alt-O) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌─────────┐ │ Options │ ├─────────┴──────────────────────────────┐ │ View Scrollback Buffer Alt-B │ │ Keystroke Macro Editor Alt-K │ │ Chat Mode Alt-Y │ ├────────────────────────────────────────┤ │ √ Status Bar Alt-SPACE │ │ √ Button Hotkeys ScrollLock │ │ √ Mouse Field Select Ctrl-Alt-O │ ├────────────────────────────────────────┤ │ √ ANSI Emulation Ctrl-Alt-A │ │ √ RIPscrip Emulation Ctrl-Alt-Z │ │ Doorway Emulation Alt-= │ │ VT-102 Emulation │ ├────────────────────────────────────────┤ │ Clear the Graphics Window Alt-G │ │ Clear the Text Window Alt-T │ │ Reset All Windows Alt-R │ ├────────────────────────────────────────┤ │ Create Variable │ │ Show Built-In Variables │ │ Show Database Variables │ ├────────────────────────────────────────┤ │ Redraw System Menu Ctrl-HOME │ └────────────────────────────────────────┘ ┌──────────────────────────────────────┐ │ View Scrollback Buffer Alt-B │ └──────────────────────────────────────┘ This option will activate the Scrollback Buffer system. This allows you to view previously displayed text information that has come across the modem. You may set the scrollback buffer size from 0k to 9999k of memory. If there is not enough memory available to hold the entire scrollback buffer, it will automatically use your hard disk to store the oldest info. Within scrollback, you may choose from the following options: OK - Exit Scrollback to session screen Search - looks for a particular word or phrase Again - looks for the next occurrence of the same word or phrase Write - option for saving the screen or the entire buffer Print - prints the content of the Scrollback Buffer Clear - erases the entire Scrollback Buffer Help - this information here At the bottom of the scrollback screen are buttons for the above commands. In addition, there is a scroll bar for scrolling up and down, paging up and down, or moving to the beginning or end of the buffer. NOTE: The scrollback buffer filters out ANSI color codes and RIPscrip commands for an uncluttered text display. ┌──────────────────────────────────────┐ │ Keystroke Macro Editor Alt-K │ └──────────────────────────────────────┘ Macros are designed to save you typing. You can define a macro to type your entire company name followed by ENTER, for example. By pressing just one key, you can make RIPterm type out whatever the macro contains just as if you had typed it yourself. This allows you to perform short-cut operations on the host. RIPterm's macro system is easy to use, and very powerful. You can save your macro keys to the default macro file (RIPTERM.KEY), or if you need to have multiple macro configurations, you can save macros to different files. There are also macro files for VT-102 emulation, and you can have RIPterm load a macro file for a particular host (System Macros). Refer to Section 5.3 ■ Keystroke Macro Editor for more information. ┌──────────────────────────────────────┐ │ Chat Mode Alt-Y │ └──────────────────────────────────────┘ Chat Mode is designed for when two terminal users connect with each other directly. There are several configuration problems that come up in this situation, and Chat Mode solves these problems. Typing by each user goes into separate windows, and the Modem Setup for Local Echo and Add CR/LF are temporarily enabled so that you can converse conveniently and easily with the remote user. Refer to Section 5.6 ■ Chat Mode for more information. ┌──────────────────────────────────────┐ │ Status Bar Alt-SPACE │ └──────────────────────────────────────┘ The Status Bar will be displayed at the bottom of your RIPterm screen by default. When this option is not checked, the Status Bar will not be displayed and your default (full-screen) text window will be one line taller. The Status Bar is used to display the current status of various aspects of the RIPterm operation. You may toggle the Status Bar ON and OFF quickly by pressing ALT-SPACE. The host might turn the Status Bar ON or OFF for you, using RIPscrip commands. If it mysteriously vanishes for some reason, keep in mind that the host you are connected to probably did it because it needs the extra line for text or graphics! The Status Bar has a number of different "fields", displaying information about RIPterm current configuration and status. The fields are: ┌──────────────┬──────────────┬──────────┬─────────────────┬ │ Alt-Z = Help │ Alt-! = Menu │ ANSI/RIP │ 38400 ■ N81 FDX │ └──────────────┴──────────────┴──────────┴─────────────────┴ (1) (2) (3) (4) (5) (6) ┬──────┬──────────────────┬─────────┐ │ COM1 │ RIPterm v2.00.00 │ Offline │ ┴──────┴──────────────────┴─────────┘ (7) (8) (9) (1) How to get the Help System Table of Contents (2) How to use the keyboard only to bring up the menu bar (3) What terminal emulation is in use, or the name of the log file if one has been opened, or the LPT port that it being printed to. (4) The BPS (bits per second) rate. Sometimes called the baud rate. (5) The parity setting, data bits, and stop bits. (6) Full-duplex (FDX) or half-duplex (HDX) settings (7) The COM port that is currently in use (8) The current version number of RIPterm (9) Whether you are "offline", or how long you have been on-line Refer to Section 5.1 ■ The Status Bar for more information. ┌──────────────────────────────────────┐ │ Button Hotkeys ScrollLock │ └──────────────────────────────────────┘ Button Hotkeys are a substitute for clicking on a button with the mouse. If a button has a hotkey, then by typing the hotkey letter for that button (usually indicated by a different color letter, or an underlined letter, or maybe both), the button behaves EXACTLY the same as if it had been clicked with the mouse. In other words, if there is a button on the session screen like this: ┌────────────────┐ │ │ │ (E)nter name │ │ │ └────────────────┘ ...where the hotkey for the button is "E", simply pressing the "E" key on your keyboard would activate this button. This may not be desirable if you're trying to type a message containing the letter "E". However, there are times when you need to be able to type without having buttons clicked for you. Button Hotkeys are linked to the ScrollLock key on your keyboard. If ScrollLock is lit, then hotkeys are processed. If ScrollLock is not lit, then the character will be sent to the host directly, bypassing any button hotkeys. Button Hotkeys can also be enabled/disabled by selecting Button Hotkeys from the Options menu. NOTE: This is only for buttons on the session screen. Buttons in dialog boxes always have their hotkeys enabled, and can be select by pressing the ALT key + the letter highlighted in yellow. ┌──────────────────────────────────────┐ │ Mouse Field Select Ctrl-Alt-O │ └──────────────────────────────────────┘ RIPterm also supports the use of the TAB and SHIFT-TAB keys to jump from mouse field to mouse field. When you are on the Mouse Field you wish to select, press ENTER to select it. Press ESC to get out of Mouse Field Select mode. The use of TAB and SHIFT-TAB can be disabled by de-selecting Mouse Field Select from the Options menu, or by pressing Ctrl-Alt-O. Also, many of the clickable buttons on a RIPscrip screen use hot keys, meaning the by pressing just one key on the keyboard, it behaves EXACTLY the same as if you had clicked on that button with a mouse. A hotkey will have one character underlined, or in a different color, or both! Press that character to activate that button. See Section 3.4 ■ Options Menu for more information on the Button Hotkeys and Mouse Field Select options. If Mouse Field Select is disabled, the TAB character (Control-I) is transmitted to the host. ┌──────────────────────────────────────┐ │ ANSI Emulation Ctrl-Alt-A │ └──────────────────────────────────────┘ The ANSI text commands can be used to change the foreground and background color of the text displayed, place the cursor at certain coordinates, and clear the screen (among other things). To make RIPterm ignore any ANSI commands, you can de-select ANSI Emulation. Any ANSI commands received will appear in the text window. ┌──────────────────────────────────────┐ │ RIPscrip Emulation Ctrl-Alt-Z │ └──────────────────────────────────────┘ RIPscrip Emulation processes all RIPscrip commands received. Deselecting this option causes RIPterm to ignore any RIPscrip commands it receives, and display them in the text window. ┌──────────────────────────────────────┐ │ Doorway Emulation Alt-= │ └──────────────────────────────────────┘ This mode is used on a number of hosts that take advantage of "Doors". When in Doorway Emulation, any keystroke that you enter on your keyboard is transmitted to the host regardless of the fact that the keystroke might be a menu shortcut, or something that RIPterm would normally process locally. This allows you to use special keystrokes (like INSERT, DELETE, PGUP, Function Keys, etc.) on a host program that can take advantage of it. The most popular program that takes advantage of this mode is DOORWAY (tm) by Marshall Dudley of TriMark Engineering, Inc. RIPterm's support for Doorway operation is a complete implementation of the Doorway interface. It fully supports the Printer Re-direction feature as well as Special Character Overriding for non-printable ASCII characters (control characters). RIPterm is one of the first terminals to be released to the general "market" with complete Doorway support. PROGRAMMER'S NOTE ----------------- For the technically minded who want to know how this works, this is what's going on: ■ The keystroke is recorded using BIOS interrupt 0x16, sub-function 0x00 for non-101-key keyboards, or sub-function 0x10 for 101-key keyboards. ■ If register AL contains a value (the ASCII character), and AH is equal to 0, then it is sent to the host by transmitting the character directly over the comm port (e.g., 'A', 'z', '3', etc). ■ If AH is not 0, then transmit the contents of AH instead to the host by transmitting a null (0), then the contents of AH. If AL == E0, and AH != 0, then it is an enhanced 101-key scancode and should be sent to the host as a null (0), followed by an 0xE0, then followed by the raw scan code (AH). ┌──────────────────────────────────────┐ │ VT-102 Emulation │ └──────────────────────────────────────┘ VT-102 emulation is for use with a host application that requires that the keyboard be configured as a VT-102 terminal. See Section 5.3 ■ Keystroke Macro Editor for specifics on VT-102 keyboard configuration, or look at the file VT102.MAC in the RIPterm directory. It's a text file easily viewable using a text viewer. In addition, many ANSI escape sequences function slightly differently than in normal ANSI mode. TeleGrafix worked closely with Digital Equipment Corp. (DEC) to develop and test RIPterm's VT-102 emulation. It adheres to the true VT-102 specification. ┌──────────────────────────────────────┐ │ Clear the Graphics Window Alt-G │ └──────────────────────────────────────┘ RIPterm uses two types of windows in RIPscrip graphics mode, a graphics window and a text window. The text window is where all plain text transmitted from the host is displayed. The graphics window is where all graphical RIPscrip commands are displayed. Choose this option to clear the graphics window only. If the graphics window overlaps the text window, then some of the text may be erased in the process. The window is cleared to the current background color, which by default is BLACK. The background color can be set using RIPscrip commands only -- there is no option in RIPterm to select a background color. NOTE: The graphics window, by default, is full screen. This may be changed by using RIPscrip commands. ┌──────────────────────────────────────┐ │ Clear the Text Window Alt-T │ └──────────────────────────────────────┘ RIPterm uses two types of windows in RIPscrip graphics mode, a graphics window and a text window. The graphics window is where all graphical RIPscrip commands are displayed. The text window is where text received from the host is displayed. RIPscrip allows for up to 36 text windows. When clearing the text window, it will clear whichever is the currently active text window. Choose this option to clear the text window only. If the text window overlaps the graphics window, then some of the graphics may be erased in the process. The window is cleared to BLACK and the cursor moved to the upper left corner of the window. NOTE: The text window, by default, is full screen. This may be changed by using RIPscrip commands. ┌──────────────────────────────────────┐ │ Reset All Windows Alt-R │ └──────────────────────────────────────┘ This command will reset the text and graphics windows to full screen. In addition, the screen is cleared and the text cursor moved to the upper left hand corner of the screen. This is equivalent to a clear screen command in other software packages. The color palette is reset to the default color set, the font is reset to the system default you have selected and any mouse fields/buttons are deleted from the screen. ┌──────────────────────────────────────┐ │ Create Variable │ └──────────────────────────────────────┘ This option enters information into the RIPterm database. Each piece of information is associated with a "label" (also called the variable name). Information entered can be from 1-60 characters in length. The label can be from 3-12 characters in length, with these restrictions: no spaces are allowed, the first character must be a letter or an underscore, the rest of the label may consist of letters, number, and underscores. An example of this might be: Variable Information Stored in variable -------------- ------------------------------ FIRST_NAME John LAST_NAME Doe ADDRESS 123 Anywhere Street PHONE_NUMBER 555-1212 You may choose to save a variable either to internal memory, or to the permanent database. This database is "indexed" for high speed access of information. If the index becomes corrupted due to a power failure or some other problem, it is automatically re-indexed for you. ┌──────────────────────────────────────┐ │ Show Built-In Variables │ └──────────────────────────────────────┘ This displays the contents of all text variables that are built into RIPterm. Some variables are built-in in the sense that RIPterm doesn't need you to provide it with information. Among the various built-in variables are things like $DATE$, $TIME$, and other such variables that change frequently. Some variables do not contain valid text data due to their nature. These might include variables like $SBARON$, or $SBAROFF$ which display or hide the Status Bar. When listing these variables, the contents are listed as blank. NOTE: The variables are appended to the scrollback buffer. You can view them by selecting text scrollback from the Options menu, or by pressing ALT-B. ┌──────────────────────────────────────┐ │ Show Database Variables │ └──────────────────────────────────────┘ This option displays all text variables that have been stored in the local RIPTERM.DB database file. All variables are listed to the current text window, but are not sent to the host. This allows you to see what is currently in your database. NOTE: The variables are appended to the scrollback buffer. You can view them by selecting View Scrollback from the Options menu, or by pressing ALT-B. ┌──────────────────────────────────────┐ │ Redraw System Menu Ctrl-HOME │ └──────────────────────────────────────┘ Redraw System Menu is a new feature of RIPscrip that allows the host to define what key sequence is needed to redraw the screen. If no sequence is defined, this option is ghosted (not selectable). Many systems just need a Carriage Return (ENTER, or Control-M) to redraw the current screen, but hosts vary. This allows them to define the correct re-draw sequence, but all you have to know is how to press Ctrl-HOME. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.5 ■ The Setup Menu (Alt-S) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────┐ │ Setup │ ├───────┴────────────────────────────┐ │ General Setup Ctrl-Alt-G │ │ Video/Mouse Setup Ctrl-Alt-V │ │ Audio Setup Ctrl-Alt-U │ │ System Font Setup Ctrl-Alt-F │ ├────────────────────────────────────┤ │ Modem Setup Ctrl-Alt-M │ │ Modem Dialing Prefixes Ctrl-Alt-D │ │ Modem Hardware Setup Ctrl-Alt-W │ ├────────────────────────────────────┤ │ File Transfer Setup Ctrl-Alt-T │ ├────────────────────────────────────┤ │ Save Setup Ctrl-Alt-S │ └────────────────────────────────────┘ The Setup Menu provides you with a centralized place to alter RIPterm's overall configuration. You may modify the modem's configuration, various general settings and also the way in which telephone numbers are dialed. The following sections describe the various options in detail. ┌────────────────────────────────────┐ │ General Setup Ctrl-Alt-G │ └────────────────────────────────────┘ The General Setup dialog box controls various miscellaneous settings for the RIPterm environment. The various settings in this dialog box are: Data Security ..... This mode prevents the host from querying info from your terminal database without you being given the opportunity to approve the information transfer first. Alarm Sounds ...... Errors, download completions, and connecting make various sounds. For quiet mode, turn this off. Enable Beeps ...... Any CTRL-G (bel) character that is received will "beep" your local console. 101-key keyboard .. If enabled, this option will provide 101-key support for Keystroke Macros and Doorway Mode. Zooming Windows ... If checked, all dialog boxes will "zoom in/out" by showing what looks like an exploding rectangle before displaying the dialog box. Force DTR on Exit . This option allows you to control whether the modem signal DTR is left ON or OFF when exiting RIPterm. Some modems act differently depending on the setting of DTR. Refer to your modem guide for more details on its DTR support. Scrollback Size ... Sets the size of the Scrollback Buffer. You can set the size from 0K (disabled) to 9,999K. Set Break Duration. This option sets the length of the special break signal that can be sent. The default is 250ms. See Section 4.1 ■ General Setup for in-depth explanations of each option. ┌────────────────────────────────────┐ │ Video/Mouse Setup Ctrl-Alt-V │ └────────────────────────────────────┘ RIPterm version 2.0 supports 117 different video cards and video modes. If yours is not listed, chances are that your video card supports one or more of the VESA video modes, which were created as a standard way of addressing video hardware from software. Check your video card documentation to see what modes it supports. VESA mode on some video cards may be slower than the native mode -- so if a native mode is available, use it! On some video cards, a memory resident driver (TSR) needs to be loaded for VESA support to work for that video card. The fastest resolution to run at is 640 x 480, because less memory is being addressed. Scrolling especially is affected by the resolution. Most video cards also run faster in 256 color mode than in 16 color mode, usually because of their hardware design. See Appendix A.4.3 ■ Solutions to Video Display Performance Issues for more information. If you have a mouse connected to your computer, you must load the mouse driver before running RIPterm to be able to use the mouse. The mouse driver is usually a file called MOUSE.SYS that is loaded in your CONFIG.SYS, or a file called MOUSE.COM that is loaded in your AUTOEXEC.BAT file. If you're not loading a mouse driver, you can't use the mouse. NOTE: RIPterm doesn't use the center button on three-button mouses for any functions. Refer to Section 4.2 ■ Video / Mouse Setup for a list of video cards supported, and a diagram of the Video/Mouse Setup screen. ┌────────────────────────────────────┐ │ Audio Setup Ctrl-Alt-U │ └────────────────────────────────────┘ A new feature in RIPterm is the support for digitized sound, in the form of .WAV files. The Audio Board Configuration is for configuring RIPterm for your audio hardware. The easiest way to do this is by using Auto-Sense. See Section 4.3 ■ Audio Setup for details on custom configuration. There are some performance issues in doing sound and communications at the same time. RIPterm version 2.x implements cutting edge technology, and sometimes may push your system to try to do more than it can. If you are having problems playing sounds or with losing characters, see Appendix A ■ Section A.4 ■ Performance Issues for more information. ┌────────────────────────────────────┐ │ System Font Setup Ctrl-Alt-F │ └────────────────────────────────────┘ The System Font allows you to select the font that is used in the ASCII text/ANSI mode. It does not have any effect on the graphics shown. Any subsequent text/ANSI displayed on the screen will appear in the chosen system font unless the host explicitly tells RIPterm to use another font for the text window. This mode allows you to specify how "large" text is when you are in full-screen text mode. You have five separate System Fonts to choose from. They are: 80x25 - default - normal DOS screen size 80x43 - 43 lines by 80 columns 40x25 - low-resolution font 91x43 - get more columns of text at once 91x25 - get more columns of text at once See Section 4.4 ■ System Font Setup for a diagram of the dialog box. ┌────────────────────────────────────┐ │ Modem Setup Ctrl-Alt-M │ └────────────────────────────────────┘ The dialog box is organized into three separate areas: Modem Command Strings Modem Port Settings Modem General Settings Modem Command Strings is the upper half of the dialog containing Modem Init, Auto Answer, Modem Reset, Modem Hangup, Redial Time, Max Attempts, and Redial Pause. Modem Port Settings is the lower-left part of the dialog containing COM Port, Baud Rate, Data Bits, Parity, and Stop Bits. Modem General Settings is the lower-right part of the dialog containing Connected To, Flow Control, Port Lock, DTR Hangup, Local Echo, Add CR/LF, Destruct BS, and BS Sends DEL. These settings are part of the setup, so once you alter them, you should click on Save Setup to make them permanent. See Section 4.6 ■ Modem Setup for details on each of these settings. ┌────────────────────────────────────┐ │ Modem Dialing Prefixes Ctrl-Alt-D │ └────────────────────────────────────┘ This option allows you to alter your dialing Prefix and Suffix settings. These settings are used for every system you try to dial to begin the dialing operation (prefix), and to finish the dialing process (suffix). You have three prefix you can configure, and three suffixes, and any one of those three entries can be set to be the "Default" prefix/suffix. Refer to Section 4.7 ■ Modem Dialing Prefixes for more details. ┌────────────────────────────────────┐ │ Modem Hardware Setup Ctrl-Alt-W │ └────────────────────────────────────┘ Interrupt Setup allows you to customize the interrupt (IRQ) settings for each of your four COM ports. Normally this isn't necessary. However, some PC's have special configurations that require the terminal's setup to be altered if the serial ports are to function properly. There are fourteen different interrupts that can be selected for each COM port -- IRQ2 to IRQ15. If two serial ports in the computer use the same interrupt (i.e., an interrupt conflict), then problems arise. See Section 4.8 ■ Modem Hardware Setup for more details on settings each of these options. ┌────────────────────────────────────┐ │ File Transfer Setup Ctrl-Alt-T │ └────────────────────────────────────┘ There are four areas to the File Transfer Setup dialog box. They are Protocol Transfer Settings, ASCII Upload Settings, and Capture Log Settings. The Protocol Transfer Settings are in the upper half of the dialog box, covering Zmodem Crash Recovery, CompuServe QuickB+ Transfers, Auto Zmodem Download, Download Dir, and Upload Dir settings. The ASCII Upload Settings are in the lower left of the dialog box, and cover the Line Pacing, Character Pacing, and Line Expansion settings. The Capture Log Settings are in the lower right of the dialog box, and cover the Capture ANSI, Capture RIPscrip, and Capture Doorway settings. See Section 4.9 ■ File Transfer Setup for details on settings each of these options. ┌────────────────────────────────────┐ │ Save Setup Ctrl-Alt-S │ └────────────────────────────────────┘ This option will save a number of configuration parameters for RIPterm. For a complete list of everything included in the RIPterm Setup File, refer to Section 4.0.1 ■ RIPterm Setup - What Is Saved?. When you run RIPterm, the setup file is loaded and used for the current session. Setup information is contained in a file called RIPTERM.CNF by default. This can be altered by using the -S parameter when starting up RIPterm. This option instructs RIPterm to use an alternate setup file (e.g., RIPTERM -Smysetup.cnf). See Section 2.3 ■ RIPterm Command Line Options for a complete list of command line option and more information. NOTE: If the Status Bar, Button Hotkeys, or Mouse Field Select is turned off by the host, and you select Save Setup, the active settings for these items are saved to your setup file. It is recommended that you save your setup only when you are offline to avoid this. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 3.6 ■ The Debug Menu (Alt-U) ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────┐ │ Debug │ ├───────┴──────────────────────┐ │ Debug Info: General │ │ Debug Info: Comm Port │ ├──────────────────────────────┤ │ Debug Info: Text Window │ │ Debug Info: Drawing Port │ │ Debug Info: Graphics Style │ │ Debug Info: Button Style │ │ Debug Info: Color Palette │ │ Debug Info: Mouse Field │ │ Debug Info: Environment │ │ Debug Info: Graphics Screen │ │ Debug Info: Templates │ ├──────────────────────────────┤ │ Full Debug Info │ └──────────────────────────────┘ The Debug menus are for TeleGrafix to assist you in determining problems with RIPterm. They are not documented here, as if TeleGrafix Tech Support need you to look up certain information, they will provide you with instructions. When any of the options is selected, the data generated is placed in your Scrollback Buffer for viewing. You are automatically placed in the View Scrollback Buffer mode to review the information. The Full Debug Info option performs every single option in the menus, and save it to the file RIPTERM.DBG in your RIPTERM directory. Do not confuse this with your RIPTERM.DB file, which is your text variable database file. You may be requested to upload this file to TeleGrafix for technical support reasons. ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ 4.0 ■ RIPterm Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ In the following sections are the features of RIPterm which control the setup and configuration of RIPterm. Since this is a communications program, you may notice that there are a large number of configuration options to choose from. This section is designed to answer the most frequently asked questions about what a particular option does so that you can make the right choices for your configuration. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.0.1 ■ RIPterm Setup - What Is Saved? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ■ General Setup ■ Modem Setup ■ Serial Port IRQ Interrupt settings (for all four ports) ■ Serial Port I/O Address settings (for all four ports) ■ Modem Prefix/Suffix Setup ■ File Transfer Setup ■ System Font setting ■ Printer Setup ■ Graphics mode ID value ■ Audio Configuration ■ Dialing Directory "toggle" mode ■ Status Bar On/Off ■ Terminal Emulation settings from Options Menu ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.1 ■ General Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm has a number of configurable settings for you to choose from to alter the way in which the software runs on a normal basis. The General Setup dialog box looks like this: ┌─────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────┐│ ││ General Setup ││ │├───────────────────────────────────────────────┤│ ││ ││ ││ [X] Data Security Scrollback Size (K) ││ ││ ┌────┬─┐ ││ ││ [X] Alarm Sounds │16 ││ ││ ││ └────┴─┘ ││ ││ [X] Enable Beeps ││ ││ Break Duration ││ ││ [X] 101-Key Keyboard (in 1/1000 seconds) ││ ││ ┌────┬─┐ ││ ││ [X] Zooming Windows │250 ││ ││ ││ └────┴─┘ ││ ││ [X] Force DTR on Exit ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└───────────────────────────────────────────────┘│ └─────────────────────────────────────────────────┘ ┌───────────────┐ │ Data Security │ └───────────────┘ This option gives you control over host data queries to your system. This option defaults to ON, giving you the ability to scrutinize any queries by the host to ask your system database for information. This does not apply to built-in text variables, just variables that contain data that you've entered. How does this apply to you? RIPscrip has the ability to ask you for information, and depending on the query from the host, this information might be stored to your local RIPterm database for future use (by the same host, or potentially another), or be stored in memory until you disconnect from the host. This option exists so that if a host asks your terminal for a piece of information, you have the ability to intervene (i.e., prevent the information from being sent). This override feature is for security purposes in the event that your database contains sensitive information that you do not want to be given out without your explicit consent. See Section 5.7.2 ■ Data Security for more detailed information. ┌──────────────┐ │ Alarm Sounds │ └──────────────┘ When this option is chosen, RIPterm will make various musical sounds when things happen like successful downloads, establishing a connection to a host, when you make a mistake, etc. If you also set Enable Beeps to OFF and set the Audio Board Sound Volume to 0% (see Section 4.3), RIPterm will make NO sounds at all. ┌──────────────┐ │ Enable Beeps │ └──────────────┘ This will enable the Beep character (ASCII character 7, BEL) to make an beeping sound on your PC speaker when received from the host. Only BEEP characters from the host are enabled or disabled with this option. Alarm Sounds (see above) and digitized sounds (see Section 4.3) are not affected by this setting. ┌──────────────────┐ │ 101-Key Keyboard │ └──────────────────┘ This mode is used by Keystroke Macros and Doorway Emulation. This mode is only available on computers with a 101-key enhanced keyboard. If this option locks up your system, disable it. It allows you to use more keys on your enhanced keyboard for macros, and to send extended keyboard codes to the Doorway system running on the host. This value is part of the RIPterm setup, saved in RIPTERM.CNF. If you set this option ON, and it locks your system, and your system locks whenever you start-up RIPterm, then the option has been saved to your setup. You should run RIPterm with the -E option, like this: RIPTERM -E The first thing you should do is disable the 101-key keyboard option and save your setup. The -E option disables 101-key keyboard support for the duration of the current RIPterm session. ┌─────────────────┐ │ Zooming Windows │ └─────────────────┘ Whenever a window or dialog box pops up on the screen in RIPterm, it will "zoom in" and "zoom out" giving a visual feeling of the window opening or closing. This slows down the display of the window or dialog somewhat. So for optimal performance of RIPterm (or if you find it annoying), toggle zoom windows off. However, some like the visual impression of windows opening or closing, and think it is cool. ┌───────────────────┐ │ Force DTR on Exit │ └───────────────────┘ This option gives RIPterm your permission to go throwing its weight around, forcing DTR's on innocent young Exits. Sorry, I'll start again. The DTR (Data Terminal Ready) signal from the computer to the modem tells the modem if it can connect to a host (DTR ON or DTR HIGH), or not (DTR OFF or DTR LOW). This is the same as DTR Hangup, detailed in Section 4.6.3 ■ Modem General Setup. Force DTR on Exit defaults to ON. When selected, RIPterm keeps the DTR signal ON after exiting RIPterm. This is mainly useful for cases where the modem still needs to be able to answer a call on its own, even if there is no terminal program running. For example, when you are using a network modem pool, or a fax modem that needs to answer the phone to receive a fax. For another example, the author uses this with auto-answer enabled on his modem so that if someone calls on his modem line, all they get is an annoying screech, even when RIPterm isn't running. Useful if the phone number used to belong to someone else, and you are sick of telling people "wrong number". Now my secret is out... When not selected, when you exit RIPterm, DTR is lowered and kept low. Some modems, even if you instruct them to pick up the phone on the first ring, will not answer the phone if DTR is low. This is because the modem assumes that if DTR is low, there is no software running to receive the call -- so why should it answer the phone? Not all modems work this way, but most do. This also comes into play on direct serial connections. Most direct connects assume that someone is connected whenever DTR is high. If you leave DTR high when you exit, it might think there is a connection, even if there isn't. So you would disable Force DTR on Exit. NOTE: If you exit RIPterm while still online, and say NOT to hangup, then RIPterm will keep DTR enabled regardless of the setting of Force DTR on Exit, so that the modem doesn't disconnect you. ┌─────────────────────┐ │ Scrollback Size (K) │ └─────────────────────┘ This option sets how much memory RIPterm uses for the Scrollback Buffer. The valid settings are from 0K (disabled) to 9,999K of memory. If you computer does not have enough RAM to hold all this data, it will put the overflow on disk. When the Scrollback Buffer fills up, it starts purging the oldest data from the top. We recommend that you set it to 64k unless you know that you need to keep more history than that. See Section 5.4 ■ View Scrollback Buffer for all the options available. ┌────────────────────┐ │ Set Break Duration │ └────────────────────┘ A Break is a special signal that can be sent from your system to the host. Most hosts simply ignore them, but some use them for aborting operations, or for various purposes. RIPterm will send a break of 250 milliseconds by default. A millisecond is 1/1000 of a second, so 250 milliseconds is one quarter of a second. ┌────┐ │ OK │ └────┘ When chosen, OK will takes all the General Setup and makes them active. The changes are not saved to the RIPterm configuration file - you must click SAVE to do that. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ CANCEL throws out any changes made in the General Setup dialog box. Whatever settings were active before entering this dialog box will be restored, and you are returned to the session screen. ┌──────┐ │ Save │ └──────┘ This option closes the dialog box and saves the current selections to the RIPterm configuration file. ┌──────┐ │ Help │ └──────┘ Clicking Help sends out a sub-space distress signal. See the Setup menu to select which human or alien subspace channel the signal is sent out on. Please note that you must have your sub-space array patched into your computer via an AST-5250 interface adapter. TeleGrafix does not provide technical support for the 5250 card, however, we do have some knowledge of sub-space transmitters. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.2 ■ Video / Mouse Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Video and Mouse Setup ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││Before RIPterm can operate, we need to know some info about your computer││ ││and the mode you want RIPterm to run under. Use the TAB and SHIFT-TAB ││ ││keys to move around this dialog box. Up and Down arrows allow you to ││ ││change settings (as will Page Up and Page Down). When you are all done, ││ ││tap <ENTER> or choose "Ok". If you wish to exit to DOS, tap the <ESC> ││ ││key or choose "Cancel". For assistance, RIPterm has an extensive help ││ ││system (just choose "Help"). If you don't know which video mode to pick,││ ││"Standard IBM EGA" will work. If you have a VGA, use "Standard IBM VGA".││ ││ ││ ││ Video mode Resolution Colors ││ ││┌─────────────────────────────────────────────────────────────────────┬─┐││ │││ Standard IBM EGA 640x350 16 ││││ │││ Standard IBM VGA 640x350 16 ├─┤││ │││ Standard IBM VGA 640x480 16 │█│││ │││ VESA Super VGA 800x600 16 │ │││ │││ VESA Super VGA 1024x768 16 │ │││ │││ VESA Super VGA 640x480 256 │ │││ │││ VESA Super VGA 800x600 256 ├─┤││ │││ VESA Super VGA 1024x768 256 ││││ ││└─────────────────────────────────────────────────────────────────────┴─┘││ ││ ││ ││ ││ ││ (■) Microsoft compatible Mouse Driver ││ ││ ( ) No Mouse Installed ││ ││ ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm version 2.0 supports 117 different video cards and video modes. If yours is not listed, chances are that your video card supports one or more of the VESA video modes, which were created as a standard way of addressing video hardware from software. Check your video card documentation to see what modes it supports. VESA mode on some video cards may be slower than the native mode -- so if a native mode is available, use it! On some video cards, a memory resident driver (TSR) needs to be loaded for VESA support to work for that video card. The fastest resolution to run at is 640 x 480, because less memory is being addressed. Scrolling especially is affected by the resolution. Most video cards also run faster in 256 color mode than in 16 color mode, usually because of their hardware design. See Appendix A.4.3 ■ Solutions to Video Display Performance Issues for more information. The video cards supported are: Standard IBM EGA 640 x 350 x 16 Colors Standard IBM VGA 640 x 350 x 16 Colors Standard IBM VGA 640 x 480 x 16 Colors VESA Super VGA 800 x 600 x 16 Colors VESA Super VGA 1024 x 768 x 16 Colors VESA Super VGA 640 x 480 x 256 Colors VESA Super VGA 800 x 600 x 256 Colors VESA Super VGA 1024 x 768 x 256 Colors 8514A (interlaced) 1024 x 768 x 256 Colors 8514A (non-interlaced) 1024 x 768 x 256 Colors ATI, VGA Wonder 800 x 600 x 16 Colors ATI, VGA Wonder+ 1024 x 768 x 16 Colors ATI, VGA Wonder 640 x 480 x 256 Colors ATI, VGA Wonder XL 800 x 600 x 256 Colors ATI, VGA Wonder XL 1024 x 768 x 256 Colors ATI, Graphics Ultra Pro 640 x 480 x 256 Colors ATI, Graphics Ultra Pro 800 x 600 x 256 Colors ATI, Graphics Ultra Pro 1024 x 768 x 256 Colors CHIPS 82C45x 1024 x 768 x 16 Colors CHIPS 82C45x 640 x 480 x 256 Colors Compaq Advanced VGA 800 x 600 x 16 Colors Compaq Advanced VGA 640 x 480 x 256 Colors Diamond Speedstar 800 x 600 x 16 Colors Diamond Speedstar 1024 x 768 x 16 Colors Diamond Speedstar 640 x 350 x 256 Colors Diamond Speedstar 640 x 480 x 256 Colors Diamond Speedstar 800 x 600 x 256 Colors Diamond Speedstar 1024 x 768 x 256 Colors Diamond Stealth (S3) 640 x 480 x 256 Colors Diamond Stealth (S3) 800 x 600 x 256 Colors Diamond Stealth (S3) 1024 x 768 x 256 Colors Everex, EVGA EV-673 800 x 600 x 16 Colors Genoa, SuperEGA 4880 640 x 480 x 16 Colors Genoa, SuperEGA 4880 800 x 600 x 16 Colors Genoa, SuperVGA 5/6000 800 x 600 x 16 Colors Genoa, SuperVGA 5000 1024 x 768 x 16 Colors Genoa, SuperVGA 5000 640 x 350 x 256 Colors Genoa, SuperVGA 5000 640 x 480 x 256 Colors Genoa, SuperVGA 6000 1024 x 768 x 16 Colors Genoa, SuperVGA 6000 640 x 480 x 256 Colors HP Ultra VGA 640 x 480 x 256 Colors HP Ultra VGA 800 x 600 x 256 Colors HP Ultra VGA 1024 x 768 x 256 Colors NSI, Smart EGA/Plus 800 x 600 x 16 Colors OAK VGA 800 x 600 x 16 Colors OAK VGA 1024 x 768 x 16 Colors OAK VGA 640 x 480 x 256 Colors Orchid, Designer VGA 800 x 600 x 16 Colors Orchid, Designer VGA 1024 x 768 x 16 Colors Orchid, Designer VGA 640 x 350 x 256 Colors Orchid, Designer VGA 640 x 480 x 256 Colors Orchid, ProDesigner II 800 x 600 x 16 Colors Orchid, ProDesigner II 1024 x 768 x 16 Colors Orchid, ProDesigner II 640 x 350 x 256 Colors Orchid, ProDesigner II 640 x 480 x 256 Colors Orchid, ProDesigner II 800 x 600 x 256 Colors Orchid, ProDesigner II 1024 x 768 x 256 Colors Orchid Fahrenheit 1280 640 x 480 x 256 Colors Orchid Fahrenheit 1280 800 x 600 x 256 Colors Orchid Fahrenheit 1280 1024 x 768 x 256 Colors Paradise Autoswitch EGA/480 640 x 480 x 16 Colors Paradise, VGA 800 x 600 x 16 Colors Paradise, VGA 1024 1024 x 768 x 16 Colors Paradise, VGA 1024 640 x 480 x 256 Colors Quadram, VGA Spectra 800 x 600 x 16 Colors Quadram, VGA Spectra 1024 x 768 x 16 Colors Quadram, VGA Spectra 640 x 350 x 256 Colors Quadram, VGA Spectra 640 x 480 x 256 Colors Radius Multiview 640 x 480 x 256 Colors Radius Multiview 800 x 600 x 16 Colors Radius Multiview 800 x 600 x 256 Colors Radius Multiview 1024 x 768 x 16 Colors Radius Multiview 1024 x 768 x 256 Colors S3 Incorporated 640 x 480 x 256 Colors S3 Incorporated 800 x 600 x 256 Colors S3 Incorporated 1024 x 768 x 256 Colors STB, VGA Extra/EM 800 x 600 x 16 Colors STB, VGA Extra/EM 1024 x 768 x 16 Colors STB, VGA Extra/EM 640 x 350 x 256 Colors STB, VGA Extra/EM 640 x 480 x 256 Colors STB VGA EM-16 Plus 800 x 600 x 16 Colors STB VGA EM-16 Plus 1024 x 768 x 16 Colors STB VGA EM-16 Plus 640 x 350 x 256 Colors STB VGA EM-16 Plus 640 x 480 x 256 Colors STB VGA EM-16 Plus 800 x 600 x 256 Colors STB VGA EM-16 Plus 1024 x 768 x 256 Colors Tecmar, VGA/AD 800 x 600 x 16 Colors Tecmar, VGA/AD 1024 x 768 x 16 Colors Tecmar, VGA/AD 640 x 350 x 256 Colors Tecmar, VGA/AD 640 x 480 x 256 Colors Trident Impact 800 x 600 x 16 Colors Trident Impact 1024 x 768 x 16 Colors Trident Impact 640 x 480 x 256 Colors Trident Impact 800 x 600 x 256 Colors Trident Impact 1024 x 768 x 256 Colors Tseng Labs, EVA-480 640 x 480 x 16 Colors Tseng 4000 800 x 600 x 16 Colors Tseng 4000 1024 x 768 x 16 Colors Tseng 4000 640 x 350 x 256 Colors Tseng 4000 640 x 480 x 256 Colors Tseng 4000 800 x 600 x 256 Colors Tseng 4000 1024 x 768 x 256 Colors V7, VEGA VGA 800 x 600 x 16 Colors V7, FastWrite VGA 800 x 600 x 16 Colors V7, FastWrite VGA 640 x 480 x 256 Colors V7, FastWrite VGA 1024 x 768 x 16 Colors V7, VRAM VGA 800 x 600 x 16 Colors V7, VRAM VGA 640 x 480 x 256 Colors V7, VRAM VGA 1024 x 768 x 16 Colors V7, VGA 1024i 800 x 600 x 16 Colors V7, VGA 1024i 640 x 480 x 256 Colors V7, VGA 1024i 1024 x 768 x 16 Colors V7, VRAM II 640 x 480 x 256 Colors V7, VRAM II 800 x 600 x 16 Colors V7, VRAM II 800 x 600 x 256 Colors V7, VRAM II 1024 x 768 x 16 Colors V7, VRAM II 1024 x 768 x 256 Colors If you have a mouse connected to your computer, you must load the mouse driver before running RIPterm to be able to use the mouse. The mouse driver is usually a file called MOUSE.SYS that is loaded in your CONFIG.SYS, or a file called MOUSE.COM that is loaded in your AUTOEXEC.BAT file. If you're not loading a mouse driver, you can't use the mouse. NOTE: RIPterm doesn't use the center button on three-button mouses for any functions. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.3 ■ Audio Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ A new feature in RIPterm is the support for digitized sound, in the form of .WAV files. The Audio Board Configuration is for configuring RIPterm for your audio hardware. ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Audio Board Configuration ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││For sound to work properly with your audio board, you must configure it. ││ ││Select the board that is installed in your computer and its hardware ││ ││settings. If you are unsure, select the Auto-Sense option to detect what││ ││kind of board you have. Consult Help for more detailed information about││ ││audio configuration for RIPterm. ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││ ┌────────────────────────────────────────────┬─┐ ││ ││ Audio Boards │ Creative Labs - Sound Blaster ││ ││ ││ └────────────────────────────────────────────┴─┘ ││ ││ ┌──────────┬─┐ ││ ││ (■) Mono Interrupt (IRQ) │IRQ 7 ││ ││ ││ ( ) Stereo ┌────┬─┐ ├──────────┼─┤ ││ ││ │100 ││ Volume(%) DMA Channel │DMA 0 ││ ││ ││ (■) 8 Bit └────┴─┘ ├──────────┼─┤ ││ ││ ( ) 16 Bit I/O Port Address │Port 220h ││ ││ ││ └──────────┴─┘ ││ ││ ┌───────────┐ ┌─────────────────────────┐ ││ ││ ┌┤ Buffering ├───┬────┤ Custom Buffering/Timing ├────────────────────┐ ││ ││ │└───────────┘ │ └─────────────────────────┘ │ ││ ││ │ ( ) Light │ ┌────┬─┐ ┌────┬─┐ │ ││ ││ │ (■) Medium │ │4 ││ Buffers │8 ││ DMA Size (in K) │ ││ ││ │ ( ) Heavy │ ├────┼─┤ ├────┼─┤ │ ││ ││ │ ( ) Custom │ │4 ││ Buffer Size │40 ││ Timer Counts/Sec │ ││ ││ │ │ └────┴─┘ └────┴─┘ │ ││ ││ └────────────────┴───────────────────────────────────────────────────┘ ││ ││ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ││ ││ │ OK │ │ Cancel │ │Auto-Sense│ │ Help │ ││ ││ └──────────┘ └──────────┘ └──────────┘ └──────────┘ ││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ ┌──────────┐ │Auto-Sense│ └──────────┘ The easiest way to configure your sound settings is to use Auto-Sense. This is an accurate way to quickly establish the correct sound board and its hardware settings. Under some circumstances auto-sensing may not work properly (e.g., network boards installed, unusual hardware, or TSR's, etc). It is possible that Auto-Sense might lock-up your computer. If it does, no damage will be done to your system; just re-run the software and configure the audio board manually. While the auto-sensing is going on, try not to move the mouse around (even though you won't be able to see it). The reason for this is it can interfere with sensing and can make the auto-senser obtain incorrect hardware settings. RIPterm supports these sound boards: Creative Labs - Sound Blaster Creative Labs - Sound Blaster Pro Creative Labs - Sound Blaster 16-bit Creative Labs - Sound Blaster Pro 16 Creative Labs - Sound Blaster ASP16 Creative Labs - Sound Blaster AWE32 Covox - Sound Master II MediaVision - Pro Audio Spectrum MediaVision - Pro Audio Spectrum Plus MediaVision - Pro Audio Spectrum 16 MediaVision - Thunderboard Adlib MultiMedia - Adlib Gold Cardinal Technologies - Cardinal Sound Studio Microsoft - Microsoft Sound System ESS Technologies - ESS 488/688 Audiodrive Ensoniq - Soundscape Roland - Roland RAP-10 Advanced Gravis - Gravis UltraSound Advanced Gravis - Gravis UltraMax The MONO and STEREO settings are for configuring your card to play sounds in Mono or Stereo. TeleGrafix recommends that you only use the Mono setting, as selecting Stereo, even for Mono sounds, causes twice as much data to be moved to the sound card, and can cause performance problems. Most sounds used with RIPterm are likely to be mono (for smaller size), so you won't be losing anything by selecting mono over stereo. The 8 Bit and 16 Bit settings configure the resolution of the sounds sent to the sound board. Like Mono and Stereo, selecting 16 Bit sends twice as much data to the sound card as 8 Bit does, even when the original sound was 8 bit. The combination of 16 Bit and Stereo is especially lethal in terms of how much data is moved around -- four times as much as 8 Bit and Mono. See Appendix A.4 ■ Performance Issues for more information and troubleshooting options. The Volume control sets the output level via the sound card. If you don't have volume control on your speakers, you can use this to select the output level. If you have volume control on your speakers, you will probably want to set the Volume to 100% and use your speaker's volume control. The Interrupt (IRQ), DMA Channel, and I/O Port Address settings tell RIPterm how to speak directly to the sound board hardware. Refer to your sound board's documentation for information on these settings. The Buffering option controls RIPterm's access to the sound file on disk. By storing the sound in memory before passing it to the sound card, RIPterm is able to prevent interruptions in the sound playback. If you are experiencing interruptions in the sound, or if you are dropping characters when the sound is enabled, you can increase the buffering to try to resolve these problems. See Appendix A.4 ■ Performance Issues for more information and troubleshooting options. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.4 ■ System Font Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────┐│ ││ System Text Font Setup ││ │├───────────────────────────────────────────────┤│ ││ ││ ││ ┌───────────────────┐ ┌─────────────────────┐ ││ ││ │ │ │ │ ││ ││ │ ( ) 80x43 font │ │ Select the font you │ ││ ││ │ │ │ want normally. It │ ││ ││ │ ( ) 91x43 font │ │ will be used when │ ││ ││ │ │ │ no BBS graphics are │ ││ ││ │ (■) 80x25 font │ │ on the screen, or │ ││ ││ │ │ │ whenever the screen │ ││ ││ │ ( ) 91x25 font │ │ is cleared. 80x25 │ ││ ││ │ │ │ is the most popular │ ││ ││ │ ( ) 40x25 font │ │ font. │ ││ ││ │ │ │ │ ││ ││ └───────────────────┘ └─────────────────────┘ ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ ││ ││ │└───────────────────────────────────────────────┘│ └─────────────────────────────────────────────────┘ The System Font allows you to select the font that is used in the ASCII text/ANSI mode. It does not have any effect on the graphics shown. Any subsequent text/ANSI displayed on the screen will appear in the chosen system font unless the host explicitly tells RIPterm to use another font for the text window. This mode allows you to specify how "large" text is when you are in full-screen text mode. You have five separate System Fonts to choose from. They are: 80x25 - default - normal DOS screen size 80x43 - 43 lines by 80 columns 40x25 - low-resolution font 91x43 - get more columns of text at once 91x25 - get more columns of text at once ┌────┐ │ OK │ └────┘ When chosen, OK makes the selected System Font the active text window font. The change is not saved to the RIPterm configuration file - you must click SAVE to do that. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel throws out any change made in the Text Font Setup dialog box. Whatever settings were active before entering this dialog box will be restored, and you are returned to the session screen. ┌──────┐ │ Save │ └──────┘ This option closes the dialog box and saves the current selection to the RIPterm configuration file. ┌──────┐ │ Help │ └──────┘ Selecting Help throws you into an alternate space/time continuum. Use a tachyon emission from your main deflector dish to return to your reality. Or click Cancel in the Help Screen dialog... ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.5 ■ Translation Tables ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Translation tables are used for international character set support. TeleGrafix is developing the capabilities for foreign character set support. We want to know about any special characters or needs you may have. You can contact TeleGrafix at the address listed in Appendix C. Currently, RIPterm does not support Translation Tables. We are currently soliciting input from our users. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.6 ■ Modem Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The Modem Setup tells RIPterm the where and how of accessing your modem. The standard settings for most hosts are 8 data bits, NO parity and 1 stop bit (8N1). These settings can be saved to RIPterm's configuration file, so once you alter them, you should click the SAVE button to make them permanent. To alter the serial port IRQ and base address settings, choose Modem Hardware Setup from the Setup menu. This dialog box appears to edit the modem's configuration: ┌──────────────────────────────────────────────────────────────────────────┐ │┌────────────────────────────────────────────────────────────────────────┐│ ││ Modem Setup ││ │├────────────────────────────────────────────────────────────────────────┤│ ││ ││ ││ ┌───────────────────────────────────────────────────────┐ ││ ││ Modem Init │AT &C1 &D2 E1 V1 X4^M │ ││ ││ ├───────────────────────────────────────────────────────┤ ││ ││ Auto Answer │AT S0=1^M │ ││ ││ ├───────────────────────────────────────────────────────┤ ││ ││ Modem Reset │AT Z^M │ ││ ││ ├───────────────────────────────────────────────────────┤ ││ ││ Modem Hangup │~~~+++~~~AT H0^M │ ││ ││ ├────┬─┬────────────────┬────┬─┬─────────────────┬────┬─┤ ││ ││ Redial Time │45 ││ Max Attempts │99 ││ Redial Pause │5 ││ ││ ││ └────┴─┘ └────┴─┘ └────┴─┘ ││ ││ ││ ││ ┌──────────┬─┐ ││ ││ ┌─ Connected To: ───────┐ [X] Port Lock COM Port │COM1 ││ ││ ││ │(■) Modem │ ├──────────┼─┤ ││ ││ │( ) Another Computer │ [X] DTR Hangup Baud Rate │19,200 ││ ││ ││ └───────────────────────┘ ├──────────┼─┤ ││ ││ [ ] Local Echo Data Bits │8 Bits ││ ││ ││ ┌─ Flow Control ────────┐ ├──────────┼─┤ ││ ││ │(■) RTS/CTS (Hardware)│ [ ] Add CR/LF Parity │No Parity ││ ││ ││ │( ) XON/XOFF (Software)│ ├──────────┼─┤ ││ ││ │( ) No Flow Control │ [X] Destruct BS Stop Bits │1 Stop Bit││ ││ ││ └───────────────────────┘ └──────────┴─┘ ││ ││ [ ] BS Sends DEL ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└────────────────────────────────────────────────────────────────────────┘│ └──────────────────────────────────────────────────────────────────────────┘ The dialog box is organized into three separate areas: Modem Command Strings Modem Port Settings Modem General Settings Modem Command Strings is the upper half of the dialog containing Modem Init, Auto Answer, Modem Reset, Modem Hangup, Redial Time, Max Attempts, and Redial Pause. Modem Port Settings is the lower-left part of the dialog containing COM Port, Baud Rate, Data Bits, Parity, and Stop Bits. Modem General Settings is the lower-right part of the dialog containing Connected To, Flow Control, Port Lock, DTR Hangup, Local Echo, Add CR/LF, Destruct BS, and BS Sends DEL. ┌────────┐ │ OK │ └────────┘ OK takes all of the selected modem options and make them the active settings. It will re-initialize the serial port if necessary and make any of the changes active. The changes are not saved to the permanent RIPterm setup file - you must do that by clicking the Save button, or by selecting Save Setup from the Setup menu. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel discards any changes made in the Modem Options dialog box. Whatever settings were active before entering this dialog box will be restored. You will be sent immediately to the session screen. ┌────────┐ │ Save │ └────────┘ This option will close the dialog box and save the selected settings to the permanent RIPterm setup file. See Section 4.0.1 ■ RIPterm Setup - What Is Saved? for details on everything saved to the RIPterm setup file. ┌────────┐ │ Help │ └────────┘ Click Help to learn the secret handshake of the bean curd farmers in Kitchitikipi, Michigan (means The Big Spring in Chippewa Indian). ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.6.1 ■ Modem Command Strings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Modem command strings are how you configure RIPterm to work with the wide variety of modems available. All modem commands begin with an "AT", short for 'ATtention'. The "AT" must be at the beginning of the line to work. You may specify control characters in a modem command string by preceding the character with a caret (^). For example, a CTRL-C would be ^C and carriage return (CTRL-M) would be ^M. The letter after the caret is not case sensitive, so ^M works exactly the same as ^m. Modem commands are not case sensitive either. Traditionally, upper case characters are used, because in the beginning days of modems, some computers (and most modems) did not support lower case characters. Each modem command string should end with a ^M (carriage return), as shown in the Modem Options dialog box above. If you wish to pause in a command, insert a comma (,) at the point where you want to pause. The pause length is controlled by the modem's S8 register. Most modems pause for two or three seconds for each comma. RIPterm also lets you use the tilde (~) to insert a 1/2 second pause in your modem command strings. For more information on modem commands, consult your modem's manual. ┌────────────┐ │ Modem Init │ └────────────┘ The Modem Initialization string is the modem command sent to the modem when RIPterm starts up, or when Initialize Modem is selected from the Connect menu. The default Modem Init string contains several modem commands: AT &C1 &D2 E1 V1 X4^M The AT is the beginning of every modem command. The &C1 tells the modem to turn the Carrier Detect (CD) signal on when you're connected, off when you're not. The &D2 tells the modem to use RTS/CTS (Hardware) Flow Control. This is the most reliable means of controlling data flow. See RTS/CTS below. The E1 tells the modem to echo commands back to RIPterm. The V1 tells the modem to display verbal results, rather than numbers. The X4 options sets the modem's ability to recognize different line conditions, such as NO DIAL TONE, BUSY, VOICE, and the CONNECT speed. X4 tells the modem to recognize as many different conditions as it can. ┌─────────────┐ │ Auto Answer │ └─────────────┘ This modem command is what would be sent to the modem to set it for "auto-answer" mode. Auto-Answer means that the modem will answer the phone automatically when it rings. The default auto-answer string which should work on nearly any modem is "AT S0=1^m" where the "1" indicates that the modem should pick up the phone on the 1st ring. ┌─────────────┐ │ Modem Reset │ └─────────────┘ This is the modem command string that is sent when the modem needs to be reset. This may be necessary if you "hang-up" the modem, abort a dial attempt, or exit RIPterm. For most modems, this command is Z, which would be entered as "ATZ^m". ┌──────────────┐ │ Modem Hangup │ └──────────────┘ This is the command string for the modem to use if DTR Hangup is disabled or fails. The modem needs to be put back into its command mode, where it accepts modem commands from RIPterm. For most modems this is done by typing in three consecutive plus signs (+++), with a short pause added before and after the pluses. Then the command for hanging up the modem must be sent. For most modems, this command is H0. The entire command would be entered as "~~~+++~~~ATH0^m". ┌─────────────┐ │ Redial Time │ └─────────────┘ Redial Time specifies how many seconds RIPterm should wait before assuming that the dialed system isn't answering. This value defaults to 45 seconds. You may need to extend this to a higher value if you're calling through an elaborate telephone system, or dialing internationally. Shortening the duration may be desirable if you are dialing a number where the Host connects quickly and you don't need the extended redial times. The Redial Time setting affects ALL connections, so you should set it to the longest time you need to connect to ANY of the systems you call. ┌──────────────┐ │ Max Attempts │ └──────────────┘ Max Attempts controls how many times connecting to a host is attempted before RIPterm gives up trying. If you have multiple phone numbers in your Dialing Directory entry, each number attempted counts as one attempt. ┌──────────────┐ │ Redial Pause │ └──────────────┘ The Redial Pause is the number of seconds RIPterm pauses between the dialing attempts. If you are not able to connect to a system (busy, no answer, whatever), RIPterm pauses before trying the next number selected. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.6.2 ■ Modem Port Settings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Modem Port Settings is the lower-left part of the dialog containing COM Port, Baud Rate, Data Bits, Parity, and Stop Bits. In this sub-section, you'll see settings for data bits, parity, and stop bits. In nearly all situations, there are only two combinations of these three values that are commonly used. They are: Combo #1 Combo #2 ----------- ----------- 8 Data Bits 7 Data Bits No Parity Even Parity 1 Stop Bit 1 Stop Bit Combo #1 Abbreviation Combo #2 Abbreviation ---------------------- ---------------------- 8-N-1 7-E-1 Combo #1 Pronunciation Combo #2 Pronunciation ---------------------- ---------------------- Eight-None-One Seven-Even-One Combo #1 (8-N-1) is typically used with BBS's. Combo #2 (7-E-1) is common on CompuServe, TymNet, TeleNet, or any of the other X.25 packet-switched networks. Many Unix systems use Combo #2 as well. ┌──────────┐ │ COM Port │ └──────────┘ This option allows you to specify which communications port will be used to dial the modem. Valid ports are COM1 through COM4. Of course, your system must have the given port in order to be able to dial out on it. RIPterm will normally initialize the modem upon initial start-up providing the "Use Modem" option is selected. ┌───────────┐ │ Baud Rate │ └───────────┘ This option allows you to specify the default baud rate in which RIPterm should operate. Valid baud rates are 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, and 115200 baud. If you use a baud rate of 9600 or faster, it is highly recommended that RTS/CTS Flow Control and Port Lock be used for the best reliability. ┌───────────┐ │ Data Bits │ └───────────┘ This option allows you to alter the number of data bits that will be used for a given communications link. Valid settings are 7 Data Bits, or 8 Data Bits. You will find that most hosts use 8 Data Bits. 7 Data Bits are commonly used when calling mainframe computers, or large hosts like TymNet, TeleNet, GEnie, CompuServe, or other nationwide network services that use the X.25 network protocol. When in doubt, try 8 Data Bits. If you get garbled information, try 7 Data Bits. ┌────────┐ │ Parity │ └────────┘ This option allows you to alter the parity setting that will be used for a given communications link. Valid settings are Even, Odd or No Parity. The vast majority of hosts in the world use a setting of No Parity. Situations where you will choose something other than No Parity would be if you were calling a mainframe computer, or dialing up via a nationwide network like TymNet, TeleNet, GEnie, CompuServe, or other such X.25-based hosts. If in doubt, try No Parity. ┌───────────┐ │ Stop Bits │ └───────────┘ This option allows you to alter the number of Stop Bits that are used for the communications link. Valid settings are 1 Stop Bit, or 2 Stop Bits. Typically, 1 Stop Bit will be used for the vast majority of hosts. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.6.3 ■ Modem General Settings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Modem General Settings is the lower-right part of the dialog containing Connected To, Flow Control, Port Lock, DTR Hangup, Local Echo, Add CR/LF, Destruct BS, and BS Sends DEL. ┌──────────────┐ │ Connected To │ └──────────────┘ There are two selections available: Modem or Another Computer. If Modem is selected, RIPterm knows that it is connected to a modem. This is the normal, default situation. RIPterm send the "Modem Init" command string to the modem when it starts up. If you are using RIPterm to connect directly to another computer via a serial link (for example, by using a null modem cable), then you would want to select Another Computer. ┌──────────────┐ │ Flow Control │ └──────────────┘ This option determines whether any flow control should be used between your computer and your modem. With RIPterm, flow control is very important at high baud rates. It is critically important with high speed file transfers with protocols like Zmodem or Ymodem. Without flow control, the host might be sending data faster than the terminal can take it in and process it. When viewing RIPscrip graphics at high baud rates (9600 baud and higher), this form of flow control is EXTREMELY IMPORTANT! Without it you could easily have garbled graphics. The reason for this is when you're working in a graphical environment, you are doing a lot of stuff "behind the scenes" to show even so much as a single line on the screen. Since graphics mode can be so CPU intensive, sometimes it is necessary to tell the host to "hold on" while the terminal "catches up" with the host. That is what flow control is for, and why RIPterm needs this mode active. RTS/CTS (Ready To Send/Clear To Send) is a form of hardware flow control. The serial connection between the computer and modem has two signals used for flow control -- RTS and CTS. The modem uses RTS to tell the computer when it is Ready To Send, and the computer uses CTS to tell the modem when it is Clear To Send. What this means is that the modem and computer know how to tell each other "I'm ready for more data now, continue...". Some modems have to be configured to enable hardware flow control. Most modems use the &R2 command to enable RTS/CTS flow control. In order to take advantage of this mode of operation you need to make sure you have a "hardware handshaking" serial cable. 99% of all serial cables you can purchase are these types of cables. If RTS/CTS flow control is not usable on your particular PC, RIPterm will issue the error message: "CTS is inactive; RTS/CTS handshaking disabled" What this means is that RIPterm sensed that RTS/CTS was not available and it will automatically shut off that mode for you so that RIPterm will function properly. NOTE: This error message can also occur if you start up RIPterm with your modem turned off! XON/XOFF flow control uses Control-Q (XON) and Control-S (XOFF) to stop data flow into the computer. This is also known as Software Flow Control. It is less reliable than RTS/CTS, but is better than no flow control. Some modems have to be configured to enable software flow control. Most modems use the &I1 command to enable software flow control. ┌───────────┐ │ Port Lock │ └───────────┘ Port Lock is used with high speed modems. Port Lock keeps the speed between the computer and the modem at the same rate. This is sometimes referred to as Fixed DTE Rate in some modem's documentation. Your modem may connect at 2400, but your computer still talks to the modem at 19,200. If Port Lock is not selected, RIPterm is in Auto-Baud Detect mode, where it automatically sets RIPterm's speed to match the modem's connect speed. Before explaining why you need Port Lock, let's discuss how a regular modem works with baud rates. Normally, a modem must be set for the exact same baud rate as the connection. For example, if the modem says: CONNECT 2400 ...then RIPterm must be set for 2400 baud if it is to talk to the remote host. RIPterm will automatically see this CONNECT 2400 message and automatically switch baud rates for you (Auto-Baud Detect mode). Now with High Speed modems the situation is a bit different. Most high speed modems achieve higher baud rates by compressing data, transmitting it, and letting the modem on the other end of the connection de-compress the data. Now, imagine a connection like this: ┌──────┐ ─╫─ ─╫─ ┌──────┐ │ │ /─╫─\_____/─╫─\ │ │ │ Your │ / ║ \_____/ ║ \ │Remote│ │ │ 9600 / ║ ║ \ 9600 │ │ ┌─┴──────┴─┐ baud ┌─────┐ ║ ║ ┌─────┐ baud ┌─┴──────┴─┐ │ Computer │════│Modem│ ║ ║ │Modem│════│ Computer │ └──────────┘ └─────┘ Telephone └─────┘ └──────────┘ Connection 9600 Baud Notice that the links between each computer and their respective modems are set for 9600 baud. Also, the telephone connection itself is also at 9600 baud. Now, lets say the remote computer sends a 10K packet of data to its modem. The modem compresses that data into a smaller packet, say 5K for this discussion. The data was compressed to half its size, so it takes half as long to transmit. The modem on the other end of the connection decompresses the packet back to its original 10K size, and it sends it out to the computer. Now if another 5K compressed packet is coming over the phone line immediately after the first one, the modem has to decompress that packet and send it to the computer as well. If the link between the computer and the modem is THE SAME SPEED as the telephone link (modem-to-modem) then the act of decompressing data packets creates more data than the computer can accept at the given baud rate. The best case situation is that the data sent will just back up, and your trans- missions aren't as efficient as they could be. The worst case situation (and it happens!) is that you will LOSE data because of serial port speeds. The solution is to set RIPterm's baud rate to a value higher than the highest connection speed (see table below), and enable Port Lock. For example, if you have a 14,400 baud modem, you might be inclined to set your baud rate in RIPterm to 19,200 baud (the next highest setting). In practice though, modems can compress data better than that. The next highest setting is 38,400 baud -- which is a very good choice. This insures that even if the modem decompressed a packet that was compressed down to 25% of its original size, the computer could receive the data at full speed from the modem. However, typical compression levels are about 50% in real world usage, so you should set RIPterm's speed to about twice as fast (or faster) than your modem can communicate at. Now, back to Port Lock. Port Lock is used for high speed modems to tell RIPterm NOT to perform Auto-Baud Detection when connecting to other systems. What this means is that the baud rate set in RIPterm will not change even if the two modems sync-up at a lower baud rate. This way, the speed between the computer and the modem are at a fixed rate always and the baud rate between the two modems can vary. When Port Lock is enabled, RIPterm will let the modems worry about getting their speeds "just right". Even if your high speed modem connects at 300 baud, RIPterm could still talk to the modem at 57,600 baud. The modem would handle all of the details about "flow control" between the computer/modem to make sure that data doesn't get stuffed into the modem faster than the telephone connection can handle. Some of the newest modems have the ability to communicate at very high speeds -- up to 28,800 -- and there is talk of even faster modems to come. Many computer's serial port controller circuitry (a 16450 UART) can only handle speeds up to 19,200 reliably. This can be fixed by adding a 16550 UART chip. Most can directly replace a 16450 UART. Some computers either have the serial controller chip integrated with other controller chips into one multipurpose chip, or it is soldered onto the main circuit board. In these cases, you can buy a replacement serial board for your computer for less than $40 with two 16550 UARTs. Then you will have the most reliable serial hardware available. See Appendix A.4 for more on 16550 chips and performance issues, and how to tell if you have a 16550. This is a table of recommended settings for RIPterm, based on the maximum speed of your modem. It is also noted if you should be using a 16550 serial controller chip. Modem Speed Recommended RIPterm Baud Rate 16550 necessary? ----------- ---------------------------------- ---------------- 300 300 (time to upgrade!) no 2400 2400 (modems with no compression) no 2400 9600 (modems with compression) no 9600 19200 (v.32 with v.42) if possible 14400 38400 (v.32bis with v.42) recommended 21800 54600 (v.32bis/terbo with v.42) required 28800 115200 (v.FAST or v.FC or v.34) imperative ┌────────────┐ │ DTR Hangup │ └────────────┘ The DTR (Data Terminal Ready) signal from the computer to the modem tells the modem if it can connect to a host (DTR enabled or DTR high), or not (DTR disabled or DTR low). DTR hangup is often referred to as "quick hangup". When activated, RIPterm lowers the DTR signal to the modem for 1 second to tell the modem to disconnect. Most modems respond to this command. Some modems need to be configured to enable support for DTR Hangup. Most modems use the &D2 command to tell the modem to disconnect if DTR is lowered. You can add the &D2 command to your modem's initialization command string. If for some obscure reason DTR doesn't hangup the modem, RIPterm will attempt to hangup the modem by issuing the typical hangup command: +++ATH0^m If after trying both methods the modem still hasn't hung-up, RIPterm will say "Hangup Failed" and beep your PC Speaker. See Section 4.6.1 ■ Modem Command Strings for information on how to set the Modem Initialization string and the Modem Hangup string. ┌────────────┐ │ Local Echo │ └────────────┘ Local Echo toggles whether RIPterm should echo keystrokes to the terminal screen locally, or let the host perform the echoing. Normally, the host will do this for you, so echo is OFF by default. In some situations though, you may wish to toggle ECHO ON. One such situation is if you are directly connected to another person's computer via modem and are typing to them in a "chat-like" manner. If your can't see what you're typing, try turning on Local Echo. If Local Echo is enabled, then the phrase "HDX" is displayed which means "Half Duplex". If this is disabled (no echo), then the phrase "FDX" is displayed indicating "Full Duplex" mode is in effect. ┌───────────┐ │ Add CR/LF │ └───────────┘ This option adds a carriage return (CR or Control-M) and a Line Feed (LF or Control-J) to the end of every line of text received. Normally, this is not necessary. Some hosts however, require that CR/LF's be ON for you to see text properly. Normally, this option is OFF. If text coming across the modem does not move to the next line, then you need to turn Add CR/LF ON. If every line of text is separated by a blank line, then you need to turn Add CR/LF OFF. ┌─────────────┐ │ Destruct BS │ └─────────────┘ A Destructive Backspace means that when you press the Backspace key on your keyboard, it ERASES the character immediately to the left of the cursor. If Destructive Backspace is disabled, then the cursor simply moves one character cell to the left. Destructive Backspace defaults to ON. ┌──────────────┐ │ BS Sends DEL │ └──────────────┘ Some hosts don't recognize the Backspace key. They use the Delete key instead. For your convenience, you can tell RIPterm to act like the Delete key was pressed when Backspace the key actually used, by enabling BS Sends DEL. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.7 ■ Dialing Prefixes and Suffixes ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Modem Dialing Prefixes and Suffixes let you set different ways for your modem to dial telephone numbers. You can dial some numbers a certain way and other numbers in a totally different manner. For your modem to dial a number, it must be issued a command. Usually this command is the same for every number you dial in your Dialing Directory. This can change if you have different types of systems you call, or if you use RIPterm on a notebook computer, and need to dialing out different from various locations. The first thing transmitted is the Prefix, followed by the phone number, then the Suffix. To better illustrate how Prefixes and Suffixes are related to dialing, refer to the following: Prefix Phone Number Suffix ------ ------------ ------ ATDT 555-1212 ^M The normal prefix is ATDT. It stands for ATtention Dial Touch-tone. If you were dialing out on a rotary phone line, that would be Pulse dialing (i.e., "ATDP"). This would be a typical use for a dialing prefix. A normal suffix is a Return character (Control-M). This is entered as ^m in the suffix string field. For example, on some hosts you might have to disable error correction on your modem to connect. You wouldn't want to put the modem commands to disable error correction into your telephone number to accomplish this because it won't work -- the command appears in the wrong place in the dialing string. To disable error correction, you would add the disable commands before the DT. For example, some modems use the &M0 command to disable error correction. So your prefix would be: AT&M0DT Another example is that you are using a notebook computer. If you dial from home, you just dial the number direct. If you're calling from the office, you have to dial a 9 before the number. A different prefix could be used in these situations, and you just set the number up in the Dialing Directory to use the default prefix. Another use for Dialing Prefixes are for phone number passwords. If you work for a company that requires you to enter a password in order to dial-out, you could accomplish this as follows, "ATDT 1234567~". The 1234567 is your password and the tilde (~) is used for a 1/2 second pause. After the pause the remainder of the phone number in the dialing directory will be dialed followed by the Dialing Suffix. The Modem Prefix/Suffix Editor dialog box looks like this: ┌───────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────┐│ ││ Modem Prefix/Suffix Editor ││ │├─────────────────────────────────────────────────────────────┤│ ││ ┌─────────────────────────────┐ ┌─────────────────┐ ││ ││ ┌─┤ Prefix Settings ├─┐ ┌─┤ Suffix Settings ├─┐ ││ ││ │ └─────────────────────────────┘ │ │ └─────────────────┘ │ ││ ││ │ ┌─────────────────────────┐│ │ ┌─────────────┐│ ││ ││ │ 1 (■)│ATDT ││ │ A (■)│^M ││ ││ ││ │ └─────────────────────────┘│ │ └─────────────┘│ ││ ││ │ ┌─────────────────────────┐│ │ ┌─────────────┐│ ││ ││ │ 2 ( )│ATDP ││ │ B ( )│^M ││ ││ ││ │ └─────────────────────────┘│ │ └─────────────┘│ ││ ││ │ ┌─────────────────────────┐│ │ ┌─────────────┐│ ││ ││ │ 3 ( )│ATDT9, ││ │ C ( )│^M ││ ││ ││ │ └─────────────────────────┘│ │ └─────────────┘│ ││ ││ └─────────────────────────────────┘ └─────────────────────┘ ││ ││ ││ ││ NOTE: Radio button indicates DEFAULT Prefix or Suffix. ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└─────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────┘ Notice that in the Modem Prefix section of the dialog box that there are three different settings labeled 1, 2 and 3. Just to the right of each of these labels is a radio button. Only one of them can be selected at any one time. Whichever one is selected is the default Prefix. You may set your Dialing Directory entries to use the "default prefix". Then if you need to change all your directory entries to use a different dialing method quickly, simply change which prefix is the default and you're done. Similar to the Prefix section of the dialog box, the Suffix section also has the ability to set a "default suffix". The method is the exact same as that for prefixes except that each suffix is labeled A, B and C. If you choose a Prefix or Suffix setting of "Default", then whichever of the three Prefix or Suffix definitions you have tagged as "Default" will be used. You may also explicitly set a Prefix of 1, 2, or 3 in the Dialing Directory to select a particular Prefix, and likewise you can select explicitly set a Suffix of A, B, or C to select a particular Suffix. The idea behind the Default option is evident if you have your entire directory set to "default", then you take your computer somewhere where you need to dial say, "9" to get an outside line and you need to change your entire configuration quickly. The length limit for each Prefix and Suffix is 60 characters. ┌────────┐ │ OK │ └────────┘ OK takes all of the Prefix and Suffix settings and make them the active settings. The changes are not saved to the permanent RIPterm setup file - you must do that by clicking the Save button, or by selecting Save Setup from the Setup menu. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel discards any changes made in the Modem Prefix/Suffix Editor dialog box. Whatever settings were active before entering this dialog box will be restored. You are returned immediately to the session screen. ┌────────┐ │ Save │ └────────┘ This option will close the dialog box and save the selected settings to the permanent RIPterm setup file. See Section 4.0.1 ■ RIPterm Setup - What Is Saved? for details on everything saved to the RIPterm setup file. ┌────────┐ │ Help │ └────────┘ Congratulations! You may have already won a famous sweepstakes prize. Click Help to see if you're the next winner. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.8 ■ Modem Hardware Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────────────┐│ ││ Modem Serial Port Hardware Setup ││ │├───────────────────────────────────────────────────────┤│ ││ ││ ││ ┌────┬─┐ ││ ││ COM Port │COM1││ ││ ││ └────┴─┘ ││ ││ ││ ││ ┌────────────────────┐ ┌────────────────────┐ ││ ││ ┌─┤ Interrupt Setup ├─┐ ┌─┤ Port Address Setup ├─┐ ││ ││ │ └────────────────────┘ │ │ └────────────────────┘ │ ││ ││ │ ┌────┬─┐ │ │ ┌───┐ │ ││ ││ │ Interrupt │IRQ4││ │ │ Port Address │3F8│ │ ││ ││ │ └────┴─┘ │ │ └───┘ │ ││ ││ │ ┌───────────────────┐ │ │ ┌───────────────────┐ │ ││ ││ │ │ Use Default Value │ │ │ │ Use Default Value │ │ ││ ││ │ └───────────────────┘ │ │ └───────────────────┘ │ ││ ││ └────────────────────────┘ └────────────────────────┘ ││ ││ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ ││ ││ │└───────────────────────────────────────────────────────┘│ └─────────────────────────────────────────────────────────┘ THIS IS AN ADVANCED OPTION AND SHOULD NOT BE USED UNLESS YOU ARE FAMILIAR WITH IBM-PC INTERRUPTS, SOFTWARE ADDRESSES, AND HARDWARE SETUP! Interrupt Setup allows you to customize the interrupt (IRQ) settings for each of your four COM ports. Normally this isn't necessary. However, some PC's have special configurations that require the terminal's setup to be altered if the serial ports are to function properly. There are fourteen different interrupts that can be selected for each COM port -- IRQ2 to IRQ15. If two serial ports in the computer use the same interrupt (i.e., an interrupt conflict), then problems arise. Port Address Setup allows you to customize the base I/O address of the four COM ports that RIPterm can utilize. Normally, you will not need to alter these settings. If you have a serial port configuration that doesn't comply with the COM1-COM4 standards, you may need to alter your addresses for these ports to make RIPterm function properly. The standard addresses for COM1-4 are as follows on an AT compatible computer: Normal PC Compatible IBM Micro Channel (ISA/EISA) (PS/2) PORT ADDRESS IRQ PORT ADDRESS IRQ ---------------------- ---------------------- COM1 3F8 4 COM1 3F8 4 COM2 2F8 3 COM2 2F8 3 COM3 3E8 4 COM3 3220 3 COM4 2E8 3 COM4 3228 3 NOTE: The first time you install RIPterm, it will auto-sense if you are on a Micro Channel machine. If you are, it will customize the addresses and IRQ's for COM3 and COM4. ┌────────┐ │ OK │ └────────┘ OK takes all of the port options and make them the active settings. It will re-initialize the serial port if necessary and make any of the changes active. The changes are not saved to the permanent RIPterm setup file - you must do that by clicking the Save button, or by selecting Save Setup from the Setup menu. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel discards any changes made in the Hardware Setup dialog box. Whatever settings were active before entering this dialog box will be restored. You will be sent immediately to the session screen. ┌────────┐ │ Save │ └────────┘ This option will close the dialog box and save the selected settings to the permanent RIPterm setup file. See Section 4.0.1 ■ RIPterm Setup - What Is Saved? for details on everything saved to the RIPterm setup file. ┌────────┐ │ Help │ └────────┘ Clicking Help causes you to revert to an Homo Australipithicus. In the Help dialog, click the Back button to become a Homo Sapiens again. NOTE: This is assuming that RIPterm is being used by humans. Our marmoset users are not affected, and there is no cure for lycanthropy here. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.9 ■ File Transfer Setup ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There are four areas to the File Transfer Setup dialog box. They are Protocol Transfer Settings, ASCII Upload Settings, and Capture Log Settings. The Protocol Transfer Settings are in the upper half of the dialog box, covering Zmodem Crash Recovery, CompuServe QuickB+ Transfers, Auto Zmodem Download, Download Dir, and Upload Dir settings. The ASCII Upload Settings are in the lower left of the dialog box, and cover the Line Pacing, Character Pacing, and Line Expansion settings. The Capture Log Settings are in the lower right of the dialog box, and cover the Capture ANSI, Capture RIPscrip, and Capture Doorway settings. ┌───────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────┐│ ││ File Transfer Settings ││ │├─────────────────────────────────────────────────────────────┤│ ││ ││ ││ [X] Zmodem Crash Recovery [X] CompuServe QuickB+ Transfers ││ ││ ││ ││ [X] Auto Zmodem Download ││ ││ ││ │├─────────────────────────────────────────────────────────────┤│ ││ ┌─────────────────────────────────────────────┐││ ││ Download Dir │.\ │││ ││ ├─────────────────────────────────────────────┤││ ││ Upload Dir │.\ │││ ││ └─────────────────────────────────────────────┘││ │├─────────────────────────────────────────────────────────────┤│ ││ ┌───────────────────────┐ ┌───────────────────────┐ ││ ││ ┌─┤ ASCII Upload Settings ├─┐ ┌─┤ Capture Log Settings ├─┐ ││ ││ │ └───────────────────────┘ │ │ └───────────────────────┘ │ ││ ││ │ ┌────┬─┐ │ │ │ ││ ││ │ Line Pacing │ 7 ││ │ │ [ ] Capture ANSI │ ││ ││ │ ├────┼─┤ │ │ │ ││ ││ │ Character Pacing │ 0 ││ │ │ [ ] Capture RIPscrip │ ││ ││ │ └────┴─┘ │ │ │ ││ ││ │ [X] Line Expansion │ │ [ ] Capture Doorway │ ││ ││ │ │ │ │ ││ ││ └───────────────────────────┘ └───────────────────────────┘ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Save │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ └────────┘ ││ │└─────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────┘ ┌────────┐ │ OK │ └────────┘ OK takes all of the Transfer Settings and makes them the active settings. The changes are not saved to the permanent RIPterm setup file - you must do that by clicking the Save button, or by selecting Save Setup from the Setup menu. After choosing this item, the dialog box will close and you will be returned to the session screen. ┌────────┐ │ Cancel │ └────────┘ Cancel discards any changes made in the File Transfer Settings dialog box. Whatever settings were active before entering this dialog box will be restored. You will be sent immediately to the session screen. ┌────────┐ │ Save │ └────────┘ This option will close the dialog box and save the selected settings to the permanent RIPterm setup file. See Section 4.0.1 ■ RIPterm Setup - What Is Saved? for details on everything saved to the RIPterm setup file. ┌────────┐ │ Help │ └────────┘ This displays a help screen of the air speed velocities of various species of swallows. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.9.1 ■ Protocol Transfer Settings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The Protocol Transfer Settings are in the upper half of the dialog box, covering the Zmodem Crash Recovery, CompuServe QuickB+ Transfers, Auto Zmodem Download, Download Dir, and Upload Dir settings. ┌───────────────────────┐ │ Zmodem Crash Recovery │ └───────────────────────┘ This option controls whether Zmodem should attempt to recover from a failed transmission. In the event that a file transfer was aborted for whatever reason, Zmodem can pick up where it left off, if possible, and continue retrieving the file. This can save a lot of time, especially if you are transferring large files on unstable line conditions. If this option is selected, then Zmodem automatically tries to resume where it left off. This is the default selection. If this mode is not enabled, then Zmodem will re-transmit the entire file over again from the beginning, erasing the previous aborted attempt. ┌──────────────────────────────┐ │ CompuServe QuickB+ Transfers │ └──────────────────────────────┘ If you are connected to CompuServe, or any system that uses a 7 Bit connection, QuickB+ is optimized for these connections. Normally, you would leave this option selected, unless you needed to prevent a host from using it for some reason. ┌──────────────────────┐ │ Auto Zmodem Download │ └──────────────────────┘ Zmodem downloads can be begun automatically the moment the host starts the transfer. A Zmodem download can easily be spotted if you see the sequence "**" on your screen. If RIPterm sees this sequence, and the Auto Zmodem Download option is enabled, it will automatically begin the Zmodem transfer without you having to intervene - making the process simpler. This option is selected by default. If for some reason this operation is not desirable, this option is provided so that you can disable this. When disabled, you will need to initiate the Zmodem download (receive) on your own. ┌──────────────┐ │ Download Dir │ └──────────────┘ The download directory setting allows you to determine where files that are downloaded (received) from a host will be stored on your hard disk. By default, RIPterm will place files that are downloaded into the current RIPterm directory (for example, C:\RIPTERM\). You can plug in your own directory name in this field if you wish to place files into another location. This option is most often used to prevent files in your RIPterm runtime directory from being overwritten, or from cluttering up your RIPterm directory with a lot of files. NOTE: Your file transfer will FAIL if the directory specified does not exist! TeleGrafix Tech Support gets this question all the time! See Appendix A.5.3 ■ My File Transfers Fail Immediately for other possible causes and solutions. ┌────────────┐ │ Upload Dir │ └────────────┘ The upload directory setting allows you to instruct RIPterm where files that you will upload (send) to a host are located. By default, files are assumed to be in the local RIPterm directory. Any directory specified must correspond to an existing DOS directory. You are not restricted to uploading files from this directory only. If you wish to upload a file from some other directory, you do not have to alter this setting if you don't want to. When prompted to enter a filename to upload, simply type the path to the file directly. RIPterm is smart enough to recognize that you gave it an full path and filename, and will temporarily override the upload directory setting. You can use the standard DOS * and ? wildcards to specify a number of files if desired. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.9.2 ■ ASCII Upload Settings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The ASCII Upload Settings are in the lower left of the dialog box, and cover the Line Pacing, Character Pacing, and Line Expansion settings. A useful aspect of ASCII uploads is that it can make a host behave EXACTLY as if you had typed in a series of commands on the keyboard. So if you have an intricate series of commands that you always have to enter, you can use a Keystroke Macro, or you can use a text file containing the commands, and ASCII Upload it to the host. You may have to tweak your ASCII Upload Settings to get it to work right, but it is VERY useful. This option modifies the default settings for ASCII (text) uploads. Some hosts are picky about how fast they can take text data being uploaded to them. With this in mind, you can set a short delay in between each line of text sent to the host, and/or you can set a delay in between each character sent to the host. Fine tuning this can make ASCII text uploads fast and the most optimized they can be for the host you call. ┌─────────────┐ │ Line Pacing │ └─────────────┘ Sometimes when uploading ASCII files to a host, it is necessary to pause in between each line so that the host can process the data. If you find that data is becoming lost, or garbled by the host when you perform an ASCII upload, you may need to increase the Line Pacing option for ASCII uploads. You specify a time value in 1/10ths of a second. Therefore, if you specify a value of 11, it would be a 1.1 second pause in between lines. ┌──────────────────┐ │ Character Pacing │ └──────────────────┘ Under some circumstances, when performing an ASCII upload to a host, it is necessary to insert pauses in between each character that is sent to the host. This may be necessary in situations where the host must process each character as it is sent, rather than every line of text sent. You specify a time value in 1/10ths of a second. Therefore, if you specify a value of 11, it would be a 1.1 second pause in between lines. ┌────────────────┐ │ Line Expansion │ └────────────────┘ When this option is chosen, RIPterm will expand blank lines that are uploaded in ASCII mode to a space character followed by a carriage return. This tricks the host into thinking that you typed something on every line, but the lines still show up as a blank. Turn this option off if you do not want blank line expansion to be enabled. This is often the case with some e-mail editors. For example, if you upload a text file into an e-mail message on a host and the file has blank lines in it, when that blank line is uploaded to the system it might (depending on the host package) show a command prompt instead of accepting the blank line as "raw text". RIPterm allows you to "transform" blank lines into a single space character followed by a carriage return. This in effect, tricks the host into thinking you typed something in, but at the same time makes it look like a real blank line in your message. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 4.9.3 ■ Capture Log Settings ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The Capture Log Settings are in the lower right of the dialog box, and cover the Capture ANSI, Capture RIPscrip, and Capture Doorway settings. When you turn on the Log Text to File option in the File menu, these settings control what is captured, and what is ignored. For more information on ANSI, RIPscrip, and Doorway, refer to the Emulation options shown in Section 3.4 ■ The Options Menu. ┌──────────────┐ │ Capture ANSI │ └──────────────┘ Captures the ANSI text color and positioning commands. ┌──────────────────┐ │ Capture RIPscrip │ └──────────────────┘ Captures all RIPscrip commands received. ┌─────────────────┐ │ Capture Doorway │ └─────────────────┘ Captures any Doorway commands sent from the host. ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ 5.0 ■ RIPterm Features ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ RIPterm has a great many features to make your online access quicker and easier. Some features are advanced and some are simple. The following section documents the various features of RIPterm to help make your adventure in the online world as simple as possible. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.1 ■ The Status Bar ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The Status Bar will be displayed at the bottom of your RIPterm screen by default. When this option is not checked, the Status Bar will not be displayed and your default (full-screen) text window will be one line taller. The Status Bar is used to display the current status of various aspects of the RIPterm operation. You may toggle the Status Bar ON and OFF quickly by pressing ALT-SPACE. The host might turn the Status Bar ON or OFF for you, using RIPscrip commands. If it mysteriously vanishes for some reason, keep in mind that the host you are connected to probably did it because it needs the extra line for text or graphics! The Status Bar has a number of different "fields", displaying information about RIPterm's current configuration and status. The fields are: ┌──────────────┬──────────────┬──────────┬─────────────────┬ │ Alt-Z = Help │ Alt-! = Menu │ ANSI/RIP │ 38400 ■ N81 FDX │ └──────────────┴──────────────┴──────────┴─────────────────┴ (1) (2) (3) (4) (5) (6) ┬──────┬──────────────────┬─────────┐ │ COM1 │ RIPterm v2.00.00 │ Offline │ ┴──────┴──────────────────┴─────────┘ (7) (8) (9) (1) How to get the Help System Table of Contents (2) How to use the keyboard only to bring up the menu bar (3) What terminal emulation is in use, or the name of the log file if one has been opened, or the LPT port that it being printed to. (4) The BPS (bits per second) rate. Sometimes called the baud rate. (5) The parity setting, data bits, and stop bits. (6) Full-duplex (FDX) or half-duplex (HDX) settings (7) The COM port that is currently in use (8) The current version number of RIPterm (9) Whether you are "offline", or how long you have been on-line Each of the various fields are described below: ┌──────────────────┐ │ (1) Alt-Z = Help │ └──────────────────┘ This option tells you how to display the Help Table of Contents. From there, you can access any area in the Help System quickly and easily. ┌──────────────────┐ │ (2) Alt-! = Menu │ └──────────────────┘ This option tells you how to access the menu bar via the keyboard. The menu bar at the top of the screen is highlighted for you. You may use the keyboard or the mouse to navigate through the menus and select options. Remember that you can click the right mouse button to bring up the menu bar also. ┌─────────────────┐ │ (3) Misc. Field │ └─────────────────┘ This field serves three purposes. If you are logging your session to a "log file", the filename (without extension) of the log file will be displayed in here. If you are not logging your session at all, then this field will display the phrase "ANSI/RIP", indicating that you are using a RIPscrip compatible terminal program. ┌────────────────────────────────────────────┐ │ (4) Baud Rate (5) Port Config (6) Duplex │ └────────────────────────────────────────────┘ These fields indicate what the current communications parameters are. The baud rate (300-115,200 baud) is displayed as well as the data bits (7 or 8), parity (N = none, E = even, and O = odd), and the stop bits (1 or 2). If Local Echo is enabled, then the phrase "HDX" is displayed which means "Half Duplex". If this is disabled (no echo), then the phrase "FDX" is displayed indicating "Full Duplex" mode is in effect. ┌─────────────────────────┐ │ (7) Communications Port │ └─────────────────────────┘ This field displays what communications port you are using. The valid ports are COM1, COM2, COM3, and COM4. ┌─────────────────────────┐ │ (8) RIPterm Information │ └─────────────────────────┘ This field displays the RIPterm version number. ┌──────────────────────────────┐ │ (9) Online/Offline Indicator │ └──────────────────────────────┘ This field displays whether you are online or offline. When RIPterm is starting up, you might see the phrase "Loading..." in this field; this is just a status indicator telling you RIPterm is doing something. The purpose of this field is for you to be able to, at a glance, determine if you are still connected to a host or not. If you are online, this field shows how long you have been connected to the host. See Section A.5.4 ■ My Modem is Always On-Line (Resuming Previous On-line Session)to fix this problem. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2 ■ The Dialing Directory ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Displayed at the top of the Dialing Directory dialog box is the name of the directory file in use (the default is RIPTERM.PHO). Whenever you change Dialing Directory files, this will change to reflect the current file in use. The middle area of the dialog box lists the host systems that have been entered for you to call. Seventeen hosts are displayed at once, and each directory can contain up to 1,000 entries. You can scroll through the available hosts by using the scroll bar at the right side of the screen. The UP ARROW, DOWN ARROW, PGUP, PGDN, HOME, and END keys work intuitively. To select an item, you can just type it's number. The Mark Entries dialog pops up to allow you to select items. See the description of the Mark button below for more details. The default display shows System Name, Phone Number, and Directory. See the Toggle button below for all the available displays. This is what the Dialing Directory dialog box looks like: ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Dialing Directory:RIPTERM.PHO ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││┌─────────────────────────────────────────────────────────────────────┬─┐││ │││ 1: The Vector Sector ││││ │││ 2: <blank> ├─┤││ │││ 3: <blank> │█│││ │││ 4: <blank> │ │││ │││ 5: <blank> │ │││ │││ 6: <blank> │ │││ │││ 7: <blank> │ │││ │││ 8: <blank> │ │││ │││ 9: <blank> │ │││ │││ 10: <blank> │ │││ │││ 11: <blank> │ │││ │││ 12: <blank> │ │││ │││ 13: <blank> │ │││ │││ 14: <blank> │ │││ │││ 15: <blank> │ │││ │││ 16: <blank> ├─┤││ │││ 17: <blank> ││││ ││└─────────────────────────────────────────────────────────────────────┴─┘││ ││┌────────┬────────┬────────┬────────┬────────┬────────┬────────┬────────┐││ │││ Edit │ Mark │ Unmark │ SaveAs │ Load │ Find │ Create │ Config │││ ││├────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤││ │││ Dial │ Cancel │ Kill │ Print │ Toggle │ Add │ Help │ Sort │││ ││└────────┴────────┴────────┴────────┴────────┴────────┴────────┴────────┘││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ There are sixteen buttons at the bottom of the dialog box to choose from. They function as follows: ┌────────┐ │ Edit │ └────────┘ Clicking this button edits the currently selected entries. An editing dialog box will appear for each host selected allowing you to edit each host's characteristics. See Section 5.2.1 ■ Editing Dialing Directory Entries for details on editing entries. ┌────────┐ │ Mark │ └────────┘ This option will mark (select) one or more Dialing Directory entries. When selected, a dialog box will appear prompting you to enter which entries to select. In this dialog box, you can enter one or more numbers indicating which directory entry(s) to select. There are a number of options you may choose from for selecting entries. Some examples are: Examples: --------- 1 ... Selects entry 1 1, 2, 3 ... Selects entries 1, 2 and 3 1 2 3 ... Selects entries 1, 2 and 3 1;2;3 ... Selects entries 1, 2 and 3 1-10 ... Selects entries 1 through 10 15- ... Selects entries 15 to the end (100) -5 ... Selects from Start (1) to entry 5 - ... Selects ALL entries 1-5, 10, 95- ... Selects 1-5, 10 and 95-100 In addition, you can also specify a "Mark Merge". This mode allows you to combine your Marked entries with any entries that are already marked. To use Mark Merge mode, enter a plus sign (+) as the first character. For example, if entries 3 and 5 are selected, and you mark "+ 10-15", then entries 3, 5, and 10-15 will be selected. One final option is the Mark Exclude mode. This mode is similar to Mark Merge, except that all entries EXCEPT those selected are marked. In other words, anything that you would think would be selected, would not be, and anything that shouldn't be selected, will be! This odd way of doing things can become very handy when combined with some of the other options in the Dialing Directory. To choose Mark Exclude mode, specify an exclamation mark (!) as the first character. You can combine Mark Merge, and Mark Exclude modes together. To do this, enter the sequence "+!" as the first two characters in the dialog box. Mark Mode will be automatically chosen if you begin typing something that appears to be a mark sequence. In other words, you do not have to select Mark mode in order to Mark entries. For example, from the Dialing Directory dialog box, simply typing "1" will bring up the Mark dialog and place "1" in the editing field automatically and allow you to continue typing in your Mark expression. ┌────────┐ │ Unmark │ └────────┘ This will de-select any previously selected directory entries. ┌────────┐ │ SaveAs │ └────────┘ This option will save either the entire Dialing Directory (or just the selected entries) to another directory file. This allows you to create new directory files quickly and easily for specific purposes. If one or more entries are selected, only those entries are copied to the new file. If no entries are selected, then the entire Dialing Directory file is copied. You will be prompted to enter the destination filename. If the destination file exists, it is checked to see if it is a RIPterm Dialing Directory file. If it is, you will be prompted to either merge the selected entries into the destination file, or to overwrite the file with just the selected entries. In the event that the destination file becomes full, a message to the effect will be displayed informing you how many entries couldn't be copied. This "directory merge" feature is unique to RIPterm. NOTE: Modifications to the Dialing Directory are automatically saved to the current directory file. You do not need to choose SAVE AS every time you add or edit an entry. ┌────────┐ │ Load │ └────────┘ This option allows you to load up another Dialing Directory file. The current directory file will be closed and the specified file will be loaded in its place. All entries are de-selected, and the window will automatically display the newly loaded entries. ┌────────┐ │ Find │ └────────┘ This option will select one or more entries that contain the specified search text. Once you choose this option, a dialog box will appear prompting you to enter a string to search for throughout the Dialing Directory. Any entries that contain the chosen text will be automatically selected. Search is not case sensitive. The System Name, all three Phone Numbers, the User-ID, Password, System ID, and Notes fields are searched for the string. Text can appear anywhere in any of these eight fields and will still be found. You may choose Find Merge mode or Find Exclude mode (or both) exactly the same way as you can with the Mark mode. The command characters (+ and !) are not added to the search string, and must be the first characters specified in the search string. Merge mode can be quite useful if you wish to select all entries in a specific area code, or that contain a common theme (like "business" or "daily"). ┌────────┐ │ Create │ └────────┘ This option creates a new Dialing Directory file. You are prompted for the number of entries the new file is to contain, and the name of the new Dialing Directory file. You are then asked to confirm that you really want to create the new file. If you click OK without a filename, nothing is done. ┌────────┐ │ Config │ └────────┘ This option is not available in the current release of RIPterm. ┌────────┐ │ Dial │ └────────┘ Selecting Dial calls one or more selected directory entries. If more than one entry is selected, they will be dialed in numerical order. If a connection is established to any host, it will be de-selected in the Dialing Directory so that later re-entry into the directory will allow you to dial the remaining hosts. This option is automatically selected if you press ENTER if at least one directory entry is selected. ┌────────┐ │ Cancel │ └────────┘ This will exit the Dialing Directory dialog box, and return you the to session screen. Any previously selected entries will remain selected next time you enter the directory. ┌────────┐ │ Kill │ └────────┘ This option will delete all selected directory entries. You are prompted with Erase Only, or Remove Entirely (Pack)? Erase Only just clears the entries selected to <blank>. Remove Entirely move the other entries in the Dialing Directory up to fill in the gaps. You will be prompted to make absolutely sure that you truly wish to erase the entries. All calling statistics for those entries will be erased as well. Once an option is killed, it is permanently deleted. If no entries are selected, this option has no effect. ┌────────┐ │ Print │ └────────┘ This prints just the Dialing Directory entries selected, or the entire directory if no entries are selected. The output can be directed to a printer or a file. Choosing the disk option will prompt you for a filename, and if you wish to append to the file, or overwrite any file by that name. Before printing or saving occurs, you will be asked what type of output you wish. You have two choices: Detailed Listing, or Tabular Listing. Specifying Detailed Listing will output a multi-line record for each entry. The format of detailed breakdown mode is as follows: ----------------------------------------------------------------------------- ENTRY #: 1 ----------------------------------------------------------------------------- Name: The Vector Sector Phone-2: 714/379-2134 Phone-1: 714/379-2133 Phone-3: 714/379-3135 SystemID: TELEGRFX User-ID: SysopJim Connects: 0 Password: Last Date: --/--/---- VT-102: NO Prefix: Default COM Port: Default Suffix: Default Baud Rate: Default BS Destr.: NO Data Bits: Default BS Delete: NO Parity: Default Local echo: NO Stop Bits: Default Use modem: Default Flow Control: None Baud Lock: NO Add CR/LF: NO Notes: Home of RIPscrip graphics Tabular Listing will print one entry per line, formatted for an 80-column display: Baud COM Last Mod Host Name Host Phone Number Rate Val # Calls Call ? Direc. =============================================================================== The Vector Sector 714/379-2133 ------ --- - 0 --/--/-- - TELEGRFX 714/379-2134 714/379-3135 ┌────────┐ │ Toggle │ └────────┘ Toggle alters what information is displayed in the Dialing Directory window. By default, the following information is displayed on each line in the window: ─#─ ──────System Name─────── ──────Phone Number───── ─Directory── Entry # Host System Name Phone Number System ID (Directory) There are six different toggle settings available, displaying all the various information that can be set in the Entry Editor. The alternate toggles are: ─#─ ──────System Name───── Port ─Baud─ D P S CT L ──Flow── Entry # Host System Name COM Port Baud Rate ┐ Data Bits │ Parity │ Stop Bits ├ Show dashes if no Custom Port Config Connection (MoDem or SeRial)│ Port Lock │ Flow Control ┘ ─#─ ──────System Name─────── ────────────────Notes─────────────── Entry # Host System Name Notes ─#─ ──────System Name─────── LastCall Total# Emulat E C BD BK P S Entry # Host System Name Date of Last Call Total Number of Calls Terminal Emulation (ANSI or VT-102) Local Echo Add CR/LF Destructive Backspace Backspace Sends DEL (BS or DL) Prefix Suffix ─#─ ────System Name──── ───Phone 1─── ───Phone 2─── ───Phone 3─── Entry # Host System Name Phone Number 1 Phone Number 2 Phone Number 3 ─#─ ──────System Name─────── ───────User-ID────── ───Password──── Entry # Host System Name User-ID Password This is a simple toggle. Each time you choose this option, the information displayed will change to the next mode. Your favorite toggle setting can be saved to your permanent RIPterm setup. To do this, choose the toggle mode you like the best, exit the Dialing Directory, then choose Save Setup from the Setup Menu. ┌────────┐ │ Add │ └────────┘ Add the selected number of entries to the end of the current Dialing Directory file. ┌────────┐ │ Help │ └────────┘ This option displays who really killed JFK. ┌────────┐ │ Sort │ └────────┘ This option is not available in the current release of RIPterm. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2.1 ■ Editing Dialing Directory Entries ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ When you choose to edit Dialing Directory entries, a dialog box like this appears on your screen to let you edit the various entries: ┌───────────────────────────────────────────────────────────────────────────┐ │┌─────────────────────────────────────────────────────────────────────────┐│ ││ Edit Directory Entry #1 ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││ ┌─────────────────────────┐ ┌───────────┬─┐ ││ ││ System Name │The Vector Sector │ Prefix # │ Default ││ ││ ││ ├─────────────────────────┤ ├───────────┼─┤ ││ ││ Phone Number 1 │714/379-2133 │ Suffix # │ Default ││ ││ ││ ├─────────────────────────┤ ├───────────┴─┤ ││ ││ Phone Number 2 │714/379-2134 │ System Dir │ │ ││ ││ ├─────────────────────────┤ ├─────────────┤ ││ ││ Phone Number 3 │714/379-2135 │ User-ID │ │ ││ ││ ├─────────────────────────┤ ├─────────────┤ ││ ││ Notes │Home of RIPscrip graphics│ Password │ │ ││ ││ └─────────────────────────┘ └─────────────┘ ││ ││ VT-102 [ ] Local Echo [ ] Destruct. BS [XI Hide UserID & P/W [ ] ││ ││ CustomPort [ ] Add CR/LF [ ] BS Sends DEL [ ] Restricted Access [ ] ││ │├─────────────────────────────────────────────────────────────────────────┤│ ││ ┌────────────┬─┐ ┌──────────────────┐ ││ ││ COM Port │ COM1 ││ BIOS COM Port [ ] │ Default Settings │ ││ ││ ├────────────┼─┤ └──────────────────┘ ││ ││ Baud Rate │ 19,200 ││ Port Lock [X] ┌──────────────────┐ ││ ││ ├────────────┼─┤ │ Active Settings │ ││ ││ Data Bits │ 8 Bits ││ Modem Connection [X] └──────────────────┘ ││ ││ ├────────────┼─┤ ┌──────────────────┐ ││ ││ Parity │ No Parity ││ RTS/CTS (■) │ Set 8-N-1 │ ││ ││ ├────────────┼─┤ └──────────────────┘ ││ ││ Stop Bits │ 1 Stop Bit ││ XON/XOFF ( ) ┌──────────────────┐ ││ ││ └────────────┴─┘ │ Set 7-E-1 │ ││ ││ └──────────────────┘ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ │└─────────────────────────────────────────────────────────────────────────┘│ └───────────────────────────────────────────────────────────────────────────┘ The significance of each of these fields are described below. The top half of the dialog box deals with settings needed for each entry. The bottom half of the dialog box deals with the Custom Port settings, and is normally ghosted (grayed-out or non-selectable) unless the CustomPort check box is selected. ┌────────┐ │ OK │ └────────┘ This will accept any changes you have made and return you to the Dialing Directory dialog box. Any changes you made in the editor will be reflected in the directory window. If you have selected multiple entries to edit, then the remaining entries (if any) that haven't been edited will be edited before you are returned to the directory screen. ┌────────┐ │ Cancel │ └────────┘ This will cancel any modifications you have made in the directory editor. You will be returned to the Dialing Directory automatically. If you have chosen to edit multiple directory entries (by selecting more than one), and there are entries that haven't been edited yet, they will be edited before you are eventually returned to the Dialing Directory dialog box. ┌────────┐ │ Help │ └────────┘ Click Help. Perspiring minds want to know. ▒▒▒ System Name ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ The System Name field is the name of the host that appears in the Dialing Directory dialog. This is the name that will be displayed to you whenever you dial the host, and is used in general to describe the host. You are allowed 24 characters for the host name. ▒▒▒ Phone Number 1 ■ Phone Number 2 ■ Phone Number 3 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ These are the telephone numbers used to dial the host. The number should be entered EXACTLY as you would dial it yourself if you were to use a phone. You are allowed up to 24 characters in each number. Valid characters are digits 0-9, hyphens, slashes, and parenthesis (if your modem allows them). You may use a comma (,) for a two or three second pause (depending on your modem) Check your modem's documentation to determine the delay value. If you wish for RIPterm to perform a half-second pause instead of the modem, use a tilde (~). NOTE: If Use Modem is NOT selected, the Phone Number 1 field is transmitted without prefix or suffix as the activation string for the direct connection to the host. Some systems require just a CR (Control-M or ^m) as the activation string. ▒▒▒ Notes ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This is a field where you may enter some comments or notes. It is strictly for your convenience. ▒▒▒ Prefix # ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option lets you select the Dialing Prefix to use. Usually, the best choice is Default, unless you have a need for a particular prefix. See Section 4.7 ■ Modem Dialing Prefixes for full details on prefixes. ▒▒▒ Suffix # ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option lets you select the Dialing Suffix to use. Usually, the best choice is Default, unless you have a need for a particular suffix. See Section 4.7 ■ Modem Dialing Prefixes for full details on suffixes. ▒▒▒ System Dir ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Each entry in the directory can have a sub-directory associated with it. This directory is used when RIPscrip graphics are being viewed on the host. Any icon, RIPscrip, sound, or image files that are sent by the host are automatically placed in the System Dir. This in effect, helps keep your icons separated from each other. If you omit a directory name in this field, and you dial into a RIPscrip host that requires icons or RIPscrip files, RIPterm will look for them automatically in the ICONS\ sub-directory. It is recommended that you keep host specific files in their proper sub-directories so as to keep files with the same name from overwriting each other. You do not need to create the sub-directory yourself. RIPterm will create it for you automatically. If the System Dir field is not blank, RIPterm checks in that directory FIRST for any necessary files. If the files are not found in that sub-directory, RIPterm will check the ICONS\ sub-directory afterward to see if it is there. This facilitates the concept of "file override". This "file override" is best explained by an example. Let's say you call several different RIPscrip hosts. Each of them have numerous icons that they use for their host. Now as you are probably aware, the sysop of each host thinks of his host as the only host in the world. With that in mind, they do not give a great amount of thought to the names that they give their icon or RIPscrip files (i.e., not considering that other hosts might have files with the same names). Files like EMAIL.BMP or FILES.BMP would be used on nearly any host! If all these files were located in the same directory, only the very latest files would be used when you call a host! In other words, when you call host XYZ, you might see host ABC's EMAIL icon! This is obviously not how it should work. With this in mind, keeping files in separate sub-directories resolves this problem quite nicely. Even if a sysop chooses to use the standard RIPterm EMAIL icon, he can do that too. All he has to do is NOT provide you with his own EMAIL icon. RIPterm would first check host XYZ's directory, and after finding that the file is not there, would check the ICONS\ directory and find it there. This way, the sysop has the ability to override standard icons with his own without affecting the standard icons. Keep in mind, that if you dial a host by type modem commands directly (not using the Dialing Directory), then the correct directory may not be used since RIPterm has no way of knowing which Dialing Directory entry you are calling. In other words, you should use the Dialing Directory to call ALL RIPscrip hosts! You can use the Manual Connect option to dial a host and set the correct System Dir. NOTE: RIPterm supports an automatic file transfer mode. This mode allows hosts to send files to your computer for subsequent use. Any files received in this mode are automatically placed in the proper System Dir. If no System Dir is defined, then the ICONS\ sub-directory is used as the destination sub-directory. The Download Directory as set in the File Transfer Settings dialog box is not used in this situation as the destination directory. ▒▒▒ User-ID ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ The User-ID field is simply a comment field for you to keep track of your account for this system. RIPterm makes no use of this information, and the host can not get at this information in any way. ▒▒▒ Password ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ The Password field is simply a comment field for you to keep track of your password for this system. RIPterm makes no use of this information, and the host can not get at this information in any way. ▒▒▒ VT-102 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This enables VT-102 terminal emulation automatically when you connect to this system, if selected. See Section 3.4 ■ The Options Menu (Alt-O) for details on VT-102 emulation. ▒▒▒ Local Echo ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Local Echo sends every character you type directly to the screen. If you are seeing every character twice, then you need to turn this option OFF. See Section 4.6.3 ■ Modem General Settings for more details on Local Echo. ▒▒▒ Destruct. BS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ A Destructive Backspace means that when you press the Backspace key on your keyboard, it ERASES the character immediately to the left of the cursor. If Destructive Backspace is disabled, then the cursor simply moves one character cell to the left. Destructive Backspace defaults to ON. ▒▒▒ Hide UserID & P/W ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option is ghosted, and does nothing in this release of RIPterm. In the future, this option will be used to keep your User-ID and Password fields secret. ▒▒▒ CustomPort ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Selecting the Custom Port option enables the bottom half of the dialog, and allows you to use the settings at the bottom of the screen. These settings now override the settings in your Modem Setup and Dialing Prefixes Setup. See Section 5.2.2 ■ Editing Dialing Directory Entries Custom Port Settings below for details on setting all these options. ▒▒▒ Add CR/LF ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option adds a carriage return (CR or Control-M) and a Line Feed (LF or Control-J) to the end of every line of text received. Normally, this is not necessary. Some hosts however, require that CR/LF's be ON for you to see text properly. Normally, this option is OFF. If text coming across the modem does not move to the next line, then you need to turn Add CR/LF ON. If every line of text is separated by a blank line, then you need to turn Add CR/LF OFF. ▒▒▒ BS Sends DEL ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Some hosts don't recognize the Backspace key. They use the Delete key instead. For your convenience, you can enable BS Sends DEL to tell RIPterm make Backspace act just like Delete was pressed when Backspace the key actually used. ▒▒▒ Restricted Access ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option is ghosted, and does nothing in this release of RIPterm. It is included for future expansion. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2.2 ■ Editing Dialing Directory Entries Custom Port Settings ▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The entire bottom half of the Edit Dialing Directory Entries dialog is devoted to custom settings for an entry. Selecting the Custom Port option enables the bottom half of the dialog, and these settings now override your default settings. ▒▒▒ COM Port, Baud Rate, Data Bits, Parity, and Stop Bits ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ See Section 4.6.2 ■ Modem Port Settings for information on these options. ▒▒▒ BIOS COM Port ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option is not available in the current release of RIPterm. ▒▒▒ Port Lock ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ This option keeps the computer to modem speed constant. See Section 4.6.3 ■ Modem General Settings for information on this option. ▒▒▒ Modem Connection ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ If Modem Connection is selected, RIPterm knows that it is connected to a modem. This is the normal, default situation. RIPterm send the "Modem Init" command string to the modem when it starts up. If you are using RIPterm to connect directly to another computer via a serial link (for example, by using a null modem cable), then you would want to select Another Computer. ▒▒▒ RTS/CTS and XON/XOFF ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ These options are for received data Flow Control. See Section 4.6.3 ■ Modem General Settings for information on this option. ┌──────────────────┐ │ Default Settings │ └──────────────────┘ This button takes the active settings from the Modem Setup dialog and enters them into the fields for you. This is a handy way to get back to your starting point. ┌──────────────────┐ │ Active Settings │ └──────────────────┘ This button takes whatever settings may have been changed by connecting to a particular host. In most cases, this button will behave exactly the same as the Default Settings button. ┌──────────────────┐ │ Set 8-N-1 │ └──────────────────┘ This button sets the Data Bits to 8, Parity to None, and Stop Bits to 1. This is the most common settings for connecting to a remote system. ┌──────────────────┐ │ Set 7-E-1 │ └──────────────────┘ This button sets the Data Bits to 7, Parity to Even, and Stop Bits to 1. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2.3 ■ Dialing Directory Conversion Utility (DIALCONV.EXE) ▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ For your convenience, a utility program has been included with RIPterm to convert Dialing Directory files from other popular terminal programs to RIPterm v1.54 format. This program currently supports the conversion of Telix and TeleMate directory files to RIPterm format. Conversion is "one way". In other words, you cannot convert a RIPterm directory file to Telix format, but you can convert Telix to RIPterm v1.54 format. NOTE: There is a separate utility included to convert RIPterm v1.54 directories to RIPterm v2.0 directories. If you are converting a Telix or TeleMate directory to RIPterm v2.0 format, you must do it in two steps. Use of DIALCONV is quite simple. The program will auto-detect what type of Dialing Directory file is to be processed and will automatically use the appropriate conversion method necessary for the given file. To convert a directory file, enter a command similar to: DIALCONV TELIX.FON RIPTERM.PHO In the preceding example, DIALCONV would convert the Telix directory file TELIX.FON to a RIPterm directory file called RIPTERM.PHO. RIPterm uses the extension of .PHO to designate Dialing Directories. All "statistical" data in the source directory file are converted into the new RIPterm file. For example, the last date a host was called, and total number of calls you have made to that host are converted as well and are made part of the RIPterm directory file. In addition, COM port, baud rate and other settings are converted as well for your convenience. If you wish to simply view the contents of a Telix or TeleMate directory file without conversion (to make sure that conversion would take place properly), you can choose an optional "view" option for DIALCONV by specifying the "-v" switch on the command line. For example, to list out all the valid entries in a Telix directory file called TELIX.FON to the screen, enter the following command: DIALCONV -v TELIX.FON All entries will be displayed to the screen for you. Output can be captured to a text file if you wish by using the MS-DOS redirection feature. Using the preceding example, let's say you wanted to print all entries in the Telix directory file to the text file TELIX.LST, enter the following command: DIALCONV -v TELIX.FON >TELIX.LST Note the use of the redirection symbol ">" followed by the filename to redirect output to. You could just have easily directed the programs output to the Printer with the following command: DIALCONV -v TELIX.FON >PRN ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2.4 ■ Dialing Directory File Format ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ For the technically minded, this section contains the C header file containing all the correct values for working with the RIPterm Dialing Directory file. This is provided for programmers who wish to create maintenance utilities. //======================================================================== // A phone book contains the necessary information to dial one or more // host systems. Each host system may have up to three phone numbers // attached to it (for multi-line systems without a "real" rotary. The // entire phone book file may be password restricted, making it so that // you have to enter a password to gain access to the entire phone book. // Alternatively, you may protect certain entries in the phone book with // the master phone book password so that only authorized dialouts can // occur on particular numbers, but leaving other numbers open for regular // use (useful in a family situation). // // If the entire phone book is password protected, then all system names, // telephone numbers, login user-id's and login passwords are encrypted to // prevent unscrupulous users from trying to hack the raw binary phone // book file. If only particular entries are protected (i.e., the whole // phone book file isn't password protected), then only the phone numbers, // login user-id's and login passwords are encrypted. The system names // are left unencrypted so that they can show up in the Dialing Directory // dialog box (you just can't access them without the phone book password) //======================================================================== //------------------------------------------------------------------------ // These definitions specify the structure of a phone book's header data // block. At the very beginning of the file is a text message that // identifies the file as a RIPterm directory file, followed by the ASCII // character CTRL-Z (end of file). If a user types out this file, they // will only see the title and nothing more. This keeps out only the most // casual of hacker. Binary file viewing utilities will bypass this // counter-measure. Immediately after the file header will be zero or // more phone entry records. The exact number of records that should be // in the file is stored in the phdTotalEntries member of this structure. // The maximum number of phone directory entries is 1024 //------------------------------------------------------------------------ typedef unsigned short WORD; typedef signed short SWORD; typedef unsigned long DWORD; typedef signed long SDWORD; typedef unsigned char BYTE; #define PHONE_TITLE " RIPterm Dialing Directory File \n\r" #define PHONE_TITLE_SIZE 37 #define PHONE_MAX_ENTRIES 1000U #define PHONE_MIN_ENTRIES 20 #define DIAL_DIR_FILENAME "RIPTERM.PHO" #define MAX_NUMS 3 /* Max phone #'s per entry */ #define PHONE_PWORD_LEN 25 /* Length of password field */ // // Finds the offset of a particular record in the Dialing Directory file. // #define PHONE_DIR_OFFSET( which ) \ ( ( SDWORD ) sizeof( phoneHeader ) + \ ( SDWORD ) sizeof( phoneEntry ) * ( SDWORD ) ( which ) ) typedef enum _phoneHeaderFlags { phdPasswordRestricted = 0x0001, // Password phone book access? phdPasswordProtectedEntries = 0x0002 // P/W protects some entries } phoneHeaderFlags; typedef struct _phoneHeader *phoneHeaderPtr; typedef struct _phoneHeader { char phdTitle[ PHONE_TITLE_SIZE ]; // Title of phone book file char phdEofChar; // EOF char ASCII 26 (Ctrl-Z) WORD phdTotalEntries; // Total phone book entries WORD phdFlags; // Various phone book flags WORD phdTotalProtectedEntries; // Total # protected entries char phdPassword[ PHONE_PWORD_LEN ]; // Phone Book Access Password char phdSpareSpace[ 81 ]; // SIZEOF: 150 bytes } phoneHeader; //---------------------------------------------------------------------- // The following definitions are used for the phone book records. // These record entries define a particular host system. There are zero // or more of these records immediately following the phone book header // data block. The total number of phone record entries is defined as // header->phdTotalEntries //---------------------------------------------------------------------- typedef enum _phoneFlags { phoBspaceDestructive = 0x0001, // Non destructive backspace phoBspaceSendDelete = 0x0002, // BS key sends DEL (not BS) phoHideUserIdAndPassword = 0x0004, // Password is hidden phoProtectedEntry = 0x0008, // Entry access by book p/w phoCustomPortConfig = 0x0010 // Use setup port config? } phoneFlags; #define PHONE_UID_LEN 30 // Length of userid field #define PHONE_NAME_LEN 25 // Length of system name #define PHONE_NUM_LEN 25 // Length of phone number #define PHONE_ID_LEN 13 // Length of system ID field #define PHONE_NOTE_LEN 51 // Length of user note field typedef struct _phoneEntry *phoneEntryPtr; typedef struct _phoneEntry { char phoName[ PHONE_NAME_LEN ]; // Name of System char phoNumber[ MAX_NUMS ] [ PHONE_NUM_LEN ]; // Phone #(s) of System // ---------------------- portSetup phoPortConfig; // COM port for entry // ---------------------- char phoSystemID[ PHONE_ID_LEN ]; // System-ID (filename) // ---------------------- SDWORD phoTotalConnects; // Total # of connections SWORD phoLastDate; // Last Date connected // ---------------------- BYTE phoPrefixUsed; // Prefix (0=def, 1-3) BYTE phoSuffixUsed; // Suffix (0=def, 1-3) // ---------------------- char phoSystemUserID[ PHONE_UID_LEN ]; // UserID used on system char phoSystemPassword[ PHONE_PWORD_LEN ]; // P/W used on system // ---------------------- char phoNotes[ PHONE_NOTE_LEN ]; // Misc user notes // ---------------------- WORD phoFlags; // Various phone flags // ---------------------- WORD phoTermEmulation; // Default emulation // ---------------------- char phoSpareSpace[5]; // Spare space } phoneEntry; // SIZEOF: 250 Bytes //------------------------------------------------------------------------ // This following structure defines a serial-port configuration. There // are technically two pertinent serial port configuration blocks that are // used at any one time, the "current port config", and the "default setup // config" block. The "current" config is the one that is // driving the serial port, which can vary from one Dialing Directory // entry to another. The default serial port setup stored in the setup // file merely defines the standard default serial configuration. When a // Dialing Directory entry is dialed, this can modify the current port // configuration, but leaves the default setup configuration untouched. //------------------------------------------------------------------------ typedef enum _comPorts { portNone = -1, // Com port (none) portCOM1 = 0, // Com port COM1 portCOM2 = 1, // Com port COM2 portCOM3 = 2, // Com port COM3 portCOM4 = 3, // Com port COM4 } comPorts; // SIZEOF: 2 bytes typedef enum _baudRates { baud300 = 0, // Baud rate 300 bps baud1200 = 1, // Baud rate 1200 bps baud2400 = 2, // Baud rate 2400 bps baud4800 = 3, // Baud rate 4800 bps baud9600 = 4, // Baud rate 9600 bps baud19200 = 5, // Baud rate 19200 bps baud38400 = 6, // Baud rate 38400 bps baud57600 = 7, // Baud rate 57600 bps baud115200 = 8, // Baud rate 115200 bps } baudRates; // SIZEOF: 2 bytes typedef enum _dataBits { dataBits8 = 0, // 8 data bits (full binary) dataBits7 = 1, // 7 data bits } dataBits; // SIZEOF: 2 bytes typedef enum _parity { parityNone = 0, // No parity parityEven = 1, // Even parity parityOdd = 2, // Odd parity } parity; // SIZEOF: 2 bytes typedef enum _stopBits { stopBits1 = 0, // 1 stop bit stopBits2 = 1, // 2 stop bits } stopBits; // SIZEOF: 2 bytes typedef enum _flowControl { flowRtsCts = 0x0001, // RTS/CTS flow control flowXonXoff = 0x0002, // XON/XOFF flow control } flowControl; // SIZEOF: 2 bytes typedef enum _comFlags { portUseModem = 0x0001, // Use modem protocols portLockBaudRate = 0x0002, // No auto-baud detection portBios = 0x0004, // Use BIOS INT14 interface portHalfDuplex = 0x0008, // Local echo - full duplex portCrLf = 0x0010, // Use CR/LF for CR's or LF's portDtrHangup = 0x0020, // Drop DTR to hangup? portBsDestructive = 0x0040, // Destructive backspace portBsSendsDel = 0x0080, // BS key sends DEL key } comFlags; // SIZEOF: 2 bytes typedef struct _portSetup { SWORD portComPort; // COM port # (1 - 4) WORD portBaudRate; // Baud Rate (300-115,200) WORD portDataBits; // Data Bits (7 or 8) WORD portParity; // Parity setting (N, E or O) WORD portStopBits; // Stop Bits (1 or 2) WORD portFlowControl; // Flow Control (RTS or XOFF) WORD portFlags; // Port config flags } portSetup; // SIZEOF: 14 bytes //======================================================================== // // NOTE: If the header says that the FILE is password protected // (phoneHeader.phdFlags & phdPasswordRestricted), then the password field // (phoneHeader.phdPassword) in the header is encrypted // // If the header says that certain ENTRIES are password protected // (phoneHeader.phdFlags & phdPasswordProtectedEntries), then some or all // entries in the file are encrypted. To tell if an entry is password // protected, phoneEntry.phoFlags & phoProtectedEntry will be non-zero. // // The fields encrypted are the system name, phone number, user-id, user // password, notes, and system ID (directory) are encrypted as well. // // No matter which flag is set, the password to gain access is encrypted in // the header. // // TeleGrafix is NOT publishing the encryption algorithm used. // // A directory entry is considered blank if the system name field // (phoneEntry.phoName) is blank. // //======================================================================== ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.2.5 ■ The Dialing Window ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ The Dialing Window appears when RIPterm is dialing the modem. This window displays the number of seconds elapsed, the time the first dialing started, the time of the current dialing started, the telephone number, the time remaining until this dialing is aborted, and the status of the current dialing attempt. ┌────────────────────────────────────────────────────────┐ │┌──────────────────────────────────────────────────────┐│ ││ Dialing Host System ││ │├──────────────────────────────────────────────────────┤│ ││ ┌───────────────────────────────────┐ ││ ││ System Name │ The Vector Sector │ ││ ││ └───────────────────────────────────┘ ││ ││ ┌───────────────────────────────────┐ ││ ││ Phone Number │ 714/379-2133 │ ││ ││ └───────────────────────────────────┘ ││ ││ ┌──────────┐ ┌──────┐ ││ ││ Start Time │ hh:mm:ss │ Attempt # │ 1 │ ││ ││ └──────────┘ └──────┘ ││ ││ ┌──────────┐ ┌────┬─┐ ││ ││ Current Time │ hh:mm:ss │ Time Remaining │ 42 ││ ││ ││ └──────────┘ └────┴─┘ ││ ││ ┌───────────────────────────────────┐ ││ ││ Status │ Dialing... │ ││ ││ └───────────────────────────────────┘ ││ ││ ┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐ ││ ││ │ OK ││ Cancel ││ Cycle ││ Remove ││ Help │ ││ ││ └────────┘└────────┘└────────┘└────────┘└────────┘ ││ │└──────────────────────────────────────────────────────┘│ └────────────────────────────────────────────────────────┘ Each field is described more fully in the following sections: ┌─────────────┐ │ System Name │ └─────────────┘ This field displays the name of the host that is being dialed. This field may be blank if you choose to dial via Manual Connect. ┌──────────────┐ │ Phone Number │ └──────────────┘ This displays the telephone number that is being used when dialing the designated host. It is shown in this field exactly as it is transmitted to the modem. ┌────────────┐ │ Start Time │ └────────────┘ This field shows the time that the modem began trying to dial out. As the modem cycles through the various attempts to connect, this time does not change. The format of this field is HH:MM:SS (hours, minutes, seconds). ┌──────────────┐ │ Current Time │ └──────────────┘ This field displays the current time. This field will constantly change as the dialing progresses. It is intended to give you a visual reference to the time, compared to the start time. ┌───────────┐ │ Attempt # │ └───────────┘ This shows how many tries have been made thus far for all phone numbers selected. If the host is busy, then it will try again after a brief pause. The maximum number of attempts is set in the Modem Setup dialog. ┌────────────────┐ │ Time Remaining │ └────────────────┘ This message displays how many seconds remain before the current dialing attempt will terminate. By default, redial time is set to 45 seconds, but this can be changed from within the Modem Setup dialog box. High speed modems, or long distance calls frequently need more than 45 seconds to complete an outgoing call. To the right of this field are two small arrows, an UP arrow, and a DOWN arrow. These are for temporarily increasing or decreasing the redial time for the rest of these dialing attempts. ┌────────┐ │ Status │ └────────┘ Periodically through the dialing process, various status messages may need to be displayed to give you more information on what is going on. Of the various messages, you might see things like, "Host is Busy. Redialing...", or "Time elapsed without connection". This is used to tell you what is going on. ┌────────┐ │ OK │ └────────┘ This returns you to the session screen. It does NOT abort the current dialing attempt. This is handy if the connection is beginning, and you need to access another feature in RIPterm. ┌────────┐ │ Cancel │ └────────┘ This option will stop dialing. You will be returned to the session screen. Any systems that you were trying to dial will remain selected the next time you enter the Dialing Directory. ┌────────┐ │ Cycle │ └────────┘ This is used when you have selected some entries to dial. By clicking on Cycle, it will stop calling whichever host is currently being dialed, and will go to the next host selected in your dialing list and begin to dial that number. If you are only dialing one host, this will stop the current dialing attempt and re-dial the same number again. ┌────────┐ │ Remove │ └────────┘ This option will remove an entry from your dial list. What this means is that whatever host is currently being dialed will have its dialing attempt stopped, and then it will be de-selected in the Dialing Directory, then RIPterm will attempt to dial the next selected number (if any). If no more entries are available in the dialing list, RIPterm will abort all dialing and return to the session screen. ┌────────┐ │ Help │ └────────┘ The 5,023,109th time you click this button, it will do exactly the same thing it did in all the previous attempts. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.3 ■ Keystroke Macro Editor ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Keystroke Macros are your own keyboard shortcuts. For example, you can instruct RIPterm to make the F5 key type your user-id and press <ENTER> for you. This would allow you to log-on quickly by simply pressing a single key. RIPterm's macro system is easy to use, and very powerful! You can save your macro keys to the default macro file (RIPTERM.MAC), or if you need to have multiple macro configurations, you can save macros to different files. When you choose the macro editor option, a dialog box similar to the following will be displayed: ┌──────────────────────────────────────────────────────────────────────────┐ │┌────────────────────────────────────────────────────────────────────────┐│ ││ Keystroke Macro Editor ││ │├────────────────────────────────────────────────────────────────────────┤│ ││ ││ ││ Common Macros (■) ││ ││ System Macros ( ) ││ ││ Terminal Emulation Macros ( ) ││ ││ ││ │├────────────────────────────────────────────────────────────────────────┤│ ││ Keystroke ... Macro Replacement Text ││ ││┌────────────────────────────────────────────────────────────────────┬─┐││ │││ Control-Shift-S ... Sample Macro^m ││││ │││ ├─┤││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ │ │││ │││ ├─┤││ │││ ││││ ││└────────────────────────────────────────────────────────────────────┴─┘││ ││ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌─────┐ ┌──────┐ ││ ││ │ OK │ │ Edit │ │ Add │ │Delete│ │ Save │ │ Load │ │Clear│ │ Help │ ││ ││ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └─────┘ └──────┘ ││ │└────────────────────────────────────────────────────────────────────────┘│ └──────────────────────────────────────────────────────────────────────────┘ When selecting macros to edit/delete, you may click on an existing macro, then click EDIT or DELETE. To select multiple macros to edit or delete, click on each macro while holding down the SHIFT key. RIPterm uses several different macro files. Common Macros are stored in RIPTERM.MAC. System Macros are macros for a particular host, and are named using the System Dir field. The Terminal Emulation files included with RIPterm are VT102.MAC and ANSI.MAC. You may store multiple macros into Macro .MAC Files for future use. You may have as many macro files as you wish limited only by the amount of available disk space. System Macros have the highest precedence, then Common Macros, and finally Terminal Emulation. For example, if you have a System Macro that uses the SAME KEYSTROKE as a Common Macro, it OVERRIDES the Common Macro. SYSTEM MACROS ARE NOT CURRENTLY AVAILABLE IN THIS RELEASE OF RIPTERM!!! NOTE: RIPterm uses most all of the Alt and Ctrl-Alt combinations for its menus. If you create a macro using these key combinations, they will NOT work, because they are overridden by the menus. RIPterm specifically does NOT make use of any of the function keys, so you have them all to yourself for keystroke macros. ┌───────────────┐ │ Common Macros │ └───────────────┘ Common macros are available at all times at the session screen in RIPterm. ┌───────────────┐ │ System Macros │ └───────────────┘ SYSTEM MACROS ARE NOT CURRENTLY AVAILABLE IN THIS RELEASE OF RIPTERM!!! System Macros are macros for a particular host, and are stored in the RIPterm directory. The name of the macro file is the same as the System Dir with .MAC on the end. For example, if you have VECTSECT in your System Dir field in the Dialing Directory, then the System Macro file would be VECTSECT.MAC. NOTE: The System Macros are loaded automatically when you dial that host. If you don't have a System Dir entered for the current host, the System Macros will not be loaded. ┌───────────────────────────┐ │ Terminal Emulation Macros │ └───────────────────────────┘ RIPterm supports two Terminal Emulation Macro sets: VT-102 and ANSI. These are loaded automatically, depending on the Terminal Emulation setting in either Modem Setup or the current Dialing Directory entry being dialed. ┌────┐ │ OK │ └────┘ OK exits the Keystroke Macro Editor and returns to the session screen. ┌──────┐ │ Edit │ └──────┘ Edits any selected macros. If no macros are selected, you are prompted to select some first. ┌─────┐ │ Add │ └─────┘ This option is for adding more macros to the currently selected macro type. When you click Add, you are first prompted for the keystroke to assign the macro to. For example, if you wanted to record a macro for the F5 key, simply press the F5 key. You may specify a combination of CTRL, ALT or SHIFT keys as well. RIPterm's macro editor allows you to define literally hundreds of macros using nearly as complex a keystroke as you want. WARNING: You would never want to create macros using just a single letter, or using control characters [such as CTRL-M (return) or CTRL-H (backspace)]. If you did, you would not be able to type without these macros being triggered. This would make it difficult to use RIPterm with the keyboard. NOTE: RIPterm uses most all of the Alt and Ctrl-Alt combinations for its menus. If you create a macro using these key combinations, they will NOT work, because they are overridden by the menus. RIPterm specifically does NOT make use of any of the function keys, so you have them all to yourself for keystroke macros. After entering the keystroke, enter the text that should be sent to the host (or the modem) if this macro is entered. In other words, enter the text that you want to be associated with this macro. For example, if you wanted to send the text "Hello World" to the host when you press F5, simply type in "Hello World". You may enter control characters into your macros by using a caret (^), followed by the letter of the control key you want to send. For example, a CTRL-C would be represented as ^C. A carriage return (<ENTER>) is specified as ^M. Also, an ESCAPE is generated by the sequence ^[ ... There are a number of different combinations of CONTROL CHARACTERS that you may choose from (see Section 5.3.1 for more details). In addition to control characters, you can also insert TEXT VARIABLES or POPUP PICKLISTS into your macros. Refer to the RIPscrip Language specification for details on these features. To exit the ADD mode, simply press the <SPACE> key. ┌────────┐ │ Delete │ └────────┘ This will delete the currently selected macros. You are asked if you are really sure you want to delete them. ┌──────┐ │ Save │ └──────┘ Enter the filename that you want to save your defined macros to. The default for Common Macros is RIPTERM.MAC. If you do not wish to store your existing macros in the default macro file, you can save them to a different file. ┌──────┐ │ Load │ └──────┘ Enter the filename of the macro .MAC file you wish to load. Macro files are contained in the current RIPTERM directory unless you have some saved elsewhere. The default file is RIPTERM.MAC, or you can specify your own macro file. ┌───────┐ │ Clear │ └───────┘ This option removes ALL macros in the currently selected macro type (System, Common, or Terminal Emulation). You are asked if you are really sure you want to delete them. ┌──────┐ │ Help │ └──────┘ Clicking Help will probably bring up a blank screen. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.3.1 ■ Control Characters in Keystroke Macros ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Not all hosts will allow you to use control characters. Regardless of that, the capability to send any control character exists in the Keystroke Macro Editor. The most commonly used control characters are: INDIVIDUAL CONTROL CHARACTERS VALUE --------------------------------------------------------- ^@ ... NUL ... Null byte 0 ^A ... SOH ... Ctrl-A (start of block) 1 ^B ... STX ... Ctrl-B (aux. start of block) 2 ^C ... ETX ... Ctrl-C (user break) 3 ^D ... EOT ... Ctrl-D (end of transfer) 4 ^E ... ENQ ... Ctrl-E (enquire) 5 ^F ... ACK ... Ctrl-F (Acknowledgment) 6 ^G ... BEL ... Ctrl-G (bell/beep) 7 ^H ... BS ... Ctrl-H (backspace) 8 ^I ... HT ... Ctrl-I (horizontal tab) 9 ^J ... LF ... Ctrl-J (line feed) 10 ^K ... VT ... Ctrl-K (vertical tab) 11 ^L ... FF ... Ctrl-L (top of form/clear screen) 12 ^M ... CR ... Ctrl-M (carriage return) 13 ^N ... SO ... Ctrl-N (shift out) 14 ^O ... SI ... Ctrl-O (shift in) 15 ^P ... DLE ... Ctrl-P 16 ^Q ... DC1 ... Ctrl-Q (resume data transmission/XON) 17 ^R ... DC2 ... Ctrl-R 18 ^S ... DC3 ... Ctrl-S (pause data transmission/XOFF) 19 ^T ... DC4 ... Ctrl-T 20 ^U ... NAK ... Ctrl-U (no acknowledgment/NAK) 21 ^V ... SYN ... Ctrl-V (synchronize byte) 22 ^W ... ETB ... Ctrl-W 23 ^X ... CAN ... Ctrl-X (cancel/CAN) 24 ^Y ... EM ... Ctrl-Y 25 ^Z ... SUB ... Ctrl-Z (end of file) 26 ^[ ... ESC ... Escape character (ESC) 27 ^\ ... FS ... 28 ^] ... GS ... 29 ^_ ... US ... 31 SPECIAL KEYSTROKES ---------------------- ^[[A ... Up arrow ^[[B ... Down arrow ^[[C ... Right arrow ^[[D ... Left arrow ^[[H ... Home key ^[[K ... End key ^[[L ... Control-Home ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.4 ■ View Scrollback Buffer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Scrollback mode allows you to review previously displayed text information that has come across the modem. You may set the scrollback buffer size to 0k - 9999k. Within scrollback, you may choose from the following options: ■ SAVE current page to a text file ■ SAVE entire buffer to a text file ■ PRINT the current buffer page, or the entire buffer ■ SEARCH for a particular piece of text ■ SEARCH again for a previously searched for text string At the top of the scrollback screen are a number of icons for the above commands. In addition, there are icons for scrolling up, down, paging up and down or moving to the beginning or end of the buffer. NOTE: The scrollback buffer filters out ANSI color codes and RIPscrip graphics for an uncluttered text display. ┌──────────────────────────────────────────────────────────────────────────┐ │┌────────────────────────────────────────────────────────────────────────┐│ ││ Scrollback Buffer ││ │├──────────────────────────────────────────────────────────────────────┬─┤│ ││ │││ ││ ├─┤│ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ │ ││ ││ATZ │ ││ ││OK │ ││ ││AT&F │ ││ ││OK │ ││ ││AT&C1&D2 │ ││ ││OK │█││ ││AT&W ├─┤│ ││OK │││ │└──────────────────────────────────────────────────────────────────────┴─┘│ │ ┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐┌────────┐ │ │ │ OK ││ Search ││ Again ││ Write ││ Print ││ Clear ││ Help │ │ │ └────────┘└────────┘└────────┘└────────┘└────────┘└────────┘└────────┘ │ └──────────────────────────────────────────────────────────────────────────┘ ┌────────┐ │ OK │ └────────┘ Clicking OK returns you to the session screen. ┌────────┐ │ Search │ └────────┘ Search looks through the entire Scrollback Buffer for a certain word or phrase, starting at the beginning of the buffer. The search string is highlighted in yellow when it is found. To find the next occurrence of the word or phrase, click Again. The search is NOT case sensitive. ┌────────┐ │ Again │ └────────┘ Again finds the next occurrence of the word or phrase specified in Find. It will continue to the end of the buffer, and then say "No more matches found". ┌────────┐ │ Write │ └────────┘ Write allows you to save the contents of the Scrollback Buffer. ┌──────────────────────────────────────────────────────────────┐ │┌────────────────────────────────────────────────────────────┐│ ││ Write Scrollback to What File? ││ │├────────────────────────────────────────────────────────────┤│ ││ ┌───────────────────────────────────────────┐ ││ ││ Filename │ │ ││ ││ └───────────────────────────────────────────┘ ││ ││ ┌────────────────┐ ┌────────────────┐ ││ ││ ┌─┤ File Control ├──┐ ┌─┤ Save What? ├──┐ ││ ││ │ └────────────────┘ │ │ └────────────────┘ │ ││ ││ │ │ │ │ ││ ││ │ (■) Append to File │ │ (■) Current Page │ ││ ││ │ ( ) Overwrite File │ │ ( ) Entire Buffer │ ││ ││ │ │ │ │ ││ ││ └─────────────────────┘ └─────────────────────┘ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ │└────────────────────────────────────────────────────────────┘│ └──────────────────────────────────────────────────────────────┘ The Filename field is the name of the file to save the buffer to. You can enter full path and filename information here. If you do NOT specify a path, the file is saved into the RIPterm directory. The File Control option lets you tell RIPterm what to do if a file by the same name already exists. If you select Append, RIPterm will add on to the end of the file if it already exists, or create a new file if it doesn't exist. If you select Overwrite File, RIPterm will erase any existing file before writing the new data to the file. The Save What? options lets you tell RIPterm how much of the buffer you wish to save. You can save just the Current Page (as shown in the Scrollback Buffer screen), or the Entire Buffer. OK, Cancel, and Help function as expected. ┌────────┐ │ Print │ └────────┘ The print option has three options: Current Page, Entire Buffer, and Page Eject. The Current Page and Entire Buffer options let you tell RIPterm how much of the buffer you wish to print. You can print just the Current Page (as shown in the Scrollback Buffer screen), or the Entire Buffer. The Page Eject option is for ASCII, Epson, and HP LaserJet printers. It sends the correct command to eject the page from the printer. Postscript printers are not affected by this setting. ┌────────┐ │ Clear │ └────────┘ This option lets you clear the entire contents of the Scrollback Buffer. You are prompted to be sure you want to clear the buffer. ┌────────┐ │ Help │ └────────┘ Clicking Help reveals the secrets of the Bermuda Triangle. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.5 ■ External Applications ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ RIPterm has a powerful feature which allows it to link-in external MS-DOS programs into RIPterm to do things quickly and easily from within the software. You are allowed up to ten different applications to be programmed into RIPterm. At the touch of a key you can fire off one of your application programs to do things like run Microsoft Windows (tm), run text editors, offline mail readers or view graphics files. What makes RIPterm's application system even more powerful is that you can link application programs to particular file extensions. The significance of this may not be readily apparent until you think about what happens when you download files off of a host with the same extension as that of another application program. For example, let's say that application #5 is defined as being your PCX file viewer program. If you link that application to files with a .PCX extension, then whenever you download a PCX file your viewer will be run immediately instructing it to view the file you just downloaded! To make situations even nicer, RIPterm will return to MS-DOS (text mode) and swap as much of RIPterm's data out of your 640k conventional memory as possible before running your application. When running applications, RIPterm frees all but about 40k that must remain to reload RIPterm when your application is finished. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.5.1 ■ The Application Editor ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ To configure External Applications, select Edit External Application from the File menu. You will see this dialog box: ┌─────────────────────────────────────────────────────────┐ │┌───────────────────────────────────────────────────────┐│ ││ Edit External Applications ││ │├───────────────────────────────────────────────────────┤│ ││ ┌────────────────────────────────────┬─┐ ││ ││ Current App │1. <blank> ││ ││ ││ └────────────────────────────────────┴─┘ ││ │├───────────────────────────────────────────────────────┤│ ││ ┌──────────────────────────────────────┐ ││ ││ Description │Edit a text file │ ││ ││ └──────────────────────────────────────┘ ││ ││ ┌──────────────────────────────────────┐ ││ ││ Command Line │EDIT.COM $FILENAME$ │ ││ ││ └──────────────────────────────────────┘ ││ ││ ││ ││ [ ] Auto Execute [ ] Pause After [ ] Protocol App ││ ││ ││ ││ ┌────────────────────┐ ┌────────────────────┐ ││ ││ ┌─┤ Auto Execution ├─┐ ┌─┤ Protocol Options ├─┐ ││ ││ │ └────────────────────┘ │ │ └────────────────────┘ │ ││ ││ │ │ │ ┌───────┐│ ││ ││ │ ┌────┐ │ │ Upload Batch│ ││ ││ ││ │ File Extension │ │ │ │ ├───────┤│ ││ ││ │ └────┘ │ │ Download Batch│ ││ ││ ││ │ │ │ ├───────┤│ ││ ││ │ ┌──────┬─┐ │ │ Trigger String│ ││ ││ ││ │ Action │Never ││ │ │ └───────┘│ ││ ││ │ └──────┴─┘ │ │ │ ││ ││ │ │ │ [ ] Ask Filename │ ││ ││ │ │ │ │ ││ ││ └────────────────────────┘ └────────────────────────┘ ││ ││ ┌────────┐ ┌────────┐ ┌────────┐ ││ ││ │ OK │ │ Cancel │ │ Help │ ││ ││ └────────┘ └────────┘ └────────┘ ││ │└───────────────────────────────────────────────────────┘│ └─────────────────────────────────────────────────────────┘ The Current App field lists the name of the application you are currently editing. Application numbers go from 1 to 10. We recommend that application #1 be used for an external text editor. This way, if a host instructs your terminal to edit a text file by running application #1, RIPterm can handle it. For more information on how a host can run application programs on your local terminal, see the following sections. ┌─────────────┐ │ Description │ └─────────────┘ The Description field is where you enter the name of the Current App. This is the name that appears after the number in the Current App field. ┌──────────────┐ │ Command Line │ └──────────────┘ This is how you define what program to run and how to run it. Type the name of the program (or a batch file) in this field along with any command line parameters you wish to pass along to the application. If the program is not accessible in your MS-DOS PATH= statement, you may give the full path and program name in this field. Refer to your DOS manual for more details about the PATH setting. In addition to being able to specify which program to run, you can also utilize one of RIPterm's most advanced features to customize it to your needs. This is the ability to pass along the filename just downloaded to an external application. For example, if you were going to edit a text file, you need to tell your editor what file you wish to edit. In the screen displayed above showing the Application Editor, you will notice the Command Line of "EDIT.COM $FILENAME$". Notice the $FILENAME$ portion of the command line. When you try to run this particular application, the phrase $FILENAME$ will be replaced with a filename of your choice. This is a simplistic way of looking at it. $FILENAME$ is a RIPterm text variable (refer to the RIPscrip Language Specification for info on Text Variables). Text variables are like Keystroke Macros - they get replaced with another string. Depending on the variable, it might be replaced with some information that RIPterm knows (like the date), or it might insert a string that you type in. In the case of $FILENAME$, RIPterm will pop-up a dialog box on your screen allowing you to enter the filename to edit. The $FILENAME$ text variable has a special property in RIPterm. In the External Application system, if you set an application to trigger to a downloaded file extension, this text variable is automatically filled in with the name of the file you just downloaded, thus saving you from having to type in the filename at all. You are not only limited to just simple text variables. You can also use "Pick-List" definitions (refer to the RIPscrip Language Specification for more details). This allows you to pop-up a listing of available choices. You might conceivably use this to specify different command-line switches to modify the behavior of a particular program - something that may be different each time you run the program. You do not need to place a ^M at the end of your command line. A carriage return will be added automatically when the program is run. NOTE: Leaving the command line blank will result in a Jump to DOS, just as if you had selected it from the Files menu. ┌───────────────────────┐ │ Auto Execute Checkbox │ └───────────────────────┘ If Auto Execute is selected, in enables the Auto Execution options in the lower left corner of the dialog box. Refer to that section below. ┌──────────────────────┐ │ Pause After Checkbox │ └──────────────────────┘ When the application is finished, and is ready to go back to RIPterm, you have the option of inserting a pause before RIPterm resumes running. This is helpful if you are using a program that does not pause when it is done. A good example is the TYPE program in DOS. If you use TYPE do display a text file, it will splat it to the screen, and then return you to RIPterm so fast you wouldn't be able to read the information at all. By selecting Pause After, you will have to press a key before RIPterm resumes. ┌───────────────────────┐ │ Protocol App Checkbox │ └───────────────────────┘ This option is not available in the current release of RIPterm. It is for enabling the Protocol Options in the lower right corner of the dialog. ┌────────────────┐ │ Auto Execution │ └────────────────┘ As stated previously, you have the ability to link particular application programs to files with certain extensions. For example, if you wanted to link a PCX image viewer to files with .PCX extensions, simply enter "PCX" in this field. Then whenever you download a file with a .PCX extension, the given application will run and the $FILENAME$ text variable will be replaced with the filename of the file you just downloaded! Neat, huh? There are three ways that applications can link to downloaded files. They can be run NEVER, ALWAYS, or RIPterm can ASK you if you want to run the application. ┌────────────────┐ │ Action - Never │ └────────────────┘ When this option is chosen, the Extension field of the application will be ignored. In other words, the application you are editing will never be automatically executed for particular files that you download. Use this option to completely disable auto-download application execution for a given application. ┌──────────────┐ │ Action - Ask │ └──────────────┘ When this option is selected and the File Extension field contains a DOS Extension, RIPterm will check every file that you download to see if it has the same extension and if so, it will pop-up a window on your screen asking if you wish to run the given application on the file you just downloaded. This is the most "secure" way of using application mode. This gives you complete control over what applications get run. ┌─────────────────┐ │ Action - Always │ └─────────────────┘ This option, when combined with the Extension field, will automatically run the configured application every time a file with the configured extension is downloaded. You will not be prompted if you want to run the application on the file -- it will be done for you immediately when the download is complete. ┌────┐ │ OK │ └────┘ Clicking OK approves any modifications you might have made in the Application Editor and saves them to RIPTERM.APP for future use in RIPterm. ┌────────┐ │ Cancel │ └────────┘ This option abandons all modifications in the Application Editor, restoring the application to the state it was in previous to entering the Application Editor. ┌──────┐ │ Help │ └──────┘ This option displays a help screen to assist you in editing applications. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.5.2 ■ Application Text Variables ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ You can run applications directly from your keystroke macros if you wish. This makes your application programs accessible at the touch of a key. This means that you don't have to pull down the EXTERNAL menu and select "Run Application" every time you wish to run your favorite programs. Similar in concept to the $FILENAME$ text variable described above, you can also insert application text variables directly into your keyboard macros in RIPterm. When executed the macro will automatically run the designated application. Application Text Variables are $APP0$ (Current App #1) through $APP9$ (Current App #10). If a Current App slot is blank, RIPterm will simply execute a DOS Shell. Unlike the $FILENAME$ text variable though, $APP0$ through $APP9$ do not get replaced with any piece of text. For example, if you had the following macro set up: F5: HELLO $APP0$ WORLD Then whenever you press the F5 key in RIPterm, your macro would send the sequence "HELLO " to the host, then run application #0 (presumably your text editor), then after that is complete, transmit " WORLD" to the host as the final part of your macro. Note that we did not use the $FILENAME$ variable inside the macro itself - that is specified in the command line portion of the application editor. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.6 ■ Chat Mode ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────────────────────┐ │┌────────────────────────────────────────────────────────────────────────┐│ ││ User-to-User Chat ││ │├────────────────────────────────────────────────────────────────────────┤│ ││┌──────────────────┐ ││ │││ Remote User │ ││ ││└──────────────────┘ ││ ││┌──────────────────────────────────────────────────────────────────────┐││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ ││└──────────────────────────────────────────────────────────────────────┘││ ││┌──────────────────┐ ││ │││ Local User (You) │ ││ ││└──────────────────┘ ││ ││┌──────────────────────────────────────────────────────────────────────┐││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ │││ ││└──────────────────────────────────────────────────────────────────────┘││ ││ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────┐ ┌──────────┐ ││ ││ │ Cancel │ │ Erase │ │Scrollback│ │ Log File │ │ Help │ ││ ││ └──────────┘ └──────────┘ └──────────┘ └────────────┘ └──────────┘ ││ │└────────────────────────────────────────────────────────────────────────┘│ └──────────────────────────────────────────────────────────────────────────┘ Chat Mode is designed for when two RIPterm users connect with each other directly. If Chat is not used for typing messages to each other, by default you can not see your own typing, only what the other user types. If you turn on Local Echo in Modem Setup to see your own typing, and you both type at the same time, your typing will be mixed with the other user, and will be unreadable. Another problem is that when you press enter to begin a new line, the cursor, by default, moves back to the beginning OF THE SAME LINE as you were just typing on. Rather than text scrolling down the screen, you just keep overwriting the same line. You can turn on Add CR/LF in Modem Setup to fix this problem. The reason for these differences is that RIPterm is usually set up to connect to a host system, rather than another terminal program. Since these require different settings, it is inconvenient (when connecting to another user) to have to change the Modem Setup. And you still have the problem of typing at the same time mixing in with the other user's typing. Chat solves the configuration problems of connecting directly with another terminal user. Typing by each user goes into separate windows, and the modem settings for Local Echo and Add CF/LF are temporarily enabled so that you can converse conveniently and easily with the remote user. ┌──────────┐ │ Cancel │ └──────────┘ The CANCEL button exits Chat. ┌──────────┐ │ Erase │ └──────────┘ The ERASE button clears both windows. Handy for keeping conversations private if someone walks up while you are chatting. ┌──────────┐ │Scrollback│ └──────────┘ The SCROLLBACK button takes you into the history of what you have both been typing. See Section 5.4 for detailed information on the Scrollback Buffer. ┌────────────┐ │ Log File │ └────────────┘ The LOG FILE button allows you to capture your conversation to a file on the disk for later review. If you missed logging part of the conversation, you can also go into the Scrollback Buffer to save the conversation to disk. ┌──────────┐ │ Help │ └──────────┘ The HELP button causes a team of TeleGrafix engineers to be beamed directly to your location - NOT! ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.7 ■ Text Variables ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ One of the special features of RIPterm is working with text variables. A text variable is a string of text that RIPterm knows represents some information, or can perform an action. For example, the text variable $DATE$ represents the current date on your system. The host may ask your system the values of one or more of these variables, and if your terminal knows that particular text variable, it will send that information to the host. There are two types of text variables. There are built-in text variables that RIPterm will ALWAYS know about. They are part of RIPterm, and a host can always query them. These types of variables are defined to provide the host with information about your terminal software and its configuration, not something about you. In other words, built-in text variables can be used to send a piece of information to the host saying "what time is it", or "what is the date where you are", or "where is the mouse located?". They function exactly like any other text variable except that RIPterm knows they exist even if you haven't created them. By nature, the values that these variables return to the host are rarely the same. They change depending on the nature of each variable. For a list of built-in text variables, refer the "RIPscrip Language Specification". There are also user-defined text variables that can contain a variety of information depending on what was entered at the time the variable was created. For example, the host might ask you what the contents of the $FULL_NAME$ variable is, and if RIPterm doesn't know, it pop-ups a dialog box on the screen and asks you about it. RIPterm will remember that information for the next time it is needed by a host. You may use either the built-in text variables or the user-defined text variables at any place that allows text variables. The valid places are in Keystroke Macros, External Applications, Pop-Up Pick-Lists, and button return strings. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.7.1 ■ User-Defined Text Variables ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ User-defined text variables are text variables that you create. A host might tell you, "Create this text variable for me", or you might create one yourself by selecting Create Variable from the Options menu. The difference is negligible, but a brief explanation of their purpose might prove insightful. User-defined text variables can store information permanently or temporarily. This information can then be re-used without you having to type it in again. The time-saving aspect of this feature is only one small benefit of its ability. Having the capability to store information over potentially long periods of time is VERY useful! There are three types of user-defined text variables: 1. Permanent (database) variables 2. Temporary (memory resident) variables 3. Volatile (discardable) variables The significance of each type of variable is described below: ┌────────────────────────────────┐ │ Permanent (Database) Variables │ └────────────────────────────────┘ Permanent text variables are saved in a local RIPterm database file called RIPTERM.DB. This file is automatically indexed for high-speed retrieval of information. This file is located the RIPterm directory. Any permanent text variable that is created is stored in this file. A permanent text variable can be created by yourself manually by choosing option Create Variable from the Options menu, or interactively by a host via special RIPscrip commands (RIP_DEFINE and RIP_QUERY). Once a variable is created, they are stored forever (unless you delete the database file). These variables may be accessed by yourself, or a host (if you permit it). This can be quite useful in preventing you from having to type the same information in over and over again in future online sessions. This can be used to sign-up on a host without having to type a single character. Sound too good to be true? With text variables, it can be done! ┌───────────────────────────────────────┐ │ Temporary (Memory Resident) Variables │ └───────────────────────────────────────┘ Temporary (memory resident) text variables are accessed like permanent text variables, except that they are not stored in the database file. They are stored in your computer's memory. They remain until you disconnect from the host. Other than that, they are identical in nature to permanent text variables. Until you exit RIPterm, they will exist and will be accessible to you (via macros), or to a host. NOTE: If your modem does not support Carrier Detect, then memory resident text variables will not be erased until you exit RIPterm! Since queries of memory resident text variables do not have Data Security applied to them, it is possible that one host could get another host's variables. Solution: Make sure Carrier Detect (CD) works on your modem! See Section A.5.4 ■ My Modem is Always On-Line (Resuming Previous On-line Session) for details. ┌──────────────────────────────────┐ │ Volatile (Discardable) Variables │ └──────────────────────────────────┘ A volatile (discardable) text variable is somewhat different than the previously described text variables. They are not stored in memory or in the database file at all. They are used solely to ask you a simple question, transmit the information to the host, then the contents of the variable are erased. Why would you (or a host) want something like this? This question is answered differently for YOU or for a host. A volatile text variable for you can be useful during keystroke macros. Let's say you have a very complex macro that you've devised for doing something in a game (for example) to another user on the host. Should you have to edit the macro each time you want to use it for someone different? Of course not! Simply place a reference to an "undefined" text variable in your macro. When you execute the macro, RIPterm will look through its list of database and memory-resident text variables, and if it doesn't find the variable, RIPterm pops up a dialog box asking you to enter data for that variable. Whatever you type into that dialog box for the variable is replaced in your macro right then and there, and is immediately discarded after the macro is finished. For example, let's say you have the following macro set up to attack another player in a game on some host you call: F2: ATTACK $USERNAME$ FIERCELY^m When you execute macro F2, RIPterm will look in through its text variables for $USERNAME$. If it doesn't find it, it pops up a window asking you to enter the following: ╔════════════════════════════════════════════════════════╗ ║ Please enter "USERNAME" ║ ║ ┌──────────────────────────────────────────────────┐ ║ ║ │ █ │ ║ ║ └──────────────────────────────────────────────────┘ ║ ╚════════════════════════════════════════════════════════╝ Simply type in the name of the user you wish to attack, and the result is plugged into the rest of the string, and sent to the host in place of the variable name $USERNAME$. After that, the remainder of the macro will be transmitted to the host (i.e., "ATTACK BEASTHEAD FIERCELY") followed by a carriage return (^M is the carriage return). Once the macro is complete, the contents of USERNAME are erased (unless it was a previously defined permanent (database) or a temporary (memory resident) text variable). A host can also ask you to enter something for a volatile text variable. Why would a host want to do this, and not save the response somewhere? What if you asked a host to download a file. You could be presented with a menu like this: ╔═══════════════════════════════════════════╗ ║ File Download ║ ║ ┌─────────────┐ ┌────────────────────┐ ║ ║ │ Protocols │ │ Enter Filename │ ║ ║ ├─────────────┤ └────────────────────┘ ║ ║ │ ( ) X-Modem │ ╔════════════════════╗ ║ ║ │ ( ) Y-Modem │ ║ Begin Download ║ ║ ║ │ (■) Z-Modem │ ╚════════════════════╝ ║ ║ │ ( ) Kermit │ ┌────────────────────┐ ║ ║ └─────────────┘ │ Cancel Download! │ ║ ║ └────────────────────┘ ║ ╚═══════════════════════════════════════════╝ The options on the left allow you to specify the file transfer protocol that you wish to use for the transfer. Enter Filename is the button we're interested in. When you click this button, you would think that RIPterm would pop up a dialog box on your screen, asking you for the filename to download, right? Do you think the filename should be saved in RIPterm's permanent database? Of course not. It is kept temporarily, until you click either "Begin Download" or "Cancel Download!". Its value is used specifically when you click on "Begin Download" whereby RIPterm looks at all of the buttons on the screen and instructs the host to begin the download in a certain way (e.g., using Z-Modem protocol to download file XYZ.EXE for example). As you can clearly see, you would not want the filename field to be part of your permanent RIPterm configuration. In this manner, volatile text variables can be extremely useful! ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ 5.7.2 ■ Data Security ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ All this discussion about user-defined text variables, and hosts asking your terminal for information, you might be concerned about calling some host you've never called before and letting it ask your terminal questions about itself (and YOU)! We don't blame you for thinking this. That is why we've put a security precaution into RIPterm. It is called Data Security. This option (available from General Setup in the Setup menu) allows you to preview any permanent (database) text variable query to determine if you really want to send that information to the host. This allows you to edit a text variable that will be sent to the host so that you are in control at all times of what information is sent to the host. Any variable that is queried by the host will be prompted on your screen allowing you to edit the response. In the event that you do not wish to divulge the information to the host, simply backspace over your text and send a "blank" response. In the event that the host won't permit a blank response, enter something like "NONE" or "N/A". Data Security does not apply to memory resident text variables. These are assumed to belong to the host you are currently connected to. NOTE: If your modem does not support Carrier Detect, then memory resident text variables will not be erased until you exit RIPterm! Since queries of memory resident text variables do not have Data Security applied to them, it is possible that one host could get another host's variables. Solution: Make sure Carrier Detect (CD) works on your modem! See Section A.5.4 ■ My Modem is Always On-Line (Resuming Previous On-line Session) for details. If Data Security is disabled, you may still be prompted to edit your variable, if the host asks for an "interactive query". The host can ask for a non-interactive text variable query, which means that the host will ask your terminal for the contents of a permanent (database) text variable. If the permanent (database) variable exists, it will send the contents to the host without you even knowing that it was sent! In some ways, it is up to the honor of the sysop of the host to set all variable queries as interactive by default. But considering the fact that this is not an entirely "equal" world, having the ability to override variable queries with the Data Security option is quite important. This option defaults to "ON" when RIPterm is installed, and all data queries are secure by default. It is up to you to disable this security measure. Use this option with caution if you're not sure about trusting the hosts you call. As a note worth mentioning, a RIPscrip command to query the contents of your terminal's text variables may be possible if you read an electronic mail message from an ingenious user who knows the RIPscrip language. In situations like this, you would definitely want to use data security mode to prevent unauthorized information transmittal to other people (e.g., credit card numbers, or other information). ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ Appendix A ■ Troubleshooting/Problems ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ Modem communications is not a simple thing. There are many different technical factors that can affect RIPterm, making it work erratically, or unreliably. This section is intended to try to help you figure out what's wrong and get yourself up and running as quickly as possible. Check through the remainder of this section to see if the particular problem you're having is addressed. If you are having some sort of difficulty not covered below (or the instructions that follow do not resolve the problem), contact the TeleGrafix Technical Support department as noted in Appendix C. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.0 ■ RIPtech - COM/Mouse Diagnostic ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There is a utility program included with RIPterm called RIPTECH.EXE. This program finds your mouse and modem, and gives you all the configuration parameters you need. It also helps you to diagnose many of the common problems associated with getting a modem up and running. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.1 ■ Mouse Doesn't Work ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There are a number of potential conflicts that can cause the mouse to not work correctly. The most common ones are listed here. ▒▒▒ A.1.1 ■ "Bus" Mouse Doesn't Work ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Make sure your mouse driver is loaded before you run RIPterm. Without a mouse driver loaded, RIPterm will not be able to use your mouse. Refer to the manual that came with your mouse under the section "Installation" or "Software Installation". Most mouse drivers come in two flavors, a .SYS file, or a TSR program ending in a .COM file extension. A .SYS file must be loaded into your C:\CONFIG.SYS file as any other device driver. An example of loading your MOUSE.SYS driver would be as follows: CONFIG.SYS file: FILES=40 BUFFERS=40 DEVICE=C:\MOUSE\MOUSE.SYS If your mouse came only with a MOUSE.COM driver, then you must edit your C:\AUTOEXEC.BAT file and add a line calling mouse driver so that it can be loaded into memory each time your system boots up. Add a line similar to the one that follows: AUTOEXEC.BAT file: PATH=C:\;C:\DOS;C:\MOUSE PROMPT $P$G MOUSE Configurations vary - refer to the manual that came with your mouse. ▒▒▒ A.1.2 ■ "Serial" Mouse Doesn't Work ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ If you are using a serial mouse, and it is not responding, you might be experiencing a "conflict" between your modem serial port, and your mouse serial port. Under most circumstances, a conflict like this will NOT arise in normal applications programs that don't use both a mouse and a modem simultaneously. Below you should find a list of correct and conflicting modem/mouse configurations. CORRECT COMBINATIONS CONFLICTING COMBINATIONS ----------------------- ------------------------ Modem=COM1 / Mouse=COM2 Modem=COM1 / Mouse=COM3 Modem=COM1 / Mouse=COM4 Modem=COM2 / Mouse=COM4 Modem=COM2 / Mouse=COM1 Modem=COM3 / Mouse=COM1 Modem=COM2 / Mouse=COM3 Modem=COM4 / Mouse=COM2 Modem=COM3 / Mouse=COM2 Modem=COM3 / Mouse=COM4 Rule of Thumb: If the mouse and modem ports Modem=COM4 / Mouse=COM1 are both odd or both even, you are Modem=COM4 / Mouse=COM3 likely to have a conflicting combo. If you are knowledgeable about IBM-PC hardware, and how to install add-on cards, you may be able to circumvent the above recommended port combinations. To do this will require removing the PC cover and changing the interrupt (IRQ) setting of either the modem serial port, or the mouse serial port (if possible). In order to get both the mouse and the modem operating properly, the two serial ports must use different IRQ settings! If none of this makes sense to you, we would recommend sticking to the above recommended layouts. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.2 ■ Modem Isn't Responding ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you have a serial mouse, you may be experiencing a conflict between your mouse and your modem. A serial mouse can be identified if it plugs into one of your IBM-PC communications ports COM1 through COM4. Not all systems have 4 COM ports, so your system may be somewhat different. A serial mouse typically has a 25-pin connector shaped like an elongated "D". Another type of serial mouse has a 9-pin connector also shaped like a "D". Check to make sure your modem is plugged in and turned on (if it is an external modem). Make sure that the serial cable connecting the modem to your computer is securely fastened to the proper COM port. Check your modem settings to make sure they are set correctly. You may edit these settings by selecting Modem Setup from the Setup menu. Things you should check for: 1. Make sure it is set for the correct port (COM1 - COM4) 2. Make sure the baud rate is set to a speed your modem can support (or lower). Settings for this would be 300, 1200, 2400, 9600, 19,200 baud. 3. If the IRQ and Base Port Address of you modem are non-standard, you can change them via Modem Hardware Setup in the Setup Menu. The standard settings are: Port IRQ Addr. ---- --- ----- COM1 4 3F8 COM2 3 2F8 COM3 4 3E8 COM4 3 2E8 Refer to Section A.1.2 ■ Serial Mouse Doesn't Work to determine if you are using an incorrect COM port configuration for your serial mouse and modem. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.3 ■ Noisy Telephone Connections ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you get a noisy telephone connection, the graphics that you see might become garbled in some fashion, and/or text appearing in the Text Window may have garbage characters in it. Since RIPterm does more than simply display pictures on the screen, this can disturb underlying (invisible) operations as well. Solutions: Hang-up and try calling again. Often times, this can resolve the problem. Make sure your phone lines are not running near a device that generates an electrical field, such as a monitor, TV, radio, flourescent lights, incandescent lights, computer power supply, or electro-hydraulic bucking bronco. The field diminishes exponentially with distance. For example, a microwave oven generates a magnetic and electrical field of 750 to 2000 milliGauss (mG) at 1.2 inches, 40 to 80 mG at 12 inches, and 3 to 8 mG at 39 inches (source: Southern California Edison). For those familiar with the Richter Scale, used for measuring earthquakes, the strength of the earthquake goes down exponentially with the distance from the epicenter. If you are experiencing adverse weather conditions (high winds, rain, hurricanes, being sucked into a black hole), or there is such a problem in between where you are and where you're calling (you're in Louisiana, and you're calling New Mexico, and there is a black hole, er, hurricane over Texas) it will often affect line quality. Long distance connections are typically the noisiest connections, especially internationally. Sometimes changing long distance carriers will clear up the problem. You can manually select a different long distance carrier by dialing the prefix for that carrier. For example, to get AT&T service, you would dial 10288# before dialing the phone number. Usually your local phone company will just bill this carrier on your monthly phone bill without any special arrangements. Use of an error-correcting modem, such as those supporting MNP2-4 or better yet v.42 (provided the host you are calling support it), will get rid of the SYMPTOMS of the problem, but you will still experience slower transmissions because the modems are having to resend data because of errors. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.4 ■ Performance Issues ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There are some performance issues in doing sound and communications at the same time. The capacity of your computer to move data around internally is pushed to its limit. The most reliable setup is to have a 16550 serial controller chip in your computer. To see if your system has a 16550 chip, select Debug Info: Comm Port from the Debug menu. In the third line listed in the middle is the phrase "Is16550:" followed by either a "Y" if you have a 16550, or a "N" if you have a 16450 or 8250 serial chip. ▒▒▒ A.4.0 ■ Symptoms of a Performance Problem: ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ If you are having any of the following problems, it could be a symptom of a performance problem: ■ Dropped characters - text received is missing letters. ■ Visual graphics screwups - you can see something is not right. Lines shooting off to weird locations on the screen, RIPscrip commands appearing in the text windows (things like: !|1K|*|w13441232). ■ Interruptions in sound playback - it sounds like a CD player skipping or pausing briefly during playback. ■ Video display is not very fast, or scrolling is slow. ▒▒▒ A.4.1 ■ Solutions to Data Receive Performance Issues: ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ If you are using a modem faster than 2400 baud, you should make sure that RTS/CTS Flow Control is enabled, and Pork Lock is turned on. You may have to reconfigure your modem to work with RTS/CTS and Port Lock, but most come preconfigured for this setup. For info on RTS/CTS and Pork Lock, see Section 4.6.3 ■ Modem General Settings. The best solution to dropped characters and visual graphics screwups (different manifestations of the same problem) is to get a 16550 serial card. It is by far the most reliable and effective solution to the problem. Unfortunately, many computer manufacturers are too cheap to put them in the stock system. Another solution is to reduce your baud rate. Usually, dropped characters only appear when your baud rate is set to 38,400 or higher, but this will vary depending on the speed of your computer. ▒▒▒ A.4.2 ■ Solutions to Sound Playback Performance Issues: ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ If you are experiencing interruptions in sound playback, for example, it sounds like a CD player skipping or pausing briefly during playback, there are several things you can try: ■ Use Mono, not Stereo. Most sounds transmitted and played back while on-line are likely to be Mono anyways, because they are half the size of Stereo files. ■ Use the 8-Bit setting, not 16-Bit. Again, most sounds you are likely to encounter are going to be 8-Bit because they are half the size of 16-Bit files. RIPterm will automatically take a 16-Bit sound and play it at 8-Bit if necessary. ■ Increase the number and size of buffers, especially on a slow CPU or hard disk (local or network). To do this, you can select Medium or Heavy Buffering. If these are not enough, you can select Custom Buffering, where you can control the number of size of the sound buffers. The first thing to try is increasing the number of buffers. If you get up more than 10 buffers and you are still having problem, reduce the number of buffers slightly, and try increasing the size. Only as a last resort should you try to change the timer counts. Increasing the number of timer counts can adversely affect data transmission over the modem. ▒▒▒ A.4.3 ■ Solutions to Video Display Performance Issues: ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ VESA mode on some video cards may be slower than the native mode -- so if a native mode is available, use it! On some video cards, a memory resident driver (TSR) needs to be loaded for VESA support to work for that video card. The fastest resolution to run at is 640 x 480, because less memory is being addressed. Scrolling especially is affected by the resolution. Most video cards also run faster in 256 color mode than in 16 color mode, usually because of the hardware design. Accelerated graphics cards, such as those with the S3 chip, are recommended. They will dramatically speed up the display of the graphics. Also, system with local bus video can make a big difference in display speed. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5 ■ Common Configuration Problems ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ These common problems are easily resolved, and frequently baffle RIPterm users. This is a compilation from our technical support staff on questions they frequently get. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.1 ■ I Can't See What I Type ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If you are NOT connected: ■ You may be configured for the wrong COM port -- see Appendix A.2. ■ You might have a Serial Port interrupt conflict -- see Appendix A.2. If you are connected: ■ If you can see text from the other system, you may need to enable Local Echo in your Modem Setup dialog. See Section 4.6.3 ■ Modem General Settings. ■ If you see nothing after connecting, this is the classic symptom of an interrupt conflict -- see Appendix A.2. ■ You may be configured for the wrong baud rate. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.2 ■ Every Line of Text Lays on Top of the Last ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ If every line of text received from the host lays on top of the previous line of text transmitted, you need to enable Add CR/LF in your Modem Setup dialog. See Section 4.6.3 ■ Modem General Settings. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.3 ■ My File Transfers Fail Immediately ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ There are two possible solutions: ■ The usual source of this problem is an invalid download directory. Usually, the directory does not exist, or it was misspelled. Try removing the download directory you have entered, and leave the field blank. Try your download again. If it works, you found the problem. ■ You are out of disk space. Select System Information from the System Menu, or type Ctrl-Alt-I to see how much disk space you have available. NOTE: This shows the space available on the disk RIPterm is running on. If your download directory is on another disk, you must Jump to DOS to see how much space is available on that disk. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.4 ■ My Modem is Always On-Line (Resuming Previous On-line Session) │ └───────────────────────────────────────────────────────────────────────────┘ Your modem and your modem cable must support the Carrier Detect (CD) signal. This is how RIPterm determines if you are online or offline. The modem can be configured for CD ON with connection, CD OFF when offline by sending these commands to the modem. From the session screen in RIPterm, type: ATZ and press ENTER. Wait for the "OK". AT&C1 and press ENTER. Wait for the "OK". AT&W and press ENTER. Wait for the "OK". If you don't get an OK after a step, STOP. Check your modem's documentation to see if it supports Carrier Detect and if &C1 is the correct command for your modem. It is standard for most modems. If your modem does not have a permanent configuration area (CMOS), then &W will give you an error. If this is the case, then you will have to put the &C1 in your Modem Init String in the Modem Setup dialog. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.5 ■ RIPterm always says "Hang up failed" when I try to hang up. ▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Make sure your modem is set up for DTR Hangup. From the Session screen, when only the Status Bar is visible, type AT &D2 <ENTER>. Now try hanging up. If your hang up didn't fail, type AT &D2 &W <ENTER>. If the modem returns OK, it saved it to it's memory. If the modem returns ERROR, go to the Modem Setup and make sure &D2 is in your Modem Init String, and save the setup. If your modem does not support DTR hangup, make sure that in Modem Setup the box by DTR hangup is not checked, and save setup. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.6 ■ I get the message "CTS is not enabled. Disabling RTS/CTS". ▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ Make sure your modem is hooked up. Make sure your modem is set up to support RTS/CTS flow control. From the Session screen, when only the Status Bar is visible, type AT &R2 <ENTER>. If the modem returns OK, type AT &R2 &W. If the modem now returns OK it is saved in it's memory. If it returns ERROR, go into Modem Setup and make sure &R2 is in your Modem Init String, and save the setup. If your modem returned ERROR when you typed AT &R2 the first time, then go to Modem Setup and make sure the box by RTS/CTS flow control is not checked. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.7 ■ I can connect with some BBS's but not others. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒│ └───────────────────────────────────────────────────────────────────────────┘ You need to turn off error correction for some older modems. To do this, select the Setup menu and select Modem Prefixes/Suffixes. Make one prefix "AT &M0 DT" this is for connecting with old modems without error correction. Make another prefix "AT &M1 DT", this one is for calling modems with error correction. Now go through your Dialing Directory and set the proper prefix for each BBS you call, and save the setup. ┌───────────────────────────────────────────────────────────────────────────┐ │▒▒▒ A.5.8 ■ RIPterm locks up when I start up or seems to be stuck in a loop│ └───────────────────────────────────────────────────────────────────────────┘ Delete RIPTERM.CNF file located in the same directory as RIPterm. Most likely the setup information is wrong. Deleting this file makes RIPterm ask you for new setup information. ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ Appendix B ■ Menu Keyboard Shortcuts Reference ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ ┌────────────────┐ │ NO MENU KEY │ └────────────────┘ System Menu System Menu: About RIPterm Professional System Menu: License Information System Menu: Debug Menu File Menu: Edit External Applications Options Menu: VT-102 Emulation Options Menu: Create Variable Options Menu: Show Variables Options Menu: Built-In Variables ┌────────────────┐ │ SINGLE KEY │ └────────────────┘ PgDn File Menu: Download a File PgUp File Menu: Upload a File PrintScreen File Menu: Print Screen ScrollLock Options Menu: Button Hotkeys ┌────────────────┐ │ ALT │ └────────────────┘ Alt-SPACE Options Menu: Status Bar Alt-= Options Menu: Doorway Emulation Alt-A Connect Menu: Modem Auto-Answer Alt-B Options Menu: View Scrollback Alt-C Connect Menu Alt-D Connect Menu: Dialing Directory Alt-F File Menu Alt-G Options Menu: Clear the Graphics Window Alt-H Connect Menu: Disconnect (Hang Up) Alt-I Connect Menu: Initialize Modem Alt-J File Menu: Jump to DOS Alt-K Options Menu: Keystroke Macro Editor Alt-L File Menu: Log Text to File Alt-M Connect Menu: Manual Connect Alt-O Options Menu Alt-P File Menu: Log Text to Printer Alt-R Options Menu: Reset All Windows Alt-S Setup Menu Alt-T Options Menu: Clear the Text Window Alt-U Debug Menu Alt-X File Menu: Exit to DOS Alt-Y Options Menu: Chat Mode Alt-Z System Menu: Help Table of Contents ┌────────────────┐ │ CTRL │ └────────────────┘ Ctrl-S XOFF Ctrl-Q XON Ctrl-END Options Menu: Send Break Ctrl-HOME Options Menu: Redraw System Menu ┌────────────────┐ │ CTRL-ALT │ └────────────────┘ Ctrl-Alt-A Options Menu: ANSI Emulation Ctrl-Alt-B File Menu: Show Local Image File Ctrl-Alt-D Setup Menu: Modem Dialing Prefixes Ctrl-Alt-F Setup Menu: System Font Setup Ctrl-Alt-G Setup Menu: General Setup Ctrl-Alt-H System Menu: Help on Menus Ctrl-Alt-I System Menu: System Information Ctrl-Alt-M Setup Menu: Modem Setup Ctrl-Alt-O Options Menu: Mouse Field Select Ctrl-Alt-P File Menu: Printer Setup Ctrl-Alt-Q File Menu: Show Local RIP Query Ctrl-Alt-R File Menu: Show Local RIP File Ctrl-Alt-S Setup Menu: Save Setup Ctrl-Alt-T Setup Menu: File Transfer Setup Ctrl-Alt-U Setup Menu: Audio Setup Ctrl-Alt-V Setup Menu: Video/Mouse Setup Ctrl-Alt-W Setup Menu: Modem Hardware Setup Ctrl-Alt-X File Menu: Run External Application Ctrl-Alt-Z Options Menu: RIPscrip Emulation ╔═══════════════════════════════════════════════════════════════════════════╗ ║▒▒▒ Appendix C ■ TeleGrafix Technical Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╚═══════════════════════════════════════════════════════════════════════════╝ TeleGrafix has a new phone number just for Technical Support. This will help those who need assistance from getting mixed in with the calls for the business office. Before contacting Technical Support, please use the Troubleshooting Guide in Appendix A to see if your question is discussed. TeleGrafix has found that most of the tech support questions are on the same issues, and we have documented them here for your convenience and to save you (and us) time. You can also download the latest technical bulletins from TeleGrafix's BBS (The Vector Sector) at the number listed below. RIPterm version 2.0 comes with 30 days unlimited technical support from your date of purchase. After this time has expired, you will fall under our new paid Technical Support plan. There will be options for paying as you go, 900 number technical support access, and yearly support contracts that can optionally include software updates. Contact TeleGrafix for more information on this program. We expect it will be in place in March 1995. This program is thoroughly tested by a large team of beta-testers, and is as bug-free as possible. However, there are most likely some bugs that have not been discovered. If you find any, please report them to TeleGrafix right away at the following address: ┌───────────────────────────────────────────────┐ │ │ │ TeleGrafix Communications, Inc. │ │ 16458 Bolsa Chica #15 │ │ Huntington Beach, CA 92649 │ │ │ │ Technical Support .. (714) 379-2130 │ │ Main Office ........ (714) 379-2131 │ │ Fax (Office/Tech) .. (714) 379-2132 │ │ TeleGrafix BBS ..... (714) 379-2133 │ │ │ │ Internet Address: │ │ rip.support@telegrafix.com │ │ │ └───────────────────────────────────────────────┘ ┌─────────────────────────────────────────────┐ ┌┴─────────────────────────────────────────────┴┐ │ │ │ Authors of RIPterm: │ │ │ │ Jeff Reeder Mark Hayton Jim Bergman │ │ │ │ ───────────────────────────────────── │ │ │ │ RIPterm docs by Jim Bergman and Jeff Reeder │ │ RIPterm docs edited by Jim Bergman │ │ │ │ ───────────────────────────────────── │ │ │ │ The authors wish to thank │ │ these people their contributions: │ │ │ │ Pat Clawson │ │ Wendy Erdtsieck │ │ Chuck Schroeder │ │ │ │ ... and the many others that have │ │ worked with us (and for us) over │ │ the last two years. Its been a │ │ long journey, and we hope that │ │ you will enjoy all the new features │ │ their contributions have made possible. │ │ │ │ TeleGrafix would also like to thank │ │ their families and friends │ │ for their support and encouragement │ │ (and for putting up with us!) │ │ during this effort. │ │ │ │ We couldn't have crawled across │ │ the finish line without you! │ │ │ └┬─────────────────────────────────────────────┬┘ └─────────────────────────────────────────────┘ ═════════════════════════════════════════════════════════════════════════════ # # # ═════════════════════════════════════════════════════════════════════════════