home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / IAB110A.ZIP / INSTALL.DOC < prev    next >
Text File  |  1994-01-23  |  9KB  |  233 lines
  1. ---------------------------------------------------------------------
  2.                          INTERNET ADDRESS BOOK
  3.  
  4.                          IAB4E.PPE version 1.10A Beta
  5.              Compiled with: PPLC v2.00 (01-20-94)
  6.                     PCBoard v15.1 Beta
  7.                                  by
  8.  
  9.                             Michael Walter
  10.                           SQLCraft Software
  11.  
  12.                   Copyright (c)1993 SQLCraft Software
  13.                      All rights reserved.
  14. ---------------------------------------------------------------------
  15.    Send questions/comments via Internet to: sqlcraft@data-base.com
  16. ---------------------------------------------------------------------
  17.  
  18.  Note: Changes from the v1.01 documentation are marked with an '*'
  19.        in the left hand margin.
  20.  
  21.  
  22.  OVERVIEW:
  23.  
  24.     This is a beta release of the Internet Address Book PCBoard
  25.     "E" command replacement PPE for use on systems running
  26.     PCBoard v15.1 beta 01-20-94 releases or later.
  27.  
  28.     This document outlines installation and use of IAB4E.PPE, an
  29.     alternative to the standard IAB.PPE program.
  30.  
  31.     The major difference between IAB and IAB4E is that:
  32.  
  33.       IAB is a replacement for PCBoard prompt #199,
  34.       the "To: (Enter)= 'ALL'" prompt
  35.  
  36.     and
  37.  
  38.       IAB4E is a replacement for the PCBoard 'E' (enter a
  39.       message) command.
  40.  
  41.     Initially we released only the IAB.PPE program, but soon found
  42.     out that if another PPE program attempts to send (stuff) the
  43.     'E'command (plus a string) to PCBoard, it may not return the
  44.     desired result after the standard IAB PPE was installed.
  45.     IAB4E properly accepts and processes 'E" +"..." commands from
  46.     both users and other PPEs.
  47.  
  48. *   NOTE: Due to overwhelming user preference for the "E" command
  49.       replacement version of IAB (vs. the prompt replacement
  50.       version).  All future standard versions of IAB will
  51.       released with only the "E" cmd replacement version
  52.       in the distribution file set.  The older prompt #199
  53.       version may still be made available on request.
  54.       The benefit of the single program type is that we'll
  55.       be able to deliver new features, enhancements, and
  56.       fixes faster and at lower cost than before.
  57.  
  58.  
  59.  IAB4E INSTALLATION (New):
  60.  
  61.     If you wish to install IAB as a direct replacement for your
  62.     PCBoard 'E' (enter a message) command, follow the instructions
  63.     below.
  64.  
  65.     There are a number of steps required to install IAB4E, but they
  66.     are fairly straight forward and should be easy enough to follow.
  67.  
  68.     First will briefly describe the steps in the procedure, then
  69.     we'll walk you through them one at a time in more detail:
  70.  
  71.     - First, you'll create a directory to hold the IAB files.
  72.  
  73.     - Second, you'll add several commands to PCBoard CMD.LST to
  74.       enable your users to access IAB.
  75.  
  76.     - Third, you'll edit the IAB.CNF configuration file to fit
  77.       your BBS.
  78.  
  79.     The following steps and examples should help you to quickly
  80.     setup IAB for your system.
  81.  
  82.     1) Create a directory to hold the IAB files.
  83.  
  84.             We use: R:\PCB\PPE\IAB
  85.  
  86.        Unzip IABxxx.ZIP into this directory.
  87.  
  88.  
  89.     2) Run PCBSETUP and add the following lines to your CMD.LST file:
  90.  
  91.         Command  Security  PPE/MNU File -or- Keystroke Replacement
  92.     =======  ========  =======================================
  93.      E           0     R:\PCB\PPL\IAB\IAB4E.PPE
  94.      IAB        90     R:\PCB\PPE\IAB\IAB4E.PPE MAINT
  95.      IABS       90     R:\PCB\PPE\IAB\IAB4E.PPE STATUS
  96.  
  97.      Actually, the command names can be anything you want to be
  98.      (that is, anything PCBoard allows).  The Command names and
  99.      required security levels are what we use on Data-Base BBS
  100.      and are provided as an example.  We suggest you set your
  101.      security levels to whatever is required for access to
  102.      Internet E-mail conference (obviously, IAB won't be of
  103.      much use to your non-Internet-enabled users).
  104.  
  105.      Some explanation is order here to explain our "multi
  106.      command entry" above...
  107.  
  108.      IAB can be invoked in one of three "modes" depending on
  109.      what parameter(s) (if any) are passed on the IAB4E.PPE
  110.      command line.  IAB currently supports the following
  111.      "modes"...
  112.  
  113.  
  114.      a) No command line parameters
  115.  
  116.         IAB4E.PPE
  117.  
  118.         In this case, IAB4E will startup in Message Entry Mode
  119.         acting as a direct replacement to the standard PCBoard
  120.         'E' command, & display the "To: (<Enter>=list) ?" prompt.
  121.  
  122.         This replaces the "To: (Enter) = 'ALL'" standard prompt
  123.         in your Internet E-mail conference (only).  Your users
  124.         will still see the standard PCBoard "To:" prompt in your
  125.         other conferences (only your Internet E-mail conference
  126.         prompt will be customized - IAB active).
  127.  
  128.       b) The Maintenance command line parameter
  129.  
  130.         IAB4E.PPE MAINT    (or simply: IAB4E.PPE M)
  131.  
  132.         Here, you are telling IAB that you want to startup
  133.         in List Maintenance Mode...you want to edit your
  134.         Internet Address Book without having to join the
  135.         Internet E-mail conference (and type "E").
  136.  
  137.         This mode also supports a second command line
  138.         parameter (active only for registered users)...
  139.  
  140.         IAB4E.PPE MAINT QUIET  (or simply: IAB4E.PPE M Q)
  141.  
  142.         which will startup IAB in maintenance mode but
  143.         completely skip the welcome screen and jump
  144.         immediately to the Address Book list display.
  145.  
  146.  
  147.      c) The Status command line parameter
  148.  
  149.         IAB4E.PPE STATUS  (or simply: IAB4E.PPE S)
  150.  
  151.         Sometimes you'll just want to check to see how many
  152.         entries are in your Address Book or whether you have
  153.         Auto-Record Mode turned on.  Starting IAB this way,
  154.         will display a brief status report to the screen
  155.         instead of actually opening the Address Book.
  156.  
  157.  
  158.      We choose to "bury" the command line parameters in our
  159.      CMD.LST (as in our example above) but you don't have to
  160.      do it that way.  You could just as easily make a single
  161.      entry to your CMD.LST file that doesn't pass any
  162.      parameters to IAB4E and leave that to your users.
  163.      However, we found the E,IAB,IABS entry approach
  164.      easier for our users.
  165.  
  166.  
  167.     3) Modify the enclosed IAB.CNF sample configuration file to
  168.        customize IAB for your system (same as for standard IAB).
  169.  
  170. *   NOTE: IAB v1.0x Users: You *MUST* add 2 (two) new lines to your
  171.           IAB.CNF file for this release to work: Lines 10 and 11
  172.       (shown below).
  173.  
  174.     Line 1: Michael Walter           Your FULL Name
  175.  
  176.     Line 2: Data-Base BBS            Your BBS Name
  177.  
  178.     Line 3: 000000                   Registration number
  179.                                      (leave the 0's until you register)
  180.  
  181.     Line 4: r:\pcb\ppe\iab\welcome   Welcome screen path\filename
  182.                      (file provided)
  183.  
  184.     Line 5: r:\pcb\ppe\iab\iab.hdr   Main Listing Header file
  185.                      path\filename  (file provided)
  186.  
  187.     Line 6: r:\pcb\ppe\iab\dat       Path (ONLY) for IAB to use for
  188.                      the data files it creates
  189.  
  190.     Line 7: 90                       Minimum security level for IAB use
  191.  
  192.     Line 8: 181                      Internet E-mail conference number
  193.  
  194.     Line 9: 1                        Flag to Toggle Caller Log Writing
  195.                                      (ON=1/off=0).  Registered users can
  196.                      turn off logging by setting this to 0
  197.  
  198. *  Line 10: 1                        Flag to toggle whether or not the
  199.                                      system retains backup copies of
  200.                                      the users' datafiles after writing
  201.                      changes to disk
  202.                      (KEEP BAKS=1 / NO BAKs=0)
  203.  
  204. *  Line 11: 100                      Max number of entries per
  205.                                      address book user.  IAB defaults
  206.                                      to storing up to 100 entries per
  207.                                      address book.  You can increase
  208.                                      the max entries by entering a
  209.                                      number larger than 100 on this
  210.                                      line.  Smaller numbers have no
  211.                                      effect.
  212.  
  213. *  Line 12: 0                        Flag to toggle whether "UUCP" mode 
  214.                                      is on or off.  When in UUCP mode, 
  215.                      IAB will enter "UUCP" in the message          header "To:" 
  216.                                      field (instead of placing the actual 
  217.                      address there) and create it's own 
  218.                      "To:  <address>" line in the first 
  219.                      line of the body of the message.  
  220.                      (See HISTORY.DOC for more info).
  221.                      (ON=1/off=0) default = 0.
  222.  
  223.  
  224.    IAB4E INSTALLATION (Converting from the older IAB prompt #199 version)
  225.  
  226.     If you have already installed IAB, follow these instructions to
  227.     convert over to IAB4E.
  228.  
  229.     1) Restore PCBTEXT prompt #199 to its default.
  230.     2) Follow the "IAB4E INSTALLATION (New)" instructions above.
  231.  
  232.  
  233.