Name: MN.L010 Purpose: Create Chronological Caller Log Author: Dick Pope Date: November 23, 1994 Synopsis: --------- Some sysops and users prefer a useable caller log accessible through the the BBS. This program hopefully remedies that need. Description: ------------ MN.L010 will read the MEBBSNet log file(s) (MEBBSNETx.LOG) as indicated in the configuration file. It will create a file (as specified in the config file). This file can be viewed through a menu item using the SHOWFILE function. I would suggest that it be run periodically through use of a cron utility. The MEBBSNet log file is copied to a ram file (RAM:LOGFILE) to minimize possible contention if users are online. Requirements: ------------- A file called MN.L010.cfg (sample included) must be in the ConfigFiles directory of MEBBSNet. This can be changed by changing the "cfgpath" variable near the top of the program. In addition, you may specify a different configuration when the program is initiated. For example: rx MN.L010 BBS:altcfg.file would invoke this program using "BBS.altcfg.file" as your configuration file. This should make it easier to run this program more than once (e.g., for each active line). This program calls the AmigaDos copy, sort and delete routines. The MEBBSNet.con file is also accessed. It accesses the copy in your MEBBSNet: directory. This may be changed in the program through a variable called "conpath" near the top of the program. The file is accessed to find the main BBS path (to determine where to find the configuration file) and to determine the text files path (to provide a default directory for resulting aller log files). The configuration file allows you to invoke automatic trimming of your log file. It produces a script in your "s:" directory called "TrimFile.scr", which uses Matt Dillon's TRIMFILE utility. This script can then be automatically executed through a cron utility. The placement and name of this file is controlled by a variable called "trimfile" near the top of the program. Configuration: -------------- There are 5 parameters that can be set. These are in a text file using a key word to identify each. These are: 1. Nodes: Specifies the nodes you wish to be included in the caller log. The default is to include Node 1. If you, for example, wished to include nodes 1 and 3, this parameter would be specified as NODES=13. 2. Caller File: Output of the program goes to this file. It is set by using the FILE= parameter. The full path must be specified. If not present, the default is CALLER.TXT in your Text Files directory. You need not specify the extension. If present, it will be stripped. The default is for an extension of ".txt" for GRAPHICS=NO and for two files, one with a ".txt" extension and one with a ".gr1" extension if you specify GRAPHICS=YES. 3. Log Limit: Specifies the maximum number of days to be used in the caller log. You specify a limit for each node listed in the NODE= parameter. For example, LIMIT=20/30/ given the above NODES= parameter would include the most current 20 days for node 1 and the most current 30 days for node 3. The limits MUST be separated with a "/". If there is no ending "/", the program will append one automatically. The default limit is 10 days for all nodes. 4. Trim: The MEBBSNet log continues to grow indefinitely. This option allows you to create a script to call Matt Dillon's TRIMFILE program that is distributed with his implementation of UUCP. MN.L010 keeps track of how many records are needed to meet the limit specified above. The script will trim records off the front of the file(s) specified in (1) and (3) above to keep it to a manageable size. This parameter is specified using the TRIM= option. The default is NO. Specifying YES will cause a TRIMFLx.scr script to be placed in your "MEBBSNet:s" directory. One TRIMFL.scr script will be created for each line specified in the NODES= parameter. 5. ANSI Log: The GRAPHICS= parameter permits you to create standard ASCII or ANSI caller log files. If NO is specified, only an ASCII file is produced. If YES is specified, both an ASCII and an ANSI caller log are produced. These parameters may be specified in any order. History: -------- v4.10 23-Nov-94 Converted for MEBBSNet v0.160 v4.00 12-Dec-93 Converted to MEBBSNet v3.02 21-Nov-92 Modified to handle 5-character baud rates v3.00 17-Dec-91 Converted to StarNet. ANSI option added. v2.10 21-Nov-91 Line number added to caller log v2.02 13-Nov-91 Conversion to ARexx caused Fidonet calls to not be included, regardless of the FIDO= parameter. Wazoo name was added. You may now also specify an alternate configuration file name when the program is invoked. v2.01 20-Oct-91 Log entries scrambled because of line noise caused program to fail. Corrected (hopefully). v2.00 07-Oct-91 Converted to ARexx v1.32 27-Dec-90 LoTek FidoNet sessions added to log. In addition, Fido transfers were added as uploads/downloads. v1.31 03-Dec-90 v2.08r disables CTRL-C. ~vp added to correct. v1.30 19-Nov-90 Fido session included in log. Log limit raised to 400. v1.24 01-Sep-90 Descriptions for certain uploads were being treated as downloads. Problem was corrected. v1.23 19-Aug-90 For posting of messages, program hunted for the string "POST" and therefore counted "POST-DOWNLOAD DISCONNECT" as if a message were posted. Problem was corrected. v1.22 19-Aug-90 Error on file integrity check record corrected. Error log extended to provide more information. v1.21 17-Aug-90 Add page break after daily totals. v1.20 15-Aug-90 Automatic trimming of log file added to configuration. First release without compiled code. AC/Basic is, at best, flaky when running automatically with DCRON. v1.10 13-Aug-90 Daily totals of calls, messages, uploads and downloads added. v1.03 11-Aug-90 Crashes caused by AC/Basic read of Paragon log file while Paragon attempted a write to the log file corrected by copying log to Ram and running from Ram. v1.02 08-Aug-90 Error in print format when # of calls exceeded limit. v1.01 05-Aug-90 Error in calculation of time used fixed. End of file problem corrected to not list last user if still online. v1.00 04-Aug-90 Original program completed Further Information: -------------------- Contact: Dick Pope 2809 Watson St. Opelika, AL 36801 InterNet: poperic@mail.auburn.edu Fidonet: 1:3613/3.0 BBS: Sysop, SmorgasBoard 205-745-3989 (19.2K USR v.32bis terbo) Distribution: ------------- This program may be freely redistributed. This documentation file must accompany any distribution. Copyright (c) 1990, 1991, 1993, 1994 Richard Pope. All Rights Reserved.