
                   Internet Connection Extension (ICE).


     In  order to understand and be able to use I.C.E.  effectively it  is 
necessary to have a basic understanding of the Internet and the systems in 
it.  The  Internet  is a system for communication of  computers  that  was 
developed by the U.S.  military.  The American military knew that  warfare 
was getting far more technological,  with computer controlled systems  now 
supporting their defence systems. A team was set up to generate a computer 
communication  system  that couldn't be knocked out in time of  war.It  is 
ironic that the very government which created this beast is now trying  to 
control it and finding it almost impossible.

     The  name  Internet is also a very good analogy of the  system  on  a 
global  level  as the Internet is an international  network  of  computers 
connecting  to each other very like a net.  In this system data is  passed 
from  one  computer to another until a pathway connects the  start  &  end 
computers.

   A-----B-----C-----D-----E       This is the simplicity and the
   |     |     |     |     |       complexity of the network. It is a very
   F-----G-----H-----J-----K       simple set up but to stop data from
   |     |     |     |     |       passing from computer A to computer Z
   L-----M-----N-----O-----P       would require the isolation of either
   |     |     |     |     |       one but would be almost impossible to
   Q-----R-----S-----T-----U       stop between the the others. The number
   |     |     |     |     |       of possible pathways grows at an
   V-----W-----X-----Y-----Z       exponential rate; a simple 5 by 5 grid
                                   provides over a hundred possible routes
and the internet is thousands of times bigger.  The secondary problem  the 
military had to overcome was that after a pathway was secured eg.
A--B-G-H-N-O-T-Y--Z the data could be interrupted by blowing up computer N 
and this would require the computer to find another path and start  again. 
This  problem was cured by passing the data in little packets from A to  F 
and B simultaneously.  B would then pass it to C and G. F would pass it to 
L and G. G would ignore the packet the second time it received it. G would 
then pass it to H and M and so on. Even if N was blown up or unplugged the 
data would pass around N making sure the end computer got it.


                     The Five Parts and The Four Layers.


                             The Four layers

     As  this  network of computers had to be able to pass data  back  and 
forth  it  was necessary to develop a system of protocols  and  procedures 
which would allow any computer to talk to any other in the network through 
any of the others.

     These  protocols and procedures are the 4 layers of the internet  and 
they are the physical layer, the internet layer,  the transport layer  and 
finally the application layer.

     The physical layer

     The  physical  layer  is literally how you connect  to  and  talk  to 
another  computer.  This could be one of a dozen different  ways,  but  if 
you're reading this you have an Atari computer and I.C.E.  was written for 
an  Atari  and  a  modem.  As most people do  not  have  the  facility  of 
connecting directly into the internet and becoming connected to  multiples 
of  computers it is necessary to work through a computer which is part  of 
the internet.  This is what your service provider is doing.  They maintain 
the  links into the Internet and pass any information that you want on  to 
the Internet & back again.

     The oldest and most common interface for connecting your computer  to 
another  is  the  modem  and the  protocol  SLIP  (serial  line  interface 
protocol) which handles packets of data back and forth.  A newer and  more 
efficient system PPP (point to point protocol) is now gaining ground  over 
SLIP as the default standard.


     The internet layer

     This  is  the protocol that handles the little packets  being  passed 
back & forth and sending it on to the next computers in the network.  This 
is  the addressing level of any data and to be accessible by the  internet 
you  have  to  have your own IP (Internet Protocol)  Address.  This  is  4 
numbers separated by dots (full stops) eg.  158.152.1.65.  This address is 
how computers know whether to keep the packet or just to pass it  on.  The 
first two numbers are the host computer you wish to send to and the second 
two numbers are the person or unit you wish to speak to.  This combination 
allows 65535 possible computers each with 65535 people or units connected. 
This gives a theoretical limit of over 2 billion people at any one time.

     The transport layer

     The  transport  control protocol (TCP) handles the packaging  of  the 
data  to be transferred back and forth and controls the sequence  to  make 
sure  that it is built up correctly.  It also handles the opening  up  and 
closing down of communications between the two networked computers.

     The application layer

     It is all well and good passing data back and forth but what data and 
why do you want it.  The application layer is the level at which the  data 
is  meaningful.  The programs running on this level are the systems  which 
request & send data down through the other protocols to the other computer 
and back again. The applications for the internet are many and varied. But 
in general usage there are usually only 5 types.


                              The Five Parts

     As  the  5 major applications available on the Internet  are  totally 
independent  from  each  other  it is a useful  concept  in  breaking  the 
Internet into manageable,  definable parts.  These 5 parts are the  E-mail 
(electronic  mail)  systems,  the Usenet News  system,  the  F.T.P.  (file 
transfer  protocol),  the  Telnet system and finally the WWW  (world  wide 
web).

The E-mail Systems

     These are the programs which pass messages and letters back and forth 
between individual people and are generally not for public  viewing.  This 
does  not mean that they are in any way immoral or illegal but  would  you 
like  your letters to friends and relatives distributed  world  wide.  The 
addresses  for E-mails are very distinct and can be spotted easily.  In  a 
similar  way  to the IP addresses (see Internet layer) the  addresses  are 
separated by dots.  Just as in snail-mail ( the post system ) the  address 
is read backwards by computers until it homes in on the intended person.My 
e-mail address for example is:

dave@levihome.demon.co.uk 
     This could be re-written as 
designation@username.provider.type_of_provider.country_or_state
      The designation may be a number,nickname or pseudonym.

     The  username is a login code used by the service provider to  enable 
them to differentiate between accounts.  There can be only one account for 
each username.

     The  provider is generally the source provider itself.  It  could  be 
Compulink,CIX,Genie or so on.

     The  type_of_provider  is  a clue to the  business.  com  or  co  are 
companies.  edu  or  ac  are  academic  systems,  org  are  organisations. 
etcetera.

     The  country_or_state is a short form of classification to allow  for 
separation of providers with the same name.

     Although  these  are  the  general rules,as  in  life  they  are  not 
immutable.  A person's or company's e-mail address can be almost  anything 
but  the only rules are that it must contain an @ symbol in  it,  this  is 
what  separates the person from the place,  and that e-mail addresses  are 
case sensitive. Any mail sent to:

dave@lEViHOme.deMon.cO.uk

would not get to me.

The Usenet News Systems

     This is a form of e-mail but is sent to an open group on a particular 
subject  (newsgroup) and is for general release  worldwide.  Most  service 
providers store articles received from all around the world and hold  them 
for a 10 day period. Any person who wants to view them adds the subject to 
his newsgroups listing and requests them from his service  provider.  They 
are  then  downloaded  and  are  viewable  after  disconnection  from  the 
internet.  Any  articles for transmission to a newsgroup are  uploaded  to 
your  service provider and are distributed world wide for anybody else  to 
read.

     There are newsgroups on thousands of different subjects.

The File Transfer Protocol (FTP)

     The programs that run FTP are the access systems to other  computers' 
file storage systems.  This is the method by which you can download direct 
from another computer (generally not your service provider) and gain files 
of programs,  pictures, information etc.). With the Internet being totally 
open  to  anyone  in the world,  it would be  almost  impossible  to  find 
anything stored without guidance. Fortunately most files are stored by the 
subject and are generally available at specific computers.

For programs for the Atari ST/TT/Falcon the main storage sites are

atari.archive.umich.edu   (Held at Michigan State University)
micros.hensa.ac.uk        (Held at Lancaster University)

     Due  to  atari.archive.umich.edu  being  extremely  busy  access   is 
difficult so copies ('mirrors') are held at other locations such as:

sunsite.doc.ic.ac.uk     (Held at Imperial College) 
     As the FTP system allows access to other computers' internal  systems 
it  is necessary to logon to that computer.  The username &  password  for 
that FTP site dictates the access that you can have.  When you do not have 
a dedicated username & password for that site you can ask for guest status 
by using 'ftp' as the username and your e-mail address as the password. If 
that computer will allow access you will only have the ability to download 
files from certain areas and upload files into a particular area.

The Telnet System

     Back in the halcyon days of Tomorrow's World with Raymond Baxter  the 
computer  network system was a method to allow you to work on your  firm's 
computer , without ever leaving home. Although this never quite happened,
the Telnet system was created to do exactly that.

     Telnet  is a system which allows you to access programs running on  a 
totally different machine.  The Images normally shown on the host computer 
are passed via the Internet and are displayed on your computer. The inputs 
(keys,  mouse etc.) that you make are passed back and are entered  exactly 
as if you were there.  This system like FTP allows you access to  somebody 
else's  machine and generally requires a username & password  for  access. 
Certain programs written for the good of all are generally available  from 
your  service provider.  Due to the age of Telnet the  applications  which 
will run in it are character based e.g.  screens of text or at most a  few 
boxes and coloured blocks.

Telnet - International Relay Chat

     This  a  system which allows you access to a  subject  based  on-line 
communication  system.  Dozens of people receive messages you type as  you 
type  them and you receive theirs.  This can be extremely interesting  and 
will remove most of the isolation of working on your computer. If you have 
to pay for the phone call please remember you can get absorbed quickly and 
forget the time.

Telnet - Archie

     This  is a program which searches for a particular set of  data  e.g. 
filename  or subject or even words from all the files accessible and  will 
respond with the names of files and their locations which match the search 
criteria. Extremely useful for finding almost anything.

Telnet - Gopher

     After  Archie  has found your files Gopher will go and get  them  for 
you.


World Wide Web (WWW)

     The  previous  four  parts were written quite a  long  time  ago,  in 
computer terms,  and are totally separate from each other.  The World Wide 
Web  is their successor.  It is all four systems in one that  allows  full 
colour  and  graphic access to other computers,  the ability  to  download 
files, News and E-mail. Unfortunately there is a 'vicious circle'. The WWW 
system is a different protocol from the other four ( it had to be ). Until 
everyone has a fully working Web Browser and the computer sites &  systems 
they  access can handle the WWW it is necessary to keep the  other  4.  As 
long as there is demand for the other 4 protocols they will stay  separate 
which generates the demand due to lack of access with the WWW.


                                  I.C.E.


     ICE  is  an Internet access package written for the ATARI  ST/TT  and 
Falcon  computers using a modem and the protocols SLIP or  PPP.  The  main 
program controls are available from keyboard,  via a command line,  and  a 
mouse with windows,  dialogs & menus.  ICE uses standard system calls  for 
access  to  the  modem and is fully compatible with HSMODEM  or  any  BIOS 
linked communications update.  The modem speed selection of ICE is carried 
out using the modem cpx in the control panel prior to startup of ICE.

     Controls  for  the access to each part of the Internet  is  given  in 
menus at the top of the screen.  A brief description of functions and uses 
are  given below but the program's use should be intuitive and as  such  a 
lot of the menu entries are self explanatory.

     If the SYSOP ( main user ) of OASIS2 selects logon from the  Internet 
menu the options available under ICE's menus have a few extra features eg. 
debugging  functions  and  Listing functions for  NEWS.  All  options  are 
explained under the Function definitions listed below.

     This  document will provide general instructions & notes on the  uses 
of  ICE and the system of windows,  menus,  dialogs and command line  used 
throughout the program.

     ICE functionallity:

     Irrespective  of  use the menus,  windows & dialogs  function  in  an 
identical fashion to normal GEM based programs.  On top of this additional 
functionallity has been given by use of keys & mouse.

     The main menu bar also displays send & receive indicators similar  to 
the  modem and a clock which displays the time in minutes since the  phone 
connection was made.

     If  any messages or information is to be displayed in a window  which 
is  not  currently  open will automatically open that  window  and  return 
function to the currently active window.  Otherwise the window is  updated 
in the background.

     As  ICE  can be run under a multi-tasker such as  MagiC,  any  dialog 
which needs to be displayed must be in a window.  This method of operation 
provides an extra button ( the Close Box ) to each dialog.  To maintain  a 
convention all window close boxes are used as a cancel button.

     Due  to GEM only allowing the use of 7 windows at the same time  some 
functions,  such  as directories,  dialer and socket display use the  same 
window  so  unfortunately  it  is  currently  impossible  to  display  the 
directories of both the Atari and a remote computer simultaneously.

     The  program  uses  the  socket  principle  for  the  separation   of 
individual connections between your computer and other Internet functions. 
Sockets  provide the facility of viewing & controlling functions  such  as 
Usenet News and Mail separately.  Each internet function uses a socket, to 
connect to the outside world,  to issue commands or transfer data in  both 
directions.  The only exception is FTP which uses one socket for  commands 
and one socket for data transfer.  Ice is currently capable of handling up 
to  100  active sockets at any one time.  If any socket  is  deleted  that 
socket will become available for re-use by any application.

     Any  function key setups defined in ICE_NET will be available at  any 
time during the running of the program, this also includes editable fields 
in dialog boxes.

     Pressing SHIFT-TAB at any time will cycle through the windows topping 
the  next open window.  Clicking on a window which is not the  top  window 
will automatically top that window.  Please note that these functions  are 
disabled during dialogs,  and that any dialog must be answered before  any 
other window can be topped, or menu selected.

     ICE Window Displays:

  Dialer:
          The  dialer  window  displays  the  communication  between   the 
     computer  and  the modem whilst connection is made  to  your  service 
     provider.  Closing  the window or pressing escape,  whilst trying  to 
     connect,  will  disconnect  your modem and exit  the  dialer  window. 
     Aborting the dialer window when the program was called by OASIS2 will 
     exit ICE and return to OASIS2.
          Pressing  'space'  or  'Help'  whilst  trying  to  connect  will 
     disconnect  the  modem  and force the modem to  retry  the  telephone 
     number again.
          After connection any message sent by your service provider  will 
     be  displayed in the window and the window will remain on screen  for 
     approximately 10 seconds before closing automatically.

          If  ICE  was  run  independent of  OASIS2  then  the  dialer  is 
     available by selection of the 'Connect ICE' entry in the File Menu.

  Command Line:
          The command line window is displayed at the bottom of the screen 
     on  entry  into  the  program  (  unless  the  dialer  is   activated 
     automatically ). Any command is available at all times, except when a 
     dialog is displayed on screen. Any commands entered as a function key 
     setup  will work as if typed in at that point.       Twenty lines  of 
     history for commands is maintained by ICE allowing access by the  use 
     of the up & down arrows: Pressing Return/Enter after selecting a line 
     will  re-issue that command.  The line may also be edited  using  the 
     normal editing keys ( left & right arrow,  delete and backspace ) any 
     other  character  pressed  will be inserted  at  the  current  cursor 
     position.  Please not that the cursor is only visible if the  command 
     line is the top window.
                Pressing TAB when the command line window is top will  re-
     orient the command line to talk to an individual function (  although 
     currently  this  has no function - it will be able to  accept  direct 
     commands   for  transmission  to  remote  computers  overriding   ICE 
     autonomic functions ).
          All keyboard input will either be displayed in the command  line 
     or in a dialog.

  News Window:
          The  Usenet News window is where all information from  the  news 
     server  is  displayed.  This window is for information  only  and  no 
     commands can be issued to it. The display comprises of the connection 
     status whilst trying to access the news server. ( See USENET NEWS for 
     further function descriptions ).

  Mail Window:
          The Mail window is where all information from the mail server is 
     displayed. This window is for information only and no commands can be 
     issued to it.  The display comprises of the receipt or sending of  E-
     mails. ( See SMTP MAIL for further function descriptions ).

  FTP Window:
          The  FTP  window displays information about the  status  of  the 
     current  FTP  session  downloads.  ( See  FTP  for  further  function  
     descriptions ).  Pressing TAB whilst the FTP window is top will  swap 
     FTP sessions to the next ( if active ).

  Socket Window:
          The  socket  window  is  where the  status  of  active  Internet 
     connections is displayed. This window will display socket information 
     in  the following order:- Socket number,  the associated  application 
     using that socket,  the current status of that connection,  remote IP 
     address and TCP port and finally the local port on the Atari.  At the 
     base of the window the total number of bytes transmitted and received 
     by  ICE is displayed.  If full sockets is selected or TAB is  pressed 
     whilst  the  window is the top window additional information  of  the 
     number  of bytes received and transmitted by each connection will  be 
     displayed.

     Connection status:

     IDLE -         The socket has been reserved for use although there is 
                    no currently active connection.

     Listen -       The socket is waiting for a remote computer to request 
                    a connection.

     SYN Sent -     The  Atari has requested a connection and  is  waiting 
                    for acknowledgement from the remote computer.

     SYN Received - The Atari has received a request for a connection from 
                    a remote computer

     Established -  The connection between the Atari and a remote computer 
                    is now active a data transfer is possible.

     Finwait 1 -    The receiving computer has requested to close down the 
                    connection.

     Closewait -    The  sending computer has requested to close down  the 
                    connection.

     Closing -      Both  computers  have  requested  to  close  down  the 
                    connection simultaneously.

     Finwait 2 -    The  sending  computer has agreed  to  the  receiver's 
                    request to close down the connection.

     Last Ack -     The  receiving  computer has agreed to  the  sending's 
                    request to close down the connection.

     Timewait -     Both   computers  have  agreed  to  close   down   the 
                    connection.  The computer is now waiting for any other 
                    packets still active in the system.

          To  disconnect or remove a socket from the window highlight  the 
     selected socket by clicking on the line with the mouse and carry  out 
     one of the following:

          Select 'Remove Socket' from the file menu.
          Place  the  mouse  over the socket window and  click  the  right 
     button.
          Using  the  left button of the mouse re-select  the  highlighted 
     line.

          The above options will display a dialog asking whether you  wish 
     to disconnect or kill the socket.

          Disconnection of the socket will abort the connection and  reset 
          the  socket  to its default status.  The socket  will  reset  to 
          Listen or Idle if these are its default values otherwise it will 
          delete the socket.

          KIlling  the  socket will abort the connection  and  remove  the 
          socket from the active list.

          Clicking  on  the desktop or top or bottom lines of  the  socket 
     window will de-select the current socket line.

  Directory Windows:

          The directory window provides access to either the Atari's  disk 
     system  or the remote directory of the FTP site dependant on  whether 
     the Command Line window is in General or FTP mode.
          When displayed the directory window will appear in the top right 
     hand  side  of the screen and will display the directory as  the  top 
     line.  Below that all the directory entries are listed below as  text 
     with  a  marker  to  indicate a subdirectory or  a  link  to  another 
     directory.  Selecting  one of these entries twice will  request  that 
     that  subdirectory be displayed.  To reverse direction and display  a 
     previous  directory level click on the path at the top of the  window 
     on  the level required,  eg.  clicking on the 'micros' in a  path  of 
     /pub/micros/atari/tos will display the directory of  /pub/micros.  If 
     the  directory displayed is an FTP directory,  there may be  a  delay 
     whilst  the  FTP system downloads the requested  directory.  Any  FTP 
     directory downloaded is automatically cached.  If the cache  contains 
     the  directory  then  it will be displayed  from  the  cache  without 
     downloading from the FTP site.
          To  select  files in the directory click left  on  the  required 
     file. Clicking on a another file de-selects the previous file unless:

          If  the  SHIFT key is depressed whilst clicking on  a  file  any 
          previous files selected will remain selected as well.

          If  the  CONTROL  key is depressed all  file  between  the  file 
          previously  selected  and  the  one being  clicked  on  will  be 
          selected inclusive of the file being clicked on.

          If the ALTERNATE key is depressed all the files in the directory 
          will be selected.

          If  the  directory  window displays  your  Atari's  disk  system 
     selecting a file twice will display the file requested in the viewer.

          Clicking  on  the  desktop  will  automatically  de-select   any 
     highlighted directory entries.

          Clicking  with  the right button whilst the mouse  is  over  the 
     directory window with files highlighted will display a dialog  asking 
     whether you wish Delete, Upload/Download, or Rename the selected file 
     or  directory.  This dialog will also display the filename and  size.    
     Viewer:
          The viewer window is used for all miscellaneous output which can 
     be requested by the user.  ( see TIME,  QUOTE, FINGER and PING ). The 
     viewing window has a fixed size of 15 lines and can only be paged  up 
     & down using the window scroll arrows.
          The  viewer window is not directly connected to a socket and  as 
     such  does not clear itself after a connection has closed  down.  Any 
     printing  to this window will automatically page the window  down  as 
     necessary.  A maximum of 30 pages can be stored at any one time  with 
     the top page being replaced as required.


     Menus & functions.

          The  menu  options in ICE are under the following  headings  and 
     will be dealt with the function of each of these:

     ICE, File, News, Mail, FTP, Telnet, Functions and Prefs

  ICE:

     The  ICE  menu would normally allow access to  the  desk  accessories 
currently  loaded  but due to ICE running inconjunction with a  modem  and 
timing being a critical part of ICE's function it is necessary that  these 
accessories be disabled whilst ICE is running.

     About  ICE displays a dialog with information about the  authors  and 
          was really written for fun.


   File:

     The file menu gives control over connection & disconnection from  the 
Internet facilities and your service provider.

     Connect ICE  - calls up the dialer window for connecting  your  modem 
          to your service provider.

     Disconnect ICE  -  selecting this will abort any active  sockets  and 
          disconnects your modem from your service provider.

     Socket Commands - if a socket is highlighted in the socket window
          this menu  option will display a dialog asking whether you  want 
          to disconnect or kill the socket ( see SOCKET WINDOW ).

     MTask  Debug  -  [Sysop Only] this option  is  for  dire  emergencies 
          and  will  display the queue entries in  the  multi-tasker.  The 
          information  will be pretty meaningless and will slow  ICE  down 
          immensely - IT SHOULD ONLY BE USED AFTER INSTRUCTION FROM ONE OF 
          THE AUTHORS !!!!

     Packet Log - [ SYSOP Only ] this option will save all packets that
          are  transmitted or received into a file for  examination  after 
          problems are experienced.  The file of packets can become  large 
          fairly quickly. You have been warned!

     Quit  -  This option will exit ICE ensuring first that  all  Internet 
          connections are aborted and that the modem is disconnected  from 
          your service provider.


   News:

          All Usenet News functions are available from this menu. The news 
     system requires very little interaction from the user as it is mostly 
     automated.  Most  options are preset by OASIS2 except for some  SYSOP 
     functions listed below.
          ICE gives access for the downloading of full newsgroup  listings 
     and the downloading of headers.
          Please note that the censored newsgroups are displayed when  the 
     SYSOP uses ICE.

     The sequence for the Usenet News system is as follows:

          Logon.
          Download full listing of newsgroups [if selected - see below].
           or Download new newsgroups since last login.
          Download ID's for all new articles in active Newsgroups.
          Download headers and articles for active newsgroups
          Download selected articles for selected headers [ if any ]
          Upload new news articles [ if any ]

     Show News - this will open the news window or top it if already open.

     Change News Server - [ SYSOP Only ] This option will allow access  to 
          re-pointing the news system to look at a different  server.  The 
          dialog  for  change  server requires an IP  address  (in  number 
          format).  If the news system is currently active an error dialog 
          will be displayed.

     List Newsgroups  -  [ SYSOP Only ] this option if selected  prior  to 
          connection of the news system will request a full listing of all 
          active  newsgroups  maintained by that server to  be  downloaded 
          prior to loading any articles or headers.

     Newsgroup  Status - [ SYSOP Only ] this option allows for the  update 
          of  the  groups file to the latest articles when  the  newsgroup 
          server uses numeric listings rather than date.

     News Debug  -  [ SYSOP Only ] this option is a debugging  tool  which 
          when  activated will save all input & output of the News  system 
          to a log file. This is for debugging purposes and should be used 
          inconjunction with instructions from the authors.

     Automatic News  - this option will try to connect to the news  server 
          until the News is ready for download.

     Get  News  - this option will try one time per selection  to  try  to 
          connect to the news system.

     Disconnect News - this option will disconnect the news system if  for 
          any reason the user requires to.  The system will  automatically 
          shut down after news transfer has been completed.

 
   Mail: This menu provides access for all your E-mail systems.

     Show Mail - this will open the mail window or top it if already open.

     Change Mail Server - [ SYSOP Only ] This option will allow access  to 
          re-pointing the mail system to look at a different  server.  The 
          dialog  for  change  server requires an IP  address  (in  number 
          format).  If the mail system is currently active an error dialog 
          will be displayed.

     Mail Debug  -  [ SYSOP Only ] this option is a debugging  tool  which 
          when  activated will save all input & output of the Mail  system 
          to a log file. This is for debugging purposes and should be used 
          inconjunction with instructions from the authors.

     Logon  to POP3 - This option is used to access the POP3  mail  system 
          and  generates  a  form  for selecting  or  entering  POP3  Site 
          details.  From this dialog it is possible to access the database 
          of  POP3  Sites  held  or after selecting  one  the  ability  to 
          activate the login sequence.

     Automatic Mail  - this option will try to connect to the mail  server 
          until the connection is ready for upload of e-mails.

     Send  Mail  - this option will try one time per selection to  try  to 
          connect to the mail system for upload of e-mails.

     Disconnect Mail - this option will disconnect the mail system if  for 
          any reason the user requires to.  The system will  automatically 
          shut down after mail transfer has been completed. Warning ! this 
          may corrupt e-mails that are being received.


   FTP:

     Unlike  News or Mail the FTP system can have any number  of  sessions 
active at the same time (Registered version only) up to the maximum number 
of sockets.  Therefore the options selected (excluding Full FTP Display or 
FTP Debug ) are selected for the currently displayed session  only.  There 
is  normally  no display apart from the directories  and  the  downloading 
status window.

     Show FTP - this will open the FTP window or top it if already open.

     Open FTP - this option will display a dialog with field for entry  of 
          FTP site name,  Username, Password, Account & Default Directory. 
          If  the Anonymous button is selected then guest status is to  be 
          requested from the FTP site and as such there is no  requirement 
          for  Username,  Password  or  Account as these  fields  will  be 
          blanked.  The  passing of logon details for Anonymous logon  are 
          built into the program and does not require you to enter your e-
          mail  address  into  the form.  The  default  directory  is  the 
          directory  that  you wish the system to start  at  after  logon. 
          Pressing on 'Store' will save the current settings to a database 
          file.  Clicking  on 'Select' will change to a form in which  you 
          can select the FTP site that you wish to connect to. Clicking on 
          OK  will return you to the 'LOGON' dialog  with the details  for 
          the selected site filled in.  Clicking on 'logon' will  activate 
          the FTP system to connect to the requested site.  The FTP window 
          will be update to show this new session as the current session.

     Swap  FTP  - this option will swap to the next FTP session (  if  any 
          exists ).

     FTP Debug  -  [ SYSOP Only ] this option is a  debugging  tool  which 
          when  activated will save all input & output of the  FTP  system 
          to a log file. This is for debugging purposes and should be used 
          inconjunction with instructions from the authors.

     ASCII  Transfer  - [default] the downloading of ASCII data is  a  lot 
          faster  than the downloading of binary data.  Clicking  on  this 
          will  request  that  the current FTP session  transfer  data  as 
          ASCII.  When  the remote FTP site has agreed then a  check  mark 
          will appear by this menu option.

     Binary Transfer - When downloading files of data other than  straight 
          ASCII text it is necessary to change to binary transfer or  data 
          will be corrupt or lost.  Clicking on this will request that the 
          current FTP session transfer data as binary. When the remote FTP 
          site  has  agreed  then a check mark will appear  by  this  menu 
          option.

     Automatic Download & Upload options are currently disabled.

     Disconnect FTP - this option will disconnect the current FTP  session 
          when the user decides to.


     Telnet:  This menu provides access to the forthcoming Telnet system - 
          currently under construction.


   Functions:  This menu allows for useful routines that generally  assist 
     in the maintenance of the system or allows for system level control.

     Show Directory  -  If  the command line is in  General  mode  then  a 
          directory  of your hard disk is displayed.  If the Command  Line 
          window  is in FTP mode then a directory of the FTP site will  be 
          displayed.( see Directory Window for functions )

     Show Viewer  - this will open the viewer window or top it if  already 
          open.

     Show Sockets - this will open the socket window or top it if  already 
          open.

     Get Quote - This has been added for fun! There is a system for 'Quote 
          of the Day'.  Clicking on this entry will display a dialog where 
          an  Internet name or an IP address can be entered.  Pressing  OK 
          will request the 'Quote of the Day' from that site.

     Get  Time  -  In order to have Internet functioning  properly  it  is 
          necessary  to  have one time across the  complete  network  this 
          time is GMT. When this option is selected ( normally automatic ) 
          the  computer will request the time from your  service  provider 
          and will set the internal clock to that time.

     Lookup Address - To convert an Internet name in to and IP address  it 
          is necessary to carry out an IP lookup.  Clicking on this option 
          will  display  a dialog box for typing an  Internet  name  into. 
          Clicking on OK will activate the lookup system.  Response  times 
          vary but usually within 5 seconds the Viewer window will display 
          the IP address relating to the Internet name listed.

     Finger Address - To gain status information or other information from 
          a  computer the command is to finger them and they will  respond 
          with some information.  This description is poor as the uses  of 
          finger    is   varied   but   one   example   is    to    finger 
          dave@levihome.demon.co.uk the answer returned will state whether 
          I am currently online. Similar to the Lookup system a dialog box 
          will  be displayed requesting an address.  this address  can  be 
          either  an Internet name or an IP address.  Clicking on OK  will 
          return the answer in the viewer window

     Ping Address - To find out how long it takes to transmit a message to 
          a remote computer the command is to PING them. Like the previous 
          2  systems  Ping  will display a dialog  box will  be  displayed 
          requesting  an address.  this address can be either an  Internet 
          name  or an IP address.  Clicking on OK will return the time  in 
          milli-seconds  in  the viewer window.  Some time useful  to  re-
          activate  a  socket  where  the  remote  computer  has   stopped 
          communicating.

     FTP/Host  Directory  -  As the Atari is limited to  a  maximum  of  7 
          windows  under Gem/Tos several functions must be carried in  one 
          window.  In  order to allow for access to your host  hard  drive 
          whilst  connected to an FTP site or vice-versa this menu  option 
          will swap the directory function between them.  Please Note  the 
          wording  may vary dependant on which you are looking at  at  the 
          current moment.

     View  File  - This menu option will be selectable if a file  on  your 
          hard  drive has been highlighted in the host  directory  window. 
          Clicking  on  View File will display the files contents  in  the 
          viewer window.  This facility is limited to 30 pages of text  of 
          15 lines each.

   Prefs: Access to personal preferences and display options.

     Display Prefs - this allows the OASIS 2 window background and text 
          colours to be set. Also, if you have NVDI 3 or above or Speedo 
          GDOS installed you can select the font to be used for all window 
          text. To change the background colour click on the paper icon, 
          to change the text colour click on the pen icon. The colours 
          will cycle through the colours available (up to 16) in your 
          screen resolution. The sample box in the centre of the dialog 
          will give you an idea of what your windows will look like.

          To change the font use the two arrows either side of the font 
          name at the top of the dialog. The font name will cycle through 
          the list of available fonts. a sample of the font will not be 
          shown in the dialog.

     Save Setup - This menu option will save the current window positions 
          to allow you to customise Ice to your personal tastes.

     FTP Prefs - This option is currently unavailable in ICE. ICE_NET 
          covers part of these preferences available.

     Full News Display - [ SYSOP Only ] As the News system is mostly 
          automatic the displayed information is minimal. This option when 
          selected will increase the information displayed.This 
          Information is also available by keeping News the top window.

     Full Mail Display - [SYSOP Only ] - currently no active effect

     Full FTP Display - This option will toggle full display. All input 
          & output of the FTP system will be displayed in the 
          Viewer excluding download information which will be displayed in 
          the FTP window.

     Full Telnet Display - This option is to allow for further control of 
          the Telnet system currently being written.

     Full Sockets - This toggle switch will turn the sockets window 
          display to full or partial display. ( See Socket Window )


                             The Command Line

     The command line gives access to ICE's facilities  by keyboard input.
Most entries in the menus will generate the corresponding commands so that 
the history of commands is accurately maintained.

     The command line is supplied for command line junkies incapable of 
using a mouse and as such contains the major functions as supplied with 
NOS. the only exception is that commands work by quoting the window or 
function you want by name rather than protocol. So it is kick news not 
nntp kick, kick mail not smtp kick.

     Menu options or selections will insert the command into the command 
line window as if it had been typed.

     Although the program does not care whether the command is typed in 
lower or upper case care must be taken when typing logical names as the 
Internet uses names that are case sensitive.

     Commands available are:

     Close - mail,news,viewer etc. Equivalent to clicking on the close box 
          of each window. (short form of command is cl)

     Debug - This option provides keyboard access to the debug facilities 
          as listed in the menus.

     Dir - This command will open a window containing the directory of the 
          current path stored ( Starting as the root of the OASIS2 Drive )
          Refer to the directory window description for details.

     Disconnect - This command will disconnect a socket which is quoted by 
          number after the command eg. Disconnect 4. This command is 
          equivalent to using a right click on a selected socket in the 
          Socket window. (short form of command is dis)

     Exit - This option closes down the online sessions and disconnects 
          the modem if online and exits ICE. Equivalent to selecting quit 
          from the File menu.

     Finger - This command allows for access to the finger system by one 
          of two methods. Typing a command of just finger will activate 
          the dialogs to allow for further definition. Finger followed by 
          either a numeric IP address  or logical name will access the 
          system directly. EG. Finger status@gate.demon.co.uk. (The short 
          form of command is fi).

     FTP - This command allows for access to the ftp system by one of two 
          methods. Typing a command of just ftp will activate the database 
          dialogs to allow for further definition. FTP followed by either 
          a numeric IP address  or logical name will access the system 
          directly. EG. ftp micros.hensa.ac.uk.

     Hide - This command followed by the window name will move that window 
          off the screen allowing for update by the system without 
          cluttering up the screen. Equivalent to the MagiC command of 
          HIDE. ( short form of command is hi)

     Kick - This command followed by mail, news or time will activate the 
          high level systems into operation. Note: Kick mail will only 
          activate for sending mail, To receive mail your service provider 
          must connect to you. (short form of command ki)

     Kill - this command will disconnect and delete any socket connection 
          which is quoted by number after the command. eg. Kill 3. Please 
          note that if you kill the mail, quote or FTP listener sockets 
          they can only be re-activated by quitting and re-running ICE. 
          Killing the DNS server will severely impair the operation of the 
          current session of ICE.

     Lookup - this command allows access to your service provider's Domain 
          Name Server (DNS). The command lookup ftp.demon.co.uk will 
          display the IP address and the correct name in the viewer 
          window. As the DNS system will only reply with known addresses, 
          no answer will be given for an unknown name. (Short form of this 
          command is lu)

     Open - This command when followed by mail, news,viewer etc will 
          display that window on the screen. This command has the same 
          effect as selecting the open or show options from the various 
          system menus. ( short form of command is op)

     Ping - This command allows for access to the ping system by one 
          of two methods. Typing a command of just ping will activate the 
          dialogs to allow for further definition. Ping followed by either 
          a numeric IP address  or logical name will access the system 
          directly. EG. Ping news.demon.co.uk

          The purpose of this command is to provide the time delay between 
          your computer and the computer specified by number or name.

          As a benefit of this connection you can determine whether or not 
          a particular is currently connected to the Internet.

     POP3 - This command is identical to the selection of 'Logon to POP3' 
          from the mail menu. A database dialog will appear ready for 
          details of the POP3 site you wish to connect to.

     PPP - This commend followed by UP,DOWN,OPEN or CLOSE allows for user 
          access to the PPP System (when active). PPP down followed by PPP 
          close is equivalent to selecting 'Disconnect ICE' from the File 
          menu. It is unlikely that this command will be required or used 
          but is supplied for completeness.

     Quote - This command allows for access to the quote-of the day system 
          by one of two methods. Typing a command of just quote will 
          activate the dialogs to allow for further definition. Quote 
          followed by either a numeric IP address  or logical name will 
          access the system directly. EG. Quote microsoft.com. This 
          facility is not commonly used but is supplied as some service 
          providers do run this system for interest.

     Show - This command when followed by mail, news etc. will open the 
          window and display it on the screen irrespective of whether it 
          has never been opened before or hidden. (short form of command 
          is sh)

     Socket - This command displays and updates the Socket window for 
          system level access to ICE. (short form of command is so)

      View - This command when followed by a filename or path\filename will 
          display the file in the viewer window exactly the same as the 
          menu option 'View File'. Please note this facility will only 
          display files from your own computer system. To display a file 
          from an FTP site it is necessary to download it first.

I hope you enjoy using ICE and believe as I do that there is little 
further in useabillity that is obtainable for the Internet. But if you do 
have suggestions or requests please make them known to me and I'll see 
what I can do..

For any comments, suggestions, or bug reports please write to

     dave@levihome.demon.co.uk

     Many thanks for using OASIS2/ICE.

     David Levi

