home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / inetlg75.zip / README.TXT < prev   
Text File  |  2001-09-14  |  9KB  |  221 lines
  1. ReadMe.txt  from INETLG75.ZIP 04 Oct 2000 (c) Chuck McKinnis, Jerry Levy
  2. Please pass on comments, suggestions, problems.
  3.  
  4. Chuck McKinnis, Sandia Park, NM (USA)    mckinnis@attglobal.net
  5. Jerry Levy, Marblehead, MA (USA)
  6. ------------------------------------------------
  7.  
  8. Read the "Installation" Section for install information.
  9.  
  10. CONTENTS
  11.  
  12. 1.0   What is INetLog?
  13. 2.0   Installation
  14. 3.0   Defaults and run options
  15.       3.1   Run options
  16.       3.2   Defaults
  17. 4.0   Utilities
  18.       4.1   EOF2CRLF
  19.       4.2   INSTALL 
  20. 5.0   Copyright notice
  21. 6.0   Other things to do or check
  22. 7.0   Tips
  23. 8.0   Bugs, problems
  24.  
  25. 1.0   What is INetLog?
  26.  
  27.       INetLog is a REXX Program that extracts and totalizes daily and
  28.       monthly connection times for calls made using the IBM IGN dialer or
  29.       the In-Joy dialer.
  30.  
  31. 2.0   Installation
  32.  
  33.       After unzipping inetlgxx.zip, open an OS/2 window, navigate to the
  34.       directory you unzipped to, run INSTALL, and you are all ready to go.
  35.       To change INetLog parameters, run INSTALL.  The inetcfg.ini file
  36.       can be changed by editing INSTALL and changing the parameters in
  37.       the Config_sample: subroutine and running INSTALL and resetting
  38.       parameters to the defaults.  Not recommended for the novice and
  39.       pay attention to the comments.  To run INetLog, open its program
  40.       object.
  41.  
  42.       NOTE - If you run multiple OS/2 sessions from different partitions
  43.       and/or multiple dialers (such as TCPDIAL).  we highly recommend
  44.       you point the log file setting on the logging page of the dialer
  45.       setup to a common log file to assure that you can analyze all
  46.       activity.  You may need to merge the separate existing logs into
  47.       the combined log.
  48.  
  49.       Read carefully the notes about messing around with the connection
  50.       log. You will need to run EOF2CRLF.CMD with the fully qualified
  51.       names of the input (the one you messed with) and output log files
  52.       as parameters after editing your new connection log.
  53.  
  54. 3.0   Defaults and run options
  55.  
  56.       3.1   Run options
  57.  
  58.             The following are acceptable command-line parameters (case
  59.             is ignored.
  60.  
  61.             QUIET - Run without output to screen, default is to output
  62.                results to the screen
  63.  
  64.             COMBINED - Produce a combined output summary listing of both
  65.                IGN and InJoy results in addition to other output.
  66.  
  67.             COMBINEONLY - Produce only a combined summary listing of the
  68.                both the IGN and InJoy results.
  69.  
  70.       3.2   Defaults
  71.  
  72.             The defaults are stored in inetcfg.ini, and the major ones
  73.             may be changed by running INetCfg.
  74.  
  75.             cfg_common - parameters common to all runs
  76.  
  77.                ibm_dialer - process IBM dialer logs (1 = yes, 0 = no)
  78.                   default is null
  79.  
  80.                injoy_dialer - process InJoy dialer logs (1 = yes, 0 = no)
  81.                   default is null
  82.  
  83.                data_path - path to data files - normally x:\inetlog\data
  84.  
  85.                daily_report - display daily reports (1 = yes, 0 = no)
  86.                   default is no
  87.  
  88.                warn_pct - warn if the IBM dialer log exceeds this
  89.                   percentage of the size specified for the log
  90.                   default is 85
  91.  
  92.                sig_x - significant digits for connects/day or conects/month
  93.                   default is 4
  94.  
  95.                sig_min - ... for minutes/day or minutes/month
  96.                   default is 7
  97.  
  98.                sig_hr - ... for hours/day or hours/month
  99.                   default is 6
  100.  
  101.             cfg_inetlog - parameters used for processing IBM dialer logs
  102.  
  103.                ibm_dialer_ini_file - name of the IBM dialer ini file
  104.                   default is dialer.ini or tcpdial.ini depending upon
  105.                   the dialer you use
  106.  
  107.                ibm_output_file - output file for IBM dialer detail report
  108.                   default is inetlog.log in data_path
  109.  
  110.                ibm_summary_file - output file for IBM dialer summary report
  111.                   default is inetsum.log in data_path
  112.  
  113.                ibm_last_time_stamp - time stamp for last processed record
  114.                   of IBM dialer log - initialized to T00000000000000
  115.                   (yyyymmddhhmmss) and updated by each run
  116.  
  117.             cfg_ijoylog - parameters used for processing InJoy dialer logs
  118.  
  119.                injoy_logs - full path(s) to the InJoy dialer log file(s)
  120.                   default is null - for each log there will be a 
  121.                   corresponding entry in injoy_accts, injoy_users, and injoy_times
  122.  
  123.                injoy_accts - account(s) for the InJoy dialer log file(s)
  124.                   default is null - if an account is not specified, the
  125.                   value will be set to (none)
  126.  
  127.                injoy_users - users(s) for the InJoy dialer log file(s)
  128.                   default is null
  129.  
  130.                injoy_times - time stamp(s) for the InJoy dialer log file(s)
  131.                   initialized to T00000000000000 (yyyymmddhhmmss) and
  132.                   updated by each run
  133.  
  134.                injoy_output_file - output file for InJoy dialer detail
  135.                   report - default is ijoylog.log in data_path
  136.  
  137.                injoy_summary_file - output file for InJoy dialer summary
  138.                   report - default is ijoysum.log in data_path
  139.  
  140. 4.0   Utilities
  141.  
  142.    4.1   EOF2CRLF
  143.  
  144.          If you edit a dialer log with the IBM system editor, it will
  145.          write an eof character at the end of the file.  Subsequent
  146.          executions of INetLog will not read beyond that point.  The
  147.          eof2crlf.cmd can be used copy a file on a character by
  148.          character basis and replace the erroneous eof character with a
  149.          normal carriage return and line feed.
  150.  
  151.    4.2   INSTALL
  152.  
  153.          This utility is used to install INetLog and can be run to update
  154.          the INetLog parameters.
  155.  
  156. 5.0   COPYRIGHT NOTICE
  157.  
  158.       This program is copyright by us (1995 - 2001).  We intend it as
  159.       Freeware, and it may be distributed freely.  We only ask that if
  160.       you build upon it or modify it and distribute a modified version,
  161.       you credit INetLog and us as a source.  Naturally, if we can be of
  162.       help in a modification, we will be pleased to do so.  No warranty
  163.       of merchantability or fitness for any purpose of any kind is
  164.       expressed or implied.
  165.  
  166. 6.0   Other things to do or check
  167.  
  168.       IBM dialer - You must, of course, have set up your IBM dialer for
  169.       logging.  Upon installation of the TCP/IP stuff supplied with IBM
  170.       Warp, a small connection logfile is enabled for the IBM dialer.
  171.  
  172.       If you are using the dial other internet providers package, sorry,
  173.       it doesn't provide for any connection logging.
  174.  
  175.       The Logging Page of the Settings Notebook for the IBM dialer allows
  176.       you to enable or disable logging and to change the size, name and
  177.       location of the logging file.  The logfile can be set anywhere in
  178.       size from 5K to unlimited size.  100K will preserve information on
  179.       about 300 logins.  The summary facilities in INetLog should allow
  180.       you to run with a setting of 10-20K. If your Dialer doesn't have a
  181.       Logging Page in the Settings Notebook, get the latest Dialer
  182.       upgrade (go to the IGN Customer Service folder to go about
  183.       downloading it).
  184.  
  185.       InJoy dialer - The InJoy dialer maintains connection logs for each
  186.          host.  INetCfg will read the InJoy sub-directory to find the
  187.          default configuration and its log and any logs associated with
  188.          any other hosts found in hosts.dat.  Summary reports are based
  189.          upon account ids and user ids, and you will be asked to furnish a
  190.          account id for any host that does not have one.
  191.  
  192. 7.0   Tips
  193.  
  194.       Because the summary files contain everything needed to continue to
  195.       accumulate connection information, you can use the IBM tiny system
  196.       system editor (tedit.exe) to clean up your connection logs.  After
  197.       running INetLog, you can delete all of the connection entries in a log
  198.       if you are not interested in daily analysis (turned off by default).  I
  199.       do not recommend that you delete the log.
  200.  
  201.       You can also edit the summary logs (inetsum.log and ijoysum.log)
  202.       in the IBM tiny system editor (tedit.exe) and eliminate the monthly
  203.       summary records that are no longer of interest.  I usually eliminate
  204.       records that pertain to this year minus 2.  This could be done by the
  205.       INetLog processing, but I chose not to do so.
  206.  
  207. 8.0   Bugs, problems
  208.  
  209.       None that I'm now aware of.
  210.  
  211.       If you modify the program, the fact output is saved till the very
  212.       end makes debugging harder, and the error-trapping with the signal
  213.       calls can be problematic as well.  You may want to comment out or
  214.       turn off all of the signal calls until your mod works as planned.
  215.       This may make it easier to spot where a modified program is going
  216.       south. Then when you've made and tested your changes, build
  217.       error-trapping back in with the signal calls re-enabled.
  218.  
  219. Chuck McKinnis, Sandia Park, NM (mckinnis@attglobal.net)
  220. Jerry Levy, Marblehead, MA
  221.