home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / cdd10.zip / CDD.DOC < prev    next >
Text File  |  1993-03-18  |  14KB  |  365 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.               ┌┬┬┬┬┬┬┬┬┬┬┬─┐
  12.               ││││││││││││ │
  13.               ││││││││││││ │
  14.               ││││││││││││ │         ┌───────────┐
  15.               ││││││││││││ │         │  ┌────────┘
  16.               ├┴┴┴┴┴┴┴┴┴┴┤ │         │  │         ┌─────────────┐
  17.               └┬─────────┴┬┘         │  │         │  ┌───────┐  │
  18.             ┌──┴──────────┴────────┐ │  │         │  │       │  │
  19.             │                      │ │  │         │  │       │  │
  20.             │                      │ │  └─────────┘  └───────┘  │
  21.             └──────────────────────┘ └────────────┐  ┌──────────┘
  22.                                                   │  │
  23.                                                   │  │
  24.                                                   │  │
  25.                                                   │  │
  26.                                                   └──┘
  27.  
  28.                     C O M P U T E R    P R O F I L E S
  29.                            406 Amsterdam Ct N.           
  30.                       Virginia Beach, Virginia 23454
  31.                       BBS (804) 491-4347  491-5061
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                 CD DIRECTOR (tm)
  51.  
  52.                                 Version 1.00
  53.           
  54.                             Created By Gary R. Smith
  55.                      Copyright (c) 1992 - Computer Profiles
  56.     
  57.  
  58.  
  59.  
  60.                             License to Use Agreement
  61.       ───────────────────────────────────────────────────────────────────────
  62.     
  63.          Computer Profiles, (hereafter referred to as"CP"), grants to 
  64.          the purchaser - and purchaser accepts - a non-transferable and
  65.          nonexclusive license to use, on a single computer, the software
  66.          products and accompanying materials provided to the purchaser by
  67.          CP. Purchaser is hereby licensed only to read the program from
  68.          its medium into the memory of a single computer solely for the
  69.          purpose of executing the program.
  70.     
  71.          CP shall have the right to terminate this license if purchaser
  72.          violates any of its provisions.  Purchaser agrees that the
  73.          software products and accompanying materials are the property of
  74.          CP and that CP shall maintain title to and ownership of the
  75.          software products at all times. Purchaser agrees to make no more
  76.          than one (1) additional working copy and one (1) backup copy of
  77.          the software products for their personal use only.
  78.     
  79.          CP makes no warranties of any kind, expressed or implied, with
  80.          respect to the quality, performance, accuracy, or fitness of the
  81.          software products for any particular purpose.  CP assumes no
  82.          responsibility for any decisions make or actions taken on the
  83.          part of the purchaser because of the use of the software
  84.          products.  In no event shall CP, or any of its representatives,
  85.          be liable for any loss of profit or any other damages, arising
  86.          out of the use or inability to use this product - even if CP or
  87.          an authorized agent of such has been advised of the possibility
  88.          of such damages - or for any claim by any other party.
  89.     
  90.          CP reserves the right to make changes, enhancements and
  91.          improvements to the software products at any time without
  92.          notice.
  93.  
  94.     
  95.  
  96.  
  97.  
  98.                                  DISCLAIMER
  99.          ───────────────────────────────────────────────────────────────
  100.  
  101.  
  102.          There is made no warranty of any kind, express or implied
  103.          including, without limitation, any warranties of merchantability
  104.          and / or fitness for a particular purpose.  CP shall not be
  105.          liable for any damages, whether direct, indirect, special or
  106.          sequential arising from a failure of this program to operate in
  107.          the manner desired by the User.  CP shall not be liable for any
  108.          damage to data or property which may be caused directly or
  109.          indirectly by the User of this program.
  110.     
  111.     
  112.          IN NO EVENT WILL CP BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING
  113.          ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
  114.          CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO
  115.          USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  116.     
  117.     
  118.          CD DIRECTOR is a Trademark of Computer Profiles Ltd
  119.          Borland C++ is a Registered Trademark of Borland International
  120.          PCBoard is a Registered Trademark of Clark Development Company
  121.     
  122.  
  123.  
  124.      Now that all the Legalities are out of the way, Let me introduce you
  125.      to the most versatile CD FILE MOVER for the PCBoard enviornment. 
  126.  
  127.                                   CD DIRECTOR
  128.                                   
  129.      If you are not running PCBoard then this software WILL NOT WORK with
  130.      your bbs. This program was written using the TOOLKIT from Clark
  131.      Development Company explicitly for PCBoard systems.
  132.  
  133.      CD Director (herein referred to as CDD) is a simple program to implement
  134.      and will provide your system with increased speed as it moves your
  135.      users download files to a temporary directory setup and directed by
  136.      you. CDD is written with the PCB C TOOLKIT and is very configurable as
  137.      you will see in the next couple of paragraphs. We apologize for the
  138.      short documentation, but when its easy there is no need to drag it out.
  139.      (You wouldnt probably read it anyways....Right<Grin>).
  140.  
  141.      To begin...
  142.  
  143.      Put CDD.EXE and the CDD.CNF files in your path. It is Multinode
  144.      Compatible!
  145.  
  146.      SETTING ENVIORNMENT VARIABLES
  147.  
  148.      CDD uses the enviornment variables of PCBoard. These variables are
  149.      normally created when a door is run however, since CDD is NOT a door
  150.      program and the variables are still expected, You will have to edit
  151.      your board batch file and insert the following enviornment variables:
  152.      (SEE BOARD.TXT for an example of setting these variables)
  153.  
  154.      Enter in your BOARD.BAT FILE:
  155.  
  156.      SET PCBDRIVE=C:                        // Or appropriate drive letter
  157.      SET PCBDIR=\PCB                        // Directory where this node of
  158.                                                PCBoard is running
  159.      SET PCBDAT=C:\PCB\PCBOARD.DAT          // This is the FULL path to the
  160.                                                nodes PCBOARD.DAT file
  161.  
  162.      Example BOARD.BAT:
  163.      _____________________________________________________
  164.         @ECHO OFF
  165.         C:
  166.         CD\PCB
  167.         SET DSZLOG=H:\PCB\PCBDSZ.LOG
  168.         SET PCB=/MAIN /UPCRED:0.2 /BYTECRED:0.5 /NOREG /SWAP
  169.    *    SET PCBDRIVE=C:
  170.    *    SET PCBDIR=\PCB
  171.    *    SET PCBDAT=C:\PCB\PCBOARD.DAT
  172.         IF EXIST REMOTE.BAT RENAME REMOTE.BAT REMOTE.SYS
  173.         IF EXIST EVENT.BAT RENAME EVENT.BAT EVENT.SYS
  174.         IF EXIST DOOR.BAT DEL DOOR.BAT
  175.         IF EXIST ENDPCB DEL ENDPCB
  176.         C:\PCB\PCB145
  177.         IF EXIST REMOTE.BAT REMOTE
  178.         IF EXIST DOOR.BAT DOOR
  179.         IF EXIST EVENT.BAT EVENT
  180.         IF EXIST ENDPCB GOTO END
  181.         BOARD
  182.         :END
  183.         ECHO TYPE BOARD TO RESTART PCBOARD (THANK-YOU).....
  184.      _____________________________________________________
  185.  
  186.   *  Add these variables
  187.  
  188.      With the above variables set any program that uses these will be able
  189.      to also return to the node directory from which it came. This also allows
  190.      CDD to find the default directory and access any of the PCBoard files it
  191.      needs to run properly.
  192.  
  193.      CREATING A TEMPORARY WORK DIRECTORY
  194.  
  195.      CDD will copy all of your users file requests to a directory determined
  196.      by you. (This is set in the Configuration File discussed later). If you
  197.      are running multiple nodes you will want to set up a temp directory for
  198.      each nodes files to be copied to...ie...
  199.  
  200.      C:\PCB\NODE1
  201.      C:\PCB\NODE2
  202.  
  203.      etc..
  204.  
  205.      CREATING THE CONFIGURATION FILE
  206.  
  207.      Note: Ensure you add a number to the end of the directory when creating
  208.      it. CDD will append a NODE NUMBER to the directory filename.
  209.  
  210.      If a different drive will be assigned for each node then you will have
  211.      to create a config file for each node and drop it in that nodes 
  212.      directory or path.
  213.  
  214.      CDD will automatically search the path to find the nearest config file.
  215.      It starts with its home directory and then moves on to the path stated
  216.      in your autoexec.bat file.
  217.  
  218.      CREATING THE CONFIGURATION FILE
  219.  
  220.      Creating the configuration file for CDD is very simple. Items in the 
  221.      file are not in any order, however if items are not found then the
  222.      defaults will be used. Any item Preceeded with a ; is considered a 
  223.      comment line.
  224.  
  225.      WORKDIR=  Assign the directory name for where CDD will place the files
  226.                it copies over (MINUS THE NODE NUMBER) (Remember you created
  227.                this directory with a node number)
  228.  
  229.                ex.   WORKDIR=H:\PCB:TEMP
  230.                     (CDD will put the files in H:\PCB\TEMP2 if the node
  231.                     number was 2, Temp1 if you have a single node)
  232.  
  233.      ZIPFILE= This is the full name and path to your zip comment file. If
  234.               you want CDD to insert a ZIP comment file into the copied
  235.               files then place the name here. If not remove this line from
  236.               the config file.
  237.  
  238.               ex. ZIPFILE=H:\PCB\RANDOM.AD
  239.  
  240.      MSGLINE= You can define this line that will be displayed to the caller.
  241.               PCB @ color codes are supported. (Only color codes are 
  242.               supported).    
  243.  
  244.               ex. MSGLINE= Processing your files, please wait...
  245.  
  246.               (Notice no "") :)
  247.  
  248.      MSG-LINE-COLOR=  This is the color you want the MSGLINE to be when
  249.               displayed to the caller. (PCB @ color codes MUST be used)
  250.  
  251.               ex. MSG-LINE-COLOR=@X0D
  252.  
  253.      SHOWMSG= If not in the config file the MSGLINE default is to show the
  254.               message. Enter YES to show and NO if you do not desire to 
  255.               show either a personalized message or the default message
  256.               line.
  257.  
  258.               ex. SHOWMSG=YES
  259.                   SHOWMSG=NO
  260.  
  261.      SHOWSTATUS= This determines if the user will be shown the status of
  262.                  the file movement. The following is shown to the user if
  263.                  this option is set to YES:
  264.  
  265.                  Filename               Status
  266.                  ___________            __________
  267.  
  268.                  CDD.ZIP                Moving File/Updating File/ Completed
  269.  
  270.                  To show this information to your users just place a YES
  271.                  after SHOWSTATUS:
  272.  
  273.                  ex. SHOWSTATUS=YES
  274.  
  275.      You can also define the colors that are used to show the status by using
  276.      the PCB @ color codes along with the following variables:
  277.  
  278.      STATUS-COLOR=  This is the text color of the status lines
  279.  
  280.      FILENAME-COLOR= This is the color of the filename
  281.  
  282.      END-MSG-COLOR= When completed the status line will default to:
  283.  
  284.                                 Start your transfer now.
  285.                                  CTRL-X Aborts Tranfer              
  286.  
  287.                     This variable only sets the color, the words are 
  288.                     not changeable.
  289.  
  290.      MOVE-COLOR= Specifies color for "MOVING FILE"
  291.  
  292.      UPDATE-COLOR= Specifies color for "UPDATING FILE"
  293.  
  294.      COMP-COLOR= Specifies color for "COMPLETED"
  295.  
  296.      See the example config file (CDD.CNF in this zip)
  297.  
  298.     BATCH FILES
  299.  
  300.     Included in this zip are batch files commonly used with PCBoard.
  301.     the means will be displayed here in the pcbsz.bat file.
  302.  
  303.     PCBSZ.BAT
  304.  
  305.     @echo off
  306.     if exist pcberr.fil del pcberr.fil
  307.     if exist pcbdsz.log del pcbdsz.log
  308. 1   CDD CDD.CNF %3
  309. 2   dsz.exe handshake both pB4096 estimate 0 %5 z sz @%PCBDRIVE%CDD.LST
  310. 3   CDD CDEL
  311.  
  312.     The files are the same as distributed with PCBoard with the following
  313.     exceptions.
  314.  
  315.     Line (1) calls CDD, Passes the CDD.CNF filename and includes the
  316.     %3 (Which is the filename or list passed by PCboard).
  317.  
  318.     Line (2) Is your regular dsz line with the %3 changed to:
  319.  
  320.             @%PCBDRIVE%CDD.LST
  321.  
  322.    Line (3) Tells CDD that all the files have been transfered and to
  323.    delete the files that were moved to the directory. NOTE that CDD
  324.    only deletes the files that it moved.
  325.  
  326.    The last item to complete is to turn off all of your internal protocols.
  327.    This is done within the pcbsetup program. If you allow internal 
  328.    protocols then CDD cannot do its job and you have defeated the purpose
  329.    of installing the program.
  330.  
  331.    The color codes for CDD are easy to use and are exactly the same as
  332.    PCBoards 14.5+ codes. The @X color codes correspond to regular PC
  333.    display codes.
  334.  
  335.    For instance, a 1 is blue, 2 is green, a 3 is cyan etc...
  336.  
  337.                  BACKGROUND  FOREGROUND
  338.                 FIRST DIGIT SECOND DIGIT
  339.    BLACK            0           0
  340.    BLUE             1           1
  341.    GREEN            2           2
  342.    CYAN             3           3
  343.    RED              4           4
  344.    MAGENTA          5           5
  345.    YELLOW           6           6
  346.    WHITE            7           7
  347.  
  348.    BRIGHT COLORS:
  349.  
  350.    BLACK            8           8
  351.    BLUE             9           9
  352.    GREEN            A           A
  353.    CYAN             B           B
  354.    RED              C           C
  355.    MAGENTA          D           D
  356.    YELLOW           E           E
  357.    WHITE            F           F
  358.  
  359.    Examples: Bright white on blue background        = 1F or @X1F
  360.              Bright yellow on green background      = 2E or @X2E
  361.              Dark blue blinking on white background = F1 or @XF1
  362.  
  363.  
  364.  
  365.