Simtel MSDOS 1992 September

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

/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / modem / 121_v22.arc / 121.DOC next >

Wrap

Text File | 1987-03-21 | 92KB | 1,769 lines

O N E T O O N E (tm) Personal Communications Software Version 2.2 for IBM and Compatible Microcomputers using PC or MS-DOS (ver. 2.0 or later) By Digital Transit 3360 Towneship Road Antioch, TN 37013 Copyright (C) 1986,1987 Digital Transit All Rights Reserved Table Of Contents What is ONE TO ONE ? ............................................ 1 Warranty and Trademarks ......................................... 2 ShareWare Notes ................................................. 3 Acknowledgments ................................................. 5 Conventions ..................................................... 6 System Requirements ............................................. 7 ONE TO ONE System Files ......................................... 8 Starting ONE TO ONE (Installation) .............................. 10 Terminal Mode & Menu Mode ....................................... 12 Terminal Mode ................................................... 12 Keys Available In Terminal Mode ............................ 15 Alt-A: Answer The Phone ............................... 15 Alt-C: Clear The Screen ............................... 15 Alt-D: Dialing Directory .............................. 15 Alt-H: Hang Up The Phone .............................. 16 Alt-M: Modem Echo ..................................... 16 Alt-P: Change Parameters .............................. 16 Alt-R: Redial The Previous Number ..................... 16 Alt-T: Chat Mode ...................................... 17 Alt-X: Exit To DOS .................................... 17 Alt-Z: Visit DOS (Shell) .............................. 17 PgUp: Upload (Send) A File ........................... 18 PgDn: Download (Receive) A File ...................... 18 Ctrl-Home: Capture Keystrokes ......................... 19 Ctrl-Keys: Attaching Messages To Keystrokes ........... 19 Home or F1: Help ...................................... 19 Esc or '+': Switch From Terminal To Menus ............. 19 Menu Mode ....................................................... 20 Menu Descriptions .......................................... 21 Info .................................................. 21 Files ................................................. 21 Modem ................................................. 24 Phone ................................................. 26 Toggles ............................................... 28 Screen ................................................ 29 Keys .................................................. 30 Tips and Tricks ................................................. 32 Final Remarks ................................................... 34 Appendix I Order Form ......................................... 35 Appendix II ONE TO ONE and Xmodem .............................. 36 Appendix III The 121PATH Environment Variable ................... 37 Appendix IV Phone Directory Structure .......................... 38 Appendix V OPTIONS.121 Structure .............................. 39 Appendix VI ONE TO ONE Programming Trivia ...................... 40 1 What is ONE TO ONE ? ONE TO ONE is a telecommunications package designed for those of us who sometimes call friends with computers. The many sophisticated programs that are currently available do a great job for accessing bulletin boards, information services, etc.. HOWEVER, they all are less than desirable when it comes to two human beings trying to communicate with each other over the phone lines via computers. ONE TO ONE is the first communications program available that attempts to address the special needs of people that need to share data with other people. What does ONE TO ONE offer that the others don't? With ONE TO ONE, you and your friend can... 1) Type messages to each other while a file transfer is in progress! 2) Never worry about garbled text caused by two people typing at the same time. Incoming and Outgoing text appear in seperate windows on screen. 3) "Share" a text file. You and a friend can be looking at the same text file at the same time. Both of you will have control over scrolling the files contents in a window. At any time, you can pause and type notes to each other about the file that you are sharing. 4) Enjoy the snazziest "user-interface" in all of telecommunications. Best of all, the price is right. With a suggested contribution of $15-$20, there is no reason to keep yourself locked out of the next generation of communications software. 2 Warranty What we want to say... A lot of time and effort has been spent on this project. It is a well-designed and well-written program. To the best of our knowledge, this software works and works well. We know this because we use it! Now that we've said that, we have to say something else; we abhor the following legal mumbo-jumbo. Unfortunately, this sort of thing is necessary in order for us to sleep at night. What we have to say... Digital Transit makes no warranty of any kind, express or implied, including without limitation, any warranties of merchantability and/or fitness for a particular purpose. Digital Transit shall not be liable for any damages, whether direct, indirect, special or consequential arising from a failure of this program to operate in the manner desired by the user. Digital Transit shall not be liable for any damage to data or property which may be caused directly or indirectly by the use of the program. IN NO EVENT WILL Digital Transit BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. Because Digital Trasit is making ONE TO ONE available through the User Supported concept of software distribution, your life is made a little easier. IF YOU FIND THAT THIS PROGRAM DOESN'T WORK AS CLAIMED, OR DOESN'T FIT YOUR NEEDS, DON'T BUY IT. We don't expect to receive your money UNTIL you are a satisfied customer. We would hope however that, if you find that this program doesn't work as claimed, you would let us know right away! We should be able to fix most anything within 48 hours and we will strive to do so. Trademarks ONE TO ONE is a trademark of Digital Transit Microsoft, Microsoft C, MS, and MS-DOS are registered trademarks of Microsoft Corporation. IBM and PC-DOS are registered trademarks of International Business Machines Corporation. Hayes is a trademark of Hayes Microcomputer Products, Inc. Touch Tone and AT&T are trademarks of American Telephone & Telegraph Company. COMPAQ is a registered trademark of COMPAQ Computer Corporation ARC is a trademark of System Enhancement Associates The Greenleaf Comm Library and The Greenleaf Functions are trademarks of Greenleaf Software, Inc. 3 User Supported Programs A computer without software is like a toaster without bread. Without software, our computers are useless. The reasonable thing to do is to acquire some quality software in order to put our expensive hardware to good use. Unfortunately, computer software is also very expensive. This makes it tougher for us to get the software we would like. What's even worse is that NO commercial software publisher will allow us to open their package, try it out, and return it if we don't like it. (Some software retailers allow you to do this, but they always charge an outrageous re-stocking fee if you return software.) Along comes User Supported software. The basic idea of User Supported software is that you, the user, should have the right to "try before you buy". If you test the software and decide that you like it, you send the author the money to pay for it. Since the author doesn't have the high marketing overhead he can charge much less than the big boys. Advantages: 1) Try before you buy. If you don't like it, don't buy it. 2) The price is right. No marketing overhead. 3) The quality is right. Most software is written by professional programmers that know what they're doing. If the quality isn't there, you'll know it BEFORE you spend any money. 4) Updates are more frequent. Since these programs are distributed over the phone, the documentation can be sent out with the program without having to wait for a new (and expensive) reprinting of a manual. Disadvantages: 1) Telephone support is hard to come by. (I've never needed any from a User Supported product.) 2) Latest figures indicate that only 10% of people actually pay the author for the program. (This figure may be optimistic) 3) This is the reason for the disadvantage #1. It's hard for someone to give up a steady job as a professional programmer and support his customers when 9 out of 10 people have STOLEN his program. There are several packages that I like, but because I think the author is asking too much, I have stopped using them. Perhaps I should have just sent the author what I think the program is worth and risk hurting his/her feelings. So you know where I stand, I think that the suggested price of $15-$20 is a bargain, considering the qualtiy of the product. HOWEVER, if in your opinion you think it's worth $5, SEND IT IN. A buck in the hand is worth two in the user's wallet. If you send less than $15.00 please send a note letting us know what we can do to make ONE TO ONE more valuable. 4 Clearly the User Supported concept is beneficial for us all. But we must take it more seriously if it's going to work. Cast your vote for the User Supported concept by paying for your User Supported programs. Before I put the soap box away... ONE TO ONE is a professional-quality software package that is being distibuted through electronic rather than traditional marketing channels. It is NOT free software. If you find this program to be of use, you are urged to send a small contribution (in the $15 - $20 range) to the author at the address below. Make checks payable to Digital Transit. Digital Transit 3360 Towneship Road Antioch, TN 37013 Whether you decide ONE TO ONE is for you or not, thanks for taking the time to try it out. You are ENCOURAGED to distribute this software in any way that you see fit, providing the following conditions are met: 1) You must receive NO COMPENSATION for distributing ONE TO ONE. (Compensated Electronic Distribution Services such as BBS's, Compuserve, Genie, etc., can distribute ONE TO ONE legally.) 2) The program and documentation must be distributed together. 3) The program and documentation must be unmodified. 4) ONE TO ONE may not be distributed in association with any other product or service unless an arrangement has been negotiated with Digital Transit. Distibuters of Public Domain and User Supported software may not distribute ONE TO ONE without written permission from Digital Transit. You will most likely get permission, but written permission is REQUIRED. Anyone interested in a site liscense, or in bundling ONE TO ONE with another product, please contact the author at the above address. 5 Acknowledgements Thanks, Jan and Chris, for your patience. Thanks, Microsoft, for MS-C (4.0) the BEST MS-DOS C COMPILER. Thanks again, Microsoft, for the MASM Assembler (ver. 4.0) Thanks, Greenleaf Software, for saving me from a lot of grunt work. Thank-you beta testers, for your encouragement and design feedback. Thanks Eric Hawkins, for your good judgement and advice. Thanks Dean Carothers, for your enthusiasm, knowledge, and friendship for the past 7 years. Thanks to everyone that became a registered user for ONE TO ONE version 1.0. 6 Conventions Used In This Manual The IBM keyboard is programmable. That is, the keyboard isn't locked into any particular mode of operation. We can redefine the keyboard to suit our needs. To this end, IBM has added several interesting keys that operate much like the SHIFT keys on a typewriter. We are only concerned with the use of the "Ctrl" and "Alt" keys right now. Whenever you see Alt-something it means to press and hold the "Alt" key while you press the "something" key at the same time. For Example: Alt-X means to hold the Alt key while pressing X Likewise, whenever you see Ctrl-something it means to press and hold the "Ctrl" key while you press the "something" key at the same time. For Example: Ctrl-X means to hold the Ctrl key while pressing X There are some other keys that we will be dealing with that aren't found on typewriters. One is the "Esc" key which is toward the upper left corner of the keyboard if you have an older computer, it's toward the upper right corner if you have a newer model. (Why they switched it is beyond me.) The other keys are on the "Numeric Keypad" generally found on the right side of the keyboard. Depending on the state of the NUM LOCK (numeric lock) key, the numeric keypad is either in the numeric mode or the direction mode. (The NUM LOCK key acts sort of like the CAPS LOCK key.) In numeric mode, the keys act like an adding machine or calculator. In the direction mode, the other markings that appear on the keys are active. In the direction mode we have keys 8, 2, 4, and 6 used for UP, DOWN, LEFT, and RIGHT, repesctively ( these keys are marked with arrows). We also have keys 7, 1, 9, and 3 used for HOME, END, PAGE UP, and PAGE DOWN, respectively. Since most keyboards have the PAGE UP and PAGE DOWN keys abbreviated, we will refer to them in this manual as PgUp and PgDn. The RETURN key is known as the ENTER key in IBM manuals. It is just where you would expect the RETURN key to be. A crooked arrow pointing to the left marks this key on most keyboards. For consistencies sake, we will refer to this key as the ENTER key. 7 System Requirements ONE TO ONE requires the following... - IBM Compatible Computer - PC-DOS Or MS-DOS (version 2.0 or later) - One Floppy Disk Drive (hard disk not required) - At Least 192k Of RAM. - One RS-232 Serial Port - A HAYES COMPATABLE modem (must support the Hayes AT command set) - Someone To Call ONE TO ONE works with Monochrome as well as Color video cards. If you have an Enhanced Graphics Adapter, ONE TO ONE will use the CGA mode. When you install ONE TO ONE, you will be asked whether you have Touch Tone or Pulse phone service. ONE TO ONE will work with either. 8 ONE TO ONE System Files ONE TO ONE version 2.2 is distributed in an archived form. The "ARC" archiving utility by System Enhancment Associates was used to compress the files in order to keep downloading time to a minimum. ARC has become the standard file compression program used for electronic software distribution. You should have no problem obtaining a copy of the latest version of ARC from your friendly neighborhood bulletin board. Please remember that ARC is not free. It will save you money in the long run so why not go ahead and pay for it? The name of the archived file is 121-V22.ARC. After "un-arching" this file you will see the files below: 121.EXE - The program. 121.DOC - The documentation for the program. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes describing improvements in release 2.2 The only file required to start ONE TO ONE is the file named 121.EXE. When you run the program for the first time ONE TO ONE looks for other files and creates them if they cannot be found. OPTIONS.121 OPTIONS.121 is a file that holds the proper configuration parameters for your system. If the file OPTIONS.121 can't be found, ONE TO ONE will ask you several questions and then create the file for you. (Those of you who run ONE TO ONE from a floppy disk drive should make sure that your disk isn't write-protected.) PHONEDIR.121 The phone directory file is named 121PHONE.DIR. When you call up the dialing directory, PHONEDIR.121 is read from disk. If ONE TO ONE can't find the phone directory, it creates a blank one and then writes it back to disk. CTRLTEXT.121 Starting with release version 2.0 you have the ability to assign phrases to Ctrl-characters. For example, you could make Ctrl-S send the phase "I'm Sending The File In 10 Seconds, OK?". Anytime you pressed Ctrl-S, this message would be sent automatically as though you had typed it by hand (except that it is sent quickly and with no typos!). The messages associated with Ctrl-characters are stored in a file called CTRLTEXT.121. This file is created when ONE TO ONE is executed for the first time. 9 Here are all the files associated with ONE TO ONE version 2.2: 121-V22.ARC - All Programs & Documentation archived for distribution. After un-archiving: 121.EXE - The program. 121.DOC - The documentation for the program. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes describing improvements in release 2.2. After running ONE TO ONE for the first time: 121.EXE - The program. 121.DOC - The documentation for the program. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes describing improvements in release 2.2. OPTIONS.121 - The System Configuration File PHONEDIR.121 - The Phone Directory CTRLTEXT.121 - Messages attached to Ctrl-characters 10 Starting ONE TO ONE (Installation) Make sure that 121.EXE is in the current directory of your disk and type 121 (press ENTER). After a few moments you will be told that ONE TO ONE couldn't find the file OPTIONS.121. You will then be asked to answer several questions so that a proper configuration file can be created for your particular system. Each question will be discussed below: Which Communications Port? (1/2): Enter the proper port number, either a 1 or a 2 to reflect which serial port you have a modem attached to. If you enter the wrong number, ONE TO ONE will not be able to initialize the serial port and will print a message to that effect. At that point you could use the Alt-P key to Change Parameters. Anything changed with Alt-P is not permanent unless you save the parameters with the menu choice called 'Save OPTIONS.121' which is found in the "Files" pull-down menu. (More about that later) What Baud Rate? (300/1200/2400/4800/9600): You must type in one of the numbers respresenting the speed of your modem. ONE TO ONE always uses 8 data bits, 1 stop bit, and No parity. You will not be prompted for these paramters. Key-Clicks On Incoming Text? (Y/N): If you type 'Y' in response to this question, ONE TO ONE will cause a "click" to occurr on each incoming character. This can be a useful feature because you will always know when someone is "typing at you". Touch Tone or Pulse Dialing? (T/P): If you have pulse dialing, you should enter a 'P'. Anything else defaults to Touch Tone service. Default Modem Initialization String? (Y/N): The default modem initialization string performs the following commands; Waits 1.5 seconds, Takes the modem off-line, Waits another 1.5 seconds, issues the ATZ command to reset the modem, Waits another 1.5 seconds, and issues the ATV1 command to set the modem result codes to WORDS instead of DIGITS, and finally, issues the ATE0 command to disable the modem from echoing your keystrokes into the receive buffer. Ninety-nine percent of you can probably just answer 'Y', take the defaults, and go with it. However, just in case you need it, you have the ability to create a custom modem initialization string. 11 If you answer 'N', meaning that you don't want to settle for the default string, you will be given an opportunity to create your own. In order to do this you should read the on-screen explanation of the special characters that can be imbedded in your initialization string. They are... { = The ENTER key. ~ = .5 seconds of delay. ^ = Next character after this should be interpreted as a control code. Those of you with faster modems might want to take advantage of the extended result codes by using the ATX1 command so that the modem will send you a message upon connection telling you at what baud rate the connection is made. That way, if you're at 300 baud and someone calls you at 1200 baud, you can use Alt-P to change parameters and establish a connection at your friend's baud rate. What Type Of Screen Do you Have? (1/2/3): 1 = Monochrome. No colors or shades of grey. 2 = Color. I have a color monitor. 3 = Monochrome, but I get nice shades of grey. 1) You would enter '1' if you have an IBM green-screen monitor. More accurately, those of you with a Monochrome Display Adapter would fall into this catagory. 2) Those of you with color monitors would enter '2'. In color, ONE TO ONE has white text on a blue background. The pull-down menus are red with white text. Sounds sort of corny and patriotic, doesn't it? It looks good and it's easy on the eyes. 3) People choosing '3' should have computers that show nice shades of grey whenever colors are represented on their screens. Compaq and AT&T computers are known to work well like this. You may just have to try it if you aren't sure. If you have an amber or green monitor and you can hardly read the text on the screen after making this selectoin, then this option is not for you. You will need to reinstall ONE TO ONE (by erasing OPTIONS.121 first) and select choice number '1' for No colors. After all of these questions have been answered, ONE TO ONE will create the OPTIONS.121 file and write it to disk for future reference. If you made mistakes while answering these questions, don't worry. You can change all of these parameters from inside ONE TO ONE and save them to disk for future use. Congratulations, you have installed ONE TO ONE and are about to see the opening screen of the program. 12 Terminal Mode And Menu Mode ONE TO ONE has somewhat of a split personality. You are either in TERMINAL MODE where you are waiting for the phone to ring, typing messages to a friend, etc., or you are in the MENU MODE where you are pulling down menus and making selections from them. The first screen you see when ONE TO ONE executes is the title screen. This screen tells what this program is, warns you that this is not free software, begs for compensation, tells who wrote it, and waits for you to press a key. Just your typical User Supported software title screen. When you press a key to continue, the modem initialization string will be sent to the modem. After this is accomplished, you are in TERMINAL MODE. This is where you will spend most of your ONE TO ONE life. TERMINAL MODE is where you perform communications with your friends. Each key you press will be sent out the comm port to whoever's out there. (The exception to this occurrs when the keys that you press are menu selections.) All of the vital choices from the menus have been mapped to the keyboard. You could call a friend (or be called), establish a connection, type messages, send and receive files, and hang up without ever once pulling down a menu. On the other hand, some things can't be performed from the keyboard but must be carried out from the appropriate menu. An example of this would be adjusting the Dividing Bar that seperates the incoming from the outgoing text. (You will have to choose this option from the "Screen" pull-down menu.) Before we go any further, let's take a minute to see how the ONE TO ONE screen is arranged... 1) The top line of the screen contains the names of all of the pull- down menus. This line is referred to as the Menu Bar. 2) The middle part of the screen is divided by a reverse video bar that we will call the Dividing Bar. Incoming Text, (characters that are typed to us) will appear in this region or "window" of the screen. Outgoing Text, (anything that we type) will appear in the lower window. 3) Below the Outgoing Text window there is an area that is set aside for informing us of the current communincation port settings. This area is also used for messages from ONE TO ONE to us. The message that you will see most frequently in the area says, "Press `Home' For Help". (Have you tried it yet?) 4) The last thing on the screen, on the very bottom line, is a program title and copyright notice. Now back to business... In order to change between MENU MODE and TERMINAL MODE you must press a special key to let ONE TO ONE know that you are ready to change modes. You can use either of two keys that have be reserved for this purpose, the 'Esc' (escape) key or the '+' (plus) key. 13 As soon as you "toggle over" to MENU MODE, you should notice a couple of things. 1) you will see Menu Mode flashing at you to let you know that the characters you press will not be sent over the phone lines. 2) The word "Info" will be highlighted on the "Menu Bar" indicating that if you press ENTER (or the Down Arrow key) this menu will become active. Press ENTER right now and you will see the menu unfold (be pulled- down). The Info menu contains no menu choices, it simply tells the program title, verion number, and gives the address of the author. To make menus go away without making a menu choice, press the 'Esc' or grey '+' key. Alternately, you could press the Up Arrow key until the menu goes past the top choice at which time it will go away. Let's make a menu selection so you can see how it's done. If you are still looking at the Info menu, make it go away by following one of the methods in the above paragraph. Now press the right arrow key and notice how, for every time you press the right arrow, the next choice to the right becomes highlighted signifying that it is ready to become the active menu. Keep pressing the right arrow key until the "Screen" pull-down menu is highlighted. Now press ENTER or press the Down Arrow. The menu will drop down and the first selection "Clear Both Screens" will be highlighted. IMPORTANT: You could also have pressed "S" to automatically pull down the Screen menu. (All menu choices can also be selected by pressing the key that corresponds to the first letter of the desired choice.) You select a menu choice by pressing ENTER whenever the desired menu choice is highlighted. To higlight the desired choice you may 1) press the key that corresponds to the first letter of the desired choice or 2) use the Up and Down arrow keys to move through the list of choices. Let's use the Down Arrow key to highlight "Clear Outgoing Screen" then press ENTER. When you do so, any text that was in our outgoing text window (the bottom half of the screen) has been cleared. If you didn't have any characters sitting in the Outgoing Text window, you will not notice that anything happened. It did. At this point, you are still in the MENU MODE as evidenced by the flashing "Menu Mode" on the screen. Press the `Esc' or `+' key to get back into TERMINAL MODE. To recap, you can use either of two methods to make menu selections. 1) Arrow Key Method - Use the arrow keys to highlight the menu or menu choice that you desire, then press ENTER. 2) Letter Keys - Press the key corresponding to the first letter of the menu that you want to pull down. Then press the key that corresponds to the first letter of the menu choice that you desire. Finish your selection by pressing the ENTER key now that your selection is highlighted. 14 To leave a menu WITHOUT making a choice you just "escape out of it" by pressing the 'Esc' or the '+' key or by pressing the Up Arrow key until you go past the top choice. You now have all of the knowledge you will need to make ONE TO ONE work for you. At this point you are encouraged to experiment. Press the key marked `Home' on the numeric keypad for Help. (You can also press the F1 key for Help, if you like.) You will find a help screen for TERMINAL MODE and a seperate help screen for MENU MODE. ONE TO ONE is very easy to use. A lot of effort went into making the "user-interface" of ONE TO ONE simple and powerful. After a little practice, making menu selections and toggling between MENU MODE and TERMINAL MODE will become second nature. 15 Available Keys In TERMINAL MODE While you are in the TERMINAL MODE you have access to all of the necessary menu choices without having to switch over to MENU MODE first. Certain keys have been assigned to the most frequently needed menu selections. Pressing the key representing the desired menu choice is just the same as if you had toggled into MENU MODE, made the choice, and toggled back into TERMINAL MODE. Most of these keypresses require that you hold down the `Alt' key while pressing the appropriate character. What follows is a listing of all available special keypresses and a description for each. Alt-A: Answer The Phone When you press Alt-A the Hayes ATA command is sent to the modem. The ATA command tells the modem to answer the phone now. Before you press Alt-A, you should first see the word RING in the Incominig Text window. This is your indication that the phone line attached to the modem is ringing. If a connection is established, you should see the word CONNECT appear in the Incoming Text window, otherwise, the message NO CARRIER will appear. If you press Alt-A when the phone isn't ringing, just press a key and the modem will stop trying for a connection. Alt-C: Clear The Screen Pressing Alt-C will cause the Incoming Text, Outgoing Text, and Dividing Bar to be cleared of their current contents. Alt-D: Dialing Directory If you want to dial the phone, press Alt-D. When you do, a dialing directory will be displayed. The directory has room for 10 entries. (This may expand in a future update.) At the bottom of the screen you are presented with several options. R) Revise an Entry - Prompts you to enter names and numbers. E) Erase an Entry - Allows you to "wipe out" an existing entry. M) Manual Dial - You dial a number from the keyboard. D) Dial an Entry - Asks "Which Entry?" then dials it for you. Q) Quit - Takes you back to TERMINAL MODE. After a phone number is dialed you will be taken back to TERMINAL MODE where you will wait for the CONNECT message to appear in the Incoming Text window. If you see the word CONNECT, you have established a connection with the person that you called. If instead, you see NO CARRIER, a connection could not be established. 16 Alt-H: Hang Up The Phone Pressing Alt-H first sends the `+++' characters to the modem and then sends the Hayes ATH command to hang up the phone. The `+++' characters puts the modem in command mode. See your modem manual for a more thourough explanation. If you were connected to another computer when you issued the Alt-H command, you should see the NO CARRIER message appear in the Incoming Text window withing 5 seconds after Alt-H is pressed. Alt-M: Modem Echo Modem Echo is a "toggle" meaning that it can be either ON or OFF. If it is ON then every character that you type will appear in both the Incoming Text window and Outgoing Text window. Alt-P: Change Parameters You may wish to change baud rates or communication ports while ONE TO ONE is running. For example, you may be called by a friend at 300 baud while your modem is set at 1200 baud. Pressing Alt-P allows you to immediately change parameters so that you are now connected at the same baud rate. When you press Alt-P, a window will appear with a list of parameters to choose from. The parameters at the top of the list are for communicatins port #1 (com 1), and the bottom choices are for port #2 (com 2). Press the key representing your choice or press the ENTER key if you want to keep your current parameters and return to TERMINAL MODE. Because ONE TO ONE always uses 8 data bits, 1 stop bit, and No parity, you will not be prompted for these parameters. Please remember that these changes are not permanent. The next time ONE TO ONE is started it will default to the parameters you set up in the OPTIONS.121 file (the first time you ran ONE TO ONE). Alt-R: Redial The Last Number Whenever you dial a number from the phone directory, a copy of that number is placed in the redial buffer. Then, when you press Alt-R, the number is redialed for you automatically. If you press Alt-R before a number has been dialed you will see a message appear saying that "There is No Number to Redial!". 17 Alt-T: Chat Mode When you and a friend are typing messages to each other, every key that you press goes out to your friend's computer. If you make a mistake while typing and press the BACKSPACE key, this too goes out to your friend. Your friend watches you make a mistake, back up to it, correct it, and then conitinue on. Meanwhile, he already knew what you were trying to say. This can be annoying after a while. There's a better way. It's called Chat Mode and you enter Chat Mode by pressing Alt-T. When you do so, your keystrokes will be saved in a buffer until you press the ENTER key. Then, all of your typing will be sent at once. Your friend will never know that you made mistakes while you were typing. While you are in Chat Mode you will still see your friend's characters arriving in the Incoming Text window as usual. The only indication that anything is different is the message that appears on the Dividing Bar. It says, "Chat Mode - Press `Esc' to return to normal mode". While you are in Chat Mode you can't make any other menu choices. You must press the `Esc' key to return to normal TERMINAL MODE first. Alt-X: Exit To DOS When you press Alt-X you will be told that you are "Exiting to DOS". You are then asked to verify the command. "Are you sure?", it asks. If you press 'Y' (for yes) you will return to DOS. Any other key will take you back to TERMINAL MODE with no harm done. Alt-Z: Visit DOS (Shell) By pressing Alt-Z, you put ONE TO ONE "on hold" and drop back to DOS. You are then free to change directories, format disks, use a text editor, or anything else you might want to do before returning again to ONE TO ONE. When you are finished with your DOS chores, type EXIT and press ENTER. You will be right back in ONE TO ONE as though you'd never left. Note: This feature has a couple of requirements... 1) Your computer must have enough memory to have ONE TO ONE and whatever other program you want to run be resident at the same time. 2) ONE TO ONE must be able to find the file COMMAND.COM somewhere in your system. For technical users: When Alt-X is pressed, ONE TO ONE tries to invoke another copy of COMMAND.COM in order to create a "DOS shell". If it can't find COMMAND.COM you will see a message saying that it failed to load the second copy of COMMAND.COM and you will be returned to ONE TO ONE. You will just have to experiment to see if this will work on your system. Hard disk user's should have no problem. Floppy disk user's will have to copy COMMAND.COM from their "boot disk" onto their ONE tO ONE disk for this to work properly. Give it a try. 18 PgUp: Upload (Send) A File When you press the PgUp key on the numeric keypad, you are telling ONE TO ONE that you want to upload (send) a file to whoever you're connected to. You will be prompted for the name of the file to send. The file to send can be in any subdirectory on any drive. You are not limited to the current directory. After you enter the file name ONE TO ONE will patiently wait for the receiving party to acknowledge that it is ready to receive. At this point, your friend should have told his computer that he wants to download (receive) a file. See Appendix II about the XMODEM protocol. Once the computers have started transferring the file, you can just sit back and relax if you like. BUT, if the other person is also using ONE TO ONE, you can continue to type messages to each other while the file transfer takes place! In either case you will see a status report of the file transfer displayed on the Dividing Bar. After the file transfer is complete, you will hear a beeping sound indicating that the transfer is complete. If something happens and you want to abort the file transfer, press Ctrl-X and you will exit gracefully. Your screen will say "Aborted by User" and you will hear the beeps letting you know that the transfer is finished. Your friend's screen will display a similar cancelation message. PgDn: Download (Receive) A File If you are ready to download (receive) a file you may press the PgDn key on the numeric keypad. You will be prompted for the name of the file to receive. You may include a valid drive/path combination in front of the file name if you wish. After you enter the file name, ONE TO ONE will patiently wait for the sending party to begin sending the file. At this point, your friend should have told his computer that he wants to upload (send) a file. See Appendix II about the XMODEM protocol. Once the computers have started transferring the file, you can just sit back and relax if you like. BUT, if the other person is also using ONE TO ONE, you can continue to type messages to each other while the file transfer takes place! In either case you will see a status report of the file transfer displayed on the Dividing Bar. After the file transfer is complete, you will hear a beeping sound indicating that a transfer is complete. If something happens and you want to abort the file transfer, press Ctrl-X and you will exit gracefully. Your screen will say "Aborted by User" and you will hear the beeps letting you know that the transfer is finished. Your friend's screen will display a similar cancelation message. 19 Ctrl-Home: Capture Keystrokes If you want to save the Incoming Characters to a file, press Ctrl- Home. When you do, you will see a little message pop up saying that "Capture is ON" and all incoming characters typed by your friend will be saved to a file named CAPTURE.121. To stop saving characters to a file, press Ctrl-Home again. You should see the message "Capture is OFF". If the file CAPTURE.121 can't be found, it is created. If CAPTURE.121 was found when opened, it will be opened in the APPEND mode. This means that you can toggle Capture ON and OFF as often as you like without worrying about overwriting previously saved characters. Feel free to erase CAPTURE.121 before you start ONE TO ONE. Since it is always opened in the append mode, it may grow very large over time. Please note that charcters are not automatically saved to a file. You have to press Ctrl-Home to invoke this option. Ctrl-Something: Send CTRLTEXT Messages Starting with release version 2.0 you have the ability to assign phrases to Ctrl-characters. For example, you could make Ctrl-S send the phase "I'm Sending The File In 10 Seconds, OK?". Anytime you pressed Ctrl-S, this message would be sent automatically as though you had typed it by hand (except that it is sent quickly and with no typos!). When you press the 'Ctrl' key and another character simultaneously you will send the message that is attached to that keystroke. To edit, examine, or print the messages to be used with Ctrl- characters, use the "Keys" pull-down menu. (How to use pull-down menus will be discussed shortly.) Home or F1: Help Pressing the `Home' or F1 keys will display a "help screen". After you read the help screen press any key and you will continue where you left off. Please note that there is a different help screen for the MENU MODE. If you toggle over to MENU MODE and don't know what to do, press `Home' or press F1 for help. Esc or '+': Switch Between TERMINAL MODE and MENU MODE You can press either `Esc' or the `+' key to move back and forth between TERMINAL MODE and MENU MODE. 20 MENU MODE Although you can perform the most needed activities in TERMINAL MODE, there are certain procedures that can not be accessed without going into MENU MODE. To get into MENU MODE, you press either the `Esc' key or the `+' key. Whenever you are in the MENU MODE you will notice that the words "Menu Mode" will be flashing on the Dividing Bar. This is a reminder that you cannot type messages or carry on TERMINAL MODE activities at this time. As soon as you leave MENU MODE and return to TERMINAL MODE the flashing message will clear. When you first enter MENU MODE you will notice that the Menu Bar is active because the first choice labeled "Info" will be highlighted. This indicates that if you press ENTER or the Down Arrow key, the Info menu will be pulled-down, revealing it's contents. All menus are accessed using ONE of the following methods... 1) Method Number One a) Use the Right or Left Arrow keys to highlight the desired menu title on the Menu Bar. b) Press the Down Arrow or ENTER key to pull-down the menu. c) Done! 2) Method Number Two a) Press the key corresponding to the first letter of the selection you desire. (e.g. `M' for Modem, etc.) b) Done! When you have pulled down the desired menu, you will see the contents of the menu. You are now ready to make a selection from the menu. All menu choices are accessed using ONE of the following methods... 1) Method Number One a) Use the Up or Down Arrows to highlight the selection of your choice. b) Press the ENTER key to choose the highlighted selection. c) Done! 2) Method Number Two a) Press the key corresponding to the first letter of the selection you desire. b) Press the ENTER key to choose the highlighted selection. c) Done! That's all there is to it! You simply use the arrow keys to point to what you want and then you press the ENTER key ...OR... you press the key that represents the first letter of the desired choice and press the ENTER key. When you do so, the choice that you made will be carried out. 21 If you are in a menu and don't care to make a choice (perhaps you were browsing or you chose the wrong menu), you can "escape out" of the menu buy choosing ONE of the methods below... 1) Press the `Esc' key - DONE! OR 2) Press the `+' key - DONE! OR 3) Press the Up Arrow until you pass the top selection - DONE! There are a number of choices that will take you immediately back to TERMINAL MODE. Others will leave you in MENU MODE. I hated to do this because of the inconsistencies but it just makes sense. What's the point of leaving you in the MENU MODE when you have just made the menu selection to Answer The Phone NOW!. You probably would like to start typing messages to your friend right away. Leaving you in MENU MODE just forces you to toggle back over to TERMINAL MODE. The same thing is true for Dialing The Phone. You probably would prefer to be taken back to TERMINAL MODE automatically. You will be. In the descriptions of the menus that follow, you will be told which selections take you back to TERMINAL MODE and which selections leave you in the MENU MODE. Menu Descriptions The Info Menu The Info menu is not truly a menu because it contains no choices. It simply displays the program title, version number, begs for your support of the User Supported concept, lists the address of the author, and displays a copyright notice. After you have read this menu press a key and you will be returned to MENU MODE. The Files Menu The Files menu contains choices that relate to aquiring or inspecting disk files. 1) Download - If you are ready to download (receive) a file you may choose this function. You will be prompted for the name of the file to receive. You may include a valid drive/path combination in front of the file name if you wish. After you enter the file name, ONE TO ONE will patiently wait for the sending party to begin sending the file. At this point, your friend should have told his computer that he wants to upload (send) a file. See Appendix II about the XMODEM protocol. 22 Once the computers have started transferring the file, you can just sit back and relax if you like. BUT, if the other person is also using ONE TO ONE, you can continue to type messages to each other while the file transfer takes place! In either case you will see a status report of the file transfer displayed on the Dividing Bar. After the file transfer is complete, you will hear a beeping sound indicating that the transfer is complete. If something happens and you want to abort the file transfer, press Ctrl-X and you will exit gracefully. Your screen will say "Aborted by User" and you will hear the beeps letting you know that the transfer is finished. Your friend's screen will display a similar cancelation message. ONE TO ONE will take you directly to TERMINAL MODE when this selection is made. 2) Upload - When you choose Upload, you are telling ONE TO ONE that you want to upload (send) a file to whoever you're connected to. You will be prompted for the name of the file to send. The file to send can be in any subdirectory on any drive. You are not limited to the current directory. After you enter the file name ONE TO ONE will patiently wait for the receiving party to acknowledge that it is ready to receive. At this point your friend should have told his computer that he wants to download (receive) a file. See Appendix II about the XMODEM protocol. Once the computers have started transferring the file, you can just sit back and relax if you like. BUT, if the other person is also using ONE TO ONE, you can continue to type messages to each other while the file transfer takes place! In either case you will see a status report of the file transfer displayed on the Dividing Bar. After the file transfer is complete, you will hear a beeping sound indicating that the transfer is complete. If something happens and you want to abort the file transfer, press Ctrl-X and you will exit gracefully. Your screen will say "Aborted by User" and you will hear the beeps letting you know that the transfer is finished. Your friend's screen will display a similar cancelation message. ONE TO ONE will take you directly to TERMINAL MODE when this selection is made. 3) View A File - This selection acts like the TYPE command in DOS. It allows you to view a text file from within ONE TO ONE. When you choose View A File you are prompted for a filename to view. The file to view can be in any subdirectory on any drive. You are not limited to the current directory. After you enter the file name, the screen will "open up" in the middle to create an 80-column area in which to view the file. Directions will be displayed toward the bottom of the screen. You have the option to Start/Stop the scrolling by pressing Ctrl-S or you may Abort by pressing the `Esc' key. After the file has been displayed you will be prompted to press any key to continue. When you do so, you will return to MENU MODE. 23 4) Share A File - This is a nifty feature! Share A File gives you the ability to share a text file with a friend. One of you acts as the Sender and the other acts as the Receiver. BOTH USERS MUST BE USING ONE TO ONE FOR THIS FEATURE TO WORK PROPERLY. When you and a friend Share A File, your screens change into a large area at the top two-thirds of the screen. The bottom portion of the screen is split into 2 sections so that you may continue to type to each other while sharing the file. It works like this; you, (the Sender) enter the name of the text file to share. (Meanwhile your friend has told ONE TO ONE that he will act as the Receiver.) Immediately, both screens change to the viewing screen described in the above paragraph. The text file is then displayed, line by line, in the viewing area of both screens. Both of you have control of when to pause or when to abort the viewing of the file. At any point you may pause (by pressing Ctrl-S) and start typing messages to each other about what you are seeing on the screen. Why hasn't this been done before? When the entire file has been displayed (or you aborted the listing) you will be prompted to press a key to continue. When you press a key you will be returned to TERMINAL MODE. 5) Directory - This is EXACTLY like the DOS DIR command. You will be prompted for a file specification that could contain a Drive_Letter/Directory/Filename_or_Wildcards. Enter your choice just as though you had typed "DIR " in front of your file specification. An example: typing A:\LETTER\FRED.* would be sent to DOS as DIR A:\LETTER\FRED.* - thereby producing a directory listing of Drive A:, Directory LETTER, File everything related to FRED. It should be noted that this command requires ONE TO ONE to be able to find the file COMMAND.COM on your program disk. If COMMAND.COM cannot be found, this command will not work. Hard disk users will not have a problem with this. Floppy disk users will want to copy COMMAND.COM to the ONE TO ONE program disk. This selection returns you back to MENU MODE. 6) Save OPTIONS.121 - The OPTIONS.121 file holds all of the options that you selected when you ran ONE TO ONE for the first time. (Remember when you were prompted for all those questions?) Starting with release version 2.0 you can save the current parameters so that they will be active the next time that ONE TO ONE is executed. The parameters that are affected by this are: 1) Position of the Dividing Bar. 2) Baud Rate and Communications Port. 7) Visit DOS (Shell) - Choosing this selection allows you to put ONE TO ONE "on hold" and drop back to DOS. You are then free to change directories, format disks, use a text editor, or anything else you might want to do before returning again to ONE TO ONE. When you are finished with your DOS chores, type EXIT and press ENTER. You will be right back in ONE TO ONE as though you'd never left. 24 Note: This feature has a couple of requirements... 1) Your computer must have enough memory to have ONE TO ONE and whatever other program you want to run be resident at the same time. 2) ONE TO ONE must be able to find the file COMMAND.COM somewhere in your system. For technically-minded users: When Alt-X is pressed, ONE TO ONE tries to invoke another copy of COMMAND.COM in order to create a "DOS shell". If it can't find COMMAND.COM you will see a message saying that it failed to load the second copy of COMMAND.COM and you will be returned to ONE TO ONE. You will have to experiment to see if this will work on your system. Hard disk user's should have no problem. Floppy disk user's will have to copy COMMAND.COM from their "boot disk" onto their ONE TO ONE disk for this to work properly. Give it a try. This selection returns you back to MENU MODE. 8) Exit To DOS - When you select this choice, you will be asked to confirm your request. If, in response to the "Are you sure?" question, you press the `Y' key, you will be taken back to the DOS prompt and ONE TO ONE will shut itself down. If any other key besides `Y' is pressed, you will return to where you left off. This selection returns you back to MENU MODE. The Modem Menu The Modem menu contains choices that relate to both the Modem and the Communications port. 1) Reset The Modem - Issues the same Modem Initialization String that you set up when you created the OPTIONS.121 file during installation. If you chose the default modem initialization string, the following will occurr... The default modem initialization string performs the following commands; Waits 1.5 seconds, Takes the modem off-line, Waits another 1.5 seconds, issues the ATZ command to reset the modem, Waits another 1.5 seconds, and issues the ATV1 command to set the modem result codes to WORDS instead of DIGITS, then it issues the ATE command to disable the modem from echoing your keystrokes back into the receive buffer. If you decided to create your own initialization string, it will be sent to the modem at this time. What does it do? Gosh, I don't know. After the initialization string has been sent to the modem you will be returned to TERMINAL MODE. 2) Online - This issues the Hayes ATO command to allow you back into the Online state. You only need to use this if you have used the Offline command described below. After the ATO command has been sent to the modem you will be returned to TERMINAL MODE. 25 3) Offline - This selection is used when you are connected with a friend on the phone and you want to drop into the Offline state to issue modem commands. You will rarely, if ever, use this feature. This one is available for the so-called Power User. The Offline choice issues the `+++' characters to the modem in order to take the modem out of the Online state. Use the Online option, described above, to return to the normal connection. This selection keeps you in the MENU MODE. 4) Change Parameters - You may wish to change baud rates or communication ports while ONE TO ONE is running. For example, you may be called by a friend at 300 baud while your modem is set at 1200 baud. Selecting Change Parameters allows you to immediately change parameters so that you are now connected at the same baud rate. When you select Change Parameters, a window will appear with a list of parameters to choose from. The parameters at the top of the list are for communications port #1 (com 1), and the bottom choices are for port #2 (com 2). Press the key representing your choice or press the ENTER key if you want to keep your current parameters. ONE TO ONE always uses 8 data bits, 1 stop bit, and No parity. You will not be allowed to change these parameters. (These parameters are required by the XMODEM file transfer protocol.) This selection returns you to TERMINAL MODE. 5) Edit Modem Initialization - You may want to change your modem initialization string at some time in the future. For instance, you may have installed ONE TO ONE a long time ago and selected the default initialization string. Now you are a true "power user" and have decided to alter some of the default S registers, etc.. This menu choice allows you to change the way that the modem is configured when ONE TO ONE starts. When you select this option you will see the current modem initialization string displayed. You may now edit the string, using your modem commands. The special characters are shown below the editing line. The special characters are... 1) ~ = .5 seconds of delay for each ~ that is encountered. 2) { = Simulates pressing the ENTER key. 3) ^ = Treats the following character as a Ctrl-character. Please note that you can press the 'Esc' key at any time and no changes will be saved to disk. Otherwise, when you have finished editing, press the ENTER key and the changes will be saved for future use. To place these changes into effect, use the 'Reset The Modem' choice on this menu. (Choice #1, described above) 26 The Phone Menu 1) Dial The Phone - Select this option if you want to dial the phone. When you do, a dialing directory will be displayed. The directory has room for 10 entries. (This may expand in a future update.) At the bottom of the screen you are presented with several options. PgUp) Show Previous List Of 10 Numbers PgDn) Show Next List Of 10 Numbers R) Revise an Entry - Prompts you to enter names and numbers. E) Erase an Entry - Allows you to "wipe out" an existing entry. M) Manual Dial - You dial a number from the keyboard. D) Dial an Entry - Asks "Which Entry?" then dials it for you. Q) Quit - Takes you back to TERMINAL MODE. After a phone number is dialed you will be taken back to TERMINAL MODE where you will wait for the CONNECT message to appear in the Incoming Text window. If you see the word CONNECT, you have established a connection with the person that you called. If instead, you see NO CARRIER, a connection could not be established. This selection returns you to TERMINAL MODE. 2) Hang Up The Phone (Disconnect) - This command first sends the `+++' characters to the modem and then sends the Hayes ATH command to hang up the phone. The `+++' characters puts the modem in command mode. See your modem manual for a more thourough explanation. If you were connected to another computer when you made this selection, you should see the NO CARRIER message appear in the Incoming Text window after a few seconds have passed. This selection returns you to TERMINAL MODE. 3) Answer The Phone - When you make this choice, the Hayes ATA command is sent to the modem. The ATA command tells the modem to answer the phone now without waiting for a ring. Before you choose Answer The Phone, you should first see the word RING in the Incominig Text window. This is your indication that the phone line attached to the modem is ringing. If a connection is established, you should see the word CONNECT appear in the Incoming Text window, otherwise, the message NO CARRIER will appear. If you make this selection when the phone isn't ringing, just press a key and the modem will stop trying for a connection. This selection returns you to TERMINAL MODE. 4) Take Phone Off Hook - This selection issues the Hayes ATH1 command to take the phone off the hook. Anyone that tries to call you after this has been done will get a busy signal. To put the phone back on the hook, choose the selection described below. This selection returns you to TERMINAL MODE. 27 5) On Hook - This selection issues the Hayes ATH0 command to put the phone on the hook (hanging up the phone). This option is used after issuing the Take Phone Off Hook command described above. You should note that, unlike choice number 2 above, this selection does not put the modem into command mode first. If you use this selection while "on-line" with a friend, the ATH0 will be sent to your friend instead of your modem. Therefore, only use this feature when you know that the modem is in the command mode. This selection returns you to TERMINAL MODE. 6) Go From Voice to Data - Sometimes you might want to start a phone call (like normal people) with a handset. Then you might want to just hang up and let your computers take over and establish a connection without having to re-dial the number. This selection allows you to do just that. Please be aware that in order for this feature to work, both you and your friend must have your phones and modems active at the same time. Most modems today are made so that your phone can plug into them. If you must unplug your phone and plug the cord into your modem every time you want to use it, this feature is not for you. After you and a friend are talking on the phone, both of you should make this selection from the Phone menu. At this time, while talking, the two of you should decide who will act as the Caller and who will act as the Answerer. After the decision has been made as to who will play which roles, you both should press the appropriate key that corresponds to the roles that you are playing. (The Caller presses `C' and The Answerer presses `Ctrl-Shift-O'. No, that's not right, the Answerer presses `A'. I just wanted to be sure that you were paying attention.) After you press the correct keys, you should both hang up the phone and let the computers do the rest. You should see the word CONNECT appear in the Incoming Text window. If you don't then something happened and you are going to have to call via computer. NOTE: Both parties don't nessacarily have to be using ONE TO ONE for this to work. When The Answerer presses `A', the Hayes ATA command is sent to the modem. When The Caller presses `C', the Hayes ATD command is sent to the modem. You could just as well have typed these commands in TERMINAL MODE but that takes a lot of the mystery out of it, doesn't it? 7) Go From Data To Voice - This option performs the function of hanging up the phone so that you and your friend can speak to one another without having to redial the phone. You MUST pick up the receiver on the phone before making this selection, otherwise you will hang up the phone. (No good!) Please be aware that this is THE VERY SAME THING as pressing Alt-H in terminal mode. Pressing Alt-H is MUCH easier to do. This choice is available on the menu for the sake of completeness. How it works --- If you answer the phone in the kitchen and you want to switch to the phone in the bedroom, all you have to do is 1) hang up the phone in the kitchen and 2) run like a bat out of hell to the bedroom to pick up the phone before you are disconnected. There is a 10-15 second delay between the time that the receiver is placed on the hook and when the phone lines are actually disconnected. If you and your friend have your phones off the hook when your modems disconnect, you will be able to pick up where your modems leave off. Try it, you'll like it! (Using Alt-H instead of this menu selection is less tedious.) 28 8) Select Dialing Mode - This menu choice allows you to select whether you have TouchTone or Pulse dialing service. (You were prompted for this information the first time you ran ONE TO ONE) Choose TouchTone or Pulse by pressing 'T' or 'P', respectively. After you make a selection, the new dialing mode will be written to disk saving it with your other parameters. Please note that you can press 'Esc' at this point and "escape" out of this option. The Toggles Menu The Toggles menu contains choices that are turned ON or OFF. When you pull down the Toggles menu you can easily tell the ON or OFF status of the selections. Selections that are turned ON will be displayed with an asterisk just in front of the selection name. If instead, the choice is turned OFF there will be no asterisk in front of it's name. For example... Chat (Wait for CR) * Capture Keystrokes * Auto-Answer Shows that Chat mode is turned OFF but the other two selections are turned ON. 1) Chat (Wait for CR) - When you and a friend are typing messages to each other, every key that you press goes out to your firend's computer. If you make a mistake while typing (and press the BACKSPACE key), this too goes out to your friend. Your friend watches you make a mistake, back up to it, correct it, and then continue on. Meanwhile, he already knew what you were trying to say. This can be annoying after a while. There's a better way. It's called Chat Mode. When you make this selection, your keystrokes will be saved in a buffer until you press the ENTER key. Then all of your typing will be sent at once. Your friend will never know that you made mistakes while you were typing. While you are in Chat Mode you will still see your friend's characters arriving in the Incoming Text window as usual. The only indication that anything is different is the message that appears on the Dividing Bar. It says, "Chat Mode - Press `Esc' to return to normal mode". While you are in Chat Mode you can't make any other menu choices. You must press the `Esc' key to return to normal TERMINAL MODE first. 2) Capture Keystrokes - If you want to save the incoming characters to a file, make this selection. When you do, you will see a little message pop up saying that "Capture is ON" and all incoming characters typed by your friend will be saved to a file named CAPTURE.121. To stop saving characters to the file, make this selection again. You should see the message "Capture is OFF". If the file CAPTURE.121 can't be found, it is created. If CAPTURE.121 was found when opened, it will be opened in the APPEND mode. This means that you can toggle Capture ON and OFF as often as you like without worrying about overwriting previously saved characters. Feel free to erase CAPTURE.121 before you start ONE TO ONE. Since it is always opened in the append mode, it may grow very large over time. Please note that incoming charcters are not normally saved to a file. You have to select this option first. 29 3) Auto-Answer - This issues the Hayes ATS0=1 command to put the modem in Auto-Answer mode. The phone will now be answered by the modem on the first ring. Making this selection again issues the Hayes ATS0=0 command to tell the modem not to answer the phone at all. NOTE: Please be aware that the phone MUST NOT BE RINGING when Auto- Answer is invoked. If the phone is ringing before you had a chance to set Auto-Answer, do one of the following... If you're in MENU MODE: Choose "Answer The Phone Now" from the Phone menu. If you're in TERMINAL MODE: Press Alt-A to answer the phone. You will be returned to the TERMINAL MODE after making this selection. 4) Modem Echo - Modem Echo determines whether the modem should echo every character that you type. If Modem Echo is ON, every key that you press will appear in both the Incoming Text window AND Outgoing Text window. You'll hardly ever use this. It does come in handy for checking to see whether your modem is hanging in there. It could also allow you to talk to yourself if you can't find anybody else at home. (Make sure nobody sees you.) You will be returned to the TERMINAL MODE after making this selection. 5) Incoming Key-Clicks - When this is turned ON you will hear a faint "clicking" sound whenever your friend types a character. This can be handy. You may not be paying attention to the Incoming Text window but the "clicks" will alert you to an incoming message. As you would expect, choosing Incoming Key-Clicks again will turn the "clicks" OFF so as not to disturb you. NOTE: The initial status of Incoming Key-Clicks is determined by whether or not you chose this option when you first installed ONE TO ONE. You can save all of the current parameters (including Key-Click status) by using the 'Save OPTIONS.121' choice in the "Files" pull-down menu. You will be returned to the TERMINAL MODE after making this selection. The Screen Menu 1) Clear Both Screens - Making this selection will cause the Incoming Text, Outgoing Text, and Dividing Bar to be cleared of their current contents. You will be returned to the TERMINAL MODE after making this selection. 2) Clear Incoming Screen - Making this selection will cause the Incoming Text window to be cleared of it's contents. The Outgoing Text window will remain unchanged. You will be returned to the TERMINAL MODE after making this selection. 3) Clear Outgoing Screen - Making this selection will cause the Outgoing Text window to be cleared of it's contents. The Incoming Text window will remain unchanged. You will be returned to the TERMINAL MODE after making this selection. 30 4) Adjust Dividing Bar - The Dividing Bar seperates the Incoming Text from the Outgoing Text. You may prefer to have more or less room to type the outgoing text. You use this option to allow you to position the Dividing Bar to suit your tastes. After you make this selection, you may use the Up and Down Arrows to move the bar up or down. Press `Esc' when you are satisfied with the Dividing Bar's position. You will be returned to the TERMINAL MODE after making this selection. 5) Change Monitor Types - This choice allows you to switch color schemes that ONE TO ONE uses. You can choose between 1) Monochrome 2) Color or 3) Monochrome with shades of grey. (You were prompted for this information when you ran ONE TO ONE for the first time.) At this point you can press the 'Esc' key and nothing will be changed. Any valid choice will cause the parameters to be saved and the screen to change colors to reflect your choice. The Keys Menus 1) Edit CTRLKeys - You can have messages attached to keystrokes. When you hold down the 'Ctrl' key while pressing an A-Z key you can send the message that is attached to that keystroke. This menu selection allows you to define and attach messages to the Ctrl-characters. When you make this selection you are prompted to press the Ctrl- character to edit. You can press any of the Ctrl-characters with the exception of 4 special cases. You cannot use the 4 following Ctrl-characters to send messages... Ctrl-H: This is the same as a backspace. Ctrl-J: This is the same as a Line-Feed. Ctrl-M: This is the same as the ENTER key. Ctrl-X: ONE TO ONE reserves the Ctrl-X key for file transfer use. Any keys EXCEPT the above 4 can be defined and used with Ctrl- character phrases. After you press the Ctrl-character of your choice, you are allowed to enter (or edit) the phrase to be attached to this keystroke. There are 2 special symbols that can be embedded in your message... 1) ^ = Causes a BEEP to be sent 2) { = Causes a Carriage Return (ENTER key) to be sent When you have finished defining your message, press the ENTER key. At this point you can define more keys OR press 'Esc' to let ONE TO ONE know that you are finished. If you have made changes you will be asked whether you would like to "Save The Changes To Disk?". If you press "Y", the CTRLTEXT.121 file is updated to reflect your new changes. 2) Show CTRLKeys - When this selection is made, the messages attached to Ctrl-characters will be displayed in a scrolling window on the screen. While the phrases are being scrolled up the screen, you may press 'Ctrl- S' to Start and Stop the scrolling. (You are also allowed to press 'Ctrl- X' to abort.) This can be a handy feature if you need a reminder of what is attached to what. A better way is described next... 31 3) Print CTRLKeys - This selection will print the currently defined Ctrl-characters and their attached messages to the printer. This is highly reccomended! If you define all of your keys and keep a list posted beside your computer, your life will be much fuller and you will magically obtain great wealth! Your children will behave, your car will get better mileage, and your mortgage will be paid off by an unknown benefactor. (Just kidding, of course. Cliff Batson's comments should not be considered as investment advice.) 32 Tips And Tricks Ctrl-Character Messages ----------------------- Starting with release version 2.0 you can attach phrases to your Ctrl-Characters so that, for example, pressing 'Ctrl-S' could send the message "Send The File In 10 Seconds, OK?". This is a neat and handy feature! This feature was added after much use of ONE TO ONE. I began to realize that during a series of "Conversations" I typed the same messages several times. Below are some suggestions for possibble messages to use. Ctrl-C: "Call me back, voice. OK?" Ctrl-G: "Greetings. Take me to Bill Gates." Ctrl-I: "^Interrupt..." Ctrl-N: "Nobody talks about my mama!" Ctrl-P: "Pick up the phone now. OK?" Ctrl-Q: "Quit Interrupting!" Ctrl-T: "Let's transfer the file in 10 seconds. OK?" Ctrl-W: "What do you mean?" You get the idea. Use your imagination. (I have a friend who has attached insults to his Ctrl-Characters.) This is a fun feature! Call-Waiting Problems --------------------- If you have Call-Waiting you stand the risk of having problems with your telecommunicating. I would suggest that you add the command to disable Call-Waiting to the front of every phone number in your dialing directory. Touch Tone Users: Add "*70," (no quotes) to the start of each number. Pulse Users: Add "1170," (no quotes) to the start of each number. This will disable Call-Waiting for the duration of this one call only. Go From Data To Voice --------------------- When you have finished transferring files and want to go back to voice communications, do the following: 1) Type a message to your friend telling him/her to "Pick up the phone and press Alt-H". 2) Perform step number 1 now. (practice what you preached.) In a few seconds you should hear the modems disconnect and you will be able to talk to each other again. Change Options -------------- In the old days (version 1.0), you had to erase OPTIONS.121 and re- start ONE TO ONE in order to change certain parameters. Version 2.0 lets you save the current parameters to disk with a new menu choice on the "Files" menu. When you select 'Save OPTIONS.121' on the "Files" menu, the current parameters will be saved to disk. The next time that you use ONE TO ONE, these changes will take effect automatically. 33 Something you should be aware of... whenever the parameters are saved, ALL of the parameters are saved. This means that you have to take precautions about having your parameters set to your satisfaction BEFORE you save the OPTIONS.121 file to disk. For example, let's say you changed baud rates to talk to your friend who has a slower modem. (Are you saying it?) Then you decided to adjust the dividing bar. When you finish adjusting the dividing bar you are prompted "Save Changes To Disk?". If you answer 'Y' (yes) then ALL of your parameters will be saved to disk. The next time you run ONE TO ONE, it will put your modem in the slower baud rate automatically. Be aware of this and you can avoid a mysterious hassle. If you have any tips or tricks using ONE TO ONE, send them in! Write me at the address below... Tips And Tricks C/O Digital Transit 3360 Towneship Road Antioch, TN 37013 34 Final Remarks It has been two months since I released version 1.0 of ONE TO ONE. I didn't expect to upadte it this quickly. However, after spending quite a bit of time using it, I was aware of some areas that could be improved. Also, I received quite a bit of feedback from you. I hope that you enjoy this new version of ONE TO ONE! I also hope that you will feel motivated to help support the development of this project. If you are using ONE TO ONE two weeks after you first tried it, you are a prime candidate for becoming a registered user! If you are basically an honest person but you just keep forgetting to pay for your "ShareWare" programs, do what I do - I write the name, address, and amount down on a piece of paper and throw it in with my pile of bills to pay. After paying my bills I seem to always have an extra $15 or $20 left. I hope you are in the same boat. If you want to be a part of the ONE TO ONE project, show me. Send in your payment if you like the product. If you have suggestions you can write to me. If you would prefer to leave a message for me on my answering machine, you may do so. Call 615-361-3655 during WORK HOURS. (Normal work hours, NOT programmer's work hours.) 35 Appendix I ONE TO ONE - User Registration Form ---------------------------------------------- (Registration for ONE TO ONE version 2.2) Please Print Date:__/__ /__ Name:__________________________________________________________ Company:__________________________________________________________ Title:__________________________________________________________ Address:__________________________________________________________ :__________________________________________________________ :__________________________________________________________ Phone #:__________________________________________________________ ========================================================================= COMMENTS, SUGGESTIONS:___________________________________________________ _________________________________________________________________________ _________________________________________________________________________ _________________________________________________________________________ _________________________________________________________________________ _________________________________________________________________________ Use The Back Of This Form If You Need More Room. Please Register Me For #_____ Copies Of ONE TO ONE (Suggested Contibution: $15.00 - $20.00 per copy) Enclosed is my check or Money Order for $__________ Make Checks Payable To: Digital Transit Digital Transit 3360 Towneship Road Antioch, TN 37013 36 APPENDIX II - ONE TO ONE and XMODEM ONE TO ONE uses the XMODEM file transfer protocol. XMODEM, developed by Ward Christenson and others in the late 1970's, has become a standard method of transferring files over phone lines. When a file is transferred using the XMODEM protocol, the file is broken into 128 character blocks of data. Each block is sent sequentially. Actually, more than 128 characters are sent in one block. The format of an XMODEM block is listed below: OFFSET INTO BLOCK CHARACTERS ----------------- ----------------------------- 0 Start Of Header (ASCII 1) 1 Block Number (starts with #1) 2 One's Compliment of Block Number 3 - 130 128 Bytes Of File Being Transferred 131 Checksum. ------------------- Total: 132 CHARACTERS IN EACH BLOCK ONE TO ONE allows you to type during file transfers by exchanging keystroke data between blocks. At 1200 baud, a block is sent approximately every 1.3 seconds. This means that you will see the incoming messages updated every 1.3 seconds. Although it may appear to be a little "jerky", it beats the heck out of twiddling your thumbs while you wait for your file transfer to be completed! Of course, at 2400 baud its half as jerky. Now THERE'S a good excuse to rush out and buy a new modem. "But Honey, my keystrokes will be less jerky now that I've spent our pension on some new hardware!". Maybe YOUR spouse will understand. 37 APPENDIX III - The 121PATH Environment Variable Starting with version 2.0, you can tell ONE TO ONE where to look to get all of the needed configuration files. This means that you will now be able to run ONE TO ONE from anywhere on your hard disk and the set up files will automatically be found. It's also good news for those with Local Area Networks. These people will now be able to keep 1 copy of ONE TO ONE in a public directory and each user can set their 121PATH variable to point to his/her own private phone directory, Ctrl-Character messages, etc.. This is possible because ONE TO ONE now has the ability to examine the environment variable table maintained by DOS. The environment variable is called 121PATH. To use it, insert the following lines in your AUTOEXEC.BAT file: PATH=\PATHNAME SET 121PATH=\PATHNAME where PATHNAME is the name of the directory in which ONE TO ONE lives on your disk. Reboot your machine for these changes to take effect. Now What? Now, whenever you run ONE TO ONE, DOS will find it for you because you set the PATH variable to "point" to it. Next, ONE TO ONE will look to see if you have defined the environment variable 121PATH. If it finds it defined, ONE TO ONE will get the correct path from your 121PATH variable and load the OPTIONS.121, PHONEDIR.121, and CTRLTEXT.121 files from this directory. This means that you can be anywhere on the hard disk and your files will be found. You can change directories to the directory where you will be downloading files and run ONE TO ONE from there. That way, you won't have to type in long Drive/Path/File names since you will already be in the default directory for downloading. Very nice. Please note that THIS IS NOT REQUIRED to run ONE TO ONE. You may continue to use it without the 121PATH environment variable, as you have in the past. However, it is a very convenient feature. 38 Appendix IV - Phone Directory Structure For Programmers Only: The phone directory entries are held in an array of 100 structures. The structure definition is shown below: struct dial_info { /* Each entry is stored in a copy of this */ int in_use; /* Whether or not this number is in use */ char name[31]; /* The name of the person to call */ char number[21];/* The phone number to dial (ascii) */ int baud; /* Baud rate for this phone number */ char parity; /* Always set to 'N' for NONE */ int databits; /* Always set to EIGHT */ int stopbits; /* Always set to ONE */ }; 39 Appendix V - OPTIONS.121 Structure For Programmers Only: The OPTIONS.121 file is the configuration file for ONE TO ONE. If this file can't be found when ONE TO ONE is run, the program will prompt you to "answer a few questions..." so that this file can be created for future use. The file OPTIONS.121 is stored on disk as a binary file. The contents of the structure below are written to disk 1) When the program can't find an existing copy of OPTIONS.121 to read or 2) Whenever you tell ONE TO ONE to save whatever changes you have made from the pull-down menus. struct config{ /* configuration structure for ONE TO ONE */ int version; /* Version number of this file (2) */ int port; /* Com port -1 (port 1 = 0, port 2 = 1)*/ int baud; /* Baud rate to intialize port */ int databits; /* Always set to EIGHT */ char parity; /* Always set to 'N' for NONE */ int stopbits; /* Always set to ONE */ int sound; /* 1 Key-Clicks ON, 0 Key-Clicks OFF */ int screencolor; /* Attribute of full screen color */ int pldncolor; /* Attribute of pull-down menus */ int msgcolor; /* Attribute of pop-up messages */ int divide_row /* Row for the dividing bar to appear */ int tone_or_pulse; /* 0 = Touch-Tone, 1 = Pulse */ char modeminit[241]; /* Modem initialization string */ }; 40 Appendix VI - ONE TO ONE Programming Trivia Programming Information ----------------------- This information is included for the terminally curious (pun intended). Equipment: 1) AT&T PC 6300 (640k, Hard Disk, Qubie' modem) 2) Compaq Portable (with Null Modem Cable) 3) IMS AT-Clone (42m Hard Disk, Qubie' 2400 modem) Languages: The C programming language and 808x Assembler. C Compiler: Microsoft C Compiler (version 4.0) Assembler: Microsoft Macro Assembler (version 4.0) Other: Greenleaf Function Library (version 3.03) Greenleaf Comm Library (version 2.03) When: Late August, 1986 - Mid December, 1986 (version 1.0) Mid January, 1987 - Mid February, 1987 (version 2.0) Mid March, 1987 - Mid March, 1987 (version 2.1) Where: Antioch, TN (Suburb of Nashville)