home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / WILDCAT / CONFXREF.ZIP / CONFXREF.DOC < prev    next >
Text File  |  1994-01-22  |  7KB  |  152 lines
  1.  
  2.                                C O N F X R E F
  3.                                + + + + + + + +
  4.                                      by
  5.                               Michael A. Conley
  6.               version 1.20                       Compiled 01/22/94
  7.  
  8.            CONFXREF is NOT compatible with Wildcat! versions before 3.0
  9.  
  10.                   A public domain utility for Wildcat! SysOps
  11.                          from the Charlatan's Cabin BBS        
  12.                                  (213) 654-7337
  13.  
  14. WHAT IT DOES:
  15. =============
  16. CONFXREF produces a detailed report of your local and various echo mail 
  17. conferences which allows you to quickly detect conference numbering or
  18. naming errors.  It collects information from a variety of sources, including
  19. Wildcat!'s CONFDESC.DAT file, your Tomcat! configuration file, your TNET,
  20. POSTLINK, WILDMAIL and GOMAIL configuration files, and even the CONTROL.DAT 
  21. files found in .QWK packets.
  22.  
  23. Here's a segment of a typical report:
  24.  
  25. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  26.                            The Charlatan's Cabin BBS
  27.  
  28.                    CONFERENCE CROSS REFERENCE LIST - Page 1 
  29.  
  30. CONF                                    TOMCAT         HUB          HUB  
  31. NBR.         DESCRIPTION                 NAME         NUMBER    DESCRIPTION
  32. ===========================================================================
  33.   0: Main Board/Comments  [LO]        Comments
  34.   1: User to User mail    [LO]        UserMail
  35. 101: Wildcat Discussion   [IN]        Wildcat!_I         34     Wildcat!
  36. 102: Cooking              [IN]        Cooking__I        110     Cooking
  37. 103: Entertainment        [IN]        Entertn__I         74     Entertain
  38. 104: For Sale             [IN]        ForSale__I         38     For-Sale
  39.  
  40. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  41.  
  42. SETTING UP:
  43. ===========
  44. First, be sure that MAKEWILD.DAT and CONFDESC.DAT are in a directory that is
  45. in your DOS path.  Also be sure that you have BRUN40.EXE available in the 
  46. path.  This Microsoft runtime module is required for the program to run.  
  47. If you don't already have it, it's probably available on the BBS where you 
  48. got this program, or you may call the Charlatan's Cabin BBS.  See below for 
  49. details.
  50.  
  51. Step 1:  Edit the supplied CONFXREF.CFG file to produce a listing of the
  52.          files you want to check.  These can include TNET config files,
  53.          CONTROL.DAT files extracted from .QWK packets, POSTLINK's
  54.          CONFLST.RLY file, WILDMAIL's WMAREAS.DAT file, and GOMAIL's
  55.          GOCONF.DAT file. 
  56.  
  57. Step 2:  Extract CONTROL.DAT from a current .QWK file from your hub.  If you
  58.          call more than one hub, rename each CONTROL.DAT to match the TNET
  59.          configuration file it is associated with.  For example, if your 
  60.          hub configuration is: BIGBOARD.CFG, then you should extract the
  61.          CONTROL.DAT file from the .QWK and rename it BIGBOARD.DAT.  Do this
  62.          for each TNET configuration file, and place the .DAT files in the
  63.          same directory where it's matching .CFG file is located.
  64.  
  65. Step 3:  Make sure that TOMCAT.CFG, CONFDESC.DAT, and MAKEWILD.DAT are in your
  66.          DOS path.
  67.  
  68.  
  69. SAMPLE CONFXREF.CFG:
  70. ====================
  71.  
  72. TNET=C:\WC30\MOGUR.CFG /DAT
  73. GOMAIL=C:\WC30\GOCONF.DAT
  74. TNET=C:\WC30\SKELETON.CFG /DAT 
  75. TNET=C:\WC30\HOTLINE.CFG /DAT
  76. TNET=C:\WC30\WLA.CFG /DAT
  77. WILDMAIL=C:\WC30\WMAREAS.DAT
  78. POSTLINK=D:\POSTLINK\CONFLST.NET
  79.  
  80. | The lines above represent the complete drive/path/filename of your echomail
  81. | system reference files.  See the documentation for a detailed description
  82. | of how these are processed.
  83. | 
  84. | ONLY the TNET lines may contain the optional switch "/DAT" ... which 
  85. | indicates that you've extracted a CONTROL.DAT from a current .QWK packet
  86. | for that particular configuration, and RENAMED IT to match the name of
  87. | the associated configuration file.  For example, if you import a packet
  88. | named MOGUR.QWK, you'd do the following:
  89. |
  90. | PKUNZIP MOGUR.QWK CONTROL.DAT
  91. | IF EXIST MOGUR.DAT DEL MOGUR.DAT
  92. | REN CONTROL.DAT MOGUR.DAT
  93. |
  94. | Be sure to place each of these .DAT files in the same directory where the
  95. | matching .CFG file exists.
  96.  
  97. (end of typical configuration file)
  98.  
  99. RUNNING THE PROGRAM:
  100. ====================
  101.  
  102. Start CONFXREF with no command line switches.  It will load your conference
  103. definitions from CONFDESC.DAT and then read the CONFXREF.CFG file you've
  104. just edited, to determine the locations of the various files.
  105.  
  106. CONFXREF will read all of the files, and then produce the output file, 
  107. called "CONFXREF.RPT"  This is a plain ASCII file and may be copied 
  108. directly to your printer, if desired.  There are form feeds at each 
  109. page break.
  110.  
  111. ------------------------------------------------------------------
  112. PROBLEMS, SUGGESTIONS:
  113.  
  114. This program is public domain.  I don't seek or accept any donations or 
  115. registration fees for any of my Wildcat! utility programs, including 
  116. TODAYBBS, FLOP, NETBULL, USTAT, and others ... however I invite you to
  117. read the short textfile "CHARWARE.TXT" enclosed in this ZIPfile.  It 
  118. suggests that you make a contribution to YOUR favorite charity if you 
  119. find this program useful.
  120.  
  121. I welcome suggestions, and will try to help (no guarantees) if there are
  122. problems.
  123.  
  124. You may contact me at The Charlatan's Cabin BBS  (213) 654-7337.  Mention
  125. your Wildcat! registration number in the comment and you'll be upgraded to
  126. visiting sysop level without the usually required registration by mail.
  127.  
  128. My Internet address is:    michael.conley@cabin.com
  129.  
  130. You may also leave a message via CompuServe EMail. My CompuServe account 
  131. number is 70250,220.  I also regularly check the Mustang Software head-
  132. quarters BBS, especially the "3rd Party Utilities Help" conference.
  133.  
  134. Please, NO VOICE CALLS.  This isn't meant to be unfriendly, but with the 
  135. price of public domain software these days ... I just can't afford to be 
  136. "on call."  I WILL respond to your questions via my BBS, Internet,
  137. CompuServe, or via the Mustang Software registered SysOp BBS.
  138.  
  139. REVISION HISTORY:
  140. =================
  141. Version 1.00    Compiled  8/22/92       First general release.
  142. Version 1.01    Compiled 11/01/92       Bug fix, occasional error determining
  143.                                         maximum conference number.
  144. Version 1.10    Compiled 02/28/93       Revised operation to include the 
  145.                                         ability to reference files in 
  146.                                         addition to TNET.  A configuration
  147.                                         file was added to the operation.
  148. Version 1.20    Compiled 01/22/94       Handles newer format CONTROL.DAT
  149.                                         files with 14-character conference
  150.                                         names.  Also, added support for
  151.                                         WILDMAIL's WMAREAS.DAT reference file.
  152.