. . . USERGUID.DOC . InJoy Release 1.1 . May 30, 1997 . . . . . . . . . . . . _ _| | . | __ \ | _ \ | | . | | |\ | ( | | | . ___|_| _|\___/ \___/ \__,| . ____/ . . . . . . . . . . . . . . . . . . . . . . . . . . The Best Way To The Internet . . . . . . . . . . . . . . . . Bjarne Jensen . DK-4300 Holbaek . Denmark . E-mail: injoy@poboxes.com . http://www.fx.dk . . . . . . . . . . . . . . . . Copyright (c) 1996-1997, F/X Communications, All Rights Reserved. . . ========================================================================== C O N T E N T S =======================================What's Where======================= o Starting InJoy.........................................A Few Tips o Entering the key code.....................To Unlock InJoy's Power o InJoy screen layout.............................A Familiarization o Online hints........................InJoy's Efficient Help System o Creating a host........................A First Step To Connecting o Host setup...........................................Who You Call o PPP/SLIP setup....................................Set One or Both o Communication setup.............Basic Stuff, Use the Online Hints o More phone numbers.................Giving More Chances to Hook Up o PPP/SLIP options...................................Tune For Speed o IP Masquerading..................................Many Through One o Dial On Demand (DOD)...........................Disconnect Actions o Host Triggered Actions............................Distant Command o Script setup.................................Simple and Effective o Script language.....................................Roll Your Own o Saving host info...................................Default or Not o Dialing..................................How InJoy Dials, and Why o CONNECT.TXT............................Your IP Address, Instantly o Hanging up............................Several Ways to Say Goodbye o Tracing.......................................Capturing Tech Data o Connection log..........................Capturing Connection Data o Textmode Ticker.............................Old but Still Ticking o Graphical Ticker........................A Pretty Face, and Brains o General setup................................InJoy is So Flexible o Auto-starting modules...........................Start and/or Stop o Command Line Options............................Customized Starts o Keyboard Shortcuts.....................................Busy Hands o SetJoy..........................................Connected Changes o KillJoy.......................................The Ultimate Ending ========================================================================== S T A R T I N G I N J O Y =======================================A Few Tips========================= o Start InJoy like any other OS/2 program, either by making an icon referencing IN-JOY.EXE, or by running InJoy directly from the command line. o Running InJoy in full screen may cause problems on some systems. While InJoy runs well in full screen on most systems, it has proven most stable in an OS/2 (VIO) window. This full screen problem has been reported by only a few people: o If COM 2 is not available on your system, InJoy will report "Could not open device" when starting the FIRST time. Simply click on OK to proceed with initialization. Then, during setup (see below) you must specify the correct COM port in InJoy's "default" host. ========================================================================== E N T E R I N G T H E K E Y C O D E ============================================To Unlock InJoy's Power======= After your registration has been processed you will receive a key code to unlock InJoy's power, at the level purchased. To unlock: o Open InJoy. o While on the opening screen press SHIFT-F10. o Enter your name and your key code with care. BOTH your name and key code is case sensitive and must be entered EXACTLY as provided. o When both have been entered, and checked for accuracy, click on OK. ========================================================================== I N J O Y S C R E E N L A Y O U T ==========================================A Familiarization=============== Refer to the following "screen shots", or just open InJoy and look at the real thing while learning about the six sections of InJoy's display: o Terminal Mode Window Used during Terminal Mode operations and to display bytes received/transmitted while dialing, and when running a connect script. o Host List Window Contains user defined hosts and all controls necessary to create, edit and remove host using the manipulation buttons [New], [Change] and [Delete]. For ease of use, the [Dial] button is immediately below the list of user configured hosts. o Output Window Shows InJoy messages and trace information, if trace is enabled. o Other Control Buttons Immediately below the Host List, and next to the Output Window, are additional buttons for the purpose of forcing a line drop [Hang Up], accessing/setting miscellaneous options [Misc. opt.] and for closing InJoy [Exit]. o Characters Per Second (CPS) Info Line and Bar Chart Provides real-time data (from left to right, with displayed symbols) on:  Total characters sent on communications line since connect  Total characters received on comma line since connect  Current CPS transmission rate, updated every second  Current CPS receive rate, updated every second avg Average CPS processed during last second max Peak CPS processed during any second of current connection The last two numbers (avg and max) are based on the sum of both transmitted and received characters. Notice that these numbers are what is actually sent and received, including PPP encapsulation characters. Additionally, the Info Line is calculated at a rather low priority within InJoy (keeping the pipe full is a lot higher on the food chain), therefore some of the 'every second' updates will occur during a rather long second. Immediately to the right of the "max" data point is a display of the total CPS receive and transmit rate in a visual Bar Chart Line. The check box on the right of the visual indicator will toggle the entire Info Line on or off. (Total throughput will increase slightly with the line turned off.) When using InJoy with Dial On Demand (DOD) with the "display DOD indicator" option turned on, the CPS Bar Line displays the DOD packet scan. This is only the case when off-line, so that functionality will not conflict with the normal use of the CPS monitor. o Status Line (at the bottom): Shows information about the current status of InJoy. These sections yield the following screen layout: ÛßInJoy - Best way to the Internet. (C)Copyright 1997 v1.1-Build May xx ßÛ ÛÚÄ[ Terminal Mode ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú[ Host ]ÄÄÄÄÄÄÄÄ¿Û Û³ ³³ Default  ³Û Û³ ³³ TestOne ± ³Û Û³ ³³ þ ³Û Û³ ³³  ³Û Û³ ³³ ³Û Û³ ³³ [ Dial ] ³Û Û³ ³³ [ New ] ³Û Û³ ³³ [ Change ] ³Û Û³ ³³ [ Delete ] ³Û Û³ ³³ ³Û ÛÀÄ[ F9: Start programs | F10: Stop programs ] ÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ÛÚ[ Output Window ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³  [ Hang Up ] Û Û³ ± Û Û³ ± [Misc. opt.] Û Û³ þ Û Û³  [ Exit ] Û ÛÀþ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±Ù Û Û Line usage monitoring....................... [X]Û ÛÜ HOST | COM3 | 115200 bps N81 | port: CLOSED | LEARNING OFF ÜÛ ========================================================================== O N L I N E H I N T S =======================================InJoy's Efficient Help System====== Useful hints are available at the bottom of the InJoy screen when operating within following described setup screens. These online hints change as the various portions of the setup screens are highlighted for data entry, or toggling. Therefore, since the hints are context sensitive you will find them very useful in completing even the most complicated setup. In fact, most people find that the hints are all that is needed to successfully complete all initial setup and performance tuning steps. ========================================================================== C R E A T I N G A H O S T =======================================A First Step to Connecting========= To connect your computer or network to the Internet, you must start by defining a host. The host configuration constitutes the parameters and options needed to communicate successfully with your ISP (Internet Service Provider). InJoy is shipped with a "default" host which cannot be deleted. You may modify to suit your needs, and you should set the "default" host to match the settings to use at InJoy start-up. For instance, most people modify the "default" host so that it has all the settings necessary to connect to their Internet Service Provider. However, before overwriting the "default" consider this: Most people find that the "default" works as well as (and in many cases, much better than) competing dialers. Therefore, it is suggested that you replace the "default" only after you have another host with tested capability. Additional information on this subject is available in the section "Saving Host Info", below. Please note that the settings contained in the "default" host are used in creating new and/or multiple hosts. Additional host are created by selecting the [New] button or pressing while the Host List Window has the focus. DO NOT PRESS ENTER AT THE END OF EACH LINE, WHEN FILLING IN VALUES. Doing so will place a space at the end of the line and InJoy will NOT work. ========================================================================== H O S T S E T U P =======================================Who You Call======================= o When creating a new host, the first screen prompts you for a configuration name, user ID and password: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß Host setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Û Û Configuration name... Û Û TestOne_____________________________________ Û Û Û Û User ID.... Û Û YourID______________________________ Û Û Û Û Password... Û Û ********____________________________ Û Û Û Û Ú Protocol ÄÄÄ¿ Û Û ³ (o) PPP ³ Û Û ³ ( ) SLIP ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Autostart per host ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ The configuration name you provide becomes the host name used by InJoy in the Host List Window to identify the set of parameters that defines one particular host. For example: If your Internet Service Provider is IBM you might want to use IBM as the host name. On the other hand, if you will use several IBM gateway telephone numbers (say for a portable computer), you might want to set up numerous host, each with a different city's name. o Fill in the User ID and Password fields with the values supplied by your ISP. Those are the values which will be used by log on scripts or PAP/CHAP authentication protocols. o After filling in those three items select the appropriate radio- button for either PPP or SLIP. Your ISP should be able to tell you which protocol is most likely to provide the best service. But, without other information available, you should probably attempt to connect first via PPP. Refer to other sources for a description of the differences between PPP and SLIP. ========================================================================== P P P / S L I P S E T U P =======================================Setup One or Both================== When you have gone through the fields of the previous host setup screen and selected to run either PPP or SLIP as framing protocol, you will see a screen like this: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß PPP setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ IP address configuration ÄÄÄÄÄÄÄÄÄ¿ Ú Domain nameserver ÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Û Û³ Your IP address..: 0.0.0.0 ³ ³ Nameserver address: 123.456.78 ³Û Û³ Dest. IP address.: 0.0.0.0 ³ ³ Backup nameserver.: 123.456.79 ³Û Û³ ³ ³ Your host name....: what.ever ³Û Û³ Netmask..........: 255.255.255.0 ³ ³ Domain name.......: your.com ³Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ Û Û Û [ ] Use VJ Compression ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Save ³ Û Û [ ] Auto connect ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û [ ] IP Masquerading [...Masquerading options] Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û Timeout.: 9000 secs. ³Save as default³ Û Û Timer...: 9999 mins. [...Disconnect actions] ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Comm setup ³ ³ PPP options ³ ³Script setup ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ NOTE: "Screen shots" in this text document are unable to accurately render those sections of the screen which are "grayed out" on the actual InJoy setup screen. For example: Both the "IP Masquerading" and "Masquerading options" in the above screen are "grayed out" in the distribution archive's Basic Version since those features are only available in the more advanced versions. NOTE: The screens are nearly the same for PPP and SLIP. Each of the various items you need to fill in are explained below. Additionally, the differences between setting up for PPP or SLIP are explained, where necessary: o Your IP address This is the Internet Protocol (IP) address that your computer will use throughout your session. The value 0.0.0.0 means that InJoy should obtain your actual IP address from the ISP server, during log on negotiation. Obtaining the IP address from the server is the standard way of assigning IP addresses using PPP, but it is possible to specify an IP address when the server will not dynamically assign one. For SLIP you should either use an IP address statically assigned to you by your ISP or auto-grab it from the text stream transmitted by your server at connect. o Dest. IP address This is the IP address of the ISP's server. It is normally assigned by the PPP server during the log on sequence. However, some providers specify a fixed IP address that you should enter here. For SLIP you should either use a static IP address assigned by the ISP, or auto-grab it from the text transmitted by your server during connect. o Netmask The netmask specifies the IP addresses which are supposed to go through your SLIP0/PPP0 interface. If you did not receive an assigned netmask from your ISP then leave it as set (255.255.255.0). o Use VJ Compression By enabling this option InJoy will try to negotiate the use of VJ (Van Jacobsen) compression. VJ compression takes some CPU cycles and it is therefore recommended for fast computers and/or a slow line. As a rule of thumb, if you are not running a 66 MHz or faster CPU, you probably won't realize any benefit from VJ compression. VJ compression will save about 30 bytes per compressible PPP/SLIP packet. o Auto connect Marking this check box causes InJoy to attempt an auto-connect to this host during start-up. Since InJoy can only attempt to connect with one host at a time, marking this block in one host automatically resets all other hosts to not attempt an auto-connect. o IP Masquerading Refer to the Masquerading section, below. o Timeout This is the "idle timeout". It specifies for how long the line may remain idle (i.e. nothing moving in or out) before InJoy will automatically disconnect the line. It may be set from 0 to 9999 seconds. If the timeout value is larger than 60 seconds a timeout warning (consisting of four beeps) will be sounded and the phrase "TIMEOUT: 1 min. to disconnect . . . " will appear in the Output Window. You may reset the idle timeout by pressing ALT-R, in which case your connection will continue as if nothing happened. A note of caution is advisable here. Some users (myself included) set the idle timeout to five minutes or so, and walk away from the computer after beginning a long down/upload . . . knowing that when finished InJoy will drop the connection, as the idle timer reaches zero. Be careful, many hosts periodically sends dummy data on the line in order to avoid unintentional disconnects. Therefore, if you are paying for your connection by the minute (to either your ISP or telephone company) you might want to insure the line is dropped within a reasonable time after data flow has stopped. To completely disable the idle timeout, specify a value of zero. In that case, the line will never be dropped due to inactivity. o Timer This timer specifies how long InJoy may stay connected before it will automatically disconnect. Set any value from 0 to 9999 minutes. This functionality is much like the one on your VCR or TV that enables you to automatically turn it off after half an hour or so, without worrying about the TV starting a fire during the night. As it can go wrong for a television, so it can for InJoy too. If InJoy has a problem disconnecting there is nothing it can do except increase your phone bill (InJoy has never started a fire!). Notice that if the timer value is set to more than one minute, you will hear/see a timer warning similar to that described for the idle timeout. And, you may reset this timer by pressing ALT-E. To completely disable the timeout, specify a value of zero. In that case, the line will never be dropped for exceeding a preset time on line. o Disconnect actions Please refer to the "disconnect actions" section. o Nameserver & Backup nameserver address The nameserver and backup nameserver are IP addresses of your preferred nameservers. The nameserver addresses are put into the %etc%\RESOLV file. This file is referenced by the TCP/IP stack for nameserver lookup's. You should make sure that your ETC environment variable is set up correctly. Normally the ETC environment variable is set when you install OS/2 TCP/IP base kit and/or Internet Access Kit. However, to check, look in your CONFIG.SYS for a line like: SET ETC=x:\tcpip\etc Then look in that directory to make sure it contains a file named RESOLV (no extension). Currently, InJoy will not preserve new or special options that might already existing the RESOLV file. This is being worked on and new functionality regarding this may be expected in future releases. If you experience problems resolving host names (even though you feel your nameserver is set up correctly) check for the existence of a RESOLV2 file in your ETC directory. The RESOLV2 file is sometimes used (seems to depend on TCP/IP stack version) on a LAN. Edit the existing RESOLV2 file or simply copy your standard RESOLV file over RESOLV2 to either refresh or create the secondary RESOLV file. InJoy does not automatically alter the contents of the RESOLV2 file. o Your host name The host name is a bit tricky. As set in your CONFIG.SYS file applies to ALL instances, except in programs auto-started by InJoy. Auto-started programs use the host name you place in this block. So, if you need a special host name for some reason, set it up in the CONFIG.SYS using string similar to: set HOSTNAME=your_host_name Normally you can leave the host name field blank in InJoy, as it is for special needs. o Domain name This is the domain in which your computer exists on the Internet. You should specify the symbolic name that you have received from your ISP. ========================================================================== C O M M U N I C A T I O N S E T U P =======================================Basic Stuff, Use the Online Hints== The communication setup screen enables you to specify the parameters required for your communication link: Ûßßßßßßßßßßßßßßßßßßßßßßßßßß Communication setup ßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ Call control ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ (o) Let InJoy make the call ³ Û Û³ ( ) Use Terminal Mode [ ] Autostart packet mode at dial if DCD? ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÚ Port setup ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ Port setup...........: COM3  [X] Use hardware flow control ³ Û Û³ Port speed...........: 57600  ³ Û Û³ Minimum connect speed: 28800  Dial timeout: 45 seconds ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÚ Modem & Dialing ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú Redial/Reconnect ÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ Phone number #1......: 555-1234 ³³ [X] Redial ³ Û Û³ Modem initstring #1..: AT&F ³³ Attempts......: 1 ³ Û Û³ Modem initstring #2..: Specify it ³³ Pause between.: 5 sec(s) ³ Û Û³ Dialing prefix.......: ATDT ³³ ³ Û Û³ Hangup string........: +++~~~ATH0 ³³ [ ] Reconnect at conn. loss ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ More phone numbers... ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Most of this setup you probably already know from other communication programs, so lets focus on the InJoy specific parameters: o Call control In this window you specify whether InJoy should make the call for you, or not. If you choose to do so, InJoy will automatically initialize your modem and call the specified host's telephone number, when you click on [Dial]. Your job will be only to answer prompts (like giving user ID and password) after having dialed. (Or maybe you wish to auto-generate a log on scrip, if required. Many ISPs no longer need scripts, see below for details.) The other possibility is to use Terminal Mode, which will put you in charge of initializing the modem and setting up the call. Even when running Terminal Mode, you can still generate and auto-run script. When you choose Terminal Mode as the call control method, then you say goodbye to some valued services like automatically re-dialing and re-connecting after an unexpected line drop, so make sure you have a good reason for selecting Terminal Mode for dialing. Checking the "Autostart packet mode at dial if DCD?" causes InJoy to enter packet mode immediately, if DCD is present. If not present, InJoy will revert to terminal mode and the "press ESC to start packet mode" will appear when the CARRIER is up. This feature is just what is needed for a leased line or null modem setup. Using or learning scripts in any way disables this function. o Phone number #1 This is the primary phone number used if you choose to let InJoy make the call for you. The phone number you specify here is always the first phone number to be dialed. If your ISP provides several phone numbers in your calling area, you have the opportunity to list them here and have InJoy keep dialing until it finds a free line. Refer to the "More Phone Numbers" section below, for more info. o Dial Timeout This is the amount of time that InJoy will allow your modem to attempt to negotiate a 'handshake' with your ISP's modem. You may set any value between 0 and 999 seconds. If the modem's initialization string (or modem default) for the S7 value is less than what is set in InJoy's "Dial Timeout" on the "Communications setup" page. That situation allows InJoy to 'time out' and disconnect PRIOR to the modem's 'time out' causing the disconnect which then is passed to InJoy. The solution is to either decrease the S7 time, or increase the value set in the "Dial Timeout". Bottom line: Modem S7 needs to be LESS than InJoy's dial timeout. o Redial Placing an X next to this attribute causes InJoy to initiate another dialing attempt when the first attempt fails. - The number of times InJoy should attempt to dial a number is set in the "Attempts" block. (It is not possible to set the value to zero, as that would prevent InJoy from dialing.) - The amount of time, in seconds, to pause between dialing attempts is set in the "Pause between" block. o Reconnect at conn. loss This option, if checked, causes InJoy to attempt to re-connect if for some reason the link fails after initially being established. This helps keep a constant connection, making InJoy the perfect choice for keeping a connection alive 24 hours a day. ========================================================================== M O R E P H O N E N U M B E R S =======================================Giving More Chances to Hook Up===== If you elected to have InJoy do the dialing, you may specify a list of phone numbers to be tried in case of unsuccessful dial attempts. In order for InJoy to use the list you MUST enable re-dialing. Having done so, you are able to click on the "More phone numbers . . ." button at the bottom center of the Communications Setup screen. That will open and the following screen where you may add the additional phone numbers: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßß Phone number list ßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Phone number: Û Û 555-1235 Ú What to dial? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ( ) All numbers in list ³ Û Û ³  Add ³³  Update ³ ³ (o) Selected numbers only ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Ú[ Phone numbers ]ÄÄÄÄÄÄÄÄÄÄÄ¿ Ú Dial sequence? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³555-1234 - Primary phone nu ³ (o) Round robin ³ Û Û ³ 555-1235 - (backup #1) þ ³ ( ) Retry each number (1) times ³ Û Û ³555-1236 - (backup #2) ± ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ³ 555-1237 - (backup #3) ± Û Û ³ 555-1236 - (backup #4) ± [X] Exit InJoy at redial fail Û Û ³ ± Û Û ³ ± First number in the list is your Û Û ³  primary phone number. This number Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ is dialed regardless of the redial Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ option. You cannot remove this Û Û ³  Waste phone number ³ number from the list. Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ÚÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ o Phone number In this field you may add as many as 10 phone numbers to the list. o What to dial With this option you control whether every number on the list will be dialed, or if only those selected should be dialed. Select numbers by using either the mouse or the SPACE key in the "Phone numbers" list box. Selected phone numbers are marked by a different color and a round symbol preceding the number. Note that the primary phone number cannot be de-selected. o Dial sequence In this section you set how InJoy will sequence the listed and selected numbers. Skipping to a new phone number after each dial attempt is known as Round Robin dialing. Using this alternative causes InJoy to skip ahead to the next number (in the listed sequence) if a busy signal or other non-connect situation occurs on any number. The "Retry each number (x) times" option will cause listed phone numbers to be tried the number of times specified in the "Redial attempts" parameter before attempting the next number. The "Redial attempts" parameter is set in the "Communication setup" screen. By learning what the problems are in your area usually are, you will be able to determine, and use, the method provides the best connect rate. o Exit InJoy at redial fail You may have the need to continue redial attempts. You can establish that by selecting to quit InJoy after having run through the phone number list. The "Exit InJoy at redial fail" parameter in combination with the auto-connect to host at start-up will enable you to redial forever. ========================================================================== P P P / S L I P O P T I O N S =======================================Tune for Speed===================== The PPP and SLIP options screens (accessed by single clicking on the "PPP Options" or "SLIP Options" button in the lower half of the screen) lets you to make choices which help tailor InJoy to your communications line for maximum performance: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßß PPP options ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ Toggles ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Ú Miscellaneous ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ ³ ³ ³ Û Û³ [X] Allow PAP Authentication ³ ³ Restart timer..: 1000 ³ Û Û³ [X] Allow CHAP Authentication ³ ³ Max. tries.....: 15 ³ Û Û³ [ ] Allow MS-CHAP Authentication ³ ³ MRU............: 1500 ³ Û Û³ [ ] Negotiate ACCM to 0 ³ ³ Interface name.: PPP ³ Û Û³ [X] FCS checking ³ ³ Priority %.....: 70 ³ Û Û³ [X] Addr & Cntl field compression ³ ³ PPPFLAG timeout: 2000 msecs. ³ Û Û³ [X] Protocol compression ³ ³ ³ Û Û³ [ ] ECHO-REQ resets idle timeout ³ ³ ³ Û Û³ [ ] Enable auto pinger ³ ³ ³ Û Û³ ³ ³ ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û Û Û Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÉÍÍÍÍÍÍÍÍÍÍÍ» ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Make fast ³ ³ Make slow ³ º Default º ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÈÍÍÍÍÍÍÍÍÍÍͼ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Note: Don't overlook the capability in the PPP Options screen to just click on the "Make fast" button and then the "OK" button. The "Make fast" settings might be all the speed you need and it might save you from having to read all this: o Allow PAP Authentication (PPP Only) To make sure that you are not authenticating in clear text, turn this option off. However, there is normally there is no reason to turn PAP Authentication off since CHAP is negotiated before PAP, if the host server allows such. Therefore, clear text passing of your user name and password is unlikely, but possible. The bottom line: If you have special data to protect OR need to be SURE your password is never exposed in clear text (on the phone line), then turn this option OFF. o Allow CHAP Authentication (PPP Only) In some very special circumstances you may need to turn off CHAP authentication. There are a few known PPP servers which behave very strangely when they receive a CHAP response, even though they ordered such a response themselves. o Allow MS-CHAP Authentication In the name of security Microsoft introduced an extension to CHAP which made their NT servers incompatible with non-MS log on routines. However, InJoy will authenticate using MS-CHAP techniques if you enable this switch and when challenged for you user account name you must reply in typical NT format, e.g. "redmonde\billsux" where "redmonde" is a NT domain containing the user account "billsbucks". If a domain is not provided, the backslash should also be omitted, e.g. "billsbucks". If you have trouble you might need these error MS-CHAP error codes: 646 ERROR_RESTRICTED_LOGON_HOURS 647 ERROR_ACCT_DISABLED 648 ERROR_PASSWD_EXPIRED 649 ERROR_NO_DIALIN_PERMISSION 691 ERROR_AUTHENTICATION_FAILURE 709 ERROR_CHANGING_PASSWORD They are returned in a line similar to: Remote message: E=649 R=0 The "E=" is the error number from the table above, and the "R=" flag indicates whether the error is transient and the client should retry. If you consistently get error 691, then either you're using the wrong account name/password or another problem I'll need to help with. So, check the name/password settings and if problems persist see README.DOC for support contacts. o Force ACCM to 0 (PPP Only) ACCM - Asynchronous Control Character Map, is a table specifying which characters that may NOT be transmitted transparently on the link. Today, the use of ACCM is almost gone, but some hosts still set up this table to the default value of 0xffffffff. This means that all characters below 0x20 will be escaped and accordingly occupy 2 bytes each. Setting the "Force ACCM to 0" will make InJoy attempt to negotiate the ACCM mask to 0, and thereby remove the use of the mask. Setting the 0 parameter will also make sure that InJoy will not exercise the default 0xffffffff mask to the host. In general, turning this parameter on is a very beneficial to line performance. Bad side effects from doing so are uncommon. o FCS checking (PPP Only) Set this parameter on to make InJoy check all incoming packets for a correct Format CheckSum (FCS). Checking will take a little away from total performance (not much though). In most cases there is no need to turn on this feature since the TCP protocol processes the checksum as well. Be careful though: InJoy's PPP negotiation is NOT running on top of TCP/IP. Therefore, line errors occur while negotiating might give unpredictable results. It is therefore recommended that conservative systems should have this parameter on. o Addr & Cntl field compression (PPP Only) Each PPP packet includes a few leading bytes that hardly ever change. Selecting this option will force compression of these bytes and save a couple of bytes per PPP packet. There should be no side effects for turning on this option and the CPU load is not affected by it. o Protocol compression (PPP Only) This routine compresses the protocol information in the PPP packets from two to one byte. (Why not save a byte where possible?) Enabling this option does not take any additional CPU and saves a byte per packet. o ECHO-REQ resets idle timeout (PPP Only) Some ISPs send echo request periodically to test if your machine responds (if not, the ISP drops the line). Each request/answer pair resets the idle timer and may cause the connection to never timeout and disconnect. Remove the X from this block to ignore echo requests and NOT reset the idle timeout--this allows disconnects to occur based on the lack of other data flow. o Auto pinger (PPP Only) For use in a future version, this item is not yet functional. o Restart timer (PPP Only) The PPP negotiation protocol uses a timer to resend protocol blocks which contained errors again, at the correct time. For example: If your PAP/CHAP user ID and password block is lost during transmission (maybe due to a bad connection) it must be retransmitted. The time for the retransmission is specified by the restart timer, and the sooner the better (within the limits of your communication line). Therefore, the lower value the better. This parameter can have a BIG influence on the negotiation time, so try to fine tune this value to be as small as possible. (InJoy ships with a default of 1000 milliseconds, work down from there when searching for supreme speed. However, some host have be found which require as much as 5000 milliseconds.) Keep in mind this timer only affects the time required to negotiate a connection with your ISP. It does NOT affect the actual throughput of the line once the connection is completed. o Max. tries (PPP Only) Specifies how many times the PPP protocols blocks should be resent in case of bad or missing response. Values of 5 to 10 should be sufficient for most implementations. o Maximum Receive Unit (MRU) (PPP Only) The Maximum Receive Unit sets the maximum number of bytes that we are capable of receiving in one PPP packet. Generally, the bigger the better (up to the 4136 max), as the round trip delay of most connections is fairly large. An incorrect MRU value may be the root cause of an inability to transmit/receive TCP/IP packets even though a PPP connection was successfully negotiated. If you experience that situation, try decreasing the MRU value to see if more reliable operation will result. During PPP negotiations, InJoy attempts to negotiate the MRU size set by this parameter. However, many host servers do not allow the MRU value to be negotiated and instead dictate the value used. InJoy automatically accepts host dictated values even though higher values improve line performance significantly. o Maximum Transmit Unit (MTU) (SLIP Only) This setting is similar in nature to the MRU setting in PPP, except that instead of setting receive packet size, it sets the maximum size of transmitted packages. A setting larger than 1500 (the default) imposes a risk of sending packets larger than those supported by your ISP. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß SLIP options ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ Toggles ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Ú Miscellaneous ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ ³ ³ ³ Û Û³ [X] Allow PAP Authentication ³ ³ Restart timer..: 1000 ³ Û Û³ [X] Allow CHAP Authentication ³ ³ Max. tries.....: 20 ³ Û Û³ [X] Negotiate ACCM to 0 ³ ³ MTU............: 1500 ³ Û Û³ [X] FCS checking ³ ³ Interface name.: SLIP ³ Û Û³ [X] Addr & Cntl field compression ³ ³ Priority %.....: 70 ³ Û Û³ [X] Protocol compression ³ ³ PPPFLAG timeout: 1000 msecs. ³ Û Û³ [ ] Enable auto pinger ³ ³ ³ Û Û³ ³ ³ ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û Û Û Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Make fast ³ ³ Make slow ³ ³ Default ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ o Interface name (Both PPP and SLIP) This is the symbolic name used as prefix for the PPP/SLIP interface. Keeping the default value of "PPP" or "SLIP" is a good choice. This parameter should only be changed if your ISP directs you to use something else. o Priority (Both PPP and SLIP) The priority parameter specifies the priority that OS/2 will assign to the InJoy dialer. The value may be fine tuned by hand, but you should be aware of the following: -- Any value larger than 75 percent, will register InJoy as a time critical process. Being time critical is a logic choice for a program handling the CPU demanding COM port. -- However, raising the value much above 75 percent may cause system hangs as the OS/2 scheduler will not allow other processes to "wake up" when they are really needed. o PPPFLAG timeout (PPP Only) Each PPP packet can potentially start with a 0xFF byte. Normally the 0xFF is only inserted in the PPP frame if the line has been idle for a while (normally 2 seconds). Some servers require this byte in each package, if that is the case with your ISP, set this option to 0. However, since this PPP FLAG byte is not normally needed, you might want to try setting the timeout to the maximum value of 9999, and see if performance improves. ========================================================================== I P M A S Q U E R A D I N G =======================================Many Through One=================== IP Masquerading allows you to share one dial up connection. With it you can use InJoy as an Internet gateway for your LAN even though you have only one ISP account, one IP address and one modem. NOTE: IP Masquerading is not available in the InJoy Basic Client Version, whether registered or not. This function is only available in the InJoy Extended Client and InJoy Professional Enterprise Server/Client version, only. These applications will run with InJoy's IP Masquerading: o Netscape and WebExplorer (or any other web browser) o Any FTP client o Any mail client (PMMail, MR/2 ICE, etc) o News readers (Agent, NR/2, etc) o IRC (but DCC send and identd is not yet supported at client PC's) o Telnet o Gopher o Servers (will run only on InJoy PC and may require individual setup to work). If servers are a requirement for you, then ask me for assistance! Any other client running TCP or UDP protocol should be running. These applications will NOT run: o PING - Works only from InJoy computer o TRACERTE - Works only from InJoy computer o Programs not running TCP or UDP protocol - Will run on InJoy computer though. o Servers on LAN client PC's. For example, a WWW/HTTP, mail or news server running on any machine OTHER THAN the machine running InJoy will not pass data to/from the Internet. Like a full fledged firewall, this feature of InJoy shields all LAN clients from direct outside contact. Though InJoy is not expected to evolve into a more advanced, secure (and expensive) firewall I am looking into making it possible to configure exactly what is necessary to run servers on an LAN clients. But, that is a future project which will take many rainy days . . . for now you just have to live with the functionality of a simple firewall. o IRC DCC Send - Works only from InJoy computer IP Masquerading, General Information: With InJoy's IP Masquerading your LAN has only one IP address. In other words, to other machines on the Internet your entire LAN appears as if it is only one machine. Consequently, when a user on your LAN sends data through InJoy to the Internet, each data packet's IP address must be changed from the individual user's LAN address to the single address 'seen' by the Internet. Similarly, incoming packets are changed so they can routed to the appropriate user on your LAN. These actions are highly dependant on the source and destination port number information in the TCP or UDP protocol. Port numbers are changed before going to the net and again when IP packets come back from the net, the same port numbers are examined to find the matching IP address. This process is a bit complicated, but luckily not very CPU/RAM consuming and as a user you should see nothing but a well functioning Internet connection. In addition to the setup tips that follow, several different thoughts on setting up IP Masquerading is presented in the file FAQ.TXT. Try them all to find the one that works best for you. Check my Web site for more information, and, if you run into setup problems be sure to consult with the experts on the InJoy Mail List. Masquerading options screen has two areas for user input: Ûßßßßßßßßßßßßßßßßßßßßßßßßß Masquerading options ßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Û Û [ ] Don't masquerade InJoy PC Û Û Û Û Masquerade port number offset: 60000 Û Û Û Û Û Û This option will turn off masquerading for the InJoy PC, giving Û Û better support for servers and special proprietary protocols. Û Û Û Û On the technical side this gives a slight chance of collision between Û Û the TCP/UDP port numbers used by the InJoy PC and the port numbers Û Û used by LAN clients. Setting 'port number offset' to a high value Û Û will minimize risk. Û Û Û Û Even when not masquerading the InJoy PC, Dial On Demand should still Û Û work as the IP address will be manipulated if needed. Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ The above screen defines the few options available for IP Masquerading. o Don't masquerade InJoy PC If you run IRC DCC or any other tricky protocol, then you should choose not to masquerade the InJoy PC and then use that PC for such purposes. Read the comment on the screen layout. o Masquerade port number offset Specifies the offset used when masquerading the source ports of the TCP/IP packets. InJoy has to change these port numbers to be able to recognize reply packets and send them in the right direction. Normally, port numbers are in the range 0-5000 depending on the time since last boot. Masquerading these port numbers to a higher value in order to avoid conflict when not masquerading the InJoy PC is a MUST. Much more information is available in the FAQ, and here is a quick check list about what to remember when setting it up: o Check my HTML page on the subject o Make sure your LAN clients have good nameserver references. Your ISP nameserver must be referenced in order for your LAN clients to be able to resolve symbolic host names! o Make sure your LAN clients default route to the InJoy computer. This way InJoy gets packets not destined for your own network and can process them for the Internet. - The InJoy Mail List is full of bright folks that knows a lot about how to make different setups work! - You might be required to turn on IP forwarding for the TCP/IP stack. This can be done by running 'ipgate on' at system start up or by setting the appropriate check box under route set up in the OS/2 TCP/IP configuration. o And remember: - You cannot ping/tracerte from the LAN clients as they don't use the TCP/UDP protocols (needed to masquerade). - Server support is very complicated with masquerading. At the moment you can run an FTP server at the InJoy PC, but that is basically it! More support later on! ========================================================================== D I A L O N D E M A N D =======================================Disconnect Actions================= Dial on Demand (DOD) allows for automatic dialing when an application on your machine or a masqueraded LAN machine needs it; auto-disconnecting when the connection is idle (using the idle timeout feature); and, auto-dialing again, at the next need/demand. This powerful connection charge saving feature is only available in the InJoy "Extended Client" and "Professional Enterprise Server/Client" versions. To enable dial on demand in its most basic form, enable the "Dial On Demand" option, accessed by clicking on "disconnect options" on the PPP/SLIP setup page. Ú[ Dial On Demand ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ [X] Dial On Demand (DOD) ³ ³ [ ] Refresh interface ³ ³ [ ] Masquerading (single user) ³ ³ [ ] Display DOD indicator ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ NOTE: Dial on demand is NOT enabled until you have successfully dialed your ISP and disconnected. That action is required in order to set up route information needed for subsequent connections. Dial on demand varies in complexity depending on outside parameters, such as dynamic versus static IP addressing and use of IP Masquerading versus single user mode. o Dial on demand with statically assigned IP address: In a scenario where the ISP configures your PPP connection with a static IP address, you should expect great results from Dial On Demand with absolutely no drawbacks. Just enable the "Dial On Demand" option and it should work. o Dial on demand with dynamically assigned IP address: Dial on demand was never meant for use in an environment with dynamically assigned IP numbers. Routes are kept across connections and using dynamically assigned IP addresses gives inconsistency. To compensate you have the option of refreshing the PPP0/SLIP0 interface at each connect or enabling single or multi-user IP masquerading. If you normally do not need multi-user IP Masquerading opt for single user Masquerading as that is a far more simple. Otherwise, with multi-user, setup these areas: -- Refresh interface Refreshing the PPP/SLIP interface at each connect, makes it possible to reflect the correct IP addresses and thereby give a clean connect without the need for IP Masquerading (assuming you don't need IP Masquerading to share your line). When connecting using this option, your Internet applications will have TCP/IP connections that still use the old interface (the IP address of the your previous connection) as will the application initiating the Dial on Demand. A re-connect demand (as in choosing reload in your browser) will bring your TCP/IP applications back to life. The above should be the only drawback of this implementation. -- Masquerading (single user) This will enable a simple (single user) IP Masquerading mechanism. All the standard TCP/IP applications should work using this mechanism and there are no known drawbacks in a standard environment. IRC DCC requires some extra support and so will any application that requires a connect back. If enabled, multi-user IP Masquerading will take precedence over this option. o Look 'n feel In this section you can find a few hints that will prove useful when working with Dial on Demand. First of all, if you have Dial on Demand enabled and you really don't want InJoy to dial until you again select a specific host, then turn it off using the F5 key. In a disconnected state, you can monitor the status of dial on demand by looking at the CPS meter in the bottom of the screen. A red bar will visualize the packet scanning activity, assuming that you have the "Display DOD indicator" option turned on. ========================================================================== H O S T T R I G G E R E D A C T I O N S ==================================================Distant Command========= Host Triggered Actions allows you to setup InJoy to monitor the COM port and react to a secret "trigger string" passed from the LAN server, ISP, or your laptop (while on the road). So far, client actions are restricted to reboot and/or redial the current host. Registered users are invited to make their needs known. Access the setup (shown below) by clicking on [...Disconnect actions] on the PPP or SLIP setup page: Ú[ Server triggered dialing ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ [X] Monitor COM port Actions ³ ³ Trigger string.: *************** [x] Call this host ³ ³ Delay..........: 99 msecs. [X] Boot computer ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ COM port monitoring requires the port to left open at all times. To do that, click on the [Misc. opt.] button on InJoy's face, then on the [ General options ] button and click to put an X in the "COM port always open?" check box under the [ "More... ] heading. Easy. Now, just pass the secret trigger string through the COM port and enjoy InJoy. ========================================================================== S C R I P T S E T U P =======================================Simple and Effective=============== Prepared scripts take all the pain out of logging on your ISP's server by completely automating the entire process. Therefore, I tried to make script setup as simple as possible, but here are a few items which are nice to know. First, if your ISP has either PAP or CHAP you will probably NOT need a script. So, check out that option FIRST. Just make sure PAP and CHAP are enabled on the PPP setup page and try a connection while the "Automatically learn script" check box is empty. If your UserID and password is accepted automatically and a connection is negotiated, you can skip this whole section. :-) And, if the first attempt fails, you still might be able to log on without a script by turning off CHAP. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßß Script setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Ú Script filename ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Script filename.: TestOne_.scr ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Ú Learn options ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Scripts will help you automating Û Û ³ ³ the host login process. Û Û ³[ ] Automatically learn script ³ Û Û ³[ ] Scan for IP addresses ³ Automatically learned scripts Û Û ³ ³ normally just work, but in some Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ situations they require a human Û Û touch. Û Û Ú Script execution options ÄÄÄÄÄÄÄ¿ Û Û ³( ) Autorun script when connected³ If your autogenerated script does Û Û ³( ) Autorun script at host select³ not work, then edit the script- Û Û ³( ) Don't run ³ file by hand, synchronizing script Û Û ³Script delay: 250 millisec(s) ³ and host login prompts. Remove Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ non static 'prompts' from script. Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³Reset script³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Most of the options are self explanatory, let's look at what is not so obvious: o Script file name Naming your script is simple, just be sure that you do not have two hosts with the same name for the first 8 characters. That is not illegal, but when creating new hosts you might accidentally overwrite a needed script when InJoy automatically generates the new script based on the first 8 characters of the host's configuration name. The above fact makes deleting, resetting and creating a script just a bit tricky, so take care. o Scan for IP addresses Enable this option if you are running SLIP and need to grab the IP addresses from the text sent to you by the server. The "Scan for IP addresses" is only used in connection with script learning. Found IP addresses are presented to you upon script learn completion and at that time you have to link the IP addresses found to match the "Your IP address" and "Gateway IP address" fields. InJoy will insert two lines in the bottom of your script like shown below. One of them to find and identify "Your IP address" and one to identify "Gateway IP address". RX: Welcome to SLIPNET TX: \r RX: Login: TX: 200000000000\r RX: Password: TX: cataftermouse\r RX: Interface going up!\r\n GY: Your IP address is: [$YOUR_IP] GD: My IP address is: [$DEST_IP] Be sure that your script is waiting for data to arrive after the IP addresses. This gives InJoy a chance to scan the data received for the script, and is done in the above by the line: RX: Interface going up!\r\n It works because IP addresses are sent before the interface is reported as "going up", giving InJoy a chance to search the script input buffer for IP addresses. o Script delay Script delay is a timer which sets how long InJoy waits between the execution of each line in the script. Normally, since scripts wait for prompts after having sent something it is not dangerous to set this value very low (even below the 200 in the "default" host) but, sometimes a critical timing situation may occur causing the modem to hang. In some cases the modem is no longer capable of even responding with an "OK" to an AT command. In other cases the modem is not able to handle AT commands in a very fast sequence even though it has answered back with and "OK". The bottom line is that 250 should work; less than that will improve performance IF hardware on both ends can support it; and, two seconds should give even the oldest (and slowest) hardware ample time to get the job done. Notice that this value must be specified in milliseconds. (1000 milliseconds equals one second!) ========================================================================== S C R I P T L A N G U A G E =======================================Roll Your Own====================== The script language is very simple and it includes the following commands: TX: text to send RX: text to expect DE: milliseconds .. delay in milliseconds (1000 = 1 second) PA: E71 PA: N81 GY: Here is your IP address: [$YOUR_IP] GD: Here is the Gateway address: [$DEST_IP] ID: Put up an interactive box, allowing input PS: Put up an interactive box, allowing input (not echoed) In order to specify Carriage Return and/or Line Feed in the scripts, you have to use the the following escape characters: \r - indicates a Carriage Return (0x0D). \n - indicates a Line Feed (0x0A). \\ - indicates just a normal backslash. \! - indicates the character Escape (0x1b). Check this simple sample of an average script: RX: login: TX: [$USERID]\r RX: password: TX: [$PASSWORD]\r Check out this example to see how the scripts can be used (full sample): DE: 2000 TX: \r RX: login: TX: [$USERID]\r RX: password: TX: [$PASSWORD]\r RX: annex TX: ppp\r RX: Enter todays dynamic secret: ID: Enter the secret!!! ; Will show a box allowing user ; input... "Enter the secret" ; will be the user prompt! RX: Enter top secret admin password: PS: ; Will show a box allowing a ; password to be entered non- ; echoed.. Keeping the format ; "PS: " is mandatory. The e.exe ; will allow for having a space ; character as last character. RX: Interface going up\r\n GY: Your IP address is: [$YOUR_IP] ; Grab the IP addresses from GD: My IP address is: [$DEST_IP] ; screen The first line of this script waits for 2000 milliseconds (which is 2 seconds) and then continues to wait for the prompt "login:". Upon receipt of that prompt it sends the special InJoy meta variable that includes the user ID you specified under the host setup. You should also notice that a similar meta variable for the password also exists. It is perfectly legal to start the script using any command. It is also allowable to specify the same command several times in a row, i.e. You don't have to wait for something between each send, and you don't have to start the script by waiting for something. If you have InJoy auto-generate a script for you, the script file is saved when you press ESC to enter PPP packet mode. You can modify the saved file, if you need to, using a text editor. For example you may wish to streamline the script which InJoy automatically created for you. Some hosts require you to log in using 7 databits and EVEN parity (e.g. Compuserve). For that purpose you can use the 'PA: E71' directly in your script. To go back to 8 bit no parity use the 'PA: N81' verb. ========================================================================== S A V I N G H O S T I N F O ====================================Default or Not?======================= After filling in all host information, you are returned to the SLIP/PPP setup screen where you may 'save host' or 'save as default'. Clicking on 'save host' will cause the information entered in the various setup screens to be associated with the host name you selected as a first step. 'Save as default' does much more. It overwrites the information in the 'default host' as it existed when InJoy was distributed. Therefore, you may wish to initially use 'save host' until you have a proven workable setup. Then, when you are ready to experiment with tweaking the various setting to improve performance, you may want to to save a new setup you created as the 'default host'. Then, each newly created host begins with proven characteristics (and your password/ID/etc) and you only need change potential performance enhancing fields. ========================================================================== D I A L I N G =======================================How InJoy Dials, and Why=========== InJoy was designed for two kinds of dialing. The easiest dialing mode is, of course to let InJoy do the dialing and let a script do all the log in process. o InJoy dialing If you enable InJoy dialing (refer to communication setup), InJoy will initialize the modem and then dial your host's number. To do that InJoy uses a special script with the following cycle: - Try to initialize modem using initialization string 1 (if available) - Wait for a maximum # of seconds as specified by dial timeout. - Try to initialize modem using initialization string 2 (if available) - Wait for a maximum # of seconds as specified by dial timeout. - Try to dial the number (using primary phone number and dial prefix) - Wait for a maximum # of seconds as specified by dial timeout for any of these responses: CONNECT, ERROR, NO DIAL TONE, NO CARRIER, NO ANSWER, BUSY, FAIL, or OK. These are the basics of the connect script, but InJoy also supports redialing, re-connecting and auto-dialing. And, how do those features add on to the basic functionality? Well, regarding re-connect and auto-connect jump to the section describing the general dialing facilities (below). Redialing however functions together with the above script. If dialing results in anything other than a CONNECT, InJoy checks the redial flag (found under communication setup) and proceeds with the selected phone numbers in the phone number list. The modem is reset in between each redial attempt. As dialing and scripting is somewhat connected, you will find that the timer found on the script setup page is also used for dialing. This timer specifies for how long InJoy will wait between executing each line of a script. In general it should not be dangerous in any way to have this timer set very low, as the scripts normally waits for something (e.g. an OK response from the modem) before continuing. o Terminal Mode dialing Doing your call using Terminal mode is very simple. As with any other program providing a Terminal Mode, you issue AT commands directly to the modem. When InJoy detects a connection, it will pop up a small window notifying you that you can press ESC to start PPP packet mode. As with InJoy dialing, you can store the commands you give in a script, but the difference is that while using Terminal Mode you would normally like your script to execute at the point of host selection (refer to script setup to see how that is done). If you do not want to edit an auto-learned script, or if you want to overwrite a previous script, you can use ALT-L to start the auto-learning of a new script. When auto-learning a script, follow the instructions on the screen. If you plan to use a NULL-MODEM for connection to a host, you will find Terminal Mode to be very useful as well. o General for both types of dialing methods Regardless of how you choose to dial you have the possibility of combining your dialing with the re-connect and auto-connect functions. Re-connect hasn't got much to do with the dialing itself, it simply re-SELECTS your active host right after being disconnected (in an unprovoked manner, such as carrier drop, ISP dead, etc, etc). Auto-dial hasn't got much to do with dialing either. It simply means that a special host should be auto-selected at start-up Also, remember to check the latest InJoy FAQ for questions regarding dialing! ========================================================================== C O N N E C T . T X T =======================================Your IP Address, Instantly========= When InJoy has established a successful connection, it immediately creates a file named CONNECT.TXT This file includes characteristics about your current connection. The following is an example of the contents of a typical CONNECT.TXT file: ------------------QUOTE-------------------------------------- 194.234.160.52 194.234.160.8 Host..........: IBM Advantis Modem connect.: CONNECT 57600 Line speed....: 57600 bps This file reflects the current/latest InJoy Internet connection information. YOUR IP address and the GATEWAY IP address makes up the first two lines. ------------------END QUOTE---------------------------------- CONNECT.TXT is not a semaphore file, so don't use it to determine if you are connected at any moment. Other means are available for verifying the connection at any instant . . . if you need to do so, contact the author via e-mail for assistance. ========================================================================== H A N G I N G U P =======================================Several Ways to Say Goodbye======== Normally, you should disconnect InJoy with either of these two ways: o Click on the [Hang Up] button (or key ALT-H,) will drop DTR on the modem and thereby force a carrier drop. However, if you have disconnect troubles using this procedure, the following could be a problem solver for you: o You can provoke a "graceful" PPP log off by pressing ALT-T (T to Terminate the session). When necessary InJoy may also be forced to break the connection by running KILLJOY (see below for more details) or by pressing CTRL-BREAK. After hanging up (with any of those methods), InJoy updates the connection log for the appropriate host. Even if terminating by using KILLJOY (see below) or CTRL-BREAK, you should still get an entry in the connection log! ========================================================================== T R A C I N G =======================================Capturing Tech Data================ To trace and monitor line activity, use the trace function. To setup tracing click on the [Misc. opt] button on InJoy's opening screen, then click on the [Trace configuration] button, to reveal this screen: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßß Trace setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Û Û [X] Trace ON/OFF Û Û Û Û Ú Trace: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Ú Output to: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ [ ] Trace communication line ³ ³ [X] Trace file (IN-JOY.TRC) ³ Û Û ³ [X] Trace PPP negotiation ³ ³ [ ] InJoy output window ³ Û Û ³ [X] Trace errors ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ³ [ ] Debug information ³ Û Û ³ [ ] Trace buffers ³ Ú IPtrace support: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ [ ] Ticker ³ ³ [ ] Outgoing packets in IPTRACE ³ Û Û ³ ³ ³ [ ] Incoming packets in IPTRACE ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û Û Û Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Save ³ ³ Reset ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Trace typically captures what you see in the output screen of InJoy to a file named IN-JOY.TRC. Careful: Too much tracing will slow down InJoy considerably, and too little could keep important information from reaching your sharp eye! Removing the X in the "InJoy output window" check box allows trace data to be captured to file without the time/resource penalty of sending the same data to the screen. When running in a stable environment, it is recommended to turn ON only "Trace PPP negotiation" and "Trace errors" . . . at the most. For some users, even that will be an unneeded speed drain (however slight). The trace file is sometimes indispensable in solving problems reported to the Mail List, Support Center or program author. IPTRACE.EXE (included with OS/2) can be used to saves a trace file of both in and outgoing packets. You can use IPFORMAT.EXE (also a Warp utility) to format and display that trace file. Note: The [Reset] button deletes the trace file! ========================================================================== C O N N E C T I O N L O G =======================================Capturing Connection Data========== The connection log saves information on the connections you have had and how long they lasted. Control and view the connection log by clicking on on the [Misc. opt] button on InJoy's opening screen, then click on the [Connection log] button. Finally, select the host whose log you wish to view and you will see the date, connection start and end time, whole number of minutes connected, total amount of seconds connected and in the last column the connection time in HHH:MM:SS notation. Ûßßßßßßßßßßßßßßßßßßßßßß Connection logging monitor ßßßßßßßßßßßßßßßßßßßßßßßÛ Û Ú[ Hosts ]ÄÄÄÄ¿Ú[ Date Start End Mins Secs Time]ÄÄÄÄÄÄ¿ Û Û ³ Default ³³ 20.12.1996 04:36:28 04:36:34 0 6 000:00:06  Û Û ³ TestOne ³³ 20.12.1996 04:36:38 04:42:28 5 350 000:05:50 ± Û Û ³ ³³ 21.12.1996 15:02:05 02:23:44 681 40898 011:21:38 ± Û Û ³ ³³ 21.12.1996 11:02:37 15:43:25 280 16847 004:40:47 ± Û Û ³ ³³ 21.12.1996 18:55:12 19:05:39 10 627 000:10:27 ± Û Û ³ ³³ 21.12.1996 19:09:46 23:42:18 272 16352 004:32:32 ± Û Û ³ ³³ 22.12.1996 00:25:46 03:47:30 201 12103 003:21:43 ± Û Û ³ ³³ 22.12.1996 03:48:18 03:49:22 1 63 000:01:03 ± Û Û ³ ³³ 22.12.1996 03:50:15 03:51:26 1 71 000:01:11 ± Û Û ³ ³³ 22.12.1996 03:51:38 03:51:50 0 12 000:00:12 þ Û Û ³ ³³ 22.12.1996 13:03:58 13:32:58 29 1740 000:29:00  Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Connections overall 61* connections this month 61* connections today 5 Û Û Û Û Connects overall: 052:27:40 3147mins Longest connect: 011:21:38 681min Û Û | this month.: 052:27:40 3147mins | this month: 011:21:38 681min Û Û | today......: 003:53:09 233mins | today.....: 003:21:43 201min Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³Monthly Summary³ ³ Reset ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ InJoy will sum up the monthly connection time, when you click on the [Monthly Summary] button. Below you can see how each month for the selected host is displayed, with connection statistics. Ú[ Hosts ]ÄÄÄÄ¿ Ú[ Date Start End Mins Secs Time]ÄÄÄÄÄÄÄ¿ ³ Default ³ ³ Oct 1996 void void 81 4874 001:21:14  ³ TestOne ³ ³ Nov 1996 void void 1793 107605 029:53:25 þ ³ ³ ³ Dec 1996 void void 69 4185 001:09:45 ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³ ± ³ ³ ³  ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ To reset the connection log for the selected host, simply click on the [Reset] button. Note: The [Reset] button deletes the log file. If you need to save the data for any purpose (for example, business expense records) you must archive prior to using InJoy's reset feature. At the bottom of the connection log screen the following is displayed: Connections overall 61 * connections this month 61 * connections today 5 Followed by statistics showing the overall connect time, connect time this current month and connect time for the current day. The statistics conclude by presenting you the longest connections overall, for this month and today. Connects overall: 052:27:40 3147mins Longest connect: 011:21:38 681mins | this month.: 052:27:40 3147mins | this month: 011:21:38 681mins | today......: 003:53:09 233mins | today.....: 003:21:43 201mins The displayed connection log can be viewed as a file. It exists in InJoy's directory with the pattern XXX.LOG, where XXX will be some variation on a host name. ========================================================================== T E X T M O D E T I C K E R =======================================Old But Still Ticking============== Setup the Textmode Ticker by clicking on on the [Misc. opt] button on InJoy's opening screen and then click on the [Textmode Ticker (old)] button. During a live connection the tickers may be turned off by pressing the F8 key, or turned on with the F7 key. Though this ticker is not as fancy as the newer Graphical Ticker, it has been retained due to popular demand. The InJoy Textmode Info Ticker operates as a low priority, background function that (if enabled) connects to the InJoy server to retrieve and display the information you request. At this time the requested information may be either commercials or announcements, or both. See the screen below to get an impression the configuration options: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßß Ticker setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û [X] Enable/disable ticker What is the InJoy ticker??? Û Û [X] Commercials On this screen you select Û Û [X] Announcements whether InJoy should connect Û Û to the IJ-center or not! Û Û Seconds between fetching: 5 Û Û The IJ center will reply by Û Û Commercial server: 198.64.226.104 giving you the selected kind Û Û of information. Receiving will Û Û run low priority in the back- Û Û ground and use only very little Û Û CPU and bandwidth. Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ *** IMPORTANT *** Û Û ³ Save ³ ³ Cancel ³ This line activity will put the Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ idle timeout out of the game! Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ The 'commercial server' is the IP address of the server giving the commercials. You cannot use any server that comes to mind, but only the ones provided by the InJoy team. The default choice is probably the best, and as this writing, the only choice.) There are a few things to be considered when enabling the ticker: First, since information is constantly flowing into your machine, the idle timeout will never reach zero. And, second: You might not receive any ticker information, at all. The idle timer monitors the line activity and you will not get a idle line timeout as long as the ticker fetches. Of course you could make the 'ticker fetch interval' bigger than the idle timeout. As the speed of your connection or InJoy server may vary, I I cannot guarantee you any ticker info at all. Also, the ticker info is requested at each fetch interval, but it might show up a lot later. And finally. The 'InJoy Info Ticker Server' is NOT a server that will register your name and license number or anything else. Neither will InJoy scan your hard disk for pirate software or anything similar :-) ========================================================================== G R A P H I C A L T I C K E R =======================================A Pretty Face, and Brains========== Setup the Graphical Ticker by clicking on the [Misc. opt] button on InJoy's opening screen and then click on the [Graphical tickers] button. During a live connection the tickers may be turned off by pressing the F8 key, or on with the F7 key. If you have trouble configuring the Graphical Ticker let the team know and we will write more instructions. ========================================================================== G E N E R A L S E T U P =======================================InJoy is So Flexible=============== The general setup screen includes options for the general behavior of InJoy. Access it by clicking on the [Misc. opt] button on InJoy's opening screen, then click on the [General options] button. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß General setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ[ Confirm ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú[ CPS monitor ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Û Û³[X] Exit (when connected)? ³³[X] Average CPS based on data sent?³Û Û³[X] Exit (when NOT connected)? ³³[X] Average CPS based on data recv?³Û Û³[ ] Hangup? ³³[ ] Idle sensitivity? ³Û Û³[X] Deleting scripts? ³³[X] Smart notation? ³Û Û³[X] Deleting hosts? ³³[X] CPS values in the connect log? ³Û Û³[X] Deleting autostarted programs?³³ ³Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ Û Û ÛÚ[ Miscellaneous ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú[ More... ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Û Û³[X] Show about box at startup? ³³[ ] Disable all tunes? ³Û Û³[ ] Allow 0.0.0.0 as GWY IP addr. ³³[ ] Error box at hangup fail? ³Û Û³[ ] Disable timeout warning ³³[ ] COM port always open? ³Û Û³[ ] Disable TIMER warning ³³[ ] COM port exclusive open? ³Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ o Confirmation options Flag the options to specify what actions you would like to confirm before being performed by InJoy. Notice that regarding InJoy exit, the confirmation option here only has effect if you actually selected the [Exit] button, i.e not by pressing the ESC button! o Miscellaneous - Show about box at start-up With the 'Show about box at startup' option you can select whether the about box with register and contact information should be shown at start-up. Selecting InJoy to automatically connect at start-up will over ride the use of this flag. - Allow 0.0.0.0 as GWY IP addr. If enabled, will allow your ISP to the use of 0.0.0.0 as GWY address. In general this use is incorrect. But with certain implementations of SLiRP (refer to other sources for information about SLiRP) this actually works. If your ISP uses SLiRP and maybe runs the server called TIA, then you should check this option. - Disable timeout/timer warning Disabling the timeout and/or timer warnings will make sure that you are not disturbed with warnings in a scenario where you'd rather not see them. Use of Dial On Demand is a situation where timeout warnings can be a pain. Turning off the warnings silences warning sounds as well. o CPS monitor - Average CPS based on data sent? Should outgoing data be included in the average CPS calculation? If yes, enable this option. - Average CPS based on data recv? Should incoming data be included in the average CPS calculation? If yes, enable this option. - Idle sensitivity? Should line idle seconds have influence on the average CPS calculation? If yes, enable this option. - Smart notation? Will go from CPS (Characters Per Sec) to Kilo CPS when number of characters go beyond 1K, and InJoy will continue to show MEGA CPS when number of bytes is above 1000K. - CPS values in the connect log? Select this option to have the CPS statistics saved in the connection log for later viewing. o More . . . - Disable all tunes? Checking this option kills all sounds during timeout warnings. - Error box at hang-up fail? Enable this toggle to get an error-box if InJoy fails to hang-up the the connection. If you experience that all the time, then it might be a good idea to turn of the warning. Leased line will normally uses modems that keep the DCD high at all times. This means that InJoy will never be able to hang up such a line and that will give warnings when trying. Turning off the warning will help you avoid getting these warnings, stressing again, that InJoy is the perfect choice for almost any communication setup. - COM port always open? If using Host Triggered Actions you must leave the COM port open (place an X in the box) in order to receive the trigger string. - COM port exclusive open? A COM port may be shared, like a file, but not if it is opened in exclusive mode. ========================================================================== A U T O S T A R T I N G M O D U L E S ===========================================Start and/or Stop============== Auto-starting automatically starts or shutdowns applications, REXX scripts or batch files at any of these times: InJoy startup/exit, dial, connection established/disconnected, or pressing F9/F10 keys. NOTE: You may setup InJoy to autostart in two different ways by using the setup screens in two different places in InJoy. Settings accessed through the [Misc. opt.] button on the startup/operating screen operate with ALL hosts. Settings placed in the dialog accessed by clicking on the [ Autostart per host ] button on the Host setup page will operate only with THAT host. The following screen shot and instructions apply to autostarting either globally or for one host . . . so carefully choose WHERE you enter the setup dialog. Ûßßßßßßßßßßßßßßßßßßßßßßßß Autostarting modules ßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Û Û Path and filename ÚÄÄÄÄÄÄÄÄÄ¿ Ú[ Autostart list ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ___________________ ³ Add-> ³ ³ E:\download\ncFTP\ncFTP.cmd  Û Û ÀÄÄÄÄÄÄÄÄÄÙ ³ C:\TCPIP\BIN\NISTIME.EXE þ Û Û ³ ± Û Û Parameters ÚÄÄÄÄÄÄÄÄÄ¿ ³ ± Û Û ___________________ ³Update-> ³ ³ ± Û Û ÀÄÄÄÄÄÄÄÄÄÙ ³ ± Û Û Working directory ³ ± Û Û ___________________ ÚÄÄÄÄÄÄÄÄÄ¿ ³ ± Û Û ³ Remove ³ ³  Û Û ÀÄÄÄÄÄÄÄÄÄÙ Àþ±±±±±±±±±±±±±±±±±±±±±±±±±±±±±±Ù Û Û Start Stop Û Û at at Other program specific options Û Û [ ]-[ ] my command ÚÄÄÄÄÄÄÄÄÄ¿ [ ] Start minimized Û Û [ ]-[ ] InJoy startup ³ Ok ³ [ ] Don't start Û Û [ ]-[ ] dial (before) ÀÄÄÄÄÄÄÄÄÄÙ [ ] Start only once Û Û [ ]-[ ] host connect Û Û [ ]-[ ] discon.(before)ÚÄÄÄÄÄÄÄÄÄ¿ General autostart options Û Û [ ]-[ ] discon.(after) ³ Cancel ³ [ ] SetJoy wait (caution) Û Û [ ]-[ ] InJoy exit ÀÄÄÄÄÄÄÄÄÄÙ [ ] Disable ALL autostarting Û Û Û Û Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Path, file name, parameters and working directory must be set up as with any other program object in OS/2. NOTE: An unnecessary trailing back slash in the working directory line can cause problems. For example, if you use D:\SOUTHSDE\PMMAIL\ instead of the correct D:\SOUTHSDE\PMMAIL you will find that PMMail will not startup correctly. The check boxes in the bottom half of the screen allow you to start or stop the applications listed in the 'Autostart list' in many different ways. Most settings and uses are self-explainatory or fully covered by the on screen 'hints'. A few things that may need additional information are: - If you do not need to start a listed program for some time, you don't have to delete it, just mark the "Don't start" check box. - Starting programs minimized does NOT work for PM applications. This is an OS/2 limitation. - For InJoy to be able to stop an auto-started program at any time, it must be able to stop it at InJoy's close. Therefore, to select program closure at my command, dial, connect OR disconnect the 'Stop at InJoy exit' block must be checked. For example: To auto-stop a program at host connect, you must place an X in BOTH the 'Stop at host connect' AND 'Stop at InJoy exit' blocks. - To change the settings of any single application you MUST press the [ Update-> ] button while the desired parameters are displayed for THAT item, prior to pressing the Ok button to close the dialog. Use CAUTION when setting up a program to autostart with 'SetJoy wait'. 'SetJoy wait' causes InJoy to PAUSE until it receives a SetJoy proceed signal. Use this feature AT YOUR OWN RISK, incorrect set up may cause a connection to continue long after it should have ended. However risky it might be, it is also a powerful and useful feature -- when used correctly: 'SetJoy wait' should ONLY be enabled when you want to autostart a program, REXX script or batch file and have InJoy NOT continue and dial, or disconnect until allowed by running setjoy.exe with the /C switch. You may run the program from a command prompt, batch file or Rexx script in this format: setjoy.exe /C ========================================================================== C O M M A N D L I N E O P T I O N S ============================================Customized Starts============= InJoy has one available command line argument. (Item added to meet users needs . . . your ideas are welcome.) You may launch InJoy and cause it to dial any predefined host simply by using that host's name as a command line argument For example: in-joy.exe HostName NOTE: The host name used IS case sensitive. You must enter it exactly as recorded in InJoy's [ Host ] listing. Tip: You can use this technique in host objects and have several hosts you can 'click' to life. ========================================================================== K E Y B O A R D S H O R T C U T S ===========================================Busy Hands===================== The following keyboard shortcuts are available ALT-E Reset timer ALT-Q Quit script learning - do NOT save this learning session ALT-L Learn script Start/Stop - SAVE learned script ALT-T Terminate the connection, gracefully ALT-R Reset idle timeout (time line allowed to remain idle) F5 Turn Dial on Demand Off F6 Reserved for future use F7 Start Tickers F8 Stop Tickers F9 Start Programs (as selected in Autostart dialog) F10 Stop Programs ========================================================================== S E T J O Y =======================================Connected Changes================== SetJoy is a utility to change InJoy's operating characteristics while InJoy is loaded and running. SetJoy is used during specific autostart options to control shutdown timing (see "Auto-starting modules" section of this document for details). Additionally, SetJoy may be used to set the idle timeout and timer or force a disconnect. More options will be added as the popular needs of our registered users are identified. Make your wishes known on the InJoy Mail List (See README.DOC for sign up details). USAGE: SETJOY [