home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / inettime.zip / README.TXT < prev    next >
Text File  |  1998-01-28  |  10KB  |  133 lines
  1. /**************************************************************************/
  2. /*                                                                        */
  3. /* INETTIME.cmd - Procedure to summarize by month all connect time to the */
  4. /*                Internet using the IPDIALER.LOG as input data.          */
  5. /*                                                                        */
  6. /* Version:       2.0                                                     */
  7. /* Last Update:   January 28, 1998                                        */
  8. /*                                                                        */
  9. /* Copyright (c) D.A.Ritari-KNIGHT RESEARCH - 1995 - ALL RIGHTS RESERVED  */
  10. /*                                                                        */
  11. /* FREELY DISTRIBUTABLE FOR ANY USE OR PURPOSE.                           */
  12. /* NO WARRANTY OF MERCHANTABILITY OR FITNESS FOR ANY PURPOSE IMPLIED.     */
  13. /*                                                                        */
  14. /*                                                                        */
  15. /* CONTACT:   Constructive comments and tips to:                          */
  16. /*                Internet:    dritari@ibm.net                            */
  17. /*                                                                        */
  18. /* FOR:       Warp Internet Users who want to know how much 'connect'     */
  19. /*            time they've used this month on IBM's Advantis Network.     */
  20. /*            (NOT for ALTERNATE-DIALER Users).                           */
  21. /*                                                                        */
  22. /* PURPOSE:   This small REXX program searches for the Internet connect   */
  23. /*            log on all available drives, and reads thru all the         */
  24. /*            entries in the log (in the file \mptn\etc\IPDIALER.LOG)     */
  25. /*            and SUMMARIZES the 'connect' time by month...quickly letting*/
  26. /*            you know how much time you've used this month. (I haven't   */
  27. /*            found a similar function with the Warp Internet bonus       */
  28. /*            pack apps). Assumptions are that you are using the SLIP     */
  29. /*            standard 'Dialer' app, that you have logging turned on,     */
  30. /*            and that the log file is set big enough to record more than */
  31. /*            a few connects. As this is a REXX application, you must     */
  32. /*            have REXX installed on your PC to run the program, and      */
  33. /*            if you prefer a PM-style application, it can be also run    */
  34. /*            using PMREXX. Testing of this app was minimal...if you      */
  35. /*            find that it doesn't run on your system, let me know or     */
  36. /*            modify it to your hearts content.                           */
  37. /*                                                                        */
  38. /*                                                                        */
  39. /* TO RUN:    At the 'C>' prompt:   INETTIME   (no parms needed)          */
  40. /*            At the 'C>' prompt:   INETTIME C:\mydir\IPDIALER.LOG        */
  41. /*            or for PMREXX usage:  PMREXX INETTIME.CMD                   */
  42. /*                                                                        */
  43. /*                                                                        */
  44. /* UPDATES:   Version 1.0 - Original Release - January 25, 1995           */
  45. /*            Version 1.1 - Inadvertently left off last entry in log.     */
  46. /*                          This corrected original error.                */
  47. /*            Version 1.2 - Variety of fixes for 'connect.log' files      */
  48. /*                          which have missing carriage returns, spliced  */
  49. /*                          lines, broken lines etc., which caused the    */
  50. /*                          calculations to abend. Also, added better     */
  51. /*                          lookup of where connect.log exists by using   */
  52. /*                          the environment 'ETC' parm if it exists.      */
  53. /*            Version 1.3 - Added new YEAR information added to log       */
  54. /*                          entries available with DIALER version 1.45.   */
  55. /*                          Also, Dialer-1.45 LOCKS the CONNECT.LOG file  */
  56. /*                          and keeps it locked, even after you hangup.   */
  57. /*                          An error message was added advising you to    */
  58. /*                          close the Dialer app before running INETTIME. */
  59. /*            Version 2.0 - Changed default name of logfile for the newer */
  60. /*            JAN/1998      IBM Dialer - 1.69 or greater...IPDIALER.LOG   */
  61. /*                          (was CONNECT.LOG). Changed search directory   */
  62. /*                          to \mptn\etc from \tcpip\etc directory. Fixed */
  63. /*                          date error in December...always showed the    */
  64. /*                          new year instead of the old year (Thanks      */
  65. /*                          Tom for the error report). IF you are still   */
  66. /*                          using the old dialer, either rename the log   */
  67. /*                          in the dialer setup to IPDIALER.LOG or change */
  68. /*                          the source code at the start of the program   */
  69. /*                          in the LOGNAME entry...remarked statement     */
  70. /*                          already provided, or override the name of the */
  71. /*                          log by running INETTIME with the fulle path...*/
  72. /*                              INETTIME C:\mptn\etc\connect.log          */
  73. /*                                                                        */
  74. /* PROBLEMS:  Do not use this program if you ONLY use the Alternate       */
  75. /*            Dialer (AD). The AD does NOT produce a IPDIALER.LOG to      */
  76. /*            summarize (INETTIME won't be able to find the log).         */
  77. /*                                                                        */
  78. /*            If INETTIME reports that it can't find your IPDIALER.LOG    */
  79. /*            file OR you have MULTIPLE ipdialer.log files and you don't  */
  80. /*            want a report on the first one it finds, specify the name   */
  81. /*            of the log on the command line when you run the program...  */
  82. /*                INETTIME   R:\example\other\backup\IPDIALER.LOG         */
  83. /*            for example (or whereever you keep you IPDIALER.LOG file).  */
  84. /*                                                                        */
  85. /*            If the INETTIME report has a month with '???' in it, your   */
  86. /*            IPDIALER.log file is corrupted on one or more entries.      */
  87. /*            A normal log entries looks like the following line:         */
  88. /*                                                                        */
  89. /*    12/11 17:22:37 Disconnected after 01:14:01  0 errors  0 discards    */
  90. /*                                                                        */
  91. /*            A corrupted line might look like the following:             */
  92. /*                                                                        */
  93. /*    xxxxx 17:22:37 Disconnected af                                      */
  94. /*    ter 01:14:01  0 errors  0 discards                                  */
  95. /*                                                                        */
  96. /*            As you can see, the log entry has (somehow) gotten split    */
  97. /*            into two lines...INETTIME will find the 'Disconnected'      */
  98. /*            line BUT there is no time to report and the date field      */
  99. /*            contains X's...the program will not abend...will attempt    */
  100. /*            to summarize the data on a '???' month and continues.       */
  101. /*            If you can edit the ipdialer.log file and straight out      */
  102. /*            the entries, future reports will summarize correctly.       */
  103. /*            (See caution below on editing the log).                     */
  104. /*                                                                        */
  105. /* LOG SIZE:  In the Dialer, I strong suggest that you set IPDIALER.LOG   */
  106. /*            size to an amount LARGER THAN 10K...I suggest at least      */
  107. /*            50K for 6 months of log activity. Also, I edit the log      */
  108. /*            occasionally to remove old month's activities (instead of   */
  109. /*            just letting the dialer arbitrarily 'trim' back your log).  */
  110. /*            (See caution below on editing the log).                     */
  111. /*                                                                        */
  112. /* CAUTIONS:  Do not edit your IPDIALER.LOG file with an ASCII editor     */
  113. /*            which puts an END-OF-FILE (EOF) mark at the end of the      */
  114. /*            file! The IBM dialer program will write log entries AFTER   */
  115. /*            this mark and you will not be able to see new log entries   */
  116. /*            using INETTIME or other ASCII-based programs (or just       */
  117. /*            'TYPE ipdialer.log') in the future. Either remove the EOF   */
  118. /*            character or erase the log and let the dialer build you     */
  119. /*            a new one for future use...A remove-end-of-file-mark        */
  120. /*            program has been included for this purpose...See REMOVEOF.  */
  121. /*                                                                        */
  122. /**************************************************************************/
  123. INETTIME.CMD - Version 2.0 - January 28, 1998
  124. -Small REXX proc for OS/2 to summarize
  125.  by month all connect time to IBM's Advantis
  126.  Internet network using the IPDIALER.LOG as
  127.  input data. (See INETTIME.TXT for details).
  128. REMOVEOF.cmd - Version 1.0 - March 2, 1995
  129. -Procedure to remove any/all extraneous
  130.  End-Of-File (EOF) marks from an ASCII text
  131.  file. (See REMOVEOF.TXT for details).
  132. Copyright(c) D.A.Ritari-KNIGHT RESEARCH-1995
  133.