home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / ABPB1531.ZIP / README.1ST < prev    next >
Encoding:
Text File  |  1996-08-31  |  11.1 KB  |  242 lines
  1.             PCBoard v15.3 - Last Minute Changes / Additions
  2.             ────────────────────────────────────────────────
  3.  
  4.  This file contains important information regarding manual updates, as well
  5.  as frequently asked questions about usage of the installation/upgrade
  6.  procedure which could not be placed in the manual. Please read it
  7.  carefully to see where it may apply to your installation.
  8.  
  9.  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  10.  
  11.  For additional information about PCBoard version 15.3, refer to the
  12.  following files.
  13.  
  14.  WHATSNEW.xxx -  A detailed list of differences between PCBoard 14.5a and
  15.                  15.3.  The xxx represents the version number of PCBoard.
  16.                  The file without an extension is for the current release.
  17.  PPE_INFO -      Descriptions of the PPL applications (PPS/PPE files) found
  18.                  in the PPL subdirectory
  19.  
  20.  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  21.  
  22.  Installing PCBoard for OS/2
  23.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24.  The installation program does all of the file copying for your copy of
  25.  PCBoard for OS/2.  In order to add the appropriate icons to your desktop,
  26.  you must follow these steps:
  27.  
  28.    1.  Add PCBCP.EXE to your startup folder.
  29.    2.  From the File menu pick Node Settings.
  30.    3.  Enter C:\PCB\STARTOS2.CMD for the filename to execute.
  31.    4.  For the working directory, enter C:\PCB.
  32.    5.  Set the OS/2 port to use in the port number field (e.g., 1 for COM1).
  33.    6.  Repeat steps 2-5 for each node you want to add.
  34.    7.  Restart OS/2.  See Chapter 7 in the manual for more Control Panel
  35.        information.
  36.  
  37.  Last Minute Changes/ Additions to The Manual
  38.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  39.    This section points out all known errors in the printed manuals and also
  40.    clarifies a few topics.
  41.  
  42.    PCBoard SysOps Manual
  43.    ------------------------
  44.  
  45.     -  Some OS/2 external protocols and door programs require the handle
  46.        number for the comm port.  Therefore, the OS/2 version of PCBoard
  47.        creates an environment variable called PCBHANDLE= which is set to the
  48.        handle of the comm port.
  49.  
  50.        To make proper use of this feature, three items must be met:
  51.  
  52.          1)  Transfer protocols must have the "Port Open" column set to Y in
  53.              PCBPROT.DAT if they expect to use the handle.  Otherwise,
  54.              PCBoard will close the port and then handle listed in PCBHANDLE
  55.              is invalid.
  56.  
  57.          2)  Door programs, put an F in the Shell column of DOORS.LST to
  58.              prevent the port from being closed.  For the curious, the F
  59.              stands for (F)ast mode because PCBoard does not close files or
  60.              comm ports when doing this type of shell.
  61.  
  62.          3)  The final aspect to consider is make sure that the program
  63.              being run knows how to find the handle.  As mentioned, PCBoard
  64.              creates the PCBHANDLE environment variable so this part will be
  65.              quite easy.  For example, if you have a transfer protocol
  66.              running under the executable FXFER.EXE and it expects the
  67.              handle to be passed via the /H: command line parameter, your
  68.              command line may look like this:
  69.  
  70.                 FXFER.EXE /H:%PCBHANDLE%
  71.  
  72.              The %PCBHANDLE% is replaced with the real comm port handle
  73.              number.
  74.  
  75.     -  Some OS/2 front-end programs pass a handle number rather than the
  76.        port name (e.g., COM1, COM2, etc.)  PCBoard can accommodate these
  77.        mailers because it too can accept a handle number via an environment
  78.        switch with the SET PCB= environment variable.  Example:
  79.  
  80.          SET PCB=/HANDLE:5
  81.  
  82.        This example shows how to set the handle to use handle #5.  Since the
  83.        handle can change from session to session, it is not wise to
  84.        hard-code it.  Instead, the front-end program that passes the handle
  85.        will do so via something like an environment variable.  Simply be
  86.        aware of this fact so that you can properly configure the system.
  87.  
  88.     -  In PCBSetup | Configuration Options | OS/2 Settings are options that
  89.        override what priority are assigned to PCBoard and the processes it
  90.        controls.  The first option, Normal Processing, determines what
  91.        "priority boost" PCBoard has.  Every other option is relative to the
  92.        default boost.  Look at this example:
  93.  
  94.           Priority Settings
  95.           ═════════════════
  96.           Normal Processing            :   5
  97.           External Protocols           :   0
  98.           PCBQWK & PCBCMPRS Processing :   0
  99.           Fido Import Processing       :   0
  100.           Fido Export Processing       :   0
  101.           All Other Shells             :   0
  102.  
  103.        Entering a 5 for the normal or default boost means that all aspects
  104.        of PCBoard default to a priority boost of 5 including the external
  105.        protocols, Fido importing and exporting, etc.  How can that be if
  106.        these options are set to 0?  The answer is really quite simple.
  107.  
  108.        All of the settings beneath "Normal Processing" are relative to the
  109.        normal processing setting.  This means that if you set the default to
  110.        5 and then set all of the other values to 0, the entire system
  111.        operates at a priority boost of 5.
  112.  
  113.        How can you lower a boost for process?  Simply enter a negative value
  114.        in the field and that will lower the overall boost as shown in this
  115.        example:
  116.  
  117.           Priority Settings
  118.           ═════════════════
  119.           Normal Processing            :   5
  120.           External Protocols           :   0
  121.           PCBQWK & PCBCMPRS Processing :  -5
  122.           Fido Import Processing       :   0
  123.           Fido Export Processing       :   0
  124.           All Other Shells             :  -2
  125.  
  126.     ┌────────────────────────────────────────────────────────────────────────┐
  127.     │ Remember!  If in doubt, leave all of these settings at 0 and let OS/2  │
  128.     │ handle the priority scheduling automatically.  It's usually best.      │
  129.     └────────────────────────────────────────────────────────────────────────┘
  130.  
  131.     -  A few options were added to the Control Panel's menu bar.  They are
  132.        as follows:
  133.  
  134.          Actions | Hide Active Nodes - minimizes all windowed active nodes
  135.          that are controlled by Control Panel.
  136.  
  137.          Actions | Show Active Nodes - makes visible all windowed active
  138.          nodes controlled by Control Panel.
  139.  
  140.          Actions | Rearrange Visible Nodes - rearranges the nodes on the
  141.          screen in on orderly fashion beginning with the upper left corner
  142.          of the screen.
  143.  
  144.        Also pertinent is that the Actions | Restart Inactive Nodes no longer
  145.        brings the currently running nodes to the foreground, but merely
  146.        restarts those nodes which are defined and are not running.
  147.  
  148.     - Keeping with the Control Panel theme, a command line parameter was
  149.       added to help facilitate systems that want to use individual PCBCP.INI
  150.       files for Control Panel.  By default this file is stored in the same
  151.       directory as PCBCP.EXE.  Overriding this location is done with the
  152.       /INI= switch as shown in this example:
  153.  
  154.          PCBCP /INI=C:\PCB\PCBCP.INI
  155.  
  156.     - In the Fido menu from the Call Waiting screen (ALT-F), an option to
  157.       scan only for netmail was added.  A side-effect of this change is that
  158.       the menu options could no longer be reference as single digit numbers
  159.       (since there are 11 options now).  As a result, the menu options are
  160.       now referenced alphabetically by letters.
  161.  
  162.  
  163.    PPLC Reference Manual
  164.    ------------------------
  165.  
  166.     -  The U_BDL(), U_MSGRD(), U_MSGWR(), U_LMR(), U_FUL(), and U_BUL()
  167.        functions all report a return type of INTEGER.  These now return
  168.        UNSIGNED integers allowing return values up to 4 billion in size.
  169.  
  170.     -  Using TINKEY(0) is a special case in that it will wait indefinitely
  171.        (or until the keyboard times out) for a keystroke.   This is a great
  172.        way to get a key from the user when you don't care how long they take
  173.        to respond.
  174.  
  175.  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  176.  Upgrading your current version of PCBoard with this file
  177.  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  178.  
  179.  There are a few items you need to be aware of if you are using the install
  180.  program to upgrade an existing version of PCBoard:
  181.  
  182.      1.  If you have multiple nodes installed, insure you have a BOARD.BAT
  183.          and a PCBOARD.DAT in the directory where PCBOARD is going to be
  184.          installed.  If you do not have these files, copy them from one of
  185.          your node directories before you begin the install.  For example,
  186.          If you have the following type of configuration
  187.  
  188.                \PCB--+
  189.                      |
  190.                      +---- NODE1
  191.                      +---- NODE2
  192.                      +---- NODE3
  193.                      +---- NODE4
  194.  
  195.          where the \PCB directory does not have a PCBOARD.DAT or BOARD.BAT
  196.          copy those two files from your NODE1 subdirectory so the INSTALL
  197.          program can do a complete upgrade.
  198.  
  199.  NOTE                                                                NOTE
  200.  NOTE  If you are running v15.X and upgrading to v15.2 then IGNORE   NOTE
  201.  NOTE  the information shown below (items 2 through 5):              NOTE
  202.  NOTE                                                                NOTE
  203.  
  204.          The INSTALL program does not know where to find all of your nodes.
  205.          If you have multiple nodes you may have to upgrade each node
  206.          manually.  If you do, the following lists the steps you must use
  207.          to upgrade each node:
  208.  
  209.      2.  Run your BOARD.BAT and immediately exit your call-waiting screen.
  210.          This will update the PCB environment variable so PCBSetup can
  211.          properly set the options already in use.
  212.  
  213.      3.  Each BOARD.BAT you use must be changed.  Remove the line which
  214.          says:
  215.  
  216.                if exist event.bat rename event.bat event.sys
  217.  
  218.          NOTE:  Do not remove the line which says "if exist event.bat event"
  219.                 or your events will *NOT* run.
  220.  
  221.          Also, change the line which reads PCB145 to run PCBOARD instead.
  222.          If you are using the /M code, change it to PCBOARDM.
  223.  
  224.      4.  Change to each node directory and run PCBSetup.  If the
  225.          PCBOARD.DAT file used by the node has not been upgraded, you will
  226.          see a version change notice.  Acknowledge the notice and when you
  227.          are at the PCBSetup Main Menu exit and save (using a full save -
  228.          Y) to upgrade the PCBOARD.DAT file.
  229.  
  230.      5.  If each of your nodes uses its own copy of PCBTEXT you must
  231.          manually upgrade each copy of PCBTEXT.  After you install the
  232.          upgrade, you will find a FIXTEXT.EXE file in the same directory as
  233.          your PCBOARD.EXE.  The syntax for the FIXTEXT program is:
  234.  
  235.                FIXTEXT <filename>
  236.  
  237.          Replace <filename> with the location of the PCBTEXT file to
  238.          upgrade.
  239.  
  240.  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  241.  
  242.