       ܲ  ܲ 
  ۲  ߲ ߲߲߲ ߲߲ ߲
 ۲                                                                    ߲
۲                             DCTCall v0.05                              
                       For RemoteAccess 2.0x or 2.5x                      
                            By Dan Traczynski                             
                              May 26, 1996.                               
                                                                           
        Copyright (C) 1995..1996 Dan Traczynski.  All rights reserved.

 ܲ  ܲ ܲܲܲܲ
    ߲ ߲߲߲ܱ


   This package contains two utilities, one a door which displays a "Today's
Callers" listing to your users, and the other a simple utility to edit your
LASTCALL.BBS file.  The program will work with RemoteAccess 2.0x and 2.5x.


            ܲ  ܲ          ܲ    ܲ  ܲ
        ܲ۰۱߱۰۲ܱ߱۰۰۲۱߱۰۱ܲ
           ߱ ߲   ߲     ߲߲     ߲ ߲

                            TaBLe oF CoNTeNTS
                          

               Features ................................... o1
               Installation ............................... o2
               Customization .............................. o3
               SysOp Hotkeys .............................. o4
               The LASTCALL.BBS editor .................... o5
               Distribution & Disclaimer .................. o6
               Credits/Acknowledgments .................... o7
               History - Notes from the Past .............. o8



              ܲ  ܲ    ܲ        ܲ  ܲ 
          ܲܰ۰ܱ۰۱۰۲ܱ߱۰۱۱۱۱۰۰߱۲ܲ
           ߱ ߲   ߲     ߲߲     ߲ 

                    SeCTioN o1  Features of DCTCall
                  

              Supports both RA 2.0x and 2.5x.
              Fully customizable.
              ANSI and ASCII support.
              Can list only the last x callers.
              Fast & easy setup.
              User time-out after 120 seconds.
              Multinode capable.
              Multi-tasker capability.
              Internal SysOp-User chat mode.
              Carrier detect.
              Includes a utility to edit your last callers list.
              It's FREEWARE!


            ܲ  ܲ          ܲ    ܲ  ܲ
        ܲ۰۱߱۰۲ܱ߱۰۰۲۱߱۰۱ܲ
           ߱ ߲   ߲     ߲߲     ߲ ߲

                       SeCTioN o2  Installation
                     

   If you are upgrading DCTCall from v0.04, simply overwrite the old .EXE
files with the new ones.  There were no data file changes.  If you are
upgrading from a version prior to v0.04, it would probably be best to simply
delete all of the old files and re-install the new version.

   Before installing DCTCall, create a separate directory for it and move the
files there.  To create the configuration file, run CONFIG.EXE and configure
it to your system.  Once completed, create a type 7 option from RA and use
a command-line similar to "C:\RA\DOORS\DCTCALL\DCTCALL.EXE /PC:\RA".  Memory
swapping should not be required.

   The "/P" parameter specifies the directory where the drop file may be
found.  An optional "/Zx" parameter may also be used which will have DCTCall
list only the last x callers.  Simply specify something like "/Z10" to list
the last 10 callers or whatever number you wish.  LASTCALL.BBS will be found
using your RA environment variable.  Be sure to check out SAMPLES.ZIP as you
may wish to use a different listing style than the default one (or create your
own).


              ܲ  ܲ    ܲ        ܲ  ܲ 
          ܲܰ۰ܱ۰۱۰۲ܱ߱۰۱۱۱۱۰۰߱۲ܲ
           ߱ ߲   ߲     ߲߲     ߲ 

                       SeCTioN o3  Customization
                     

   To customize the format and colours of DCTCall, you must edit the
DCTCALL.STL file, which is divided into a few different sections.  The first
one is the "declaration" part, which tells DCTCall what the pause prompt
should look like and some other information.  Valid declarations are shown
below.

 NewColour <n>          This states what colour new users are to be displayed
                        in when showing how many calls they made.  Valid
                        range is 1 to 15.

 PausePrompt <String>   Use this statement to set what your pause prompt at
                        the end of each screen should look like.  If no pause
                        prompt is declared, the internal animated one will be
                        used.

 NoBanner               This simply disables showing the copyright info line
                        at the bottom of each page (instead it is displayed
                        when the program terminates ;).

   Once you have completed this part, you must make the "header" section which
is what is displayed at the top of the screen above the listing.  Simply add
the word "Header", then insert the lines containing the header below it.  An
example is shown at the end of this chapter.

   Once you have designed your header, you must create the body of the
listing, which is referred to by the keyword "Main".  This is the actual
list format that will be used.  Imbedded codes are to be used in this section
to display the caller's name, baud rate, etc.  Refer to the table below for a
list of available codes in this section.

        List of imbedded codes
   --------------------------------
     %B         Baud
     %Cx      ~ Calls
     %Nxx     ~ Name
     %1A        Time On, hours
     %1B        Time On, minutes
     %2A        Time Off, hours
     %2B        Time Off, minutes
     %Tx      ~ Time spent online
     %Lxx     ~ Location
     %Ox      ~ Node
     %#         Caller Number

~ The "x" or "xx" in these codes are the length that the field should be when
  printed on the screen.  Therefore a "%N30" would display the user's name
  with spacebar padding to make it 30 characters.  The rest of the fields are
  always of a fixed length.

   To wrap up the design, a footer section is to be created.  It is basically
what is displayed at the bottom of the screen after the users have been
listed.  An example follows.

[ Sample DCTCALL.STL ]
NewColour 15
PausePrompt [PauSeD]
NoBanner
Header
-------------------------------------------------------------------------
Name                         Login Logout Location                   Baud
---------------------------- ----- ------ -------------------------- ----
Main
%N28 %1A:%1B %2A:%2B  %L26 %B
Footer
-------------------------------------------------------------------------


This design would translate to something like:


-------------------------------------------------------------------------
Name                         Login Logout Location                   Baud
---------------------------- ----- ------ -------------------------- ----
Dan Traczynski               12:07 12:47  Vancouver, B.C.            28.8
System Operator              12:49 13:04  Vancouver, B.C.            None
-------------------------------------------------------------------------

[PauSeD]


   Of course you are free to add ANSI codes to this and it will work just as
well.  Please see the examples in the archive SAMPLES.ZIP for more help on
designing your own styles.


            ܲ  ܲ          ܲ    ܲ  ܲ
        ܲ۰۱߱۰۲ܱ߱۰۰۲۱߱۰۱ܲ
           ߱ ߲   ߲     ߲߲     ߲ ߲

                       SeCTioN o4  SySop Hotkeys
                     

           F1    Shows the Sysop keys on the status bar.
           AltC Invokes the chat mode.
           AltT "Twit user".  Returns the user back to the BBS.
           PgUp  Adds 5 minutes to the user's time.
           PgDn  Subtracts 5 minutes from the user's time.


              ܲ  ܲ    ܲ        ܲ  ܲ 
          ܲܰ۰ܱ۰۱۰۲ܱ߱۰۱۱۱۱۰۰߱۲ܲ
           ߱ ߲   ߲     ߲߲     ߲ 

               SeCTioN o5  Editing Your LastCall.BBS File
             

   I have included a utility in this package which allows you to edit the
LASTCALL.BBS file, therefore allowing you to edit who called that day.  I
suppose that the only possible use for it would be if you had unwanted users
abusing your BBS and creating bogus accounts, you could use the utility to
easily delete these entries from the caller file.  Or you may just want to
see who called that day without entering the BBS - it can be used for that as
well.  The program is quite easy to use, so I doubt anyone would encounter
any problems when using it.  The only point to mention is that if EDITCALL.EXE
can't find your LASTCALL.BBS file it means that you haven't set your RA
environment variable.


            ܲ  ܲ          ܲ    ܲ  ܲ
        ܲ۰۱߱۰۲ܱ߱۰۰۲۱߱۰۱ܲ
           ߱ ߲   ߲     ߲߲     ߲ ߲

                 SeCTioN o6  Distribution & Disclaimer
               

   DCTCall is copyrighted (C) 1995, 1996 by Dan Traczynski.  All Rights
Reserved.  I encourage you to distribute it, but DO NOT by any means change
any of the files within the original archive.  The archive should be named
DCTCL005.ZIP, preferably kept in its ZIP format.

   The author, Daniel Traczynski, will take no responsibility should any
unintended results occur to your system while using this program.  Although
this program has been tested thoroughly, no guarantee can be given that it
will do what it was made to do.  Nevertheless, if anything should happen, the
user is totally responsible and the author will be under no obligations
whatsoever.  By using this program you agree to this disclaimer.


              ܲ  ܲ    ܲ        ܲ  ܲ 
          ܲܰ۰ܱ۰۱۰۲ܱ߱۰۱۱۱۱۰۰߱۲ܲ
           ߱ ߲   ߲     ߲߲     ߲ 

                  SeCTioN o7  Credits/Acknowledgments
                

-Well I'd like to thank Alan Ianson (BBS: 604-251-1817) for his support of all
 my programs; without him my software wouldn't have been hatched into the
 RADist network.  His FidoNet node number is 1:153/757 in case you would like
 to FREQ any programs from him.
-Steve Lorenz for DDPlus.
-Chronos on Rogue's Inn BBS for eta testing the program for me back when it
 was only a eta 1.  Too bad his board went down.
-Garfield on Neural Meltdown BBS (604-255-5198) for his eta testing.


            ܲ  ܲ          ܲ    ܲ  ܲ
        ܲ۰۱߱۰۲ܱ߱۰۰۲۱߱۰۱ܲ
           ߱ ߲   ߲     ߲߲     ߲ ߲

                      SeCTioN o8  Program History
                    

v0.05 - May 26, 1996.

This is the first public release of DCTCall to RADist.

-Added the animated pause prompt.
-Fixed a bug in style #5.
-Added the %T macro (shows how many minutes the user spent online).
-EditCall.Exe would not let you change the time on and time off fields.
 Fixed.
-Modified sample styles #1 and #4 so they would use the new macro that
 displays the minutes the user spent online.
-If the user had ASCII and a new user (someone with 1 call to the system) was
 in the caller list, DCTCall would send ANSI codes across the modem.  This
 is fixed (thanks Alan, I never would have found this!).
-Improved EditCall.Exe.
-Replaced style #2 with a new design.
-Added a 120 second user timeout.
-Fixed up the colour configuration in CONFIG.EXE.


v0.04 - March 13, 1996.

-Added listing style #5.
-The "Paused" prompt may now be configured.
-DCTCall can now be configured to list only the last x callers.
-Fixed the colour of the "New" string in the number of calls for good this
 time.
-Added the configuration program.
-Added colour configuration.
-Rewrote the documentation.
-Added the LASTCALL.BBS editor.


v0.03 - February 5, 1996.

Well it's been a while, but I finally decided to finish off this new version.
As soon as I'm sure that it's bug-free, I'll make a public release of it in
RADist.

-Fixed a bug where the caller number wasn't being sent over the modem and
 would only display locally.  This was a really stupid mistake, but the
 program works fine now.
-Fixed a bug in the "Returning to BBS" display on the remote end when the
 listing was completed.
-Fixed a bug where if the caller had 0 calls the colour would screw up (but
 it's impossible to have 0 calls unless the SysOp edits the user).
-DCTCall now displays 31200 and 33600 baud as RA 2.50 now supports these.
-If you had the status bar turned off and hit F1 to display the help, it
 would go back on.  Fixed.
-You can now keep DCTCALL in its own directory rather than RA's and it will
 still function correctly (simply use "C:\BBS\DOORS\DCTCALL\DCTCALL.EXE" as
 the command line).  LASTCALL.BBS must be in the current directory though.


v0.02 - December 31, 1995.

This is the first "public" release.  Here's a list of bug fixes and changes
from the earlier eta version..

-Configuration!  You can design your own listing format!
-Added file-locking so now multi-line BBSs can use DCTCall too ;)
-DCTCall now has full ANSI and ASCII support.
-The colours were changed a bit so they're brighter...people complain that
 my designs are always so dull.
-The program should should run a bit faster now.
-The program now calls its configuration files from the directory that it
 resides in rather than the current directory (well it still checks the
 current dir, but will check its home directory if they're not in the current
 one).

eta 1 - October 7, 1995.

Initial creation.  Not too many configuration options or anything.


 ܲ  ܲ ܲܲܲܲ
    ߲ ߲߲߲ܱ
                                    {EoF}
