home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / instai.zip / AIHLP.INF (.txt) next >
OS/2 Help File  |  1996-07-12  |  52KB  |  264 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About AI's Installer ΓòÉΓòÉΓòÉ
  3.  
  4. AI's Installer 
  5.  
  6. Version 1.0 - by Antonino Iannella, July 12th, 1996 
  7.  
  8. AI's Installer is a software installer, which uses standard REXX functions with 
  9. a PM interface. Please choose a section below. 
  10.  
  11. Contents 
  12.  
  13.      Who this is for 
  14.  
  15.      Usage demonstration 
  16.  
  17.      Creating your own installation routine 
  18.  
  19.      Registration 
  20.  
  21.      Contacting the author 
  22.  
  23.      Revision history 
  24.  
  25.      FTP and BBS site documentation 
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 2. Who this is for ΓòÉΓòÉΓòÉ
  29.  
  30. AI's Installer is a software installer for OS/2 applications. It utilises 
  31. existing REXX functions, and adds an intuitive PM interface. The installation 
  32. program may be customised for the application it installs. AI's Installer was 
  33. designed to facilitate installation programs by providing a robust, quality 
  34. utility which inherits all the benefits of REXX programming. 
  35.  
  36. Software developers benefit because they customise an existing, functional 
  37. installer for their own purposes. End users benefit from using a simple, 
  38. intuitive method to add new software. 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 3. Usage demonstration ΓòÉΓòÉΓòÉ
  42.  
  43. You must have OS/2 Warp (or above) and REXX installed. The installer is 
  44. distributed for installing the sample program, Example. 
  45.  
  46. Activate InstAI.exe. This is the standard installer user interface. 
  47.  
  48. The installation process is 
  49.  
  50.    1. Choose an appropriate directory to install Example to. By default, the 
  51.       \OS2\APPS directory is chosen. The user also may choose a different 
  52.       target by selecting Other directory. 
  53.  
  54.    2. Choose whether to create a desktop object. The installer is designed to 
  55.       create a Program object. 
  56.  
  57.    3. Press Install to commence the installation. A message box appears on the 
  58.       success of the installation. The installer exits if the installation was 
  59.       successful. 
  60.  
  61.    4. Pressing Cancel at any time aborts the installer. No action is taken. 
  62.  
  63.    5. Pressing the big OS/2 logo informs the user of the application they are 
  64.       installing. This may be used to provide on-line help. 
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 4. Creating your own installation routine ΓòÉΓòÉΓòÉ
  68.  
  69. If you think AI's Installer will be ideal for your application, then feel free 
  70. to use it. However, please register with the author! 
  71.  
  72. To use AI's Installer, you should be reasonably familiar with OS/2 REXX and Dr 
  73. Dialog. Dr Dialog is a GUI creation tool made available through the IBM EWS. It 
  74. is commonly distributed with the Developer's Connection CD-ROMs from IBM. 
  75.  
  76. Steps for creating a simple installation program 
  77.  
  78.      Activate InstAI.Res with Dr Dialog, hopefully via its popup menu, or 
  79.       manually loading it by starting Dr Dialog first. 
  80.  
  81.      An outline of all the Installer's widgets will appear. Open the Global 
  82.       Procedures section of the notebook. Open the UserDefine procedure. 
  83.  
  84.      AI's Installer relies on the all the variables in this procedure. 
  85.       Initialise them as follows 
  86.  
  87.             ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  88.             ΓöéVariable       ΓöéUses                            ΓöéExample                              Γöé
  89.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  90.             ΓöéProduct        ΓöéThe software's product name     ΓöéExample                              Γöé
  91.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  92.             ΓöéDesktopName    ΓöéThe label of the desktop object ΓöéExample application                  Γöé
  93.             Γöé               Γöécreated for the user to start   Γöé                                     Γöé
  94.             Γöé               Γöéthe application                 Γöé                                     Γöé
  95.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  96.             ΓöéExename        ΓöéThe name of the executable, usedΓöéEx.exe                               Γöé
  97.             Γöé               Γöéfor the desktop object          Γöé                                     Γöé
  98.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  99.             ΓöéWaitString     ΓöéThe string displayed while the  ΓöéPlease wait, installing...           Γöé
  100.             Γöé               Γöésoftware is installing          Γöé                                     Γöé
  101.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  102.             ΓöéSAuthor        ΓöéThe software house name         ΓöéAntonino Iannella                    Γöé
  103.             Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  104.             ΓöéInform         ΓöéUsed by the About the Author    ΓöéProduct "v1.0 (C) 1996 by" SAuthor   Γöé
  105.             Γöé               Γöédialog box. It is automatically Γöé                                     Γöé
  106.             Γöé               Γöéset, as shown in the example.   Γöé                                     Γöé
  107.             ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  108.  
  109.      Now edit the Click event handler for the Install button. The code to edit 
  110.       lies half way down. It is reproduced here. By following the example, 
  111.       necessary application files may be copied to the target directory, 
  112.       defined as DirInstall. 
  113.  
  114.             /* ------------------------------ */
  115.  
  116.             /* Here is where the necessary files
  117.                are copied to the target directory,
  118.                DirInstall. The variable 'rc' is 0 if
  119.                the installation completed sucessfully. */
  120.  
  121.                Copy "Ex.exe" DirInstall
  122.  
  123.             /* ------------------------------ */
  124.  
  125.       If the installer appears to not install anything while running it through 
  126.       Dr Dialog (by pressing F5), use commands like 
  127.  
  128.                Copy ".\Ex.exe" DirInstall
  129.  
  130.       The installer will still work when it is completed. 
  131.  
  132.      Naturally, registered users are free to modify and use AI's Installer as 
  133.       they see fit. Hopefully, they will provide the author with valuable ideas 
  134.       on how to improve it! 
  135.  
  136.      Now choose 'Save As...' from the File menu and save the installer to your 
  137.       own installer name, like Rideinst.RES. 
  138.  
  139.      Create your own icon or edit InstAI.ICO for the installer. It must have 
  140.       the same name as the installer, like Rideinst.ICO. 
  141.  
  142.      Hopefully, your new installer will successfully install your application. 
  143.       Drop the .RES object onto the RestoEXE object in your Dr Dialog folder. 
  144.       This will create an installer executable. You must distribute the 
  145.       executable, your .ICO file (it is still needed), and the InstAI.DLL file 
  146.       with your application. 
  147.  
  148.      Enjoy your nice, new installer! 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 5. Registration ΓòÉΓòÉΓòÉ
  152.  
  153. AI's Installer is provided as a fully-functional product, with no limitations. 
  154. However, it is shareware.  If you intend to use this product as part of your 
  155. own, or to create a derivative work, please be kind enough to register by 
  156. sending 
  157.  
  158. $5 Australian for each application that uses it 
  159. $10 Australian for lifetime use for any applications 
  160.  
  161. to the author. This will ensure that precious development efforts will 
  162. continue. In return, you will receive excellent customer support, for any query 
  163. or problem. Those with lifetime registration will be notified of new releases 
  164. and be registered to use them. 
  165.  
  166. AI's Installer remains the property of the author.  It is freely distributable 
  167. on any medium or site. All files from the archive must be intact when 
  168. distributed. I do not guarantee the software's reliability, although I would 
  169. appreciate being informed of any problems anyone may have. Any damage or loss 
  170. incurred as a result of using this software is NOT the author's responsibility. 
  171.  
  172. Microsoft employees and their families must pay US$1 000 000 in registration 
  173. for every copy they possess, for any application which uses AI's Installer. 
  174. They will receive free upgrades. 
  175.  
  176. Trademarks 
  177.  
  178. All trademarks mentioned herein are the property of their respective owners. 
  179.  
  180.  
  181. ΓòÉΓòÉΓòÉ 6. Contacting the author ΓòÉΓòÉΓòÉ
  182.  
  183. Send all comments, bug reports, or suggestions for improvement to 
  184.  
  185.         ****    ****       *  ****  Operate at a higher level.
  186.       *    *  *    *     *  *    *
  187.      *    *  *         *       *    Mr Antonino Iannella
  188.     *    *   ****    *      *       Computer Systems Engineering
  189.    *    *  *    *  *     *          9308390r@lux.levels.unisa.edu.au
  190.    ****    ****  *      ******      http://members.tripod.com/~antonino/index.html
  191.  
  192.  Would you fix your house if the windows need replacing?
  193.  So why not fix your computer by replacing its Windows?
  194.  
  195. Send registration payments by mail to 
  196.  
  197. Mr Antonino Iannella
  198. 6 Bolingbroke Avenue
  199. DEVON PARK SA 5008
  200. AUSTRALIA
  201.  
  202. Phone + 61 8 346 2742 anytime. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 7. Revision history ΓòÉΓòÉΓòÉ
  206.  
  207. v 1.0 - First release July 12th, 1996.
  208.  
  209. Future plans 
  210.  
  211. Future revisions of AI's Installer will include 
  212.  
  213.      An improved user interface and the ability to find which drive \OS2\APPS 
  214.       lies in 
  215.  
  216.      An uninstallation method, to remove installed applications 
  217.  
  218.      A global installation object for any application installing which needs 
  219.       to be done. 
  220.  
  221.      Built-in handling of a compressed archive to get files from, instead of 
  222.       simply copying them 
  223.  
  224.  
  225. ΓòÉΓòÉΓòÉ 8. FTP and BBS site documentation ΓòÉΓòÉΓòÉ
  226.  
  227. This section has files needed for public domain sites. 
  228.  
  229.      FILE_ID.DIZ 
  230.  
  231.      InstAI.txt 
  232.  
  233.  
  234. ΓòÉΓòÉΓòÉ 8.1. FILE_ID.DIZ ΓòÉΓòÉΓòÉ
  235.  
  236.  
  237. InstAI.zip - AI's Installer
  238. A PM software installer for
  239. developers. Uses REXX functions.
  240. Shareware
  241. Mr Antonino Iannella
  242. 9308390r@lux.levels.unisa.edu.au
  243.  
  244.  
  245. ΓòÉΓòÉΓòÉ 8.2. InstAI.txt ΓòÉΓòÉΓòÉ
  246.  
  247.  
  248.          OS/2 Upload Information Template for ftp-os2.nmsu.edu
  249.  
  250. Archive Name:  InstAI.zip
  251. Program Description: (keep it under 60 characters)
  252.  
  253. A PM software installer for developers. Uses REXX functions.
  254.  
  255. Operating System Versions:   OS/2 3.0 (Warp) and above
  256. Program Source:       none
  257. Replaces:             none
  258.  
  259. Your name:            Antonino Iannella
  260. Your email address:   9308390r@lux.levels.unisa.edu.au
  261.  
  262. Proposed directory for placement:  /pub/os2/dev32 or /pub/os2/dev32/rexx
  263.  
  264.