home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / RIPKT100.ZIP / INSTALL.DOC < prev    next >
Text File  |  1994-04-07  |  8KB  |  193 lines
  1. ------------------------------------------------------------------------------
  2.  RIPKit for PCBoard
  3. ==============================================================================
  4.  
  5.  
  6.  
  7.  
  8. Requirements
  9. ---------------------------------------
  10.  
  11.    * PCBoard v15.1
  12.    * A fair amount of experience with a RIPaint type of program and PCBoard
  13.    * Plenty of time (you will now have more screens to update for your system).
  14.  
  15.  
  16. The Goal Of RIPKit
  17. ---------------------------------------
  18.  
  19.    The goal of RIPKit is to simply provide PCBoard SysOps with a starting
  20.    point for "RIPping" their systems.  By no means is this kit designed to
  21.    be a hands-off / self-maintaining RIPscrip add-in for PCBoard.
  22.  
  23.    If you keep the focus of this product in mind, you'll understand the reason
  24.    we listed experience with a paint program and PCBoard as a requirement.
  25.    Without this experience, you'll quickly get lost in the complexity of a
  26.    heavily modified system for RIPscrip.
  27.  
  28.  
  29. Support For RIPKit
  30. ---------------------------------------
  31.  
  32.    RIPKit was put together by the technical support staff of CDC in some
  33.    of their free time between answering calls and messages.  As such, support
  34.    for the product is extremely limited.
  35.  
  36.    Support for RIPkit can *only* be obtained via the Salt Air BBS.  Customers
  37.    asking questions via other means (e.g., fax or phone), will be referred
  38.    to the Salt Air BBS to ask their questions.
  39.  
  40.  
  41. Installation Instructions
  42. ---------------------------------------
  43.  
  44. 1) Change to your \PCB directory.  Make a RIP directory by typing "MD RIP"
  45.    at the DOS prompt.  Change to the newly created RIP subdirectory and
  46.    unzip RIPKIT.ZIP using the following command:
  47.  
  48.        PKUNZIP RIPKIT.ZIP -d
  49.  
  50.    This will create the following new subdirectories:
  51.  
  52.        \PCB\RIP\        - Where file replacements for PCBTEXT records are
  53.        \PCB\RIP\PPE\    - PPEs (and associated files) used in the RIPKit.
  54.        \PCB\RIP\MENUS\  - MNUs (and associated files) used in the RIPKit.
  55.  
  56.    NOTE:  If your system involves a network, you only have to have one copy
  57.           of the RIPKit files.  If performance is a concern, store the RIPKit
  58.           files on each workstation of your network.
  59.  
  60. 2) Add the following line to AUTOEXEC.BAT (remember to do this to each
  61.    machine in your system).
  62.  
  63.        SET PCBRIP=C:\PCB\RIP
  64.  
  65.    If your files are not in C:\PCB\RIP\, enter the appropriate directory.
  66.    For example, Salt Air, stores all of the RIPKit files on the server in
  67.    the H:\PCB\RIP\ subdirectory.  Consequently, our line in AUTOEXEC.BAT
  68.    looks like this:
  69.  
  70.        SET PCBRIP=H:\PCB\RIP
  71.  
  72.    NOTE:  Do *NOT* add the trailing backslash to this environment variable.
  73.           If you do, the RIPKit stuff will not work.  Throughout the
  74.           PCBTEXT.RIP (and several display files), relative references
  75.           are made.  Example:
  76.  
  77.              %%PCBRIP%\DISPLAYIT
  78.  
  79.           When PCBoard substitutes the environent variable, the result is:
  80.  
  81.              %C:\PCB\RIP\DISPLAYIT
  82.  
  83.           Obviously, if you have the trailing backslash, the resulting
  84.           substutition is:
  85.  
  86.              %C:\PCB\RIP\\DISPLAYIT
  87.  
  88.           Since this is not a valid filename specification, it won't work.
  89.  
  90. 3) Move PCBTEXT.RIP from the \PCB\RIP subdirectory to your PCBTEXT
  91.    subdirectory.  If your system has a local copy of PCBTEXT for each node
  92.    or workstation, take that into consideration.
  93.  
  94. 4) Move WELCOME.RIP from the \PCB\RIP subdirectory to the directory where your
  95.    WELCOME file is.  If your system has a local copy of the WELCOME file for
  96.    each node/workstation, keep that in mind.
  97.  
  98.    NOTE:  If you have changed the name of your WELCOME file to something else,
  99.           you will have to rename WELCOME.RIP to the name of your welcome file and
  100.           add a .RIP extension.  For example, if PCBSetup | File Locations | Display
  101.           Files shows:
  102.  
  103.              Name/Loc of WELCOME File          : C:\PCB\GEN\WELC
  104.  
  105.           Rename your WELCOME.RIP to WELC.RIP after copying it to C:\PCB\GEN\.
  106.  
  107. 5) The next group of files relate to conferences.  The configuration for each
  108.    conference specifies where the User Menu (BRDM), SysOp Menu (BRDS), and
  109.    NEWS file are stored.
  110.  
  111.    Move/Copy BRDM.RIP and BRDS.RIP to the same location as your BRDM and BRDS
  112.    files.  If you have changed the names of your BRDM and BRDS files, don't
  113.    forget to change the names of the .RIP counterparts.  For example, if your
  114.    Main Board Configuration screen shows:
  115.  
  116.         Name/Loc of User's Menu     : C:\PCB\GEN\USERS
  117.         Name/Loc of Sysop's Menu    : C:\PCB\GEN\SYSOP
  118.  
  119.    Rename BRDM.RIP to USERS.RIP and BRDS.RIP to SYSOP.RIP after copying/moving
  120.    them to the appropriate subdirectory.
  121.  
  122.    Do the same thing for the NEWS.RIP file making sure it gets copied to the
  123.    right directory and the name of the corresponding .RIP file is correct.
  124.    Once you have taken care of the placement and naming of the NEWS.RIP file,
  125.    edit the file with a text editor because it hard codes the name of your
  126.    actual NEWS file.
  127.  
  128.    What happens with the RIPKit is PCBoard finds the NEWS.RIP, displays the
  129.    NEWS_.RIP located in the \PCB\RIP\ subdirectory (to setup the display
  130.    for RIP, the text window, etc.).  Finally, your normal NEWS file is
  131.    displayed.
  132.  
  133. 6) Unzip the CMDFILES.ZIP (located in \PCB\RIP) into the directory specified by
  134.    the following field in PCBSetup | File Locations System Files:
  135.  
  136.         Location of Command Display Files : C:\PCB\CMDFILES\
  137.  
  138.    Using this example, you would type:
  139.  
  140.         PKUNZIP \PCB\RIP\CMDFILES.ZIP C:\PCB\CMDFILES
  141.  
  142.    NOTE:  If you do not have a directory specified in PCBSetup, enter one
  143.           (like \PCB\CMDFILES) and create the directory if necessary.
  144.  
  145. 7) Update PCBML.DAT with RIP Language (Check all nodes to make sure they are
  146.    configured to run multiple languages, and that they all point to the same
  147.    PCBML.DAT.  Example PCBML.DAT:
  148.  
  149.               Language             Extension  Country  CodePage  Yes  No
  150.         ═════════════════════════  ═════════  ═══════  ════════  ═══  ══
  151.         1 - Salt Air (Customized)                                 Y    N
  152.         2 - Automated (Standard)      STD                         Y    N
  153.         3 - Sub-menus                 SUB                         Y    N
  154.         4 - RIPscrip                  RIP                         Y    N
  155.  
  156.    Also check to see if your system is setup to support multiple languages.
  157.    PCBSetup | Configuration Options | System Control has a setting:
  158.  
  159.         Multi-Lingual Operation         : Y
  160.  
  161.    Make sure this option is set to "Y" for proper operation.
  162.  
  163. 8) Unzip FLAG32.ZIP in the \PCB\RIP subdirectory to your \PCB\FLAG
  164.    subdirectory (unless you've already installed FLAG.PPE).  Once this
  165.    is done, modify record 549 in your *PCBTEXT.RIP* to look like the
  166.    following:
  167.  
  168.     ╒════════════════════════════════════════════════════════════
  169.     │   Record No.:  549          Record Length:  60        Justi
  170.     ├────────────────────────────────────────────────────────────
  171.     │(@TIMELEFT@ min left), (H)elp, (V)iew, (F)lag, More
  172.     │!C:\PCB\FLAG\FLAG.PPE
  173.     ╘════════════════════════════════════════════════════════════
  174.  
  175.     NOTE:  You may already have David Terry's FLAG.PPE installed on your
  176.            system.  If you do, simply update your PCBTEXT.RIP (record 549)
  177.            with the appropriate information.
  178.  
  179. 9) Modify record 387 in the default PCBTEXT file.  This record is the
  180.    "Enter Language # to use" prompt.  You want this record to read:
  181.  
  182.     ╒══════════════════════════════════════════════════════
  183.     │   Record No.:  387          Record Length:  56
  184.     ├──────────────────────────────────────────────────────
  185.     │Enter Language # to use (Enter)=no change
  186.     │!%PCBRIP%\PPE\LANGPRMP.PPE
  187.     ╘══════════════════════════════════════════════════════
  188.     
  189.    The LANGPRMP.PPE auto-detects if the user has RIP capabilities.  If
  190.    so, it automatically picks the language number which is defined as
  191.    having a .RIP extension in PCBML.DAT.
  192.     
  193.