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

Function:  Last X Callers 3.x: display/logger program for CNet 2.63+
             (formerly called LastTenCallers.rexx)

By:        Ignus Fast of Surface Normal (209)725-2623,,,22222222    30 Jan '94

Features:  Enters Logins immediately, so a crash won't erase evidence
             of a users call...
           Displays a large amount of info about each call...
           Adds data in two phases so that an online users call will
             be retained if the computer GURU's.  (as a > char)...
           Allows the option to ignore ONE user level... or even individual
             account numbers!
           Displays from 1 to the last 9999 callers...
           Will optionally not log the sysop...

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

Installation:

     Step 1:  Add to Sys.Welcome as:
                {#0pfiles:LastXCallers.rexx}  (where {==Control-Q)
                (optionally followed  by Press [ENTER]{G32} as a pause)

     NOTE!      If you don't wish to force the users to look at the log upon
                logon, you need to add the keyword 'update' to the program...
                YOU MUST STILL CALL IT FROM SYS.WELCOME!  If called with the
                argument 'update', it will update the log with no diplay.
                If you fail to call it at logon, NO CALLERS WILL BE LOGGED!
                      In this case it would look like this:
                {#0pfiles:LastXCallers.rexx update}

     Step 2:  Find the words "Lost Carrier" in the BBSTEXT file
              (Line 80 for Cnet 3.x, maybe for earlier versions also)
                insert at the beginning of this line:
                {#0pfiles:LastXCallers.rexx dropped}

     Step 2:  Find the words "Logoff complete" in the BBSTEXT file
              (line 99 for CNet 3.x, maybe for earlier versions also)
                insert at the beginning of this line:
                {#0pfiles:LastXCallers.rexx logoff}

Optional:     To add as a GFile or PFile, add as an AREXX file:
                FileName:     Pfiles:LastXCallers.rexx
                Description:  Examine the Last X Callers Log
****            Arguments:    view
               (It will then run as display ONLY and not update the log)

****  Argument has CHANGED since version 3.1!!!  Change from DISPLAY to VIEW!

     To change the number of callers to log, the logging access, or the path
  of the log file, you may edit the LastXCallers.rexx program with a text
  editor!

****************--------------------------------------------------------------
     Please ensure that if you wish to change either the account levels OR
the account numbers to be logged/ignored, that you enter them in a line (no
wildcards accepted) seperated by a space.  For example, if you wanted to
NOT log account levels 3, 19, and 31, and also not log account numbers 1,
20, 35, 99, and 987, the lines would look like this:

ac="3 19 31"                   /* Levels to Ignore 0 to 31 or "" to disable */
uc="35 20 1 99 987"            /* User account #'s to ignore   (see docs)   */

     As you can see, each entry MUST be seperated by a space, though their
order does not matter.  As of this version you still cannot say 1-12 for 1
through 12, but I may include that in a later revision.
****************--------------------------------------------------------------

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

  *  NEW FEATURES/Updates/Bug fixes/etc...

update 3.1
5 Feb 1994 -- Scans your BBSMENU file for computer types, and shows the user's
              computer type in the callers log!  Had to chop some of the other
              fields short, but...  Nothing~=Something...  You know. (?)
           -- BBSMENU scanned daily, so if you add/change computer types,
              it'll catch up the next day automatically...
           -- Found out it was keeping one too many callers, though it never
              displayed the extra one...  (fixed)
           -- Moved the getlog/putlog routines so displaying is much faster
              than before
           -- Sorry- still only ignores one access level...  working on it!
update 3.2
6 Feb 1994 -- Added a dropped carrier function!  If the user drops carrier,
              a minus sign '-' is placed before their name...  All other info
              is now updated correctly like a normal logoff...
           -- Cleaned up some of the code for better speed under some
              circumstances.
           -- Changed the DISPLAY keyword to VIEW to allow use of a DROPPED
              argument for dropped carrier and also to better standardize
              my own arguments (This is the same as in IgReg.rexx...)
update 3.3
8 Feb 1994 -- Finally added ability to ignore more than one access level!  To
              use, just enclose the access levels you don't want logged in the
              quotes, with each level seperated BY A SPACE!
              To disable, use 99.  You CANNOT use arguments such as '-' for a
              range of numbers...  each level must be entered separately.
update 3.4
11 Mar '94 -- Sorry- some people's BBSMENU files used TAB as the character
              preceeding each computer type, and I never checked for that!
              Fixed in this version- should now read comp. types correctly...
update 3.5
1 July '94 -- Minor cosmetic updates
update 3.6
13 Jul '94 -- Added a user account number to ignore...  Just as with the
              access level ignore feature, this requires one entry per
              number, with each seperated by a space.  As you can see, this
              doesn't allow for a huge number of account to be ignored,
              but...
           -- Parses user actions better; doesn't mistake them as often.  I
              should have caught this some time ago, but you know how it
              goes...
update 3.7
26 Jul '94 -- Added a simple file-lock routine due to reported crashes on
              multi-line systems with simultaneous accesses of LastX.
update 3.8
26 Sept 94 -- Added a toggle to display either the actual time of logoff or
              the number of minutes the user was online...  Good for people
              too lazy to do the math.  Added by request.
update 3.9
07 Oct '94 -- Added a toggle to use either 12 hour (AM/PM) or 24 hour time...
              This forced me to cut down the Handle field to 14 characters
              instead of 16, but I don't think it detracts from the program.
revision 4.00
12 Oct '94 -- Changed the date column; the year was really not needed, and I
              like this date/month format better... it also only displays the
              date when it changes between calls, which looks neater.
           -- Changed format of the baud field for 28.8 Kbaud modems...
           -- Eliminated the Feedback action; compressed the Post and Respond
              actions into one general action called Post...
           -- Cleaned up the Logon/off time fields (right justified looks
              better to me...)
update 4.10
15 Oct '94 -- Added a toggle which displays the users account level after their
              name - added by request from The Baron...
           -- You will again need to delete your old log file; it won't mess
              anything up if you don't, but I added a data field to the file
              and the display'll look REALLY screwed up if you don't!
------------------------------------------------------------------------------

                                             Ignus Fast/Stan Smith
                                             Surface Normal BBS
                                             1(209)725-2623,,,22222222
                                             FIDO -- 1:208/602.0
