home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / trimcc20.zip / TRIMCC.DOC < prev    next >
Text File  |  1993-10-08  |  11KB  |  253 lines
  1. ---------------------------------------------------------------------
  2.                               TRIMCC v2.0f
  3.                           By:  Mark W. Johnson
  4.                           Copyright April 1993
  5.      Written and compiled using MicroSoft Visual Basic for Dos v1.0
  6.  
  7. ---------------------------------------------------------------------
  8.  
  9. TriMCC is a TriBBS utility that will create a two column message
  10. conference and file listing for each call to your BBS.  This program is
  11. for use ONLY with TriBBS v5.0?.  DO NOT attempt to use it with earlier
  12. versions of TriBBS, TriMCC accesses USERS.SUP, this alone will cause the
  13. program to fail when used.  If you attempt to use TriMCC with TriBBS
  14. 4.0x the results will be unpredictable because of a change to the data
  15. structure of FAREA.DAT.
  16.  
  17.  
  18. This software is FREEWARE.  You are granted permission to freely
  19. distribute the TRIMCC archive, provided all the original files are
  20. kept together, and only a nominal fee is charged for copying.  No portion of
  21. TRIMCC may be changed or modified without the author's constent.
  22. The files in this archive should be:
  23.  
  24.             TRIMCC.EXE - program file
  25.             TRIMCFG.EXE - configuration file builder
  26.             TRIMCC.DOC - usage documentation
  27.             TRIMCC.CFG - sample config file
  28.             LOGON.BAT  - sample of logon batch file
  29.             FILE_ID.DIZ - BBS description file
  30.  
  31. Results of McAfee's validate program on TRIMCC.EXE:
  32.  
  33.           File Name:  trimcc.exe
  34.                Size:  61,440
  35.                Date:  10-8-1993
  36.           File Authentication:
  37.           Check Method 1 - 0B12
  38.           Check Method 2 - 06FD
  39.  
  40.  
  41. Results of McAfee's validate program on TRIMCFG.EXE:
  42.  
  43.           File Name:  trimcfg.exe
  44.                Size:  169,136
  45.                Date:  9-28-1993
  46.           File Authentication:
  47.           Check Method 1 - D22F
  48.           Check Method 2 - 1B1C
  49.  
  50. If any of these numbers do not match, you have an archive that may be
  51. corrupted.  Delete the archive and contact the person or BBS you
  52. received it from or the author.
  53.  
  54. What TriMCC does:
  55.  
  56.   TriMCC creates a two column listing of BBS message conferences and
  57.   file areas.  It will check for users access to areas by verifing both
  58.   security level and access to private areas.  I used read access as
  59.   the minimum requirement to see an area in the listing, so for those
  60.   of you with multiple security levels, callers will see any area that
  61.   they have read access to.
  62.  
  63.   Conferences and file areas can now be sorted!  Conferences can be
  64.   sorted by name and/or by network name.  I've not yet determined the
  65.   best way to sort file areas other than by name, but it's coming.
  66.  
  67.   TriMCC now allows the sysop to choose the text colors of choice for
  68.   conference numbers and text.  Default colors are the same as TriBBS
  69.   defaults.  The background color is black, I doubt if this will
  70.   change since I prefer a black ground, plus scrolling will be faster.
  71.  
  72.   Using the optional command line parameters -F and -C you can now stop
  73.   TriMCC from building screens for Files or Conferences.
  74.  
  75.  
  76. What TriMCC does not do:
  77.  
  78.   It does not display network status of message conferences.  Given the
  79.   length of some conference names, plus the network name(s) it would be
  80.   impossible to have a two column listing.  Once a caller changes to a
  81.   conference the status line displays the network name(s).
  82.  
  83.  
  84. Important safety tip:
  85.  
  86.   Due to the way TriBBS displays sysop created screens if you are
  87.   running a multinode BBS to avoid conflicts between callers with the
  88.   same security level you MUST use individual nodes display directory.
  89.   This means that you will have to copy all your displays to each node's
  90.   display directory.
  91.  
  92.   For those of you running a local node, the above will not apply IF
  93.   local logons do not have the same security level as remote callers.
  94.  
  95.  
  96. Setting up and running TriMCC:
  97.  
  98.   First create a configuration file by running Trimcfg:
  99.  
  100.   Command line for Trimcfg is: TRIMCFG [TRIMCC.CFG]
  101.  
  102.   If the filename is omitted from the command line TRIMCFG will create
  103.   TRIMCC.CFG.
  104.  
  105.   You will be presented with a screen displaying the following:
  106.    
  107.                    TriMCC Configuration Module v1.0                |||++
  108. |                                                                        |
  109. |          Current config: [TRIMCC.CFG               ]   +------------+  |
  110. |                                                        |    Save    |  |
  111. |         Main TriBBS dir: [C:\TRIBBS                ]   +------------+  |
  112. |                                                                        |
  113. |                Node dir: [C:\TRIBBS                ]   +------------+  |
  114. |                                                        |    Open    |  |
  115. |             Display dir: [C:\TRIBBS                ]   +------------+  |
  116. |                                                                        |
  117. |   Color of Conf. number: [Default        ]            +------------+  |
  118. |                                                        |    Quit    |  |
  119. |     Color of Conf. text: [Default        ]            +------------+  |
  120. |                                                                        |
  121. |    Color of File number: [Default        ]                            |
  122. |                                                                        |
  123. |      Color of File text: [Default        ]                            |
  124. |                                                                        |
  125. |            Clear Screen: [Yes    ]                                    |
  126. |                                                                        |
  127. |        Sort Conferences: [By Network  ]                               |
  128. |                                                                        |
  129. |         Sort File Areas: [No     ]                                    |
  130. |                                                                        |
  131. +------------------------------------------------------------------------+
  132.   
  133.   Current config --> file currently being edited
  134.   Main TriBBS dir --> refers to node 1's TriBBS dir
  135.   Node dir --> refers to the node calling Trimcc
  136.   Display dir --> refers to the display directory used by node
  137.   Color of Conf. number --> refers to the color of conf. numbers
  138.   Color of Conf. text --> refers to the color of conf. descriptions
  139.   Color of File number --> refers to the color of file area numbers
  140.   Color of File text --> refers to the color of the file area discriptions
  141.   Clear Screen --> inserts @CLS@ code at beginning of menu
  142.   Sort Conferences --> options for sorting message conferences
  143.   Sort File Areas --> sort file areas
  144.   Save button --> saves the current configuration
  145.   Open button --> allows you to open the current or different config file
  146.   Quit button --> exits TRIMCFG, will squawk if file not saved
  147.  
  148.   For those using an earlier version of TRIMCC, TRIMCFG should(?)
  149.   convert your old configuration files to the new format.  Don't forget
  150.   to save those changes.
  151.  
  152.   Of course for a single node 1 bbs, node and display should (may?) be
  153.   the same.
  154.  
  155.   I had some question as to why bbs, node and display are all required
  156.   in the configuration file.  BBS is pretty self explanitory, TriMCC
  157.   needs to know the where the main working files are at.  Node refers to
  158.   the node the user is coming in on, TriMCC uses TRIBBS.SYS (drop file
  159.   created when TriBBS exits memory to run doors and logon.bat) to get
  160.   information about the user (ie Name, security, etc).  Display refers
  161.   to the directory to store the generated screens.  Depending upon how
  162.   your system is configured, the display screens could be saved to either
  163.   the main or node directory.
  164.  
  165.  
  166.   Second create a logon batch file that calls TriMCC.exe.  The logon
  167.   batch file should look something like this:
  168.  
  169.   @echo off
  170.   d:
  171.   cd \bbs\util\trimcc
  172.   trimcc [trimcc.cfg] [-F] [-C]
  173.   c:
  174.   cd \tribbs
  175.   board
  176.  
  177.   The only requirement here is that TriMCC.EXE and *.CFG be in the same
  178.   directory.  If you use the configuration from an ealier version of
  179.   TRIMCC, the program will abort and no files will be created.  That's
  180.   all there is to it, TriMCC is up and ready to run.
  181.  
  182.   All command line parameters are optional, if you use the default
  183.   configuration.  By using -F or -C Trimcc won't build the listing for
  184.   Files or Conferences.  Oh, by the way, omit [ and ] from the command
  185.   line.  Also, case and order of the commands is not important.
  186.  
  187.   If you are upgrading from v1.2 or 1.1 make sure to delete the
  188.   MSG??.ANS and DIRS??.ANS files or TriBBS will display these if the
  189.   caller is using ANSI.
  190.  
  191. -------------------------------------------------------------------------
  192. History Notes:
  193. 10/08/93  Fixed a bug that would cause the program to abort if "DISPLAY"
  194.           was included in the display directory name in configuration
  195.           file.  Fixed the bug the would cause the program to abort and
  196.           not return to the system if a terminal error was encountered.
  197.  
  198. 09/24/93  Cleaned up sort routines.  Changed format of configuration
  199.           files and built small program for building them.
  200.  
  201. 08/28/93  Added ability to sort file areas and conferences by heading.
  202.           Additionally message conferences can be sorted by network
  203.           name.
  204.  
  205. 08/24/93  Now supports TriBBS 5.x, takes advantage of @Xbf codes to
  206.           create *.BBS format files.
  207.  
  208. 08/11/93  Reorganized data structures to keep from crashing if you have
  209.           up to 150 conferences and 155 file areas.  I really don't know
  210.           what the maximum number of areas is.
  211.  
  212.           Now clears the screen before starting listing.
  213.  
  214. 05/18/93  Fixed bug with program not giving users, other than sysop,
  215.           access to private conferences and file areas.
  216.           Release 1.1
  217.  
  218. 04/18/93  Added command line support (-f and -c) to keep Trimcc from
  219.           generating file or conference listing.  Modularized some of
  220.           the code to decrease the compiled program size.
  221.  
  222. 04/15/93  Fixed problem when either bright green was used or
  223.           randomly generated.  Release vesion 1.0
  224.  
  225. 04/07/93  Added file areas, seperate color support for messages and
  226.           files.  Now numbers sequencially from top to bottom of
  227.           listing.  Replace ". " with " - " to remain more consistant
  228.           with the look and feel of TriBBS.  (Never released)
  229.  
  230. 04/05/93  Added random color support, added ability to use default
  231.           configuration file without being on command line.
  232.  
  233. 04/04/93  Fixed bug with using color values less the 10.
  234.  
  235. -------------------------------------------------------------------------
  236. Thanks to:
  237.  
  238. A special thanks to Mark Goodwin for TriBBS, one of the finest programs
  239. I've ever had the pleasure to use.  Thanks also goes to Bryan Nylin of
  240. Implex Systems (Implex Connection) for the programming tips.  Thanks
  241. to all the sysops who provided me with feedback so that I could make this
  242. program useful to all.
  243.  
  244. -------------------------------------------------------------------------
  245.  
  246. Please address any comments to:
  247.  
  248. Mark W. Johnson - sysop - The House of Fools - (206) 290-7622
  249. Speeds: 2400 to 14.4
  250. Fido netmail address:  1:343/137
  251. Fido TriBBS support echo (probably the easiest way to find me)
  252.  
  253.