PC Online 1997 March

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

/ PC Online 1997 March / PCO3_97.ISO / filesbbs / os2 / injoy10a.arj / USERGUID.DOC < prev next >

Wrap

Text File | 1996-12-29 | 86.4 KB | 2,003 lines

. Bjarne Jensen . DK-4300 Holbaek . Denmark . E-mail: injoy@poboxes.com . http://www.fx.dk . . . . . _ _| | | __ \ | _ \ | | | | |\ | ( | | | ___|_| _|\___/ \___/ \__,| ____/ -------------------------------------------------------------------------- The Best Way To The Internet U S E R G U I D . D O C Release 1.0 - December 29, 1996 Copyright (c) 1996, Bjarne Jensen All rights reserved NOTE 1: USERGUID.DOC is not yet a fully mature produce. Instead, it is a "living document" constantly changing as user needs are better understood. The entire InJoy Team regrets this inconvience to you, but remain confident that the basic InJoy setup and operation is so simple that many will find this document competely unnecessary, anyway. For your convenience the latest versions of all InJoy documents are always available at my Web site: http://www.fx.dk, see you there. NOTE 2: For best viewing use a viewer allowing at least 80 columns and select a non-proportional font. The combination of the OS/2 System Editor (E.EXE) and the System Monospaced font is ideal if the word wrap option (under the Options menu) is off. ========================================================================== 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.................................Disconnect actions 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..................Connecting causes starting o Killjoy.......................................The ultimate ending Note: To locate information, use the Find option under the Edit menu of the OS/2 System Editor. Since major topic headings are both capitalized and double spaced (like in "C O N T E N T S", above) each is easily located without having to type the entire line when filling in the find dialog. You may print this file by dragging it to your printer object or through using the Print choice on the pop-up menu. ========================================================================== 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: - Auto-starting/stopping modules might not function as expected. 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 1996 v0.99 - Build Dec21 ▀▀█ █┌─[ Terminal Mode ]────────────────────────────────────────┐┌[ Host ]────────┐█ █│[opening port] ││ Default │█ █│AT&F ││ Main ISP ▒ │█ █│OK ││ Leased line ■ │█ █│ATDT555-55555 ││ Telco acc. │█ █│ ││ │█ █│ ││ [ Dial ] │█ █│ ││ [ New ] │█ █│ ││ [ Change ] │█ █│ ││ [ Delete ] │█ █│ ││ │█ █└──────────────────────────────────────────────────────────┘└────────────────┘█ █┌[ Output Window ]─────────────────────────────────────────┐ █ █│ 19:09:47:10: RX: CONFIG_ACK [ Hang Up ] █ █│ 19:09:47:10: *** IPCP LAYER OPENED SUCCESSFULLY *** ▒ █ █│ 23:42:18:38: FCS Error ▒ [Misc. opt.] █ █│ 23:42:18:72: FCS Error ■ █ █│ 23:42:18:75: Timeout warning [ Exit ] █ █└■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒┘ █ █ 847.5K 2.2M 0 0 859avg 7963max [X]█ █▄▄▄▄ HOST <vest fast> | COM3 | 57600 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 <Insert> while the Host List Window has the focus. ========================================================================== 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... █ █ vest fast █ █ User ID.... █ █ bj....................................... █ █ 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's 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 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 the InJoy FAQ or 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 this screen: █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ PPP setup ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █┌ IP address configuration ─────────┐ ┌ Domain nameserver ─────────────┐█ █│ Your IP address..: 0.0.0.0 │ │ Nameserver address: 193.162.14│█ █│ Dest. IP address.: 0.0.0.0 │ │ Backup nameserver.: │█ █│ │ │ Your host name....: bj │█ █│ Netmask..........: 255.255.255.0 │ │ Domain name.......: fx.dk │█ █└───────────────────────────────────┘ └────────────────────────────────┘█ █ [X] Use VJ Compression ┌───────────────┐ █ █ │ Save │ █ █ [ ] Auto connect └───────────────┘ █ █ [X] IP Masquerading [...Masquerading options] █ █ ┌───────────────┐ █ █ Timeout.: 0 secs. │Save as default│ █ █ Timer...: 0 mins. [...Disconnect actions] └───────────────┘ █ █ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌───────────────┐ █ █ │ Comm setup │ │ PPP options │ │Script setup │ │ Cancel │ █ █ └─────────────┘ └─────────────┘ └─────────────┘ └───────────────┘ █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ 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 timer". It specifies for how long the line may remain idle (i.e.,, nothing moving in or out) before InJoy will automatically disconnect the line. 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 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 timeout, specify a value of zero. In that case, the line will never be dropped due to inactivity. o Timer This is the timer that specifies for how long InJoy may stay connected before it will automatically disconnect. 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 timeout warning similar to that described for the idle timeout. And, you may reset this timer by pressing ALT-E. 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 ──────────────────────────────────────────────────────────┐ █ █│ ( ) Let InJoy make the call │ █ █│ (o) Use Terminal Mode │ █ █└────────────────────────────────────────────────────────────────────────┘ █ █┌ Port setup ────────────────────────────────────────────────────────────┐ █ █│ Port setup...........: COM3 [X] Use hardware flow control │ █ █│ Port speed...........: 57600 │ █ █│ Minimum connect speed: 0 Dial timeout: 60 seconds │ █ █└────────────────────────────────────────────────────────────────────────┘ █ █┌ Modem & Dialing ────────────────────┐┌ Redial/Reconnect ───────────────┐ █ █│ Phone number #1......: ││ [X] Redial │ █ █│ Modem initstring #1..: ││ Attempts......: 4 │ █ █│ Modem initstring #2..: ││ Pause between.: 1 sec(s) │ █ █│ Dialing prefix.......: ATDM ││ │ █ █│ 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 . . . 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 scripts. 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 real good reason for selecting Terminal Mode for dialing. 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 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: █ █ ............................. ┌ What to dial? ──────────────────┐ █ █ ┌─────────────┐┌─────────────┐ │ (o) All numbers in list │ █ █ │ Add ││ Update │ │ ( ) Selected numbers only │ █ █ └─────────────┘└─────────────┘ └─────────────────────────────────┘ █ █ ┌[ Phone numbers ]───────────┐ ┌ Dial sequence? ─────────────────┐ █ █ │46341747 - Primary phone nu │ ( ) Round robin │ █ █ │ ■ │ (o) Retry each number (4) times │ █ █ │ ▒ └─────────────────────────────────┘ █ █ │ ▒ [ ] 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..: 500 │ █ █│ [X] Allow CHAP Authentication │ │ Max. tries.....: 5 │ █ █│ [X] Force ACCM to 0 │ │ MRU............: 1500 │ █ █│ [X] FCS checking │ │ Interface name.: PPP │ █ █│ [X] Addr & Cntl field compression │ │ Priority %.....: 70 │ █ █│ [X] Protocol compression │ │ PPPFLAG timeout: 2000 msecs. │ █ █│ [ ] 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 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 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 4096 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..: 400 │ █ █│ [X] Allow CHAP Authentication │ │ Max. tries.....: 50 │ █ █│ [X] Force ACCM to 0 │ │ MTU............: 1500 │ █ █│ [X] FCS checking │ │ Interface name.: SLIP │ █ █│ [X] Addr & Cntl field compression │ │ Priority %.....: 85 │ █ █│ [X] Protocol compression │ │ PPPFLAG timeout: 0 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 IP address and modem. 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 client PC's - E.g. HTTP servers on client machines. Servers are not possible to run on LAN client PC's via IP masquerading. I'll do my best to provide a solution in the future, making it possible to configure exactly what is necessary to get your server running on an individual LAN client. For now you just have to live with the functionality of a simple fire wall. o IRC DCC Send - Works only from InJoy computer IP Masquerading, General Information: With Masquerading you only have one IP address. This means that the InJoy computer has to make all source IP addresses uniform before transmitting them over PPP/SLIP to the Internet. Incoming IP packets are changed as well, so they can routed to the appropriate originator (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. As a rationale to this section, I would like to conclude that IP Masquerading is a very comprehensive functionality with only very few drawbacks and even fewer unsolvable drawbacks. Go for this low cost, easy configurable feature today and share your dial up connection more effectively than with any other product I can think of. Check my Web site for more information . . . sorry, but producing tight, working code was just more important than writing words that might change as the code was developed and tested. Masquerading options screen has two areas for user input: █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Masquerading options ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █ █ █ [X] 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 minimise 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. IP Masquerading is on my observation list and there is a few known bugs, so please keep a close eye on my Web pages if this function is key to your needs. 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. o My mailing list is full of bright folks that knows a lot about this and how to make different setups work! o 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. And remember: o You cannot ping/tracerte from the LAN clients as they don't use the TCP/UDP protocols (needed to masquerade). o 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 allows for dialing when you need it and disconnecting when the connection is idle. To enable dial on demand in its most basic form, enable the "Dial On Demand" option, currently found under disconnect options. ┌[ Dial On Demand ]─────────────────┐ │ [ ] Dial On Demand (DOD) │ │ [ ] Refresh interface │ │ [ ] Masquerading (single user) │ │ [ ] Display DOD indicator │ └───────────────────────────────────┘ Dial on demand is NOT enabled until you have successfully dialed your ISP and disconnected. The reason, route information must be set up before dial on demand has a chance to function. Dial on demand varies in complexity depending on outside parameters, such as dynamic IP addressing 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. The only thing that needs to be done, is enabling the "Dial On Demand" option and the functionality is enabled. 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 enable single user or multi-user IP masquerading. If you normally do not have a demand for multi-user IP Masquerading, then prefer the single user Masquerading as that is a far more simple functionality. -- 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) and so will the application that initiated the dial on demand. A re-connect/reload, 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 off dial on demand 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. Dial on demand works, but it is on my observation list, so please keep a close eye on my pages if this is one of your key needs. ========================================================================== 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. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Script setup ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █ ┌ Script filename ──────────────────────────────────────────────────────┐ █ █ │ Script filename.: Belle_di.scr │ █ █ └───────────────────────────────────────────────────────────────────────┘ █ █ ┌ Learn options ────────────────────┐ Scripts will help you automating █ █ │ │ the host login process. █ █ │ [X] 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 ─────────┐ █ █ │ (o) 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: 0 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 aa 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 ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █ █ █ [ ] Trace ON/OFF █ █ [ ] Trace communication line █ █ [X] Trace PPP negotiation █ █ [X] Trace errors █ █ [X] Debug information █ █ [ ] Trace buffers █ █ █ █ [ ] Enable trace file █ █ ┌───────────┐ ┌───────────┐ ┌───────────┐ █ █ │ 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! When you are running in a stable environment, it is recommended to turn only errors and negotiation tracing on. The trace file is very useful if you see a problem that you need to report to the author. 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 █ █ │ Belle direct│ │ 20.12.1996 04:36:38 04:42:28 5 350 000:05:50 ▒ █ █ │ Ascend CPH │ │ 21.12.1996 15:02:05 02:23:44 681 40898 011:21:38 ▒ █ █ │ IBM │ │ 21.12.1996 11:02:37 15:43:25 280 16847 004:40:47 ▒ █ █ │ TeleDK │ │ 21.12.1996 18:55:12 19:05:39 10 627 000:10:27 ▒ █ █ │ TeleDK Roski│ │ 21.12.1996 19:09:46 23:42:18 272 16352 004:32:32 ▒ █ █ │ Vestnet │ │ 22.12.1996 00:25:46 03:47:30 201 12103 003:21:43 ▒ █ █ │ autostart te│ │ 22.12.1996 03:48:18 03:49:22 1 63 000:01:03 ▒ █ █ │ vest fast │ │ 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 681mins █ █ | this month.: 052:27:40 3147mins | this month: 011:21:38 681mins █ █ | today......: 003:53:09 233mins | today.....: 003:21:43 201mins █ █ █ █ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ ┌───────────────┐ █ █ │ 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 │ Belle direct│ │ Nov 1996 void void 1793 107605 029:53:25 ■ │ Ascend K¢ben│ │ Dec 1996 void void 69 4185 001:09:45 ▒ │ IBM │ │ ▒ │ TeleDK │ │ ▒ │ TeleDK Roski│ │ ▒ │ Vestnet │ │ ▒ │ autostart te│ │ ▒ │ vest fast │ │ ▒ │ │ │ ▒ │ │ │ └─────────────┘ └─────────────────────────────────────────────────────────┘ 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============== Control and view the Textmode Ticker by clicking on on the [Misc. opt] button on InJoy's opening screen, then click on the [Textmode Ticker (old)] button. The "Textmode ticker" has been obsoleted by a new graphical ticker, but functionality is still in this release. 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.246.131 giving you the selected kind █ █ of information. Receiving will █ █ run low priority in the background █ █ and use only very little CPU █ █ and bandwidth. █ █ ┌───────────┐ ┌───────────┐ *** IMPORTANT *** █ █ │ Save │ │ Cancel │ This line activity will put the █ █ └───────────┘ └───────────┘ idle timeout out of the game! █ █ Should the ticker be activated when connected. █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ 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 choice (and as this is being written it is also 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 timeout as long as the ticker fetches commercials, etc. Of course you could use the combination making 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========== Control and view the Graphical Ticker by clicking on the [Misc. opt] button on InJoy's opening screen, then click on the [Graphical tickers] button. 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. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ 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.246.131 giving you the selected kind █ █ of information. Receiving will █ █ run low priority in the background █ █ and use only very little CPU █ █ and bandwidth. █ █ ┌───────────┐ ┌───────────┐ *** IMPORTANT *** █ █ │ Save │ │ Cancel │ This line activity will put the █ █ └───────────┘ └───────────┘ idle timeout out of the game! █ █ Should the ticker be activated when connected. █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ 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 causes InJoy to not issue any 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. ========================================================================== A U T O S T A R T I N G M O D U L E S ===========================================Connecting Causes Starting===== Auto-starting modules is a feature that lets you automatically start TCP/IP application suite when the connection is established. You can specify programs for auto-starting per host as well as in general, for all hosts. Refer to host setup for host specific auto- starting and refer to miscellaneous options for global auto-starting. The list on the right part of the screen shows your current application suite. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Miscellaneous options ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █ ┌─────────┐ ┌[ Autostart list ]───────────────┐ █ █ Path and filename │ Add-> │ │ f:\pmmail15\pmmail\pmmail.exe █ █ └─────────┘ │ explore.cmd ■ █ █ Parameters ┌─────────┐ │ ▒ █ █ │Update-> │ │ ▒ █ █ Working directory └─────────┘ │ ▒ █ █ ┌─────────┐ │ ▒ █ █ [ ] Start minimized │ Remove │ │ ▒ █ █ [ ] Close at disconnect└─────────┘ │ ▒ █ █ [ ] Close at InJOY exit │ ▒ █ █ [ ] Don't start │ █ █ └■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒┘ █ █ ┌────────┐ ┌────────┐ █ █ │ Ok │ │ Cancel │ █ █ └────────┘ └────────┘ █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ Path, file name, parameters and working directory must be set up as with any other program object in OS/2. Below the program information you see flags which allows you to start the program minimized, close them at disconnect or close them when InJoy stops. If you for some reason do not want to start the program at all, just mark the "Don't start" check box. Starting programs minimized doesn't work for PM applications. This is an OS/2 limitation. ========================================================================== K I L L J O Y =======================================The Ultimate Ending================ KILLJOY.EXE is a small utility program that will allow you to kill InJoy from the command line. KILLJOY.EXE may be run without parameters causing InJoy to die instantly (and thereby drop the possible modem connection, hopefully.) or It can be run with the '-' parameter which causes it kill InJoy as soon as the modem connection is gone. Refer to the disconnect actions for other means to disconnect InJoy. _____ _____ (_____) (_____) _ ____ _ ___ _ _ | | | _ \ | |/ _ \| | | | _| |_| | | |___| | |_| | |_| | (_____)_| |_(____/ \___/ \__ | (____/ Copyright (c) 1996, Bjarne Jensen. All rights reserved.