home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 147.img / PCB142D4.TD0 / PCBCONV.DOC < prev    next >
Text File  |  1988-12-19  |  40KB  |  992 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                            PCBoard Conversion Instructions
  10.                            -------------------------------
  11.                                    December 6, 1988
  12.  
  13.  
  14.           VERSION 9.x & EARLIER -> 10.0 UPGRADE INSTRUCTIONS
  15.           --------------------------------------------------
  16.           If you are currently  running version 9.x or earlier  of PCBoard,
  17.           in  order to upgrade to the current product you must first covert
  18.           your various system  files to 10.0 format.   This is done  by the
  19.           program 9TO10.BAS  which is  included on  Disk 4  in the  CONVERT
  20.           subdirectory on the disk.  This program  should be placed in your
  21.           '\MAIN'  directory  along with  your  user's file.    The program
  22.           should  be  loaded  and run  using  BASICA  or  GWBASIC with  the
  23.           parameter "/S:152" -  which will  allow for the  new longer  USER
  24.           file record length.
  25.  
  26.           After  converting your older  format USER's file  to Version 10.0
  27.           format, proceed with  the instructions  in the following  section
  28.           (VERSION 10.0 -> 12.x UPGRADE INSTRUCTIONS).
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                           1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.           VERSION 10.0 -> 12.x UPGRADE INSTRUCTIONS
  76.           -----------------------------------------
  77.           All versions  of PCBoard now use record # 1  of the USERS file as
  78.           the "Master" sysop record.  This record, formatted exactly as any
  79.           other user record,  now stores  all Sysop data  - including  last
  80.           message  number read  information, transfer protocol,  and expert
  81.           flag  information.  This  record must remain  as record  # 1 from
  82.           this point on.  The reason for this change was to cut down on the
  83.           code accessing  record #  1 of  the  message base  and to  insure
  84.           better error trapping  of last message read pointers.  Therefore,
  85.           before continuing with  your conversion  process, you must  first
  86.           modify/create a sysop  record in  your CURRENT USERS  file -  and
  87.           then convert that file to 12  format.  Following this conversion,
  88.           you  can  then proceed  with  the  VERSION 12.x  ->  14.0 UPGRADE
  89.           INSTRUCTIONS.     Optionally,  a  program  called  10TO14.EXE  is
  90.           provided on Disk 4 of your distribution disks in the subdirectory
  91.           called  CONVERT -  which  has been  provided  compliments of  Tom
  92.           Alford.  This program should allow you to skip the steps below.
  93.  
  94.                1.   If you presently have a user record in your user's file
  95.                     which  you would like  to use  as your  "sysop" record,
  96.                     enter your current  version of the  code, bring up  the
  97.                     record number on your screen, note the record number of
  98.                     your current  "sysop" record on  a slip of  paper, exit
  99.                     the program, then proceed to step 4.
  100.  
  101.                2.   If you do NOT  have a current user  record you wish  to
  102.                     use as your "Sysop" record,  enter your current version
  103.                     of the code and (A)dd a  new user, entering their first
  104.                     and last names as the two "names" you wish to  use when
  105.                     logging on as the remote sysop.  Also, enter a password
  106.                     (since it will  be asked  for as well  when logging  on
  107.                     from remote).   Enter a security  level of 110.   Note:
  108.                     It is not  recommended that you  use your actual  first
  109.                     and last names as entries here.   Since these names are
  110.                     used  solely to verify  access rights and  are not used
  111.                     for   program  display  purposes,   you  should  use  a
  112.                     combination of first  and last names and  password that
  113.                     are totally unique to your system.
  114.  
  115.                3.   After completing the  above entry, note the  "record #"
  116.                     of the number just  created.  This number will  be used
  117.                     when  running a  conversion program  which  will "move"
  118.                     this record  to record # 1  of the user's file.   Note:
  119.                     If the record # you plan on using is already record #1,
  120.                     there  is no need for  a further conversion process and
  121.                     you can skip to step 5.
  122.  
  123.                4.   Place the program PCBSYSOP.EXE (found on Disk 4 in  the
  124.                     CONVERT subdirectory) in the same directory location as
  125.                     your USERS file.   This  program can be downloaded from
  126.                     the Salt Air  BBS system.   Run the program.   When  it
  127.  
  128.                                           2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.                     asks for the record # you wish to create as the sysop's
  142.                     record number,  input  the number  you have  determined
  143.                     from above.    For example,  if the  record number  you
  144.                     created was record #  345, enter the # 345  when asked.
  145.                     The program PCBSYSOP.EXE will then pick up record # 345
  146.                     and move  it to  record #  1, appending  all the  other
  147.                     user's in the file onto that record.  Note that no user
  148.                     records  will be  lost  using this  program.   When the
  149.                     process is finished,  a new file caller  USERS.NEW will
  150.                     be present  on your  disk which  will be  in proper  11
  151.                     format.  If the conversion is successful, copy this new
  152.                     file over as your new user's file  for version 11.  The
  153.                     new file can also be used with version 10.0 of the code
  154.                     without problems.
  155.  
  156.                5.   After completing the  above process,  you will want  to
  157.                     verify record #  1 as being  your sysop record.   Enter
  158.                     your  current  version  of  the  code  and  verify  the
  159.                     information in record # 1 is correct.  Then exit.
  160.  
  161.                     NOTE:  The  program PCBEDIT.COM  is  no longer  used by
  162.                     PCBoard.  This program has been replaced by the program
  163.                     PCBSM.EXE.  Do  NOT run  the program PCBEDIT.COM  after
  164.                     performing this conversion!
  165.  
  166.                6.   Next,  run the  program  USERS120.EXE  (located in  the
  167.                     CONVERT subdirectory) to  convert the above  USERS file
  168.                     to 12.x format.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                           3
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.           VERSION 11.x -> 12.x UPGRADE INSTRUTIONS
  208.           ----------------------------------------
  209.           CAUTION:  It is  essential that you  read this entire section  of
  210.           the document before attempting to upgrade your system to  version
  211.           12.x.  After  converting to 12.x,  then proceed with the  VERSION
  212.           12.X -> 14.0 UPGRADE INSTRUCTIONS.
  213.  
  214.           To do a quick upgrade, follow the instructions below:
  215.  
  216.           1.   Copy  the   file  "PCBTEXT"  to  your   "\GEN"  subdirectory
  217.                location.    Note  that  this  file  REPLACES  your  current
  218.                PCBTEXT.FIL file which is no longer used by the code.  Next,
  219.                copy the file CALLWAIT.SCR to your "DEFAULT" drive location.
  220.                This file is the `call waiting' menu and is loaded from disk
  221.                in binary  format when the code runs - rather than having it
  222.                stored  in  memory at  all times.    Finally, copy  the file
  223.                PCBPROT.DAT to each of your "DEFAULT" drive locations!  This
  224.                file is REQUIRED in order for the code  to load and contains
  225.                information on the  various transfer  protocols you will  be
  226.                supporting.
  227.  
  228.           2.   Next, you must  RENAME several other  system files in  order
  229.                for the new  code to find them.   First, if you  are running
  230.                any  "security specific"  BRDM.xxx, BRDMG.xxx,  BRDS.xxx, or
  231.                BRDSG.xxx main menu  files, they MUST  be renamed to  BRDMxx
  232.                and BRDMxxG  respectively.   (i.e. Move  the security  level
  233.                suffix to become  part of the  actual filename).  Third,  if
  234.                you  are  using a  NEWASK.DAT file,  it  must be  renamed to
  235.                NEWASK - without the  ".DAT" extension.  The reason  for the
  236.                above changes is to allow for multilingual language support.
  237.                Basically, all filenames which  previously had an extension,
  238.                with the  exception of the  DOORS.DAT file and  system batch
  239.                files, no  longer allow  any suffix  to be  included in  the
  240.                filename - since  the suffix  is needed  for supporting  the
  241.                various  foreign  language  versions  of the  system  files.
  242.                Please refer to  the section  on "Multilingual Support"  for
  243.                more  information on complete  file naming  conventions when
  244.                running under either of those environments.
  245.  
  246.           3.   Copy  the  new  PCBSETUP.EXE,  PCBPACK.EXE, and  PCBOARD.EXE
  247.                files to their respective location(s) on your system.
  248.  
  249.           4.   Copy the program USERS120.EXE to  your "\MAIN" location (the
  250.                location where your USERS' file is located.)
  251.  
  252.           5.   Change your current  directory location  to "\MAIN" and  run
  253.                the program USERS120.   As you run the  program, you will be
  254.                asked to enter default values for  several of the new USERS'
  255.                file  fields.    These  default values  include  "Expiration
  256.                Date", "Expiration Security  Level", "Expiration  Conference
  257.                Registration Info.", and  a default value for  a new "sysop-
  258.                maintained" comment field.    The program  will additionally
  259.  
  260.                                           4
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.                provide defaults for these values.  If you wish to over-ride
  274.                the default values, simply enter the data you wish.  You can
  275.                abort the conversion at any  time by simply pressing  (Esc).
  276.                No  damage  will be  done  to  your current  USERS'  file by
  277.                aborting this program.  If you allow the program to complete
  278.                it's conversion process, a new file  will be created on disk
  279.                called "NEWUSERS" -which can be copied  over the top of your
  280.                current USERS file when you are satisfied you  have properly
  281.                configured your new system.
  282.  
  283.           6.   Change  your   current  directory  location   back  to  your
  284.                "DEFAULT" location and run the  new version of PCBSETUP.EXE,
  285.                setting and saving the new values  in the various screens as
  286.                required.   Please note  the following  changes  in the  new
  287.                PCBSetup  program:    1) The  previous  file  definition for
  288.                storing your NEWASK answers  - usually NEWREG.DAT -  can now
  289.                only  be  8  letters  long  without  an  extension and  will
  290.                automatically be adjusted  to this format when you  load the
  291.                program - double check this entry!;  2) The previous flag of
  292.                "Pause During Node CHAT" has been changed to allow disabling
  293.                of the  upload drive  size space  check to  allow using  the
  294.                SUBST  command when  defining an Upload  drive; 3)  You must
  295.                indicate in the "Switches  & Stuff" screen whether you  want
  296.                all main board  messages to  default to "private  messages",
  297.                whether you want to run your  system in "subscription mode",
  298.                and  must  also  define  a  prompt for  the  user-maintained
  299.                comment field;   4) The  previous field of  "Running an  EGA
  300.                Monitor Under  True Network"  has been  changed to  "Disable
  301.                Keyboard  5  Min.  Timeout  Period";  and  5)  the  previous
  302.                "Switches & Stuff" prompt of  "Disable String Garbage Clean-
  303.                Up" has  been changed  to  "Enable User's  City During  CHAT
  304.                displays".  Please check ALL PCBSetup screens before running
  305.                the code to insure a proper configuration.
  306.  
  307.           7.   Load  and run  the  12.0 version  of  PCBoard.   IMMEDIATELY
  308.                select sysop option  (8) and pack  your USERS' file.   After
  309.                the  program  completes  packing the  USERS'  file,  it will
  310.                automatically create 26 quick index  user's files for use by
  311.                the code.   As PCBoard re-loads  after the file is  created,
  312.                your 26  new USERS'  Quick  Index Files  will be  available.
  313.                Next,  IMMEDIATELY  pack EACH  of  your message  bases using
  314.                Sysop option (3)!   Failure to  pack EACH message base  will
  315.                result in erroneous code operation!
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                           5
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.           VERSION 12.X -> 14.0 UPGRADE INSTRUCTIONS
  340.           -----------------------------------------
  341.  
  342.           The files needed for PCBoard v14.0 operation are:
  343.  
  344.                Filename       Description
  345.                ------------   ---------------------------------------
  346.                PCBOARD.EXE    PCBoard v14.0 main program module
  347.                PCBPACK.EXE    PCBoard v14.0 pack module
  348.                PCBSETUP.EXE   PCBoard v14.0 Setup Program
  349.                PCBFILER.EXE   PCBoard v14.0 File Maintenance Program
  350.                PCBSM.EXE      PCBoard v14.0 PCBSysMgr Maintenance Program
  351.                PCBDIAG.EXE    PCBoard v14.0 System diagnostics program
  352.                PCBCONV.EXE    PCBoard v14.0 Convert for USERS/MSGS
  353.                CALLWAIT.SCR   PCBoard v14.0 CALLWAIT.SCR
  354.                MKPCBTXT.EXE   PCBTEXT file maintenance/generate program
  355.                PCBTEXT        New PCBTEXT File
  356.                HLPx           New HELP Files
  357.                BRDM, BRDS     New Main Menus
  358.  
  359.           Additional files which are available, but not required are:
  360.  
  361.                PCBPROT.DAT    PCBoard v14.0 PCBPROT.DAT & .BAT files
  362.                PCBNUM.EXE     PCBoard v14.0 caller number adjuster program
  363.                PCBMODEM.EXE   PCBoard  v14.0  PCBModem  -   for  new  style
  364.                               AX9624C's
  365.                ANSFILER.EXE   PCBFiler   for   remote   operation  (DOORWAY
  366.                               required!)
  367.                ANSSETUP.EXE   PCBSetup   for   remote   operation  (DOORWAY
  368.                               required!)
  369.                ANSSM.EXE      PCBSysMgr  for   remote  operation   (DOORWAY
  370.                               required!)
  371.  
  372.                             * * *  C A U T I O N S  * * *
  373.  
  374.           BEFORE ATTEMPTING  TO LOAD  ANY V14.0 FILE,  YOU MUST  COMPLETELY
  375.           BACKUP YOUR ENTIRE SYSTEM -  SINCE THE NEW PROGRAMS (WHEN  RUN) -
  376.           WILL PERMANENTLY ALTER YOUR PRESENT FILES.
  377.  
  378.           DO NOT BEGIN  THIS CONVERSION PROCESS  UNTIL YOU HAVE  SUFFICIENT
  379.           TIME IN  WHICH TO PERFORM THE ENTIRE  CONVERSION!  ONCE YOU BEGIN
  380.           THE CONVERSION, YOU MUST  FOLLOW ALL THE STEPS INDICATED!   ALSO,
  381.           THERE ARE NO  UTILITY PROGRAMS PROVIDED  WHICH WILL ALLOW YOU  TO
  382.           'REVERSE' THE PROCESS  OF UPGRADING  TO 14.0 ONCE  IT HAS  BEGUN.
  383.           (I.E. THERE ARE  NO PROGRAMS  WHICH WILL CONVERT  A V14.0  USER'S
  384.           FILE  BACK TO  A  PREVIOUS FORMAT!)    YOU  SHOULD *FIRST*  DO  A
  385.           COMPLETE REPACK OF  ALL YOUR  MESSAGE BASES AND  YOUR USERS  FILE
  386.           BEFORE BEGINNING THIS CONVERSION PROCESS!
  387.  
  388.           YOU *MUST* REMOVE THE  FILE PCBFILER.COM FROM YOUR SYSTEM.   THAT
  389.           FILE IS REPLACED BY PCBFILER.EXE.  FAILURE TO REMOVE PCBFILER.COM
  390.           MAY RESULT IN CORRUPTED DIR FILES!!!
  391.  
  392.                                           6
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.                        * * *  Novell & Network/OS Users  * * *
  406.  
  407.           Novell and Network/OS sysops  will need to insure that  they have
  408.           a:
  409.  
  410.                SET PCB=/NMT
  411.  
  412.           statement in their environment prior to code load or they may not
  413.           get any screen displays and their system will lock up!
  414.  
  415.                              * * *  C A U T I O N  * * *
  416.  
  417.                V14.0 HAS BEEN DESIGNED TO EASILY  CONVERT ALL OF YOUR V12.X
  418.                FILES USING PCBSETUP TO PERFORM THE  CONVERSION.  IF YOU ARE
  419.                USING PRE-V12.0 SOFTWARE  YOU *MUST*  BEGIN BY DOING  SCREEN
  420.                DUMPS ON ALL SCREENS IN YOUR CURRENT PCBSETUP BEFORE COPYING
  421.                ANY NEW FILES.  ADDITIONALLY, IT IS STRONGLY  SUGGESTED THAT
  422.                ALL  USERS,  REGARDLESS OF  WHAT  VERSION THEY  ARE RUNNING,
  423.                FIRST MAKE A SCREEN DUMP OF ALL CURRENT PCBSETUP SCREENS FOR
  424.                REFERENCE WHEN CONFIGURING V14.0 FOR OPERATION.  SINCE V14.0
  425.                IS SUBSTANTIALLY MORE  FLEXIBLE THAN  ANY PREVIOUS  RELEASE,
  426.                YOU WILL FIND IT VERY HELPFUL  IF YOU HAVE PRINTOUTS OF YOUR
  427.                CURRENT  CONFIGURATION FROM WHICH  TO REFER WHEN CONFIGURING
  428.                YOUR NEW SYSTEM.
  429.  
  430.           1.   After  backing  up  your  complete  system, copy  the  above
  431.                programs to  their  respective  locations  on  your  system.
  432.                Usually, this means  all of the  above .EXE files should  be
  433.                placed in your default "\PCB"  location, with the HELP files
  434.                going  in your "\PCB\HELP"  location.   The v14.0  menus and
  435.                PCBTEXT files should  be placed  in your current  "\PCB\GEN"
  436.                location.
  437.  
  438.           2.   Next,  if  you  have any  BRDMGxx  files  (where  'xx' is  a
  439.                security specific menu file), they *must* be renamed  in the
  440.                format BRDMxxG.
  441.  
  442.                Example:       Oldname ->  BRDMG10
  443.                               Newname ->  BRDM10G
  444.  
  445.           3.   Run the PCBCONV.EXE program.   This program can be  run from
  446.                any  location  on your  system.   This  program is  used for
  447.                converting  both  your USERS  file, as  well as  all message
  448.                bases, to the new v14.0 format.   When the program runs, you
  449.                will be asked to select which file you wish to convert.  You
  450.                will  be asked  to  supply a  new name  for the  output file
  451.                generated  by  the  conversion  process.   This  means  your
  452.                current file  will be left intact in the event of a problem.
  453.                Additionally, you can  abort the  conversion process at  any
  454.                time by simply pressing  the (Esc) key.  You  *must* convert
  455.                all message bases on your system as well  as your USERS file
  456.                before continuing.
  457.  
  458.                                           7
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                              * * *  C A U T I O N  * * *
  472.  
  473.                V14.0  OF PCBOARD REQUIRES  400 BYTES OF  STORAGE PER SINGLE
  474.                USER RECORD!  INSURE YOU HAVE SUFFICIENT DISK STORAGE  SPACE
  475.                AVAILABLE  BEFORE  BEGINNING  YOUR CONVERSION  -  SINCE  ALL
  476.                MESSAGE BASES WILL  BE DUPLICATED AND DUPLICATE  YOUR USERS'
  477.                FILE WILL BE SUBSTANTIALLY LARGER THAN YOUR CURRENT COPY!
  478.  
  479.           4.   After converting your  message bases and USERS file  over to
  480.                the new format,  you should load and run PCBSetup.  When you
  481.                run this program for the first  time, it will recognize that
  482.                you  are  converting  from a  pre-v14.0  format,  and adjust
  483.                itself accordingly.
  484.  
  485.                Please note that  v14.0 of  the code allows  you to  'share'
  486.                almost  any  system  file  between  conference  locations  -
  487.                including all menus,  scripts, NEWS,  BLTx, and DIRx  files.
  488.                This  should  substantially help  those  sysops who  wish to
  489.                share common information  among areas.  However, it can also
  490.                cause a problems if  one of the 'shared' files  is altered -
  491.                without  understanding  the effects  it  will have  on other
  492.                areas of  your system.    Use extreme  caution when  sharing
  493.                files between areas!
  494.  
  495.           5.   Some notes on using the new PCBSetup program:
  496.  
  497.                A.  You will need to run PCBSetup  before you can run either
  498.                PCBSM or PCBFiler.  The initial run of PCBSetup will convert
  499.                your PCBOARD.DAT,  CNAMES and  other configuration files  to
  500.                v14.0 format.
  501.  
  502.                Note: PCBSetup  will not  modify any  of your  configuration
  503.                files until you  exit the program  and request that it  save
  504.                the new files.  At this  point it  creates a  backup of  the
  505.                files called PCBOARD.OLD  and CNAMES.OLD  thus avoiding  any
  506.                potential loss of data.
  507.  
  508.                B. The  easiest way  for multi-node  systems to  perform the
  509.                conversion  where  the  GEN directory  and  other  files are
  510.                shared between nodes is  to simply run PCBSetup once  on one
  511.                node only.  Then  copy the newly created PCBOARD.DAT  to the
  512.                other  nodes and  make changes  there to  indicate the  node
  513.                number and comm port if necessary.
  514.  
  515.                C. At certain points in the program, a prompt will appear on
  516.                the screen which  indicates that by  pressing (F2), you  can
  517.                edit the file  highlighted without having to  use a separate
  518.                text editor.    We strongly  recommend  you edit  all  files
  519.                available using PCBSetup to avoid inserting bogus lines into
  520.                your ASCII system files - such as your PWRD's file, etc.
  521.  
  522.                PCBSetup will also allow you to modify any of the ASCII text
  523.  
  524.                                           8
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.                and graphics screens used by PCBoard.  However, to do so you
  538.                will have to first run PCBSM and enter the names of the TEXT
  539.                and GRAPHICS editors you  wish to use.   After this is  done
  540.                you can press F2 to edit TEXT files and press F3 to edit the
  541.                GRAPHICS versions of the same files.
  542.  
  543.                D.  The  code  no  longer  uses  a  specific  "\PCB\GEN"  or
  544.                "\PCB\MAIN" drive locations.  However, it is again suggested
  545.                you  maintain   your  current  "\PCB\GEN"   and  "\PCB\MAIN"
  546.                locations  to  minimize configuration  changes  and possible
  547.                inducing of errors in your setup.
  548.  
  549.                E.  The new  DIR.LST, SCRIPT.LST and  BLT.LST files  are new
  550.                random access files which  are used to store information  on
  551.                what files  are to be accessed  during the (F),  (S) and (B)
  552.                commands respectively.  DO  NOT ATTEMPT TO EDIT  THESE FILES
  553.                USING  A STANDARD  TEXT  EDITOR!   ONLY USE  PCBSETUP'S (F2)
  554.                FUNCTION TO EDIT THESE FILES!
  555.  
  556.                F. When exiting  PCBSetup, you have several  "save" options.
  557.                The default of (Y)es, saves all new values and proceeds with
  558.                a verification  check of your current configuration.   It is
  559.                strongly suggested you use this option whenever you change a
  560.                file definition or path statement inside PCBSetup.  A second
  561.                save option is  (Q)uick Save -  which saves all new  values,
  562.                but does not perform any configuration checking.  If (N)o is
  563.                entered, the program terminates without saving any new data.
  564.  
  565.                G.  It  should be  noted that  most  of the  old environment
  566.                switches that PCBoard used  to use have now been  moved into
  567.                PCBSetup and  will be ignored if placed  in the environment.
  568.                It  is  therefore suggested  that  you examine  your startup
  569.                batch files  to determine if  any of  these were in  use and
  570.                remove  them  as  well  as  make sure  the  the  appropriate
  571.                questions are answered in the PCBSetup Options #2 screen.
  572.  
  573.                H. When PCBSetup creates the new  .LST files which contain a
  574.                list of the DIR files,  download paths, doors, bulletins and
  575.                scripts  available  for  each  conference  it  makes certain
  576.                assumptions based on the status of the "Mini-BBS" flag.
  577.  
  578.                If  you  have answered  NO to  the  "Mini-BBS" flag  in your
  579.                current v12.x setup then PCBSetup will create the .LST files
  580.                in such a way  that all DIRS, SCRIPTS, BULLETINS,  DOORS and
  581.                DOWNLOAD  PATHS that were  available on the  Main Board will
  582.                still be available.
  583.  
  584.                If, on the other hand, the "Mini-BBS" flag is set to  YES at
  585.                the time  you perform  the conversion  then your  conference
  586.                will only have access to the DIRS, SCRIPTS, BULLETINS, DOORS
  587.                and DOWNLOAD PATHS that are inside the conference setup.
  588.  
  589.  
  590.                                           9
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.                If you are converting your system and have not yet saved the
  604.                PCBOARD.DAT file  in v14.0  format you  can experiment  with
  605.                this by going into  the old PCBSetup and changing  the Mini-
  606.                BBS  flag one way or the other  to see the effects it has on
  607.                the .LST file creation.
  608.  
  609.                Once the file is  created you can always reconfigure  it any
  610.                way you like.   Remember, v14.0 is VERY flexible,  almost to
  611.                the point of being overwhelming if you try to take advantage
  612.                of everything it  allows.  However, by knowing what PCBSetup
  613.                is  doing  you  can  possible save  yourself  some  time  in
  614.                performing the conversion.
  615.  
  616.  
  617.                I. For  those of you  who were running  extended conferences
  618.                beyond  the  nine  conferences   supported  directly  within
  619.                PCBoard (such as the  users of QwikMail or ProDoor)  you can
  620.                easily convert  your entire conference  setup including  the
  621.                extended conferences by doing the following:
  622.  
  623.                     a. Create a single  CNAMES file that lists all  of your
  624.                     conferences and their locations in normal CNAMES format
  625.                     with up to 39 conferences in the file.
  626.  
  627.                     b. Use a  text editor capable  of editing lines  longer
  628.                     than 255 characters to edit  your existing v12.x format
  629.                     PCBOARD.DAT  file to  change the number  of conferences
  630.                     from 9 to whatever the number is.  Example:  if you had
  631.                     10 extended conferences then you  would change the 9 to
  632.                     a 19.
  633.  
  634.                     c. Now  simply run  PCBSetup and  it will  read in  and
  635.                     convert  the extended  conferences in  addition to  the
  636.                     standard conferences.
  637.  
  638.           6.   You are supplied  with a  new PCBTEXT file  which should  be
  639.                placed in your  current "\PCB\GEN" location.   Also included
  640.                with v14.0 is a program called MKPCBTXT.EXE which allows you
  641.                to perform bilingual or multilingual language conversions on
  642.                the file  very easily.  After loading  the MKPCBTXT program,
  643.                you will  be asked for  the file you wish  to edit.   If you
  644.                wish  to  create a  new  file,  simply enter  it's  name and
  645.                location in the required field.  After pressing (Enter), the
  646.                program will indicate the file does not currently  exist and
  647.                ask if you  wish to create it.   After replying with  a (Y),
  648.                the new file will  be created.  CAUTION:  DO  NOT ATTEMPT TO
  649.                ALTER ANY OF  THE "(" OR ")"  SIGNS IN YOUR PCBTEXT  FILE AS
  650.                YOUR CODE MAY BECOME INOPERABLE IF YOU DO!
  651.  
  652.                If you  wish to create a  new PCBTEXT file, it  is suggested
  653.                you  copy  your  current file  over  to  a  new file  called
  654.                PCBTEXT.NEW,  followed by  using  MKPCBTXT.EXE  to edit  it.
  655.  
  656.                                           10
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.                When you are satisfied  with all of your changes,  then copy
  670.                the PCBTEXT.NEW file back to PCBTEXT.
  671.  
  672.                After making a text change to a record in your PCBTEXT file,
  673.                you should  press (Enter)  - after  which  the program  will
  674.                automatically justify your field based  on the right or left
  675.                justification indicated.
  676.  
  677.           7.   When calling up the  new PCBPack module from a  command line
  678.                mode,  you can  have the  program display  the  command line
  679.                options  which  are supported  by  simply typing  in PCBPACK
  680.                without any additional options.
  681.  
  682.           8.   As indicated herein, v14.0  of the code uses minute  integer
  683.                timing  to control  all event timing,  etc.  As  a result of
  684.                this, you must insure the time it takes to run your event is
  685.                at least one minute  in length.  If it is not, the code will
  686.                reload and run the event multiple times until the event time
  687.                'minute' has expired.
  688.  
  689.           9.   All environment switches have been moved from the 'SET PCB='
  690.                parm  to  the PCBSetup  program  except the  "/BIO", "/NMT",
  691.                "/BLAST", "/BAUD:xxxx", "/DELAY:x" and "/NOCTS" parms.   You
  692.                can now select your modem type  and 'lock modem speed' parms
  693.                from inside PCBSetup.  Note that you should only select "EVI
  694.                FastComm" modem if you are using an old style FastComm which
  695.                does  not support MNP  error checking.   Again, double check
  696.                your various  batch files to see  if you need to  remove any
  697.                un-needed parms from your 'SET PCB=' statement.
  698.  
  699.           10.  One  command  line parm  is  available when  calling  up the
  700.                program from the BOARD.BAT file.  It is:
  701.  
  702.                /LOCALON
  703.  
  704.                The  use  of the  '/LOCALON' switch  allows  the code  to be
  705.                automatically loaded to the point of asking for the caller's
  706.                name and is  designed to support systems  running 'in-house'
  707.                mail systems.
  708.  
  709.           11.  To  take  advantage  of PCBoard  v14.0's  multiple  DIR line
  710.                description  feature,  simply  include a  "|"  in  each line
  711.                following  the  main  file  description   line.    The  only
  712.                requirement is that  the first  character in all  subsequent
  713.                lines must be  a blank!  However,  you can place the  "|" in
  714.                any  position  in the  line  that  you  desire  (other  than
  715.                position #1).
  716.  
  717.           12.  Due  to  the  recent legal  activites  involving  the former
  718.                '.ARC'  public  domain  routines,  PCBoard  will  no  longer
  719.                directly support the  viewing of  '.ARC' file contents  with
  720.                internal assembly language routines.  Instead, the code will
  721.  
  722.                                           11
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                now call up  a batch file  through a SHELL operation,  which
  736.                will allow the  sysop to use whatever  type file compression
  737.                program is  applicable to  the files  on their  system.   In
  738.                order  for  this  to  work  properly,  you  must  follow the
  739.                instructions below:
  740.            
  741.                A.  Load  the new  PCBSetup program,  and  in the  Options 2
  742.                screen, enter two new  pieces of information.  The  first is
  743.                the name of the batch file which will be used to call up the
  744.                file  compression  utility program,  and  the second  is the
  745.                default  filename  extension  which  your  system  will use.
  746.                (i.e.   'ARC',  'PAK', etc.)    The default  batch  filename
  747.                entered should be  PCBVIEW.BAT and  *must* be structured  as
  748.                follows: 
  749.            
  750.                     (utility program) %1 > pcbview.txt 
  751.            
  752.                NOTE:   PCBoard  will pass  the  compressed filename  to  be
  753.                viewed in  the '%1'  parameter field.   The '>  pcbview.txt'
  754.                portion of the  command line simply redirects  the output of
  755.                the routine  to a  file which  PCBoard will  display to  the
  756.                caller on completion of the SHELL.   CAUTION:  DO NOT CHANGE
  757.                THE '%1 > PCBVIEW.TXT' PORTION OF  THE ABOVE COMMAND LINE OR
  758.                YOUR (F) (V) COMMAND WILL NOT WORK! YOU CAN *ONLY* ALTER THE
  759.                FIRST  PART  OF  THE COMMAND  LINE  TO  INDICATE WHICH  FILE
  760.                COMPRESSION  UTILITY  PROGRAM TO  USE!   The  batch filename
  761.                specified (PCBVIEW.BAT) can  reside in any location  on your
  762.                system if you  include a  drive+sudirectory location in  the
  763.                field. Also, make  sure you enter the  *complete* batch file
  764.                filename in the field indicated  - since PCBoard will  first
  765.                check for  the presence  of  that file  before allowing  the
  766.                command to execute!
  767.            
  768.                B. The filename  extension field allows  you to specify  the
  769.                suffix  extension of the compressed files  you will be using
  770.                on your system. If  your caller fails to enter  the filename
  771.                extension when requesting  an (F) (V) command, the code will
  772.                automatically 'add' the extension specified here in order to
  773.                find the  file on disk.  NOTE:   YOU CAN NOT  HAVE DIFFERENT
  774.                TYPES OF COMPRESSED FILENAME EXTENSIONS ON YOUR SYSTEM!  ALL
  775.                COMPRESSED FILENAMES *MUST*  HAVE THE SAME EXTENSION  - SUCH
  776.                AS 'PAK', 'ARC', ETC.  DO *NOT* ATTEMPT TO USE A COMBINATION
  777.                OF  SEVERAL  EXTENSIONS -  AS PCBOARD  WILL ONLY  ATTEMPT TO
  778.                LOCATE THOSE FILES WHICH MATCH THE EXTENSION SPECIFIED! 
  779.            
  780.                C. The  PCBVIEW.BAT file  should normally  be a single  line
  781.                entry which calls  up your file compression  utility program
  782.                (including any  necessary  command  line  parameters.    The
  783.                second half  of the command line includes  those items which
  784.                PCBoard needs in order to be  able to display the results of
  785.                the (F) (V) request to the caller and must *not* be altered!
  786.                The exact format of the PCBVIEW.BAT  file should be: 
  787.  
  788.                                           12
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.            
  802.                  (utility program name + parms) %1 > pcbview.txt 
  803.            
  804.                  For example: 
  805.            
  806.                  pkxarc /v %1 > pcbview.txt 
  807.            
  808.                would  function   properly.    DO   NOT  ALTER  THE   '%1  >
  809.                PCBVIEW.TXT' PORTION OF THE COMMAND LINE! 
  810.            
  811.                D.  Upon  completion of  the  SHELL procedure,  PCBoard will
  812.                check for the presence of  the PCBVIEW.TXT file and  display
  813.                it  to the caller if found  - followed by deleting the file.
  814.                If  the file is  not found, the  caller will be  displayed a
  815.                message indicating an  error occured attempting to  view the
  816.                compressed file. 
  817.            
  818.                E. CAUTION:  SINCE THIS NEW ROUTINE USES A 'SHELL' PROCEDURE
  819.                TO  WORK,  YOU  *MUST*  INSURE  YOU HAVE  SUFFICIENT  MEMORY
  820.                AVAILABLE  ON  YOUR  SYSTEM  IN ORDER  TO  INVOKE  THE  FILE
  821.                COMPRESSION UTILITY.  SINCE PCBOARD  IS USING ABOUT 210K  OF
  822.                MEMORY AT  THAT POINT, YOU SHOULD HAVE  AT *LEAST* 210k+SIZE
  823.                OF FILE COMPRESSION PROGRAM AVAILABLE AS FREE MEMORY ON YOUR
  824.                SYSTEM IN ORDER FOR THE COMMAND TO WORK PROPERLY.  IF YOU DO
  825.                NOT HAVE SUFFICIENT MEMORY, YOUR SYSTEM MAY RECYCLE WHEN THE
  826.                CODE  ATTEMPTS TO  SHELL OUT  TO THE  BATCH  FILE -  SINCE A
  827.                MEMORY ERROR WILL  OCCUR.   IT IS SUGGESTED  YOU ATTEMPT  TO
  828.                LOCATE AND USE THE SMALLEST FILE COMPRESSION UTILITY PROGRAM
  829.                AVAILABLE FOR YOUR SYSTEM IF YOU ARE SHORT ON MEMORY!! 
  830.            
  831.                F. Included  with this release is a  very small VIEWARCH.COM
  832.                file  which can  currently be  used to replace  the previous
  833.                internal PCBoard view function.   By using this file, little
  834.                additional   memory  should  be  required  by  your  system.
  835.                CAUTION:    THE VIEWARCH.COM  FILE WILL  AUTOMATICALLY WRITE
  836.                DIRECTLY TO THE PCBVIEW.TXT FILE *WITHOUT* HAVING TO USE THE
  837.                BATCH FILE  MODE OF  OPERATION.   IF YOU  ARE RUNNING  UNDER
  838.                *ANY* MULTITASKING SOFTWARE, YOU SHOULD  *NOT* USE THE BATCH
  839.                FILE  METHOD  OF  OPERATION.    INSTEAD,  SIMPLY  ENTER  THE
  840.                FOLLOWING IN PLACE OF THE PCBVIEW.BAT FILE ENTRY:
  841.            
  842.                  VIEWARCH.COM
  843.  
  844.                This  will automatically  create  the necessary  PCBVIEW.TXT
  845.                file needed for proper operation.
  846.            
  847.                G. If you wish to disable the (F) (V) function entirely, you
  848.                can use the following statement in your SET PCB= environment
  849.                switch: 
  850.            
  851.                  SET PCB=/NOVIEW 
  852.            
  853.  
  854.                                           13
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.                which will completely disable the function. 
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                           14
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.           PCBOARD.DAT
  934.           -----------
  935.           All versions of PCBoard  11.x and above require a  completely new
  936.           PCBOARD.DAT configuration file.   If you  are converting from  an
  937.           earlier  version  of PCBoard,  you must  make  a set  of complete
  938.           screen dumps of  all of  your current PCBSETUP.EXE  screens.   No
  939.           conversion program is  provided to  upgrade a  pre-11 version  of
  940.           PCBOARD.DAT to version 12.  It  is mandatory that all information
  941.           be re-entered in the new PCBSETUP.EXE  program.  Having copies of
  942.           your previous screens will make this task much easier.
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                           15
  987.  
  988.  
  989.  
  990.  
  991.  
  992.