home *** CD-ROM | disk | FTP | other *** search
/ The Unsorted BBS Collection / thegreatunsorted.tar / thegreatunsorted / misc / ipro.doc < prev    next >
Text File  |  1996-12-05  |  105KB  |  2,516 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                              INSTALLATION PRO
  15.                              ================
  16.  
  17.                                 Version 3.3
  18.  
  19.                                  Release B
  20.  
  21.                           Copyright (C) 1990-1996
  22.  
  23.                                 BMB Software
  24.  
  25.                                P. O. Box 1071
  26.  
  27.                       West Springfield, MA  01090-1071
  28.  
  29.                             Phone: (413) 746-9478
  30.  
  31.                              FAX: (413) 746-9523
  32.  
  33.                              BBS: (413) 731-1155
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.     Table of Contents                                            Page
  43.     =================                                            ====
  44.  
  45.      Introduction................................................ 1 
  46.      Getting Started............................................. 1 
  47.      Product Description......................................... 1 
  48.      System Requirements......................................... 2 
  49.      Installing the Software (from diskette)..................... 2 
  50.      Editing Keys................................................ 3 
  51.      Creating a Title............................................ 3 
  52.      Product Name................................................ 3 
  53.      Product Version............................................. 3 
  54.      Installation Screen Title................................... 4 
  55.      Selecting Screen Colors..................................... 5 
  56.      Title Color................................................. 5 
  57.      Menu Color.................................................. 6 
  58.      Query Line Color............................................ 6 
  59.      The Installation Diskette Set............................... 6 
  60.      Number of Diskettes......................................... 6 
  61.      Insert Alert................................................ 6 
  62.      Volume IDs.................................................. 6 
  63.      Checking Target System...................................... 7 
  64.      Viewing an Inro File........................................ 7 
  65.      Checking for Free Disk Space................................ 7 
  66.      Checking Target System Base RAM............................. 8 
  67.      Continuing with Less RAM.................................... 8 
  68.      Checking for DOS Versions................................... 8 
  69.      DOS Versions................................................ 8 
  70.      CPU Type.................................................... 9 
  71.      Math Co-Processor........................................... 9 
  72.      Continuing w/o a Math Co-Processor.......................... 9 
  73.      Monitor Type................................................ 9 
  74.      Default Source Drive........................................ 9 
  75.      Default Destination Drive................................... 10 
  76.      Creating Directories........................................ 10 
  77.      Directory Creation Messages................................. 10 
  78.      Copying Files............................................... 12 
  79.      Source Files................................................ 12 
  80.      Destination................................................. 13 
  81.      Copy Codes.................................................. 14 
  82.      Scrolling Region............................................ 15 
  83.      File Viewing................................................ 16 
  84.      Name of Viewing File........................................ 16 
  85.      Viewing Disk Number......................................... 17 
  86.      Executing Another Program................................... 17 
  87.      File Execution.............................................. 17 
  88.      Execution Disk Number....................................... 18 
  89.      Re-Booting Target System.................................... 18 
  90.      Security/Other Function..................................... 18 
  91.      Security Command Line....................................... 18 
  92.      Security Drive.............................................. 19 
  93.  
  94.                                         i
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.     Table of Contents (continued)                                Page
  103.     =================                                            ====
  104.  
  105.      Before or After............................................. 19 
  106.      Check ICA................................................... 20 
  107.      Modifying System Files...................................... 20 
  108.      Modifying AUTOEXEC.BAT...................................... 20 
  109.      Primary Path................................................ 20 
  110.      Secondary Path.............................................. 21 
  111.      Adding AUTOEXEC.BAT Lines................................... 22 
  112.      Modifying CONFIG.SYS........................................ 22 
  113.      CONFIG.SYS FILES Option..................................... 22 
  114.      CONFIG.SYS BUFFERS Option................................... 22 
  115.      Adding CONFIG.SYS Lines..................................... 22 
  116.      Custom BATCH................................................ 23 
  117.      Directing the Output File (for the INSTALL.EXE program)..... 23 
  118.      Output File Spec............................................ 23 
  119.      Terminating................................................. 24 
  120.      The INSTALL Program......................................... 24 
  121.      The Introductory Screen..................................... 25 
  122.      The NEEDS Screen............................................ 26 
  123.      Source Drive Screen......................................... 28 
  124.      Destination Path Screen..................................... 28 
  125.      Insert Diskette Screen...................................... 29 
  126.      Performing Security/Other Function.......................... 29 
  127.      The AUTOEXEC.BAT Screen..................................... 30 
  128.      The CONFIG.SYS Screen....................................... 30 
  129.      The File Viewing Screen..................................... 31 
  130.      Re-Booting Screen........................................... 31 
  131.      The Final Screen............................................ 31 
  132.      File Compression............................................ 32 
  133.      Splitting Files............................................. 33 
  134.      Examples.................................................... 33 
  135.      BLDSPLIT.................................................... 37 
  136.      File to Split............................................... 37 
  137.      Fit to Floppy............................................... 38 
  138.      Vol. Labels?................................................ 38 
  139.      Drive?...................................................... 38 
  140.      All Same?................................................... 38 
  141.      KBytes?..................................................... 38 
  142.      Error Messages.............................................. 39 
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.                                        ii
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.      Introduction
  162.  
  163.          Thank you for trying BMB Software's Installation Pro, herein
  164.          referred to as IPro.  Registering the software will enable you
  165.          to obtain free technical support by phone, FAX, and BBS.
  166.  
  167.          Should you need clarification for an answer to a question
  168.          while using Installation Pro (herein referred to as IPro)
  169.          press the <F1> key for help.  If that does not give you
  170.          enough information, then please read the manual carefully
  171.          before calling for support.  Best method to obtain help is
  172.          to FAX questions to BMB Software or post a message to SYSOP
  173.          on the BMB Software BBS.  Thank you.
  174.  
  175.      Getting Started
  176.  
  177.          If you downloaded this program as a .ZIP archive file, then
  178.          just create subdirectory (like \IPRO) and unZIP the file
  179.          into that directory and run MAKEINST to start the program.
  180.          If you obtained IPro on diskette with an INSTALL program on
  181.          it, then the INSTALL program will place the files in the
  182.          directory that it (optionally) creates.  You may then read
  183.          the defaults from the INSTALL.EXE program on diskette to see
  184.          how that INSTALL.EXE program was generated.
  185.  
  186.          If during the installation process, you were presented a file
  187.          for viewing, then that file will reside in the same directory
  188.          as Installation Pro.  If so, this file is an ASCII file and can
  189.          be PRINTed or TYPEd from the DOS prompt.
  190.  
  191.      Product Description
  192.  
  193.          The Installation Pro product is made up of one file called
  194.          MAKEINST.EXE.  This file's name is a acronym for MAKE
  195.          INSTall.  This program will generate a customized
  196.          executable file (named INSTALL.EXE by default) for
  197.          installation of your software product after answering a series
  198.          of questions about your software product requirements.
  199.  
  200.          There are no script files to copy along with the installation
  201.          program.  You don't need any compiler or specific computer
  202.          language knowledge because there is no compiling to
  203.          perform to get your executable.  You don't have to spend
  204.          time editing source code, compiling, and maintaining your
  205.          installation program.  This leaves more time to spend on
  206.          your software product or other area of your business.
  207.  
  208.          Making big or small changes is easy.  Just read the defaults
  209.          from the INSTALL.EXE program that you want to make
  210.          changes to and all your previous answers will appear as the
  211.  
  212.                                         1                                       
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.          default answers in the MAKEINST.EXE program.  Now all
  221.          you have to do is change the ones you wish.
  222.  
  223.  
  224.      System Requirements
  225.  
  226.          The following requirements are required or strongly suggested:
  227.  
  228.          - IBM AT/286/386/486/586 computer
  229.          - MS-DOS or PC-DOS version 2.1 or later
  230.          - Hard disk
  231.          - One floppy drive (360K or better)
  232.          - 80 column monitor (color monitor preferred)
  233.  
  234.          Although MAKEINST.EXE will run on a monochrome monitor, the
  235.          color chart used for selecting various screen colors will be
  236.          difficult to use.
  237.  
  238.  
  239.      Installing the Software (from diskette)
  240.  
  241.          Installing Installation Pro is very simple because Installation
  242.          Pro was used to create its own installation program.  It will
  243.          create a directory called 'IPro' which will contain the Instal-
  244.          lation Pro files.
  245.  
  246.          If you allow the installation program to modify/create your
  247.          AUTOEXEC.BAT file at installation time, then Installation
  248.          Pro will have added itself to your path statement.  This will
  249.          allow you to use the MAKEINST.EXE file from anywhere on your
  250.          system.  If you like, you can put the MAKEINST.EXE file in your
  251.          DOS or UTILITY directory if you have one.  However, it is best
  252.          to have an IPro directory for Installation Pro.
  253.  
  254.          You may install the software in one of two ways:
  255.  
  256.          - Make the drive you are installing from the default drive and
  257.            then typing 'INSTALL' without the quotes, or...
  258.  
  259.          - Type the letter of the drive where the installation
  260.            diskette(s) is(are).  If you are installing Installation
  261.            Pro from drive B: then you would type B:\INSTALL
  262.  
  263.          We know that you, the reader, a software developer, will be all
  264.          too familiar with these procedures.  However these instructions
  265.          are not here to insult you, but are for the occasional reader
  266.          who may not be familiar with MS-DOS PC-DOS
  267.          systems.
  268.  
  269.          Note: You can force either the INSTALL.EXE program or the
  270.  
  271.                                         2                                       
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.                MAKEINST.EXE program to monochrome monitor mode by
  280.                invoking either program with the /B switch.
  281.  
  282.      Editing Keys
  283.  
  284.          When queried for input from INSTALL.EXE, MAKEINST.EXE, or
  285.          BLDSPLIT.EXE, a number of editing keys can be used to facilitate
  286.          input.  The following keys can be used:
  287.  
  288.          Home             Places cursor at beginning of line.
  289.  
  290.          End              Places cursor at end of line.
  291.  
  292.          Right-Arrow      Moves cursor one place to the right in field.
  293.  
  294.          Left-Arrow       Moves cursor one place to the left in field.
  295.  
  296.          Up-Arrow         Moves cursor to the previous field.
  297.  
  298.          Down-Arrow       Same function as <Enter> key.
  299.  
  300.          Insert           Toggles between insert mode and overstrike mode.
  301.  
  302.          Enter            Accepts input and moves cursor to next field or
  303.                           starts program action.
  304.  
  305.          Delete           Deletes character at cursor position.
  306.  
  307.      Creating a Title
  308.  
  309.      Product Name
  310.  
  311.          The Product Name you choose should accurately reflect your
  312.          software product.  It will be displayed at various places in
  313.          the generated installation routine depending upon which
  314.          options you selected at generation time.  You have 20
  315.          characters available for a Product Name.  Installation Pro's
  316.          default for this entry is 'Soft-Product'.
  317.  
  318.          If your product was 'Best Word Processor for DOS', you
  319.          might want to use just 'Best Word' as a product name for the
  320.          installation routine.  Installation Pro will use the correct
  321.          grammatical possessive s ('s) or simply an apostrophe if your
  322.          Product Name ends in the letter "s."
  323.  
  324.      Product Version
  325.  
  326.          This entry asks you to enter the version of the product for
  327.          which you want to generate the installation routine.  You
  328.          may enter any seven characters for your Product Version.  It
  329.  
  330.                                         3                                       
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.          may begin with a 'V' for Version, a 'T' for a Test version, or
  339.          any other letter or no letter at all.  You may even blank out
  340.          the entire entry for no version number at all.  Some example
  341.          entries are 'V1.2b', 'T0.91', 'X3.3ab', etc.
  342.  
  343.  
  344.      Installation Screen Title
  345.  
  346.          Installation Pro automatically creates a screen title for you
  347.          from the following responses:
  348.  
  349.          - Product Name
  350.  
  351.          - Product Version
  352.  
  353.          - Title Color
  354.  
  355.          When you answer the first two questions, Product Name and Product
  356.          Version, Installation Pro creates the following title that will
  357.          appear in your installation routine during the entire course of
  358.          the installation.  If your response to the Product Name question
  359.          was 'Installation Pro' and your response to the Product Version
  360.          question was 'V1.2a' then the following title would have been
  361.          created for you:
  362.  
  363.          "Installation Pro  V1.2a  Installation Program"
  364.  
  365.          The above title could then be edited to anything you would like
  366.          as a title.  Remember, that if you go back to a previous question,
  367.          i.e., the Product Name or the Product Version question, the
  368.          edited title will be replaced by the Installation Pro created
  369.          title and you will have to re-edit your custom title.
  370.  
  371.          The title color question comes after the title question and you
  372.          can use the F1 help key to view a color combination chart for the
  373.          available foreground and background colors.
  374.  
  375.          The title banner has been broken down into three lines and there
  376.          are 4 thirty-four character fields that can be used to display
  377.          any information about your company or any other information that
  378.          you choose.  The title banner will appear in one of the following
  379.          formats according to the information you entered:
  380.  
  381.   ┌────────────────────────────────────────────────────────────────────────┐
  382.   │╔══════════════════════════════════════════════════════════════════════╗│
  383.   │║                   The Centered and Bold White Title                  ║│
  384.   │╚══════════════════════════════════════════════════════════════════════╝│
  385.   └────────────────────────────────────────────────────────────────────────┘
  386.          No top or bottom information was entered.
  387.  
  388.  
  389.                                         4                                       
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.   ┌────────────────────────────────────────────────────────────────────────┐
  398.   │ Top Left Info                                           Top Right Info │
  399.   │                    The Centered and Bold White Title                   │
  400.   │ Bottom Left Info                                     Bottom Right Info │
  401.   └────────────────────────────────────────────────────────────────────────┘
  402.          Top and bottom information was entered.  It can be both left
  403.          and right but only right or left is required.
  404.  
  405.   ┌────────────────────────────────────────────────────────────────────────┐
  406.   │                    The Centered and Bold White Title                   │
  407.   │                                                                        │
  408.   │ Bottom Left Info                                     Bottom Right Info │
  409.   └────────────────────────────────────────────────────────────────────────┘
  410.          No top information was entered.  Bottom information was entered.
  411.  
  412.   ┌────────────────────────────────────────────────────────────────────────┐
  413.   │ Top Left Info                                           Top Right Info │
  414.   │                                                                        │
  415.   │                    The Centered and Bold White Title                   │
  416.   └────────────────────────────────────────────────────────────────────────┘
  417.          No bottom information was entered.  Top information was entered.
  418.          (Note:  The maximum title length is 70 characters.  The title
  419.                  will appear in a double-lined box in your choice of
  420.                  colors, shadowed on a dithered white background.)
  421.  
  422.          Your company name could also appear in the title.  The BMB
  423.          Software company name will not appear anywhere in the
  424.          installation routine but it is embedded in the .EXEs along
  425.          with your registered serial number.
  426.  
  427.      Selecting Screen Colors
  428.  
  429.      Title Color
  430.  
  431.          Enter the color combination you want for your installation
  432.          screen title.  To get help about the possible color combina-
  433.          tions entries, press function key F1 on your keyboard.  This
  434.          action will cause a color chart of the 127 possible color
  435.          combinations that are available to you, to be displayed on
  436.          your monitor.  Then, remember the number of the color
  437.          combination that you wanted and press any key on your
  438.          keyboard.  This will return you to the entry screen where
  439.          you may enter the number you selected.
  440.  
  441.          BMB Software has picked color combinations that are tasteful.
  442.          Moreover, these colors will also display on monochrome monitor
  443.          should Installation Pro fail to detect the monitor type.  There
  444.          are a few systems out there that do not completely comply with
  445.          the IBM video standards.  And, a few large computer companies
  446.          have made systems with monochrome CGA monitors and graphic cards.
  447.  
  448.                                         5                                       
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.          While some of the color combinations may be recognizable
  457.          on these systems, BMB Software has precluded this condition by
  458.          selecting black as the foreground color on colored backgrounds
  459.          or brightly colored foreground colors on dark backgrounds.
  460.          However, if you know what type of system your installation will
  461.          run on, then use any color combination you like.
  462.  
  463.          When Installation Pro detects a monochrome monitor, it will
  464.          display all of the screens in color combinations of 7 and 112.
  465.  
  466.      Menu Color
  467.  
  468.          Most of what applies for title color, applies for menu color
  469.          also.  The menu is the box that appears at the bottom of the
  470.          installation screen and allows the user to make choices
  471.          concerning the installation.
  472.  
  473.      Query Line Color
  474.  
  475.          The query line is a line that pops up and prompts the user
  476.          for input.  You can only select a color combination for the
  477.          input area of the question.  This selection is similar to the
  478.          previous two.
  479.  
  480.      The Installation Diskette Set
  481.  
  482.      Number of Diskettes
  483.  
  484.          This entry is a simple one.  You enter the number of dis-
  485.          kettes that your software product requires for installation.
  486.          Remember to leave about 100K of space on one of the
  487.          diskettes (preferably the first one) for the install program
  488.          plus space for any 'README.DOC' or such files if they are not
  489.          already on your volume set, either in ASCII or in a
  490.          self- extracting compressed archive file.  You may want to
  491.          leave this 'README.DOC' file in an ASCII format on your
  492.          installation set even if you are using a compressed format.
  493.          This will allow for a quick file update without having to
  494.          re-compress your archive.
  495.  
  496.      Insert Alert
  497.  
  498.          Answer 'Y' to the 'Insert Alert' question if you'd like a
  499.          couple of musical notes to play alerting the user to insert
  500.          another diskette into the drive.
  501.  
  502.      Volume IDs
  503.  
  504.          Selecting Volume ID checking is a good way to ensure that
  505.          the correct diskette is placed in the drive during installation
  506.  
  507.                                         6                                       
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.          of your software product.  Installation Pro will check the
  516.          Volume ID of the diskette before performing any copy
  517.          operations on it.  Volume IDs can consist of any character
  518.          that is valid under MS-DOS rules for Volume IDs.
  519.          Examples of Volume IDs are:
  520.  
  521.             IProV32-1
  522.             IProV32-2
  523.             BMBINST1
  524.             MYPROG2
  525.  
  526.          The volume label must also end with the number of the diskette
  527.          that it is on.  For example:  VOLUME-1 or NEWSOFT31
  528.  
  529.          Installation Pro will compare the Volume ID on the diskette by
  530.          converting all lower case letters to upper case and removing
  531.          leading, trailing, and embedded spaces on both the Volume ID
  532.          on the diskette and the Volume ID that you entered in response
  533.          to the MAKEINST.EXE program question(s).
  534.  
  535.          If there's a match, then the installation will continue.  If
  536.          there's a mismatch, then Installation Pro will ask the user to
  537.          insert the correct diskette and try again.  The user will also
  538.          have the option to quit the installation at that time.
  539.  
  540.          It is a good idea to put the phrasing "Disk m of n" (where m
  541.          is the disk number and n is the total number of diskettes in
  542.          the installation set) on each diskette in the installation set.
  543.          This will enable the user to easily find the correct diskette
  544.          to insert.  You may also want to identify the diskette that has
  545.          the INSTALL program on it.
  546.  
  547.      Checking Target System
  548.  
  549.      Viewing an Inro File
  550.  
  551.          There is an option to view an introduction file at the beginning
  552.          of the installation.  When this option is used, the volume
  553.          checking feature must also be used.  This option allows the user
  554.          to check for certain things before beginning the installation.
  555.          IPro will ask where this file resides.  It must reside on one
  556.          of the installation diskettes and preferably the first one.
  557.          The user has the option to quit the installation on the
  558.          following screen.
  559.  
  560.      Checking for Free Disk Space
  561.  
  562.          If you select this option, then Installation Pro will check the
  563.          amount of free space on the destination disk drive that the
  564.          user selects.  If that amount is less that what you specified,
  565.  
  566.                                         7                                       
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.          then the user will be informed and given the opportunity to
  575.          select another disk drive or quit the installation routine.
  576.  
  577.          The minimum free disk space allowed is 100,000 bytes.  The
  578.          maximum allowed is 32,000,000.  The value entered is in
  579.          bytes.  Remember, if you are using file compression for your
  580.          software product, that the amount of free space needed is for
  581.          the un-compressed files on the destination disk drive.  If you
  582.          are also copying the INSTALL program to the destination
  583.          disk drive, then don't forget to add its program size to the
  584.          total. If your software creates files when first started then
  585.          don't forget to allow for that too.  You may also want to
  586.          allow for temp files, etc.
  587.  
  588.      Checking Target System Base RAM
  589.  
  590.          If your software product requires a minimum amount of RAM
  591.          in the target system, then select this option.  The value
  592.          entered is in kilobytes.  The minimum value allowed is 128K
  593.          bytes of base RAM.  The maximum value is 16 megabytes of memory
  594.          or 16384K.  If you enter 8192 kilobytes for a system require-
  595.          ment, IPro will assume 1024 kilobytes (1M) is base and shadow
  596.          memory and the remaining 7 megs is extended memory.
  597.  
  598.          If Installation Pro finds less base RAM in the target system
  599.          than the amount you specified then the user will be informed
  600.          that more base RAM must be added to the system before the
  601.          user will be allowed to continue with the installation
  602.          procedure.  The exception follows:
  603.  
  604.      Continuing with Less RAM
  605.  
  606.          You may elect this option if you want your user to continue
  607.          the installation procedure when Installation Pro has detected
  608.          less RAM than you specified.  The user will be informed that
  609.          more RAM is needed to execute your software product but may
  610.          continue with the installation and add more RAM and a later time.
  611.  
  612.      Checking for DOS Versions
  613.  
  614.          If your software product executes with any version of DOS
  615.          then you may not need this option.  However, even if you
  616.          do not elect this option, Installation Pro will always check
  617.          that the target system has at least DOS version 2.00 as a
  618.          minimum because that is what Installation Pro requires for
  619.          its own execution.
  620.  
  621.      DOS Versions
  622.  
  623.          DOS version numbers are composed of a major version and
  624.  
  625.                                         8                                       
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.          a minor version separated by a period.  DOS version 3.3 has
  634.          a major version number of 3 and a minor version of 30.
  635.          The major version is a single digit while the minor version
  636.          is a double digit.
  637.  
  638.      CPU Type
  639.  
  640.          The target system's CPU (Central Processing Unit) can be
  641.          checked if your software product requires a CPU that is
  642.          greater than the Intel 8088 or 8086 CPU.  If your software
  643.          product will execute on the 8088 type (compatible) of CPU
  644.          then there is no need to check since this is the minimum for
  645.          any IBM PC or compatible.  If your software product
  646.          requires an 80286 or 80386+ type of CPU then you may
  647.          check the target system for that type of CPU.  If a lesser
  648.          CPU is detected than what you require, the user is informed
  649.          and the installation process is terminated.
  650.  
  651.      Math Co-Processor
  652.  
  653.          If your software product requires a math co-processor for its
  654.          execution then you may elect this option.  This option will
  655.          check the target system for the presence of a math co-
  656.          processor and will inform the user if one is required and
  657.          none was found.  The installation process will terminate
  658.          unless the following option is exercised:
  659.  
  660.      Continuing w/o a Math Co-Processor
  661.  
  662.          Select this option if want to allow your user to install your
  663.          software product, which requires a math co-processor, even
  664.          if they don't have the required hardware, namely a math co-
  665.          processor.  Installation Pro will inform the user that they will
  666.          be allowed to continue with the installation but must add a
  667.          math co-processor at a later time.  If this option is not
  668.          selected and you require a math co-processor then Installation
  669.          Pro will inform the user that a math coprocessor was not found
  670.          on the target system and will terminate the installation process.
  671.  
  672.      Monitor Type
  673.  
  674.          Select monitor checking if you wish to have Installation Pro
  675.          check for a minimum monitor type.  You can check for a CGA,
  676.          EGA, or VGA graphics as a requirement for your software.
  677.          If your software will run on anything, then there's no need to
  678.          check.  An 'Continue with a lesser monitor' option is available
  679.          to you.
  680.  
  681.      Default Source Drive
  682.  
  683.  
  684.                                         9                                       
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.          The default source drive is the diskette drive that will be the
  693.          Installation Pro default source drive for the installation of
  694.          your software product if Installation Pro is unable to find the
  695.          source drive on its own.  This drive should be drive A:.
  696.          However, the user will still have the option of changing the
  697.          source drive at installation time.
  698.  
  699.      Default Destination Drive
  700.  
  701.          The default destination drive is the drive on which you want
  702.          your software product installed.  Normally, this will be the
  703.          C: drive on the target system.  This is also the drive that
  704.          Installation Pro expects to find the AUTOEXEC.BAT and
  705.          CONFIG.SYS system files.
  706.  
  707.      Creating Directories
  708.  
  709.          There are three possible answers to the Create Directories
  710.          question.  They are 'N', 'Y', and 'Z'.
  711.  
  712.          The 'N' answer stands for 'No' and you will not be asked for
  713.          the number of directories to be created nor their names.
  714.  
  715.          The 'Y' and 'Z' answers stand for 'Yes' answers and you will
  716.          be asked for the number of directories to create and their
  717.          names.
  718.  
  719.          However, the 'Z' response will also ask you for the directory
  720.          file extension name while the 'Y' answer will not.  In other
  721.          words, if you want to create directories with file extensions
  722.          then answer 'Z'.  The de facto standard for DOS directories
  723.          is to create them without extensions, but you may create
  724.          them with extensions if you like.
  725.  
  726.      Directory Creation Messages
  727.  
  728.          If you answered 'Y' or 'Z' to the create directories question,
  729.          then IPro asks if you want messages to inform the user that
  730.          one or more directories alread exists and what the user can
  731.          do to prevent from overwriting existing files.  If you know
  732.          you are updating files and the directory will most likely
  733.          exist, then you can answer 'N' the this question.
  734.  
  735.          Creating directories with Installation Pro is very easy once
  736.          you understand the mechanism.  A total of fourteen
  737.          directories/subdirectories can be created by the installation
  738.          routine on the target disk drive.  Fourteen directories right
  739.          off the root directory can be created or one directory off
  740.          the root and thirteen levels of subdirectories off of the
  741.          first.  Any combination of the previous two scenarios is possible.
  742.  
  743.                                        10                                       
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.          A directory that will be created right off the root must begin
  753.          with a '\' (backslash) character.  This tells the installation
  754.          routine to create a directory right from the target drive's root.
  755.          Next, to create a subdirectory off the previously created
  756.          directory, you simply enter its name.  To create another
  757.          directory at the same level, you enter its name preceded by a
  758.          '+' (plus sign).  This tells the installation routine to create
  759.          another directory at the same level as the previous one.
  760.          Here are a couple of examples:
  761.  
  762.          Let us say you want to create a directory off the root
  763.          directory called 'MYPROGS'.  You also want to create two
  764.          directories off of that one at equal levels called 'MYDATA'
  765.          and 'MYTEXT'.  The graphical tree would look as follows:
  766.  
  767.             ROOT
  768.              C:
  769.               \
  770.               |
  771.               +--MYPROGS--+
  772.                           |
  773.                           +---MYDATA
  774.                           |
  775.                           +---MYTEXT
  776.  
  777.          The entries required to create the previous illustration are as
  778.          follows:
  779.  
  780.               \MYPROGS
  781.               MYDATA
  782.               +MYTEXT
  783.  
  784.          Note:  The first entry is also known to Installation Pro as
  785.                 the primary directory.
  786.  
  787.          Let us say you have entered the following 9 entries to create
  788.          directories:
  789.  
  790.               \PROGS
  791.               DATA1
  792.               +DATA2
  793.               +DATA3
  794.               TEXT
  795.               \PROGS2
  796.               LIB
  797.               +BIN
  798.               SRC
  799.  
  800.          The resulting directory tree created from the previous 9
  801.  
  802.                                        11                                       
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.          directory entries would look like this:
  811.  
  812.             ROOT
  813.              C:
  814.               \
  815.               |
  816.               +---PROGS---+
  817.               |           |
  818.               |           +---DATA1
  819.               |           |
  820.               |           +---DATA2
  821.               |           |
  822.               |           +---DATA3---+
  823.               |                       |
  824.               |                       +---TEXT
  825.               +---PROGS2--+
  826.                           |
  827.                           +----LIB
  828.                           |
  829.                           +----BIN----+
  830.                                       |
  831.                                       +----SRC
  832.  
  833.          You cannot go back one level without going all the way to
  834.          the root directory.
  835.  
  836.          This should not pose a problem in most cases.  If you
  837.          wanted to create the TEXT directory off of DATA1 instead
  838.          of DATA3, just create DATA2 and DATA3 first and then
  839.          create DATA1 and then TEXT.
  840.  
  841.      Copying Files
  842.  
  843.          Copying files requires three parameters as follows:
  844.  
  845.               source file(s)
  846.               destination
  847.               copy code (Abbreviated 'CpC' on entry screen.)
  848.  
  849.          A Copy Operation consists of one of each of the above.
  850.          Each diskette in the installation set of diskettes can contain
  851.          up to three of the above Copy Operations.
  852.  
  853.      Source Files
  854.  
  855.          Source files are the files that will be copied.  They are your
  856.          software product's files.
  857.  
  858.          The source parameter is a file specification consisting of 21
  859.          characters.  It may contain wildcards and subdirectories.
  860.  
  861.                                        12                                       
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.          Valid examples are:
  870.  
  871.          *.*
  872.          MY*.EXE
  873.          *.COM
  874.          MY*.*
  875.          SUBDIR\*.*
  876.          DATA\*.DAT
  877.          MATH\*.EXE
  878.          ONLYTHIS.FIL
  879.  
  880.          The source file specification should never begin with a
  881.          backslash character.  In fact, Installation Pro will not let
  882.          you put one in because it will put one in at installation time.
  883.          However, if you have a subdirectory on your installation
  884.          diskette, you may start the source file specification with a
  885.          directory name followed by a backslash and then the name of
  886.          your file.  For example:
  887.  
  888.          SUBDIR\*.DAT
  889.  
  890.          INSTALL would add the source drive and a backslash to it making
  891.          it look like the following file specification:
  892.  
  893.          A:\SUBDIR\*.DAT
  894.  
  895.      Destination
  896.  
  897.          The destination parameter for your files consists of one or
  898.          more directories/subdirectories only.  Do not enter drive
  899.          letters, filenames, or wildcard characters.  The destination
  900.          should match the first directory you created, that way any
  901.          change that the user makes at installation time will be
  902.          reflected in the destination by Installation Pro.
  903.  
  904.          Let us say, for example, the primary directory that you
  905.          wanted to create was '\MYDIR' and this was also your
  906.          destination specification, and then the user changed the
  907.          default destination drive (C:) to D: and the primary des-
  908.          tination to '\USER'.  INSTALL would then copy your files
  909.          to 'D:\USER' and this change would also be reflected in the
  910.          changes to the AUTOEXEC.BAT and CONFIG.SYS files if
  911.          those options were exercised.
  912.  
  913.          Note:  INSTALL will only make changes to the AUTOEXEC.BAT
  914.                 and CONFIG.SYS system files if the primary directory
  915.                 was utilized in those files and only if those changes
  916.                 do not already exist in the user's system files.
  917.  
  918.          If you have a destination of \MYDIR\SUB1, you can only use
  919.  
  920.                                        13                                       
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.          the X and the E copy codes if \MYDIR is your primary directory.
  929.  
  930.      Copy Codes
  931.  
  932.          Copy codes (abbreviated CpC on the input screen) control
  933.          the file copying operation during installation.  The codes are
  934.          always active even when their corresponding options are not
  935.          selected.  For example, let us say, you chose to check for a
  936.          math co-processor in the target system and one was not
  937.          detected, and you allowed the user to continue the
  938.          installation without one, then if you had a copy code of 7 for
  939.          a copy operation, the files would not be copied.
  940.  
  941.          | Omitted-\
  942.          | Omitted---> Replaced with bargraphs.
  943.          | Omitted-/
  944.  
  945.          The following table tells you what the valid copy codes are
  946.          and what their function is:
  947.  
  948.          - C     Copies files.  Wildcards allowed.
  949.          - X     Does not copy a file but executes it on the source
  950.                  drive.  The file is executed from the destination's
  951.                  primary directory or a subdirectory that is off the
  952.                  primary directory, so if the executable file generates
  953.                  output to a default directory, then the output goes
  954.                  here.  Generally, this is the code to use for executing
  955.                  self-extracting archives files.  No wildcards allowed.
  956.          - E     Copies a file and executes it in the primary destination
  957.                  directory/subdirectory on the destination drive.  Use
  958.                  to copy a self-extracting archive file and then
  959.                  executing it from where it's been copied.  This will
  960.                  leave the file at the destination.  No wildcards allowed.
  961.          - 3     Copies files only if an 80386 or an 80486 is detected
  962.                  on the target system.  Wildcards allowed.
  963.          - 5     Copies files only if an 80286 or greater CPU is detected
  964.                  on the target system.  Wildcards allowed.
  965.          - 7     Copies files only if a math coprocessor is detected in
  966.                  the target system.  Wildcards allowed.
  967.          - F     Marks the first part of a multi-part self-extracting
  968.                  archive file.  Always changes the file extension to .EXE.
  969.          - G     Similar to copy code 'F' but retains the file name
  970.                  extension that it found for this file part.
  971.          - I     Marks an intermediate part of a multi-part self-extracting
  972.                  archive file.
  973.          - L     Marks the last part of a multi-part self-extracting
  974.                  archive file.  This will also cause the file to execute.
  975.                  The file will be deleted after execution.
  976.          - M     Similar to copy code 'L' in that it marks the last part
  977.                  of a multi-part file.  However, the file will not execute
  978.  
  979.                                        14                                       
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                  and will not be deleted afterwards.
  988.  
  989.          The above copy codes are the only valid codes for
  990.          copy operations.  Installation Pro will not accept any other
  991.          characters.
  992.  
  993.          When using copy code 'F' to mark the first part of a multi-
  994.          part file, you should mark the last part of the file with the 'L'
  995.          copy code.  This 'F' code will rename the file with an .EXE
  996.          extension.  The 'L' code will close the file after the last part
  997.          has been appended, execute it, and then delete it.  You can
  998.          see that this pair of codes was meant to be used with self-
  999.          extracting archive type of files.
  1000.  
  1001.          Similarly, the 'G' copy code should be paired with the 'M'
  1002.          copy code.  The file will retain the name that was marked
  1003.          with the 'G' code, and the 'M' code will append the last part
  1004.          to the file and close it.  No file execution or deletion will
  1005.          occur.  This pair of codes could be used for a large database
  1006.          that you do not want to compress or can't compress.
  1007.  
  1008.          Installation Pro will prompt you for the source, destination,
  1009.          and the copy code for each copy operation for each diskette
  1010.          in the installation set.  You may have nine copy operations
  1011.          per diskette and up to nine diskettes.  This gives you a total
  1012.          of 81 copy operations per installation diskette set.  You
  1013.          could also use the Installation Pro's file execution feature at
  1014.          the end of your installation to execute another program
  1015.          which could be another installation program (possibly named
  1016.          INSTALL2.EXE) which could install another nine diskettes,
  1017.          etc.  Again, using Volume IDs could ensure that the correct
  1018.          diskette has been inserted in the source drive when many
  1019.          diskettes are involved.
  1020.  
  1021.          When all copy operations have been entered and you are
  1022.          satisfied that they are correct, answer "Y" (Yes) to the
  1023.          question:
  1024.  
  1025.          "Are ALL copy operations complete?"
  1026.  
  1027.          This will take you to the next input screen.  Answering "N"
  1028.          (No) will take you back to the first copy operation for
  1029.          diskette number 1.
  1030.  
  1031.      Scrolling Region
  1032.  
  1033.          During the installation process, the screen may rearrange
  1034.          itself because of the possibility of scrolling.  When this
  1035.          happens, the title portion of the screen repositions itself at
  1036.          the bottom of the screen below a line of up-arrows.  This
  1037.  
  1038.                                        15                                       
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.          action keeps the installation screen title on the screen at all
  1047.          times.  The copy codes that can make this happen are 'E',
  1048.          'X', and 'L'.
  1049.  
  1050.      File Viewing
  1051.  
  1052.          If you elect this option, you will be asked for the name of
  1053.          the file and where it is located.  This file will automatically
  1054.          pop up in a scrollable window during the installation process
  1055.          for the user's viewing after all copy operations have been
  1056.          performed.
  1057.  
  1058.          This unique feature of Installation Pro has a variety of uses.
  1059.          It can be used to:
  1060.  
  1061.          - Convey the latest features of your software.
  1062.          - Alert the user about errors or omissions in the documentation.
  1063.          - Inform the user of subtle bugs for this release.
  1064.          - Advertise.
  1065.          - Remind the user to fill out his/her registration cards, etc.
  1066.          - All of the above.
  1067.  
  1068.          The use of this feature can reduce the number of support calls
  1069.          from users who fail to read the installation documentation.
  1070.  
  1071.          The file is limited to plain ASCII text and can be up to
  1072.          15,000 lines long.  Each line of text can be up to 78 characters
  1073.          in length.  You may want to space indent each line to provide
  1074.          some white space for ease in viewing.
  1075.  
  1076.      Name of Viewing File
  1077.  
  1078.          The file specification for the name of the file to view con-
  1079.          sists of a directory and the file name and file extension.  In
  1080.          most cases, you do not need to have a directory name before
  1081.          the file name.  If you include a directory name, then it must
  1082.          not begin with a "\" (backslash) character.
  1083.  
  1084.          If your viewing file will be viewed from a diskette, then the
  1085.          file must reside in the root directory of the diskette unless it
  1086.          is preceded by a subdirectory name.  In that case, there must
  1087.          be a corresponding directory on the diskette which holds the
  1088.          viewing file.
  1089.  
  1090.          Here's an example:
  1091.  
  1092.          README.DOC
  1093.          SUB\READ.ME
  1094.  
  1095.          If your source drive is A:, then Installation Pro will compose
  1096.  
  1097.                                        16                                       
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.          the above file specifications to:
  1106.  
  1107.          A:\README.DOC
  1108.          A:\SUB\READ.ME
  1109.  
  1110.          If the viewing file will be copied to the destination drive
  1111.          during installation, then the file must be in the main directory
  1112.          that was created by Installation Pro.  And again, if the viewing
  1113.          file specification contains a directory, it must be only one
  1114.          level down from the main directory.  Some examples are:
  1115.  
  1116.          README.DOC
  1117.          TEXT\READ.ME
  1118.  
  1119.          If the destination drive was C:, and the main directory was
  1120.          NEWDIR then Installation Pro will compose the file specification
  1121.          to:
  1122.  
  1123.          C:\NEWDIR\README.DOC
  1124.          C:\NEWDIR\TEXT\READ.ME
  1125.  
  1126.          It will be quicker to view a file that is on a hard disk than
  1127.          one that is on a diskette.  If the file is copied to the
  1128.          destination drive and directory for viewing it will also remain
  1129.          there afterwards and the user may TYPE or PRINT it after
  1130.          installation.
  1131.  
  1132.      Viewing Disk Number
  1133.  
  1134.          If you're going to have the user view a file from one of the
  1135.          installation diskettes, then just enter the number of the
  1136.          diskette where it can be found.  If it's on the last disk,
  1137.          Installation Pro will read it after all the copy operations are
  1138.          finished.  If the viewing file will be copied to the desti-
  1139.          nation, then enter zero and Installation Pro will look for it on
  1140.          the destination drive:\directory.
  1141.  
  1142.      Executing Another Program
  1143.  
  1144.          When Installation Pro is finished installing your software
  1145.          product, you have the option to either execute another
  1146.          program or give the user the option to re-boot the target
  1147.          system.  Obviously, you can't do both; at least not easily.
  1148.  
  1149.      File Execution
  1150.  
  1151.          If you select this option, then you will not be able to give
  1152.          the user the re-boot option for the target system.  Instead,
  1153.          you will be asked for the name of the file that you want
  1154.          executed.  The file can be a .COM, .EXE, or .BAT file.  IPro
  1155.  
  1156.                                        17                                       
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.          will not check to see if the file exists first, so anything
  1165.          can be put in the file specification, such as switches and/or
  1166.          placeholders.
  1167.  
  1168.      Execution Disk Number
  1169.  
  1170.          The rules for the location of the program that will be
  1171.          executed are the same as the ones for File Viewing.  See
  1172.          that topic for more information.
  1173.  
  1174.      Re-Booting Target System
  1175.  
  1176.          If you did not elect File Execution, then you have the option
  1177.          of giving your user the ability to re-boot the target system at
  1178.          the end of the installation process.  Giving the user this
  1179.          option will place an additional choice in the menu allowing
  1180.          the user to WARM RE-BOOT the target system by selecting
  1181.          it from the menu.  The menu's default choice will be to
  1182.          "Quit" the installation.  No matter what choice the user
  1183.          makes, a message will be displayed at the end stating
  1184.          whether the installation was successful or not.
  1185.  
  1186.      Security/Other Function
  1187.  
  1188.          This option can be used for a variety of reasons.  If you
  1189.          need to execute copy protection software, file de-
  1190.          compression software, or other program necessary for
  1191.          installation of your software product, then this is the option
  1192.          you want to exercise.
  1193.  
  1194.          If you answer "Y" to the question about executing an
  1195.          other/security program then you will be asked three addi-
  1196.          tional questions.  Answering "N" will skip the next three
  1197.          questions.  The word "security" will be used for simplicity
  1198.          throughout this chapter but can mean file de-compression,
  1199.          etc.
  1200.  
  1201.      Security Command Line
  1202.  
  1203.          You have 40 characters that you can enter for your com-
  1204.          mand line for execution of your required program.  The
  1205.          following placeholders are valid for program command line
  1206.          parameters:
  1207.  
  1208.          Placeholder     Parameter
  1209.          -----------     -----------
  1210.          %S              Is replaced by the source drive that the
  1211.                          user selected for the installation.
  1212.  
  1213.          %D              Is replaced by the destination drive that
  1214.  
  1215.                                        18                                       
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.                          the user selected for the installation.
  1224.  
  1225.          %P              Is replaced by the destination path, that is,
  1226.                          the \directory that the user selected as their
  1227.                          primary path for installation.
  1228.  
  1229.          %B              Is replaced at installation time with the
  1230.                          default boot drive letter that you entered
  1231.                          at installation generation time.
  1232.  
  1233.          %Q              Is replaced by the directory name number two
  1234.                          if you entered one at installation generation
  1235.                          time.
  1236.  
  1237.          As an example, we will use the following sample command line to
  1238.          execute a copy protection program:
  1239.  
  1240.          EVMOVE  %S  %D  /Z
  1241.  
  1242.          Installation Pro would translate (replace the placeholders with
  1243.          actual program values) this line to look like this:
  1244.  
  1245.          EVMOVE  A:  C:  /Z
  1246.  
  1247.          if A: was what the user selected as his/her source drive, and C:
  1248.          was the user's designated destination drive.  Adding %P just
  1249.          before the %D in the sample line above would yield:
  1250.  
  1251.          EVMOVE  A:  C:\MYDIR  /Z
  1252.  
  1253.          again if C:\MYDIR was the user selected drive:\directory path.
  1254.  
  1255.      Security Drive
  1256.  
  1257.          This is the diskette number that your security/other program
  1258.          resides on.  Of course, if it has been copied to a hard drive,
  1259.          then the security diskette number would be zero (0).
  1260.          Installation Pro will prompt the user to insert the correct
  1261.          diskette to execute the program.  Installation Pro will always
  1262.          append the source drive and a backslash to the beginning of the
  1263.          command line if the security/other program is on a diskette.
  1264.          If the source drive was B: our sample command line would end up
  1265.          looking like this:
  1266.  
  1267.          B:\EVMOVE  A:  C:\MYDIR  /Z
  1268.  
  1269.          Nothing else on the line will change except the placeholders.
  1270.  
  1271.      Before or After
  1272.  
  1273.  
  1274.                                        19                                       
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.          This tells Installation Pro when to execute the security/other
  1283.          program.  'Before' means to execute the program before the
  1284.          copying of the files.  'After' means to execute it right after
  1285.          the file copying operation(s).
  1286.  
  1287.      Check ICA
  1288.  
  1289.          In the Security/Other Function area, you can check the ICA.
  1290.          Any one of the ICA's (Intra-application Communications Area)
  1291.          16 bytes can be checked for any value.  This allows Installation
  1292.          Pro to know if the Security/Other function executed successfully.
  1293.          You can also put in your own custom error message (40 characters)
  1294.          or leave it blank and Installation Pro will put one in for you.
  1295.  
  1296.      Modifying System Files
  1297.  
  1298.          The term 'System Files' in this section refer to the
  1299.          AUTOEXEC.BAT and the CONFIG.SYS files.
  1300.  
  1301.          If you choose to modify either of the system files, and one or
  1302.          both files does not exist, Installation Pro will create them
  1303.          for you on the default destination drive that you specified as
  1304.          the default destination drive.  The user cannot change this
  1305.          drive during installation.
  1306.  
  1307.          In most cases, drive 'C:' will be what you want.  However, if
  1308.          you are distributing software to known system configurations,
  1309.          you may want to change this drive letter to something other
  1310.          than 'C:'.
  1311.  
  1312.          Note:  The user will always have the final option of whether
  1313.                 to let the changes to their system files take place.
  1314.                 If the user elects not to have Installation Pro make the
  1315.                 changes to the system files, Installation Pro will leave
  1316.                 the changes in files named AUTOEXEC.BTA and CONFIG.SSY
  1317.                 in the primary installation directory.
  1318.  
  1319.      Modifying AUTOEXEC.BAT
  1320.  
  1321.          If you choose this option then you will be allowed to make up
  1322.          to 5 modifications to the AUTOEXEC.BAT file.  Those are options
  1323.          are:
  1324.  
  1325.               Primary path
  1326.               Secondary path
  1327.               Additional line 1
  1328.               Additional line 2
  1329.               Additional line 3
  1330.  
  1331.      Primary Path
  1332.  
  1333.                                        20                                       
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.          Installation Pro will add the primary path to the path in
  1343.          the user's AUTOEXEC.BAT file.
  1344.  
  1345.          Installation Pro will not add this primary path to the user's
  1346.          current path statement if it finds that it is already there.
  1347.          If the path is longer than 70 characters, Installation Pro will
  1348.          create an additional path statement appending the original to
  1349.          the newly created one.
  1350.  
  1351.          The path that you enter should correspond to the primary
  1352.          directory that you created in the Create Directories section.
  1353.          When they correspond, any change that the user makes during
  1354.          installation will be reflected in this path also.  If they do
  1355.          not correspond, Installation Pro will not change this path to
  1356.          reflect a change that the user might have made during the
  1357.          installation process.  This may give you a file path that is
  1358.          invalid, since it may not exist.
  1359.  
  1360.          If you want to leave the path statement in the user's
  1361.          AUTOEXEC.BAT file alone, then enter a zero (0) as the primary
  1362.          path.
  1363.  
  1364.      Secondary Path
  1365.  
  1366.          The secondary path is similar to the first.
  1367.  
  1368.          It contains the primary path in addition to a secondary
  1369.          directory.  This secondary directory should be one of the
  1370.          directories that you created for your installation.  This
  1371.          secondary path can change if the user elects to change the
  1372.          destination directory where your product is installed.
  1373.          However, since the user can only change the primary directory,
  1374.          only that part of the secondary path will change.  Here's an
  1375.          example:
  1376.  
  1377.          You chose the default destination drive as drive C: and to
  1378.          create two directories for your software product as follows:
  1379.  
  1380.          \NEWDIR
  1381.          DATA
  1382.  
  1383.          During an installation in which the user accepts all the
  1384.          defaults that you specified, the paths added to the user's
  1385.          AUTOEXEC.BAT file will be:
  1386.  
  1387.          C:\NEWDIR
  1388.          C:\NEWDIR\DATA
  1389.  
  1390.          Now suppose the user changes the default destination drive
  1391.  
  1392.                                        21                                       
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.          from C: to D:, and changes the primary directory from \NEWDIR
  1401.          to \MYDIR, then the following paths would be added:
  1402.  
  1403.          D:\MYDIR
  1404.          D:\MYDIR\DATA
  1405.  
  1406.          As you can see from the previous examples, your software
  1407.          would still be able to create files in your DATA subdirectory
  1408.          even though the primary directory was changed.  Remember, the
  1409.          user is only allowed to change the primary directory.
  1410.  
  1411.      Adding AUTOEXEC.BAT Lines
  1412.  
  1413.          Whether you've elected to add paths to the user's system files
  1414.          or not, Installation Pro will allow you to add three additional
  1415.          lines to the system files.  These can be lines that start
  1416.          TSRs, do some type of file maintenance, or any other task that
  1417.          should be done at start up time.  These lines will be added to
  1418.          the tail end of the AUTOEXEC.BAT file.  Installation Pro will
  1419.          check to see if these lines already exist in the AUTOEXEC.BAT
  1420.          file before trying to insert them a second time.
  1421.  
  1422.      Modifying CONFIG.SYS
  1423.  
  1424.          Installation Pro will modify your user's CONFIG.SYS system
  1425.          file if you want it to.  Installation Pro can do a variety
  1426.          of things to the CONFIG.SYS file.
  1427.  
  1428.      CONFIG.SYS FILES Option
  1429.  
  1430.          If you do not want Installation Pro to touch the value of the
  1431.          FILES variable in the user's CONFIG.SYS file, then enter a
  1432.          zero for the value of FILES.  If you want to check that the
  1433.          FILES value is at least a certain value that you specify, then
  1434.          enter that value in response to the FILES question.
  1435.  
  1436.          Installation Pro will never reduce the user's FILES value to
  1437.          a lesser one.  However, it will increase it to a value that
  1438.          you specified if that value is greater than the user's.
  1439.  
  1440.          The maximum value allowed is DOS's maximum value of 255.
  1441.  
  1442.      CONFIG.SYS BUFFERS Option
  1443.  
  1444.          Installation Pro can do the same thing to the value of the
  1445.          user's BUFFER variable in CONFIG.SYS as it was able to do to
  1446.          the FILES variable above.  The rules are similar.
  1447.  
  1448.          The maximum value allowed is DOS's maximum value of 99.
  1449.  
  1450.  
  1451.                                        22                                       
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.      Adding CONFIG.SYS Lines
  1460.  
  1461.          Adding lines to the CONFIG.SYS system file is as easy as it is
  1462.          for adding lines to the AUTOEXEC.BAT system file.  You can add
  1463.          up to three lines.  These lines will be added to the tail end
  1464.          of the user's CONFIG.SYS file.  These lines can be used to
  1465.          install drivers that your software product may require for
  1466.          operation.
  1467.  
  1468.      Custom BATCH
  1469.  
  1470.          Answering 'Y' to creating a custom batch file will proceed
  1471.          by asking you a series of questions about the following:
  1472.  
  1473.               Time
  1474.               Where
  1475.  
  1476.          The 'Time' question is for how many seconds to display an
  1477.          informational message to the user.  That message informs the
  1478.          user what is being created and where it is being placed.
  1479.  
  1480.          The 'Where' question asks if you want the batch file placed
  1481.          in the root directory of the boot drive or in the primary
  1482.          directory that was created.
  1483.  
  1484.          The questions that follow these two batch file questions
  1485.          will actually compose the batch file.  One hundred and sixty
  1486.          five characters are allowed.  Placeholders can be included
  1487.          in the file, giving an actual file output greater than the
  1488.          one hundred sixty five characters.
  1489.  
  1490.      Directing the Output File (for the INSTALL.EXE program)
  1491.  
  1492.          When you've finished answering all the questions for your
  1493.          software product that Installation Pro requires, Installation
  1494.          Pro will write an output file named INSTALL.EXE.
  1495.  
  1496.          If file named INSTALL.EXE already exist in your default
  1497.          directory, then Installation Pro will ask you if you wish to
  1498.          overwrite this file.  If you answer "Y", then Installation Pro
  1499.          will write the new one over the old one, destroying it in the
  1500.          process.  If you answer "N" to the overwrite question,
  1501.          Installation Pro will prompt you for a file specification.
  1502.  
  1503.      Output File Spec.
  1504.  
  1505.          The output file specification that you enter can be solely a
  1506.          file name or can include a drive and directory.  You may want
  1507.          to keep all your INSTALL.EXE programs in the same directory
  1508.          and code them by product and disk size.  Some examples:
  1509.  
  1510.                                        23                                       
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.          IPRO13.5   Installation Pro V1.3 for 5¼ diskette
  1520.          IPRO13.3   Installation Pro V1.3 for 3½ diskette
  1521.  
  1522.          You could later rename these files to INSTALL.EXE when you copy
  1523.          them to diskettes.  In this way, the files are always available
  1524.          for reading, saving you the time of reconstructing the entire
  1525.          installation process from scratch when only a very small change
  1526.          is required.
  1527.  
  1528.      Terminating
  1529.  
  1530.          When Installation Pro has finished writing its output file,
  1531.          INSTALL.EXE, it will display a message on the screen that
  1532.          INSTALL.EXE or, if you renamed the output file, then that name,
  1533.          has been successfully created.  The output file is then ready
  1534.          to be placed on a diskette to install your software product.
  1535.  
  1536.          If you keep an INSTALL.EXE file in the directory where you are
  1537.          generating installation routines, MAKEINST.EXE will always ask
  1538.          you if you want to overwrite INSTALL.EXE.  Then if you choose
  1539.          not to overwrite it, MAKEINST.EXE will ask you for a file
  1540.          specification.  This file specification could even be
  1541.          A:\INSTALL.EXE.
  1542.  
  1543.      =================================================================
  1544.      The INSTALL Program
  1545.  
  1546.          The INSTALL Program (full name is INSTALL.EXE) is that program
  1547.          which is generated by Installation Pro.  The MAKEINST.EXE
  1548.          program is that part of Installation Pro which generates
  1549.          INSTALL.  The INSTALL Program does more than just check the
  1550.          target system hardware and install your software product.
  1551.  
  1552.          INSTALL introduces your product in grammatically correct
  1553.          language.  It helps the user along with informational messages,
  1554.          and checks all user input.  INSTALL will not allow the user to
  1555.          err.
  1556.  
  1557.          INSTALL is invoked by typing its name.  The following command
  1558.          line switches are valid when invoking INSTALL:
  1559.  
  1560.               Switch     Purpose
  1561.               ------     -------
  1562.               /D         Starting INSTALL with a /D switch will prevent
  1563.                          install from finding the disk drive that INSTALL
  1564.                          was started from and instead will use the drive
  1565.                          letter that you specified during installation
  1566.                          generation time as the default source drive.
  1567.                          This letter can still be changed by the user.
  1568.  
  1569.                                        24                                       
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                          Useful for CD-ROM installations or if the
  1578.                          INSTALL program resides on a different drive
  1579.                          than the application files.
  1580.               /B         Starting INSTALL with a /B switch will force
  1581.                          INSTALL to use monochrome colors.
  1582.  
  1583.          During the entire installation process, the title that you
  1584.          created at installation generation (IG) time, will be displayed
  1585.          on the user's screen.
  1586.  
  1587.          We will step through the installation screens one at a time and
  1588.          see what is actually happening behind the scenes.
  1589.  
  1590.          Events that occurred during the installation generation phase,
  1591.          i.e., during the time that you were answering the questions
  1592.          from the MAKEINST.EXE program, shall be herein known as IG time.
  1593.  
  1594.      The Introductory Screen
  1595.  
  1596.          The first screen the user will see is the introductory screen.
  1597.          This screen will inform the user about what is to come.  The
  1598.          screen title, the one which you created during the generation
  1599.          phase, displays at the top of this screen.
  1600.  
  1601.          The first line after the title area will read "INSTALL prepares
  1602.          Soft-product to run from your hard disk by:"  If you renamed
  1603.          the generated INSTALL.EXE program to INSTALLH.EXE then the first
  1604.          line after the title area will begin with INSTALLH instead of
  1605.          INSTALL.  The INSTALL program will find its own executable name
  1606.          and use it in the top line.
  1607.  
  1608.          The Product Name that you entered for your software product will
  1609.          appear in the top line where Soft-product appeared.
  1610.  
  1611.          Following the top line, are bulleted items that may display on
  1612.          the screen depending on your choices of options at IG time.
  1613.  
  1614.          The first bulleted item is:
  1615.  
  1616.               Installing Soft-product's files.
  1617.  
  1618.          Again, the name you selected for your software product at IG
  1619.          time is the name that will display in this bulleted item.  Let
  1620.          us say you chose 'Big Business' for your software product's
  1621.          name, then the first bulleted item would look like the following:
  1622.  
  1623.               Installing Big Business' files.
  1624.  
  1625.          Installation Pro will display grammatically correct possessives.
  1626.  
  1627.  
  1628.                                        25                                       
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.          If you chose to create directories at IG time, then the next
  1637.          bulleted item will display as follows:
  1638.  
  1639.               Creating a directory on your destination disk.
  1640.  
  1641.                    or
  1642.  
  1643.               Creating directories on your destination disk.
  1644.  
  1645.          Depending on the number of directories you chose to create, one
  1646.          of the above bulleted items will display on the user's screen.
  1647.  
  1648.          The next two bulleted items will display on the user's screen
  1649.          based upon which system files you chose to modify/create at IG
  1650.          time.  If you chose to modify/create the AUTOEXEC.BAT file and
  1651.          the CONFIG.SYS file then two bulleted items will display on the
  1652.          user's screen as follows:
  1653.  
  1654.          Creating and/or modifying your AUTOEXEC.BAT file. (optional)
  1655.          Creating and/or modifying your CONFIG.SYS file. (optional)
  1656.  
  1657.          The last bulleted item to appear will be:
  1658.  
  1659.               Displaying the latest release notes.
  1660.  
  1661.          Of course, it will only display if you chose the file viewing
  1662.          option at IG time.
  1663.  
  1664.          INSTALL will then tell the user that he/she will be given step-
  1665.          by-step instructions.  Following this line, a menu will appear
  1666.          with the only choices that the user can make.  For this screen
  1667.          it will be either 'Continue' or 'Quit.'
  1668.  
  1669.          To make that choice, the user must either press the corresponding
  1670.          letter of his/her choice, in this case, a 'P' or a 'Q' (case
  1671.          makes no difference) or, highlight his/her choice on the menu
  1672.          with the arrow keys and pressing the <Enter> key.  If the user
  1673.          selects to 'Continue' then he/she will move to the next screen.
  1674.          If the user selects to 'Quit', then the screen area below the
  1675.          title area will be cleared and message will appear stating that
  1676.          'Soft-product' has NOT been installed.  The user will return to
  1677.          the operating system.
  1678.  
  1679.      The NEEDS Screen
  1680.  
  1681.          This screen deals with the minimum requirements necessary to
  1682.          properly install your software product.
  1683.  
  1684.          The first line after the title area on this screen is as follows:
  1685.  
  1686.  
  1687.                                        26                                       
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.          To install Soft-Product on your hard disk, you will need:
  1696.  
  1697.          Again, the name you chose for your software product at IG time
  1698.          will display in this line.
  1699.  
  1700.          Next, the first bulleted line of this screen will always tell the
  1701.          user how many diskettes are in the installation volume set by
  1702.          displaying:
  1703.  
  1704.               The Soft-Product installation diskette. (1)
  1705.  
  1706.                    or
  1707.  
  1708.               The Soft-Product installation diskettes. (2)
  1709.  
  1710.          Either one of the lines above will be displayed depending on the
  1711.          number of diskettes in the installation volume set.  The number
  1712.          of diskettes in the volume set will appear at the right of the
  1713.          line enclosed in parentheses.
  1714.  
  1715.          If you specified an amount of RAM to check for, then the
  1716.          next bulleted line may look like:
  1717.  
  1718.               512K of memory or more.
  1719.  
  1720.                    or
  1721.  
  1722.               640K of memory.
  1723.  
  1724.          If you are checking for less than 640K of memory, then
  1725.          Installation Pro will say that it will check that the user's
  1726.          system has nnnK of memory or more.  However, if you are checking
  1727.          for 640K of memory, then Installation Pro will not say 'or
  1728.          more' since 640K is the maximum memory that DOS will look
  1729.          at.
  1730.  
  1731.          Another bulleted item will appear if you selected the checking
  1732.          of free space on the destination disk.  If so, a line similar
  1733.          to the following will appear:
  1734.  
  1735.               500,000 bytes of free disk space.
  1736.  
  1737.          The number 500,000 will actually be the number that you
  1738.          specified at IG time.
  1739.  
  1740.          If you elected to check for the DOS version at IG time, then
  1741.          a bulleted line similar to the following will appear:
  1742.  
  1743.               DOS version 3.10 or greater.
  1744.  
  1745.  
  1746.                                        27                                       
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.          This line will appear even if you elected not to check for the
  1755.          DOS version.  In that case it will check that the target system
  1756.          has at least DOS version 2.0 as a minimum so that the
  1757.          installation program will run correctly.
  1758.  
  1759.          The next two bulleted lines will appear if you elected to check
  1760.          for CPU type and a math co-processor.  If you chose both, you
  1761.          will get two lines displayed that are similar to the following:
  1762.  
  1763.               An 80268 CPU or greater.
  1764.               A MATH Co-processor.
  1765.  
  1766.          You'll only get one of the above lines if you only selected
  1767.          one of the options.
  1768.  
  1769.      Source Drive Screen
  1770.  
  1771.          This screen asks the user from which drive he would like to
  1772.          install your software product.  In almost all cases, Installation
  1773.          Pro will be able to find the drive from which the installation
  1774.          routine was started.  It will make this drive the default drive
  1775.          for the installation.  If this is satisfactory to the user,
  1776.          he/she has only to press the <Enter> key and the installation
  1777.          routine will proceed to the next screen.  If it is not
  1778.          satisfactory to the user, he/she may press the <D> key to change
  1779.          the source drive or select 'Change Drive' from the scrolling bar
  1780.          menu and press <Enter>.  This new drive will become the default
  1781.          drive for reading the installation diskettes if Installation Pro
  1782.          finds it to be a valid drive.
  1783.  
  1784.          The drive selection example on this screen will never be the
  1785.          same drive as the default drive.  Installation Pro will always
  1786.          pick another drive for the example selection.
  1787.  
  1788.      Destination Path Screen
  1789.  
  1790.          The path [drive:\directory] where you software will be installed
  1791.          is the next item that the user must decide.  Normally, the user
  1792.          will just accept the default and continue to the next screen.
  1793.          However, if the user wants the install your software on another
  1794.          drive and/or directory, then he/she must select the 'Change PATH'
  1795.          item from the menu or press the <P> key.  The user will then be
  1796.          prompted for a path.
  1797.  
  1798.          Installation Pro will accept only valid drives from the user.
  1799.          It will also accept only one directory.  If the user enters more
  1800.          than one directory or a drive that is not a valid drive, he/she
  1801.          will be informed of the problem in a pop-up window.
  1802.  
  1803.          If the user changes the default directory then all changes to
  1804.  
  1805.                                        28                                       
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.          AUTOEXEC.BAT and CONFIG.SYS files will reflect this change.
  1814.  
  1815.          Installation Pro will check for the validity of the user's
  1816.          choice and will check the destination drive for write protection
  1817.          and free space.
  1818.  
  1819.      Insert Diskette Screen
  1820.  
  1821.          If you selected This screen will ask the user to insert diskette
  1822.          m of n diskettes.  The diskettes in the installation volume set
  1823.          should be marked somewhere on the diskette's label with the
  1824.          following:
  1825.  
  1826.               Diskette 1:    Disk 1 of n
  1827.               Diskette 2:    Disk 2 of n
  1828.  
  1829.          (where m is the diskette number and n is the number of diskettes
  1830.           in the installation volume set.)
  1831.  
  1832.          A bargraph may appear while the diskettes are being copied.
  1833.          A bargraph will only appear if the total number of copy
  1834.          operations is greater than one.  The bargraph is based on the
  1835.          total number of copy operations and not file sizes, so the
  1836.          graph may not show a true percentage of completion but it
  1837.          will show that progress is being made.  Wildcards in copy
  1838.          operations will only increment the graph by
  1839.          1/total_copy_operations.  An additional bargraph will be
  1840.          displayed for copy codes of F, I, L, G, and M.
  1841.  
  1842.          As soon as Installation Pro has finished with a diskette, it
  1843.          will prompt the user to insert the next diskette in the series.
  1844.          If you answered 'Y' to the 'Insert Alert' question then a little
  1845.          tune will play when the user is prompted to insert the next
  1846.          diskette.  This will continue until all the diskettes have been
  1847.          processed.  When the last diskette has been processed, the user
  1848.          will be shown one of the following screens depending on the
  1849.          options selected at IG time:
  1850.  
  1851.               The AUTOEXEC.BAT File Screen
  1852.               The CONFIG.SYS File Screen
  1853.               The File Viewing Screen
  1854.               The Re-boot Screen
  1855.               The Successful Installation Screen
  1856.  
  1857.      Performing Security/Other Function
  1858.  
  1859.          A message will be displayed indicating that Installation Pro
  1860.          is performing a security (copy-protection) function or other
  1861.          function of your choosing.  This other function may be file
  1862.          decompression or other function needed by you software product
  1863.  
  1864.                                        29                                       
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.          for proper installation.  This message and action can occur in
  1873.          one of two places but not both.
  1874.  
  1875.          Just before Installation Pro is ready to copy files according
  1876.          to the copy operation command parameters that you gave it during
  1877.          IG time, if you exercised the security/other function option,
  1878.          then the message will be displayed and the action will take
  1879.          place at his time.  Of course, for this function to occur at
  1880.          this time you would have had to specify "B"efore to the "When
  1881.          to execute" question and not "A"fter.
  1882.  
  1883.          If you answered "A"fter to the Before/After question then the
  1884.          message and action will occur immediately after all the file
  1885.          copying operations have been performed.  This would be a good
  1886.          time to execute a decompression utility with a wildcard operation.
  1887.  
  1888.          Make sure that this process works and is not dependent on DOS
  1889.          or DOS's directory for needed commands.  If this child process
  1890.          crashes the system, Installation Pro will not continue
  1891.          (obviously).  Your needed programs should be supplied on your
  1892.          diskettes.  Be careful that these programs will execute with
  1893.          all versions of DOS from the minimum you allowed at IG time.
  1894.  
  1895.          Installation Pro will prompt the user to insert the correct
  1896.          disk for this operation to be performed even if this diskette
  1897.          is not in sequence with the file copying operations.  Checking
  1898.          for volume labels is always a good idea when you have more than
  1899.          one diskette in your installation diskette set.
  1900.  
  1901.      The AUTOEXEC.BAT Screen
  1902.  
  1903.          The user's AUTOEXEC.BAT system file is modified at this time if
  1904.          you elected this option at IG time.  The user has the option of
  1905.          'Continue'ing the installation, letting Installation Pro make
  1906.          the modifications to his/her AUTOEXEC.BAT file, or selecting
  1907.          the 'Skip' option from Installation Pro's menu.  When selecting
  1908.          the 'Skip' option, the primary directory will contain the
  1909.          modifications that would have been made had the user not selected
  1910.          the 'Skip' option.  These changes will be placed in a file named
  1911.          'AUTOEXEC.BTA'.
  1912.  
  1913.          Note:  The changes to the AUTOEXEC.BAT are placed in a file
  1914.                 similarly named but with the last two letters of the
  1915.                 file extension reversed.
  1916.  
  1917.      The CONFIG.SYS Screen
  1918.  
  1919.          The user's CONFIG.SYS system file is modified at this time
  1920.          if you elected this option at IG time.  The user has the
  1921.          option of 'Continue'ing the installation, letting Installation
  1922.  
  1923.                                        30                                       
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.          Pro make the modifications to his/her CONFIG.SYS file, or
  1932.          selecting the 'Skip' option from Installation Pro's menu.
  1933.          When selecting the 'Skip' option, the primary directory will
  1934.          contain the modifications that would have been made had
  1935.          the user not selected the 'Skip' option.  These changes will
  1936.          be placed in a file named 'CONFIG.SSY'.
  1937.  
  1938.          Note:  The changes to the CONFIG.SYS are placed in a file
  1939.                 similarly named but with the last two letters of the
  1940.                 file extension reversed.
  1941.  
  1942.      The File Viewing Screen
  1943.  
  1944.          If you selected file viewing at IG time, then Installation Pro
  1945.          displays the file you selected to the user for viewing.  The
  1946.          file that the user views appears in a scrollable window which
  1947.          is 15 lines high and 78 characters wide.  As the user reads
  1948.          the file he/she may scroll the file through the window by
  1949.          either pressing the down-arrow key or the page-down key.
  1950.          The user may re-read the file by pressing the page-up, up-
  1951.          arrow, or the home key.  The end key will bring the user the
  1952.          end of the file that he/she is viewing.
  1953.  
  1954.          The user is constantly presented a line of help at the bottom
  1955.          of the window.  When the user is through viewing/reading
  1956.          the file, he/she may press the <Esc> (Escape) key to exit.
  1957.          This information is also presented to the user in the
  1958.          window's bottom border.
  1959.  
  1960.          Note:  Viewing a file from a diskette may be a little slow due
  1961.                 to the diskette drive's limited speed in accessing the
  1962.                 file.
  1963.  
  1964.      Re-Booting Screen
  1965.  
  1966.          This screen will only appear if you selected the re-boot
  1967.          option.  If you did select this option then you obviously did
  1968.          not select the 'Execute a program at installation end' option.
  1969.  
  1970.          Although it is possible to do both by placing the name of the
  1971.          file to execute at the end of the AUTOEXEC.BAT as an
  1972.          added line, this is not recommended since this program will
  1973.          always execute when the user's system is turned on or re-
  1974.          booted.  However, in some cases this may be what you want
  1975.          to do.
  1976.  
  1977.      The Final Screen
  1978.  
  1979.          This screen is Installation Pro's final screen.  It states
  1980.          whether or not your software product was successfully
  1981.  
  1982.                                        31                                       
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.          installed.
  1991.  
  1992.          Centered directly below the screen title, in reverse video,
  1993.          will be one of the following messages indicating the suc-
  1994.          cessful or unsuccessful installation of you software product:
  1995.  
  1996.               Soft-Product has been successfully installed.
  1997.  
  1998.                    or
  1999.  
  2000.               Soft-Product has not been successfully installed.
  2001.  
  2002.          Installation Pro will consider your product successfully
  2003.          installed if all the directories were created and all the
  2004.          files were copied without error.  The latter message will
  2005.          appear if the user decides to quit the installation before
  2006.          the files have been copied successfully or if there was an
  2007.          error reading one of the diskettes.
  2008.  
  2009.      File Compression
  2010.  
  2011.          A very good method of saving space on your diskettes is to
  2012.          use file compression.  There are many good file compression
  2013.          utilities around such as PKZIP and ARC to name a couple.
  2014.  
  2015.          However, these are commercial products and require licensing.
  2016.  
  2017.          One product that I use and has no licensing requirements for
  2018.          commercial use (unless it is integrated with your product and
  2019.          bundled with it) is LHA213.  This product is as good if not
  2020.          better than most of the other products that I have used.  It's
  2021.          available on most BBS systems as well as on BMB Software's
  2022.          support BBS at 413-731-1155.  Set your modem to 8 data bits,
  2023.          one stop bit and no parity.  The BMB Software BBS uses Hayes
  2024.          Optima 14.4K baud modems.  LHA213.EXE (it itself is a
  2025.          self- extracting archive file) can be found in filebase zero
  2026.          in area C.
  2027.  
  2028.          An advantage of using self-extracting compressed archived
  2029.          files is that they require very little overhead.  The overhead
  2030.          required for making an archive self-extracting with LHA is
  2031.          about 1500 bytes.  If you were to place an un-packer, an un-
  2032.          zipper, or the LHA program on a diskette to un-compress the
  2033.          files it would take approximately 15 to 40 thousand bytes
  2034.          depending on which one you used.  What you gain by
  2035.          placing a stand alone decompression utility is more
  2036.          functionality which you really don't need in an installation
  2037.          routine.
  2038.  
  2039.          Also, if you had a self-extracting archive that you created
  2040.  
  2041.                                        32                                       
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.          with  the LHA program, and it was larger than available
  2050.          memory, say 700,000 bytes, it would still execute in the
  2051.          user's system.  That's because only the small overhead
  2052.          associated with the self-extracting archive is actually running
  2053.          in the system while it's reading and extracting the
  2054.          compressed files in the archive.
  2055.  
  2056.      Splitting Files
  2057.  
  2058.          Splitting of files is often necessary if you have large
  2059.          executables or large database files that must be installed on
  2060.          another system.  You can use Installation Pro just to move
  2061.          large files if you like.
  2062.  
  2063.          Installation Pro allows the splitting of self-extracting files for
  2064.          rejoining at installation time.  Only self-extracting files can
  2065.          be rejoined and executed at installation time.  Splitting of
  2066.          files can be done very easily with BMB Software's file
  2067.          splitting utility BLDSPLIT.
  2068.  
  2069.          If you have an application that uses more than 10 360K
  2070.          diskettes you should seriously consider going to higher
  2071.          density diskettes.  The user might be overwhelmed loading
  2072.          20 or 30 diskettes.
  2073.  
  2074.          See the BLDSPLIT Chapter for more information on its use.
  2075.  
  2076.          Also see the Example Runs Chapter for more information
  2077.          about using BLDSPLIT with Installation Pro.
  2078.  
  2079.      Examples
  2080.  
  2081.          Here are some examples for using Installation Pro.
  2082.  
  2083.          Example 1:
  2084.  
  2085.          This is an example of how Installation Pro's installation
  2086.          routine was created.  Since Installation Pro will fit on one
  2087.          360K diskette, the process for creating a 720K 3½ diskette
  2088.          installation will be similar.
  2089.  
  2090.          On the first screen, you create the title and version of your
  2091.          product (in this case, Installation Pro), the colors for your
  2092.          screen, the number of diskettes (in this case 1), and the
  2093.          volume name of the diskette.  The volume name is not necessary
  2094.          as there is only one diskette and it must be inserted in order
  2095.          to run the installation program.
  2096.  
  2097.          On the second screen we will check for free disk space.  In
  2098.          this case we need less than 300K, but we will use 500K so that
  2099.  
  2100.                                        33                                       
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.          the user will have enough free disk space to create a couple
  2109.          of installation routines without having any problems.  We will
  2110.          also check that the user has at least 512K of RAM and DOS
  2111.          version 2.10 or better.  Our default source drive will be
  2112.          drive A: and our default destination drive (and also the drive
  2113.          where we can find AUTOEXEC.BAT) will be drive C:.  We will not
  2114.          check for an 80286 or greater CPU nor a coprocessor, since these
  2115.          are not necessary.
  2116.  
  2117.          On the next screen we will choose to create one directory on
  2118.          the user's system for our software product and its name will
  2119.          be \IPRO.
  2120.  
  2121.          For the next screen we will answer one (1) to the number of
  2122.          copy operations question.  For the Src. question we will answer
  2123.          "*.*" (without the quotes, for all files on this diskette) and
  2124.          for the Dst. (Destination) question we will answer with out
  2125.          primary directory (and our only one) of "\IPRO".
  2126.  
  2127.          The next screen will have all "N"o answers for:
  2128.  
  2129.               File to view
  2130.               File to execute
  2131.               Give re-booting option.
  2132.  
  2133.          Now for the last screen we will choose to modify AUTOEXEC.BAT by
  2134.          adding our primary directory to the user's path statement in
  2135.          his/her AUTOEXEC.BAT file.  No modifications to his/her
  2136.          CONFIG.SYS file need be done.  We will also answer "Y" to the
  2137.          "Finished editing ALL screens?" question and INSTALL.EXE will
  2138.          then be generated in a few seconds.
  2139.  
  2140.          We then format a diskette and place our newly created
  2141.          INSTALL.EXE program on it.  We then also place the MAKEINST.EXE
  2142.          file and any README files and other utilities which are needed
  2143.          on the same diskette following the INSTALL.EXE program.  We are
  2144.          then ready to test this master installation diskette by
  2145.          inserting it in a drive on some system you want to test install
  2146.          your software product.  If you wish to make a change in the
  2147.          installation routine, you simply re-run the MAKEINST.EXE program
  2148.          and choose "Y" for reading defaults from a previously generated
  2149.          INSTALL.EXE program.  You may then simply replace the
  2150.          INSTALL.EXE program on your master installation diskette
  2151.          because they will be the same length and will copy over one
  2152.          another without fragmentation.
  2153.  
  2154.          Example 2:
  2155.  
  2156.          In this example. your software product is contained in
  2157.          one directory and is almost three (3) megabytes in about
  2158.  
  2159.                                        34                                       
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.          110 files.  In this case we suggest that you compress the
  2168.          entire directory and make it a self-extracting file.  To do
  2169.          this we will use (in this example) the LHA program.
  2170.          This program is free and can be found on Compuserve
  2171.          as well as on BMB Software's BBS (in the ARC
  2172.          library).  For this case we will assume that your
  2173.          software product is in a directory named "\MYDIR" on
  2174.          drive C: and you wish to have it installed on the user's
  2175.          system on drive C: and in directory \GREAT.
  2176.  
  2177.          The following LHA commands would create the self-
  2178.          extracting file that we need:
  2179.  
  2180.               LHA a MYCOMP C:\MYDIR\*.*
  2181.  
  2182.          This creates the MYCOMP.LZH file.  This is a
  2183.          compressed file containing all the files in the \MYDIR
  2184.          directory on drive C:.  The next LHA command will
  2185.          make this file a self-extracting file:
  2186.  
  2187.               LHA s MYCOMP
  2188.  
  2189.          You know have the MYCOMP.EXE file that you need.
  2190.          At installation time, Installation Pro will execute this file
  2191.          and your original un-compressed files that were in your
  2192.          \MYDIR directory will be restored on the user's system.
  2193.          On the test directory that we used for this example,
  2194.          which had 112 files and almost 3 megabytes (2.69
  2195.          megabytes) of space, LHA compressed this directory to
  2196.          1.12 megabytes.  This is a savings in space of more than
  2197.          50% which will save you approximately 4 360K
  2198.          diskettes in your distribution installation diskette set.
  2199.  
  2200.          You can then easily figure that the installation will
  2201.          require 4 360K diskettes including the 90K or so for
  2202.          INSTALL.EXE.
  2203.  
  2204.          When running MAKEINST.EXE, you only need to
  2205.          remember what you will use for the volumes names if
  2206.          you decide to use them (it would be very helpful to be
  2207.          sure that the user inserts the correct diskette at the
  2208.          correct time) and the number of diskettes that will be
  2209.          needed.  Make sure that the parts of the archive file are
  2210.          in the correct order.  Installation Pro has no way of
  2211.          knowing if you put the parts in the correct order or how
  2212.          many parts there are to the file.
  2213.  
  2214.          Also, you should check for free disk space.
  2215.  
  2216.          This would be about 4 megabytes.  You need this much
  2217.  
  2218.                                        35                                       
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.          because both the self-extracting archive file and the files
  2227.          that it is producing (extracting) will reside
  2228.          simultaneously on the destination disk for a short time
  2229.          (while the self-extracting archive file is executing)
  2230.          before the self-extracting archive is deleted.  There will
  2231.          be only four copy operations, one per diskette and they
  2232.          will look like the following:
  2233.  
  2234.               Source          Destination     Copy Code
  2235.               -----------     -----------     -----------
  2236.               MYCOMP.P01      \GREAT          F
  2237.               MYCOMP.P02      \GREAT          I
  2238.               MYCOMP.P03      \GREAT          I
  2239.               MYCOMP.P04      \GREAT          L
  2240.  
  2241.          The directory \GREAT should be the primary directory that you
  2242.          created.  After you have made the INSTALL.EXE program and have
  2243.          placed it on one of the four diskettes that you will need, you
  2244.          are ready to run the BLDSPLIT program.  When running BLDSPLIT,
  2245.          the file to be split will be MYCOMP.EXE and you will probably
  2246.          want to answer "Y" to the "Fit to floppy?" question.  This will
  2247.          split the MYCOMP.EXE file across the four floppy diskettes.
  2248.          BLDSPLIT will prompt you for installing the next diskette after
  2249.          it fills it.  This is also a good time to put volume names on the
  2250.          diskettes.
  2251.  
  2252.          You must remember that the first file part will get a copy code
  2253.          of "F" (stands for First part tells Installation Pro to open a
  2254.          file for multi-part input).  Parts 2 and 3 will get copy codes
  2255.          of "I" (stands for Intermediate) and part 4 (the last part) gets
  2256.          a copy code of "L" (stands for Last part and tells Installation
  2257.          Pro to close the file after copying and then to execute it.
  2258.          During this multi-part copying process, a bar graph will be
  2259.          displayed on the installation screen to show percentage of
  2260.          copying that is complete.
  2261.  
  2262.          Example 3
  2263.  
  2264.          For this example, you want to distribute a database file that
  2265.          your application keeps in a compressed format.  You also have
  2266.          a little utility that you wish to execute before you copy the
  2267.          database file to the target system.  This utility accepts
  2268.          parameters and switches.  Your database is 1.2 megabytes large
  2269.          so you decide to split it across 4 360K diskettes.  Using
  2270.          BLDSPLIT, you generate four files on four diskettes.  Your
  2271.          original file was named 'BIGBASE.DAT'.  You now have it in four
  2272.          parts named 'BIGBASE.P01' through 'BIGBASE.P04'.  You rename
  2273.          the first part to BIGBASE.DAT' on diskette number one.  This
  2274.          will be the name that will be used on the target system.
  2275.  
  2276.  
  2277.                                        36                                       
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.      =================================================================
  2286.      BLDSPLIT
  2287.  
  2288.          BLDSPLIT is a BMB Software utility program that can help you
  2289.          make your installation routine simpler.  It is a program than
  2290.          will split any size file(s) into smaller parts.  These parts
  2291.          may later be rejoined by Installation Pro or the DOS copy
  2292.          command.
  2293.  
  2294.          BLDSPLIT will split a file into parts that you determine the
  2295.          size of, or BLDSPLIT can determine the size for you if the
  2296.          destination is a floppy drive.  BLDSPLIT will split a file in
  2297.          up to 99 parts.  BLDSPLIT will change the name of the file
  2298.          extension to reflect the number of the part.
  2299.  
  2300.          BLDSPLIT will display two bar graphs as a visual aid for
  2301.          determining the completion of the file splitting.  One graph
  2302.          shows the percentage of completion of the file to be split.
  2303.          The other shows the percentage of completion of the writing
  2304.          of the split file part.
  2305.  
  2306.          For example, let us say that you have a self-extracting archive
  2307.          file that is 900,000 bytes.  You could have BLDSPLIT split the
  2308.          file into 200,000 byte parts.  The files would look like this:
  2309.  
  2310.               The file to split is:      PROGRAMS.EXE
  2311.  
  2312.               The split files would be:  PROGRAMS.P01
  2313.                                          PROGRAMS.P02
  2314.                                          PROGRAMS.P03
  2315.                                          PROGRAMS.P04
  2316.                                          PROGRAMS.P05
  2317.  
  2318.          The first four files with extensions of .P01, .P02, .P03, .P04
  2319.          would each be about 200,000 bytes (200K) and PROGRAMS.P05 would
  2320.          be about 100,000 bytes (100K).  The "K" in 200K represents 1024
  2321.          bytes.  Installation Pro could then rejoin the split parts of
  2322.          the file to PROGRAMS.EXE and execute it (which will decompress
  2323.          it).
  2324.  
  2325.          BLDSPLIT should be executed from the drive:\directory in which
  2326.          you want the parts of the file to remain.  BLDSPLIT dumps the
  2327.          parts to the default drive and directory.  The exception to this
  2328.          rule is if you are fitting a file to diskettes.  In this case,
  2329.          you can be on any drive and in any directory, and the parts of
  2330.          the file will go the diskette drive that you designated.
  2331.  
  2332.      File to Split
  2333.  
  2334.          At the prompt that asks you for a name of a file to split, you
  2335.  
  2336.                                        37                                       
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.          enter the file name including any drive and/or directory
  2345.          associated with it.  The file can be write protected because
  2346.          BLDSPLIT will open it for reading only.
  2347.  
  2348.      Fit to Floppy
  2349.  
  2350.          If you answer "Y" to the "Fit to Floppy?" question, BLDSPLIT
  2351.          will put the file to be split on floppy diskettes.  BLDSPLIT
  2352.          will check for the amount of free file space on the diskette
  2353.          drive that you specified and place as much of the file to split
  2354.          as it can on the diskette.  It will then ask you to insert
  2355.          another floppy diskette until the entire file has been placed
  2356.          on diskettes.  Make sure you have enough diskettes to hold the
  2357.          entire file.  The "Y" answer will also cause BLDSPLIT to ask
  2358.          you if you wish to have it prompt you for volume labels for
  2359.          each diskette that you insert and will ask you for the diskette
  2360.          drive that you want to use.
  2361.  
  2362.      Vol. Labels?
  2363.  
  2364.          If you answered "Y" to the "Fit to Floppy?" question, BLDSPLIT
  2365.          will ask you if you want volume labels.  If you answer "Y" the
  2366.          "Vol. Labels?" question, BLDSPLIT will ask you for a volume
  2367.          label for the diskette after each diskette insertion.  Volume
  2368.          labels must follow the DOS standard for volume label names.
  2369.  
  2370.          Volume labels can be up to 11 characters in length.
  2371.  
  2372.      Drive?
  2373.  
  2374.          If you answered "Y" to the "Fit to Floppy?" question, BLDSPLIT
  2375.          will ask you for the drive letter.  Simply enter the letter of
  2376.          the drive that you want to use for placing the parts of the file
  2377.          to split.
  2378.  
  2379.      All Same?
  2380.  
  2381.          If you answered "N" to the "Fit to Floppy?" question, BLDSPLIT
  2382.          will ask you if all the parts of the file to split will be the
  2383.          same size.  If you answer "Y" to this question, BLDSPLIT will
  2384.          ask you for the number of kilobytes to make each part.  The
  2385.          parts must be at least 1K (one kilobyte) large but also large
  2386.          enough that it will not require BLDSPLIT to split the file into
  2387.          more than 99 parts.  The last part may be smaller than the rest
  2388.          of the parts if the bytes remaining for the last part are less
  2389.          than the part size.
  2390.  
  2391.      KBytes?
  2392.  
  2393.          If you answered "N" to the "Fit to Floppy?" question, BLDSPLIT
  2394.  
  2395.                                        38                                       
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.          will either ask you the "KBytes?" question or the "Enter size
  2404.          of part n in kilobytes?" question (where n in the part number).
  2405.          If you entered "Y" to the "All same?" question, BLDSPLIT will
  2406.          ask you the "KBytes?" question.  If you entered "N" to the "All
  2407.          same?" question, BLDSPLIT will ask you the latter question.
  2408.          The remaining bytes of the file to be split will be displayed
  2409.          to the right of the "All same?" or "Drive?" questions.
  2410.  
  2411.          At the end of the file splitting, BLDSPLIT will display a
  2412.          message stating if the file has been successfully split or
  2413.          not.
  2414.  
  2415.      Error Messages
  2416.  
  2417.          The following error messages may occur while you are testing
  2418.          your new installation routine.  These explanations should help
  2419.          you decide what went wrong, what was forgotten, or what
  2420.          typographical error may have been introduced while you were
  2421.          generating your installation routine.
  2422.  
  2423.          L101 -- The error message displayed after this error code
  2424.                  signifies that there was a problem with creating a
  2425.                  directory.
  2426.  
  2427.          L102 -- The error message displayed after this error code
  2428.                  signifies that there was a problem with the source of
  2429.                  a copy operation.
  2430.  
  2431.          L103 -- The error message displayed after this error code
  2432.                  signifies that there was a problem with the destination
  2433.                  of a copy operation.
  2434.  
  2435.          L104;n -- This error code signifies a problem with the source
  2436.                    file of a copy operation.
  2437.  
  2438.                    Note:  The "n" following the error code and semi-colon,
  2439.                    is the copy operation number for that particular
  2440.                    diskette.
  2441.  
  2442.          L106;n -- This error code signifies a problem with the file to
  2443.                    be viewed if that option was selected at IG time.
  2444.                    The "n' following the error code and the semi-colon
  2445.                    is the disk number that Installation Pro was looking
  2446.                    for the file to reside on.  0 is for the hard disk
  2447.                    in the default primary directory, 1, 2, 3, ..., 9 is
  2448.                    the diskette number that it expected it to be on.
  2449.  
  2450.          L107 -- Indicates a problem reading the source diskette.  The
  2451.                  message following this code should explain the problem
  2452.                  in greater detail.
  2453.  
  2454.                                        39                                       
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.          L108 -- This error code signifies a problem with one of the
  2464.                  system files.  The message following this code should
  2465.                  explain in greater detail what Installation Pro was
  2466.                  unable to do for whatever reason.
  2467.  
  2468.          L109;xx ICA=yyy;zz -- This error occurs if the value that
  2469.                                Installation Pro found at the memory
  2470.                                location that you specified does not
  2471.                                equal the value that you specified.
  2472.                                This error can only occur if you selected
  2473.                                ICA checking.
  2474.  
  2475.                 where     xx = The memory value that Installation Pro
  2476.                                found at the designated address.
  2477.                          yyy = The designated memory address.
  2478.                           zz = The value that Installation Pro expected
  2479.                                to find at the designated address.
  2480.                                (NOTE:  xx, yyy, and zz are hex values)
  2481.  
  2482.          L111 message drive: -- Indicates that there was a problem
  2483.                                 reading or writing from/to a disk during
  2484.                                 the copy operation(s).  The problem drive
  2485.                                 will be displayed in the message following
  2486.                                 the error code.  Three attempts will be
  2487.                                 made to recover from the error.  More
  2488.                                 messages will pop up and disappear in
  2489.                                 windows telling the user what is happening.
  2490.                                 The installation will abort if Installation
  2491.                                 Pro was not able to recover from the error.
  2492.  
  2493.          Thank you all for your inputs, suggestions, and support.
  2494.  
  2495.          Gerry Bilodeau
  2496.          BMB Software
  2497.          P.O. Box 1071
  2498.          West Springfield, MA  01090-1071
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.                                        40                                       
  2515.  
  2516.