home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / modem / ldstat.zip / LDSTAT.DOC next >
Text File  |  1993-06-30  |  11KB  |  273 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                           LDSTAT(TM) For Telix
  16.                      Long Distance Detail Reporter
  17.  
  18.               Copyright (C) 1993 By Gregory E. Shultz Sr.
  19.                           All Rights Reserved
  20.  
  21.  
  22.  
  23.              Telix Is A Trademark Of deltaComm Development
  24.        Telix Is Copyright (C) 1986-1992 By deltaComm Development
  25.  
  26.  
  27.  
  28.  
  29.         LDSTAT(TM) For Telix                                              1
  30.  
  31.  
  32.         Introduction
  33.         ────────────
  34.  
  35.         LDSTAT.EXE extracts information from the Telix log file regarding
  36.         long distance calls dialed in the "1-XXX-YYY-ZZZZ" format (where
  37.         XXX is the area code, YYY is the dial prefix, and ZZZZ is the dial
  38.         suffix, with or without the hyphens).
  39.  
  40.  
  41.         Disclaimer
  42.         ──────────
  43.  
  44.         Users of LDSTAT(TM) must accept this disclaimer of warranty:
  45.  
  46.         LDSTAT.EXE has been tested on two different systems, an IBM and a
  47.         Tandy, without any occurrence of hardware problems related to the
  48.         use of the software.  The program simply reads, and does not write
  49.         to, the Telix usage log.  The author assumes no liability for da-
  50.         mages, direct or consequential, which may result from the use of
  51.         LDSTAT(TM).  LDSTAT(TM) is supplied as is, and the author disclaims
  52.         all warranties, express or implied, including, without limitation,
  53.         the warranties of merchantability and of fitness for any purpose.
  54.  
  55.  
  56.         Distribution Files
  57.         ──────────────────
  58.         
  59.         Files included in this archive:
  60.  
  61.         LDSTAT.EXE (the executable)
  62.         LDSTAT.DOC (documentation)
  63.         PRODUCT.LST (list of other software by the author)
  64.         READ.ME (miscellaneous information)
  65.         REGISTER.FRM (registration form)
  66.  
  67.  
  68.         Program Usage
  69.         ─────────────
  70.         
  71.         LDSTAT InFile OutFile
  72.  
  73.         Example:
  74.  
  75.         LDSTAT TELIX.USE LONGDIST.RPT
  76.  
  77.         ...where TELIX.USE is the log file generated by Telix, and the
  78.         output file created by LDSTAT is LONGDIST.RPT.  If you would like
  79.         to run LDSTAT from a directory other than \TELIX, you may specify
  80.         a path name as follows:
  81.  
  82.         LDSTAT C:\TELIX\TELIX.USE LONGDIST.TXT
  83.  
  84.         Please note that TELIX.USE is the default name Telix uses for its
  85.         log file and the name can be changed to any legal DOS file name
  86.         you would like, by pressing CTRL+O within Telix, and accessing
  87.         "Filenames and Paths" from the configuration menu.  The output
  88.         file you specify may also be any legal DOS file name, except that
  89.         the program will not allow file extensions of EXE or COM to be
  90.  
  91.  
  92.         LDSTAT(TM)                                                        2
  93.  
  94.  
  95.         specified as extensions, and will automatically change such exten-
  96.         sion specifications to TXT.
  97.  
  98.  
  99.  
  100.         Program Notes
  101.         ─────────────
  102.  
  103.  
  104.         It is important to note how this program operates, because of a
  105.         quirk I have discovered in Telix.  When Telix logs information to
  106.         disk, it keeps track of a variety of information.  Here is a sam-
  107.         ple of the kind of information Telix logs during any given session:
  108.  
  109.         93-06-29  12:04:32  Telix Usage Log Opened.
  110.         93-06-29  12:04:50  Connected with : Mother Earth BBS
  111.         93-06-29  12:04:50  ++ At phone #  : 1-407-555-8222
  112.         93-06-29  12:04:50  ++ Settings    : 9600,N,8,1
  113.         93-06-29  12:05:27  Upload using Zmodem protocol.
  114.         93-06-29  12:05:28  ++ File : C:\TELIX\UPLOAD\WIDGET.ARC
  115.         93-06-29  12:05:35  ++ Chars per second : 369
  116.         93-06-29  12:05:58  Download using Zmodem protocol.
  117.         93-06-29  12:05:59  ++ File : C:\TELIX\DOWNLOAD\ldstat.zip
  118.         93-06-29  12:07:33  ++ Chars per second : 231
  119.         93-06-29  12:07:41  Elapsed time online 00:02:50
  120.         93-06-29  12:07:44  Exiting Telix.
  121.  
  122.         Notice the second to last line, and the listing of "Elapsed time".
  123.         This information is very important to the operation of LDSTAT(TM),
  124.         as it not only uses this information in compiling and processing
  125.         data, but it needs to find this line as part of the search algo-
  126.         rithm.  Below is the resulting entry into the output file:
  127.  
  128.  
  129.  
  130.                                Telix Log Analysis
  131.                           Long Distance Detail Report
  132.                               Generated 06-29-1993
  133.  
  134.         Date     System Called       Number      Time      Min.   Actual
  135.  
  136.         06/29/93 Mother Earth BBS 407 555-8222  12:04 PM     3   00:02:50
  137.  
  138.  
  139.  
  140.         *Note that the "System Called" field of the output listing will
  141.          truncate BBS names to 18 characters in length (the above listing
  142.          is "condensed" to accommodate this documentations format).
  143.  
  144.  
  145.         LDSTAT(TM)                                                        3
  146.  
  147.  
  148.         Here is a sample snippet of the log file when this information is
  149.         not supplied by Telix:
  150.  
  151.         93-05-27  21:31:45  Connected with : PC Resource
  152.         93-05-27  21:31:45  ++ At phone #  : 1-407-295-8884
  153.         93-05-27  21:31:45  ++ Settings    : 2400,N,8,1
  154.         93-05-27  21:34:41  Download using Zmodem protocol.
  155.         93-05-27  21:34:41  ++ File : C:\TELIX\DOWNLOAD\whatever.zip
  156.         93-05-27  21:37:23  ++ Chars per second : 230
  157.         93-05-27  21:44:32  Connected with : Another BBS
  158.         93-05-27  21:44:32  ++ At phone #  : 555-0204
  159.  
  160.         As you can see, although the session with the BBS was completed in
  161.         a normal manner, Telix neglected to log the information to disk.
  162.         This produces the following output in the long distance detail re-
  163.         port provided by LDSTAT:
  164.  
  165.                                Telix Log Analysis
  166.                           Long Distance Detail Report
  167.                               Generated 06-29-1993
  168.  
  169.         Date     System Called     Number       Time     Min.    Actual
  170.  
  171.         05/27/93 PC Resource    407 295-8884   9:31 PM          *Log Err*
  172.  
  173.  
  174.         What is important to note here is that the program, after encount-
  175.         ering a long distance entry, searches for the "Elapsed time" line
  176.         of the log file to correspond with that particular session.  If it
  177.         encounters another connection before it hits the "Elapsed" line,
  178.         you get the above resulting entry in the output file.  In fact,
  179.         while the program is running, it will display an error message.
  180.         LDSTAT(TM) will display all information pertaining to the call that
  181.         it possibly can, but obviously it cannot display information re-
  182.         garding elapsed time.
  183.  
  184.  
  185.         What follows is an example that will cause LDSTAT(TM) to display
  186.         nothing about the particular long distance session:
  187.  
  188.         93-06-23  22:34:31  Connected with : BBS America
  189.         93-06-23  22:34:31  ++ At phone #  : 1-555-699-8222
  190.         93-06-23  22:34:31  ++ Settings    : 2400,N,8,1
  191.         93-06-23  22:35:00  Upload using Zmodem protocol.
  192.         93-06-23  22:35:00  ++ File : C:\TELIX\UPLOAD\WIDGET.ZIP
  193.         93-06-23  22:35:09  ++ Chars per second : 323
  194.         93-06-23  22:35:25  Download using Zmodem protocol.
  195.         93-06-23  22:35:26  ++ File : C:\TELIX\DOWNLOAD\whatever.zip
  196.         93-06-23  22:35:46  ++ Chars per second : 227
  197.         93-06-23  22:35:55  Exiting Telix.
  198.         93-06-23  22:35:55  Telix Usage Log Closed.
  199.         93-06-23  22:40:50  Telix Usage Log Opened.
  200.         93-06-23  22:40:52  Elapsed time online 00:00:00
  201.  
  202.  
  203.         LDSTAT(TM)                                                        4
  204.  
  205.  
  206.         The key here is the last line: "...Elapsed time online 00:00:00".
  207.         When LDSTAT(TM) encounters what it thinks is a session of no dura-
  208.         tion, it displays no information to the output file concerning that
  209.         particular call, since this program is designed only to provide in-
  210.         formation about calls in which an actual long distance connection
  211.         was made.  Notice that after the call, Telix was exited and it had
  212.         not displayed the duration of the previous call.  Subsequently,
  213.         Telix was reloaded, and for reasons unknown it displayed the last
  214.         line, even though no call was placed.  Since LDSTAT(TM) encountered
  215.         this line before it detected another connection, it caused it to
  216.         loop out of its subroutine that performs such checking, and to re-
  217.         turn to looking for new long distance entries.
  218.  
  219.  
  220.         Registration & Distribution
  221.         ───────────────────────────
  222.  
  223.         LDSTAT(tm) is a "shareware program" and is provided at no charge
  224.         to the user for evaluation.  Users are free to share this program
  225.         with others, but are not allowed to distribute the program altered
  226.         or as part of another system, or software package.
  227.  
  228.         To aid the continued development of LDSTAT(TM), and other products
  229.         from Personal Computing Resource, a registration fee of $10.00 is
  230.         required from non-commercial users of this product, after a 30 day
  231.         evaluation period.  The $10.00 registration will license one copy
  232.         for use by a single user on any one computer at any one time.
  233.  
  234.         Commercial users of LDSTAT(TM) must register and pay for their co-
  235.         pies within 30 days of first use or their license is withdrawn.
  236.         Site-license arrangements may be made by contacting Personal Com-
  237.         puting Resource.
  238.  
  239.         Anyone distributing LDSTAT(TM) for any kind of remuneration must
  240.         first contact Personal Computing Resource at the address below for
  241.         authorization.  This authorization will be automatically granted
  242.         upon request and such distributors may begin offering LDSTAT(TM)
  243.         immediately.  Personal Computing Resource must still be advised so
  244.         that the distributor can be kept up-to-date with the latest version
  245.         of LDSTAT(TM).
  246.  
  247.         All registered users will receive a copy of the latest version of
  248.         LDSTAT(TM), and will be given a user account on The PC Resource BBS
  249.         where they can obtain subsequent updates, free of charge, through
  250.         version 1.XX.  A registration form is contained within this ar-
  251.         chive and is named REGISTER.FRM
  252.  
  253.         The version of LDSTAT(TM) contained within this archive is in no
  254.         way "crippled", and is fully functional.
  255.  
  256.  
  257.         LDSTAT(TM)                                                        5
  258.  
  259.         Reaching The Author
  260.         ───────────────────
  261.  
  262.                BBS: The PC Resource BBS
  263.                     (407)295-8884
  264.         CompuServe: 71223,431
  265.            Fidonet: 1:363/32 (Address as: Gregory Shultz)
  266.          U.S. Mail: Gregory E. Shultz
  267.                     PC Resource
  268.                     P.O. Box 681618
  269.                     Orlando, Florida 32868
  270.  
  271.                                 **END**
  272.  
  273.