Enter 1998 December

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

/ Enter 1998 December / ENTER12_1.iso / os2 / Injoy / docs / userguid.txt < prev

Wrap

Text File | 1998-09-01 | 106.2 KB | 2,424 lines

. . . USERGUID.TXT . InJoy Release 2.0b . September 1, 1998 . . . . . . . . . . . . ___ _ . |_ _|_ __ | | ___ _ _ . | || '_ \ _ | |/ _ \| | | | . | || | | | |_| | (_) | |_| | . |___|_| |_|\___/ \___/ \__, | . |___/ . . . . . . . . . . . . . . . . . . . . . . . . . . The Best Way To The Internet . . . . . . . . . . . . . . . . F/X Communications . DK-4300 Holbaek . Denmark . E-mail: injoy@fx.dk . http://www.fx.dk . . . . . . . . . . . . . . . . Copyright (c) 1998, 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..................................Setup 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 Network Address Translation (NAT)................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 Good-bye o Tracing.......................................Capturing Tech Data o Connection log..........................Capturing Connection Data o Textmode Ticker...........................................Ticking 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 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. o When you return to the main InJoy screen the registration will proceed and after waiting a few seconds, you can press SHIFT-F10 to check if your registration info was accepted. o Restart InJoy! ========================================================================== 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. 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 function 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 1998 v2.x Build MMMYY ▀█ █┌─[ Terminal Mode ]──────────────────────────────────┐┌[ Host ]────────┐█ █│ ││ Default │█ █│ ││ TestOne ▒ │█ █│ ││ ■ │█ █│ ││ │█ █│ ││ │█ █│ ││ [ Dial ] │█ █│ ││ [ New ] │█ █│ ││ [ Change ] │█ █│ ││ [ Delete ] │█ █│ ││ │█ █└─[ F9: Start programs | F10: Stop programs ] ───────┘└────────────────┘█ █┌[ Output Window ]───────────────────────────────────┐ █ █│ [ Hang Up ] █ █│ ▒ █ █│ ▒ [Misc. opt.] █ █│ ■ █ █│ [ Exit ] █ █└■▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒┘ Connect Box [X]█ █ Line usage monitoring....................... [X]█ █▄ HOST <Default> | 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 <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... █ █ 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.123.12│█ █│ Dest. IP address.: 0.0.0.0 │ │ Backup nameserver.: 123.123.12│█ █│ │ │ Your host name....: whatever │█ █│ Netmask..........: 255.255.255.0 │ │ Domain name.......: your.com │█ █└───────────────────────────────────┘ └────────────────────────────────┘█ █ █ █ [ ] Auto connect ┌───────────────┐ █ █ │ Save │ █ █ [X] Firewall / NAT [... Firewall Setup] └───────────────┘ █ █ [X] Packet Filtering [... Filter Setup] █ █ ┌───────────────┐ █ █ Timeout.: 9000 secs. │Save as default│ █ █ Timer...: 9999 min. [... 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 "Firewall / NAT" and "Firewall Setup" 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 Destination 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 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 Firewall / NAT Refer to FIREWALL.TXT and the NAT section, below. o Packet Filtering Refer to FILTER.TXT. o Timeout This is the "idle timeout". It specifies for how long the line may remain idle (i.e. nothing being received) before InJoy will automatically disconnect the line. The timeout counter will not reset for outgoing only, traffic. 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 function 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 exist the RESOLV file. This is being worked on and new capability 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 [ ] Instant pkt mode if DCD=ON at dial time?│ █ █└─────────────────────────────────────────────────────────────────────┘ █ █┌ 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 good-bye 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 "Instant pkt mode if DCD=ON at dial time?" 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 Modem initstring #1 The default initialization strings in InJoy's distribution archive *MAY* work satisfactorily, but they are probably *NOT* the best for your system, or for your ISP. There are several sources for potentially better init strings. Your closest source is in the FAQ.TXT file shipped with this version of InJoy...look there *next*. 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. Expect trouble if the modem's initialization string (or modem default) for the S7 value is more 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' and disconnect. 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 connection 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 │ │ UI priority %..: 0 │ █ █│ [X] Protocol compression │ │ PPPFLAG timeout: 2000 msecs.│ █ █│ [ ] ECHO-REQ resets idle timeout │ │ │ █ █│ [ ] Use VJ Compression │ │ │ █ █│ │ │ │ █ █└────────────────────────────────────┘ └─────────────────────────────┘ █ █ █ █ █ █ █ █ █ █ ┌───────────┐ ┌───────────┐ ┌───────────┐ ╔═══════════╗ ┌───────────┐ █ █ │ 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 turn the PAP option OFF. o Allow CHAP Authentication (PPP Only) CHAP is an authentication protocol which does not pass your ID/password in the clear. With some ISPs 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 the response themselves. NOTE on multiple PPP negotiation protocols (i.e. using both PAP and CHAP at the same time). Some ISPs simply can NOT reliably negotiate a connection if multiple authentications are picked. If some PPP negotiations are successful but others fail for no apparent reason, ask your ISP exactly which one they use. Then use it and it alone. 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. "redmond\money" where "redmond" is a NT domain containing the user account "money". If a domain is not provided, the backslash should also be omitted, e.g. "money". 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.TXT 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 Address & Control 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 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 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..: 2000 │ █ █│ [X] Allow CHAP Authentication │ │ Max. tries.....: 20 │ █ █│ [ ] Allow MS-CHAP Authentication │ │ MTU............: 1500 │ █ █│ [X] Negotiate ACCM to 0 │ │ Interface name.: slip │ █ █│ [X] FCS checking │ │ Priority %.....: 70 │ █ █│ [X] Addr & Cntl field compression │ │ UI priority %..: 0 │ █ █│ [X] Protocol compression │ │ PPPFLAG timeout: 2000 ms │ █ █│ [ ] ECHO-REQ resets idle timeout │ │ │ █ █│ [ ] Use VJ Compression │ │ │ █ █│ │ │ │ █ █└────────────────────────────────────┘ └─────────────────────────────────┘ █ █ █ █ ┌───────────┐ ┌───────────┐ ┌───────────┐ ╔═══════════╗ ┌───────────┐ █ █ │ 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 communication threads. 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 UI Priority (Both PPP and SLIP) This option specifies the priority of the InJoy User Interface. Obviously, a user interface need not have the same priority as the more important communication threads, and accordingly, InJoy lets you assign an individual priority to just this thread. The UI Priority option has offered the customization to people in need of InJoy functioning in an environment where several applications (e.g. DOS applications) are fighting for the CPU cycles. Unless you find yourself in this category of users, then it is recommended that you keep the user interface priority at its default value of zero. Zero means keep the priority that OS/2 assigned to this thread - a.k.a. the default priority. 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. ========================================================================== N E T W O R K A D D R E S S T R A N S L A T I O N (NAT) =======================================Many Through One=================== NAT 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: NAT is not available in the InJoy Basic Client Version, whether registered or not. This function is only available in the InJoy Extended Client, InJoy SOHO Client and the InJoy Professional Server/Client version. These applications will run with InJoy's NAT implementation: - Netscape and WebExplorer (or any other web browser) - Any FTP client - Any mail client (PMMail, MR/2 ICE, etc) - News readers (Agent, NR/2, etc) - IRC (including DCC CHAT and DCC SEND) - Telnet - Gopher - Ping - Servers will run only on InJoy PC. Any other client running TCP or UDP protocol should be running. For servers on LAN clients, use The F/X Firewall Plugin with its Port Redirection feature. These applications will NOT run: - TRACERTE can't be translated, but it will work on the InJoy computer, provided that the following is marked as shown: [X] Disable NAT for InJoy PC - Programs not running TCP or UDP protocol - Will run on InJoy computer though. o NAT, General Information: With InJoy's NAT 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 NAT are presented in the file FAQ.TXT. Try them all to find the one that works best for you. Check our Web site (www.fx.dk) for more information, and, if you run into setup problems be sure to consult with the experts on the InJoy Mail List. o NAT options screen: █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Firewall Options ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█ █ ┌ Network Address Translation (NAT) ──────────────────────────────────────┐ █ █ │ │ █ █ │ [X] Network Address Translation [ ] Disable NAT for InJoy PC │ █ █ │ [ ] Disable NAT Ping support │ █ █ │ Translation port offset: 60000 │ █ █ │ │ █ █ └─────────────────────────────────────────────────────────────────────────┘ █ █ ┌ Firewall ───────────────────────────────────────────────────────────────┐ █ █ │ │ █ █ │ [X] F/X Firewall Firewall directory: .\firewall │ █ █ │ │ █ █ └─────────────────────────────────────────────────────────────────────────┘ █ █ This option will turn off NAT for the InJoy PC, providing transparent █ █ network access for the InJoy gateway computer. Particularly useful █ █ if you must run server applications or other applications that uses █ █ non-masqable proprietary protocols. █ █ █ █ █ █ ┌──────────┐ ┌──────────┐ █ █ │ Ok │ │ Cancel │ █ █ └──────────┘ └──────────┘ █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ The above screen defines the few options available for NAT. o Disable NAT for InJoy PC If you run tricky protocols that can't be translated or maybe even servers on your InJoy PC, then you should choose not to translate the InJoy PC and then use that PC for such purposes. The InJoy PC will then have transparent access to the Internet, just as if NAT wasn't enabled at all. Read the comment on the screen layout. o Translation port offset Specifies the offset used when translating 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. Translating these port numbers to a higher value in order to avoid conflict when not translating 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 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 F/X Firewall Please refer to the FIREWALL.TXT document and the on-screen guidelines. ========================================================================== 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 NAT LAN client 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", "SOHO Client" and the "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) │ │ [X] Instant DOD │ │ [X] Display DOD monitor │ │ [X] DOD interface is def. route│ │ Advanced DOD options: │ │ DOD interface: 111.222.111.0 │ │ DOD netmask..: 255.255.255.0 │ └───────────────────────────────────┘ o Instant DOD Specifies how InJoy should handle DOD once you select a HOST. If "Instant DOD" is enabled InJoy will proceed directly to the DOD state, where it waits for an outgoing packet before triggering an Internet connection. If "Instant DOD" is disabled InJoy will immediately establish an Internet connection once you select a host. When you hang up, InJoy will proceed to the DOD state. In the DOD state, InJoy will wait for an outgoing packet before triggering a new Internet connection. o Display DOD monitor When DOD is active and waiting to be triggered, an on-screen indication can be shown. The 'graphical' CPS monitor is used as the the visual tool, helping you not to leave this function unattended in a setup that could cost you money due to excessive calling. o DOD interface is default route This option helps you to specify which packets will trigger DOD. If the 'DOD' interface is the default route, then any outgoing packet will trigger DOD dialing. If the 'DOD' interface is NOT the default route, then only packets that are specifically routed to this interface will trigger DOD. In the usual setup, it is recommended to let the DOD interface be the default route. o DOD interface & netmask For the sake of DOD, a 'DOD' interface is created on your TCP/IP stack. The characteristics of this interface controls which packets will trigger DOD. The DOD interface is an advanced option that should only be changed if you know what you are doing. Otherwise stick with the default values. o Automatic DOD killers DOD is meant as a cost saving option and to keep it that way, InJoy will in fact disable DOD if dialing fails. Many people have wondered about this approach, but if you live in Europe or in other regions that charge you per call, then you'll appreciate this implementation from the first time your ISP is unavailable for a longer period. Without InJoy's ability to kill DOD you could otherwise risk that InJoy would do repeated dialing for e.g. a whole night (when you are sleeping). The phone-bill surprise you, but not amuse you. Of course, if you live in a region that doesn't charge per call, then you would want DOD to be active at all times. You can do this, just refer to these options found within the InJOy Communication Setup: ┌ Redial/Reconnect ────────────────┐ │ [X] Redial │ │ Attempts......: 9999 │ │ Pause between.: 5 sec(s) │ │ │ │ [X] Reconnect at conn. loss │ └──────────────────────────────────┘ Only when all the attempts specified above has failed, will DOD be disabled. 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 F6 key. To enable DOD for a host, you can use the function key F5 on the InJoy main screen. This requires the DOD to be enabled in the host settings. In case you have "Instant DOD" enabled and yet wish to have an immediate connection, then use the key SHIFT-F5 to trigger an immediate dial. Sometimes you will find it useful to go back and see what packet triggered DOD. You can do that. InJoy saves the offending packet to the file 'DOD.DMP'. This file maintains a format similar to that produced by the native OS/2 application IPTRACE. To get a nicely formatted dump of the DOD trigger packet, you must rename 'DOD.DMP' to 'IPTRACE.DMP' and then run IPFORMAT in the same directory. 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.: RING [x] Call this host │ │ Delay..........: 5 msecs. [ ] 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. Additionally, you may place the single word RING in the Trigger string block and InJoy will respond to your phone call. (Of course, it will also respond to ALL phone calls--so be system security conscious as you engage this feature.) ========================================================================== 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, we 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 IN: Put up an interactive box with default input, which allows 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! IN: StaticPart ; Will show a user input box ; with the "StaticPart" already ; entered on the input line. 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 (enabling "Let InJoy make the call" on the Communications setup page--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 capability? 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 When using either type of dialing, if InJoy is unable to open the port (for instance if the modem is in use by a fax or other comm program) it will return the message "Port open fail, retrying in 5 secs..." When the other program releases the modem, InJoy will dial. 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, do a text search for semaphore in the included FAQ.TXT file. ========================================================================== H A N G I N G U P ======================================Several Ways to Say Good-bye======== 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). Using the graceful logoff at any hangup attempt is also a toggle in the general setup. 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: ─────────────────────┐ █ █ │ [X] Important info │ │ [X] Trace file (IN-JOY.TRC) │ █ █ │ [ ] Trace communication line │ │ [X] InJoy output window │ █ █ │ [X] Trace PPP negotiation │ └─────────────────────────────────┘ █ █ │ [X] Trace errors │ █ █ │ [ ] Debug information │ ┌ IPtrace support: ───────────────┐ █ █ │ [ ] Trace buffers │ │ [X] Outgoing packets in IPTRACE │ █ █ │ [ ] Ticker │ │ [X] Incoming packets in IPTRACE │ █ █ └──────────────────────────────┘ └─────────────────────────────────┘ █ █ █ █ █ █ █ █ █ █ ┌───────────┐ ┌───────────┐ ┌───────────┐ █ █ │ Save │ │ Reset │ │ Cancel │ █ █ └───────────┘ └───────────┘ └───────────┘ █ █ █ █ Use this as a quick way to turn on/off tracing █ █ █ █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ 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. However, due to the sometimes LARGE trace files, please do not send them until asked for. 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 =======================================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] button. During a live connection the tickers may be turned off by pressing the F8 key, or turned on with the F7 key. 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 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 │█ █│[X] Hangup? ││[X] 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? ││[X] Disable all tunes? │█ █│[X] Allow 0.0.0.0 as GWY IP addr. ││[X] Error box at hangup fail? │█ █│[X] Disable timeout warning ││[X] COM port always open? │█ █│[X] Disable TIMER warning ││[X] COM port exclusive open? │█ █│[X] Primary interface (hostid) ││[X] Send Term. Req. at hangup? │█ █└──────────────────────────────────┘└──────────────────────────────────┘█ █ ┌───────────┐ ┌───────────┐ █ █ │ 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 gateway IP address. If enabled, will allow your ISP to the use of 0.0.0.0 as a gateway 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. - Primary interface (hostid) Hostid allows you to change the Primary IP Address of the system. Should be enabled in multi-homed environments! Also, check your OS/2 TCP/IP documentation for the hostid command. 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 received? 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 Second) to thousands of 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. - Send Termination Request at hangup Prior to hanging up (by dropping DTR), InJoy can send a PPP protocol block to let the other end know of our intention to hang up. Using this approach is recommended. ========================================================================== 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-explanatory 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============= To avoid creation of the default route when connecting InJoy, you will find the /D parameter useful - as below. in-joy /D 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 On F6 Turn Dial on Demand Off F9 Start Programs (as selected in Autostart dialog) F10 Stop Programs SHIFT-F5 Immediately cause Dial On Demand to dial SHIFT-F8 Display filter usage (statistics) SHIFT-F9 Dump NAT table of clients SHIFT-F10 Registration Screen ========================================================================== 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. SetJoy MUST be executed in the same directory as InJoy's executable (IN-JOY.EXE). That means if you are running SETJOY.EXE from a script or .CMD file the script MUST CD to the InJoy directory prior to calling or running SETJOY.EXE. 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.TXT for sign up details). USAGE: SETJOY [<option>] Where <option> is: /H, /h or /? - Display help /C - for use with specific auto-starting options, see details in the 'Auto-starting modules' section of this document. /D - Disconnect the current connection, immediately /O:<host name> - Changes, and saves the /T or /I setting for the named host. NOTE: The /O option (when used) must precede /T and /I /O:* - modify every host and save the setting (default) /O:# - modify the current host, and NOT save the change /T:nnn (or t) - Set the Idle Timeout from 0 to 999 seconds /I:nnn (or i) - Set the Timer from 0 to 999 minutes /P:passw. - Set the Password of host (use with /O param) /U:userid. - Set the Userid of host (use with /O param) /CONNECT - Connect InJoy (use with /O to cause a dial) NOTE: Setting zero for either the Idle Timeout or Timer turns that feature off. EXAMPLES: setjoy /O:* /T:999 Sets and saves Idle Timeout of all host to 999 seconds setjoy /I:120 Sets and saves Timer of all host to 120 minutes setjoy /O:# /T:90 Sets the current active host's Idle Timeout to 90 seconds, for this session only. setjoy /O:"TeleDK account" /T:30 Set and save the Idle Timeout of the host named <TeleDK account> to 30 seconds. NOTE the " around host names which include spaces. setjoy /O:Vestnet /I:0 /T:0 Turn off the Timer and Idle Timeout for the host named <Vestnet>, and save those settings. setjoy /O:Default /P:secret /U:me /CONNECT Causes InJoy to dial and connect to the <Default> host passing a user ID of "me" and a password of "secret" ========================================================================== K I L L J O Y =======================================The Ultimate Ending================ KillJoy 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.) 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) 1998 F/X Communications. All rights reserved.