Welcome to the Termite TCP Demo

If you have any questions please feel free to contact us at:

      Oregon Research
      16200 SW Pacific Hwy, Suite 162
      Tigard, OR 97224

      Phone: 503-620-4919 
      Fax: 503-624-2940 
      Technical Support: 503-968-9250
      E-Mail: orders@orres.com  info@orres.com
      WWW: www.orres.com/~orres

QuickStart
**********

This quick start assumes that you already have a PPP account 
with an Internet Service Provider(ISP) that supports PAP 
automated login and already know the following information:

*  Your ISP's phone number 
*  Your ISP's DNS IP address
*  Your User Name and Password

If your ISP does not support PAP, then a Login Script will need
to be recorderd.  The following constitutes the minimum steps to 
configure and use Termite TCP. 

*  Run Termite TCP from either WorkBench or the Shell. 
*  Open the Connection Settings window from the Settings menu. 
*  Enter the modem initialization string required for your modem
*  Enter your ISP's phone number in the ISP Phone Number gadget. 
*  Enter the name of your serial device driver and unit number in 
   the Device and Unit string gadgets if they are different from 
   serial.device unit 0. 
*  Select the handshaking mode you want to use. Note that you 
   cannot use RTS/CTS if you only have a seven line serial cable. 
*  Select Use. 

*  Open the NetworkSettings window from the Settings menu. 
*  Enter your ISP's DNS IP address in the Name Server (DNS) gadget. 
*  Enter your ISP's domain name in the Default Domain gadget. 
*  Select Use. 

*  Select PAP Username/Password from the Settings|Login menu
*  Enter your User Name and Password in the appropriate gadgets.
   It is important to note that user names and passwords ARE 
   case sensitive.  So BiGfIsH is not the same as BIGFISH
*  Select Use
*  Select Save Settings from the Settings menu. 

*  Click on Connect button from the Termite TCP main window. 
   Termite TCP will dial your ISP and automatically login. After 
   successful login the PPP driver and the TCP/IP stack will be 
   initialized. On successful initiation of network communications, 
   Termite TCP will display the message 
   
   Connected

   in the Termite TCP main window status gadget. 

*  You may now run any Termite TCP client software. AmiTCP clients 
   are only supported in the full version.
*  To end your Termite TCP session and terminate the network 
   driver click onthe Disconnect button. 

Using Termite TCP 
*****************

Your Internet Service Provider 
******************************

Before you can begin to use Termite TCP, you must have a dialup 
PPP account with an Internet Service Provider(ISP).  These accounts 
are available from a wide variety of commercial and non-commercial
sources. You should spend some time researching the different 
providers in your area before opening an account.

A good source for locating an ISP in your area is your local 
newspaper's business section or contacting your local Amiga user 
group(or any computer user group). The type of account that you 
acquire and the services provided are entirely up to you and should 
be based on your individual needs. The options generally include 
different amounts of connect time per month, different e-mailing 
options, and the amount of disk space on the ISP's machine that 
you are allowed to use. The more options you select, the more it 
will generally cost. You want to be sure that you are actually 
going to use a given level of service before you sign up. You can 
always upgrade you account if you find you need more features. 
However, you can't get money back for services you agree to but 
don't fully utilize. At a minimum your account must support PPP 
dialup access. Your ISP may call this a PPP account or an IP 
account.  You must ensure that it is for PPP access and not SLIP. 

When you obtain your account, you will need to obtain 
the following information from your ISP: 
*  Your account name 
*  Your account Password 
*  Your e-mail address ( usually AccountName@ISPdomainName)
*  Your ISP's phone number 
*  Your ISP's Domain Name Server (DNS) IP address
*  Your ISP's domain name 
*  Your net mask (usually 255.255.255.0) 
*  Any specific instructions or commands that you are required to 
   follow in order to connect to their system using PPP. Including 
   any recommended modem init string settings. 

Connection Settings
*******************

The Connection Settings Window has been broken into two windows 
with the minimum required information on the basic screen and 
addtional options accessed through the More button gadget.  

Init Command    This string instructs your modem how to talk to 
   and how to respond to your ISP's modem. Different modems support
   different features that can be turned on or off and therefore 
   there is no one init command that will work with all modems. 
   Also different modems use different commands to enable or 
   disable the same features. The Hayes command set used to be a 
   standard that all modems used for configuration. However, with 
   the development of new high speed modems with unique features, 
   you can no longer count on every modem supporting the same 
   features or every modem configuring the same features with the 
   same commands. In short, outside of the basic Hayes command set,
   there is noeffective standard. You will need to ask your ISP if 
   they have any recommended modem configuration or init string 
   commands that you should set. Your modem performance can be 
   significantly influenced by it's configuration. Please refer 
   to your Modem Owners Manual for more information on the 
   available commands for your modem.

   The following modem options, if available, should either be 
   explicitly specified in the Modem Init String gadget or active 
   in a stored configuration specified by ATZ or ATZ1 or factory 
   default configuration specified by AT&F1 or AT&F2. 

   E1    Tells the modem to echo typed characters 
   V1    Tells the modem to report in verbal codes 
   M1    Turns the modem speaker on 
   &C1   Enables Carrier detection, this option must be on for 
         Termite TCP's auto-reconnect feature to work. 
   &D2   This tells the modem to hang up when we close the 
         serial.device (hang up when DTR is dropped) 
   /N3   guarantees error correction, if available

   If you have your favorite modem setup stored, then you can enter: 

   ATZ or ATZ1 

   in the Modem Init String gadget to access these configurations.
   Factory defualt configurations are accessed using

   &F  commands.  

   Please refer to your Modem Owners Manual for more information 
   on the available commands for your modem. 
   
ISP Phone Number    This is the number that Termite TCP must dial 
   in order to connect with your Internet Service Provider. If you 
   want to make a direct serial connection, say to a machine 
   running Linix that has a PPP daemon running, then you can leave 
   the phone number blank. When you click on Connect from the 
   status window, you will be asked if you want to make a direct 
   connection. 

Serial Device     This is the name of the serial device you wish 
   to use. If you are using your Amiga's built in serial port, 
   Commodores standard driver is called serial.device. Some modem 
   vendors include their own drivers, and several third party 
   devices are available. Be aware that not all serial devices are 
   created equal, and some do not offer complete functionality or 
   compatibility. If you have your modem attached to a serial port 
   other than the built in serial port on your Amiga, then you must
   specify the serial device driver for the serial card you are 
   using. Your serial port card manufacturer will supply you with 
   the proper device name in their documentation. 

Unit  The unit refers to "what serial port do you want to use?" 
   If you are using your Amiga's built in serial port and 
   serial.device, then 0 means use the first available serial port. 
   If you are using a third party serial card, then follow the 
   manufacturers documentation for unit number. 

Baud  This is the speed at which the computer talks to the modem, 
   in bytes-per-second (bps). Note that this is different than the 
   speed of the connection between your modem and your ISP. The 
   baud rate you choose is dependent on your machine configuration.
   If you have an unaccelerated machine with no fast ram, then you 
   should use 19,200. If you have an accelerated machine with fast 
   ram, then you can probably set your baud rate to 38,400 or 
   possibly 57,600(see important note). 

   If you experience slower than expected performance at a 
   particular baud rate, then you should try switching to the 
   next lower baud rate or reducing the CPU loiad on the machine. 
   It is likely that your machine configuration is not fast enough 
   to handle that data rate along with all of the other things the 
   machine must do(screen io, disk io, TSR tasks, etc.).  

   The slowdown is a result of the machine falling behind in 
   reading the serial port resulting in data drop out. Data drop 
   out causes the PPP packet checksum to fail, which in turn causes 
   the PPP driver to issue a resend request. The host machine then 
   has to resend the data and your machine has to reprocess it. In 
   short, if you operate at a baud rate higher that your machine 
   capability, the machine is doing a lot more work than necessary 
   to get the data under the pretense of speed. You are much better 
   off using a lower baud rate with no serial errors requiring 
   data retransmittal. 

   VERY IMPORTANT NOTE ON BAUD RATE   You should not try to use a 
   baud rate of 57,600 unless you have a high speed serial card 
   and/or an extremely fast Amiga(68040 or 68060) and Fast Ram. 
   Very few Amiga's are capable of reliable operation at this rate. 

Handshaking       Handshaking, or flow control is how modems 
   prevent themselves from talking over each other. One modem 
   acknowledges it is ready to receive, and the other modem sends 
   until the first modem says it is no longer accepting data. None 
   means use no handshaking. Communications are generally very 
   reliable, but there is a possibility for error. You should 
   only use this option if: 
   *  Your modem does not support hardware handshaking(RTS/CTS) 
   *  Your serial cable does not have enough lines to support 
      hardware handshaking. If this is the case we highly recommend 
   that you purchase a serial cable capable of supporting hardware 
   flow control. 

   The first form of handshaking developed was known as Software 
   Flow Control or XON/XOFF. This uses to control characters sent 
   as data for flow control. One side sends an XOFF, and the other 
   side cannot send any more data until it is XONed once again. 
   This is an obsolete method of flow control that is slower and 
   more prone to errors than hardware handshaking. Hardware flow 
   control known as RTS/CTS handshaking is only available on high 
   speed modems. They use serial cabling with seven wires instead 
   of three, giving them more control over the communications 
   process. RTS (Ready To Send) and CTS (Clear To Send) are two 
   of these new control lines. If you have a high-speed modem and 
   appropriate cabling, use RTS/CTS handshaking. It is very 
   important that your modem uses the same flow control that you 
   specify here. This is accomplished with the modem's Init string. 
   Refer to your modem manual for the command to turn on your 
   chosen handshaking method. 

MTU   This option specifies the largest number of bytes to be 
   transfered  at once. MTU stands for Maximum Transfer Unit.  The 
   default size is 1500.   Some ISP's will request/require a MTU 
   other than 1500 and this value will be negotiated during login 
   with your ISP.  

   In general the default will yeild the best overall TCP 
   performance.   However, there are some circumstances, like an 
   interactive telnet session  where large numbers of small packets 
   are exchanged, where a smaller  MTU can result in better 
   performance.    

Verification Interval      This new option specifies the time 
   interval that TermiteTCP will test your  ISP connection.  
   After the specified number of minutes has elapsed, TermiteTCP 
   will test the connection.  If the connection has failed for 
   some reason(phone  line dropped, etc.), then TermiteTCP will 
   automatically redial the phone and reconnect to your ISP. 

Network Settings 
****************

Without correct network information, Termite TCP will not be able 
to connect you to the Internet.  Your ISP will provide you with 
all of this information when you sign up for an account. It is 
important to remember that the periods in IP addresses and net 
masks ARE important. 

Name Server (DNS) IP Address    This is your ISP's official
   numeric IP address in the Domain Name System(DNS).  It is a 
   set of four numbers separated by periods. Your ISP will give 
   you this number when you obtain your account. This Address MUST 
   be specified. 

Net Mask    This is your ISP's subnet mask for interpreting IP 
   addresses within it's IP network. It sounds complicated, and 
   well..., it is. However, it is nothing that you really need to 
   worry about(except that you need to get it right). For most ISP's 
   this will be 255.255.255.0 but be sure to confirm this.

Default Domain    This is the "human readable" domain name of your 
   ISP. This is usually expressed in the form of 

      InternetServiceProvider.com 

   Your ISP will provide you with this information. 

Email Address        This is the address that you will use for
   sending and receiving electronic mail. This is generally in the 
   form of 

      AccountName@InternetServiceProvider.com 

   Your ISP will provide you with this information. 

Selecting More Options displays the expanded Network Settings Window. 
   This allows access to additional Network settings. These options 
   are generally kept hidden because most users will never have to 
   enter any information into these additional gadgets. To return 
   to the basic Network Settings window select Fewer Options. It is 
   important to note that togging between the two window views 
   acts as an implicit Use on any changes to any options. So, if 
   you select More Options and edit the Local IP Address, then 
   selecting Fewer options accepts your edited value for the local 
   IP address as if you had selected Use. To cancel any edit 
   mistakes, you must select Cancel before switching window views. 

Local IP Address        Most modern ISPs issue accounts with 
   Dynamic IP Addresses. This means that your machine is not 
   "permanently" attached to the Internet and you get a different 
   IP address every time you call in and connect to the network. 
   Users with Dynamic IP Accounts MUST leave the Local IP address 
   as 0.0.0.0 A Local IP Address of 0.0.0.0 tells Termite TCP to 
   negotiate with your ISP for your IP address. This is part of 
   the standard PPP negotiation that occurs when you call your ISP. 

   Some people will accounts with a Static IP Address. This means 
   that your IP address never changes. Even if you have a Static IP 
   address, you usually can leave your Local IP Address as 0.0.0.0 
   and allow Termite TCP to negotiate your address with your ISP. 
   A very few ISPs issue Static IP accounts and have machines that 
   will not negotiate a local address. If you have difficulty 
   logging in and receive the message Local IP Address 0.0.0.0 in 
   the status window after a Network Login error, then you should 
   enter your Static IP address in the Local IP Address gadget. 

Remote IP Address       You will use this address even less than 
   the Local IP Address. This is used only if the remote machine 
   operated by your ISP will not do ANY address negotiation. This 
   will only occur in very old implementations or very high 
   security systems. If necessary, enter your ISP's IP Address in 
   the Remote IP Address gadget. Note this address is generally
   different then the Name Server DNS IP Address. 

   A few new PC based ISP's require the remote IP address be 
   something other than 0.0.0.0 at the start of the address 
   negotiation phase.  If the message in the status window says 
   LCP: Up and then proceeds to cycle through IPCP: CONFREQ and 
   IPCP: CONFREJ followed by a  Termite TCP message saying that 
   we were unable to negotiate with your host,  try setting the 
   remote IP address to something other than 0.0.0.0   
   (1.1.1.1 for example). 

Alternate DNS IP Address      This filed hold the IP address of an 
   alternate Name Server (DNS) machine. This is sometimes useful if 
   your primary Name Server is susceptible to occasional "downtime". 
   Without access to a Name Server, you cannot make connections in 
   by specifying domain names .i.e. you could not telnet to 
   teleport.com you would have to telnet to 192.108.254.64. Not the 
   kind of information everyone keeps handy. If this occurs to you, 
   ask your ISP for the IP address of an alternate Name Server. 

Login Settings
**************

PAP/CHAP User Authentication
****************************

Many systems offer(and some require) the use of automated user 
authentication protocols.  TermiteTCP offers support for 
PAP(User/Password Authentication Protocol also known as UPAP) and 
the less common CHAP(Crytographic Handshake Authentication Protocol).  

If available, you should use PAP because your logins will generally 
be faster using PAP than though a script based login.

To use PAP or CHAP, select the PAP Username/Password submenu option 
from the Settings|Login menu. If using PAP, then enter your user 
name and password in the PAP UserName and PAP/CHAP Password gadgets.  
CHAP only requires a password in the PAP/CHAP Password gadget.  For 
security, your password is obscured while you are typing, so 
please type carefully.  Also, remember that usernames and 
passwords are CaSe SeNsItIvE. Select Use to accept your entries.

To connect with PAP/CHAP all you need to do now is click on the 
Connect gadget of the status window.  

No login script is required when using PAP or CHAP (except 
possibly for a delay command after connect) and you do not have 
to execute the Record Login Script procedure.

Recording a Login Script 
************************

If your ISP does not support PAP or CHAP logins, then a Login 
Script will need to be generated.  You can manually edit the login 
script or use the Record Login Script feature to have Termite TCP 
do it for you.  Needless to say, letting the script writer do the 
work for you is the easiest and recommend option. If you make
a mistake you can always go back and edit the resulting login 
script in the script editor. 

Record Login Script    Based on the configuration information you 
   have entered, Termite TCP will: 
   *  Configure your modem based on your specified Init Command 
   *  Dial your ISP's phone number 
   *  Connect with your ISP's modem and initiate communication 

   If successful communication is established, then a Terminal 
   window will be opened. How you proceed from this point depends 
   on the login procedure requirements for the ISP you have chosen. 
   Most systems will display some system information followed by 
   the prompt login:. Some systems may require you to enter a 
   series of PPP commands or a keystroke to wakeup the system 
   before you are presented with the login: prompt. Your ISP will 
   inform you if you need to take any special action. 

   When you see the login: prompt, type in your account name 
   followed by the return key. You will see a password: prompt 
   asking you to enter your account password. Type in your account 
   password followed by the return key. After your Password has 
   been accepted by your ISP, it will start talking PPP to Termite 
   TCP.  The  words Packet mode enabled (or something similar) will 
   be displayed followed by a series of seemingly random characters. 
   This means that your system has agreed to talk to Termite TCP 
   in language of networks. The gibberish characters are your ISP 
   sending a configuration request packet to Termite TCP to attempt 
   to negotiate a common set of rules that will be followed. 

   The record login procedure is now complete. Close the terminal 
   window by clicking on the close window gadget in the upper left 
   corner of the window. Termite TCP will now hang up the modem, 
   close the window, and display the Edit Login Script window.   

Login Script Editor     This allows you to fine tune the information 
   recorded during your login and allows you to remove any typing 
   errors from the script.  Or you may also choose to enter your 
   login script by hand or you may want to review and change the 
   information.  After reviewing the script and making any changes 
   necessary , click on Use. 

   A login script consists of a series of Wait and Send 
   instructions. A Wait instruction tells Termite TCP to sit and 
   watch the serial port until the listed string is received. When 
   the listed string is received through the serial port, Termite 
   TCP continues to the next line of the login script. You 
   typically use Wait instructions to wait for strings like login: 
   and password: to be received. It is important to note that a 
   Wait instruction is case sensitive and only an exact match will 
   cause the script to continue executing. So waiting for Login: 
   is different than waiting for login: 

   A Send instruction tells Termite TCP to send the listed string 
   to the modem. You will typically use Send commands to send your 
   Account Name and Password. The carriage return you type to send 
   your account name or password is implied and you do not have to 
   explicitly enter it in the Send instruction. Special commands 
   recognized by the Send command are useful for ISP's that 
   require special characters to be sent to wake up the service. 

      CR This will cause a single carriage return to be sent. 
      CONTROL-C This will cause a the Control-C to be sent. 
      ESCAPE This will cause the Escape to be sent.  

   To change a line from a Wait to a Send(or vice versa), click on 
   the cycle gadget for that line. Termite TCP continues to Wait 
   for strings or Send strings until the first blank line in the 
   script is encountered. Presumably all of the actions necessary 
   to login have been executed before the first blank line and you 
   have successfully logged into to your Internet account. 

   Some ISPs are slow in responding to certain actions.  The 
   DELAY command is  prevents login script commands from executing 
   too quickly.  For instance,  many systems require a slight 
   delay after connection but before a wakeup character is sent.

   The argument is the number of seconds to delay before executing 
   the next  script command. A DELAY 0 command is automatically 
   generated as the first  line of the script when using the R
   ecord Login Script procedure. 

Save Settings 
*************

You have now completed all of the steps necessary to connect
and automatically log into your Internet account. It is important 
to save your settings so Termite TCP remembers them the next time 
you run TermiteTCP. 

The full version of Termite TCP supports saving mutliple 
configurations for those with more than one Internet account.


Connecting to your ISP 
**********************

Now that you have completed all of the steps necessary to connect 
and automatically log into your Internet account. To accomplish 
this, all you have to do is click on the Connect gadget in the main 
Termite TCP status window. After you click on Connect, you will see
the following messages displayed in the Termite TCP status window: 

*  Setting up modem... while sending the init string to the modem. 
*  Dialing... while dialing your ISP 
*  If your are running a login script you will see 
   Waiting for "string" will be displayed during the execution of 
   each Wait command contained in the login script. 
*  Starting Network Driver... while Termite TCP is initiating the 
   Network driver and negotiating with your ISP on the network 
   protocol options. 
*  Connected. is displayed when the network connection is 
   successfully established. 

You are now "on the Internet" and ready to use client software. 
You may abort the connection process at any time by clicking on the 
close window gadget of the Termite TCP status window. After you 
have successfully configured Termite TCP remember to use the Save 
Settings option of the Settings manu to have Termite TCP remember 
your connection, network, and Login script settings. 

The next time you run Termite TCP allyou have to do is click on 
the Connect button and you will automatically be connect to the 
Internet! Disconnecting from your ISP When you are finished with 
your Internet session you may disconnect from the network in one of
three ways: 

*  Selecting Disconnect from the Termite TCP status window will
   disconnect you from the network, but leave Termite TCP running. 
*  Closing the Termite TCP status window using the close window 
   gadget will disconnect you from the network and quit Termite TCP. 
*  And finally selecting Quit from the Termite TCP menu will 
   disconnect you from the network, close the status window and 
   exit the program. 

Status Window Close Window Gadget    serves several functions 
   depending on the current state of your network connection. 

   *  If you are not connected to the network, then the Connect 
      button will be enabled and the Disconnect button will be 
      disabled. In this case clicking the Close Window Gadget will
      quit the Termite TCP application. 

   *  If you are connected to the network, then the Connect button 
      will be disabled and the Disconnect button will be enabled. 
      In this case clicking the Close Window Gadget will disconnect 
      you from the network and quit the Termite TCP application. 

   *  If you are in the process of establishing a network 
      connection, then both the Connect and Disconnect buttons 
      will be disabled. In this case, clicking on the Close Window 
      Gadget will abort the network connection attempt and return 
      the program to a disconnected state. The Status window will 
      not be closed and the program will not terminate. This is 
      useful if it is obvious that something went wrong with the 
      network connection attempt and you do not feel like waiting 
      for Termite TCP connection timer to timeout normally. 
   
Other Menu Options      Two other menu options of interest are: 
   Selecting About from the Termite TCP menu will display 
   information about the authors. This is also where you should 
   look to find out the version number of the program should you 
   need technical support. Selecting Iconify from the Termite TCP 
   menu will "hide" the Termite TCP application by removing the 
   application menu and status window and replacing it with an i
   con that resides on your WorkBench. Double click on the icon 
   to restore the menu bar and status window. 

Tooltype support
****************

Tooltype support is included for specifying configuration 
information via tooltypes specified in the TermiteTCP program icon. 
To edit the tooltype settings, click on the TermiteTCP icon and 
select Information from the WorkBench Icon menu.

The following Tooltypes are currently recognized:

   AUTOCONNECT 
      TermiteTCP will automatically connect to your ISP when the 
      program is launched if this tooltype is set to TRUE.

   AUTOICONIFY 
      TermiteTCP will automatically iconify to your WorkBench
      after network connection if this tooltype is set to TRUE.

   NULLMODEM 
      If this tool type is set to TRUE, it will supresses the 
      warning message if you attempt to connect with no phone 
      number entered in the Connection settings.  This is useful 
      if you are intentionally making a direct serial connection 
      to a local host via the serial port.


TTCP Client Software 
********************

Client software is software that accomplishs a specific task by 
utilizing the features of Termite TCP to communicate with the 
Internet. After you have used Termite TCP to connect to the 
Internet, it simply waits until it is instructed to do something 
by a client program.  So in essence, Termite TCP is like a high 
performance race car and the client program is the driver. All 
client programs require Termite TCP to be active and connected to 
your ISP before they will access the Internet(sort of like putting 
gas in the car).

Clients for the three basic uses of the Internet are supplied as 
part of the standard Termite TCP package:

   Termite Mail for electronic mail transfer.
   Termite FTP for file transfer
   Termite Telnet for remote login 

AmiTCP Clients
**************

Generally client programs are compiled specifically for a 
particular TCP/IP implementation. One of the exceptional 
capabilities of Termite TCP is it's ability to be used by client 
programs compiled for a different TCP/IP. In particular most 
client programs written for AmiTCP Copyright 1994 AmiTCP/IP Group 
will operate perfectly running under Termite TCP. 

The AmiTCP compatibility support is only available in the 
full version of Termite TCP.
