Programmer 7500

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

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / 1TO1_V23.ZIP / 121.DOC < prev next >

Wrap

Text File | 1988-06-28 | 84.5 KB | 2,647 lines

@CB O N E T O O N E (tm) Personal Communications Software Version 2.3 R E F E R E N C E M A N U A L Digital Transit 3360 Towneship Road Antioch, TN 37013 Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 2 WARRANTY A lot of time and effort have gone into making ONE TO ONE a unique and efficient communications program. Comments from current users indicate that the program works and works well. However, on the off chance that something unfortunate does occur we must state the following: 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. Digital Transit is making ONE TO ONE available through the User Supported concept of software distribution. IF THIS PROGRAM DOESN'T FIT YOUR NEEDS ... DON'T BUY IT. However, if you do use this program and then find that it doesn't work as claimed, let us know. We should be able to fix most anything within 48 hours. We don't expect to receive your money UNTIL you are satisfied! Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 3 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. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 4 TABLE OF CONTENTS WARRANTY..................................................... 2 TRADEMARKS................................................... 3 WHAT IS ONE TO ONE? ......................................... 5 SHAREWARE NOTES ............................................. 6 ACKNOWLEDGMENTS ............................................. 8 CONVENTIONS USED IN THIS MANUAL ............................. 9 SYSTEM REQUIREMENTS ......................................... 10 ONE TO ONE SYSTEM FILES ..................................... 11 GETTING STARTED ............................................. 13 STARTUP OPTIONS ............................................. 15 PRIMARY SCREEN DISPLAY ...................................... 16 TERMINAL & MENU MODES ....................................... 17 TERMINAL MODE KEYSTROKE COMMANDS ............................ 19 Alt-A: Answer The Phone ..................................... 19 Alt-C: Clear The Screen ..................................... 19 Alt-D: Dialing Directory .................................... 19 Alt-H: Hang Up The Phone .................................... 19 Alt-M: Modem Echo ........................................... 20 Alt-P: Change Parameters .................................... 20 Alt-R: Redial The Last Number ............................... 20 Alt-T: Chat Mode ............................................ 20 Alt-X: Exit To DOS .......................................... 21 Alt-Z: Visit DOS (Shell) .................................... 21 PgUp: Upload (Send) A File .................................. 21 PgDn: Download (Receive) A File ............................. 22 Ctrl-Enter: End of Message Indicator ........................ 22 Ctrl-Home: Capture Keystrokes ............................... 22 Ctrl-Keystroke: Send CTRLTEXT Messages ...................... 22 Home or F1: Help ............................................ 22 Esc or `+': Switch From Terminal To Menus ................... 22 MENU MODE ................................................... 23 MENU DESCRIPTIONS THE INFO MENU............................................ 24 THE FILES MENU .......................................... 24 THE MODEM MENU .......................................... 27 THE PHONE MENU .......................................... 28 THE TOGGLES MENU ........................................ 30 THE SCREEN MENU ......................................... 32 THE KEYS MENU ........................................... 33 TIPS AND TRICKS ............................................. 34 FINAL REMARKS ............................................... 36 APPENDIX I ORDER FORM ..................................... 37 APPENDIX II ONE TO ONE AND XMODEM .......................... 38 APPENDIX III PHONE DIRECTORY STRUCTURE ...................... 39 APPENDIX IV OPTIONS.121 STRUCTURE .......................... 40 APPENDIX V COMMUNICATIONS PORT ADDRESSES .................. 41 APPENDIX VI ONE TO ONE PROGRAMMING TRIVIA .................. 42 Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 5 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 are less than desirable when it comes to two human beings trying to communicate over the phone lines via modem. ONE TO ONE is the first communications program available that attempts to address the special needs of people sharing data with other people. What does ONE TO ONE offer that the others don't? With ONE TO ONE, you and your friends can: o Type messages to each other while a file transfer is in progress! o Never worry about garbled text caused by two people typing at the same time. Incoming and Outgoing text appear in separate windows on screen. o "Share" a text file. You and a friend can be looking at the same text file simultaneously. 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. o Best of all ... the price is right! A suggested contribution of $15- $20 is cheap at twice the price. ONE TO ONE is an excellent communications program designed with the `friend to friend' computer network in mind. With a little practice you will find it to be a very useful, interactive and entertaining file transfer utility. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 6 SHAREWARE NOTES A Computer without software is like a toaster without bread. Without software, our computers are useless so we buy the programs that put expensive hardware to work. Unfortunately, computer software is very expensive which makes it tough to get EVERYTHING we need. What's even worse is that very few commercial software dealers allow us to open their package, try it out and return it if we don't like it. Those that do always charge an outrageous re-stocking fee. Then along comes User Supported software. The basic idea 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: o Try before you buy. If you don't like it, don't buy it! o The price is right. You don't pay for marketing overhead. o 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. o Updates are more frequent. The programmers are frequently in close contact with the users and modify the programs based on user input. The programs are then distributed via modem not dealer/distributor networks. The documentation is a file on the program disk. No waiting for a new and expensive reprinting of the manual. Disadvantages: o Telephone support is hard to come by. (I've never needed any from a User Supported product.) o Latest figures indicate that less than 10% of the users actually pay the author for the program. o This is the reason for the first disadvantage. It's hard for someone to give up a PAYING job as a professional programmer to support NON-PAYING users. There are several packages I like but think the author is asking too much so I've stopped using them. Perhaps I should have sent the author what I think the program is worth and risk hurting his/her feelings. Anyway, you know where I stand. A suggested price of $15-$20 is a bargain considering the quality of the product. If in your opinion you think it's only worth $5, SEND IT IN. However, if you send less than Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 7 $15.00 please send a note letting us know what we can do to make ONE TO ONE more valuable. Clearly, the User Supported concept is advantageous 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 the programs you use. Before I put the soap box away... ONE TO ONE is a professional-quality software package that is being distributed 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 3360 Towneship Road Antioch, TN 37013 Whether you decide to use ONE TO ONE 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: o 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.) o The program and documentation must be distributed together. o The program and documentation must be unmodified. o ONE TO ONE may not be distributed in association with any other product or service unless an arrangement has been negotiated with Digital Transit. Distributors 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 license, or in bundling ONE TO ONE with another product, please contact the author at the above address. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 8 ACKNOWLEDGEMENTS Thanks, Jan and Chris, for your patience. Thanks, Microsoft, for Microsoft C - the BEST MS-DOS C COMPILER. Thanks again, Microsoft, for the MASM Assembler (ver. 5.1) 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 9 years. Thank you, Steve Bell, for your expert help in editing the documentation of ONE TO ONE. Thanks to all of the registered users of ONE TO ONE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 9 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 and THEN press the "Something" key ... at the same time. EXAMPLE: Alt-X ... Press "X" WHILE the "Alt" key is depressed. Also, whenever you see "Ctrl-something" it means to press and HOLD the "Ctrl" key while you press the "something" key at the same time. EXAMPLE: Ctrl-X ... Press "X" WHILE the "Ctrl" key is depressed. There are keys we'll use 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 or toward the upper right corner if you have a newer model. (Why they switched it is beyond me.) The "Numeric Keypad" generally found on the right side of the keyboard is also important. 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 behaves like the CAPS LOCK key.) In numeric mode, the keys generate numbers much like a calculator. In the direction mode, the other markings that appear on the keys are active. For instance 8, 2, 4 and 6 move the cursor UP, DOWN, LEFT and RIGHT respectively (these keys are marked with arrows). Keys 7, 1, 9 and 3 are used for HOME, END, PAGE UP and PAGE DOWN cursor movement. Most keyboards have the PAGE UP and PAGE DOWN keys abbreviated. They are referred to in this manual as PgUp and PgDn. The RETURN key is known as the ENTER key in IBM manuals. It is located on the right side of the keyboard and marked with a crooked arrow pointing to the left. For consistency it is referred to as the ENTER key. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 10 SYSTEM REQUIREMENTS ONE TO ONE requires the following: o IBM Compatible Computer o PC-DOS Or MS-DOS (Version 2.1 or later) o One Floppy Disk Drive (hard disk not required) o 192k Of RAM minimum o One RS-232 Serial Port o HAYES COMPATIBLE modem (supporting the Hayes AT command set) o An operating telephone line. o Someone To Call ONE TO ONE works with Monochrome as well as Color video cards. If you have an EGA or VGA display card, 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. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 11 ONE TO ONE SYSTEM FILES ONE TO ONE Version 2.3 is distributed in an archived form. The "ARC" archiving utility by System Enhancement Associates was used to compress the files 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 saves money in the long run so why not go ahead and pay for it? The name of the archived file is 121-V23.ARC. After "un-arching" this file you will see the files listed below: 121.EXE - The program. 121.DOC - The documentation for the program. 121SORT.EXE - A utility to sort a ONE TO ONE phone directory. 121SORT.DOC - The documentation for 121SORT.EXE. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes on improvements in the current version. The only file required to start ONE TO ONE is 121.EXE. When you run the program for the first time ONE TO ONE looks for other files and creates them if they are not found. Those files are: OPTIONS.121 OPTIONS.121 is the file that holds the current configuration parameters for your system. If the file OPTIONS.121 is not found it will be created automatically after asking you several questions. Floppy users should remove the write protect tab before startup. PHONEDIR.121 The phone directory file is named PHONEDIR.121. When you access the dialing directory, PHONEDIR.121 is read from disk. If ONE TO ONE can't find the directory, it creates a blank one and writes it back to disk. CTRLTEXT.121 Beginning with Version 2.2 you have the ability to assign phrases to Ctrl-characters. For example, you could assign Ctrl-S the phrase "I'm Sending The File In 10 Seconds, OK?". When Ctrl-S is pressed this message would be sent automatically as though you had typed it by hand. It is sent quickly 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. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 12 Listed below is a brief summary of all files associated with ONE TO ONE Version 2.3: 121-V23.ARC - The archived distribution form of ONE TO ONE. After un-archiving: 121.EXE - The program. 121.DOC - The documentation for the program. 121SORT.EXE - A utility to sort a ONE TO ONE phone directory. 121SORT.DOC - The documentation for 121SORT.EXE. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes describing improvements in release 2.0. After running ONE TO ONE for the first time: 121.EXE - The program. 121.DOC - The documentation for the program. 121SORT.EXE - A utility to sort a ONE TO ONE phone directory. 121SORT.DOC - The documentation for 121SORT.EXE. 121READ.ME - Notes reflecting any last minute changes or tips. WHATSNEW.121 - Notes describing improvements in release 2.0. OPTIONS.121 - The System Configuration File. PHONEDIR.121 - The Phone Directory. CTRLTEXT.121 - Messages attached to Ctrl-characters. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 13 GETTING STARTED The FIRST time you start ONE TO ONE, type 121 and press ENTER. After a few moments you will be told that ONE TO ONE couldn't find the file OPTIONS.121. You are then asked to answer several questions so that a configuration file can be created for your particular system. Each question is discussed below. o Which Communications Port? (1/2/3/4): Enter the port number, 1 through 4 to reflect the serial port you use. If you enter the wrong number, ONE TO ONE will not be able to initialize the serial port and prints a message to that effect. If that occurs 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 MENU. (More about that later.) o What Baud Rate? (300/1200/2400/4800/9600): Type the number representing the speed of your modem and press ENTER. ONE TO ONE always uses 8 data bits, 1 stop bit and No parity. You will not be prompted for these parameters. o Key-Clicks On Incoming Text? (Y/N): If you type `Y' in response to this question, ONE TO ONE will cause a "click" to occur on each incoming character. This can be a useful feature because you will always know when someone is "typing at you". o Touch Tone or Pulse Dialing? (T/P): If you have pulse dialing, you should enter a `P'. Anything else defaults to Touch Tone service. o Default Modem Initialization String? (Y/N): The default modem initialization string performs the following commands: ... Wait 1.5 seconds ... Take the modem off-line ... Wait another 1.5 seconds ... issue the ATZ command to reset the modem ... Wait another 1.5 seconds ... issue the ATV1 command to set the modem result codes to WORDS instead of DIGITS ... and finally, issue 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' accepting the defaults and go with it. However, the ability to create a custom modem initialization string is available. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 14 To change the default setting type `N' and press ENTER. An on-screen explanation of the special characters that can be imbedded in the initialization string is then displayed. They are: { = The ENTER key. ~ = 0.5 second delay. ^ = Next character is interpreted as a control code. Enter the customized modem initialization string and press ENTER. Faster modems may take advantage of the extended result codes by using the ATX1 command. When connected the modem will detect the caller's baud rate and send a message to the monitor. That way, if you're at 1200 baud and someone calls at 300 just use Alt-P to change parameters and establish a connection at the caller's rate. o 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. ENTER `1' if you have an IBM green-screen monitor or a Monochrome Display Adapter card. ENTER `2' for color monitors. 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. ENTER `3' for monitors that display shades of grey when colors are represented. Compaq and AT&T computers are known to work well like this. Try it if you aren't sure. If the text on the screen is barely readable then this option is not for you. Re-install ONE TO ONE by erasing OPTIONS.121 and then 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 make mistakes while answering these questions, don't worry. The parameters can be changed and saved via the `pull-down' menus while running ONE TO ONE. Congratulations! You now have a working copy of ONE TO ONE! Make backups of these files and store in a safe place. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 15 STARTUP OPTIONS THE 121PATH ENVIRONMENT VARIABLE ONE TO ONE can run from any directory on a hard disk and the configuration files will automatically be found. That's good news for Local Area Networks! Keep one copy of ONE TO ONE in a public directory and each user can set their 121PATH variable to point to his/her own private configuration files. 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, modify your AUTOEXEC.BAT file to include: PATH=\PATHNAME1 SET 121PATH=\PATHNAME2 where PATHNAME1 leads to the 121.EXE directory and PATHNAME2 leads to the configuration file. Reboot and these changes take effect. Now, whenever ONE TO ONE is started DOS will find 121.EXE because the PATH variable is set to "point" to it. Next, ONE TO ONE looks for the environment variable 121PATH. If it is `SET' ONE TO ONE will load OPTIONS.121, PHONEDIR.121 and CTRLTEXT.121 from the directory PATHNAME2 leads to. If the files are NOT found they will be created in the directory pointed to by 121PATH=. Otherwise, the files default to the current or PATHNAME1 directory. You can be anywhere on the hard disk and your files will be found! Move to the directory where you will be downloading files and run ONE TO ONE from there. No need for typing long Drive/Path/File names since you are in the default directory for downloading. 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. STARTUP WITH AUTO-DIAL/AUTO-ANSWER ONE TO ONE will immediately dial a directory listing with the following startup command: 121 D <ENTER> where D is a Dialing Directory Entry. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 16 121 A <ENTER> ONE TO ONE is executed and then issues the Hayes ATS0=1 command to put the modem in Auto-Answer mode. The phone is answered on the first ring. Both choices skip the title screen moving directly to TERMINAL MODE. PRIMARY SCREEN DISPLAY Each time ONE TO ONE is executed the title screen is displayed. It describes the program; warns that this is not free software; begs for compensation; tells who wrote it and ... waits for a keystroke. Just your typical User Supported software title screen. Press any key to clear it, automatically send the modem initialization string, enter TERMINAL MODE and the primary screen display. The exceptions to this are the `121 A' and `121 D' startup commands which skip the title screen and go directly to TERMINAL MODE. The primary screen is divided into four discrete sections. They are: o The top section of the screen contains the names of all of the pull- down menus. This line is referred to as the Menu Bar. o The middle section of the screen is divided by a reverse video bar called the Dividing Bar. INCOMING TEXT, or characters that are typed to us, will appear in the upper "window" of this section. OUTGOING TEXT, or characters that we type, will appear in the lower window. o Below the OUTGOING TEXT window there is an area set aside for the current communication 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 is, "Press `Home' For Help". Have you tried it yet? o The bottom line is the program title and copyright notice. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 17 TERMINAL AND MENU MODES When the title screen is cleared with a keystroke you enter TERMINAL MODE. This is where most of your ONE TO ONE life is spent. Each key pressed is sent out the comm port to whoever is out there. ONE TO ONE has somewhat of a split personality. You are in TERMINAL MODE when waiting for the phone to ring, typing messages to a friend, downloading or uploading files. You are in MENU MODE while pulling down menus and making selections from them. All of the vital choices from the menus are mapped to the keyboard. You can call or be called; establish a connection; type messages; send and receive files or hang up without once using a menu. On the other hand, some operations must be carried out from the appropriate pull-down menu. An example is adjusting the Dividing Bar that separates the incoming from the outgoing text. This option is available only from the "Screen" pull-down in MENU MODE. `Toggle' between TERMINAL MODE and MENU MODE by pressing either the `Esc' (escape) key or the `+' (grey plus) key. Press Esc (or grey plus) and notice the changes. Press it again to return. When you "toggle into" the MENU MODE you will notice two changes: o The MENU MODE is flashing to let you know that key strokes will not be sent over the phone lines. o The word "Info" will be highlighted on the "Menu Bar". Pressing ENTER (or the Down Arrow key) activates the menu. Press ENTER and the menu unfolds or is `pulled down'. The INFO MENU contains no choices. It simply displays the program title, version number, and gives the address of the author. To remove a pull-down menu from the screen without making a change press `Esc' or grey plus. Pressing the Up Arrow key until the menu goes past the top choice will accomplish the same thing. Make a menu selection so you can see how it's done. If you are still in the Info pull-down menu remove it by one of the methods described above. Now press the right arrow key a few times. Each time you press the right arrow the Menu choice to the right is highlighted. When a Menu selection is highlighted it is ready to become active. Keep pressing the right arrow key until the SCREEN MENU is highlighted. Now press ENTER or the Down Arrow. The menu will drop down and the first selection "Clear Both Screens" will be highlighted. IMPORTANT: You could have pressed "S" to automatically pull down the SCREEN MENU. All menus can be selected by pressing the key corresponding to its first letter. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 18 Selecting a choice WITHIN a Menu is handled the same way. Pull-down a Menu as described above. Then either ... o Press the key that corresponds to it's first letter. OR ... o Use the Up or Down arrows to highlight a choice and press ENTER. Pull-Down the SCREEN MENU and use the Down Arrow to highlight "Clear Outgoing Screen" and press ENTER. Any text that was in the outgoing text window (the bottom half of the screen) has been cleared. (If the Outgoing Text window was empty you will not notice that anything happened. It did.) Return to TERMINAL MODE by pressing Esc twice if you are in a menu or once if on the Menu Selection Bar. TO RECAP ... use either of two methods to make menu selections: ARROW/ENTER METHOD - Use the arrow keys to highlight a title on the Menu Bar or a choice within a menu and then press ENTER. OR ... KEYSTROKE METHOD - Press the key corresponding to the first letter of the menu to pull down (e.g. `M' for MODEM, etc.). Then press the key that corresponds to the first letter of your choice. Finish the selection by pressing ENTER. You now have all of the knowledge needed to make ONE TO ONE work for you. At this point you are encouraged to experiment. Call up the Help Screen by pressing either the key marked `Home' on the numeric keypad or F1. You will find a help screen for TERMINAL MODE and a separate 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. Making menu selections and toggling between MENU MODE and TERMINAL MODE will become second nature after a little practice. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 19 TERMINAL MODE KEYSTROKE COMMANDS When in TERMINAL MODE you have access to most menu choices without switching to MENU MODE. Certain keystrokes have been assigned the most frequently used menu selections. A Keystroke Command will perform as if you had toggled into the MENU MODE, made a choice and toggled back into TERMINAL MODE. Most keystrokes require that you hold down the `Alt' key while pressing the appropriate character. What follows is a listing of all Keystroke Commands and a description of each. Alt-A: Answer The Phone Alt-A sends the Hayes ATA command to the modem. The ATA command tells the modem to answer the phone. Before you press Alt-A the word RING should appear in the Incoming Text window. This indicates that the phone line attached to the modem is ringing. If a connection is established the word CONNECT appear in the Incoming Text window, otherwise, the message NO CARRIER appears. If you should press Alt-A when the phone isn't ringing just press any key and the modem will stop trying for a connection. Alt-C: Clear The Screen Alt-C clears the Incoming Text, Outgoing Text, and Dividing Bar windows of their current contents. Alt-D: Dialing Directory Alt-D creates a screen display of the Dialing Directory. The directory can contain up to 100 entries. At the bottom of the display are several options: PgUp)Previous List - PREVIOUS 10 Directory Entries. PgDn)Next List - NEXT 10 Directory Entries. D)ial an Entry - Asks "Which Entry?" then dials it. P)rint Listing - Print Directory Listing. R)evise an Entry - Add/Revise names and numbers. M)anual Dial - Dial a number from the keyboard. E)rase an Entry - Delete an existing entry. Q)uit - Returns to TERMINAL MODE. After a number is dialed you are returned to TERMINAL MODE. CONNECT will appear in the Incoming Text window indicating that the call was successful. Otherwise, no connection was established and the message NO CARRIER appears. Alt-H: Hang Up The Phone Alt-H sends the Hayes ATH command to hang up the phone. NO CARRIER will appear in the Incoming Text window if you were online when the Alt-H command was issued. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 20 Alt-M: Modem Echo Alt-M `toggles' Modem Echo between ON and OFF. Modem Echo ON causes keyboard input to appear in the Outgoing Text window AND `echo' to the Incoming Text window as well. Alt-P: Change Parameters Alt-P opens the parameters window permitting changes in baud rate, communications port or both. The Parameters window is divided into two sections. Keys 1-4 are used to select which communications port is desired. Keys 5-9 are used to select the appropriate baud rate. Press a key from each category (if needed) and then press ENTER. To accept the current setting without making any changes, press ENTER without indicating a number. EXAMPLE: Someone calls at 300 baud and your modem default setting is 1200. Press Alt-P ... select the appropriate 300 baud setting by pressing the `5' key and press ENTER. That's all there is to it. IMPORTANT: ONE TO ONE always uses 8 data bits, 1 stop bit, and NO parity. This is not an option. Alt-P changes are not permanent! The OPTIONS.121 file is not automatically modified. The parameters will default to the most recently saved OPTIONS.121 configuration for the next session. Alt-R: Redial The Last Number Alt-R redials the most recent Dialing Directory number called. If no number has been dialed the message "There is No Number to Redial" is displayed. Alt-T: Chat Mode When typing messages every keystroke is transmitted immediately ... mistakes, corrections, misspellings ... everything. This is not amusing for long. There is a better way and it's called Chat Mode. Alt-T creates a buffer that captures all keystrokes until you press ENTER. The edited message is then transmitted. No one will ever know how bad a typist you really are! Neither the Incoming Text window nor incoming messages are affected. The only indication that anything is different is the message on the Dividing Bar, "Chat Mode - Press `Esc' to return to normal mode". Chat Mode locks out all other menu choices. Press `Esc' to return to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 21 Alt-X: Exit To DOS Alt-X exits ONE TO ONE and returns to the DOS prompt. You are first told that you are "Exiting to DOS" and then asked for verification "Are you sure?". Press `Y' and return to DOS. Any other keystroke returns to TERMINAL MODE with no harm done. Alt-Z: Visit DOS (Shell) Alt-Z puts ONE TO ONE "on hold" and drops back to DOS. You may then change directories, format disks, use a text editor, etc. Type EXIT and press ENTER to return to ONE TO ONE. It's as though you never left! This feature does have two requirements: o Your computer must have enough memory to run both ONE TO ONE and your `other' program at the same time. o ONE TO ONE must be able to find the COMMAND.COM file somewhere in the system. ONE TO ONE needs the second copy of COMMAND.COM to create a "DOS shell". If it is not located a message appears saying that it failed to load the second copy of COMMAND.COM and then returns to ONE TO ONE. Experiment to see if this will work on your system. Hard disk user's should have no problem. However, floppy users will have to copy COMMAND.COM from their "boot disk" onto their ONE TO ONE disk for Alt-Z to work properly. Give it a try. PgUp: Upload (Send) A File Press PgUp on the numeric keypad to upload (send) a file. You are prompted for the filename which can be prefixed with a valid drive and path combination. After entering the file name ONE TO ONE will patiently wait for the receiving party to acknowledge that it is ready to receive. At this point file transfer begins automatically. Once file transfer has begun sit back and relax if you like. BUT, if the other person is also using ONE TO ONE you can continue to type messages while the file transfer takes place! In either case you will see a status report of the transfer displayed on the Dividing Bar. A beeping sound will indicate when transfer is complete. File transfer can be aborted anytime by pressing 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. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 22 PgDn: Download (Receive) A File When you are ready to download (receive) a file press PgDn. You are prompted for a filename which can be prefixed with a valid drive and path combination. After entering the file name ONE TO ONE will patiently wait for the sending party to begin uploading the file. The features available with file Uploading apply here. Either sit back or type messages ... no matter ... you will be notified when file transfer is complete. Ctrl-Enter: End of Message Indicator To indicate that you've finished a thought, press CTRL-ENTER which sends a "space", a smiley face and a Carriage Return. This IS OPTIONAL! Consider using it to show that something you've typed was meant to be said with a grin (e.g. <GRIN>). Ctrl-Home: Capture Keystrokes Ctrl-Home allows ONE TO ONE to capture all incoming keystrokes. When Ctrl-Home is executed "Capture is ON" appears on screen. All incoming characters will be saved to a file named CAPTURE.121. To terminate capture press Ctrl-Home again and "Capture is OFF" will appear. If CAPTURE.121 is not found, it is created. Thereafter CAPTURE.121 is opened in the APPEND mode. This means that you can toggle Capture ON and OFF as often as you like without overwriting previously saved characters. Ctrl-`User Defined Key': Send CTRLTEXT Messages With the KEYS pull-down menu you can create personalized Keystroke Commands. For instance, Ctrl-T could be defined as "Transfer the file in 10 seconds, Ok?". Now, when Ctrl-T is pressed this message is automatically transmitted. This is a convenient and error-free way to send commonly typed phrases and is limited only by your imagination. When you press `Ctrl' and another character simultaneously you will send the message that is attached to that keystroke. See the KEYS MENU discussion on page 33 for more details. Home or F1: Help Pressing the `Home' or F1 key displays a "help screen". Press any key to remove it. There are two help screens, one for TERMINAL MODE and another for MENU MODE. The help screen that appears corresponds to the current active mode. Esc or `+': Switch Between TERMINAL MODE and MENU MODE You can press either `Esc' or the `+' key to `toggle between' TERMINAL MODE and MENU MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 23 MENU MODE Most functions can be controlled in TERMINAL MODE with Keystroke Commands. However some procedures must be accessed through the MENU MODE. Toggle into MENU MODE with either Esc or the `+' key. "Menu Mode" will be begin flashing on the Dividing Bar and no messages or TERMINAL MODE activities are possible. All menus are activated using either of the following methods: ARROW/ENTER METHOD - Use the Right or Left Arrow keys to highlight the desired menu title on the Menu Bar. Press the Down Arrow or ENTER key to pull-down the menu. KEYSTROKE METHOD - Press the key corresponding to the first letter of the selection you want. (e.g. `M' for Modem, etc.) When the appropriate menu is pulled down activating a specific entry is just as easy. To highlight your choice use either the Up/Down arrows or press the key corresponding to its' first letter. Then press ENTER. That's all there is to it! You simply use the arrow keys to point to what you want and press ENTER ... OR ... press the key that represents the first letter of the desired choice and press ENTER. If you need to exit a menu without making a choice just "escape out" with any of the following: o Press the `Esc' key - OR o Press the `+' key - OR o Press the Up Arrow until you pass the top selection. A number of menu choices will return you to TERMINAL MODE. Others leave you in MENU MODE. This may seem inconsistent but it makes sense when the menu choice is considered. In the following menu descriptions you are told which selections take you back to TERMINAL MODE and which selections leave you in the MENU MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 24 MENU DESCRIPTIONS THE INFO MENU The INFO MENU is not truly a menu because it contains no selections. It simply displays the program title, version number, lists the address of the author, and displays the copyright notice. Press any key and return to MENU MODE. THE FILES MENU The FILES MENU contains choices that relate to acquiring or inspecting disk files. o DOWNLOAD A FILE - When you are ready to DOWNLOAD (receive) a file select this option (or the PgDn Keystroke Command, page 22). You are prompted for a filename which can be prefixed with a valid drive and path combination. After entering the file name ONE TO ONE will patiently wait for the sending party to begin uploading the file. Once file transfer has begun sit back and relax if you like. BUT, if the other person is also using ONE TO ONE you can continue to type messages while the file transfer takes place! In either case you will see a status report of the file transfer displayed on the Dividing Bar. A beeping sound will indicate that the transfer is complete. File transfer can be aborted anytime by pressing Ctrl-X and you will exit gracefully. Your screen will say "Aborted by User" and you will hear beeps letting you know that the transfer is finished. Your friend's screen will display a similar cancelation message. This selection returns you to TERMINAL MODE. o UPLOAD A FILE - When you are ready to upload (send) a file select this option (or the PgUp Keystroke Command, page 21). You are prompted for the filename which can be prefixed with a valid drive and path combination. After entering the file name ONE TO ONE will patiently wait for the receiving party to acknowledge that it is ready to receive. At this point file transfer begins automatically. The features available with file downloading apply here. Either sit back or type messages ... no matter ... you will be notified when file transfer is complete. This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 25 o 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. A very handy feature indeed. When you choose VIEW A FILE you are prompted for a filename which can include any valid drive or path. You are not limited to the current directory. After you enter the file name the screen "opens up" in the middle to create an 80-column viewing area. Instructions are displayed near the bottom of the screen. Scrolling is controlled with Ctrl-S or you may Abort by pressing `Esc'. After the file has been displayed you are prompted to press any key to continue. This selection returns you to TERMINAL MODE. o 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 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 screen opens up a window at the top two-thirds of the display. The bottom portion of the screen is split into 2 sections so that you may continue to type while sharing the file. It works like this. The Sender enters the name of the text file to share while the `downloader' tells ONE TO ONE that he will act as the Receiver. Immediately both screens change to the viewing screen described above. The text file is then displayed, line by line, in the viewing area of both screens. Both parties have control of when to pause or abort the viewing of the file. Press Ctrl-S to pause. Then start typing messages to each other about what you are seeing on the screen. This is a convenient feature that other communication programs don't offer. When the entire file has been displayed (or aborted with Esc) you will be prompted to press a key to continue. When you press a key you will be returned to TERMINAL MODE. o 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 as though you had typed "DIR " in front of your file specification. EXAMPLE: A:\LETTER\FRED.* is sent to DOS as DIR A:\LETTER\FRED.* producing a directory listing of Drive A:, Directory LETTER, File everything related to FRED. DIRECTORY requires that ONE TO ONE be able to access COMMAND.COM on your program disk. Hard disk users should have no problems. Floppy users must copy COMMAND.COM to the ONE TO ONE program disk. This selection leaves you in MENU MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 26 o SAVE OPTIONS.121 - The OPTIONS.121 file contains the operating parameters for ONE TO ONE. SAVE OPTIONS.121 will save changes made during a session and have them active the next time ONE TO ONE is executed. The parameters saved are ... position of the Dividing Bar, Baud Rate and Communications Port, Monitor type, etc. In short, everything. o VISIT DOS (SHELL) - This selection behaves exactly like the Alt-Z Keystroke Command discussed on page 21 earlier. This selection returns you to MENU MODE. o 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. If any other key is pressed you will return to MENU MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 27 THE MODEM MENU The Modem menu contains choices that relate to both the Modem and the Communications port. o RESET MODEM - Issues the same Modem Initialization String created during installation. After the initialization string has been sent to the modem you are returned to TERMINAL MODE. o GO TO ONLINE STATE - ONLINE sends the Hayes ATO command to the modem returning you to the Online status. Use this command only if the OFFLINE command (described below) was issued. After the ATO command is sent you are returned to TERMINAL MODE. o GO TO OFFLINE STATE - OFFLINE sends the Hayes `+++' command to the modem dropping you out of the `online' state to issue modem commands. This feature will rarely, if ever, be used. It is available for the so called `Power User'. The ONLINE option above resumes normal operation. This selection keeps you in the MENU MODE. o CHANGE PARAMETERS - This selection is used to change baud rates or communication ports while ONE TO ONE is running. It behaves exactly like the Alt-P Keystroke Command discussed on page 20. This selection returns you to TERMINAL MODE. o EDIT MODEM INITIALIZATION - You may want to change the modem initialization string at some point in the future. You could 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 edit the string using your modem commands. Embedded command characters are shown below the editing line. They are: ~ = 0.5 seconds of delay for each ~ that is encountered. { = Simulates pressing the ENTER key. ^ = Treats the following character as a Ctrl-character. Press `Esc' at any time and no changes will be saved to disk. Otherwise, when you finish editing press ENTER and the changes will be saved for future use. This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 28 THE PHONE MENU o DIAL THE PHONE - Select this option to activate and display the Dialing Directory. The directory can contain up to 100 entries. DIAL THE PHONE behaves exactly like the Alt-D KeyStroke Command in TERMINAL MODE. The options available are: PgUp)Previous List - PREVIOUS 10 Directory Entries. PgDn)Next List - NEXT 10 Directory Entries. D)ial an Entry - Asks "Which Entry?" then dials it. P)rint Listing - Print Directory Listing. R)evise an Entry - Add/Revise names and numbers. M)anual Dial - Dial a number from the keyboard. E)rase an Entry - Delete an existing entry. Q)uit - Returns to TERMINAL MODE. After a number is dialed you are returned to TERMINAL MODE. CONNECT will appear in the Incoming Text window indicating that the call was successful. Otherwise, you see NO CARRIER and a connection could not be established. o HANG UP (Disconnect) - This command sends the Hayes ATH command to hang up the phone. The message NO CARRIER appears if you were online. HANG UP is identical to the Alt-H Keystroke Command discussed on page 19 and returns you to TERMINAL MODE. o ANSWER THE PHONE NOW - This choice sends the Hayes ATA command telling the modem to answer the phone now, without waiting for a ring. Before selecting ANSWER THE PHONE make certain the word RING appears in the Incoming Text window indicating a caller. When a connection is established the word CONNECT appears in the Incoming Text window. Otherwise, the message NO CARRIER will appear. If this selection is made when the phone isn't ringing press any key and the modem will stop trying for a connection. This selection returns you to TERMINAL MODE. o TAKE PHONE OFF HOOK - This selection issues the Hayes ATH1 command telling the modem to take the phone off the hook. Incoming calls will get a busy signal. TAKE PHONE OFF HOOK will NOT put the modem into command mode (e.g. `+++' is not sent). It must already be in command mode for this to work. This selection returns you to TERMINAL MODE. o PUT PHONE ON HOOK - This selection issues the Hayes ATH0 command telling the modem to put the phone back on the hook. ON HOOK does NOT put the modem into command mode, it simply puts the phone `back on the hook' after TAKE PHONE OFF HOOK is issued. ON HOOK will send the ATH0 command out the comm port if you are `online'. The modem must be in command mode for this feature to work. This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 29 o GO FROM VOICE TO DATA - This feature allows a `voice' call to be converted into a `data' call without re-dialing the number. It will work ONLY if BOTH phones and BOTH modems are active at the same time. If either phone must be unplugged to use the modem this feature will not work. VOICE TO DATA takes a little cooperation but it's really quite easy. Just follow these steps: 1) Both parties select VOICE TO DATA from the PHONE MENU. 2) Decide who will be the CALLER and who will be the ANSWERER. 3) Then the CALLER presses `C' and the ANSWERER presses `A'. 4) Hang up the phones and let the computers take over! CONNECT should appear in the Incoming Text window. Otherwise, something went wrong. Redial via computer. Note: not all modems will allow you to do this. I have heard from a few users that can't get this feature to work with their modems. Only experimentation will tell you whether or not you can use this option with your modem. When the ANSWERER pressed `A' the Hayes ATA command was sent to the modem. When the CALLER pressed `C' the Hayes ATD command was sent. These commands could have been typed in TERMINAL MODE but that takes all of the mystery out of it, doesn't it? This selection returns you to TERMINAL MODE. o GO FROM DATA TO VOICE - This feature allows a `data' call to be converted into a `voice' call without re-dialing the number. It will work ONLY if BOTH phones and BOTH modems are active at the same time. If either modem must be unplugged to use the phone this feature will not work. DATA TO VOICE takes a little cooperation but it's really quite easy. Just follow these steps: 1) Both parties agree to `switch' to a voice call. 2) Both parties highlight DATA TO VOICE in the PHONE MENU. 3) Both parties pick up the phone and THEN press ENTER. 4) The computers hang up and the humans take over! Picking up the receiver and pressing ALT-H will accomplish the same thing and is much easier. DATA TO VOICE is included in the menu for the sake of completeness. This selection returns you to TERMINAL MODE. o SELECT DIALING MODE - This feature is great for people using data communications in different locations (traveling salesmen?). SELECT DIALING MODE permits changing between Touch Tone and Pulse dialing without `restarting' ONE TO ONE. The new dialing mode will be written to disk saving it with your other parameters. This selection returns you to the TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 30 THE TOGGLES MENU THE TOGGLES MENU contains choices that are turned ON or OFF. Selections that are ON will be displayed with an asterisk. The choice is OFF when there is no asterisk. EXAMPLE: Chat (Wait for CR) * Capture Keystrokes * Auto-Answer In this example Chat mode is OFF but the others are active. o CHAT (Wait for CR) - When CHAT MODE is active (ON) your keystrokes are saved to a buffer until ENTER is pressed. Then all of your typing is sent at once. Your friend will never see your mistakes. Text will still appear in the Incoming Text window as usual. The only indication that anything is different is the message on the Dividing Bar, "Chat Mode - Press `Esc' to return to normal mode". CHAT MODE active keeps you in MENU MODE and prevents any other menu selections. Press `Esc' to return to exit. o CAPTURE SESSION - This selection behaves exactly like the Ctrl-Home Keystroke Command in TERMINAL MODE discussed on page 22. CAPTURE SESSION active (ON) allows ONE TO ONE to store all incoming keystrokes in a file named CAPTURE.121. If CAPTURE.121 is not found it is created. Thereafter it is opened in the APPEND MODE to avoid overwriting previously saved keystrokes. This selection returns you to TERMINAL MODE. o AUTO-ANSWER - This issues the Hayes ATS0=1 command to put the modem in Auto-Answer mode. The phone will now be answered 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. The phone MUST NOT BE RINGING when AUTO-ANSWER is invoked. If the phone is ringing choose ANSWER THE PHONE NOW from MENU MODE or Alt-A in TERMINAL MODE. This selection returns you to TERMINAL MODE. o MODEM ECHO - MODEM ECHO determines whether the modem should echo every character typed. If MODEM ECHO is ON, every keystroke you press will appear in both the Incoming Text AND Outgoing Text windows. This is rarely necessary. 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 anyone else at home. (Make sure nobody sees you.) This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 31 o INCOMING KEY-CLICKS - When this option is active a faint "clicking" sound is heard with each incoming 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 expected, choosing INCOMING KEY-CLICKS again will turn the "clicks" OFF so as not to disturb you. The initial status of INCOMING KEY-CLICKS is determined when ONE TO ONE is first installed. You can save all of the current parameters (including Key-Click status) by selecting `Save OPTIONS.121' in the FILES MENU. This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 32 THE SCREEN MENU o CLEAR BOTH SCREENS - This selection will cause the Incoming Text, Outgoing Text, and Dividing Bar to be cleared of their current contents. This selection returns you to TERMINAL MODE. o CLEAR INCOMING SCREEN - This selection will cause the Incoming Text window to be cleared of its contents. The Outgoing Text window will remain unchanged. This selection returns you to TERMINAL MODE. o CLEAR OUTGOING SCREEN - This selection will cause the Outgoing Text window to be cleared of its contents. The Incoming Text window will remain unchanged. This selection returns you to TERMINAL MODE. o ADJUST DIVIDING BAR - The Dividing Bar separates the Incoming from the Outgoing Text. ADJUST DIVIDING BAR allows you to position the Dividing Bar to suit your tastes. Select this option then 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. This selection returns you to TERMINAL MODE. o CHANGE MONITOR TYPES - This choice allows you to adapt ONE TO ONE to the type of monitor in use. Choose between: 1) Monochrome 2) Color 3) Monochrome with shades of grey. Press `Esc' and nothing will be changed. A selection will save the parameters to disk and the screen resets to reflect your choice. This selection returns you to TERMINAL MODE. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 33 THE KEYS MENU o EDIT CTRLKeys - Messages can be attached to Ctrl-Keystrokes. Hold down `Ctrl' then press a letter to send the message attached to that character. EDIT CTRLKeys defines the messages attached to the Ctrl- characters. This selection will prompt you to press the Ctrl-Keystroke to edit. Any letter from A-Z can be assigned to a Ctrl-Keystroke with four exceptions. You CANNOT use: H - because Ctrl-H is the same as a backspace. J - because Ctrl-J is the same as a Line-Feed. M - because Ctrl-M is the same as the ENTER key. X - because Ctrl-X is reserved for file transfer aborts. Any other key is acceptable. Select any other letter and then enter or edit the phrase to be attached to this Keystroke. There are two 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 the message is complete press ENTER. Define more keys the same way or press `Esc' to quit. You will be asked "Save The Changes To Disk?". Press "Y" and the CTRLTEXT.121 file is created (or updated). o SHOW CTRLKeys - This selection will scroll the messages attached to Ctrl-Keystrokes in a screen window. Press `Ctrl-S' to Start and Stop the scrolling. Press `Ctrl- X' to abort. This handy feature is a great `memory jogger'. o Print CTRLKeys - This selection will print the currently defined Ctrl- Keystrokes and their attached messages. This is highly recommended! If you define all of your keys and keep the 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.) Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 34 TIPS AND TRICKS CTRL-KEYSTROKE MESSAGES. The Ctrl-Keystroke feature was added as a convenience. I realized that messages were often repeated during a "conversation". ONE TO ONE Version 2.2 incorporated Ctrl-Keystroke to eliminate this repetition and add a little `flavor'. This is a very handy feature! Some suggestions for messages to use are listed below. 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. (A friend has attached insults to his Ctrl-Keystrokes.) This is a fun feature! CALL WAITING PROBLEMS Call Waiting can cause problems with telecommunications. Turning it off is very easy. Use the appropriate method listed below. Touch Tone Dialing Service: Prefix the phone number with *70. (e.g. *70 404 555 1212) Pulse Dialing Service: Prefix the phone number with 1170. (e.g. 1170 404 555 1212) This disables Call-Waiting for the duration of this one call only. GO FROM DATA TO VOICE. When you're through transferring files and want to go back to voice do the following: Type a message to your friend telling him/her to "Pick up the phone and then press Alt-H". Perform step above now. (practice what you preach.) In a few seconds you should hear the modems disconnect and you will be able to talk to each other again. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 35 SAVING OPTIONS.121 In the old days (version 1.0) OPTIONS.121 was erased and ONE TO ONE restarted just to change a parameter. Version 2.2 changed all that with the addition of SAVE OPTIONS.121 in the FILES MENU. The current parameters are saved to disk with this new menu choice. The next time ONE TO ONE is started these changes take effect automatically. Something you should be aware of ... whenever the parameters are saved, ALL of the parameters are saved. Be cautious! Make certain they are set to your satisfaction BEFORE saving OPTIONS.121 to disk. For example, let's say you changed baud rates to talk to a friend with a slower modem (Are you saying it?) and then decided to adjust the dividing bar. Wh en 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... Cliff Batson C/O: Digital Transit 3360 Towneship Road Antioch, TN 37013 The latest version of ONE TO ONE is always available on: Cumberland BBS 1-615-526-3347 SYSOPS: Dean Carothers & Del Robinson Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 36 FINAL REMARKS ONE TO ONE was released nearly two years ago. This new version (2.3) represents some "tweaking" of version 2.2. In a way, I'm a little embarrassed by ONE TO ONE. I've learned so much more about programming and "slickness" in the last couple of years that I'd love to just sit down and rewrite ONE TO ONE from scratch. Maybe if Ed McMahon calls me telling me that I've won the Publisher's Clearing House Sweepstakes, I'll throw away the old code and start anew. I'm grateful for those that have taken the time to become registered users. Enjoy this new version of ONE TO ONE! It was written with ALL of us in mind. Friends computing with friends. If you've used ONE TO ONE for two weeks ... you're probably hooked! Go ahead. Become a registered user! We need your support! If you are basically an honest person but keep "putting off" paying for your "ShareWare" programs ... do what I do ... write the name, address and amount down on a piece of paper and throw it in the pile of bills to pay. Treat them like the power bill. Payment due for SERVICES RENDERED. Send in your payment if you like the product. If you have suggestions please drop me a note. If you prefer to leave a message on my answering machine call 615-361-3655 during WORK HOURS (8:00 a.m. - 5:00 p.m. Central Time Zone). You'll notice that these are NORMAL work hours - NOT programmer's work hours. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 37 APPENDIX I ONE TO ONE Version 2.3 ---------------------------------------------------- REGISTRATION FORM Please Print Date:__/__ /__ Name:____________________________________________________________ Company:_________________________________________________________ Title:___________________________________________________________ Address:_________________________________________________________ :__________________________________________________________ :__________________________________________________________ Phone#:__________________________________________________________ ================================================================= COMMENTS/SUGGESTIONS:____________________________________________ _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ _________________________________________________________________ Please Register Me For #_____ Copies Of ONE TO ONE (Suggested Contribution: $15.00 - $20.00 per copy) Enclosed is my check or Money Order for $__________ Make Checks Payable To: Digital Transit 3360 Towneship Road Antioch, TN 37013 Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 38 APPENDIX II ONE TO ONE & XMODEM ONE TO ONE uses the XMODEM file transfer protocol. XMODEM, developed by Ward Christensen and others in the late 1970's, has become a standard for transferring files over phone lines. When a file is transferred via XMODEM it is broken into 128 character data blocks. Each block is sent sequentially. Actually, more than 128 characters are sent in each 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 Per 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 it's 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. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 39 APPENDIX III PHONE DIRECTORY STRUCTURE For Programmers: 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 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 */ }; Note: There is a small utility program called 121SORT.EXE that is included with ONE TO ONE. 121SORT sorts the phone directory alphabetically. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 40 APPENDIX IV OPTIONS.121 STRUCTURE For Programmers: OPTIONS.121 is the configuration file for ONE TO ONE. If this file is not found when ONE TO ONE is run the program will prompt you to "answer a few questions..." then create it. 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 ... or 2) whenever you tell ONE TO ONE to save changes made with 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 */ int baud; /* Baud rate to initialize 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 */ }; Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 41 APPENDIX V COMMUNICATIONS PORT ADDRESSES ONE TO ONE allows you to use 4 comm ports; COM1:, COM2:, COM3:, and COM4:. Each of these 4 ports has 2 unique pieces of information that let the computer know how to communicate with it. These 2 items are 1)Port Address and 2) Interrupt Request Lines (IRQ). The following table shows the port address and IRQ for all 4 comm ports supported by ONE TO ONE... Port Address IRQ ---- ------- --- COM1 3F8H 4 COM2 2F8H 3 COM3 3E8H 4 COM4 2E8H 3 The data for COM1 and COM2 are standards in the PC world. COM3 and COM4 data is sometimes different than what is shown here, although it is rare to find a difference. Copyright (C) 1986, 1987, 1988 by Digital Transit ONE TO ONE - Reference Manual 42 APPENDIX VI ONE TO ONE PROGRAMMING TRIVIA Programming Information This information is included for the terminally curious (pun intended). Equipment: o AT&T PC 6300 (640k, Hard Disk, Qubie' modem) o Compaq Portable (with Null Modem Cable) o IMS AT-Clone (42m Hard Disk, Qubie' 2400 modem) o NEC MultiSpeed EL laptop Languages: o The C programming language and 808x Assembler. o C Compiler: Microsoft C Compiler (version 5.0) o Assembler: Microsoft Macro Assembler (version 5.1) Other: o Greenleaf Function Library (version 3.03) o Greenleaf Comm Library (version 2.03) When: o Late August, 1986 - Mid December, 1986 (Version 1.0) o Mid January, 1987 - Mid February, 1987 (Versions 2.0 - 2.2) o Mid July, 1988 (Version 2.3) Where: o Antioch, TN (Suburb of Nashville) Copyright (C) 1986, 1987, 1988 by Digital Transit