LOGGIT -- TELIX LOG FILE ANALYZER
Copyright (C) 1989,1990 by Vic Baron
CIS: 71210,3632

All Rights Reserved


_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER


The author, Vic Baron, is a Member of The Association of
Shareware Professionals (ASP). ASP has established stringent
standards for its members and wants to make sure the Shareware
principle works for you. If you are unable to resolve a share-
ware-related problem with an ASP member by contacting the member
directly, ASP may be able to help. The ASP Ombudsman can help
you resolve a dispute or problem with an ASP member, but does not
provide technical support for members' products. Please write to
the ASP Ombudsman at:

Address: P.O. Box 5786 Compuserve: ASP Ombudsman
Bellevue, WA 98006. 70007,3536


DISCLAIMER

This program is provided "as is" with no warranties whatso-
ever, either expressed or implied, including without limitation,
warranties of merchantability or fitness for a particular pur-
pose. The entire risk as to the quality and performance of the
program is with you. Should this program be defective, you
assume the entire cost of all necessary servicing, repair or
correction.














T A B L E O F C O N T E N T S
T A B L E O F C O N T E N T S
T A B L E O F C O N T E N T S



OVERVIEW .................................................... 1

COMMAND SYNTAX .............................................. 1

PATHNAMES ................................................... 1

CONVENTIONS ................................................. 1

STARTING LOGGIT ............................................. 2

SELECTING DATE RANGE ........................................ 2

SCAN CRITERIA ............................................... 2

UP/DOWNLOAD ANALYSIS ........................................ 3

OUTPUT MODES ................................................ 3

BATCH FILE OPERATION ........................................ 4

DISTRIBUTION PACKAGE ........................................ 4

CAUTIONS .................................................... 4

PROGRAM SUPPORT ............................................. 4

L O G G I T V4 R E G I S T R A T I O N F O R M ........ 5

APPENDIX A .................................................. 6

APPENDIX B .................................................. 7


Loggit -- Telix Log Analyzer Version 4.00 1
October 10, 1990
_________________________________________________________________


OVERVIEW

LOGGIT is a screen oriented, menu driven program designed to
provide an analysis of the Telix Usage Log. It provides the user
with detailed or summary information regarding uploads and down-
loads, total time online, total calls and more. Output can be
directed to the screen for quick information or to the print
device or a file for a more permanent record. Analysis may be
done for individual calls, specified date ranges or other combi-
nations. LOGGIT searches the PATH for the TELIX.CNF file and
reads date/time configuration information.



COMMAND SYNTAX

LOGGIT is run by entering --

LOGGIT [/t]

The command line option -- /t -- disables the log file integrity
check.
PATHNAMES

LOGGIT supports the standard DOS conventions for pathnames for
all files and may be run from any directory as long as it is
included in your PATH. If a pathname is not specified for the
input and output files, the default is the current directory.

CONVENTIONS

When asking for input, as in a filename, LOGGIT will display the
default value in angle brackets <>. Thus, hitting return without
any input will use the data contained within the brackets.

On the occasions that a yes or no input is required LOGGIT will
display (y/N) or (Y/n) indicating the default value in upper
case.

In using the menus, the default value is the selection that is
highlighted when the menu is first presented. Pressing return
will select the highlighted function. The selection may be
changed in two ways, either by using the cursor keys to highlight
another selection or by entering the first character of the
selection.

Ctl-C or Ctl-Break will exit from any part of LOGGIT but may
leave incomplete files on the disk if the file output mode was
selected.


Loggit -- Telix Log Analyzer Version 4.00 2
October 10, 1990
_________________________________________________________________
STARTING LOGGIT

Running LOGGIT is as simple as entering LOGGIT at the DOS prompt
and pressing . You will then be presented with a series
of menus which will define the input file and the scan criteria.
At the top center of the screen will be a message window which
will prompt you for the correct response. The menus are self
explanatory but a brief description follows:

Enter Input filename

Hitting at this prompt will default to the current
directory and the TELIX.USE file. For any other selection, main-
tained in the format of the TELIX.USE file, enter the complete
pathname of the input file. Your selection will be displayed in
the Input Window in the upper left of the screen.

SELECTING DATE RANGE

Next is displayed the menu which allows the selection of the
range of dates upon which LOGGIT will operate.

Alldates -- compile data from the first date entered in
the file to the last entry.

Select dates -- allows the selection of START and END dates as a
range for compiling the data. LOGGIT will start compiling data
from the start date specified and will continue compiling data UP
TO but not including the END date. Dates are entered in the form
MMDDYY. LOGGIT scans the TELIX.CNF file to determine the selected
date separator (i.e. '/' or '-') and will adjust the dates ac-
cordingly. If the date separator specified in the CNF file
doesn't match those in the .USE file, an error message is dis-
played and the program is aborted. To scan from a specified start
date to the end of the file, you could enter any date that is
beyond the end of the data in the file. LOGGIT will continue to
compile data until it reaches the end date or the end of the
file.

SCAN CRITERIA

The next menu presented tells LOGGIT whether to scan for a spe-
cific BBS or to compile data on all calls made.

Allcalls -- compile data on all calls made. LOGGIT will
tally all calls, keeping track of time online, average
time/call,total calls to each number, total number of uploads,
downloads and aborts. The output will be sorted by name and the
individual results will be displayed as in appendix A.

Individual -- compile data on the specified BBS. LOGGIT will
tally all calls to the specific BBS keeping track of time
online,total calls, average time/call, uploads, downloads and
aborts.


Loggit -- Telix Log Analyzer Version 4.00 3
October 10, 1990
_________________________________________________________________
UP/DOWNLOAD ANALYSIS

If the Individual mode has been selected, a submenu of choices
will appear allowing you to further define the analysis.

Detailed -- Compile the individual up and download
activity for the selected BBS, showing the date, protocol, file-
name and transfer speed in CPS. A sample of the output is shown
in appendix B.

Summary -- Accumulate and display the totals for the selected
BBS.

PcPursuit -- Compensates for inaccuracy in Telix logfile when
accessing PCP. Use this mode for a more accurate time online
calculation for your PCPursuit main number.

OUTPUT MODES

If Allcalls or Individual Detailed has been selected, the next
menu presented is the output mode menu, allowing three different
types of output.

Screen -- Sends all output to console. This is the only
output mode available when using the Individual Summary or Indi-
vidual PcPursuit modes.

Printer -- Sends all output to standard printer port.

File -- Sends all output to data file.


If File is selected you are prompted for an output filename.

Enter output filename

Pressing will use the default file TELIX.RPT or you may
enter any valid DOS filename. LOGGIT will check for the existence
of the selected file and if present will allow you the option to
overwrite the file.

If the Individual mode has been selected, you are now prompted to
enter the BBS name to analyze. The input is CASE SENSITIVE and
all that need be entered is enough of the BBS name to make the
search unique. LOGGIT will attempt to locate the BBS name entered
and, if unable to find it, will display an error message and
request another name.

LOGGIT will now scan the file and compile the data according to
the parameters that have been selected. The message window will
display an "Analyzing -- Please Wait" message. When the scan is
completed the data will be output to the file or the printer
directly. If the screen mode has been chosen, you will be prompt-
ed to strike a key to page the output.


Loggit -- Telix Log Analyzer Version 4.00 4
October 10, 1990
_________________________________________________________________
BATCH FILE OPERATION

LOGGIT may be run from a batch file if you use one of the
programs used to stuff keyboard responses in a buffer.
DISTRIBUTION PACKAGE

The files in the distribution package are:

LOGGIT.EXE -- LOGGIT executable
LOGGIT.DOC -- Documentation for LOGGIT


CAUTIONS

Due to power failures and improper use of the program, TELIX has,
on occasion, entered some strange entries into the TELIX.USE
file. LOGGIT makes every attempt to catch these errors and
instruct the user to correct them before proceeding. The usual
error is the combining of two lines of the log onto one line.
These errors are easy to spot and correct. There is one
particular error, however, that can cause some strange results.
Occasionally, TELIX will insert an Elapsed Time Online entry into
the log which signifies the end of the connection when the
connection has not ended at all. This can produce some strange
elapsed times and may even miss logging some up/downloads. If you
notice some strange results, look closely at the TELIX.USE file.
Chances are you'll find some subtle error in the file. This can
produce incorrect results but can do no harm at all.

The built-in file integrity check may be overridden by the use of
the command line switch /t.

PROGRAM SUPPORT

The author may be reached by leaving Email on Compuserve or by
leaving a message in the Telix Conference or Shareware Conference
on Interlink or U'NI Net.


Loggit -- Telix Log Analyzer Version 4.00 5
October 10, 1990
_________________________________________________________________
L O G G I T V4 R E G I S T R A T I O N F O R M


TO: Vic Baron Date___/___/___
GTX
5419 Dahlia Drive
Los Angeles, CA 90041



FROM: Name:_____________________________________________________

Address:__________________________________________________

City:______________________ State: __________ ZIP: _______

Phone - Day: ( ) __________ Evening: ( ) __________



LOGGIT 4 $12.00

(CA residents add 6% tax) _____

(Foreign orders add $10.00 for shipping) _____

Total $_____





Where did you get LOGGIT 4 (BBS name, phone number, etc.)?

__________________________________________________________

__________________________________________________________

__________________________________________________________


Date Registered ___________________


==========================================================

COMMENTS:_________________________________________________
__________________________________________________________
__________________________________________________________
__________________________________________________________
__________________________________________________________
__________________________________________________________
__________________________________________________________


Loggit -- Telix Log Analyzer Version 4.00 6
APPENDIX A
_________________________________________________________________
Sample output for Allcalls --

================================================================
BBS TELEPHONE Total Total Avg UP DN FILE
NAME NUMBER CALLS TIME TIME LDS LDS ABORTS
================================================================
A.M.U.L.E.T. 989-5054 3 0:26 8 min 2 0 0
A.S.T.E. BBS 443-0242 1 0:16 16 min 1 0 1
AAAExecpc 622-1138 54 8:55 9 min 5 20 3
AAALaTelenet 624-2251 8 2:02 15 min 0 0 0
AAALaTelenet24 622-1138 67 4:21 3 min 0 0 0
AT&T Communicator 983-5090 1 0:00 0 min 0 0 0
Albedo 0.39 822-8520 2 0:12 6 min 1 0 0
BBS1-PC! 623-8451 2 1:02 31 min 2 2 0
+ + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + +

+ + + + + + + + + + + + + + + +
qhost 547-1549 6 1:03 10 min 6 2 0
sunrise omega 452-0350 1 0:01 1 min 0 0 0
swap 861-0925 1 0:05 5 min 0 0 0
unix 530-3013 1 0:00 0 min 0 0 0
unk16 1-818-961-7903 2 0:12 6 min 0 0 0
xanth West 1-818-710-9998 1 0:18 18 min 0 1 0

Start Date -------- 09-01-90
End Date ---------- 10-02-90
Total Calls ------- 0399
Numbers Called ---- 0122
Total Uploads ----- 0090
Total Downloads --- 0103
Total Aborted ----- 0009
Total Time Online - 54 hrs 48 mins
Average Time/Call - 8 min 17 secs


Loggit -- Telix Log Analyzer Version 4.00 7
APPENDIX B
_________________________________________________________________
Sample output for Individual - Detailed

================================================================
Upload/Download Activity for: AAAExecpc
================================================================
90-09-01 Upload External YmOdem-g protocol. CPS
90-09-03 Upload External YmOdem-g protocol. CPS
90-09-10 Upload External ZmodemH protocol. CPS
90-09-11 Download External YmOdem-g protocol. CPS
90-09-11 Download thelist2.zip Zmodem protocol. 220 CPS
90-09-14 Download External YmOdem-g protocol. CPS
90-09-15 Download External YmOdem-g protocol. CPS
90-09-16 Download vircom.zip YmodEm-g protocol. 192 CPS
90-09-20 Upload External ZmodemH protocol. CPS
90-09-20 Download pk361pat.zip YmodEm-g protocol. 175 CPS
90-09-20 ABORTED CPS
90-09-20 Download dsz0920.zip Zmodem protocol. 219 CPS
90-09-20 superk.pak 177 CPS
90-09-20 cudmx.zip 164 CPS
90-09-21 Download toots.gif Zmodem protocol. 196 CPS
90-09-22 Download mnp.doc Zmodem protocol. 0 CPS
90-09-22 Download mnemonic.txt Zmodem protocol. 204 CPS
90-09-22 Download pcpchek.zip Zmodem protocol. 1026 CPS
90-09-22 Upload External ZmodemH protocol. CPS
90-09-24 Download ABORTED YmodEm-g protocol. CPS
90-09-24 Download dszreg.zip Zmodem protocol. 221 CPS
90-09-24 mn1221.zip 23 CPS
90-09-24 td1pat.zip 93 CPS
90-09-24 tc2pat_2.zip 96 CPS
90-09-24 noah2.zip 116 CPS
90-09-24 Download External YmOdem-g protocol. CPS
90-09-28 Download ABORTED YmodEm-g protocol. CPS
90-09-28 Download External Dszmodem protocol. CPS

Start Date -------- 09-01-90
End Date ---------- 09-30-90
Total Calls ------- 0129
Total Uploads ----- 0005
Total Downloads --- 0020
Total Aborted ----- 0003
Total Time Online - 15 hrs 20 min
Average Time/Call - 7 min 19 sec


Sample output for Individual - Summary

================================================================
BBS TELEPHONE Total Total Avg UP DN FILE
NAME NUMBER CALLS TIME TIME LDS LDS ABORTS
================================================================
Execpc 622-1138 54 8:55 9 min 5 20 3