home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / p / pi49a.zip / MANUAL.DOC < prev    next >
Text File  |  1993-01-26  |  58KB  |  1,301 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                      Program Installer Professional
  16.                              Version 4.9
  17.                         Official Release (01/93)
  18.  
  19.                   Copyright (C) 1990, 1991, 1992, 1993
  20.                           The DataWorks, Inc.
  21.                               P.O. Box 614
  22.                           5000 Whitling Drive
  23.                          Pelham, Alabama  35124
  24.  
  25.                              (800) 844-2509
  26.  
  27.                          Local: (205) 663-1991
  28.  
  29.                           FAX: (205) 664-3014
  30.  
  31.                           BBS: (205) 664-0406
  32.  
  33.  
  34.  
  35.  
  36.                               User's Manual
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                              Disclaimer
  60.  
  61.  
  62.      The DataWorks, Inc. makes no warranties or claims to the fitness of this
  63. program. The user of this program, makes use of this program accepting any
  64. and/or all responsibilities for the actions of this program.
  65.  
  66.      Though we at DataWorks have taken every measure possible to insure that
  67. the program will/does function properly and will not cause any loss or
  68. contamination to your data, we cannot accept responsibility for unexpected
  69. bugs or other problems with the program that could result in the loss of or
  70. contamination of your data.
  71.  
  72.      If you do experience problems (bugs!) with the program, we would like to
  73. know, and ask that you contact DataWorks directly, or through our support BBS.
  74.  
  75.  
  76.  
  77.                               Acknowledgements
  78.  
  79.      Special thanks to Bob Ainsbury (TechnoJock Software) for the best online
  80.      phone support ever.
  81.  
  82.      Kim Kokkenen, President of and Developer for TurboPower Software, for
  83.      a fine selection of toolkits and great technical support.
  84.  
  85.      Borland International for a superior product and great support staff.
  86.  
  87.      Barry Weck, co-developer of Program Installer.
  88.  
  89.      The staff at DataWorks, Inc. for putting up with us programmers!<G>
  90.  
  91.  
  92.  
  93.      ■ Borland is a registered trademark of Borland International
  94.      ■ Turbo Pascal is a registered trademark of Borland International
  95.      ■ Async Professional is a registered trademark of
  96.        TurboPower Software
  97.      ■ TechnoJock's Turbo Toolkit is a registered trademark of
  98.        TechnoJock Software.
  99.      ■ PKZip/PKUnZip are registered trademarks of PKWare, Inc.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                               Introduction
  115.  
  116.      Program Installer is simply that - a program installer. It has been used
  117. by DataWorks, Inc. in some of our own third party applications as a generic
  118. installation utility.
  119.  
  120.      Program Installer is designed for programmers/ 3rd. party developers. You
  121. can use it to facilitate the installation of a program you have written for
  122. either a client or for some vertical market. Program Installer doesn't care
  123. about what you have written or whether or not you want the program(s) you have
  124. written installed into a particular directory on the client/customer's hard
  125. drive.
  126.  
  127.      Program Installer can read files from either the A: or B: floppy diskette
  128. drive, and allows the end-user to specify the hard drive letter (C: through Z:)
  129. and/or subdirectory(s) into which your programs should be copied. All you, as
  130. a programmer/distributor, need to do is follow the simple setup instructions of
  131. Program Installer, and then let Program Installer do the rest for you (and
  132. your client/customers)!
  133.  
  134.      Program Installer not only copies files from the diskettes you setup for
  135. distribution, it can also handle subdirectories you may need created (nested)
  136. on the end-user's (client's) harddrive, and also provides for updating the
  137. end-user's AUTOEXEC.BAT and CONFIG.SYS files dynamically - all this totally
  138. transparent to the end-user.
  139.  
  140.      Also, Program Installer provides options that allow you a limited amount
  141. of license protection for your application. Even data encryption has been
  142. implemented (beginning with version 3.0) so you can be assured that your
  143. programs/data cannot be installed (or just copied) without the use of Program
  144. Installer.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.                                FEATURES!
  170.  
  171.  
  172.         ■ Easy setup. Program Installer takes only minutes to
  173.           completely configure for your use.
  174.  
  175.         ■ Free technical support from 7:00 A.M. to 7:00 P.M.
  176.           central standard time (USA). (800) 844-2509
  177.                TECHNICAL SUPPORT (Registered Users Only!)
  178.  
  179.         ■ Multiple Diskette, unlimited nesting of sub-directory
  180.           levels for your application.
  181.  
  182.         ■ AUTOEXEC/CONFIG file changes supported, in ALL areas
  183.           necessary for the CONFIG.SYS (including environment space
  184.           allocation), and the basic areas of the AUTOEXEC (PATH,
  185.           SET statements, etc.).
  186.  
  187.         ■ Data compression. We use the .LZH method for optimum data
  188.           compression.
  189.  
  190.         ■ Diskette File Encryption. We employ a 32 bit CRC public-key
  191.           method that literally scrambles the contents of the 'installation'
  192.           diskettes so only PI can copy and extract your application!
  193.  
  194.         ■ Floppy Diskette 'Copy-Protection'. We employ a specialized
  195.           method of copy-protecting the initial PROGRAM DISK 1,
  196.           distribution diskette so that even the best of COPYing
  197.           products have a hard time making an image copy of your
  198.           distribution diskette!!!
  199.  
  200.         ■ On-screen listing of files/directories on your hard disk
  201.           so you can quickly and easily select the appropriate
  202.           files for building your distribution diskette(s).
  203.  
  204.         ≡ The confidence in knowing that we have been supporting
  205.           this product, through shareware means, and now have one
  206.           of the largest installed bases of 'auto-installation'
  207.           programs available today!
  208.  
  209.                     
  210.  
  211.  
  212.  
  213.      IMPORTANT NOTICE FOR TEST DRIVE (Non-registered) VERSION/USERS
  214.  
  215.      If you have not registered your copy of Program Installer, some of
  216. the following features will not work because they are disabled in the
  217. TEST DRIVE release of all copies of Program Installer. Prior to version 4.0beta,
  218. we totally disabled almost all of the advanced features of the program until
  219. the user registered the program. With the release of 4.0beta and later versions,
  220. we are allowing for all features to be available except for the following:
  221.  
  222.         ■ You will not be able to remove any of the hard-coded
  223.           "Copywrite (C)" information lines out of the program
  224.           and replace them with your own.
  225.  
  226.         ■ Although you will be able to actually work with all the
  227.           features of the program, and even create your distribution
  228.           diskettes, Program Installer's main INSTALL.EXE program
  229.           will only allow the installation of ONE of your distribution
  230.           disks. This does, however, allow you to use the program
  231.           fully if you have only need one distribution diskeete to
  232.           release your application!
  233.  
  234.      We effected these disabilities this way because this will allow you,
  235. the distributor/developer to preview all of the program's features/options,
  236. and review the integrity/performance of the program all the way to the point
  237. of actually creating your distribution diskettes. However, the INSTALL.EXE is
  238. disabled when it comes to the point of actually installing more than one
  239. distribution diskette.
  240.  
  241.                          NOTICE!!!   NOTICE!!!
  242.  
  243.      We at DataWorks, Inc. know that Program Installer is a high-quality,
  244. commercial product. However, instead of releasing Program Installer at
  245. $199.95 or higher, to compete with other comparable commercial products,
  246. we're releasing it via the BBS community for a very modest fee. Because of this
  247. we MUST disable the program, forcing users to pay for its use. There are a
  248. number of ways available for registering the program and obtaining a
  249. REGISTER.KEY file. See the REGISTER.DOC file for details. Our main reason for
  250. distributing the program this way, and at such a price is because we know
  251. that many, many developers out there don't want to spend $200.00 and up
  252. to use an installation utility only once! Also, for distributors/developers
  253. that DO have several products they want to use the installation utility for,
  254. we're providing an excellent product at an excellent price! By doing this,
  255. we hope to make every user of Program Installer happy!!!
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                         SETUP AND CONFIGURATION
  266.  
  267.  
  268.      When you first receive Program Installer it needs to be configured for use
  269. with your application(s). This is accomplished easily!
  270.  
  271.      Program Installer's main program - INSTALL.EXE - is the only program that
  272. you'll ever use. This may seem a bit confusing, but the program modifies itself
  273. each time you configure it for your software and distribution. This means that
  274. once you configure it for use with say, a product you're selling that you don't
  275. care about copy protection for, and it has only 4 disks, that you're not locked
  276. into THAT configuration, period. Program Installer is designed to be configured
  277. again, and again. So, whether you're wanting to use it for only one application
  278. you're marketing/distributing, or with many different applications, it's quite
  279. easy to configure it for each application! Best of all, you only have to buy
  280. one copy of the program to do all this! No royalties, no nothing.
  281.  
  282.  
  283.          
  284.                       REPLACING OUR COPYRIGHT LINES
  285.  
  286.      The first thing most users want to do is get rid of DataWorks' copyright
  287. information that appears throughout the program. To do this, make sure you are
  288. in the directory that INSTALL.EXE is in. Then type
  289.  
  290.         INSTALL LICENSEE - and press <Enter>.
  291.  
  292.      Program Installer will look for your REGISTER.KEY file in the same
  293. directory you are executing the INSTALL.EXE file in. (NOTE: If you have NOT
  294. registered your copy of Program Installer, you will not have this file!) If
  295. Program Installer finds the REGISTER.KEY file, then it proceeds and allows
  296. you to continue.
  297.  
  298.      The screen that appears is simple. You're prompted to enter the name -
  299. however you want it! - that you want to appear instead of the DataWorks, Inc.
  300. copyright information that appears throughout the program.
  301.  
  302. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  303. ░╔═════════════════════════════════════════════════════════════════════════╗░
  304. ░║ ······································································  ║░
  305. ░╚═════════════════════════════════════════════════════════════════════════╝░
  306. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  307.  Figure 1
  308.  
  309.  
  310.      After you enter the name (or complete line of information) and press
  311. <Enter> (or <RETURN> on some machines) you will be prompted to verify that the
  312. data you entered is, in fact, what you want to use in place of the DataWorks,
  313. Inc. copyright information.
  314.  
  315.  
  316.  
  317.  
  318.  
  319.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  320.         ░░╔═══════════════════════════════════════════╗░░
  321.         ░░║              You entered...               ║░░
  322.         ░░║ Copyright (C) 1991 - The DataWorks, Inc.  ║░░
  323.         ░░║                                           ║░░
  324.         ░░║               Accept  Redo                ║░░
  325.         ░░╚═══════════════════════════════════════════╝░░
  326.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  327.          Figure 2
  328.         
  329.  
  330.      If you <Accept> the line, the INSTALL.EXE modifies itself so that the line
  331. you just entered appears from then on, each time you run the program, where
  332. the end-user would otherwise see the DataWorks, Inc. copyright information.
  333.  
  334.      Next you will be returned to the DOS environment, at which point you will
  335. have to type INSTALL again if you wanted to run the program to check and see
  336. that your line has been properly inserted.
  337.  
  338.      Now, the next step is to configure Program Installer for a few other
  339. options that really make up the program's strength.
  340.  
  341.      These configuration steps/options can be changed for any/all applications
  342. you may want to use Program Installer with.
  343.      
  344.  
  345.      To configure Program Installer you type
  346.  
  347.         INSTALL LICSETUP <Enter>
  348.  
  349.      The following screen will appear:
  350.  
  351. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  352. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  353. ░░░░░░░░░░░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░░░░░░░░░░
  354. ░░░░░░░░░░░░░░░░░░░░░░░░░█ Program Installer Setup  ░░░░░░░░░░░░░░░░░░░░░░░░░░
  355. ░░░░░░░░░░░░░░░░░░░░░░░░░█        Main Menu         ░░░░░░░░░░░░░░░░░░░░░░░░░░
  356. ░░░░░░░░░░░░░░░░░░░░░░░░░█──────────────────────────░░░░░░░░░░░░░░░░░░░░░░░░░░
  357. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  358. ░░░░░░░░░░░░░░░░░░░░░░░░░█     1    Setup Disks     ░░░░░░░░░░░░░░░░░░░░░░░░░░
  359. ░░░░░░░░░░░░░░░░░░░░░░░░░█     2    Exit            ░░░░░░░░░░░░░░░░░░░░░░░░░░
  360. ░░░░░░░░░░░░░░░░░░░░░░░░░█                          ░░░░░░░░░░░░░░░░░░░░░░░░░░
  361. ░░░░░░░░░░░░░░░░░░░░░░░░░█████████████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  362. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  363. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  364. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  365. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  366. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  367.        Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  368. ------------------------------------------------------------------------------
  369.  Figure #3
  370.  
  371.  
  372.  
  373.  
  374.      From this menu choose option #1 (Setup Disks) and press <Enter>.
  375. The following screen should appear (NOTE: The directories you may see on
  376. the left side of the screen may be different, but the screen layout the
  377. same):
  378.  
  379. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════  3:39:16 p.m. ╗
  380. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  381. ║──────────────────────────────────────────║║──────────────────────────────────║
  382. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  383. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  384. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  385. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  386. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  387. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  388. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  389. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  390. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  391. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  392. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  393. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  394. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  395. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  396. ║ Select files or directories to archive                                       ║
  397. ╠══════════════════════════════════════════════════════════════════════════════╣
  398. ║            File Style: Just Compression;  Floppy Disk Size: 360 k            ║
  399. ║                               PI Directory: C:\                              ║
  400. ╠══════════════════════════════════════════════════════════════════════════════╣
  401. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  402. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  403. ╚══════════════════════════════════════════════════════════════════════════════╝
  404. --------------------------------------------------------------------------------
  405.  Figure #4
  406.  
  407.  
  408.     Before we get involved with this screen, let's configure Program Installer
  409. first, and then we'll come back to this screen.
  410.  
  411.  
  412.     At this time, press <Alt-S> (hold down the Alt key on your keyboard, and
  413. then press the 'S' character). You should see the following screen:
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428. ╔═══════════════════════ Program Installer Preferences ════════════════════════╗
  429. ║                                                                              ║
  430. ║ ╔═════════ Archive File Options ══════════╗  ┌── Maximum Disk Size ───┐      ║
  431. ║ ║ ( )   Just Encryption                   ║  │ ( )   360 k            │      ║
  432. ║ ║ (*)   Just Compression                  ║  │ ( )   720 k            │      ║
  433. ║ ║ ( )   Both Encryption and Compression   ║  │ (*)   1.2 meg          │      ║
  434. ║ ║                                         ║  │ ( )   1.4 meg          │      ║
  435. ║ ╚═════════════════════════════════════════╝  └────────────────────────┘      ║
  436. ║                                                                              ║
  437. ║ ┌────────────────── Autoexec.bat and Congig.sys Options ───────────────────┐ ║
  438. ║ │ [X]  Update AUTOEXEC.BAT with user defined information?                  │ ║
  439. ║ │ [ ]  Update CONFIG.SYS with user defined information?                    │ ║
  440. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  441. ║   Allowed installations (1 to 255; Enter 0 for unlimited): 0··               ║
  442. ║                                                                              ║
  443. ║ ┌─────────────────────────── AUTOEXEC.BAT info. ───────────────────────────┐ ║
  444. ║ │ path %PATH%;Mypat······················································· │ ║
  445. ║ │ ········································································ │ ║
  446. ║ │ ········································································ │ ║
  447. ║ ├──────────────────────────── CONFIG.SYS Info. ────────────────────────────┤ ║
  448. ║ │ ········································································ │ ║
  449. ║ │ ········································································ │ ║
  450. ║ │ ········································································ │ ║
  451. ║ └──────────────────────────────────────────────────────────────────────────┘ ║
  452.  <Ctrl-Enter> Save Setup   <Tab, Enter, Shift-Tab> Change fields   <Esc> Cancel
  453.  -------------------------------------------------------------------------------
  454.   Figure #5
  455.  
  456.  
  457.      This is where the real configuration is done for your application's
  458. distribution. In the 'Archive File Options' box (upper left box in the screen),
  459. you'll notice that the default is 'Just Compression'. Most users of Program
  460. Installer don't really need the 'Encryption' feature, and just use the
  461. 'Compression' feature when setting up their disks.
  462.  
  463.      'Just Encryption' - If you choose this option then the files that
  464. Program Installer prepares for your distribution diskettes will not be
  465. compressed. This will require more floppies for your software/application.
  466. However, it will still protect your interests some, because the INSTALL
  467. program will be the only way these prepared DISK1.X, DISK2.X, etc. (for how-
  468. ever many disks are required for your application) files cannot be unpacked
  469. (not uncompressed - like DOS's BACKUP program, INSTALL determines how many
  470. of the files selected, when grouped, best fit on each floppy, depending on the
  471. size of the floppy disk you are using. It creates one DISKx file for each
  472. disk, and each of these DISKx files contains files that make up your
  473. application. So, though your files are not compressed, they are still
  474. packed, or "combined" into one file for each distribution diskette) and
  475. copied onto the end-user's hard drive without using INSTALL to do so. To
  476. further protect your interests, the packed ("combined") file is also
  477. encrypted so even if the best of hackers could figure out how to unpack our
  478. formats, they would first have to figure out how to decrypt the file!
  479.  
  480.  
  481.  
  482.  
  483.      You would choose 'Just Encryption' if you did not want to use compression
  484. on your files, and if you wanted to speed up the process of preparing your
  485. disk(s) for distribution.
  486.  
  487.      'Just Compression' - The default mode, using 'Just Compression', the
  488. INSTALL program goes through all of the files within a given directory that
  489. you have selected for use in your application and compresses each file. This
  490. is done before the packing of the DISKx files that will be placed on each
  491. distribution diskette.
  492.  
  493.      We use the .LZH compression technique from TurboPower Software's
  494. Async Professional <tm> toolkit. This technique is as good as most any other
  495. on the market today. However, it is not as fast as others (like PkZip <tm>).
  496. Depending on the number and size of the files you have selected for your
  497. application (we'll get into how to do this when we return to working with
  498. the screen in Figure #5), this could take some time. On one beta site, we
  499. selected a subdirectory with over 436 files in it, totalling some 8.7
  500. megabytes in uncompressed form. It took just over 30 minutes for Program
  501. Installer to complete the compression of all the files, and prepare the four
  502. DISKx files. We elected to use Encryption and Compression for this test,
  503. really putting the program through its paces. It performed quite well.
  504. Although, it took this long to create the DISKx files for distribution,
  505. when installing your application, Program Installer takes only minutes,
  506. depending on the speed of the end-user's hard drive. The installation
  507. and extraction of the DISKx files takes only a few minutes compared to the
  508. time it takes the program to create these files initially. We really
  509. cannot explain in simple terms why this is so.
  510.  
  511.      'Both Encryption and Compression' - Select this option to encrypt the
  512. compressed DISKx files you are setting up for distribution. Here again,
  513. the encryption is just an added feature/measure to help protect your
  514. interests.
  515.  
  516.      Once you have selected which of these three features to use, press
  517. the <TAB> key on your keyboard and you will jump to the 'Maximum Disk Size'
  518. window. Notice that the boarder around the window you are in is a double-line
  519. boarder, and the other windows have single-line boarders around them. This
  520. is one way you can quickly determine which window you are currently in.
  521.  
  522.      Here, using the <Up> or <Down> cursor keys again, you
  523. specify which size floppy diskette you are using for your distribution
  524. disks. The only thing Program Installer won't take care of for you, is
  525. the formatting of these floppy diskettes. You must make sure, that when
  526. Program Installer prompts you for a floppy disk, no matter which size you
  527. elect to use, the floppy must be formatted before Program Installer can
  528. place any files on it. And the floppy must be complete blank, with not even
  529. the system boot files on it (except for the very first - INSTALL - diskette).
  530.  
  531.      Next, press the <TAB> key again, and you will go to the 'Autoexec.bat
  532. and Config.sys Options' window. Here you can specify 1, 2, or all 3 of 3
  533. available options.
  534.  
  535.  
  536.  ■■■ NOTICE - SEE UPDATE INFO ON THIS AT THE END OF THIS DOC ■■■
  537.  
  538.      'Update AUTOEXEC.BAT with installation path?' - If you press the
  539. <Space-Bar> while the cursor is on this option, you will see an 'X' appear
  540. between the brackets. This options tells Program Installer to update the end-
  541. user's AUTOEXEC.BAT file PATH command line with the path (complete drive,
  542. subdirectory name, etc.) that the user specified for installing your
  543. application (later in this document, we'll cover that actual installation
  544. procedure that the end-user performs and how it operates). This is specified
  545. at the time the user installs (runs INSTALL) your application. Leave this
  546. option blank (default) if you do NOT want the installed subdirectory of your
  547. application's path included in the end-user's system's PATH statement.
  548.  
  549.      'Update AUTOEXEC.BAT with SET= 'VARIABLES'?' - This option is provided
  550. for developers of applications like those done with CLIPPER. Here, the
  551. end-user would have to update their own AUTOEXEC.BAT file with a
  552.  
  553.         SET variablename = \APPLICATION DIRECTORY
  554.  
  555. for CLIPPER to properly find itself during runtime. Other applications may
  556. use environment variables as well, and may need environment SET variables
  557. added to the AUTOEXEC.BAT file. Program Installer allows you to define up to
  558. three (3) such variables (see the '"Set" Variables' window, next).
  559.  
  560.      'Update CONFIG.SYS with user defined information?' - Like the SET= VARIABLES
  561. option, this option will allow you to define up to three (3) lines of
  562. information that will be appended to the end-user's CONFIG.SYS file. Like with
  563. the SET= VARIABLES option, this may be necessary for some applications. Quite
  564. often, many DOS installation programs and other applications do not set
  565. parameters in a CONFIG.SYS file like the FCBS= or the STACKS= parameters.
  566. However, your application may need these set a specific way. You can define
  567. the line, exactly as it must appear, and up to three (3) of these lines,
  568. in the 'CONFIG.SYS Info' window.
  569.  
  570.      Press <TAB> again and the cursor goes to the 'Allowed installations
  571. (1 to 255; Enter 0 for unlimited):' field. This is provided as an added measure,
  572. again, to help protect your interests. You can set this to say, 2, and then
  573. INSTALL will only allow itself to be run twice for this configuration. Now,
  574. if the user begins the INSTALL process and aborts, that doesn't count. Only
  575. if they complete a successful installation will it count. So, if you only
  576. want your application to be able to be installed once or twice, set this to
  577. 1 or 2, respectively. Of course, this doesn't stop them from making disk copies
  578. of your application initially, but it is a deterent!
  579.  
  580.  
  581.      Program Installer keeps a log of everything it does for your given
  582. configurations. It creates a directory called #_PI.DIR, in the directory/
  583. path you specify (or off of the root of C:\ as it defaults for) and in this
  584. directory it maintains its log file, and also uses this directory to build
  585. or compress the disk files that are to be prepared for your distribution
  586. disks. So, if you just leave the default, or change it to a drive letter
  587.  
  588.  
  589.  
  590. of your choice, but don't specify a subdirectory, just a root directory,
  591. you will find the #_PI.DIR subdirectory created off of the root directory
  592. after you have completed setting up a set of distribution diskettes. In
  593. this subdirectory you will also find a PI_x.LOG file, where x is the
  594. number of the log. Program Installer looks for the existence of a log file
  595. in its work directory before beginning. If, for example, you run Program
  596. Installer for the first time, it creates the PI_0.LOG file in the work
  597. directory (#_PI.DIR in this case). Now, if you don't delete the log file/
  598. work directory, the next time you run Program Installer, if you use the
  599. same work directory, it will see the PI_0.LOG file, and name the next one
  600. PI_1.LOG, and so on.
  601.  
  602.      Pressing <TAB> from here, you go to the '"Set" Variables' window. Here
  603. is where you can define environment variables that you want inserted into the
  604. end-user's AUTOEXEC.BAT file. NOTE: In this window you type only the name
  605. of the environment variable, and nothing else. Program Installer knows how
  606. to handle the rest of the syntax. For example, if you need the line
  607.  
  608.                 SET MYPATH=directoryname/path
  609.  
  610. all you need to type here is 'MYPATH' in this window. Program Installer will
  611. set it equal to the subdirectory that your application gets installed into.
  612. This is determined by the INSTALL program at runtime, when the end-user is
  613. actually installing your application. So, if you need this to be a GIVEN sub-
  614. directory, be sure to include the subdirectory name in your documentation to
  615. the end-user.
  616.  
  617.      NOTE: Any variable you need defined will only be set to the installation path
  618. and this is hard coded for now. We're working on incorporating a more flexible
  619. option that'll allow you to actually type in the complete SET= statement
  620. yourself, hence allowing you to point to perhaps your own TEMP subdirectory,
  621. or some other work directory, other than the primary installation sub-
  622. directory. This feature should be available in one of the minor 4.x updates
  623. that'll be posted in the next month or two.
  624.  
  625.      Press <TAB> once more and you'll move to the 'CONFIG.SYS Info' window.
  626. Here you can add up to three (3) additional lines for parameter definitions
  627. in the end-user's CONFIG.SYS file. Something like
  628.  
  629.         FCBS=16,32
  630.  
  631. or
  632.  
  633.         STACKS=0,0
  634.  
  635. or whatever you may need to be sure has been set in the CONFIG.SYS. NOTE: If
  636. you do define something here that may already be defined in the end-user's
  637. CONFIG.SYS file, Program Installer will detect this, and then determine if
  638. the end-user's system is configured equal to, or greater than your specks.
  639. This applies to things like FILES= or BUFFERS=. If you type these into this
  640. window now as, for example, FILES=30 and BUFFERS=25 (on two separate lines in
  641. this window, of course), then Program Installer will first check to see if
  642.  
  643.  
  644.  
  645. these parameters are not already defined in the CONFIG.SYS. If they are not,
  646. your lines will be inserted. If these two parameters are already defined,
  647. however, the values of your lines will be compared with the values already
  648. in the CONFIG.SYS file. If yours are greater, in this case, your lines
  649. will be written into the file, and theirs will be removed.
  650.  
  651.      A case that the greater does NOT replace what is already in the
  652. CONFIG.SYS file is with the STACKS= parameter. If you define this
  653. parameter in this window, and if it already exists in the end-user's
  654. CONFIG.SYS file, then yours will be written to the file anyway! Also,
  655. if you enter the SHELL= statement in this window, Program Installer WILL
  656. compare the environment space indicated with the /E: /P switches, and if
  657. you are allocating more space than may already be allocated, then your
  658. line will replace whatever may already be in the CONFIG.SYS file.
  659. If there is not a SHELL= statement in the CONFIG.SYS file, then of
  660. course, your line will be inserted. However, if you are, for example,
  661. allocating 256K of environment space, when there is already 512K of
  662. environment space allocated, then your line will be ignored.
  663.  
  664.      There are a lot of caveats, we know, that we will try and
  665. enhance/dress-up as we gradually update the program. For now, we
  666. hope these configuration options are adequate.
  667.  
  668.      Once you have set all of your options in this screen, you can save
  669. this setup by pressing <Ctrl-Enter> (hold down the CONTROL/Ctrl key and
  670. pressing ENTER). If you need to edit your setup, use the <TAB> key to
  671. navigate the screen and make any necessary changes. To abort altogether
  672. you can press <Esc> to abort.
  673.  
  674.      Once you save your options, you are returned to the work screen,
  675. as previously shown in Figure #5. You should see a screen similar to the
  676. following:
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700. ╔═════════════════╣ C:\ ╠══════════════════╗╔═══════════════════ 1:01:34 a.m. ═╗
  701. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  702. ║──────────────────────────────────────────║║──────────────────────────────────║
  703. ║  AM          │SUB-DIR│ 1-18-92│ 1:39p    ║║                                  ║
  704. ║  APRO        │SUB-DIR│12-22-91│10:07a    ║║                                  ║
  705. ║  ART         │SUB-DIR│ 1-15-92│ 2:04p    ║║                                  ║
  706. ║  CHATBOX     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  707. ║  CPUP        │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  708. ║  CUP         │SUB-DIR│12-27-91│ 9:57a    ║║                                  ║
  709. ║  DV          │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  710. ║  DWORKS      │SUB-DIR│12-22-91│10:09a    ║║                                  ║
  711. ║  EZTAPE      │SUB-DIR│12-22-91│ 9:22a    ║║                                  ║
  712. ║  FAST        │SUB-DIR│12-22-91│10:25a    ║║                                  ║
  713. ║  NEWSWORK    │SUB-DIR│ 1-04-92│ 5:42a    ║║                                  ║
  714. ║  NWLITE      │SUB-DIR│ 1-03-92│ 7:08p    ║║                                  ║
  715. ║  OFFLINE     │SUB-DIR│12-22-91│ 9:40a    ║║                                  ║
  716. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  717. ║ Select files or directories to archive                                       ║
  718. ╠══════════════════════════════════════════════════════════════════════════════╣
  719. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  720. ║                               PI Directory: C:\                              ║
  721. ╠══════════════════════════════════════════════════════════════════════════════╣
  722. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  723. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  724. ╚══════════════════════════════════════════════════════════════════════════════╝
  725. --------------------------------------------------------------------------------
  726.  Figure #6
  727.  
  728.  
  729.      From this work screen we will instruct Program Installer as to the files
  730. that make up your entire application. What we've done here is pretty straight
  731. forward. However, before we get into using this screen to build the
  732. distribution diskettes, let's briefly go over the menu options at the bottom
  733. of the screen in Figure #6.
  734.  
  735.      <+, -, Space> Means that you can use the PLUS and MINUS keys on your
  736. ten-key key pad (this is on the right side of the keyboard on 101 or newer
  737. enhanced keyboards) to mark or unmark individual files for packing. If you
  738. do not have an enhanced keyboard, with the ten-key keypad on the right side,
  739. you can use the <Space-Bar> if/when you need to flag a specific group of files,
  740. flagging each one individually.
  741.  
  742.      The <Space-Bar> is better suited for flagging an entire subdirectory
  743. for packing. Let's say all of your application resides in one subdirectory.
  744. Just scroll to that subdirectory and press the <Space-Bar>. You'll see a
  745. √ check mark appear to the left of the directory name, and the specifications
  746. for that flagged directory appear on the right side of the work screen. This
  747. shows what is selected for Program Installer to either compress/encrypt or both
  748. for your distribution diskettes.
  749.  
  750.      The <+> and <-> keys are better suited for selecting a group of files that
  751. reside in a common directory, with say, the same file extension, or something
  752.  
  753.  
  754.  
  755. similar to each file name. For example, if my application is a database system,
  756. and all of the database files must be initialized (already exist) for the
  757. main program to work, then I may want to initialize them now, then select
  758. just the .DBF and .NDX files for packing. If all of these files reside in a
  759. subdirectory where other files reside with a different suffix, I can use the
  760. <+> key to flag just these files.
  761.  
  762.      When you press either the <+> or <-> keys (on the key-pad now!), you
  763. will see a small box appear in the center of the work screen. In the box
  764. the prompt is defaulted for the DOS wildcard '*.*'. Here I could change
  765. this to *.DBF first, then press <Enter>. Then press the <+> key again
  766. and change it to *.NDX. This would select my group of files out of the
  767. many files that could also be residing in the same subdirectory.
  768.  
  769.      Pressing the <+> key prompts you for files/wildcard combinations to
  770. select for packing, and the <-> key prompts you for files to deselect
  771. from your setup work screen.
  772.  
  773.      Likewise, if you have pressed the <Space-Bar> while on a subdirectory
  774. name and have selected it for packing, pressing the <Space-Bar> on that
  775. same subdirectory name again, will deselect all those files for packing.
  776.  
  777.      Let's walk through a cenario here, pretending to build a set of
  778. distribution disks for our product. To make this easy though, lets go
  779. further and pretend that the DOS subdirectory on your hard drive is the
  780. application's installed subdirectory.
  781.  
  782.      If this were the case, simply make sure that all of the files necessary
  783. to the application are installed in this subdirectory. (Mine is called
  784. \PUBLIC\V5.00, but yours may be \DOS or any other name - Just use whatever
  785. subdirectory your DOS system files are installed in.)
  786.  
  787.      In my case, my DOS system files are in a subdirectory that is nested off
  788. of my root directory. To navigate through subdirectories with the work screen,
  789. use the <Up> and <Down> cursor keys to move your cursor, then press <Enter>
  790. when on a subdirectory name that you would like to enter. When you ARE
  791. in a subdirectory, you will see the drive and path that you are in in the
  792. center of the top-left column of the work screen. Also, you will notice that
  793. the very top/first entry in the subdirectory is now not a subdirectory or
  794. file name, but two (2) dots '..' instead. This indicates that you ARE in a
  795. subdirectory, and to get out of the subdirectory, you place the cursor on
  796. these two dots and press enter. This will take you back to the previous
  797. path level. If you were nested down several subdirectories, you would
  798. simply repeat this for each level, until you back all the way out to the
  799. root directory.
  800.  
  801.      Once inside my \PUBLIC subdirectory, I press the <Space-Bar> when the
  802. cursor is on my V5.00 subdirectory. The screen looks like the following:
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810. ╔══════════════╣ C:\PUBLIC\ ╠══════════════╗╔═══════════════════ 1:54:30 a.m. ═╗
  811. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  812. ║──────────────────────────────────────────║║──────────────────────────────────║
  813. ║  ..          │ UP--DIR │12-22-91│ 9:25a  ║║C:\PUBLIC\V5.00\*.*               ║
  814. ║  DOSU        │ SUB-DIR │12-22-91│ 9:25a  ║║                                  ║
  815. ║√ V5.00       │ SUB-DIR │12-22-91│ 9:26a  ║║                                  ║
  816. ║  bw       exe│   117456│ 7-29-91│ 1:52p  ║║                                  ║
  817. ║  bwback   ovr│    39598│ 7-29-91│ 1:52p  ║║                                  ║
  818. ║              │         │        │        ║║                                  ║
  819. ║              │         │        │        ║║                                  ║
  820. ║              │         │        │        ║║                                  ║
  821. ║              │         │        │        ║║                                  ║
  822. ║              │         │        │        ║║                                  ║
  823. ║              │         │        │        ║║                                  ║
  824. ║              │         │        │        ║║                                  ║
  825. ║              │         │        │        ║║                                  ║
  826. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  827. ║ Select files or directories to archive                                       ║
  828. ╠══════════════════════════════════════════════════════════════════════════════╣
  829. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  830. ║                               PI Directory: C:\                              ║
  831. ╠══════════════════════════════════════════════════════════════════════════════╣
  832. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  833. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  834. ╚══════════════════════════════════════════════════════════════════════════════╝
  835. --------------------------------------------------------------------------------
  836.  Figure #7
  837.  
  838.  
  839.      By pressing the <Space-Bar> while on a subdirectories's name, you are
  840. instructing Program Installer to flag ALL of the files in that subdirectory
  841. for packing. That is why you see the \PUBLIC\V5.00\*.* setting in the right
  842. column of the work screen in Figure #7 above. Now, if this were all I needed
  843. to install my application, I could press the <F10> key now, and Program
  844. Installer will begin its work, prompting me as needed for blank floppies, or
  845. to press any key to continue, as it worked to build the distribution disks
  846. for my application. However, let's make it more difficult. Let's say I don't
  847. want ANY of the .COM files out of this directory included in the packing! At
  848. this point I would press <Enter> while my cursor was on the V5.00 subdirectory,
  849. then press the <-> key and replace the default wildcard with *.COM, and press
  850. <Enter>. The screen looks like the following:
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865. ╔═══════════╣ C:\PUBLIC\V5.00\ ╠═══════════╗╔═══════════════════ 2:04:32 a.m. ═╗
  866. ║      Name    │   Size  │  Date  │  Time  ║║ Selected Files for Archiving     ║
  867. ║──────────────────────────────────────────║║──────────────────────────────────║
  868. ║  ..          │ UP--DIR │12-22-91│ 9:26a  ║║C:\PUBLIC\V5.00\*.BAS             ║
  869. ║√ gorilla  bas│    29434│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.CPI             ║
  870. ║√ money    bas│    46225│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.EXE             ║
  871. ║√ nibbles  bas│    24103│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.GRB             ║
  872. ║√ remline  bas│    12314│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.HLP             ║
  873. ║  assign   com│     6399│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.INI             ║
  874. ║  command  com│    47845│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.LST             ║
  875. ║  diskcomp com│    10652│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.PRO             ║
  876. ║  diskcopy com│    11793│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.SYS             ║
  877. ║  doskey   com│     5883│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.TXT             ║
  878. ║  dosshell com│     4623│ 4-09-91│ 5:00a  ║║C:\PUBLIC\V5.00\*.VID             ║
  879. ║  edit     com│      413│ 4-09-91│ 5:00a  ║║                                  ║
  880. ║  format   com│    32911│ 4-09-91│ 5:00a  ║║                                  ║
  881. ╠══════════════════════════════════════════╝╚══════════════════════════════════╣
  882. ║ Select files or directories to archive                                       ║
  883. ╠══════════════════════════════════════════════════════════════════════════════╣
  884. ║    File Style: Both Encryption and Compression; Floppy Disk Size: 1.2 meg    ║
  885. ║                               PI Directory: C:\                              ║
  886. ╠══════════════════════════════════════════════════════════════════════════════╣
  887. ║ <+, -, Space> Mark/Unmark files               <Alt-D> New Drive              ║
  888. ║ <Tab> Archive List      <Alt-S> Options       <F10> Archive       <Esc> Quit ║
  889. ╚══════════════════════════════════════════════════════════════════════════════╝
  890. --------------------------------------------------------------------------------
  891.  Figure #8
  892.  
  893.  
  894.      As you can see, the .COM files have now been deselected (the √ check
  895. mark removed from the left of the filename), and on the right side you now
  896. see a more descritive listing showing what we are going to pack. These
  897. as WE know, are all of the files, except those that end in .COM, out of my
  898. \PUBLIC\V5.00 subdirectory.
  899.  
  900.      Now, to begin the process that will build my distribution diskettes, I
  901. simply press the <F10> key.
  902.  
  903.      What follows, after you press the <F10> key is the compression part, if
  904. you chose to use 'Compression' in your setup. After the compression is done,
  905. Program Installer begins the packing process, packing a number of files into
  906. one (1) or more DISKx files. I have chosen Compression and Encryption in my
  907. setup and now Program Installer is 'Freezing' all of my files. This is the
  908. term used in LZH that tells you the file is being compressed. Once this is
  909. done I see a listing of file names scroll by as Program Installer is packing
  910. as many of the compressed files into DISK1.LZX. If not all of the files will
  911. fit on one (1) 1.2 megabyte 5 1/4" floppy, Program Installer goes on to
  912. packing the DISK2.LZX file for my System Disk 2 (distribution diskette).
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.      Once all of the compressing and packing is done, I then see the
  921. DISK1 and DISK2.LZX files being encrypted. After this, I am instructed that
  922. my setup will need three completely blank foppy diskettes. The first floppy is
  923. the INSTALL program. Also, if I have any README.DOC or other such files,
  924. Program Installer will install them from this first INSTALL diskette for me
  925. when the end-user runs INSTALL. The next two floppies are the DISK1.LZX and
  926. DISK2.LZX.
  927.  
  928.      The .LZX is Program Installer's way of knowing that this is not only
  929. a compressed, but also an encrypted diskette. We use three types of
  930. file suffix names (extensions):
  931.  
  932.         .X      This extension is used for 'Encryption Only'.
  933.         .LZH    This extension is used for 'Compression Only'.
  934.         .LZX    This extension is used for 'Encryption & Compression'.
  935.  
  936.      These file extensions are added to the DISKx file for each distribution
  937. floppy diskette. The actual files that you select for distribution have
  938. nothing to do with our own file extensions.
  939.  
  940.      Finally, one additional option in the Options Menu of the work screen
  941. in Figure #8 is <Alt-D>. Pressing <Alt-D> allows you to select a different
  942. hard drive to work with for selecting (tagging) files for packing for your
  943. distribution diskettes.
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.                  WRAPPING UP THE CONFIGURATION OPTIONS
  977.  
  978.  
  979.      That just about covers it from start to finish, insofar as the
  980. configuration options are concerned.
  981.  
  982.      You will want to work with the configuration options to become
  983. even more familiar with Program Installer's nice, built-in, setup screens.
  984. After you have configured and distributed a couple of products, you will
  985. find Program Installer quite easy and fast to work with.
  986.  
  987.      If you need any help at all, we offer various levels of technical
  988. support. Next we're going to briefly cover the actual INSTALL program
  989. from the end-user's standpoint.
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.                       INSTALLING YOUR APPLICATION
  1031.                        The End-User's Perspective
  1032.  
  1033.      The following documentation is provide to help you, the Developer, or
  1034. Distributor with some ideas on how to document your own manual, insofar as
  1035. covering the installation procedure. You are free to reproduce or use any of
  1036. the following, in any form or fashion, in any/all of your own documentation
  1037. for your own applications.
  1038.  
  1039.  
  1040.                               INSTALLATION
  1041.  
  1042.      To install your application, simply place the INSTALL system diskette
  1043. in either the 'A' or 'B' drive. Next, change to that drive and type INSTALL.
  1044.  
  1045.      This example will assume that you are using the 'A' drive, but if you
  1046. are using the 'B' drive, simply replace any reference to 'A' in the following,
  1047. with 'B'.
  1048.  
  1049.      To change to the 'A' drive, from the DOS prompt you type
  1050.  
  1051.         A: <Enter> - <Enter> means to press the enter / return key
  1052.                       on your keyboard.
  1053.  
  1054. Then type INSTALL and press <Enter> again. You should see the following screen:
  1055.  
  1056.  
  1057.  
  1058. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1059. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1060. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1061. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1062. ░░░░░░░░░░░░░░░░▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀░░░░░░░░░░░░░░░░░
  1063. ░░░░░░░░░░░░░░░█    Program Installer - Main Menu    ░░░░░░░░░░░░░░░░░
  1064. ░░░░░░░░░░░░░░░█─────────────────────────────────────░░░░░░░░░░░░░░░░░
  1065. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1066. ░░░░░░░░░░░░░░░█     1    Install Program Disk(s)    ░░░░░░░░░░░░░░░░░
  1067. ░░░░░░░░░░░░░░░█     2    Exit Install Program       ░░░░░░░░░░░░░░░░░
  1068. ░░░░░░░░░░░░░░░█                                     ░░░░░░░░░░░░░░░░░
  1069. ░░░░░░░░░░░░░░░████████████████████████████████████░░░░░░░░░░░░░░░░░░░
  1070. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1071. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1072. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1073. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1074. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1075. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1076.   Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.
  1077. ______________________________________________________________________
  1078.  Figure #9
  1079.  
  1080.      At this point you want to choose option 1) Install Program Disk(s).
  1081. This will bring up the next screen, where you will be prompted to enter the
  1082. source drive you are using. The source drive is the floppy drive that you
  1083. inserted the INSTALL diskette in.
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089. ░░░░░░░░░░░░░░░░░┌───────────────────────────────────────────┐░░░░░░░░░░░░░░░░░░
  1090. ░░░░░░░░░░░░░░░░░│      Program Installer Version 4.5        │░░░░░░░░░░░░░░░░░░
  1091. ░░░░░░░░░░░░░░░░░└───────────────────────────────────────────┘░░░░░░░░░░░░░░░░░░
  1092. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1093. ░░┌─────────────────────────────────────────────────────────────────────────┐░░░
  1094. ░░│    Copyright (C) 1990..1992 The DataWorks, Inc.   All Rights Reserved.  │░░░
  1095. ░░└─────────────────────────────────────────────────────────────────────────┘░░░
  1096. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1097. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1098. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1099. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1100. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1101. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1102. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1103. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1104. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1105. ░░░░░░░░░░╔════════════════════════════════════════════════════╗░░░░░░░░░░░░░░░░
  1106. ░░░░░░░░░░║ Enter the SOURCE drive to use:  A                  ║░░░░░░░░░░░░░░░░
  1107. ░░░░░░░░░░╚════════════════════════════════════════════════════╝░░░░░░░░░░░░░░░░
  1108. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1109. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1110. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1111. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1112. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1113. [Enter] - Select    [Esc] - Quit                                             
  1114. ________________________________________________________________________________
  1115.  Figure #10
  1116.  
  1117.  
  1118.      Here you can either press <Enter> to accept the default drive, or enter B
  1119. to replace the default of A, and then press <Enter>.
  1120.  
  1121.      Next you will see the same screen, except you are being prompted to enter
  1122. the destination directory to install the application into. Program Installer
  1123. already has a default directory built in, and you can just press <Enter> to
  1124. accept the default of 'C:\', or replace the C:\ with the proper drive letter
  1125. of your choosing.
  1126.  
  1127.                      NOTE TO DEVELOPER/DISTRIBUTOR
  1128.  
  1129.      When you configure Program Installer, and then from the work screen,
  1130. select the subdirectory(s) to pack your program disk(s) from, Program Installer
  1131. retains that subdirectory(s) name and will install back into that same
  1132. directory(s) on the end-user's system. This is important to note, as you
  1133. need to be sure that you have your application set up exactly as it will need
  1134. to be on the end-user's system when it installs. Hence the end-user really
  1135. only needs to press <Enter> at the default prompt of C:\ for the destination
  1136. directory to install into, unless they are installing onto a different
  1137. hard drive.
  1138.  
  1139.     If you need to, feel free to call our technical support for more information
  1140. on how Program Installer works in this regard.
  1141.                   END OF NOTE TO DEVELOPER/DISTRIBUTOR
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.            SPECIAL NOTE ON AUTOEXEC.BAT and CONFIG.SYS FILES
  1148.  
  1149.  
  1150.      The install program may need to modify some variables in your AUTOEXEC.BAT
  1151. file, and parameters in your CONFIG.SYS file.
  1152.  
  1153.      Depending on your application, INSTALL may need to add this program's
  1154. subdirectory to your PATH statement, may need to SET variable names for your
  1155. DOS environment so it can find itself or work space it may need, and it may
  1156. need to check and/or add parameters like FILES= and/or BUFFERS= statements
  1157. to your CONFIG.SYS file. However, you will want to check these files after
  1158. INSTALL has completed installation, and be sure INSTALL placed the following,
  1159. or verified that the following already exists in these two files.
  1160.  
  1161.         for AUTOEXEC.BAT
  1162.                         SET=
  1163.                         SET=
  1164.                         SET=
  1165.                         PATH=
  1166.  
  1167.         for CONFIG.SYS
  1168.                         FILES=
  1169.                         BUFFERS=
  1170.                         STACK=
  1171.                         FCBS=
  1172.  
  1173.                     NOTE TO DEVELOPERS/DISTRIBUTORS
  1174.  
  1175.      The above is simply provided to help you with your documentation. Only
  1176. YOU know how your application should be installed, and what parameters/variables
  1177. may need to be set in the AUTOEXEC.BAT or CONFIG.SYS files. I've provided this
  1178. brief documentation for you to give you some ideas on how to conclude the
  1179. installation part of your application's documentation. What you actually place
  1180. here, if anything, depends entirely on your needs, and configuration.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.                               WRAPPING UP
  1206.  
  1207.  
  1208.      At this point, we at DataWorks hope that this documentation is enough
  1209. for you to not only use Program Installer for your application, but to use
  1210. it to its fullest extents for all of your applications, however many you
  1211. may have. Also, we hope we have provided enough information concerning the
  1212. installation process so that you can easily and quickly write up the installation
  1213. documentation part of your manual/documentation for your application.
  1214.  
  1215.      The DataWorks, Inc. is a software development corporation. We are NOT a
  1216. software distribution company in the commercial sense. We do a lot of 3rd
  1217. party development, but on a much larger scale than this. We are not technical
  1218. writers (those who write the fancy user's manuals, etc.). We simply know how
  1219. to produce professional, high-quality software. At the same time, though, some
  1220. of us get the opportunity to produce a small, simple application like
  1221. Program Installer, and we hope you like it - in spite of how brief this
  1222. manual may be!
  1223.  
  1224.      And remember, Technical Support is only a phone call away, or a message
  1225. away on our Tech Support BBS (DataWorks BBS!).
  1226.  
  1227.  
  1228.  
  1229. 03/92
  1230.  
  1231.         We also fixed the problem that occurred when you declared say,
  1232. FILES=60 to be inserted into the CONFIG.SYS file. Program Installer 4.5
  1233. DOES properly determine if anything you are wanting to insert into the
  1234. CONFIG.SYS file is going to degrade the current configuration of the
  1235. CONFIG.SYS file, and if so, it won't insert your declarations.
  1236.  
  1237.  
  1238.  
  1239.  
  1240. 04/92
  1241.  
  1242.         With the official release of Program Installer 4.5 there are
  1243. several subtle changes to the setup screens.
  1244.  
  1245. FEATURES
  1246.  
  1247.         With version 4.5 you can now create and compress an application
  1248. that you only need one diskette for, and Program Installer will attempt
  1249. to place this application on the first diskette, if it will fit. If the
  1250. application will not fit, Program Installer will place as much of the
  1251. application on the first disk as possible and then prompt for however
  1252. many disks are needed from that point on.
  1253.  
  1254.         Program Installer now allows you, the programmer, to also type
  1255. in full/complete lines that will be inserted into or appended into the
  1256. end-user's AUTOEXEC.BAT file. Previously you could only declare SET
  1257. variables to be inserted into the AUTOEXEC.BAT file.
  1258.  
  1259.      *** IMPORTANT ***       *** IMPORTANT ***       *** IMPORTANT ***
  1260.  
  1261.  
  1262.         Up to version 4.0, when the end-user was running INSTALL,
  1263. Program Installer, during the installation process, prompted the user
  1264. for the destination directory. With this release, Program Installer
  1265. assumes that the directory structure you built your installation
  1266. diskettes from is the same that you want to install to. If not, then you
  1267. will need to reconfigure, place all of the distribution files in the
  1268. directory structure the way you want the final product to turn out after
  1269. installation, and then re-build your distribution diskette(s).
  1270.  
  1271.  
  1272. 11/92
  1273.  
  1274. Released the BETA (a release) of Version 4.8.
  1275.  
  1276.  
  1277. 01/93
  1278.  
  1279.  
  1280. Released Version 4.9. With this release we have corrected the problem,
  1281. ENTIRELY, with the TITLE replacement feature.
  1282.  
  1283. Also, we are incorporating the DISK-SENSE feature. Here we check to be
  1284. sure the end-user's hard drive has sufficient space to copy the
  1285. distribution files to before extracting the .LZH archives. If the
  1286. end-user's HD is too full/doesn't have enough space, the application
  1287. files are extracted automatically from the distribution diskettes.
  1288.  
  1289.  
  1290.                            SPECIAL NOTICE!!!
  1291.  
  1292. Version 5.0 is scheduled for release in about 4 weeks (March 1, 1993).
  1293. WIth this release we will have completed the DISKCOPY copy-protection
  1294. schemes - promised for so long now!!!
  1295.  
  1296. Also, we are scheduling the release of the Windows 3.x support
  1297. installation methods, as well as the OS/2 2.x CONFIG.SYS/OS2 methods.
  1298.  
  1299. Thank you again for your support!
  1300.  
  1301.