home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1993 #2
/
Image.iso
/
comm
/
ldstat.zip
/
LDSTAT.DOC
next >
Wrap
Text File
|
1993-06-30
|
11KB
|
273 lines
LDSTAT(TM) For Telix
Long Distance Detail Reporter
Copyright (C) 1993 By Gregory E. Shultz Sr.
All Rights Reserved
Telix Is A Trademark Of deltaComm Development
Telix Is Copyright (C) 1986-1992 By deltaComm Development
LDSTAT(TM) For Telix 1
Introduction
────────────
LDSTAT.EXE extracts information from the Telix log file regarding
long distance calls dialed in the "1-XXX-YYY-ZZZZ" format (where
XXX is the area code, YYY is the dial prefix, and ZZZZ is the dial
suffix, with or without the hyphens).
Disclaimer
──────────
Users of LDSTAT(TM) must accept this disclaimer of warranty:
LDSTAT.EXE has been tested on two different systems, an IBM and a
Tandy, without any occurrence of hardware problems related to the
use of the software. The program simply reads, and does not write
to, the Telix usage log. The author assumes no liability for da-
mages, direct or consequential, which may result from the use of
LDSTAT(TM). LDSTAT(TM) is supplied as is, and the author disclaims
all warranties, express or implied, including, without limitation,
the warranties of merchantability and of fitness for any purpose.
Distribution Files
──────────────────
Files included in this archive:
LDSTAT.EXE (the executable)
LDSTAT.DOC (documentation)
PRODUCT.LST (list of other software by the author)
READ.ME (miscellaneous information)
REGISTER.FRM (registration form)
Program Usage
─────────────
LDSTAT InFile OutFile
Example:
LDSTAT TELIX.USE LONGDIST.RPT
...where TELIX.USE is the log file generated by Telix, and the
output file created by LDSTAT is LONGDIST.RPT. If you would like
to run LDSTAT from a directory other than \TELIX, you may specify
a path name as follows:
LDSTAT C:\TELIX\TELIX.USE LONGDIST.TXT
Please note that TELIX.USE is the default name Telix uses for its
log file and the name can be changed to any legal DOS file name
you would like, by pressing CTRL+O within Telix, and accessing
"Filenames and Paths" from the configuration menu. The output
file you specify may also be any legal DOS file name, except that
the program will not allow file extensions of EXE or COM to be
LDSTAT(TM) 2
specified as extensions, and will automatically change such exten-
sion specifications to TXT.
Program Notes
─────────────
It is important to note how this program operates, because of a
quirk I have discovered in Telix. When Telix logs information to
disk, it keeps track of a variety of information. Here is a sam-
ple of the kind of information Telix logs during any given session:
93-06-29 12:04:32 Telix Usage Log Opened.
93-06-29 12:04:50 Connected with : Mother Earth BBS
93-06-29 12:04:50 ++ At phone # : 1-407-555-8222
93-06-29 12:04:50 ++ Settings : 9600,N,8,1
93-06-29 12:05:27 Upload using Zmodem protocol.
93-06-29 12:05:28 ++ File : C:\TELIX\UPLOAD\WIDGET.ARC
93-06-29 12:05:35 ++ Chars per second : 369
93-06-29 12:05:58 Download using Zmodem protocol.
93-06-29 12:05:59 ++ File : C:\TELIX\DOWNLOAD\ldstat.zip
93-06-29 12:07:33 ++ Chars per second : 231
93-06-29 12:07:41 Elapsed time online 00:02:50
93-06-29 12:07:44 Exiting Telix.
Notice the second to last line, and the listing of "Elapsed time".
This information is very important to the operation of LDSTAT(TM),
as it not only uses this information in compiling and processing
data, but it needs to find this line as part of the search algo-
rithm. Below is the resulting entry into the output file:
Telix Log Analysis
Long Distance Detail Report
Generated 06-29-1993
Date System Called Number Time Min. Actual
06/29/93 Mother Earth BBS 407 555-8222 12:04 PM 3 00:02:50
*Note that the "System Called" field of the output listing will
truncate BBS names to 18 characters in length (the above listing
is "condensed" to accommodate this documentations format).
LDSTAT(TM) 3
Here is a sample snippet of the log file when this information is
not supplied by Telix:
93-05-27 21:31:45 Connected with : PC Resource
93-05-27 21:31:45 ++ At phone # : 1-407-295-8884
93-05-27 21:31:45 ++ Settings : 2400,N,8,1
93-05-27 21:34:41 Download using Zmodem protocol.
93-05-27 21:34:41 ++ File : C:\TELIX\DOWNLOAD\whatever.zip
93-05-27 21:37:23 ++ Chars per second : 230
93-05-27 21:44:32 Connected with : Another BBS
93-05-27 21:44:32 ++ At phone # : 555-0204
As you can see, although the session with the BBS was completed in
a normal manner, Telix neglected to log the information to disk.
This produces the following output in the long distance detail re-
port provided by LDSTAT:
Telix Log Analysis
Long Distance Detail Report
Generated 06-29-1993
Date System Called Number Time Min. Actual
05/27/93 PC Resource 407 295-8884 9:31 PM *Log Err*
What is important to note here is that the program, after encount-
ering a long distance entry, searches for the "Elapsed time" line
of the log file to correspond with that particular session. If it
encounters another connection before it hits the "Elapsed" line,
you get the above resulting entry in the output file. In fact,
while the program is running, it will display an error message.
LDSTAT(TM) will display all information pertaining to the call that
it possibly can, but obviously it cannot display information re-
garding elapsed time.
What follows is an example that will cause LDSTAT(TM) to display
nothing about the particular long distance session:
93-06-23 22:34:31 Connected with : BBS America
93-06-23 22:34:31 ++ At phone # : 1-555-699-8222
93-06-23 22:34:31 ++ Settings : 2400,N,8,1
93-06-23 22:35:00 Upload using Zmodem protocol.
93-06-23 22:35:00 ++ File : C:\TELIX\UPLOAD\WIDGET.ZIP
93-06-23 22:35:09 ++ Chars per second : 323
93-06-23 22:35:25 Download using Zmodem protocol.
93-06-23 22:35:26 ++ File : C:\TELIX\DOWNLOAD\whatever.zip
93-06-23 22:35:46 ++ Chars per second : 227
93-06-23 22:35:55 Exiting Telix.
93-06-23 22:35:55 Telix Usage Log Closed.
93-06-23 22:40:50 Telix Usage Log Opened.
93-06-23 22:40:52 Elapsed time online 00:00:00
LDSTAT(TM) 4
The key here is the last line: "...Elapsed time online 00:00:00".
When LDSTAT(TM) encounters what it thinks is a session of no dura-
tion, it displays no information to the output file concerning that
particular call, since this program is designed only to provide in-
formation about calls in which an actual long distance connection
was made. Notice that after the call, Telix was exited and it had
not displayed the duration of the previous call. Subsequently,
Telix was reloaded, and for reasons unknown it displayed the last
line, even though no call was placed. Since LDSTAT(TM) encountered
this line before it detected another connection, it caused it to
loop out of its subroutine that performs such checking, and to re-
turn to looking for new long distance entries.
Registration & Distribution
───────────────────────────
LDSTAT(tm) is a "shareware program" and is provided at no charge
to the user for evaluation. Users are free to share this program
with others, but are not allowed to distribute the program altered
or as part of another system, or software package.
To aid the continued development of LDSTAT(TM), and other products
from Personal Computing Resource, a registration fee of $10.00 is
required from non-commercial users of this product, after a 30 day
evaluation period. The $10.00 registration will license one copy
for use by a single user on any one computer at any one time.
Commercial users of LDSTAT(TM) must register and pay for their co-
pies within 30 days of first use or their license is withdrawn.
Site-license arrangements may be made by contacting Personal Com-
puting Resource.
Anyone distributing LDSTAT(TM) for any kind of remuneration must
first contact Personal Computing Resource at the address below for
authorization. This authorization will be automatically granted
upon request and such distributors may begin offering LDSTAT(TM)
immediately. Personal Computing Resource must still be advised so
that the distributor can be kept up-to-date with the latest version
of LDSTAT(TM).
All registered users will receive a copy of the latest version of
LDSTAT(TM), and will be given a user account on The PC Resource BBS
where they can obtain subsequent updates, free of charge, through
version 1.XX. A registration form is contained within this ar-
chive and is named REGISTER.FRM
The version of LDSTAT(TM) contained within this archive is in no
way "crippled", and is fully functional.
LDSTAT(TM) 5
Reaching The Author
───────────────────
BBS: The PC Resource BBS
(407)295-8884
CompuServe: 71223,431
Fidonet: 1:363/32 (Address as: Gregory Shultz)
U.S. Mail: Gregory E. Shultz
PC Resource
P.O. Box 681618
Orlando, Florida 32868
**END**