DP Tool Club 15/CD_ASCQ_15_070894.iso/vrac/ichatv35.zip/ICECHAT.DOC

Text File | 1994-05-31 | 70KB | 1,804 lines

────────────────────────────────────────────────────────────────────────────────

 ▄█▄   ▄███████▄  ▄█████████▄   ▄███████▄   ▄██   ██▄   ▄███████▄  ▄██████████▄
█████ ████▀  ▀███ ████    ▀▀▀  ████▀  ▀███ ████   ████ ████▀▀▀████ ▀▀▀▀████▀▀▀▀
█████ ████        ████▄▄▄▄▄    ████        ███████████ ████▄▄▄████     ████
█████ ████        ████▀▀▀▀▀    ████        ████▀▀▀████ ███████████     ████
█████ ████▄  ▄███ ████    ▄▄▄  ████▄  ▄███ ████   ████ ████   ████     ████
 ▀█▀   ▀███████▀  ▀█████████▀   ▀███████▀   ▀██   ██▀  ▀██▀   ▀██▀     ▀██▀
        ██   ██      ██   █▌      ██  ▐▌     ██         █▌     ██       ██
        ▐▌   ▐▌      ▐▌   ▐       ▐▌   ▌     ▐▌         ▐      ▐▌       ▐▌
         ▌    ▌      ▐                       ▐                 ▐         ▌

────────────────────────────────────────────────────────────────────────────────
      IceChat v3.50 -  CopyRight Jeremy Landvoigt, 1993  - IceChat v3.50
────────────────────────────────────────────────────────────────────────────────

                     Ansi/Ascii Split Screen Chat Program
                     For RemoteAccess, SuperBBS Software
                          & Dorinfo1.Def Compatibles

                  Original Documentation by Jeremy Landvoigt,
                   Updated by Eddy Matthews For 3.10 Release
                Revised again by Jeremy Landvoigt 3.50 Release

 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓                     Table Of Contents                    ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 Table Of Contents ...................................................... 1

 Some Of IceChat's Features ............................................. 2

 Setting Up IceChat Using ChatCfg.Exe ................................... 3

 Upgrading from v3.10 to v3.50 .......................................... 9

 Installing IceChat Into RA 2.0x Systems ................................ 9

 Installing IceChat Into SuperBBS 1.1x Systems .......................... 13

 Installing IceChat Into other Dorinfo1.Def Systems ..................... 17

 Macros In IceChat Configuration ........................................ 17

 BBS System Files Used By IceChat ....................................... 18

 Parameters Used When Executing IceChat ................................. 19

 Files Created & Used by IceChat ........................................ 20

 Frequently Asked Questions ............................................. 23

 Registration ........................................................... 24



                                   -1-







 Archive Contents ....................................................... 25

 CopyRight Notices & Program Disclaimer ................................. 26

 Credits ................................................................ 27

 Program Support - BBS Locations ........................................ 27




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓               Some Of IceChat's Features                 ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 {+} Indicates registered only.

     IceChat is a split screen chat utility for RemoteAccess & SuperBBS
     BBS packages. It can be used with many other BBS types as long as they
     support Dorinfo1.Def type Doors.

     IceChat supports two different types of chat modes :

     1) Horizontal Split Screen Chat (Chat Windows above and below)
     2) Vertical Split Screen Chat Mode (Chat Windows Side By Side)

     IceChat also has another chat mode for ASCII users.

 {+} IceChat allows the users to post a comment in the area of the SysOps
     Choice. It has a built Message Editor For this purpose. This function
     requires the Hudson message Base Type.

     If the SysOp doesn't answer the page, and you are using RemoteAccess or
     SuperBBS, IceChat will update the [Wants Chat] flag causing it to be act-
     ivated on the SysOps status line, and the users total number of pages for
     the call will be incremented. This is ONLY possible when using RA or
     SBBS, generic Dorinfo1.Def systems are not supported by this feature.

     Configurable Emergency page option, password protected. This is activated
     when a user has paged outside of paging hours. If they chose to emergency
     page, they must enter a password. This can be disabled by leaving
     password blank when configuring IceChat. It can also be configured so
     that only users ABOVE a set security level will be asked for the
     emergency page password.

     IceChat v3.50 will seek out Ra 2.0x or Sbbs 1.1x and read in crucial
     information from the BBS configuration to make IceChat v3.50 even easier
     to install than it already is.

    A configurable page tune for those users that are in your VIP.CTL Textfile

    IceChat is Easily configured, unlike many programs SysOp's have to deal
    with.

    Easy To Use SysOp function keys :

    F1     : Display Help Status Pop Up Menu


                                   -2-







    ALT-F2 : SplitScreen Chat Mode
    ALT-F3 : Vertical Chat Mode
    ALT-B  : Blacklist User (Security Lockout) [RemoteAccess & SBBS Only!]
    ALT-E  : User Editor
    ALT-H  : Hang Up
    ALT-J  : Drop To DOS
    ALT-L  : Line Noise Key
    ALT-T  : ASCII TextFile Dump to modem & screen
    ALT-X  : Force Program Exit

    Easy To Use User Keys :

    CTRL-U : Display User help line
    CTRL-L : List/Add to available Macros (if enabled)
    CTRL-W : Clear Window
    CTRL-R : Redraw Screen

    Online User Editor : IceChat has an Online User Editor Built in so that
    the SysOp can edit the users Profile without having to exit back to the
    BBS. (RemoteAccess & SuperBBS Only)

    Can play random page tunes

    Defined Macro Listing in Chat

    And LOTS MORE!!

 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓          Setting Up IceChat Using ChatCfg.Exe            ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 To Setup IceChat, please read this section thoroughly! Then also read the
 section of these documents that apply to the Installation of IceChat into
 the particular type of BBS system you are running (i.e. RA, SuperBBS etc)

 N.B.
   Menu items that are followed by '{+}' are REGISTERED ONLY features, and will
   not be active until you have registered IceChat and obtained a valid key.

 When you run CHATCFG.EXE, you will be presented with a series of pulldown
 menus. In this section we will step through each menu in turn and explain
 in some  detail what  you need to  enter in order  that IceChat  will be
 configured  correctly. The  cursor  keys are used  to move  around the
 configuration  program, left and  right will  move between the  various
 pulldown menus, and the up and down keys will step through the items on
 each menu or submenu.


 FILE
 ------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  Save & Exit        ▐
 ▌  Save Without Exit  ▐
 ▌  Exit Without Save  ▐
 ▌  Macro Editor       ▐
 ▌  Quiet User Editor  ▐
 ▌  Registration Info  ▐
 ▌  Program Info       ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█



 · Save & Exit - Selecting this option will save any changes you have made
   and exit to Dos.

                                  -3-

 · Save Without Exit - Save changes and stay in ChatCfg.

 · Exit Without Save - Exit ChatCfg, but DO NOT save any changes made.

 · Macro Editor - This menu option will bring up a submenu that will ask for a
   'Keyword' and a 'Macro' that will be used in place of the 'Keyword' as
   explained below. You can also configure the colour that will be used when
   these macros are displayed.
    - Page #1 - Page #5
      There are five pages available for you to enter macros. They are
      explained below. Pages #3-#5 are ONLY available to registered users
      of IceChat, unregistered users are limited to two pages.
    - User Keyword - The word to be translated by IceChat, i.e. RA
    - Macro - The replacement to be used by IceChat, i.e. RemoteAccess

      IceChat has the ability to translate Macros when in Chat mode,
      here you can enter the macro and what IceChat should convert it
      to.   i.e. RA = RemoteAccess. You will be asked for the original
      word and then for the replacement, enter "RA" (as the original) and
      RemoteAccess (as the replacement) then whenever you type "RA" when
      in chat mode, IceChat will convert it to "RemoteAccess" (without
      Quotes). You have two pages in which you can enter any macros you
      wish. It is useful to also place common mistyped words here too, i.e
      TAHT (User Keyword) - THAT (Macro) then every time you accidentally
      type 'Taht', IceChat will convert it to 'That'.

      Control strings may also be used in macros. For Example, if your
      key word is "HT!" and the Macro is "Hi There @F!", when "HT!" is
      typed in chat, it will be replaced with "Hi There Jeremy!" For
      example. Available control strings are listed in a seperate section
      of these documents.

    - Colour
       Once you have entered a "User Keyword" and it's accompanying
       "Macro" IceChat will ask for a colour. This is the colour that the
       Macro will be displayed in when in chat. An Asterisk (*) will show
       the colour you have selected.

 · Quiet User Editor - Allows you to edit a list of user names. Here you
   can specify those users that you DO NOT wish to chat to. If a user that
   is entered in this list attempts to page, IceChat will 'Appear' to operate
   normally to the user, but it will NOT play a page tune to annoy the SysOp.

 · Registration Info - Gives detail of the status of IceChat and other
   registration info.

 · Program Info - Gives detail of the current version of IceChat including
   release date and any crucial fixes.

 STRINGS
 ---------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  Greetings String    ▐
 ▌  User Editor String  ▐
 ▌  ASCII Dump String   ▐
 ▌  Drop To Dos Header  ▐
 ▌  SysOp Help String   ▐
 ▌  Page SysOp String   ▐
 ▌  Page Reason Header  ▐
 ▌  Message String {+}  ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█


 NOTE: IceChat now has the ability to use a number of macro characters that
       will be translated when it is run. These can be used in the various
       'Strings' that can be displayed to the user. See the seperate section
       of these docs for more info on the macros and their usage.

                                   -4-

 · Greetings String - String displayed to users when the SysOp first enters
   chat. This string will only be shown once per program execution. Leave
   blank to disable.

 · User Editor String - String displayed to users when the user record is
   being altered, by using the built in user editor in IceChat (RA and Sbbs
   only).

 · ASCII Dump String - String displayed to users when SysOp is preparing to
   view an ASCII file.

 · Drop To Dos String - String to be displayed to users when the SysOp Drops
   To DOS.

 · SysOp Help String - String displayed to users when SysOp is viewing local
   help window by pressing F1 (Function key F1) when in Chat.

 · Page SysOp String - Enter the string displayed to users when paging the
   sysop.

 · Page Reason Header - Reason for page header. i.e. "Why do you want to chat
   with Jeremy?"

 · Message String {+} - The string to be displayed when IceChat asks if the
   user wants to enter a message to the SysOp if the chat request is
   unanswered.


 PATHS
 -------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  MsgBase Path {+}     ▐
 ▌  External Editor {+}  ▐
 ▌  Logfile Path         ▐
 ▌  External DOS Util    ▐
 ▌  Regular Pagetune     ▐
 ▌  VIP Pagetune         ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█


 · MsgBase Path {+} - Path to your message base, i.e. C:\RA\MSGBASE

   NOTE TO RA SYSOPS:
       IceChat DOES support the JAM message base at this time. The area
       selected for IceChat to post messages into MUST be specifically
       configured to be either a HUDSON base OR a JAM Base.

 · External Editor {+} - The full path and command line of the external
   message editor you want to use such as IceEdit. This will be called
   whenever a user leaves a message to the SysOp when a page has not been
   answered. Please refer to the documentation for the message editor of
   your choice for details of the required command line.

 · External DOS Util - When shelling to DOS using the Alt-J function within
   IceChat, you have the ability to call up a program automatically by
   enabling this option.

   If you enter the path and filename of a DOS utility, when you shell
   to DOS IceChat will ask if you want to invoke your Dos program - You
   can then select 'Y' to run it, or 'N' to go straight to Dos.
   If you leave this field blank IceChat will just shell to Dos as
   normal, you will NOT be asked to press Y/N.

 · Logfile Path - The path and filename of the logfile IceChat should use.
   This can either be a seperate logfile, or IceChat can append to your BBS
   logfile if you so choose.

 · Regular Pagetune - The path and filename the 'Normal' pagetune to be used
   by IceChat (i.e. C:\ra\Icechat\Page.Ice).

                                   -5-


 · VIP Pagetune - The path and filename of the 'VIP' pagetune to be used by
   IceChat (i.e. C:\ra\icechat\Vip.Ice).

   This tune is used for VIP users who's names are stored in an ASCII
   control file called VIP.CTL. See the section of these docs about
   the Files Used and Created by IceChat for more info on this file.

 TOGGLES
 ---------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  Alias Usage          NO   ▐
 ▌  Force Greeting       NO   ▐
 ▌  Suspend Time         YES  ▐
 ▌  Chat In Top Window   YES  ▐
 ▌  View Macros          YES  ▐
 ▌  Create Macros        NO   ▐
 ▌  Allow Remote Exit    NO   ▐
 ▌  Page Exceeded Hangup NO   ▐
 ▌  Beep Remotely        YES  ▐
 ▌  Use JAMbase          NO   ▐
 ▌  Use Tearline         YES  ▐
 ▌  Use Countdown Bar    NO   ▐
 ▌  Disable Bleep {+}    YES  ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█


 · Alias Usage - Should IceChat use the SysOp's & User's alias as defined
   above? Yes/No

 · Force Greeting - Should IceChat use the 'Greeting' string when a 'Forced'
   chat is initiated by the SysOp.

 · Suspend Time - Should IceChat freeze the users time whilst in chat.

 · Chat In Top Window - Should the Sysops chat window be the top one? If NO,
   IceChat will place the users chat window on top.

 · View Macros - If Yes, users users can view the macros that have been
   defined.

 · Create Macros - If set to Yes, users will be allowed to create thier own
   macros. If set to No, they can only use the macros that the SysOp has
   defined.

 · Allow Remote Exit - Are users allowed to terminate a chat? If set to NO,
   only the Sysop will be able to stop the chat by pressing [Esc] or Alt-X.

 · Page Exceeded Hangup - Should IceChat drop the carrier on a user if he/she
   exceeds the permitted number of attempts to page the Sysop. (RA/SBBS Only)

 · Beep Remotely - Should IceChat cause the remote (Users) terminal to Beep
   whilst paging the sysop.

 · Use JAMbase - Should IceChat make use of the JAMBase when posting messages
   to the Sysop after an unanswered page? If NO, IceChat will expect the
   message base to be a HUDSON message base.

 · Use Tearline - Should IceChat append a tearline to the end of messages
   written from within IceChat? Eg:

   --- IceChat v3.50
    * Origin: Ice Technologies BBS, 905-895-0852, IceSoft HQ!

 · Use Countdown Bar - Should IceChat use the countdown graph while paging?
   (The countdown graph looks like this: [████░░░░░░░░░░░] ) It is useful to
   disable this if you often abort users pages.

 · Disable Beep {+} - Disable the beep on keypress when in ChatCfg. This option
   also affects some beeps in IceChat itself.


                                   -6-

 NAMES
 -------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  BBS Name           ▐
 ▌  SysOp Real Name    ▐
 ▌  SysOp Alias        ▐
 ▌  CoSysOp 1 Name     ▐
 ▌  CoSysOp 2 Name     ▐
 ▌  CoSysOp 3 Name     ▐
 ▌  Msg Area Name {+}  ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█



 · BBS Name - Enter the name of your BBS system.

 · SysOp Real Name - The name of the System operator.  If you are a registered
   user of IceChat, this name MUST be exactly the same as the name that
   appears in the registration key.

 · SysOp Alias - System operators Alias (if used). If this is enabled, IceChat
   will use the Users alias aswell.

 · CoSysOp 1-3 Names - Enter up to 3 Co-SysOps in these fields.  To select a
   CoSysop for Chat, run IceChat with a parameter ranging from A-C, or you may
   select the CoSysOp for chat from within IceChat while the pagetune is
   playing.

   i.e.  IceChat.Exe /A  - would cause IceChat to use the #1 Co-Sysops
                           name instead of the SysOp's name.

   OR You may press 1,2 or 3 while the page is playing to select a CoSysOp for
   chat.

 · Msg Area Name {+} - Name of the message area used to post messages into if
   the sysop does not respond to a chat request (or if he/she manually aborts
   the request)


 COLOURS
 ---------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  Punctuation       ▐
 ▌  Numbers           ▐
 ▌  UpperCase ASCII   ▐
 ▌  LowerCase ASCII   ▐
 ▌  High Bit ASCII    ▐
 ▌  Macros            ▐
 ▌  Sysop Name        ▐
 ▌  User Name         ▐
 ▌  Time Clock        ▐
 ▌  Chat Timer        ▐
 ▌  Status Line       ▐
 ▌  Default Settings  ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█


 Here you can define what colours IceChat should use for various
 types of text. You can select the colour you prefer for any of the
 following :

 · Punctuation    · Numbers      · Capital Letters      · High Bit ASCII
 · Macros         · SysOp Name   · User Name            · Time Clock
 · Chat Timer     · Status Line

 · Default Settings - Selecting this option will restore IceChat's 'Default'
   colours.

 Select the colour you prefer by entering the number indicated in
 ChatCfg.Exe. IceChat will then use these colours when in chat.


 PAGE SETUP
 ------------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌  Page Hours          ▐
 ▌  Page Duration       ▐
 ▌  Maximum Pages       ▐
 ▌  Page Reason Length  ▐
 ▌  Emergency Password  ▐
 ▌  Emergency Security  ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█

 · Page Hours - Paging Hours (must NOT extend beyond midnight!) Enter the
   starting and ending times for each day of the week. Users can ONLY
   page between these hours, or by entering a password if it is outside paging
   hours (See Emergency Password). These hours MUST NOT extend beyond
   midnight.

                                   -7-

 · Page Duration - How long (in seconds) IceChat should page the sysop.

 · Maximum Pages - How many times a user may page in one session. This feature
   can only be used if SuperBBS or RA is the BBS package.

 · Page Reason Length - The minimum number of characters a user MUST enter as
   a page reason. If the user enters LESS than this amount IceChat will exit
   and inform him/her that the reason is too short.

 · Password required to page the sysop outside normal paging times. The user
   will need to enter this password BEFORE IceChat will call the SysOp, in
   this way regular or trusted users can page you at any time. They MUST also
   have a security level ABOVE the level set in 'Emergency Security' for this
   feature to be used.

 · Emergency Security - The MINIMUM security needed by a user before they
   will be given the option to FORCE an 'Emergency Page' outside normal paging
   hours. Users with a security BELOW this level will NOT be given the option
   to page outside the normal hours. See also 'Emergency Password', the two
   emergency options (Password and Security) work in combination with each
   other.


 OTHER
 -------

 █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
 ▌ Board Number {+}     ▐
 ▌ Msg Attribute {+}    ▐
 ▌ Origin Line {+}      ▐
 ▌ Chat Border Type     ▐
 ▌ BBS Type             ▐
 ▌ Name Brackets        ▐
 █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█


 · Board Number {+} - The number of the message board as defined in your BBS
   config. This only applies if you are using the HUDSON style message base.
   If you are using JAMBASE, make sure you specify the full path and filename
   of the JAMbase in the files setup.

 · Msg Attribute {+} - Message Type - Private, Public, Or Both - Select the
   message attribute. If set to 'Private/Public' IceChat will ask if the
   message is Public or Private before it is saved.

 · Origin Line {+} - The originline that will be appended to messages to the
   SysOp written from within IceChat. This can be disabled under the Toggles
   setup.

 · Chat Border Type - Choose one out of a selection of three different types
   of chat windows borders that you would like to use while chatting with the
   user.

 · BBS Type - Select the BBS software you are using. This is essential for the
   correct operation of IceChat.

       - RemoteAccess v2.0x
       - SuperBBS v1.1x
         If you are using Sbbs, you will be presented with another menu
         option:

          - SBBS UserFile Path
            If you are using SuperBBS v1.1x, you will be asked for the path
            to your user file (Susers.Bbs). This is the PATH ONLY, NOT the
            filename of your user file!.

       - Dorinfo1.Def Compatible
         If you are not using RA or SBBS, IceChat can still use the generic
         Dorinfo1.Def file which is generated by *most* BBS packages. Check
         your BBS documentation to see if it can generate a Dorinfo1.Def
         file.

                                   -8-

 · Name Brackets - Select the brackets ( {([ ) that will be used when
   displaying the SysOp's or Users name in IceChat.

  Please note that the configuration file is not a text file, so you
  MUST use CHATCFG.EXE to configure the program, and the configuration file
  must be named ICECHAT.CFG.


 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓             Upgrading From v3.10 to v3.50                ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 This couldn't be easier!

 Simply copy the files from the v3.50 distribution archive into the directory
 you have IceChat installed and run 310TO350.EXE. This will upgrade all of the
 previous versions configuration to the format needed by v3.50



 Please Note!

 Failure to upgrade your previous configuration files will result in an error
 message being displayed if you attempt to run ChatCfg.Exe or IceChat.Exe

 You should also run ChatCfg.Exe and step through each of the pulldown menus
 to ensure your setup is correct.




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓          Installing IceChat Into RA v2.0x Systems        ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 Please read the section of this document entitled 'Setting Up IceChat Using
 ChatCfg.Exe' BEFORE attempting to install IceChat into RA. Failure to setup
 IceChat correctly before installing it into your bbs program will probably
 result in IceChat failing to run or not running as expected.

 If you are using RemoteAccess, and you wish to take advantage of the added
 features for the RemoteAccess BBS Package, you MUST be running RemoteAccess
 v2.00 or a newer version. IceChat's added features will not work properly
 with versions of RemoteAccess older than v2.00.

 In order to run IceChat.Exe, you must have a fossil driver active. A fossil
 driver such as BNU should work fine with IceChat. If you don't have a fossil driver installed, a
 simple error message will be displayed, and the program will stop. A fossil
 is not required when running in local mode.



                                   -9-









 We will now run through EVERYTHING you need to do in order to get IceChat to
 run in your RemoteAccess setup.

1.  Extract all the files in the distribution archive to a directory of your
    choice. C:\RA\ICECHAT is recommended and is assumed to be the directory
    you are using from now on.

2.  To help IceChat find it's configuration files, you need to define an
    environment variable for it in this manner in your AutoExec.Bat :

    SET ICE={PATH TO ICECHAT DIRECTORY}

    PLEASE NOTE, THE ENVIRONMENT VARIABLE NAME IS ICE  -  NOT ICECHAT !!

    The environment variable is used by IceChat to find its system files
    and configuration. Failure to setup the environment variable can result
    in IceChat failing to run correctly - YOU HAVE BEEN WARNED!

    Please see your DOS manual for more information on environment variables.

  N.B.
    You will need to reboot your machine after entering the environment
    variable for it to take effect.

3.  Run ChatCfg.Exe and configure all of IceChat's options as explained earlier
    in this document. You MUST configure IceChat for it to work correctly!
    Refer to the section of this document for setting up IceChat.

4.  You will now need to edit your .MNU files to include IceChat so that when
    a user pages you it will execute IceChat instead of the internal chat
    routine built into RemoteAccess.
    IceChat can be run using either a type 7 or a type 15 menu command. A type
    15 menu will require a batch file that is called to execute IceChat, a type
    7 menu only  needs  to have  the command  line  to execute  IceChat on the
    Optional data line of the menu. See your BBS manual for more information on type 7 and type 15
    menus... Decide which type of menu command (Type 7 or type 15) you wish to
    use and then do ONE of the following depending on which menu type you have
    chosen to use:

    Type 7 Menu Command:


      Optional Data:
       <command line> [control codes]

      Description:
      This function will run an external program, or door in a
      shell while the user is on-line.

 Example command lines for Type 7 usage:


   In a single line system, calling the SysOp to chat you may use...


                                   -10-








    C:\RA\ICECHAT\IceChat.Exe *! *M



   In a multi-line system, calling the Sysop may use...
   This example would call the correct node number by using RA's *N parameter.

    C:\RA\ICECHAT\IceChat.Exe *! *M



   In a single line system, calling CoSysOp #1 (NOT the sysop) you may use...

    C:\RA\ICECHAT\IceChat.Exe -A *! *M



 The following RA parameters are used in the above examples:


      *M
      Activate the MemorySwap feature. RemoteAccess attempts to
      swap itself and all the memory it occupies to XMS and EMS
      memory (if available) or to disk, leaving only 3KB resident.
      This is ideal when running memory-hungry programs but takes
      a few seconds longer in order to perform the swap.  If the
      swap cannot be accomplished, RemoteAccess will attempt to
      load the program in a normal shell.

      *N
      The current node number, as specified by the -N command line
      parameter when RemoteAccess was loaded.

      *!
      Freeze the system timer for the duration of the shell.



    Type 15 Menu Command:


      Exit to DOS with errorlevel
      Optional data:
      <errorlevel>

      Description:
      This function causes RemoteAccess to exit to DOS completely,
      returning an errorlevel to your BBS batch file.  The
      optional data field should contain the errorlevel that you
      wish to pass to the batch file.  The batch file should trap
      the errorlevel and act accordingly.

      If you use this exit while the user is still on- line, the
      user may be logged back into RemoteAccess using the command
      line parameter -R.  This forces RemoteAccess to read the


                                   -11-







      EXITINFO.BBS file that was written at the time of the exit
      so that it can restore system and user information,
      presenting the user with the TOP menu.

      NOTE:  Errorlevels 0 through 5 are reserved for internal use
      by RemoteAccess.  For a complete description of these
      internal errorlevels and how they are used, see the
      Errorlevels section of the Reference chapter.


If you decide to use a Type 15 menu to call IceChat you will need to add IceChat
into your BBS batchfile and call IceChat with the errorlevel you have chosen.

            :START
            IF ERRORLEVEL 10 GOTO ICECHAT
            IF ERRORLEVEL  5 GOTO NET&ECHO
            IF ERRORLEVEL  4 GOTO ECHOMAIL
            IF ERRORLEVEL  3 GOTO NETMAIL
            IF ERRORLEVEL  0 GOTO START_UP
            GOTO START_UP

            :ICECHAT
            CD\RA\ICECHAT
            ICECHAT.EXE <Don't forget IceChat's Parameters!>
            RA -R
            GOTO AFTER_BBS

           In this  example, a TYPE 15  menu command with an Errorlevel of
           10 will make the batch file  execute the command following  the
           :ICECHAT label. Include  the line "RA  -R" to  return to
           the board after the external programs have been executed.

 N.B.
  DO NOT FORGET to include the correct command line switches for IceChat in
  your batchfile. Failure to do so will result in IceChat not functioning as
  it is intended. See the section of this doc file for more info on IceChats
  parameters.

5.  Make sure you have changed ALL of the menus you wish to call IceChat from
    and that you have saved the changes.

6.  IceChat also needs to be setup in RACONFIG.EXE so that when you break in to
    chat with a user it calls up IceChat and NOT the internal RemoteAccess chat.
    Change to your RemoteAccess directory and run RACONFIG.EXE

7.  What you do next depends on wether you have registered RA....

    If you HAVE registered, Goto OPTIONS, PAGING and then to 'External'.
    Enter the following command line:

       C:\RA\ICECHAT\IceChat.Exe -F *E *M *!

    If you are NOT running a registered version of RA you will need to setup
    IceChat so that it is called from a Function key, as the above example will
    ONLY work if you have a registered copy of RA. Instead you will need to do
    the following.


                                   -12-








    Goto MANAGER, AltFn Key, and choose a blank entry to install IceChat into.
    We will assume entry 1. Enter the following command line:

       C:\RA\ICECHAT\IceChat.Exe -F *E *M *!

    If you are running an UNREGISTERED copy of RA, and have chosen this second
    example, you will need to call IceChat by pressing Alt-F1 instead of the
    Alt-C command which would be used when it is installed in a REGISTERED
    version.

    These are only an example to get you going... Please refer to the section of
    these docs about 'parameters' to ensure you have the correct command line
    to execute IceChat.

8.  Please make sure that there is a Page.Ice in your BBS System Directory,
    or in your IceChat Directory. IceChat requires this as your page tune. A
    selection of sample page tunes has been included, just rename the tune of
    your choice to Page.Ice.

9.  When you run IceChat, be sure that the IceChat.Cfg file has been created.
    If it has not, then you MUST run ChatCfg.Exe. If you don't, and attempt to
    run IceChat.Exe directly, IceChat will display an error message that
    IceChat.Cfg doesn't exist.



That's all there is to it....



 Please make sure that there is a Page.Ice in your BBS System Directory,
 or in your IceChat Directory. IceChat requires this as your page tune. A
 selection of sample page tunes has been included, just rename the tune of
 your choice to Page.Ice. If you have enabled a seperate tune for VIP users
 the tune you wish to use should be named Vip.Ice and this should also be
 placed in either your system or IceChat directory. BOTH tunes must exist
 for this feature to work, if the Vip.Ice tune does not exist, or cannot be
 located by IceChat the default Page.Ice file will be used instead.


 When you run IceChat, be sure that the IceChat.Cfg file has been created.  If
 it has not, then you MUST run ChatCfg.Exe. If you don't, and attempt to run
 IceChat.Exe directly, IceChat will display an error message that IceChat.Cfg
 doesn't exist.



 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓       Installing IceChat Into SuperBBS v1.1x Systems     ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 Please read the section of this document entitled 'Setting Up IceChat Using
 ChatCfg.Exe' BEFORE attempting to install IceChat into SuperBBS. Failure to
 setup  IceChat  correctly  before  installing it into  your bbs  program will
 probably  result in IceChat failing to run or not running as expected.


                                   -13-









 If you are using SuperBBS, and you wish to take advantage of the added
 features for the SuperBBS Package, you MUST be running SuperBBS 1.15 Or a
 newer version. IceChat's added features will not work properly with versions
 of SuperBBS older than v1.15.

 In order to run IceChat.Exe, you must have a fossil driver active. A fossil
 driver such as BNU should work fine with IceChat. If you do not have a fossil
 driver installed, a simple error message will be displayed, and the program
 will stop.

 **Note** : Do _NOT_ write protect _ANY_ Of the IceChat files, if you do,
        IceChat will ignore them, and therefore not run properly.


 We will now run through EVERYTHING you need to do in order to get IceChat to
 run in your SuperBBS setup.

1.  Extract all the files in the distribution archive to a directory of your
    choice. C:\SBBS\ICECHAT is recommended and is assumed to be the directory
    you are using from now on.

2.  To help IceChat find it's configuration files, you need to define an
    environment variable for it in this manner in your AutoExec.Bat :

    SET ICE={PATH TO ICECHAT DIRECTORY}

    PLEASE NOTE, THE ENVIRONMENT VARIABLE NAME IS ICE  -  NOT ICECHAT !!

    The environment variable is used by IceChat to find its system files
    and configuration. Failure to setup the environment variable can result
    in IceChat failing to run correctly - YOU HAVE BEEN WARNED!

    Please see your DOS manual for more information on environment variables.

  N.B.
    You will need to reboot your machine after entering the environment
    variable for it to take effect.

3.  Run ChatCfg.Exe and configure all of IceChat's options as explained earlier
    in this document. You MUST configure IceChat for it to work correctly!
    Refer to the section of this document for setting up IceChat.

4.  You will now need to edit your .MNU files to include IceChat so that when
    a user pages you it will execute IceChat instead of the internal chat
    routine built into SuperBBS.
    IceChat can be run using either a type 7 or a type 15 menu command. A type
    15 menu will require a batch file that is called to execute IceChat, a type
    7 menu only  needs  to have  the command  line  to execute  IceChat on the
    Optional data line of the menu. See your BBS manual for more information on type 7 and type 15
    menus... Decide which type of menu command (Type 7 or type 15) you wish to
    use and then do ONE of the following depending on which menu type you have
    chosen to use:



                                   -14-







    Type 7 Menu Command:

    Description..: Shell to DOS and run program
               This option is used for starting other pro-
               grams, like doorgames and mailscanners, in
               SuperBBS. It shells to DOS and starts the pro-
               gram given in the optional data field. SuperBBS
               will return to the menu the exit started from.
    Optional data: ProgramName <Parameters>



 Example command lines for Type 7 usage:


   In a single line system, calling the SysOp to chat you may use...

    C:\SBBS\ICECHAT\IceChat.Exe *S *E *!



   In a multi-line system, calling the Sysop may use...
   This example would call the correct node number by using Sbbs's *N parameter.

    C:\SBBS\ICECHAT\IceChat.Exe -*N *S *E *!



   In a single line system, calling CoSysOp #1 (NOT the sysop) you may use...

    C:\SBBS\ICECHAT\IceChat.Exe -A *S *E *!



 The following SuperBBS parameters are used in the above examples:

               *E   Read EXITINFO.BBS when returning to BBS.
                This can be handy if the program used with
                the type 7 exit, changes some of the
                user's data, like a timebank.
               *N   Gives current node number.
               *S   Swap SuperBBS to EMS or disk. If you run a
                program which needs more memory than the
                normal amount available, specify the *S
                option, so SuperBBS will swap itself to
                EMS or, if EMS is not available, to disk.
               *!   Freeze system timer whilst in external
                program.

               Mostly you just use the *E and *S parameters.
               With multi-node operations, you will need the
               *N and *P options.

These are EXAMPLES ONLY, and you should read the section of this manual that
details command line parameters for IceChat for more information.



                                   -15-









    Type 15 Menu Command:

This is similar in usage to a type 7 menu command, but it returns to the batch
file which runs your BBS.  Please see your BBS documentation for more info.

    Description..: Exits to DOS with errorlevel
               Leaves SuperBBS and returns to the batchfile
               which you ran SuperBBS from. There you inter-
               cept the given errorlevel and start an external
               action.
    Optional data: Errorlevel <MenuName>
               The errorlevel will start the action required
               from your batchfile. (Don't use errorlevels
               below 10.)

If you decide to use a Type 15 menu to call IceChat you will need to add IceChat
into your BBS batchfile and call IceChat with the errorlevel you have chosen.

 Example BBS batch file:

            :START
            IF ERRORLEVEL 10 GOTO ICECHAT
            IF ERRORLEVEL  5 GOTO NET&ECHO
            IF ERRORLEVEL  4 GOTO ECHOMAIL
            IF ERRORLEVEL  3 GOTO NETMAIL
            IF ERRORLEVEL  0 GOTO START_UP
            GOTO START_UP

            :ICECHAT
            CD\SBBS\ICECHAT
            ICECHAT.EXE <Don't forget IceChat's parameters!>
            BBS -R
            GOTO AFTER_BBS

           In this  example, a TYPE 15  menu command with an Errorlevel of
           10 will make the batch file  execute the command following  the
           :ICECHAT label. Include  the line "BBS  -R" to  return to
           the board after the external programs have been executed.

 N.B.
  DO NOT FORGET to include the correct command line switches for IceChat in
  your batchfile. Failure to do so will result in IceChat not functioning as
  it is intended. See the section of these docs about IceChats command line
  parameters for more info.


5.  Make sure you have changed ALL of the menus you wish to call IceChat from
    and that you have saved the changes.

6.  IceChat also needs to be setup in CONFIG.EXE so that when you break in to
    chat with a user it calls up IceChat and NOT the internal SuperBBS chat.
    Change to your SuperBBS directory and run CONFIG.EXE

7.  Goto PATHS, and then to 'Ext. chat'. Enter the following command line:


                                   -16-








       C:\SBBS\ICECHAT\IceChat.Exe -F *E *S *!

    This is only an example to get you going... Please refer to the section of
    these docs about 'parameters' to ensure you have the correct command line
    to execute IceChat.


8.  Please make sure that there is a Page.Ice in your BBS System Directory,
    or in your IceChat Directory. IceChat requires this as your page tune. A
    selection of sample page tunes has been included, just rename the tune of
    your choice to Page.Ice.


9.  When you run IceChat, be sure that the IceChat.Cfg file has been created.
    If it has not, then you MUST run ChatCfg.Exe. If you don't, and attempt to
    run IceChat.Exe directly, IceChat will display an error message that
    IceChat.Cfg doesn't exist.



That's all there is to it....




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓     Installing IceChat Into Other Dorinfo1.Def Systems   ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 Please read the section of this document entitled 'Setting Up IceChat Using
 ChatCfg.Exe' BEFORE attempting to install IceChat into your Dorinfo1.Def
 compatible system.

 Your BBS MUST be capable of producing a Dorinfo1.Def drop file for IceChat
 to run correctly. If IceChat fails to find this file it will abort with an
 error message!

 Because of the number of slight differences between various BBS systems it
 is impossible to give a detailed explanation of EXACTLY how to install
 IceChat into any Non RA or SBBS system. However, if you follow the basic
 ideas outlined in the sections of this document about installing IceChat
 into either RA or SBBS it should give you the general layout of what is
 necessary. Please refer also to the documents for your particular BBS
 system for any differences in layout or command line parameters.




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓             Macros In IceChat Configuration              ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

  ** NOTE : All MACROS and the following strings and headers (UserEditor,
  ASCII, Drop To DOS, SysOp Help, Page Reason String, and Paging Header) can
  all make use of built in control strings:


                                   -17-








  @1 = CoSysOp name #1
  @2 = CoSysOp name #2
  @3 = CoSysOp name #3
  @A = SysOp alias
  @B = BBS name
  @C = Chat duration
  @D = Date
  @F = User's first name or alias
  @S = SysOp name (Read From IceChat Configuration)
  @T = Time of day
  @V = Program version number

  The control strings can be used in the following manner. For Example, if you
  were configuring your Page Reason String to ask the user why they are paging,
  you could put:

  @F, Why Would You Like To Chat With The SysOp?

  And then when IceChat is run, and asks the user who is "John Smith" in this
  example to enter a page reason, the @F will be replaced, and the string
  will appear to the user as:

  John, Why Would You Like To Chat With The SysOp?

  All the control strings can be used in a similar manner in all the other
  Strings & Headers, as well as macros.





 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓               BBS System Files Used By IceChat           ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 See also the section on 'Files Created & Used By IceChat' later in these docs.


  When executed, IceChat calls upon the following Files from your BBS System:

      ExitInfo.Bbs   - Read/Write To Exitinfo.BBS, to adjust time limit,
               read in the User's Name, Location, baudrate etc..
               and to indicate the [Wants Chat] at the bottom of the
               SysOp's screen after exiting IceChat. Also accessed
               by IceChat's User Editor.

      Dorinfo1.Def   - Read in user Information


    When using RemoteAccess, IceChat also calls upon the following files as well
    as those above :

      Ra.Log         - IceChat writes out to this file to indicate the User's
               Paging reason (If you set your Logname to your Ra.Log)



                                   -18-







      PageStat.Ra    - IceChat uses this to determine whether or not The
               SysOp has disabled the paging by using ALT-O in
               RemoteAccess. If Paging is set to [OFF] Then no page
               tune will be heard on the Sysops end when the user pages
               This file is only used if it can be found in the System
               directory defined in ChatCfg.


    When using SuperBBS, IceChat calls upon the following files as well as those
    listed at the start of this section :

      Susers.Bbs     - Read/Write To the secondary SuperBBS UserFile. This is
               not a RemoteAccess File, it is only accessed with
               SuperBBS software.

  If you have registered your copy of IceChat, it will also read and/or write
  to the various BBS message base files if you have allowed the user to post
  a message to the SysOp if the chat request is not answered.

  If you are not using RemoteAccess or SuperBBS, the only file that is read
  from is the Dorinfo1.Def BBS drop file.




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓         Parameters Used When Executing IceChat           ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 There are many parameters that can be used for IceChat. They are :


 IceChat.Exe -D:[PATH] This will cause IceChat to use the specified [PATH] to
         locate the dropfiles that IceChat will read in. This is a change
         since the previous versions, which had a limit of ten paths in
         the configuration program. This new change will allow for more than
         10 paths.

 IceChat.Exe -F This will cause IceChat to abort the page reason prompt and
        jump directly into chat mode. This would normally be used when
        the SysOp instigates a chat with a user, OR if you do not want
        IceChat to ask for a reason when paging.

 IceChat.Exe -L This will cause IceChat to run in local/testing mode so that
        the SysOp is able to test it out.

 IceChat.Exe -V This will cause IceChat to run in Vertical Split Screen Chat
        Mode.

 IceChat.Exe -{A/B/C}      This will cause IceChat to change the SysOp name to
               either CoSysOp #1,#2, or #3. Co-SysOps names are


                                   -19-







               defined in ChatCfg.

 IceChat.Exe    This will cause IceChat To wait for the user to enter a page
        reason.  If they are outside of paging hours, a message to that
        effect will be displayed, and they will return to the BBS.

 These parameters may be used in almost any combination when executing IceChat,
 It is IMPORTANT that you select the right parameters for IceChat to run
 correctly, so please read this section carefully and refer to the various
 examples given for setting up your particular BBS in the relevant section of
 these documents.



 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓             Files Created & Used by IceChat              ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

 IceChat creates a number of files for it's own use, these include it's main
 configuration file and macro file etc. There are also a number of ANSI files
 that you can create yourself using an ansi editor (such as TheDraw). These
 ANSI files will be used by IceChat during its operation. See the following
 list for a full rundown on the files that are created and/or used by IceChat.


  !!  ALL of these files MUST reside in the same directory as IceChat.Exe !!

  ───────────
  ICECHAT.CFG
  ───────────

     This files stores IceChat's main configuration. It is created by
     ChatCfg.Exe and MUST be present for IceChat to run.


  ───────────
   MACRO.CFG
  ───────────

    Macro.Ice file is an encoded file that you MUST use ChatCfg to edit. Do NOT
    use a standard text editor. It contains words that will be replaced
    in chat with new words. For Example, if you type "BBS" in chat, it will
    replace it with "Bulletin Board System". These are all SysOp Defined.

  ────────────
   NOPAGE.CFG
  ────────────

    NoPage.Ice file is an encoded file that you MUST use ChatCfg To edit. Do NOT
    user a standard text editor. It contains any names of users that you feel
    shouldn't be allowed to page. When the user enters the page reason, it will
    appear that the music is playing from the remote end, but no page music will
    be heard on the Sysop's end. You do not HAVE to use a NoPage.Cfg, but it is
    always handy to prevent yourself from being annoyed by the constantly paging
    user that every BBS has.



                                   -20-







  ────────────
   RANDOM.CFG
  ────────────

    Random.Cfg file is a text file that you can create. It contains any page
    tunes that you would like to have randomly selected and played everytime
    a user pages. When the user pages, IceChat will read in all of the page
    tunes listed in this file, and will randomly select one to be played.
    Please note, if this file exists, the VIP page tune will not be played
    for VIP users. The Format is simple :

    Page.Ice
    Dallas.Ice
    Dance.Ice
    Axel_F.Ice

    That is a simple example. You do not have to use these particular tunes,
    just replace these names with the page tunes you prefer.  These tunes must
    be in your IceChat directory. If it can't find the random pagetune that it
    selects, it will default to page.Ice. A file containing various page tunes
    is included in the release archive.

  ────────────────────
   PAGE.ICE & VIP.ICE
  ────────────────────

    These are standard RemoteAccess page tunes that IceChat will play while
    paging. Page.Ice is used for normal users, and Vip.Ice is used for VIP
    users. These files must be located in either the IceChat directory or the
    main BBS System directory. These files will not be used if the Random page
    tune function is active.

  ───────────
    VIP.CTL
  ───────────

    Very Important Person TEXTFILE - use a different tune for these Users.
    This file is a simple ascii text file which contains a list of user names
    that will use the Vip.Ice pagetune when they page the SysOp. It's format
    is simple, just enter each user that you wish to use the Vip.Ice pagetune,
    ONE name per line as follows:

    Jeremy Landvoigt
    Eddy Matthews
    Joe Smith
    Dave Jones
    Etc

  ──────────────
   NOTAVAIL.A**
  ──────────────


                                   -21-








    This is an ANSI/ASCII file that can be displayed if the SysOp is unable to
    (or chooses to abort) the users page.  You can create this file using any
    standard ANSI/ASCII editor. It uses the ^A (ASCII CODE 1) as a
    'WAIT FOR C/R' symbol (just like in Remote Access)

  ──────────────
   OUTHOURS.A**
  ──────────────

    This is an ANSI/ASCII file that can be displayed if the user pages
    outside of the SysOp's paging hours.  You can create this file using any
    standard ANSI/ASCII editor. It uses the ^A (ASCII CODE 1) as a
    'WAIT FOR C/R' symbol (just like in Remote Access)
    This file is ONLY Displayed when user pages out of hours and there is NOT
    a defined emergency password.

  ──────────────
   HORIZCHT.ANS
  ──────────────
    The HORIZCHT.ANS and VERTCHT.ANS MUST be in 24x79 format, and they MUST be
    saved in ANIMATED mode in TheDraw. If you dont save them like this, it is
    possible for them to scroll off the bottom of the screen by one line, and
    thus mess up the display. YOU MUST SAVE THEM IN THIS FORMAT TO WORK !!!

    If you create this file, it will be used by IceChat to replace the built
    in Horizontal Chat screen. This file is NOT necessary, but is included
    so that you can make IceChat look like the rest of your BBS setup should
    you wish to. Simply create an ANSI screen using an ansi editor (TheDraw)
    And name it HorizCht.Ans. This file MUST be in the same directory as
    IceChat.Exe. When an ascii user calls IceChat, this file is ignored and
    IceChat will use it's internal ascii chat mode.

  ──────────────
   VERTCHT.ANS
  ──────────────
    The HORIZCHT.ANS and VERTCHT.ANS MUST be in 24x79 format, and they MUST be
    saved in ANIMATED mode in TheDraw. If you dont save them like this, it is
    possible for them to scroll off the bottom of the screen by one line, and
    thus mess up the display. YOU MUST SAVE THEM IN THIS FORMAT TO WORK !!!

    If you create this file, it will be used by IceChat to replace the built
    in Vertical Chat screen. This file is NOT necessary, but is included
    so that you can make IceChat look like the rest of your BBS setup should
    you wish to. Simply create an ANSI screen using an ansi editor (TheDraw)
    And name it VertCht.Ans. This file MUST be in the same directory as
    IceChat.Exe. When an ascii user calls IceChat, this file is ignored and
    IceChat will use it's internal ascii chat mode.

  ──────────────
   MACROHDR.ANS
  ──────────────
    Included in the release archive is an ANSI screen named SAMPLE3.ANS,
    It is used to replace the header at the top of the macro listing feature.
    the screen has to be renamed to MACROHDR.ANS to become active. If this
    screen is not available in your chat directory IceChat will use its built


                                   -22-







    in screens.

  ──────────────
   ICECHAT.KEY
  ──────────────

    This is your registration key that you will recieve after you have
    registered IceChat. It is NOT included in the original archive OR
    generated by IceChat. Once you have registered your copy of IceChat
    it will release the functions that are disabled in the trial version.
    As with all the other files listed here, simply place it in your
    IceChat directory when you register.




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓                Frequently Asked Questions                ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘


Q: Is it possible to run Icechat from RA's external chat feature? I have the
path and filename set correctly, but RA's default chat mode always comes up.

A: This is most likely because your copy of RA is Unregistered. This RA feature
is only available in the registered version. Change from using RA's external
chat routine and use a Function key instead. This is explained in the section
of these docs about installing IceChat into RA.

--

Q: IceChat is ignoring the necessary configuration files that it requires at
startup. What is wrong?

A: There are two possible solutions.  1st: Make sure that none of the IceChat
files are WRITE-PROTECTED. If they are, IceChat will simply ignore them.
2nd : Make sure that you have set up and icechat environment variable. EG.

SET ICE=C:\bbs\doors\chat

This will allow IceChat to find its configuration files no matter where IceChat
is run on the System. Otherwise, it will be necessary to run IceChat from a
batchfile that will CD into Icechats home directory. EG:

@Echo OFF


                                   -23-







Cd \BBS\DOORS\CHAT
ICECHAT.EXE
Cd \BBS\Ra

--

Q: When I try to run IceChat, it gives me a conversion error similar to
"Invalid IceChat.Cfg : Please run v3.10 -> v3.50 converter". What is wrong?

A: This is most likely because you have just recently upgraded to a newer
version of IceChat and not run the conversion utility. The solution would be to
run the Conversion program, or to delete your IceChat.Cfg file and start the
installation from scratch.




 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓                        Registration                      ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

   The Development of IceChat v3.50 took many long hours, and alot of time
   and effort not to mention money. This program is not FreeWare.  If this
   program satisfies your expections of a chat utility, if not MORE, then you
   are expected to register it after an evaluation period of 30 days or
   sooner.  By doing this you can be sure of continued development of the
   software. Thanks for your support.

   This Program may be freely distributed but DO NOT under any circumstances
   change any of the executables or alter any files that come in the original
   distribution archive.

   I urge you to register as soon as you can! The more registrations that
   I have will show the interest of people in the program, and I will release
   a newer version with many more features.  If you register, the IceChat built
   in message editor will be available and the extra Macro editing screens.
   Also, all "Unregistered" messages and almost inaudible beeps within the
   program will be removed.

   If you wish to register, please fill out the registration form :

     Register.Can - Registration Form For Canadian Users
     Register.Aus - Registration Form For Australian Users
     Register.Eur - Registration Form For United Kingdom / Europe
     Register.Wld - For All Other Registrations

   Please at this time send ALL registrations to the address listed in the correct
   registration form. Thank you for your support. If you are interested in
   becoming a Support/Beta Test Site, and there is not one in your area, you
   may file request a Beta Application Form. Information you need :

     FileName : BetaTest.App
     MAGIC    : ICEBETA
     FileSize : 3702 Bytes
     Address  : 1:250/912
     Who      : Anyone can FREQ


                                   -24-







     When     : Can be FREQed at anytime

   Once it is completed correctly, send it to the address listed at the
   end of that file.  You will be contacted if you are accepted as a
   Support/BetaTest site. Please note also, that if you are not accepted, you
   will not be contacted until a time when your help might be required. (If
   I was to call everyone that sent in a Betatest Form my Phone Bill would be
   Sky-Rocketing!)  Any Registration/Betatest forms that have invalid or missing
   information may be considered void and not be processed, depending on the
   extent of the errors.



 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓                       Archive Contents                   ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

    The IceChat archive should contain the following files :

    ICECHAT.EXE         - The Main Program
    CHATCFG.EXE          - Use to configure the program
    ICEPLAY.EXE         - PageTune Player
    310TO350.EXE        - Convert your old IceChat.Cfg with this
    ICECHAT.DOC         - Program Documentation
    WHATSNEW.350        - Changes (Additions/Deletions) in IceChat v3.50
    REGISTER.WLD        - Generic Registration Form
    REGISTER.AUS        - Australian Registration Form
    REGISTER.CAN        - Canadian Registration Form
    REGISTER.EUR        - UK/Europe Registration Form
    PAGE.ICE            - Page Tune
    FILE_ID.DIZ         - General Program Description
    PAGES.ZIP           - A selection of pagetunes
    SAMPLE1.ANS         - Sample Horizontal ANSI screen (rename to HorizCht.Ans
                          to use it). See HorizCht.Ans in the section of these
                          docs on 'Files Used & Created by IceChat' for more
                          info.
    SAMPLE2.ANS         - Sample Vertical ANSI screen (rename to VertCht.Ans to
                          use it). See VertCht.Ans in the section of these docs
                          on 'Files Used & Created by IceChat for more info.
    SAMPLE3.ANS         - Sample Macro Header ANSI screen (must be renamed to
                          MacroHdr.Ans to be used). See MacroHdr.Ans in the
                          'Files Used & Created by IceChat' section for more
                          info.

    If one or any combination of these files are missing, or files have been
    ADDED, then you are using a possibly modified or altered copy of ICECHAT.
    It would be advised that you delete this copy, and get a clean copy of
    ICECHAT from one of the BBS's listed at the end of the documentation.
    Newest Version of IceChat can be F'REQed from Ice Technologies BBS under
    the magic name 'ICECHAT' (Without the quotes)

    Files IceChat will create are :

    ICECHAT.CFG         - The configuration file
    MACRO.CFG           - Encrypted Macro File
    NOPAGE.CFG          - List of TWIT users who may not page


                                   -25-







    ICECHAT.LOG         - Usage Log (Can be configured to be appended to your
              BBS system log)



 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓           CopyRight Notices & Program Disclaimer         ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

    The door IceChat, along with all its support files and documents,
    are Copyright (C) 1993 Jeremy Landvoigt.  Distributing a version
    AFTER it has been registered is prohibited;  distribution of the
    original, unaltered version is permitted, indeed encouraged, as long
    as all support-files and documentation accompany the program are
    included WITHOUT ALTERATION OF ANY SORT.

    The author can be quickly reached for information through the RA_UTIL
    international FidoNET Conference.  If you wish to trust
    comments/complaints/suggestions to the Post Office, you can send them to:

            Jeremy Landvoigt
            100 Burling Place
            Newmarket, Ontario
            L3Y - 5W4
            Canada

    The following programs mentioned in this documentation are Copyright of
    their respective authors. They are listed in no particular order:

    IceChat      - CopyRight Jeremy Landvoigt
    RemoteAccess - CopyRight Wantree Development & Andrew Milner
    SuperBBS     - CopyRight Aki Antman & Risto Virkkala
    X00          - CopyRight Raymond L. Gwinn
    BNU          - CopyRight David Nugent and Unique Computing Pty Limited
    FKFossil     - CopyRight Tim Strike and Forbidden Knights Systems
    Turbo Pascal - CopyRight Borland International


    THE USUAL LEGALITIES

    I (Jeremy Landvoigt) make no warranty of any kind, expressed or implied,
    including without limitation any warranties of merchantability
    and/or fitness for a particular purpose.  I shall not be held liable
    for any damages, whether direct, indirect, special or consequential
    arising from the failure of this program to operate in the manner desired
    by the user.  I shall not be held liable for any damage to data or
    property which may be caused directly or indirectly by the use of this
    program.

    In no event will I be held liable for any damages, including (but
    not limited to) any lost profits, lost savings, or other incidental
    or consequential damages arising out of the use -- or the inability
    to use -- this program, or for any claim by any other party.




                                   -26-








 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓                          Credits                         ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

   There are a few people who helped with the development of IceChat that
   although they weren't involved in the creation or writing of the program,
   their suggestions, Bug reports, and lengthy ßeta testing have been an
   enormous asset. I would like to thank in no particular order :
   Bill Dykstra, Danny Dufour, Adam Roycraft, Marcus Limosani, Eddy Matthews,
   Marc Kulak, Max Quagliotto, Bob Miedema, Tom Harvey, Jim Edwards and
   Steve Lanning for all of their help. Couldn't have done it without them!

   Also, portions of the Fossil Routines used in IceChat v3.50 are Copyright
   1993 By Tim Strike and Forbidden Knights Systems.



 ┌────────────────────────────────────────────────────────────────────────────┐
 │░░░▒▒▒▓▓▓             Program Support - BBS Locations              ▓▓▓▒▒▒░░░│
 └────────────────────────────────────────────────────────────────────────────┘

  IceChat can be File Requested from any of the following BBS's under the magic
  name of ICECHAT.  1200-14400 Baud Rates Supported.

  Legend
  ──────

  S - Support Site   B - Beta Site   R - Registration Site   D - Distrib. Site
  L - Up To 2400 Bps H - Up To 14.4k Bps

  BBSName              Location        Phone            FidoNET      Flags
  ─────────────────────────────────────────────────────────────────────────────

* Ice Technologies     ON, Canada      [phone]   1:250/912    S B R D H
  Blue iCE Beta Labs   TX, USA         [phone]   1:130/1016   S     D H
  Decker's BBS         WI, USA         [phone]   1:2300/15    S B   D H
  GeNNeXXuS            NSW, Australia  61-2-725-3541    3:713/611    S     D H
  Infinity Links       Vic, Australia  61-3-850-9115    3:633/262    S B R D H
  InfoSoft BBS         Cleveland, UK   44-642-764245    2:252/51     S B R D H
                       (21:00-08:00 GMT Only!)
  Adventurer's Inn     SC, USA         [phone]   1:372/6577   S B   D H














                                   -27-