Copyright: Copyright 1998 by VisionSoft


 Logger

Version 1.03

 Copyright 1998 by VisionSoft

Written by S.Goodwin

This program will take the Logfile.log file, created by War-FTP, and turn it into a system message to be used by your FTP server. It will sort the download and uploads by size, files, or number of sessions.

 Contents

Features	Credits
Requirements
Version History
Installation
Un-Installing
Operation	Shareware Information
Settings Dialog	Copyright Information
Structure File	Other Products From VisionSoft


 Features

•	Works with up to 4000 Gig of files

•	Separate data for upload and downloads

•	Structure files are compatible with LogFrog

•	Create top download lists

•	Sort by:

Download size

Download files

Upload size

Upload files

Number of users sessions

Speed of uploads

Speed of downloads


 Requirements

Windows 95

1 Meg of disk space

386 or higher

4 Meg of RAM

War-FTP, version 1.65 or greater.


 Version History

1.00	Initial Release
1.01	Minor bug fix (loading Ignore Names) Added sort by download/upload speeds Add file lists Wildcards for loading log files Split Create Now! into two buttons Improved docs
1.02	Added local/system time facility Removed feature of menu on right mouse click
1.03	Removed crash when corrupt user names feature in the log Added version number to tag line


 Installation

Un-zip the archive into a new directory (called Logger, for example).

Run it! The program will automatically set-up the registry information it needs. On the first time it is run, the About box will appear. This is the only time it will do so on start-up.


 Un-Installing

Delete the Logger directory, load RegEdit and delete everything from the Logger key:

HKEY_LOCAL_MACHINE\SOFTWARE\VisionSoft\Logger\

You should also delete the boot-up feature from:

HKEY_LOCAL_MACHINE\ SOFTWARE\Microsoft\\Windows\CurrentVersion\Run\Logger


 Operation

The program has two main states, in the system tray, and on the screen. Whilst in the tray there are two options. You may either click on the icon with the left mouse button, or the right. The left button will open the Settings dialog, whilst the right will bring up a menu with the options:

Settings Dialog	Open the same Settings dialog as the left button
About	Gives you version information
Quit	Removes the program from the tray.


 Settings Dialog

Here you can set-up the files used in creating the message file. They are:

Logfile

Structure File

Destination File

All these must contain a full path, otherwise the program may not work when Windows boots up. The LogFile entry may contain wildcards (e.g. c:\Program Files\War-Ftpd\*.log, if necessary). The other options are straight forward:

Dont Include Users- This list box can be used to remove the sysop and other important people from the lists. Their totals will not be used when reporting the total files with |%TOTALULB|.

Automatically Update Destination File will, for as long as Logger is resident in the system tray, update the system every hour on the hour (default). Alternatively, it can update every 10 minutes, for example. The latter option is only really useful on heavy loaded sites.

Create Top Downloads File List will, at the allotted time (i.e. on boot-up, when you hit Create Now!, or whenever the destination file is updated) search through every file in the log file(s), and count the number of times it is downloaded. With many files this operation can be very slow. If you are not going to report the top downloads, untick this check box. If you will report the downloads, It is recommended you only create the list at boot-up. Once created, the list will be stored in the registry and re-loaded as needed. As an example, the program has taken 30 seconds to create a list for 500 files.

The American Date uses Month-Day-Year, as opposed to Day-Month-Year.

24 Hour Clock uses 21:00 for 9PM. The AM/PM post-fix is not used in this instance. The time zone (i.e. GMT, EST etc), should be entered into the structure file.

 Run On Boot-up; does just that. When the box is ticked, Windows will start Logger as soon as it has booted up. You will know if it has worked if the Logger icon (a tree) appears in the system tray.

As for the buttons, well:

Create Now re-builds the file, using the current logfile

View Log Now - shows the current destination message file

Edit Struct - opens notepad to permit editting of the current struct.txt file


 Structure File

This file stores the format information for the output file. All the text in the structure file is copied, until it reaches a |. This allows Logger to add specific information into the text file. It will add this information until the next | character is reached, at which point Logger will continue to copy the structure file line by line.

Format Specifiers

These can be split up into five sections. For example,

|%U0ULNAME|

This means, Take the user at position 0 in the uploads list, and print their name. Why?

%U	Add some User information from the log. This can read: TOTALULF - Total number of files uploaded TOTALDLF - Total number of fles downloaded TOTALULB - Total size of files uploaded TOTALDLB - Total size of files downloaded TOTALKPS - Average transfer speed DATE - Current data TIME - Current time U - User information F - File information (downloads only) Only the U and F options require additional parameters. See table below for the F parameters.
0	Position in the list. 0 (zero) is the user with the highest quantity, 1 is second, and so on. The bottom of the list is denoted with -0, the 2nd worst is -1, and so on.
UL	Use the uploads list. This can be: UL - Uploads, sorted by total file size UF - Uploads, sorted by total number of files UB - Upload baud rate DL - Downloads, sorted by total file size DF - Downloads, sorted by total number of files DB - Download baud rate SZ - Number of sessions
NAME	Print the persons name. This can be: NAME - Their name SZ - Number of sessions KPS - Average transfer rate B - Number of bytes transfered F - Number of files transfered
|	End of information

When reporting individual files the format specifier starts with |%F, and is constructed thus:

|%F	Specify the top downloads. Only downloads are supported because it is not possible to upload with the same filename more than once.
0	Position in the list. 0 (zero) is the user with the highest quantity, 1 is second, and so on. The bottom of the list is denoted with -0, the 2nd worst is -1, and so on.
NAME	Print the full filename. This can be: NAME - The filename, see below DL - Number of downloads When giving the name, you can specifies the number of characters it uses. For example: |%F0NAME80| will pad the name to 80 characters. If the filename is longer than 80 characters, only the last 80 will be shown.
|	End of information

Note:

If you are using the uploads list, then the bytes transfered entry will report the uploaded bytes.


 Credits

Concept, design and coding Steven Goodwin

Icons: Author unknown!

Contact:

Steven Goodwin

105 St. Johns Road

Clacton-on-Sea

Essex CO16 8DB

See Also:

Shareware Information

Copyright Information

Other Products From VisionSoft


 Copyright Information

This software, graphics and documentation are Copyright 1998 by Steven Goodwin.

This product is Freely Distributable, with all copyrights retained. Copies may be made and distributed on the following conditions:

•	The contents of the archive are kept as is, with no modifications, additions, or absentees.

•	No charge is made for the archive, above and beyond reasonable media costs.

•	No part of this product may not appear in a commercial package without written permission from the author. This does not include magazine coverdisks or other media where the software is auxiliary to its main purpose.

Failure to comply with any of the conditions above results is a direct breach of the license agreement under which this product is distributed. Any such archive should be deleted, and a new, complete, one requested.

It is requested that any commercial breach be reported to the author.

All Rights Reserved

See Also:

Credits

Shareware Information

Other Products From VisionSoft


 Shareware Information

This product is classed as Shareware.

This means you may use the product for up to 30 days without penalty. After this time, you are required to register it with the author.

Registration costs £5, and rewards you with the latest version, copies of other VisionSoft products (or those that will be un-released to the general public), and a warm glow knowing you have helped the shareware scene!

Registration fees should be sent to the author…

See Also:

Credits

Copyright Information

Other Products From VisionSoft


 Other Products From VisionSoft

Desktop Calendar	This is a small program that will create a calendar for the current day, and use it for the backdrop of your desktop.
Swap File Reporter	A program that sits in the system tray and report the size of your swap file when you hover over it. It also reports hard drive space and memory used.
Jargon Buster	Find the meaning of several Internet terms and acronyms…without showing yourself up!
Logger	This converts War-FTP log files into readable tables to be used a messages on your site. It automatically updates every hour.
MIDI Converter 120	Converts MIDI files from Format 1 to MIDI Format 0
Mozart Dice	Creates random compositions, based on the tables supposedly created by Mozart.

Other Minor Releases:

Rot13	Basic ROT13 text encoder/decoder
Sphere	Calculates the formula for an N-dimension sphere and calculates the volume and surface area of such a sphere, given a radius. Source included.
Skull	Spinning skull. My first screen saver.
See Also:
Credits
Shareware Information
Copyright Informat