******************************************************************************* In-Joy for OS/2 (draft version) _______________________________________________________________________________ Beta release 0.08 - June 18, 1996 Copyright (c) 1996, Bjarne Jensen All rights reserved. U S E R S G U I D E ******************************************************************************* T O P I C S I N C L U D E D I N T H I S U S E R G U I D E: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ o Starting InJoy o Where to enter key code o The InJoy screen layout o Creating a host o Host setup o PPP setup o Communication setup o PPP options o Script setup o Saving the host o Dialing o Hanging up o Tracing o Connection log o Info Ticker o General setup o Autostarting modules o Scripts o Killjoy =============================================================================== S T A R T I N G I N J O Y ^^^^^^^^^^^^^^^^^^^^^^^^^^ InJoy has proven to run most stable in an OS/2 window, but on most systems it shouldn't matter. The possible problems you might encounter running InJoy in a full screen are: - com port behaves strangely and sends you wierd characters after a while. This I have seen using the "SIO.SYS" driver. - Autostarting and autostopping modules might not work. However, most system don't seem to have a problem. Remember, these are problems reported by only a few people and it seems InJoy is running well on most systems even in a full screen. When InJoy comes up it may report that it "Could not open device", click on OK to proceed with initialisation. InJoy tries to open com2 default and if that port is not available on your system, then just specify another com port for your default host! =============================================================================== W H E R E T O E N T E R K E Y C O D E ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When you have received you key code, and wish to enter it in InJoy, you need to press: SHIFT-F10 (enter this on the main screen of InJoy) In this dialog you need to enter your name and your key code. Both name and key code must entered with great care. If you delete InJoy, you need to re-enter this information so keep it at a secure location! When you enter your name, it is very important that you enter it in the exact same case as you gave when your key was to be generated. The key is case sensitive as well, and must be entered in the same case as when you received it. =============================================================================== I N J O Y S C R E E N L A Y O U T ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ InJoy will slit up the screen in 6 parts: - The Terminal Mode Window used for Terminal Mode and also showing the received and sent bytes while dialing or while running a connect script. - Host listbox (and attached manipulation buttons) Contains your hosts, grouped together with some host manipulation buttons such as "Delete", "New", "Change". The "Dial" button also resides as part of this group! - Output window This window is used as a trace window. It will show you messages from InJoy and also trace lines, providing that trace is enabled. - CPS and Bar chart line This line will give you some info about your connection. The line shows (from left to right): * Characters sent on comm line since connect * Characters received on comm line since connect * CPS out * CPS in * Average CPS * Max CPS * CPS Bar The last three numbers are calculated as the addition of both transmitted and received characters. Notice that these numbers are what is actually sent and received on the line, so PPP encapsulation is included. The checkbox entirely on the right of this line can be used to turn this functionality on/off! - Other buttons Right below the host listbox you will find more buttons for the purpose of hanging up, going into miscellaneous options and finally for exiting InJoy. - Status line (bottom line) Shows some information about the current status of InJoy. This builds up to the following screen layout: Ûßßßßß In-JOY - Best way to the Internet. Copyright 1996, version 0.08 ßßßßÛ ÛÚÄ[ Terminal Mode ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú[ Host ]ÄÄÄÄÄÄÄÄ¿Û Û³ ³³ Default  ³Û Û³ ³³ P&T þ ³Û Û³ ³³ IBM ± ³Û Û³ ³³ Test ISP  ³Û Û³ ³³ ³Û Û³ ³³ [ Dial ] ³Û Û³ ³³ [ New ] ³Û Û³ ³³ [ Change ] ³Û Û³ ³³ [ Delete ] ³Û Û³ ³³ ³Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ ÛÚ[ Output Window ]ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³  [ Hang Up ] Û Û³ ± [Misc. opt.] Û Û³  [ Exit ] Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛLine usage monitoring...........................±±±±±±±±±±±±±±±±±±±±±± [X]Û ÛÜÜÜ HOST | COM3 | 115200bps N81 | Port: Ready | LEARNING OFF ÜÜÜÛ =============================================================================== C R E A T I N G A H O S T ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When you wish to set up an ISP (Internet Service Provider) also known as a NAS (Network Access Server), you should choose to create a new host. InJoy always provides you with a "default" host which you cannot delete. The default host is used by InJoy at startup, in order to have a default set of parameters. You should change the "default" host to make it match the default settings that you would like to use at startup. Most likely you would want to set up more hosts than just the "default" host, and accordingly you have the possibility to create new hosts by selecting the [New] button or pressing within the host listbox. Notice: When entering the host setup screens, you will constantly see small hints in the bottom of the screen. Read those hints and use them as a guidance for your input. The default host is also the container for the default parameters used when you wish to a new host! =============================================================================== H O S T S E T U P ^^^^^^^^^^^^^^^^^^^ When creating a new host, the first screen presented to you prompts you for a hostname, your userid and your password. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß Host setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û Configuration name... Û Û My PPP host...................................... Û Û User ID.... Û Û 200000000005........................... Û Û Password... Û Û ******................................. Û Û ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄ¿ Û Û ³ PPP ³ ³ SLIP ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ The hostname is the name you and InJoy uses to identify the set of parameters that this host defines (e.g. com port, phonenumber, etc). The userid and password fields should be filled in with the values you have received from from you ISP. The userid and password are then later used by the scripts or the PAP/CHAP authentication protocols. When you have filled in this information, you should proceed by pressing the button of your choice and thereby selecting your frame protocol (either PPP or SLIP). SLIP is not yet supported by InJoy. Refer to the InJoy FAQ for a description of the differences of PPP and SLIP! =============================================================================== P P P S E T U P ^^^^^^^^^^^^^^^^ When you have gone through the fields of the previous host setup screen and selected to run PPP as framing protocol, you will see this screen. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß PPP setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ IP address configuration ÄÄÄÄÄÄÄÄÄ¿ Ú Domain nameserver ÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Û Û³ Your IP address..: 0.0.0.0 ³ ³ Nameserver address: 194.182.11³Û Û³ Dest. IP address.: 0.0.0.0 ³ ³ Backup nameserver.: ³Û Û³ ³ ³ Your host name....: bjarne ³Û Û³ Netmask..........: 255.255.255.0 ³ ³ Domain name.......: via.com ³Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÛ Û [ ] Use VJ Compression ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û [X] Allow PAP/CHAP Authentication ³ Save ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Timeout.: 900 seconds (idle time) Û Û Timer...: 9999 minutes (max. conn. time) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³Save as default³ Û Û [ ] Auto connect ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Comm setup ³ ³ PPP options ³ ³Script setup ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Your IP address --------------- This is the IP address that your computer will have throughout your session. The value 0.0.0.0 means that InJoy should obtain this IP address from the server. 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 in case the server will not dynamically assign you one. Dest. IP address ---------------- This is the IP address of the server. This IP address is normally assigned by the PPP server, but in case that is not supported, specify the fixed IP address that you have received from your ISP here. Netmask ------- The netmask specifies what IP addresses that are supposed to go through your PPP0 interface. If you have not received a speciel Netmask from your ISP, then just leave it as is. Use VJ Compression ------------------ Enabling this option will make InJoy try to negotiate the use of VJ (Van Jacobsen) compression on the connection. Enabling VJ compression takes up some CPU and it is mostly recommended when you have a fast computer and a slow line. VJ compression will save you around 30 bytes per PPP packet. Allow PAP/CHAP Authentication ----------------------------- Setting this option will allow the server to prompt you for your userid and password. This is the most common way for authenticating yourself towards the host. PAP is a simple protocol that will send your userid and password in the clear, without encryption. The CHAP protocol is much more sophisticated, but in general it is the task of the server to choose which protocol to use, so you cannot decide, only hope. Timeout ------- This is the idle timer that specifies for how long the line would have to stay idle before InJoy will automatically disconnect. Notice that if the timeout value is bigger than one minute, you will hear/see a timeout warning (consiting of four beeps). If you regret the timeout, you can reset the timout by pressing ALT-R. Be careful when putting your thrust into this functionality. Many hosts periodically sends dummy data on the line in order to avoid such disconnects. To completely disable the timeout, specify a value of zero. Timer ----- This is the idle 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, so you can go to sleep without worrying about the TV setting fire during the night. As this can go wrong for Television, it can go wrong for InJoy as well. If InJoy has problems disconnecting there is nothing it can do except raising your phone bill! (InJoy has never started a fire) Notice that if the timer value is bigger than one minute, you will hear/see a timeout warning (consiting of four beeps). If you regret the timeout, you can extend the timer by a new period, pressing ALT-E. To completely disable the timer, specify a value of zero. Auto connect ------------ This flag indicates to InJoy that it should attempt to auto connect to this host at startup. Only one host definition can carry this flag, and setting it on one host automatically resets the flag on all other host definitions. Nameserver & Backup nameserver address -------------------------------------- The nameserver and backup nameserver are IP addresses of your preferred nameservers. The nameserver addresses are put into the resolv file in your %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 or Internet Access Kit. Your host name -------------- The host name is a bit tricky. It is set up in your config.sys file, and the host name you specify here is only used by the programs that are autostarted by InJoy. So really, if you need a speciel host name for some reason then set it up in your config.sys using the: set HOSTNAME=your_host_name Normally you can leave this field blank, as it is seldomly used. Domain name ----------- This is the domain in which you reside. 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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The communication screen enables you to specify the parameters for your communication line. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßß Communication setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ Call control ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ (o) Let In-JOY make the call ³ Û Û³ ( ) Use Terminal Mode ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÚ Port setup ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ Port setup...........: COM3  [X] Use hardware flow control ³ Û Û³ ³ Û Û³ Port speed...........: 57600  ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÚ Modem & Dialing ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿Ú Redial/Reconnect ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ Phone number.........: 87353008 ³³ [X] Redial ³ Û Û³ Backup phone number..: ³³ Attempts......: 20 ³ Û Û³ Modem initstring #1..: AT&F ³³ Pause between.: 2 sec(s) ³ Û Û³ Modem initstring #2..: AT&C1&D2 ³³ ³ Û Û³ Dialing prefix.......: ATDM ³³ [ ] Reconnect at conn. loss ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Most of this setup you already know from your other communication programs, so lets focus on the InJoy specific parameters: Call control ------------ In this paramter group you specify whether InJoy should make the call for you. If you choose to do so, InJoy will automatically initialise your modem and set up the call. Your job will be only to answer prompts after having dialed and maybe autogenerate a script. The other possibility is to use Terminal Mode, which will put you in charge of initialising your modem and set up the call. Even when running Terminal Mode, you can still generate scripts and autorun scripts. Phone number & backup phone number ---------------------------------- These are the phone numbers used if you choose to let InJoy make the call for you. The phone number are used in the following way: The primary phone number is used for number of times and if that fails, then the backup phone number is used for a number of times. Currently you cannot make InJoy call the numbers in a round robin fashion. Reconnect at conn. loss ------------------------ This option, if checked, will tell InJoy that it should reconnect if once connected and then the line drops due to some outside influence. =============================================================================== P P P O P T I O N S ^^^^^^^^^^^^^^^^^^^^ The PPP options screen has some options that will help you taylor the line to give you max. performance. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß PPP options ßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ ÛÚ Toggles ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Ú Miscellaneous ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û³ ³ ³ ³ Û Û³ [X] Force ACCM to 0 ³ ³ Restart timer..: 150 ³ Û Û³ [ ] FCS checking ³ ³ Max. tries.....: 5 ³ Û Û³ [X] Addr & Cntl field compression ³ ³ MRU............: 4096 ³ Û Û³ [X] Protocol compression ³ ³ Interface name.: PPP ³ Û Û³ [ ] Enable auto pinger ³ ³ Priority %.....: 80 ³ Û ÛÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Make fast ³ ³ Make slow ³ ³ Default ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Force ACCM to 0 --------------- ACCM - Asynchronous Control Character Map, is a table specifying which characters that must be sent 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 removing the use of the mask. Setting of this parameter will also make sure that InJoy will not exercise the default 0xffffffff mask towards the host. In general this is a very important parameter for line performance and normally there would be no side effects of having this parameter turned on. FCS checking ------------ Set this parameter to make InJoy check all incoming packets for a correct Format CheckSum (FCS). Checking will take up some perfomance (not much though) and in most cases there is no need, as the TCP protocol has the checksum as well. Addr & Cntl field compression ----------------------------- Each PPP packet includes a few bytes in the start that never hardly ever changes. Selecting this option will force compression of these bytes and save you a couple of bytes per PPP packet. There should be no side effects for turning on this option and the CPU load will not be effected from it. Protocol compression -------------------- Will compress the protocol information in the PPP packets from two to one byte. Why not save a byte where possible? Enabling this option will not take any additional CPU and it will save you a byte per packet. Auto pinger ----------- Not yet supported. Restart timer ------------- The PPP negotiation protocols needs a timer, telling when to resend protocol blocks in case of error. E.g. if you PAP/CHAP userid and password block is lost due to a bad connection, then the implementation needs to resend the PAP/CHAP protocol block after some time. The time is specified by this parameter and the lower value the better. This parameter can have a REAL BIG influence on the negotiation time, so try to fine tune this value to be as little as possible. Beware, this timer will only have effect on negotiation time, not on the actual throughput of the line. Max. tries ---------- Specifies how many times the PPP protocols blocks should be resend in case of bad or missing response. Values of 5-10 should be sufficient for most implementations. Maximum Receive Unit (MRU) -------------------------- The Maximum Receive Unit is the maximum number of bytes that we are capable of receiving in one PPP packet. The bigger the better (has a max of 4096), as the round trip delay of most connections are pretty slow. Notice: Many implentations will not allow the MRU value to be negotiated freely, but some does and that could improve line performance significantly. Interface name -------------- This is the symbolic name used a prefix for the PPP interface. Keeping the default value of "PPP" is a good choice and this parameter should only be changed if you have a very good reason. Priority -------- The priority parameter specifies the priority assigned to the InJoy dialer. This is a value that you can fine tune by hand, but you should be aware of the following: Any value bigger 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, but raising the value much above 75 percent may cause system hangs as the OS/2 sheduler will not allow other processes to wake up. =============================================================================== S C R I P T S E T U P ^^^^^^^^^^^^^^^^^^^^^^ The script setup is pretty simple, but there are a few things that 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 above options are self explained, so we will move on to look at what is not that obvious from the screen setup. Script filename --------------- Naming your script is simple, just be sure that you do not have two host that by accident reference the same file name. That is not illegal, but when doing new hosts that could easily happen as InJoy automatically generates a script based on the 8 first characters of your hosts configuration name. The above fact makes deleting/reseting a script just a bit more tricky. Scan for IP addresses --------------------- Not yet supported. Script language --------------- 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 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 out this example to see how the scripts can be used: DE: 2000 TX: \r RX: login: TX: [$USERID]\r RX: password: TX: [$PASSWORD]\r RX: annex TX: ppp\r RX: Interface going up\r\n 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 speciel InJoy meta variable that includes the userid you specified under the host setup. You should also notice that a similar meta variable for the password exist as well. It is perfectly legal to start the script using any command and it is also legal 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 need to start the script by waiting for something. If you had InJoy autogenerate a script for you the script file is saved when you press ESC to enter PPP packet mode. You can modify this file, if you need to, using a text editor. For example you may wish to streamline the script which In-Joy automatically created for you. Some hosts require you to login 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. Script delay ------------ The script delay is a timer specifying for how long InJoy should wait between the execution of each line in the script. Normally, as scripts waits for prompts after having sent something it is not dangerous to set this value very low, but as you know, sometimes you get into a situation where timing is crucial and then you know what to do. Often the dangerous situations occur when modems are not able to handle handle AT commands in a very fast sequence and that is even though having answered back with and "OK". Notice that this value must be specified in milliseconds. 1000 milliseconds equals one second! =============================================================================== S A V I N G Y O U R H O S T D E F I N I T I O N ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ After having filled in all the information for your host, you are returned to the PPP setup screen. On this screen you can 'save as default' and/or just 'save host'. Saving the host as default, gives you an easy possibility copy the host by just creating a new one right after having saved, only changing the fields that you think needs changing. Saving the host normally simply gives you a new host entry. =============================================================================== D I A L I N G ^^^^^^^^^^^^^ InJoy has been build to enable two kinds of dialing. The preferred mode of dialing is of course to do it automatically and let a script do the login process. InJoy dialing ------------- If you enable InJoy dialing (refer to communication setup), you should see InJoy initialising your modem and then dial. InJoy uses a special script for dialing, and that script has the following life cycle: - Try to initialise modem using init string 1 (if available) - Wait max. 45 secs on an OK answer - Try to initialise modem using init string 2 (if available) - Wait max. 45 secs on an OK answer - Try to dial the number (using primary phonenumber and dial prefix) - Wait max. 45 secs for one of the following: CONNECT,ERROR,NO DIAL TONE,NO DIALTONE,NO CARRIER,NO ANSWER,BUSY,FAIL,OK These are the basics of the connect script, but as you know, InJoy also supports redialing, re-connecting and auto-dial and how does 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 else than a CONNECT, Injoy will check the redial flag found under communnication setup. If redial is turned on, then InJoy will attempt to redial the primary phone number number of times. If there is still no connection after redialing the primary phone number, InJoy will switch to the backup phone number and retry the re-dial procedure using the backup phone number. The modem is not being reset between each redial attempt. As dialing and scripting is somewhat connected, you will find that the timer found at 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. Terminal Mode dialing --------------------- Doing your call using Terminal mode is very simple. As with any other program providing a Terminal Mode, you give your 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 already at the point of host selection (refer to script setup to see how that is done). If you do not feel like setting the autolearn script or if you feel like overwriting your script, you can use the ALT-L to start learning a new script. When learning a script you should follow the instructions on the screen! If you plan to be using a NULL-MODEM for running up against a host, you would find Terminal mode to be very useful as well. What is general for both types of dialing methods ------------------------------------------------- Regardless of how you choose to dial you have the possibilty of combining your dialing with the re-connect and auto-connect functionality. the re-connect hasn't got much to do with the dialing itself, it simply reselects 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 speciel host should be auto selected at startup Also, remember to check the InJoy FAQ for questions regarding dialing! =============================================================================== H A N G I N G U P ^^^^^^^^^^^^^^^^^^^ InJoy can disconnect you in one of two ways.. Either the obvious ALT-H (hangup button) which will drop DTR on the modem and thereby force CARRIER to drop. If you for some reason need to do a graceful PPP logoff you can press ALT-T to terminate your session. Maybe if you are having troubles using the regular hangup button, ALT-T could be a problem solver for you. After having hung up, InJoy will do a entry in the connection log for the appropriate host entry. Even if terminating InJoy using killjoy or using CTRL-BREAK, you should still get your entry in the connection log! =============================================================================== T R A C I N G ^^^^^^^^^^^^^ To trace and monitor line activity, use the trace functionality. The trace functionality can be found under miscellanous options and it includes the following possibilities. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß 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 ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ What you enable is typically what you see in the output screen of InJoy. To much tracing will slow down InJoy conciderably, and to little tracing 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. All tracing can be stored in the in-joy.trc file and that file is very useful if you see a problem that you need to report to programmer. Notice: The "Reset" button will delete you trace file! =============================================================================== C O N N E C T I O N L O G ^^^^^^^^^^^^^^^^^^^^^^^^^^^ The connection log is a monitor that will show you the connections you have had and the how long they have lasted. You can see the date, start time, end time, whole number of minutes and finally the total amount of seconds. Notice: The minutes describe the whole connection time, but so do the seconds. The number at the bottom of the screen is calculated from the seconds and due to rounding it might show a different value than you would expect by looking at the minutes per connection. Ûßßßßßßßßßßßßßßßßßßßßßß Connection logging monitor ßßßßßßßßßßßßßßßßßßßßßßÛ Û Û Û Ú[ Hosts ]ÄÄÄÄ¿ Ú[ Date Start End Mins Secs ]ÄÄÄÄÄÄÄÄ¿ Û Û ³ Default ³ ³ 26.05.1996 15:15:52 15:15:55 0 3 ³ Û Û ³ ³ ³ 26.05.1996 15:21:39 15:21:42 0 2 ³ Û Û ³ ³ ³ 02.06.1996 22:23:28 22:23:47 0 19 ³ Û Û ³ ³ ³ 02.06.1996 22:25:50 22:26:30 0 39 ³ Û Û ³ ³ ³ 02.06.1996 23:18:02 23:22:19 4 257 ³ Û Û ³ ³ ³ ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Total connection time 5 min(s) Û Û ÚÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Reset ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÙ Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ To reset your connection log, you simply choose the reset button. Currently InJoy will not sum up your monthly connection times, but that will be available in a later version. The connection log you see here can also be found as a file. To find the connection logs, look for files matching the pattern *.log. =============================================================================== I N F O T I C K E R ^^^^^^^^^^^^^^^^^^^^ The InJoy info ticker is a low priority background functionality that if enabled will connect to the IJ server and get the information that you have requested. The requested information may be: - commercials - announcements See The below screen setup to get an impression of what can currently be configured: Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßßß 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 guided to by the InJoy team. The default choice is probably the best choice and at least while this is being written also the only server available! There is a few things to have in concideration when enabling this option: - the idle timeout may be put out of the game - you might not receive any ticker info 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 IJ 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' is NOT a server that will register your name and license number or anything. Neither will InJoy scan your harddisk for pirate software or anything similar:-) =============================================================================== G E N E R A L S E T U P ^^^^^^^^^^^^^^^^^^^^^^^^ The general setup screen includes options for the general behaviour of InJoy. Ûßßßßßßßßßßßßßßßßßßßßßßßßßßßßß General setup ßßßßßßßßßßßßßßßßßßßßßßßßßßßßÛ Û [X] Show about box at startup? Û Û Û Û [ ] Confirm InJoy exit (when connected)? Û Û [ ] Confirm InJoy exit (when NOT connected)? Û Û [ ] Confirm hangup? Û Û [X] Confirm deleting scripts? Û Û [X] Confirm deleting hosts? Û Û [X] Confirm deleting 'autostart program' entries? Û Û Û Û ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÄÄÄÄÄÄ¿ Û Û ³ Ok ³ ³ Cancel ³ Û Û ÀÄÄÄÄÄÄÄÄÄÄÄÙ ÀÄÄÄÄÄÄÄÄÄÄÄÙ Û Û Show about box when starting InJoy..? Û ÛÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÜÛ Showabout box at startup ------------------------ With the 'Show about box at startup' option you can select whether the about box with register and contact information should be shown at startup. Selecting for InJoy to automatically connect at startup will override the use of this flag. Confirmation options -------------------- Use these flags to specify what actions you would like to confirm before being performed by InJoy! You should notice that regarding InJoy exit, the confirmation option here only has effect if you actually selected the [exit] button, i.e not not pressing the ESC button! =============================================================================== A U T O S T A R T I N G M O D U L E S ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Autostarting modules is a feature that InJoy provides in order to let you start your TCP/IP application suite when connection. 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 and filename, Parameters and Working directory must be set up as with any other program object in OS/2. Below the program information you see some flags that will allow 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, then you can "check" the Don't start checkbox. Starting programs minimized doesn't work for PM applications. This is an OS/2 limitation! =============================================================================== K I L L J O Y ^^^^^^^^^^^^^ Killjoy.exe is a small utility program that will allow you to kill InJoy from the command line. Killjoy.exe can be run without parameters, which will cause InJoy to die instantly (and thereby hopefully drop the possible modem connection) or It can be run with the '-' parameter that makes it kill InJoy as soon as a possible connection is gone. ***********************************