
     Contents

     Section 1           Introduction

     Section 2           General Options

     Section 3           Defining Accounts

     Section 4           Account Details

     Section 5           Problem Solving


     
     Section 1 Introduction

     ICE_NET is a simple means of configuring ICE and OASIS 2 for your 
Internet Account. In fact OASIS 2 and ICE can be configured for upto 10 
separate Accounts. 
     You can of course edit the iCE.NET file manually with an text editor, 
but ICE_NET makes everything much easier.

     The ICE_NET program should only be run from inside the OASIS 2 
folder, the easiest way to do this is to run it from the OASIS 2 Toolbox.

     When you run ICE_NET it will first read in the OASIS.OPT file, any 
scaleable fonts available and finally the ICE.NET file. the main dialog 
then appears. any changes you make in this section are saved immediately 
in the Option or FTP files.

     There are two main areas to this dialog, the top section deals with 
the OASIS and ICE preferences, the Display options, the General Account 
details and the FTP sites database. The lower section deals with the 
specific Account details. This lets you add and delete Accounts, set the 
modem commands, dial script, function keys, Account details and the 
various News and Mail settings etc.
   
     When you have finished configuring your OASIS and ICE setups click on 
Save and the ICE.NET file will be saved. clicking on Exit will quit the 
iCE_NET program without saving any changes you have made to the ICE.NEt 
information.

     Many of the dialogs in ICE_NET contain a Help and Undo button. The 
Help button brings up a dialog showing brief descriptions for each area of 
the dialog. The Undo button resets the contents of the dialog back to the 
values in the ICE.NET file.

                --------==========<<<>>>==========--------

     Section 2 General Options

     Lets deal with the top section of the main dialog first. This 
contains five options that setup the way OASIS 2 and ICE work. The options 
you set here apply no matter which Internet Account you choose to use 
inside OASIS or logon to with ICE.

     Section 2.1 OASIS Options.

     This allows the OASIS 2 default options and the Sysop password to be 
changed.  This dialog is identical to the Preferences dialog within OASIS 
2. 
     There are three main areas to the Preference dialog, one each for 
General, Daily Net and Post Box.


     The General items cover the settings that have an effect on the whole 
of OASIS 2. These options are:-

     Desktop: This allows the OASIS 2 Desktop to be turned on or off. This 
only takes effect from the next time you run OASIS 2.

     UK Date: This allows the date format to be set to DD/MM/YY as used in 
the UK or MM/DD/YY as used in Europe and America.

     Fonts: This tells OASIS 2 whether you want to use scaleable fonts or 
not.


     The Daily Net items cover options that only effect the way the Daily 
Net windows operate. These options are:-

     All Items: This tells the news reader whether you want to read only 
the articles you have not read before, or all articles regardless of 
whether you have read them previously or not.

     Local Post: This tells OASIS to upload your News articles, but not to 
download them as they will be automatically added to the News database. 
The article will only appear in the News group the next time you Unbatch 
news. This makes the article appear to have been downloaded with all the 
other News articles.

     Auto Unbatch: This tells OASIS 2 to automatically Unbatch any News 
articles you have downloaded as soon as you exit ICE and OASIS 2 is 
started again. If this option is left off you will have to select Unbatch 
News from the Internet Menu.

     Bell: This option allows you to turn on or off the bell that sounds 
when you reach the end of a News thread.


     The Post Box items cover options that only effect the way the Post 
Box windows operate. These options are:-

     Directory: This tells OASIS 2 to automatically add any E-Mail 
addresses to your Yellow Pages from new E-Mails that you receive.

     Show MIME: This tells the OASIS 2 to automatically switch to the MIME 
Post Box if you try to read a MIME E-Mail.

     The final item in the Preferences dialog is the Password button. This 
allows you to set the Sysop password. If you already have a password set 
you must enter this before you are asked for a new password. If you do not 
already have a password set you will just be asked for a new password.

                             ----------------

     Section 2.2 ICE Options

     The ICE preferences dialog appears allowing you to set four options 
for Full information in four of the ICE windows. These are News, Mail, FTP 
and Sockets. The Full display shows more detailed information than normal.
     The News option tells ICE to show the status of each article it 
downloads, rather than just which News group it is currently downloading 
articles for.
     The Mail option tells ICE to show who outgoing mails are being sent to 
and who incoming mails are from.
     The Sockets tells ICE to show the transmit and receive data figures 
for each socket rather that just the total transmit and receive figure at 
the bottom of the window.
     The FTP option tells ICE to show all FTP commands and messages in the 
Viewer rather than just the FTP status in the FTP window.

                             ----------------

     Section 2.3 Display

    This allows the OASIS 2 and ICE 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 (upto 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.
                             ----------------

     Section 2.4 POP3 Account

     This dialog allows you to enter the details of any POP3 Mail accounts 
you have. There are fields for Name, Host, Username, Password and 
Mailbox. All these details are provided by your Service Provider.
     For security, the Username and Password are displayed as asterix 
characters. To enter a new Password or Username, delete all the asterix 
characters and enter the new Username or Password.
     To change between different account details use the Up and Down 
arrows, if you have changed any details in the account that is currently 
displayed they will automatically be saved.
     The final item is the Delete button, this will remove the currently 
displayed account from the database. The number of accounts in the 
database is displayed at the top right of the dialog.
     To add a new FTP site to the database simply edit the details 
displayed and click on OK or use the Up and Down arrows to change to 
another site's details. ICE_NET will automatically save the new account 
into the database.

                             ----------------

     Section 2.5 FTP Sites

     This dialog allows you to enter FTP site details into the FTP site 
database so that you can select an FTP site easier while on-line with ICE.
     The dialog contains areas for an FTP site name ie 'ftp.demon.co.uk', 
you can also set a default directory so that when you logon to the site 
ICE automatically changes to that directory. The remaining three areas 
allow you to enter User ID, Password and Account number if you have a 
specific Account with an FTP site. If you don't have a specific Account 
click on the Anonymous button, this will log you onto the FTP site with a 
User ID of FTP and your E-Mail address is the Password.
     For security, the Password is displayed as asterix characters. To 
enter a new Password, delete all the asterix characters and enter the new 
Password.
     To change between different site details use the Up and Down arrows, 
if you have changed any details in the site that is currently displayed 
they will automatically be saved. 
     The final item is the Delete button, this will remove the currently 
displayed group from the database. The number of sites in the database is 
displayed at the bottom right of the dialog.
     To add a new FTP site to the database simply edit the details 
displayed and click on OK or use the Up and Down arrows to change to 
another site's details. ICE_NET will automatically save the new site into 
the database.

                             ----------------

     Section 2.6 FTP Access

     There are four items in this dialog, the default download path, the 
FTP Server root and the FTP Server on/off popup.
     To set the download path click on the top Select button, the 
File Selector will appear. Select the drive and folder you wish any FTP 
dowmloads to be placed in and click on OK. The path name will now appear 
in the top box.
     If you wish to allow people to logon to your machine to upload and 
download data from your hard drive you must define the root of your FTP 
site (the \ directory when people first logon). To do this click on the 
bottom Select button, the File Selector will appear. Select the drive and 
folder you wish to be the root of your FTP site and click on OK. The path 
name will now appear in the bottom box. Finally change the FTP Server to 
ON to tell ICE to set up the FTP Site when you logon.
     The final step is to define the Passwords used to limit access to 
your FTP Site. Click on the Password button and the Password dialog 
appears. You can define upto five levels of access. At this time ICe does 
not support multiple levels of access, you may enter passwords, but they 
will not be saved.

     Obviously your FTP site will only be available when you are online, 
but this can be a very good method for transferring files between you and 
other people. To limit the access people have to your hard drive use the 
FTP Access option described above to set passwords that are required when 
people logon to your FTP Site.

                --------==========<<<>>>==========--------

     Section 3 Internet Accounts

     The second section contains the following items.

     New Account, Delete Account, General Details, Dial Script, Account 
Details, Function Keys, and the Select Account Popup.

     Let's deal with each item in turn.

                             ----------------

     Section 3.1 Defining Accounts

     New Account

     This option allows you to specify a new Internet Account for use in 
OASIS 2 and ICE. A dialog appears allowing you to enter the New Account's 
Name. This item is only available if you currently have less than 10 
Accounts already specified. The details initially set for the New Account 
are copied from the Account currently shown in the Account Selector. When 
you click on OK, this Account name is added to the Select Account Popup.

                             ----------------

     Delete Account

     This allows the currently selected Account to be removed from the 
current list of Accounts. You are asked to confirm that you wish to delete 
The currently selected Account. When yoiu click on OK, this Account is 
removed from the Select Account Popup.

                             ----------------

     Account Selector

     This popup allows you to select which Internet Account you are 
editing the details for.

                             ----------------

     Section 3.2 General

     This dialog has four areas, the World Time Zone popup that allows you 
to define your local Time Zone so that OASIS 2 can set your system clock 
to GMT as used by the Internet.
     The next section allows you to enter you Modem commands for Dial, 
Hang Up and Reset.
     The next section allows you to enter the Main User's (Sysop's) 
Username, real Name and a Filename. The filename is used for the Mailbox 
and Yellow Pages files if the Username would be an illegal filename or if 
it is too long or clashes with another filename already in use.
     If you enter a filename that clashes with an existing one, ICE_NEt 
will return you to this dialog when you click on OK. if you leave this 
field blank, ICE_NET will copy the Username into this field.
     Finally there is a popup to switch on or off the Online time clock, 
this clock appears in the top left of the screen and indicates the number 
of hours and minutes you have been connected to the 'net.

                             ----------------

     Section 3.3 Dial Script

     This dialog allows you to set the amount of time the ICE Dialer will 
allow for the Modem to connect (Dial Time) and the amount of time the 
Dialer will allow for the Logon process to take place (Connect Time). You 
also specify the Telephone number the Dialer uses in this dialog.
     The remaining items in this dialog is where you define the Dial 
Script. The left hand side of the dialog is the text the Dialer receives 
from your service provider and the text to the right is the text the 
Dialer sends in return.

     So for example, this is my old NOS DIAL.TXT file:-

cwait 30000  "gin:" "NO CARRIER" 
wait 1000
send "yeadontt\r"
wait 60000 "word:" 
wait  1000
send "password\r"
wait 60000 "ocol:" 
wait 1000 
send "ppp mru=1500 idle=300\r"
wait 60000 "HELLO"

     So this means that the Dialer waits to receive the text 'gin:' and 
returns 'yeadontt'. The old NOS dialer required the \r for the Return 
key press, but the ICE Dialer doesn't require this. These first two items 
would be laid out like this in the ICE Dialer dialog:-

          gin:                yeadontt

     ie the 'gin' is placed in the first line on the Receive side and the 
'yeadontt' is placed in the first line on the Send side.

     So the full dial script for ICE would look like this:-

          gin:                yeadontt
          password            password
          ocol:               ppp
          HELLO

     The last receive send combination MUST only have test on the Receive 
side. This is the text the Dialer waits to receive, when this text is 
received the Dialer knows you are connected and exits.

     The protocol element only needs to be slip or PPP, no additional 
parameters are required.

     If your service provider uses the Dynamic IP Address system, you 
place the last text you receive before the IP address in the Receive side 
and the Send side contains $GET_IP. The Dialer will then read the IP 
address and pass it onto ICE. If not text is received after the IP 
address, you MUST still place some text in the receive line after the 
$GET_IP, any text will do.

                             ----------------

     Section 3.4 Account Details

     This dialog allows you to edit the major Account details. You can 
edit the Account name that appears in the Account Selector.
     In the top left corner a popup lets you set the Protocol ICE will use 
to communicate with the Internet, the options available are SLIP and PPP. 
If you change the protocol to be used, a warning will appear telling you 
to check that your Dial Script is still correct. There are three items for 
PPP, these let you choose a packet size of either 520, 1024 or 1536 bytes.
     The top three fields in the dialog must be completed in order for 
OASIS 2 and ICE to function correctly.
     You must fill in the  Host and Domain name parts of your E-Mail 
address for the Account. The Host name is the 'yeadontt' part and the 
Domain name is the 'demon.co.uk' part of the E-Mail address 
'phil@yeadontt.demon.co.uk'.
     You must also fill in your IP address, if you have a Dynamic IP 
address, leave this field blank.
     The final two items are optional, the Reply-To E-Mail address is only 
used if it is different to you normal E-Mail address for this Account. if 
you enter your normal E-Mail address it will not be saved with the rest of 
the Account details. The Organisation name is used for company or club 
names etc.

                             ----------------

     Section 3.5 Function Keys

    This Dialog contains three key areas. First the text defined for a 
Function key can be edited. Second the type of Function  key can be set, 
either Normal or with one of the Shift, Control or Alternate keys. Finally 
the Function key being edited ie 1-10. To select a particular key click on 
its number and one of the four key type buttons, then edit the text. To 
add the 'Return' key press to the end of a command enter \n after the 
text. You can define a total of 39 Function key combinations, F10 without 
any shift keys is reserved for ICE to top the command Line window.

                             ----------------

     Section 4 Account Options

     There are six areas that define the detailed operation of an 
individual Internet Account. These are the TCP/IP options, the Mail 
options, the News options, the Log files, the Time options and the IP 
Addresses.

     Section 4.1 TCP/IP

     This dialog allows you to set the Internal and External packet life, 
the TCP Error count and the packet size.
     The Internal packet life is the number of seconds a packet 'lives' on 
your service providers system before it is discarded. If the packet is 
discarded ICE will attempt to send it again. The default value for this 
field is 8 seconds.
     The External packet life is the number of seconds a packet 'lives' 
outside your service providers system on the rest of the Internet before 
it is discarded. If the packet is discarded ICE will attempt to send it 
again. The default value for this field is 60 seconds.
     The TCP Error count defines how many TCP/IP errors will occur one 
after the other before the Socket the error occurs on is disconnected. So 
if one packet is sent out and an error occurs, ICE counts the errors until 
this figure is reached. If the packet is successful before the count 
reaches this figure, ICE resets the count back to zero. The default value 
for this field is ten errors.
     The packet size is the  amount of data (in bytes) that will be sent 
inside one packet. If you experience a lot of packets failing reduce the 
packet size. The packet sizes available for SLIP are 512,1024 and 1536. 
the packet sizes available for PPP are 500, 1000 and 1500.

                             ----------------

     Section 4.2 Mail

     This dialog contains popups for Bell, Auto Send and POP3.
     With bell on every time a new piece of E-Mail arrives ICE will sound 
a bell, otherwise no notification will be given other than the text in the 
Mail window.
     With Auto Send on ICE will automatically send any E-Mail you have 
prepared with OASIS 2 before logging on, otherwise you will have to select 
Send Mail from the ICE Mail menu.
     The POP3 popup tells ICE if you have a POP3 account with your service 
provider.

                             ----------------
     
     Section 4.3 News

     This dialog contain popup fields for Auto News and Posting and 
Download Methods as well as two text fields for News Timeout and History.
     With Auto News o nICE automatically 'kicks' your News server until it 
connects successfully, otherwise you will have to select Get News from the 
ICE News menu.
     The Posting Method popup tells ICE which method to use for uploading 
News articles. There are two methods available 'I HAVE' and 'POST'. Select 
the method that works with your service provider.
     The Download Method popup defines whether ICE will download News 
articles by their Date and Message ID or by an article Number assigned by 
the Service Provider. Again, select the method that works best with your 
Service Provider.
     The News Timeout field defines the amount of time in seconds the News 
system can be inactive before it disconnects. So the default value of 300 
seconds means that ICE will disconnect the News socket after five minutes 
if there is no data transferring. If you experience long 'dead' periods 
you may need to increase this figure.
     The Article History field defines how many News article IDs ICE 
retains in the History file to eliminate downloading duplicate News 
articles.

                             ----------------


     Section 4.4 Log Files

     This dialog allows you to specify which Log files ICE will record 
while it is running. This allows you to check what has been happening if 
you are experiencing difficulties or just to keep a record of your 
activities.
     The ICE Log contains the time you logon or logoff the Internet or, in 
addition, the activities that you carried out while on line. Set the popup 
to OFF to disable the log, to DATE to record your logon and log off times 
and to FULL to keep a full record of all activities.
     The General Error Log reports and TCP/IP or other errors that occur 
while ICE is online. You can disable this log by setting the popup to OFF, 
VIEWER tells ICE to display any errors in the Viewer as they happen while 
FILE will write the errors into a file on your hard drive.
     With Packet Log ON a file containing EVERY byte sent and received by 
ICE while online is written to your hard drive. WARNING this file can get 
VERY BIG so take care.
     With Mail Log ON a file containing the commands and data sent and 
received by ICE while it downloads and uploads E-Mail is written to your 
hard drive.
     With  News Log ON a file containing the commands and data sent and 
received by ICE while it downloads and uploads News is written to your 
hard drive.     
     With FTP Log ON a file containing the commands sent and received by 
ICE while it downloads and uploads files and communicates with FTP sites 
is written to your hard drive. This log only refers to you accessing FTP 
sites, and does not cover your own FTP Site.

                             ----------------

     Section 4.5 Time

     This dialog allows you to tell ICE to automatically set your system 
time to that of the Internet.
     The Auto Attempts field defines how many times ICE will attempt to 
set your system clock.

                             ----------------

     Section 4.6 IP Addresses

     This dialog allows you to set the IP Addresses that ICE needs to 
know, the only field you MUST fill in is the Domain Server. You can either 
ask your service provider to supply you with this information or if you 
have a working NOS setup the Domain Server IP Address can be found in the 
domain section (usually the first IP Address set) or in the default route 
section, ie:-

# set up the domains
domain addserver [158.152.1.65]
domain addserver [158.152.1.71]
domain addserver [158.152.1.193]
domain suffix demon.co.uk
domain cache clean on
domain cache size 100
domain cache wait 300

route add default sl0 158.152.1.65 1

     The other IP Addresses can be left blank and will be set to the same 
address as the Domain Server. If you can find out the IP Address for any 
of the other items then obviously fill them in as this will make things 
work more smoothly when online.
     The Domain IP address and Dynamic Name Server (DNS) addresses must be 
the numeric IP address (ie 158.152.1.65), but the remaining IP addresses 
can be either numeric, or the name. 
     So for the news server you could enter 158.152.254.254 or 
news.demon.co.uk either will work. The name is the better option, because 
if your service provider changes the IP address of the server, the name 
will probably remain the same and ICE will automatically find the IP 
Address from the name when it needs to.

                             ----------------

     Section 5 Problem Solving

     As with any complex configuration of this type, you can make mistakes 
or enter the wrong information. If you have any difficulties check the 
ICE.NET file using this program. If you are not sure about any of the 
details contact your service provider. 


