home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / PCBCM12.ZIP / PCBCM.DOC < prev    next >
Text File  |  1994-03-30  |  10KB  |  259 lines
  1.  
  2.  
  3.  
  4.  
  5.                           PCBUtility Package
  6.                      PCBoard Conference Menu Utility
  7.                         Version 1.2    03/20/94
  8.                           Copyright (c)  1994
  9.                              Casto Software
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 WARNING
  17.                                 -------
  18.  
  19.           As with all new software it is * strongly * recommended that
  20.         you have a recent backup just in case.
  21.  
  22.  
  23.  
  24.  
  25.                                 LEGAL
  26.                                 -----
  27.  
  28.           David Casto hereby disclaims all warranties relating to this
  29.         software, whether express or implied, including without
  30.         limitation any implied warranties of merchant ability or
  31.         fitness for a particular purpose. David Casto will not be
  32.         liable for any special, incidental, consequential, indirect or
  33.         similar damages due to loss of data or any other reason, even
  34.         if David Casto or an agent of David Casto has been advised of
  35.         the possibility of such damages.  In no event shall David
  36.         Casto liability for any damages ever exceed the price paid for
  37.         the license to use software, regardless of the form of the
  38.         claim.  The person using the software bears all risk as to the
  39.         quality and performance of the software.
  40.  
  41.           You are free to distribute this software as long as there
  42.         are no modifications to any files in this archive.
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                                 What Is It?
  49.                                 -----------
  50.  
  51.           This is a command line utility that will read the PCBoard
  52.         CNames.@@@ file and produce a Conference Menu.  It is completely
  53.         dependent on PCBUtility v1.0x files.  You must have installed
  54.         PCBUtility to be able to use this program.
  55.  
  56.  
  57.                                 Installation
  58.                                 ------------
  59.  
  60.           You must have PCBUtility set up in order to use this
  61.         program.  Once you have PCBUtility set up and configured
  62.         use a text editor and edit the file PCBCM.CFG in the PCBUTIL
  63.         directory.  This file tells the program your network definitions
  64.         and sort preference.
  65.  
  66.           General PCBCM.CFG line syntax:
  67.  
  68.  
  69.                 Conf#:NetWorkName
  70.  
  71.                       This will take the single conference number and
  72.                       add NetWorkName as the network.
  73.  
  74.  
  75.                 Conf#1-Conf#2:NetWorkName
  76.  
  77.                       This will take any conference number greater than
  78.                       or equal to Conf#1 but less than or equal to Conf#2
  79.                       and add NetWorkName as the network for the
  80.                       conference range.
  81.  
  82.  
  83.                 SORTType:#
  84.  
  85.                       This line is for the sort method desired.
  86.                       The four valid sort methods are:
  87.                       1) Sort by Conference Number
  88.                       2) Sort by Conference Name
  89.                       3) Sort by Conference NetWork then Number
  90.                       4) Sort by Conference Name then NetWork then Number
  91.  
  92.                (See the example CNFNx files in this archive where x =
  93.                 the sort type.)
  94.  
  95.  
  96.                 Color Configuration:
  97.  
  98.                         If the following lines are in the configuration
  99.                     file then these colors will be substuted for the
  100.                     defult colors.  Valid colors range from 0 to 8, all
  101.                     other values will be ignored.  On some of the lines
  102.                     below note a "Y" after the color.  The "Y" will allow
  103.                     high intensity colors, but only on these lines.  If
  104.                     you don't want high intensity colors place a "N" on
  105.                     the line.
  106.  
  107.  
  108.                 BACKGround:3
  109.  
  110.                         This is the menu back ground color.  This color
  111.                     will not accept high intensity colors nor will it
  112.                     look for them.
  113.  
  114.                 BORDERHILight:7
  115.  
  116.                         This is the border (1/2 of the box line around
  117.                     the menu) highlight color.  This color will not accept
  118.                     high intensity colors nor will it look for them.  It
  119.                     will automaticly convert the value to high intensity.
  120.  
  121.                 Border:8
  122.  
  123.                         This is the border (the other 1/2 of the box line
  124.                     around the menu) low intensity color.  This color will
  125.                     not accept high intensity colors nor will it look for
  126.                     them.
  127.  
  128.                 HEADERBar:7:Y
  129.  
  130.                         This is the menu header color.  This is the line
  131.                     that describes the conference number, conference name,
  132.                     and the net work name.  This color may be a high
  133.                     intensity color.
  134.  
  135.                 CONFNumber:7:Y
  136.  
  137.                         This is the conference number color.  This color
  138.                     may be a high intensity color.
  139.  
  140.  
  141.                 CONFName:6:Y
  142.  
  143.                         This is the conference name color.  This color
  144.                     may be a high intensity color.
  145.  
  146.                 NETWORKName:2:Y
  147.  
  148.                         This is the conference network name color.  This
  149.                     color may be a high intensity color.
  150.  
  151.  
  152.                 USEPPE:Y
  153.  
  154.                         This instructs the program to create the CNFN files
  155.                     for the use of the CNFN.PPE.  See the PCBCM.NEW for
  156.                     more info.
  157.  
  158.  
  159.  
  160.           The PCBCM.HDR file:
  161.  
  162.                 You may want to create a file PCBCM.HDR in the PCBUTIL
  163.                 directory as a conference menu header if you are using a
  164.                 registered key file and if this file exists in the PCBUTIL
  165.                 directory PCBCM will add the header file into the conference
  166.                 menu.
  167.  
  168.                         (see the example PCBCM.HDR in this archive)
  169.  
  170.  
  171.                               Command Line Use
  172.                               ----------------
  173.  
  174.           Command line syntax is as follows:
  175.  
  176.                 Examples:
  177.  
  178.                 1) PCBCM
  179.                    Will read the CNames.@@@ file from beginning
  180.                    to end and produce a conference menu.  This is
  181.                    the default command line and will only add
  182.                    conferences that are set up in PCBSetup with a "Y"
  183.                    in the "Public Conference" field and the "Security
  184.                    Level to Join" is equal or less than 0.  If the
  185.                    conference is set up PCBSetup with a "N" in the "Public
  186.                    Conference" field then the conference will not be added
  187.                    to the menu.
  188.  
  189.                    It will also read the PCBCM.CFG to determine the
  190.                    NetWork.
  191.  
  192.  
  193.                 2) PCBCM /SEC:110
  194.                    Will read the CNames.@@@ file from beginning
  195.                    to end and produce a conference menu for security
  196.                    level 110 users (CNFN110).  If the conference is set
  197.                    up in PCBSetup with a "Y" in the "Public Conference"
  198.                    field and the "Security Level to Join" is equal or less
  199.                    than the security level on the command line then the
  200.                    conference will be added to the menu.  If the
  201.                    conference is set up PCBSetup with a "N" in the "Public
  202.                    Conference" field then the conference will not be added
  203.                    to the menu.
  204.  
  205.                    It will also read the PCBCM.CFG to determine the
  206.                    NetWork.
  207.  
  208.  
  209.                 3) PCBCM /CFG:CM.CFG
  210.                    Will read the CNames.@@@ file from beginning
  211.                    to end and produce a conference menu for security
  212.                    level 0 users (CNFN).  If the conference is set up
  213.                    PCBSetup with a "N" in the "Public Conference" field
  214.                    then the conference will not be added to the menu.
  215.  
  216.                    It will also read the CM.CFG to determine the
  217.                    NetWork.
  218.  
  219.  
  220.                 4) PCBCM /CFG:CM.CFG /SEC:110
  221.                    Will read the CNames.@@@ file from beginning
  222.                    to end and produce a conference menu for security
  223.                    level 110 users (CNFN110).  If the conference is set
  224.                    up in PCBSetup with a "Y" in the "Public Conference"
  225.                    field and the "Security Level to Join" is equal or less
  226.                    than the security level on the command line then the
  227.                    conference will be added to the menu.  If the
  228.                    conference is set up PCBSetup with a "N" in the "Public
  229.                    Conference" field then the conference will not be added
  230.                    to the menu.
  231.  
  232.                    It will also read the CM.CFG to determine the
  233.                    NetWork.
  234.  
  235.  
  236.                 5) PCBCM /SEC:ALL
  237.                    Will read the CNames.@@@ file from beginning
  238.                    to end and produce a conference menu for the sysop
  239.                    security level found in PCBSetup "Sysop Level
  240.                    (for Sysop Menu and F1-Temp-Sysop Upgrade)".
  241.  
  242.                    It will read the PCBCM.CFG file to determine the
  243.                    NetWork and will add all conferences to the menu
  244.                    even PRIVATE conferences.
  245.  
  246.  
  247.  
  248.                                 Summary
  249.                                 -------
  250.  
  251.                   If you would like to see further enhancements of
  252.                 this program then please communicate them to me by
  253.                 voice or BBS.
  254.  
  255.                 Voice: 614-882-0993
  256.  
  257.  
  258.                 BBS: 614-882-0994
  259.