home *** CD-ROM | disk | FTP | other *** search
- AverageZ v2.0
- Copyright 1989-1990 Average Software
-
- Another Average Utility
- From:
- Average Software
- "The Epitome Of Mediocrity" tm
- Ken Rieck and Dave Masters
-
- Call the Average Software Support Board
- Data Trax
- Oceanside, California
- (619) 433-8564
- Up to 38400 USR HST 1441
-
- This is going to be short because I hate reading documentation too.
-
- DESCRIPTION
- -----------
- AverageZ was initially written over a period of one week using Turbo Pascal
- 5.5 while trying to teach ourselves pascal. It started when it was
- realized that the LOG file that DSZ can create and maintain has a lot of
- useful information, but in it's natural form the information isn't easy to
- grasp as a whole. AverageZ will read the LOG file and compile the all the
- lines into one, useful screen of information. The screen is divided into
- ZModem transfers on the left, and all other protocols (like YModem,
- YModem-G, XModem, etc.) on the right side. Version 1.1 will be the last
- release of AverageZ. Due to the limitations of DSZ's logging capabilities,
- there are only two things that you can tell from looking at the log file;
- whether it was a ZModem transfer or a XModem/YModem transfer. We will
- continue to support AverageZ through the Average Software Support Board
- which is listed at the end of this document.
-
- USEAGE
- ------
- Running AverageZ is easy, you simply invoke it by typing:
-
- AverageZ [logfilename.ext] [/O<reportfilename.ext>]
-
- on the command line, [logfilename.ext] is optional. If you have the DSZLOG
- environment variable set, AverageZ will read it and process the file that
- it points to. If you have this variable set, but want to process a
- different LOG file, putting it on the command line will override the
- environment setting. Averagez now has the capability to optionally write
- its report to disk. If you want your compiled DSZ log statistics written
- to a file, add /O<filename> to your command line. <Filename> can be any
- valid DOS file name including path (if desired), and must be included if
- you specify '/O' on the command line.
-
- There are only two errors that AverageZ looks for in your log file: if the
- file doesn't exist or if the file is in the wrong format. If it is in the
- wrong format, AverageZ abort with a message telling you the line number(s)
- (in the LOG file) where the error(s) occurred and you can then edit the LOG
- to remove or correct the erroneous line(s). Below is a sample of what a
- proper DSZ LOG file line looks like:
-
- Z 166947 19200 bps 1084 cps 0 errors 0 128 world27.zip 0
- ^ ^ ^ ^ ^ ^ ^ ^ ^
- │ │ │ │ │ │ │ │ └ S/N
- │ │ │ │ │ │ │ └ Filespec
- │ │ │ │ │ │ └ Block Size
- │ │ │ │ │ └ Flow Control
- │ │ │ │ └ Error Count
- │ │ │ └ Characters Per Second
- │ │ └ Comm Port Speed
- │ └ File Size
- └ Protocol Used
-
- There's no need to go into depth about all the different items on each
- line, if you want more information about it, consult the DSZ
- documentation.
-
- AverageZ can now handle entries made by another program called LOGDATE.
- LOGDATE is normally run immediately prior to calling DSZ for a file
- transfer, and will put a time/date stamp in your DSZ log file. LOGDATE is
- not included in the AverageZ package, and if you're interested in obtaining
- the program, you should be able to download it from a local BBS.
-
- AverageZ will trap up to nine incorrectly formatted lines in your log
- file. If your LOG has bad lines in it, simply use a straight ASCII
- editor (like QEDIT) to fix the problem.
-
- If you haven't set the DSZLOG variable in your environment, you should
- add:
-
- SET DSZLOG=<filespec>
-
- to your AUTOEXEC.BAT file. Once you do this, DSZ will maintain a log of
- all your transfers. Again, if you want more information about the DSZLOG=
- environment variable, consult the DSZ documentation.
-
-
- If you like the program, then tell your friends about it and upload it to
- your favorite BBS.
-
- ACKNOWLEDGEMENTS
- ----------------
- Omen Technologies - Without them, this program wouldn't have a reason to
- exist.
- Chris Mueller - For the tip that led to the LOGDATE entry handling.
- Chris Conrad - Requested redirection capability.
- You - For downloading and trying this program.
-
- DISCLAIMER
- ----------
- AverageZ is provided on an "as is" basis without warranty of any kind
- expressed or implied. In no event will Average Software be liable to you
- for any damages, including any lost profits, lost savings or other
- incidental or consequential damages arising out of the use of or inability
- to use the program, even if Average Software has been advised of the
- possibility of such damages, or for any claim by any other party.
-
- BUG REPORTS
- -----------
- If you find any bugs, we'd appreciate a call to the Average Software
- Support Board - Data Trax (619) 433-8564. Data Trax features near-instant
- verification and security upgrade using the PCBVerify callback door, so
- you call once, get callback verified, and then your access is upgraded
- instantly. If you'd rather not call, then you can send a postcard to:
-
- Average Software
- 1837 S. Myers St. #7
- Oceanside, CA 92054
-