Monster Media 1994 #1/monster.zip/monster/TRIBBS/HDUTL52A.ZIP/HDUTL.NEW

Text File | 1994-01-28 | 20KB | 463 lines

                         Heavy Duty Utility
                          By H.D. Holland
                        From: HD's Support BBS
                           [phone]
                           [phone]

                           V5.02a 02/01/94

          PLEASE READ THE INSTRUCTIONS FOR INSTALLATION/UPGRADE.

UPGRADE 07

1. When the /U, upload verify option is used, new uploads are added to
the .IDX files (if used). There is no need to run MAKEIDX now after an
upload.

2. Change in the handling of the KEY file (just to keep the hackers on
their toes).

3. HDUTL now builds only .BBS screens using @Xcodes for colors. With the
improved handling of the codes by TriBBS, the .ANS screens are no longer
needed.

4. Change in name of program to remove any conflict with Mark's registered
'Tri' trademark. (No! there was no problem, I just wanted to avoid one.)

INSTALLATION: Rename all THDUTL.* files in the \UTL directory to HDUTL.*.
Change your BETWEEN.BAT to reflect HDUTL. If you are a registered user,
call the Support BBS and pick up a new HDUTL.KEY, use the temporary key
provided until then. Expand HDUTL.EXE, HDUTL.CLR (and HDUTL.KEY) into the
\UTL directory. You should be ready to go, run HDUTL /N to rebuild new
screens.

UPGRADE 06

1. Correct handling of DEADFILE, file listings. They will now be added
to the FILES.LST in \DEADFILE vice overwriting the existing FILES.LST.

2. Add Subscription notification and trial subscription functions. If
file HDUTL.SUB exist, new callers will be given a trial subscription
of xx days and users whose subscription will expire in yy days will be
given a notification in the form of a user specific logon message. Build
HDUTL.SUB as follows:

xx,yy
@X04 Text to be placed in the user specific logon message, any length.

xx = trial subscription length in days, 0 = none
yy = days before expiration that the notifications will start.


UPGRADE 05

1. FINALLY! Found a routine that will compute the number of days between
two different dates without 10K of code or strange errors! (I read the
durn documentation for PDS 7.1 :-) ) No more strange outputs in the Hourly
Usage Graphs.

UPGRADE 04

1. Add an /N switch to simply rebuild all the screens with the data stored
in the various support files. As all the files are straight ASCII, they may
be edited to add/subtract or correct information contained within them. You
may then run HDUTL /N to rebuild the screens with the edited data.

2. Extract the data from the affected FILES.LST for files failing integrity
or virus scan and place the data in the FILES.LST in the DEADFILE area if
DEADFILE is indicated with the /U switch. e.g. /UC:\DEADFILE.

UPGRADE 03

NOTE: Upgrade Action required on this item:
1. Extend the range of variable for those control freaks who maintain 2 to
3 years of CALLERS.LOG. :)  Dates indicated in the Tally and the BBS Usage
Graph are now in MM-DD-YY format. You may 1). Edit your HDUTL.TIM file and
add "-YY" (YY = the start year of your CALLERS.LOG) to the end of the date
line (second element in the tile) and do the same to the first line of the
HDUTL.DOR file, or; 2). Rerun HDUTL /F to build new files and screens.


UPGRADE 02

1. FIX FOR YEAR END SORT PROBLEM. Extended the sort routine input to
include the year so we don't have problems on January 01 each year with
the last 15 callers screen. We will still have a problem on January, 01
2000. If I am still alive, give me a call, otherwise you best remember
to delete your CALLERS.LOG on that day and start a fresh set of screens.

NOTE: Upgrade Action required on this item:
2. Add node # to the last 15 caller screen (far right side) at the expense
of the year of the logon (we can probably figure that out). :) This change
adds an additional item to the HDUTL.WRK file and makes your old one
incpmpatable. You must run HDUTL /F to recompile the files. ALTERNATELY,
you may edit HDUTL.WRK adding ONE blank line JUST BEFORE every user name
in the list EXCEPT the first one (which will be the second line of the file).
The first line in the file is the pointer into CALLERS.LOG, the second line
is a user name, the next 9 refer to that user (old file), the next 10 now
refer to the user (new file). Be sure to add a blank line at the very end
of the file also (for the bottom user).

UPGRADE 01

NOTE: Upgrade Action required on this item:
1. Added a start date to the HDUTL.TIM file. It previously used the start
date of the HDUTL.DOR file, however; when you changed the number of doors
in your DOORS.MNU, the date reverted to the current date, causing a
Situation 6 in Process 12 error when the BBS Usage Graph was constructed.
EDIT YOUR HDUTL.TIM FILE AND ADD A DATE BETWEEN THE FIRST AND SECOND LINES
OF NUMBERS IN THE FORMAT mm-dd (e.g. 12-25). The date reflects the date
when the Usage graph was first started with it's current values. OR,,,,,
rerun HDUTL /F and rebuild all the files and screens.

2. More thorough checking of uploads for imbedded archive files (within an
archive) is performed. Internal archives are extracted and repacked into
the default archive unless the /SP (Skip rePack) switch is used. Tradeoff:
If internal archives are repacked, the original archive must also be
repacked to include them. Any volume labels or path data will be lost (I
haven't gotten that good yet).

3. The filesize of the repacked archive is updated to the ACTUAL size vice
an estimation as used previously.

4. File date stamping in the FILES.LST. The oldest date found in an
uploaded archive, or the actual file date of an uploaded file will be
indicated at the end of the 'Uploaded By' line in mm-dd-yy format.

5. For you dropped carrier watchers, build a file named HDUTL.DRP and
place it in the \UTL directory. It can be either ANSI or ASCII and should
contain your comment to those users who tend to drop carrier without first
signing off the BBS (Use the @X color codes for best results). When HDUTL
finds a user who has dropped carrier, HDUTL.DRP is copied to ##.BBS (user
specific logon screen) to welcome them on their next call. Only one screen
is made and given the .BBS extension so it will always be displayed.
Additionally, in order to keep the amount of code down, I hinged the
function off of the /R (Real name) routine. In order to use it you must
include the /R switch in your BETWEEN.BAT call to HDUTL. (Note I have NOT
tested this feature thoroughly, let me know if there are any problems). The
function is only called for normal runs and is not called by the /F switch.
(e.g. you can't go back and build several display screens for past
offenses) :) Oh yeah, the ##.BBS file is KILLED the next time the same
caller is noted by HDUTL so it doesn't hang around forever.

6. The exit ERRORLEVEL function now indicates whether an upload occurred or
not. An ERRORLEVEL of 1 is returned when upolad(s) were found.

7. Add a deadfile path to the /U switch. If you want files which failed
integrity or virus scanning to be retained, add a path to the /U switch
e.g.  /UC:\TRIBBS\DEADFILE. All files failing /U validity checks will be
copied to this directory and deleted from the upload directory.


                           V5.01 93/12/24

1. Revamp the BBS Tally and Hourly usage graph screens to make them
more useful and match the other screens more closely.

2. Rework troublesome areas to make them more reliable under all
situations.

3. Add /Q switch to allow HDUTL to run Quietly (Limited printing
of advisories to the screen).

4. Add /SP switch to skip the repacking of uploaded archives to the
default. When used, archives will NOT be repacked, however integrity
and virus checks WILL be performed as usual when the /U switch is
used. The /SP switch has no meaning except as an amplification to the
/U switch.

5. Check for archives within archives and perform integrity and virus
checking on them independently. Normally, internal archives will be
repacked into the default unless the /SP switch is indicated.

6. Add support for DOS 6.2 simply by clipping the comma from the
filesize entered into the FILES.LST.

7. Revamp the handling of excluded callers. Uploads and Downloads and
Door Tallys are now checked as if they were not excluded, however they
will NOT show up in any of the screens.

UPGRADE INFO:
This version changes the format of HDUTL.TIM. Rerun HDUTL /F [/R /H##]
to rebuild all screens. (Only the /R /H## /A /L switches should be used
for a forced run) /Recompile your CALLERS.LOG if necessary for the full
run/

FIRST TIME USERS:
HDUTL will run 'out of the box' with no switches and do Download
Tracking, and screen generation. You need only edit the HDUTL.CFG for
your board and put HDUTL in your BETWEEN.BAT. Please read the .DOC file
for the advanced features.

Note: It was brought to my attention that chunked archives (large
archives split into several files) may cause a problem when they are
reformatted to a new archive format. Off hand, I don't have a solution
for this! Any suggestions?

Future:
I would really like to be able to see quickly (from the last 15 callers
screen for instance) if all my MAILRUN stuff went off OK during the
night. Maybe some simple cryptic check marks or something. Hmmm?

I will do a quick-and-dirty Dropped Carrier screen soon (by request).

APOLOGY: I am sorry but it has become necessary to use a KEY file with
HDUTL in order to realize any benefit from my efforts. Effective with
the release of the V5.01 and V4.02 versions, a KEY file will be necessary
to remove the 30 second wait and alarm. Registered users may pick up
their keys from the Support BBS. The HDUTL.KEY provided with this
archive will allow you to evaluate the program. After it expires the
program will continue to run, but with some agrivation. Copy the .KEY
file to the /UTL directory.

                           V3.06 93/12/04

1. Correct yet another stupid programmer's error. Misspelled one of
the variables in the Download tracking section. How dumb!

                           V3.05 93/12/04

1. Another bug found in the download section added to handle exclusion
of files from the Top 15 list. Some (if not all) downloads were NOT
being tracked. Fixed. THIS IS THE FINAL RELEASE ?  maybe!

                           V3.04 93/12/03

1. Yet another bug fix &^)(%$#.

                           V3.03 93/12/02

1. A few more bug fixes, particularly in the /F (force new screens)
area, and the Top 15 exclusion routines. Barring any unforeseen
multi-legged critters, THIS IS THE FINAL RELEASE.

Note: It may be worthwhile to recombine your CALLERS.LOG and rerun
HDUTL /F to build new (and hopefully more correct) screens. Use
the DOS call COPY CALLERS.TRM+CALLERS.LOG TMP, then DEL CALLERS.*,
and finally REN TMP CALLERS.LOG, to rebuild your full log. Then
run HDUTL /F (/R if you use it) to rebuild new screens.

                           V3.02 93/12/02

//Thanks again to my trusty beta observers and testers for their
  input and interest//

1. Correct an error where an extra blank line was added to FILES.LST
for downloads when the downloaded file was the last one in the list.

2. Add some 'fool proofing' to areas that used input from the various
HDUTL.xxx exclusion files.

3. Extend the Top 10 list to the Top 15, and extend the New Users
screen to a full 15 to match the Last 15 screen in length. I still
refer to it alternately as a Top 10 or Top 15 list. I found it weird
that the screens did not fill the computer display and were not the
same length as the Last 15 caller screen.

4. Add yet another exclusion file for the Top 15 list. HDUTL.AFX (Area
File exclude). The file is a pure ASCII file with the file area numbers
you wish to exclude from the screen. The HDUTL.TTX (Top Ten file name
exclude) is still operative if you wish to use it (see B04 below).

HDUTL.AFX  Example:
1
3
9
14         <Simply list the file areas by number, no blank lines.

5. Speed up the search for downloads on /F runs (and on normal runs
as a by-product). (Thanks to the new binary FILES.LST format).

6. Exclude those callers listed in HDUTL.XCL from the Top 15 Up/
Download screen. Now the SysOp won't show up as the top uploader :)

7. Move the DOOR tally routine outside of the Last 15 loop. Due to
the coding used, items in the logon line from the CALLERS.LOG were
not checked for the DOOR tally. Things like baudrate were not looked
at. They are now! (Thanks to Steve Sears's observation).

Note1: Index files are suggested to speed up the handling of Download
tracking. MAKEIDX must however be run for all upload directories to
make the recently uploaded files available. Suggest the following in
BETWEEN.BAT to run MAKEIDX if uploads occurred.

IF NOT EXIST UPLOAD.DAT GOTO NEXT1
TYPE UPLOAD.DAT >> UPLOADS.DAT           <Save the data if you want
DEL UPLOAD.DAT                           <Delete the file for next run
MAKEIDX /F:#-#     (where #-# will include your upload directories)
:NEXT1
<rest of your BETWEEN.BAT>

Note2: If you use the /U upload checking function, ensure the archive
programs, PKZIP/PKUNZIP.EXE, LHA.EXE, PAK.EXE are in the DOS path.
Without them strange things happen to the FILES.LST and file
discriptions, not to mention loss of uploads.


                           V3.01 93/11/24

Revise handling of FILES.LST to support TriBBS V5.01 B07 and
later releases.

Follow the instructions in BETA.DOC/README.1ST provided with TriBBS and
run ASCTOBIN /ALL.

DO NOT ATTEMPT TO USE THIS VERSION WITH TriBBS VERSION PRIOR TO B07!


                           V3.00 93/11/20

Version 3.0 released.

Thanks to: (for trying the new products and offering suggestions)

   Michael Kauffmann    Villa Rica, Ga.
   Karl Duncan          Reading, Pa.
   Michael Guerra       Waldorf, Md.
   Butch Nordstrom      Billerica, Ma.
   Jim Kunert           Sheboygan, Wi.
   Jim Wellis           Knoxville, Tn.
   Doug Nelson          Columbia, Mo.
   Steve Sears          Ft.Meyers, Fl

Your comments were well taken and greatly appreciated.

B04 Released 93/11/17

1. Rework the default archive area to prevent losing Volume Labels in
   ZIPs, to update the file size in FILES.LST and to clean up some
   'bugs' in the routine. File sizes placed in the FILES.LST may differ
   from actual by an amount equal to the size of the DESC.SDI and the
   HDUTL.MSG as they are not contained in the archive when the filesize
   is checked and placed into the FILES.LST.

2. Add a HDUTL.TTX file to exclude filenames or partials from the Top
   10 files list. Enter up to 50 file names or partials (e.g. .GIF)

3. Add checking to ensure uploaded file TEST didn't overwrite an
   existing TEST.ZIP (Default ZIP), when it was forced into an archive.
   Just in case the EXACT MATCH flag was set in TriBBS. If the /U option
   is used, EXACT MATCH should be turned off in TriBBS's WFC System
   Configuration.

4. Changed the color for the numbers in the Top 10 screen to the first
   color (in HDUTL.CLR) vice the 2nd (which was also used for the
   border) I'm working on a better DOC on the color file and how it
   equates to the actual screen colors used.

5. Add a Mail Run hour switch to place a notice in the usage graph for
   the selected hour. Switch /H## added. To designate your Hub run hour
   place the /H## switch on the HDUTL command line. e.g. /H04 for an
   04 A.M. mailrun hour.

B03 Released 93/11/13

1. Add /R switch to check login names and replace with Real name if
   they are an alias.

2. Add /M switch to Mark uploads with "Uploaded By: SysOp" if no
   "Uploaded" comment is found in the FILES.LST.

3. Swat a couple of pesky bugs noted by my faithful testers. (THANKS)

4. Add some debug code to print more usable Situation and Process
   information. Include PROCESS.DAT file with keys to printouts.

B02 Released 93/11/12

1. Add /ST switch to save the trimmed portion of the CALLERS.LOG into
   CALLERS.TRM.

B01 Released 93/11/11

Upgrade info: Copy HDUTL.EXE to your directory. Add the /U switch to
the BETWEEN.BAT if you desire to use the new feature. Ensure the default
archive extension is set correctly in TriBBS's WFC Configure System
window. Build an ASCII file HDUTL.MSG if you wish archive comments
added to your uploads. ZIP, ARJ, LZH, ARC, SDN and PAK archives are
currently supported. Build HDUTL.ACX file containing the three letter
file extensions (in UPPER CASE) which are to be excluded.

1. Adds upload archive integrity checking. If used, remember to turn
   off files checking in the WFC setup screen. Deletes files and the
   FILES.LST entries for those that fail.

2. Adds  default archive conversion, the default archive extension is
   taken from the SYSDAT1.DAT file as set from the WFC screen.

3. Adds insertion of archive comments if HDUTL.MSG exist in \UTL dir.

4. Adds virus checking after the user logs off. Calls McAfee's SCAN.EXE.
   Deletes files and FILES.LST entries for those that fail.

5. Also if no FILE_ID.DIZ or DESC.SDI file was contained in the upload, one
will be build from the FILES.LST file description and added to the new
archive. Rebuilding of FILES.LST will have a description.

6. HDUTL.ACX file added to allow exclusion of specific file extensions
from conversion to default archive.


                            V2.00 93/11/05

Upgrade info: Copy HDUTL.EXE to your directory and edit your .CFG
file adding an output screen below the Top 10 screen for the new
BBS Hourly call graph. Edit your BETWEEN.BAT adding the /T# trim
switch if desired. Copy the HDUTL.CLR file to the /UTL directory
and edit it to suit your preferences for screen colors.

1. Added BBS Hourly call graph screen.

2. Added /T#, CALLERS.LOG trim function.

3. Added HDUTL.CLR file to customize screen colors.

4. Recompiles for speed and to correct bugs noted since release
of V1.02.


                            V1.02 93/10/29

Upgrade info: Copy HDUTL.EXE to your directory and edit your .CFG
file to include a screen name for the Top 10. The name is entered
just below the last screen file name in the HDUTL.CFG file. Rerun
the program with the /F switch to build the new screen.

1. Added Top Ten tracking for Uploaders, Downloaders and popular files.
Additional files HDUTL.FIL, HDUTL.UPL and HDUTL.DLD are built to
hold the data. New screen name required in .CFG.



                            V1.01 93/10/24

Upgrade info: Simply copy the HDUTL.EXE to your directory. No changes
in any other files.

1. Added a FILECHK.DAT output file. Build an ASCII file named HDUTL.CHK
in the \UTL directory and enter the names of files you wish to track the
downloads for. You may enter full file names (HDUTL.ZIP), or partials
(.ZIP). Each time a user downloads one of these files, an entry is made
in the FILECHK.DAT file:

  filename          user            from            date/time logged on
HDUTL11.ZIP     by Hal Holland   From Austell, Ga.   10/24/93 12:51:43

2. If you do not currently use a download tracker on your system, you
may run HDUTL for the FIRST time with both the /F (force new screens)
and /D (force logging of downloads) command line switches. Do NOT run
it a second time with /D switch or false download numbers will result.

3. The printouts to the logging files and screen have been formatted to
be a little neater.

4. It is no longer necessary to run the NEWUSER.BAT file to obtain the
user's city and state. The data is taken from the USERS.DAT file now.

5. Missing entries in FILES.LST or FILES.IDX will no longer bomb the
program. Advisories are provided in HDUTL.LOG.

                           V1.00 Original release
                               (see docs)