home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / imp1_1.zip / IMP.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-07-18  |  19KB  |  461 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About IMP ΓòÉΓòÉΓòÉ
  3.  
  4.  IMP is a Install Management Program that will create a list of the files that 
  5. were installed on your system by an application. This gives you the ability to 
  6. know exactly what files the application installed and where they are. IMP will 
  7. also delete these files from your system if you wish to remove the application. 
  8.  
  9.  
  10. ΓòÉΓòÉΓòÉ 2. Main Menu ΓòÉΓòÉΓòÉ
  11.  
  12. Use the choices on the Main Menu to: 
  13.  
  14. Quit 
  15.      Exits the program. 
  16.  
  17. Locator 
  18.      Set IMP to the Locator option. 
  19.  
  20. Remover 
  21.      Set IMP to the Remover option. 
  22.  
  23. Editor 
  24.      Opens the Editor dialog box. 
  25.  
  26. Help Index 
  27.      Displays the Help Index. 
  28.  
  29. Shareware Info 
  30.      Displays the Shareware Information dialog box. 
  31.  
  32. Product Info 
  33.      Displays the Product Information dialog box. 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 3. IMP Locator ΓòÉΓòÉΓòÉ
  37.  
  38.  This option is responsible for finding the files that were installed by an 
  39. application and creating the IMP data file which lists these files. The 
  40. following steps describe the procedure to create a data file. 
  41.  
  42.  1. Install the application that a data file is to be created for. 
  43.  
  44.     Note:  If you attempt to run IMP after you have been using the application, 
  45.     the time/date stamps of the files will be too far apart for a reliable data 
  46.     file to be created. 
  47.  
  48.  2. Run IMP. The Locator option will be selected as the default window 
  49.     configuration. 
  50.  
  51.  3. Push the Source File... button. You will be presented with a file dialog 
  52.     box with which to select an application file as the source file. This 
  53.     source file will be used by the Locator to obtain a time/date stamp. 
  54.  
  55.     The Locator will now fill in the save file and search path entry fields 
  56.     with default values. The directory that IMP is run from is used to store 
  57.     the data file while the folder which contains the source file is used as 
  58.     the search path. If you wish to change these values, follow steps 4 and 5. 
  59.     If these are correct, skip to step 6. 
  60.  
  61.  4. Push the Save File... button. You will be presented with a file dialog box 
  62.     with which to select a save file. You may also type in a name of your own 
  63.     choosing. The extension of .IMP is the default, but is not required. 
  64.  
  65.  5. Push the Search Path button if you are unsure of the proper format of the 
  66.     search path. You will be presented with a dialog box which shows the 
  67.     required format. The search path may contain multiple entries with each 
  68.     path followed by a semi-colon(;). 
  69.  
  70.     Note:  Ensure that you do not reverse the semi-colon(;) and the colon(:). 
  71.     This will create a valid path for the default directory and will not give 
  72.     you a valid search in your desired path. 
  73.  
  74.  6. Set the Time Margin spin button. This value should be greater than the 
  75.     amount of time that was required for the application to install. (i.e. If 
  76.     it took 20 minutes to complete the install, set the time margin for over 20 
  77.     minutes.) 
  78.  
  79.  7. Push the Locate button. You will be presented with the Time/Date Stamp 
  80.     dialog box. 
  81.  
  82.  8. Choose the Time/Date Stamp to be used. These selections are explained 
  83.     below. 
  84.  
  85.    o Last Access This is the most reliable time/date stamp. When the files are 
  86.      first installed, they will all have approximately the same time and date 
  87.      for this stamp. This is the default setting. 
  88.  
  89.    o Last Write This is the second most reliable time/date stamp. When the 
  90.      files are first installed, they will all have approximately the same time 
  91.      and date for this stamp. As the application files are updated (i.e. INI 
  92.      and CFG) these times will begin to differ. 
  93.  
  94.    o Creation This is the least reliable time/date stamp. This time and date 
  95.      are set when the file was first created. If the application took longer 
  96.      than a few hours to write, all the files could have time differences of 
  97.      months or even years. 
  98.  
  99.  9. The Locator will now open the progress dialog and use the search path, 
  100.     time/date stamp, and time margin to find files that match the source file's 
  101.     time/date stamp. As each file is tested, the folder and file name data is 
  102.     updated in the progress dialog box. You may push the Cancel button at any 
  103.     time if you wish to stop the search for some reason. After the search is 
  104.     complete, the progress dialog will close and IMP will display a message to 
  105.     inform you of the results of the search. 
  106.  
  107. 10. Upon successful completion of the file search, you may edit your newly 
  108.     created data file by selecting the Editor from the main menu or delete the 
  109.     files listed in the data file by selecting the Remover from the main menu. 
  110.  
  111. 11. Your IMP data file is now finished. If you wish to create a data file for 
  112.     another application, please wait a short amount of time. This will ensure 
  113.     that the time/date stamps of the two applications are not within the time 
  114.     margin of the new search. 
  115.  
  116.     Note: If your search path is restrictive enough, (i.e. different drives or 
  117.     a search in different folders) then you do not have to wait to install the 
  118.     next application. 
  119.  
  120.  
  121. ΓòÉΓòÉΓòÉ 4. IMP Remover ΓòÉΓòÉΓòÉ
  122.  
  123.  This option is responsible for deleting the folders/files that are contained 
  124. in the IMP data file. The following steps describe the procedure to remove an 
  125. application from your system. 
  126.  
  127.  1. Ensure that you are not using any of the files from the application that is 
  128.     to be deleted. One example of where this could occur is if you desired to 
  129.     remove your screen saver while it was running. This will cause an error in 
  130.     the removal process. 
  131.  
  132.  2. Run IMP. The Locator option will be selected as the default window 
  133.     configuration. 
  134.  
  135.  3. Select Remover from the main menu. This will configure IMP to the Remover 
  136.     option. 
  137.  
  138.  4. Push the Data File... button. This will present you with a file dialog to 
  139.     select the applications data file. Choose the data file of the application 
  140.     you wish to remove. 
  141.  
  142.  5. The remover will now show you the data file you selected in the entry 
  143.     field. 
  144.  
  145.  6. Push the Remove button. This will present you with a message box that will 
  146.     confirm or cancel this action. 
  147.  
  148.     Warning:  Do not start the removal process unless you are sure you want to 
  149.     delete all the entries in the data file. 
  150.  
  151.  7. The Remover will now open the progress dialog box. The Remover then sorts 
  152.     the folders into order by length so that deeply nested folders and files 
  153.     are deleted first. You may not see this message depending on your system 
  154.     speed and the size of the data file. The Remover will display the folder 
  155.     and file names as it attempts to delete them. If the Remover encounters any 
  156.     errors or is unable to delete an entry, you will receive a message box 
  157.     informing you of the condition. Any files or folders that could not be 
  158.     deleted will remain in the data file. If you stop the removal, the files 
  159.     and folders that were not deleted will also remain in the data file. 
  160.  
  161.     Note:  Depending on your system speed and the data file size, it may take a 
  162.     short period of time for the Remover to return control back to IMP. This 
  163.     only occurs with unusually large data files of roughly 200 or more 
  164.     individual folders with their own files. 
  165.  
  166.     Note:  If the Remover deletes files from your system folders, (i.e. a DLL 
  167.     in your OS/2 DLL folder) OS/2 will not allow it to delete the folder due to 
  168.     the folder still containing files. This is normal and does not interfere 
  169.     with the removal process. When the Remover finishes, go to the editor and 
  170.     confirm that all files were removed and only system folders remain. You may 
  171.     then manually delete the folder entry from the data file to complete the 
  172.     removal of the application from your system. 
  173.  
  174.  8. Upon successful deletion of all the files and folders, the Remover will 
  175.     notify you with a message box and delete the empty data file from your 
  176.     system. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 5. Shareware Information ΓòÉΓòÉΓòÉ
  180.  
  181.  IMP was started in December of 94' and took around 6 months to write in my 
  182. spare time. The idea was born from the labors of numerous system formats and 
  183. reinstalls to get rid of old programs. It was also a way to get my feet wet in 
  184. programming for OS/2 with Borland C++. 
  185.  
  186.  This is a fully operational version of IMP and is not 'disabled' while I wait 
  187. on your check. I always found that annoying in the shareware that I was 
  188. currently trying. The shareware concept is pretty easy to understand. If you 
  189. like the program, contribute to the author. If you don't like it, don't use it. 
  190. This way you get the satisfaction of knowing what a program is going to do 
  191. without hearing 'you opened the box, you can't return it even if it doesn't do 
  192. what it advertised'. 
  193.  
  194.  Anyway, I hope that you find this program as useful as I do and if you have 
  195. any questions, comments, or contributions, feel free to contact me through the 
  196. information in the shareware dialog box. 
  197.  
  198.  
  199. ΓòÉΓòÉΓòÉ 6. Product Information ΓòÉΓòÉΓòÉ
  200.  
  201.  This is version 1.0 of IMP. If you would like to contribute to future 
  202. releases, feel free to contact me through the information in the shareware 
  203. dialog box. 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ 7. Warning and Disclaimer ΓòÉΓòÉΓòÉ
  207.  
  208.  This application is a file locating and removing utility. This means that 
  209. after you create a list of files and then remove them, they are deleted from 
  210. your system. 
  211.  
  212.  Before you run IMP, be sure that you have read and understand the following 
  213. sections in the help file: 
  214.  
  215. o Editor 
  216.  
  217. o Locator 
  218.  
  219. o Remover 
  220.  
  221. o Requirements and Limitations 
  222.  
  223. DISCLAIMER OF WARRANTIES: 
  224.  
  225.  This application is provided "AS IS", without warranty of any kind. The author 
  226. shall not be held liable for any damages arising out of the use of this 
  227. program, even if he has been advised of the possibility of such damages. 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ 8. Requirements and Limitations ΓòÉΓòÉΓòÉ
  231.  
  232.  Before you run this application, you should read the following notes 
  233. concerning the execution of IMP. 
  234.  
  235. Files 
  236.  
  237.      The following files comprise the entire IMP application. IMP should be 
  238.      installed into its own folder, but can be run from anywhere. 
  239.  
  240.     IMP.EXE (Main program) 
  241.  
  242.     IMP.HLP (Help file) 
  243.  
  244.     IMP.ICO (Icon file) 
  245.  
  246. Folders in Folders (".IMP.Folder.Holder.") 
  247.  
  248.      If the Locator finds a folder in the search path that contains only 
  249.      folders, it will place the statement ".IMP.Folder.Holder." in the place of 
  250.      the file name. This allows the Locator to keep track of folders which 
  251.      match the search criteria but do not contain any files. 
  252.  
  253.      If the Remover cannot remove a folder it will also place the statement 
  254.      ".IMP.Folder.Holder." in the place of the file name. 
  255.  
  256. HPFS 
  257.  
  258.      The Locator requires the last access, creation, and last write time/date 
  259.      stamps to be available for each file it tests.  This means that IMP will 
  260.      only work with the High Performance File System and will not work 
  261.      correctly with the FAT File System. 
  262.  
  263.      Note:  It is possible to create a simple list of files from a FAT 
  264.      directory if you concentrate the search path to only that folder belonging 
  265.      to the application and select either last access or last write since these 
  266.      values default to the same time and date when viewed from OS/2. You would 
  267.      get the same results if you simply deleted the folder using your OS/2 
  268.      desktop. 
  269.  
  270. Limits on Data File Size 
  271.  
  272.      The maximum number of folders that can be stored in a IMP data file is 
  273.      32767. This is due to using listboxes for display and editing. This limit 
  274.      also applies to the number of files in each folder. This is normally not a 
  275.      problem for most users but is included for use on networks. 
  276.  
  277. Locator and Remover 
  278.  
  279.      Be sure to double check the file list that the Locator creates. If the 
  280.      install program of the source file uses a OS/2 file during its execution, 
  281.      this file could be added to the list. One example of where this would 
  282.      occur is if you specify a drive wide search (i.e. search path=C:\;) on the 
  283.      drive containing OS/2. Another example is where the install program 
  284.      updates your CONFIG.SYS file. If this file is deleted, it will take 
  285.      considerable effort to recover from this mistake. 
  286.  
  287. Networks 
  288.  
  289.      IMP has been successfully run over the IBM Peer Network included with OS/2 
  290.      Warp Connect. This enables Network Administrators to remove an application 
  291.      from an entire Network rather than from one machine at a time. 
  292.  
  293.  
  294. ΓòÉΓòÉΓòÉ 9. Definitions ΓòÉΓòÉΓòÉ
  295.  
  296. This is an alphabetical list of all the definitions and terms used in this 
  297. application. 
  298.  
  299. Creation 
  300.  
  301.      This is a time/date stamp which gives the time and date of when a file was 
  302.      first created. 
  303.  
  304. Data File 
  305.  
  306.      This is the file that the Locator creates to list all the files which 
  307.      belong to an application. This is also the file that the Remover uses to 
  308.      delete an application from your system. 
  309.  
  310. Editor 
  311.  
  312.      This dialog box enables you to edit the data files that you create. It 
  313.      also allows you to convert a data file to an ASCII text file. 
  314.  
  315. Last Access 
  316.  
  317.      This is a time/date stamp which gives the most recent time and date that a 
  318.      file was queried for information, written to, or copied. 
  319.  
  320. Last Write 
  321.  
  322.      This is a time/date stamp which gives the most recent time and date that a 
  323.      file was written to. 
  324.  
  325. Locator 
  326.  
  327.      This option will create a data file which contains a list of files that 
  328.      were installed on your system by an application. 
  329.  
  330. Remover 
  331.  
  332.      This option will remove the files that are contained in an applications 
  333.      data file from your system. 
  334.  
  335. Save File 
  336.  
  337.      This is the data file that the Locator creates to store the list of files 
  338.      that an application has installed on your system. 
  339.  
  340. Search Path 
  341.  
  342.      This is the directory path that the Locator will search when it looks for 
  343.      files that match the time/date stamp of the source file. 
  344.  
  345. Source File 
  346.  
  347.      This is the file that is used by the Locator to get a time/date stamp to 
  348.      compare with other files that are in the search path. 
  349.  
  350. Time Margin 
  351.  
  352.      This is time period in minutes which the Locator uses to compare the 
  353.      time/date stamps of the source file and the files in the search path. If 
  354.      the difference between the two stamps is less than the Time Margin, then 
  355.      the two files are considered to have been installed at the same time. 
  356.  
  357. Time/Date Stamp 
  358.  
  359.      This is a time and date that are assigned to every file on your system. 
  360.      You can view the three types (creation, last access, last write) by 
  361.      opening a drive or folder in the 'details' mode. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 10. Author's Comments ΓòÉΓòÉΓòÉ
  365.  
  366.  The ideal system that IMP prefers is one which just had OS/2 installed onto an 
  367. empty hard drive. This enables IMP to create a data file of all the files that 
  368. belong to OS/2. Then, when you installed a new application, you could compare 
  369. the two data files to determine the owner of any questionable files. These 
  370. 'questionable' files would most likely be a DLL that was added to your OS/2's 
  371. DLL folder or an application's help file added to your OS/2's HELP folder. This 
  372. OS/2 data file would allow you to create and accurately edit data files for the 
  373. applications that you install. 
  374.  
  375.  This is not a very realistic scenario for most users. So, until you find 
  376. yourself back at square one with an empty hard drive and a stack of install 
  377. disks, be very certain of the files you tell IMP to remove from your system. 
  378.  
  379.  Once again, if you have any questions, comments, or contributions, feel free 
  380. to contact me through the information in the shareware dialog box. 
  381.  
  382. Note:  Be sure to check out my Free Advertising help panel. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 11. IMP Editor ΓòÉΓòÉΓòÉ
  386.  
  387. This dialog box allows you to edit your data files or translate your data files 
  388. into ASCII. The following steps describe the procedure to edit your data files. 
  389.  
  390.  1. Run IMP. 
  391.  
  392.  2. Select the Editor from the main menu. The Editor dialog box will open and 
  393.     you will be presented with a file dialog box with which to select the data 
  394.     file you wish to edit. 
  395.  
  396.  3. The Editor will now read the data file and display the folders in the 
  397.     'Folders:' listbox. The Editor will also display any files contained in the 
  398.     selected folder in the 'Files:' listbox. The status box shows what 
  399.     operation the Editor is currently performing. 
  400.  
  401.     Note:  If a folder is empty of files the "Files:' listbox will contain the 
  402.     entry ".IMP.Folder.Holder.". 
  403.  
  404.  4. You may review the folder and file entries by selecting a folder. The 
  405.     Editor will update the files for each folder you select. 
  406.  
  407.     Note:  Depending on your system speed and the data file size, it may take a 
  408.     short period of time for the Editor to update the folder and file 
  409.     information when you make a selection or deletion. This only occurs with 
  410.     unusually large data files of roughly 200 or more individual folders with 
  411.     their own files. 
  412.  
  413.  5. You may remove a folder (and all the files associated with that folder) or 
  414.     a file from your data file by 'double clicking' on the desired entry. You 
  415.     are then presented with a message box to either confirm or cancel your 
  416.     choice. 
  417.  
  418.     Note:  You may turn off these prompts by deselecting the checkmark at the 
  419.     bottom of the dialog box. 
  420.  
  421.  6. You should read the Requirements and Limitations section for details on 
  422.     which files you should remove from your data file. 
  423.  
  424.  7. When you are finished editing your data file you may push the Data --> 
  425.     ASCII button to convert the IMP data file into an ASCII file. The source 
  426.     file extension is changed to 'txt' and is used as the ASCII output file. 
  427.     IMP will sort this ASCII text by folder and then by file to aid in finding 
  428.     an entry quickly. This allows you to print a list of the folders/files 
  429.     found by the Locator or review the folders/files with a text editor of your 
  430.     choice. 
  431.  
  432.     Note:  Depending on your system speed and the data file size, it is a good 
  433.     idea to create the ASCII file to use as a guide when editing the data file. 
  434.     This would save time by eliminating the need to scan through the data file 
  435.     by allowing you to jump to the entries that need deleting. 
  436.  
  437.  8. After you have finished editing your data file, simply push the Data 
  438.     File... button to edit another data file or push the Close button to return 
  439.     to the IMP main menu. 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ 12. Free Advertising ΓòÉΓòÉΓòÉ
  443.  
  444. Here is a list of all the shareware programs that I have written as of when 
  445. this program was released. 
  446.  
  447.  CLIP is a Command Line Interface Program that will organize your command line 
  448. programs. It allows you to create a 'library' of entries which list the command 
  449. line program, arguments for that program, and any required switches that are 
  450. needed. It also allows you to create entries for normal programs. You may then 
  451. select an entry and run it with the touch of a button. 
  452.  
  453.  Available as clip.zip 
  454.  
  455.  STRIP is a command line program that will remove the formatting codes from 
  456. various types of ASCII data files such as *.ipf for help files and *.html for 
  457. World Wide Web home pages. This enables you to read the text without trying to 
  458. decipher the formatting codes and also enables you to use your wordprocessor to 
  459. spell check the file. 
  460.  
  461.  Available as strip.zip