home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / imp1_1.zip / IMP_HELP.TXT next >
Text File  |  1995-07-19  |  18KB  |  296 lines

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