home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / u2txt11.arj / U2TXT.DOC < prev    next >
Text File  |  1991-01-06  |  10KB  |  284 lines
  1.  
  2.  
  3.                           INFORMATION SYSTEMS SOFTWARE
  4.  
  5.                                  User -2- Text
  6.                                  version 1.10
  7.                                 Copyright @ 1991
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.             This program is actually part of a "greater" program under
  16.      development, but due to a request, this section has been separated and
  17.      released on it's own.  I make no claims to it NOT destroying things on
  18.      your system, but from the tests I, and others have done, nothing "bad"
  19.      has happened.  But one never knows...
  20.  
  21.  
  22.             Simply, this program will read your USERS.BBS file (RA, QuickBBS &
  23.      maybe others) and write out a variety of ASCII text files with the
  24.      information.
  25.  
  26.  
  27.  
  28.                                -= REGISTRATION =-
  29.  
  30.            Yup... let's go with $100.00 for each copy you use... :-)  Actually,
  31.      if you would just let us know you are using it, via NETMAIL, we'd kind of
  32.      like to know.  Other than that, it's entirely up to you.  Now, of course,
  33.      since there are other programs being put out by us (ISS), it might be nice
  34.      to register this, since people who register one "ISS" program, will gener-
  35.      ally get a discount (when applicable) on other programs.
  36.      Hint, hint...
  37.  
  38.      All questions, problems, etc., concerning registrations will be handled by
  39.      Doris Zagorski so...
  40.  
  41.      Registration NetMail may be sent to:    Or, for those who wish, a postcard:
  42.  
  43.      Doris Zagorski                          Doris Zagorski  C/O
  44.                                              Information Systems Software
  45.      FidoNet  - 1:322/235                    656 Old West Central Street
  46.      RBBS-NET - 8:906/201                    Franklin, Ma.  02038
  47.              or 8:906/1000
  48.  
  49.  
  50.      INFORMATION SYSTEMS SOFTWARE
  51.      User -2- Text Documentation
  52.      Page 2
  53.  
  54.                            -= PROGRAM INFORMATION =-
  55.  
  56.      Within the archive, you should have received the following files:
  57.  
  58.      U2TXT.EXE   <--- Main program.
  59.      U2TXT.DOC   <--- This documentation.
  60.      SAMPLE.CFG  <--- Sample (optional) configuration file.
  61.      CHANGES.DOC <--- A list of little improvements, changes, etc., from each
  62.                       version.
  63.  
  64.          If any of these files are missing, please grab a new copy someplace, or
  65.      you may request one from an ISS Support System.  See Appendix A.
  66.  
  67.  
  68.  
  69.                            -= RUNNING THE PROGRAM =-
  70.  
  71.           There are two ways to run U2TXT.  The "first" is in it's "Stand
  72.      Alone" mode (fancy??).  In this mode, the program will ask for the
  73.      information it needs and procede from there.  The other way, is via it's
  74.      "Unattended" mode, which involved including a configuration file name on
  75.      the command line when you run U2TXT.
  76.  
  77.                       
  78.      - STAND ALONE -
  79.  
  80.           Command Line:  U2TXT
  81.  
  82.           When the program first comes up, it asks you for some information.
  83.      First thing it wants to know is where your USERS.BBS file is located.  You
  84.      need to enter in the full path and NAME to the USERS.BBS file.
  85.  
  86.      - What is the Path and name to the Users.BBS file: -
  87.  
  88.      C:\RA\USERS.BBS
  89.  
  90.  
  91.           The next question concerns the path and file name of the ASCII output
  92.      file you want created.  If you want it to go to the same directory you run
  93.      U2TXT from, just enter the name of the file you want.  If you want it
  94.      someplace else, put in the path as well.
  95.  
  96.      - What is the Path and name of the Text file you want created? -
  97.  
  98.      USERS.TXT          <--- Will create a file called users.txt in the same
  99.                              directory.
  100.  
  101.      C:\TEMP\USERS.TXT  <--- Will create a file called users.txt in the
  102.                              directory "TEMP".
  103.  
  104.  
  105.           The next question concerns whether you want to filter your output by
  106.      security level.  If you say Yes "Y" to this a question will come up asking
  107.      what security level you wish to use.  If you answer No "N", then it will
  108.      drop to the last section for determining the type of output you want.  The
  109.      output will be for all those equal to or less than the security level
  110.      chosen at the next question.
  111.      
  112.      - Do you want to filter the output by security level (Y/N)? -
  113.  
  114.  
  115.      INFORMATION SYSTEMS SOFTWARE
  116.      User -2- Text Documentation
  117.      Page 3
  118.  
  119.           If you answered "Y" to the previous question, you will be asked what
  120.      security level you want to filter your output on.  You MUST enter a value
  121.      (whole number) between 1 - 32000 at this question.  The program becomes
  122.      rather persnickity at this question.  Just pressing the <ENTER> key will
  123.      do nothing for you and it will just keep waiting for an appropriate
  124.      answer.  Entering anything other than a whole number here (between 1 -
  125.      32000) will only cause the program to do funny things.  The choice is
  126.      yours and yours alone.
  127.  
  128.      - Enter the Highest Security Level you want listed (1 - 32000): -
  129.  
  130.  
  131.           The next question will concern the "information" included in the
  132.      output file.  Currently, there are five choices.
  133.  
  134.  
  135.      1.  Most all the information from the Users.bbs file, usefull or not.
  136.      2.  Most of the information which "seems" useful.
  137.      3.  Less information.
  138.      4.  The least amount of information.
  139.      5.  Single line, double spaced...
  140.  
  141.            ***** Note - See Appendix B for examples of outputs... *****
  142.  
  143.  
  144.  
  145.      - UNATTENDED -
  146.  
  147.           Command Line:   U2TXT Sample.cfg
  148.  
  149.           In this mode, U2TXT will get it's information from the file
  150.      "SAMPLE.CFG" and run without interruption, producing the output stated in
  151.      the configuration file.  The config file, is a standard ASCII text file,
  152.      consisting of four lines.  You have the same choices for input, output and
  153.      selection, except in this case, those choices are placed in the config
  154.      file.
  155.  
  156.      SAMPLE.CFG
  157.  
  158.      E:\RA\USERS.BBS     <--- Path and filename to the USERS.BBS file.
  159.      E:\TEMP\USERS.TXT   <--- Path and filename for the ASCII output file.
  160.      5                   <--- Output selection level.
  161.      32000               <--- Highest Security Level.
  162.  
  163.  
  164.  
  165.                            -= SOME FINAL THOUGHTS =-
  166.  
  167.           Should you have any questions concerning this program and or ideas on
  168.      improvements, I'm reachable in the BBS_UTIL Echo, RA_UTIL Echo, QuickBBS
  169.      Echo and via NetMail at:
  170.  
  171.      FidoNet  - 1:322/235                                  RBBS-Net - 8:906/201
  172.  
  173.      Thanks.
  174.  
  175.      John Bierrie
  176.      ISS
  177.  
  178.      INFORMATION SYSTEMS SOFTWARE
  179.      User -2- Text Documentation
  180.      Page 4
  181.  
  182.                                 -= APPENDIX A =-
  183.  
  184.                                 SUPPORT SYSTEMS
  185.  
  186.      These are the Primary ISS Support Systems and will always have the
  187.      current version of U2TXT available for file request using the magic
  188.      name of U2TXT.
  189.  
  190.      Doc's Place BBS                             The Cold Zone
  191.      Franklin, MA                                Monroe, WI
  192.  
  193.      508-528-7465                                608-328-8202
  194.  
  195.      FidoNet  - 1:322/235                        FidoNet  - 1:11/717
  196.      RBBS-Net - 8:906/201                        RBBS-Net - 8:972/406
  197.              or 8:906/1000
  198.  
  199.  
  200.  
  201.  
  202.                                 -= APPENDIX B =-
  203.  
  204.  
  205.                            EXAMPLES OF OUTPUT FORMAT
  206.  
  207.  
  208.  
  209.      Selection 1:
  210.      ************
  211.  
  212.      User #: 1         [ John Bierrie ]
  213.  
  214.      City: Franklin, Ma     Password: XXXXXX     Security Level: 101
  215.                                                                
  216.      Home Phone: XXX-XXX-XXXX     Data Phone: 508-520-4574
  217.                                                                
  218.      Times On: 1719   Last On (date/time): 12-29-90 / 09:12  For 4 mins.
  219.                                                                
  220.      Posted: 999 msgs.  NetMail Credit: 4500 cents   High Msg Read: 2229
  221.                                                                
  222.      Uploaded: 6 Times     121 Kbytes.
  223.  
  224.      Downloaded: 5 Times     420 Kbytes.
  225.  
  226.      Transfered: 0 Kbytes the last time on.
  227.  
  228.      INFORMATION SYSTEMS SOFTWARE
  229.      User -2- Text Documentation
  230.      Page 5
  231.  
  232.      Selection 2:
  233.      ************
  234.  
  235.      User #: 1         [ John Bierrie ]
  236.  
  237.      City: Franklin, Ma     Password: XXXXXX     Security Level: 101
  238.                                                                
  239.      Home Phone: XXX-XXX-XXXX     Data Phone: 508-520-4574
  240.                                                                
  241.      Times On: 1719         Last On (date/time): 12-29-90 / 09:12
  242.                                                                
  243.      Posted: 999 msgs.           NetMail Credit: 4500 cents
  244.                                                                
  245.      Uploaded: 6 Times     121 Kbytes.
  246.  
  247.      Downloaded: 5 Times     420 Kbytes.
  248.  
  249.  
  250.  
  251.      Selection 3:
  252.      ************
  253.  
  254.      User #: 1         [ John Bierrie ]
  255.  
  256.      City: Franklin, Ma     Password: XXXXXX     Security Level: 101
  257.                                                                
  258.      Home Phone: XXX-XXX-XXXX     Data Phone: 508-520-4574
  259.                                                                
  260.      Times On: 1719         Last On (date/time): 12-29-90 / 09:12
  261.                                                                
  262.      Uploaded: 6 Times     121 Kbytes.    Downloaded: 5 Times     420 Kbytes.
  263.  
  264.  
  265.  
  266.      Selection 4:
  267.      ************
  268.  
  269.      User #: 1         [ John Bierrie ]
  270.  
  271.      City: Franklin, Ma     Password: XXXXXX     Security Level: 101
  272.                                                                
  273.      Home Phone: XXX-XXX-XXXX     Data Phone: 508-520-4574
  274.  
  275.  
  276.  
  277.      Selection 5:
  278.      ************
  279.  
  280.      John Bierrie   H-Phone: XXX-XXX-XXXX  D-Phone: 508-520-4574  Sec: 101
  281.  
  282.  
  283.                                   [ THE END. ]
  284.