home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / system / inimaint / inihelp.txt < prev    next >
Text File  |  1994-03-12  |  193KB  |  4,446 lines
  1. ************************************************************************
  2. *
  3. * INIHELP.ITL - Information Tag Language file for Help Manager text
  4. *
  5. ************************************************************************
  6. ************************************************************************
  7. * INIMAINT NOT DONE HELP PANEL - This panel is displayed
  8. * for any help item that has not had its help written
  9. ************************************************************************
  10.  
  11. Help for Items not yet done
  12.  
  13. The Help for this item has not yet been written.
  14.  
  15. ************************************************************************
  16. * INIMAINT EXTENDED HELP PANEL - This panel is displayed
  17. * for a help request when no dialogs or message boxes are visible.
  18. ************************************************************************
  19.  
  20. About The Ini File Maintenance Program
  21.  
  22. Ini File Maintenance is a Presentation Manager-based
  23. application which is an utility for the maintenance of the various
  24. OS/2 INI Files.  System Maintenance is an upgrade from IniMaint that
  25. will also process Extended Attributes.  If SysMaint is purchased,
  26. then IniMaint is included, since SysMaint is the more capable
  27. program.  If IniMaint is purchased, then only the INI file code is
  28. activated.  An additional license fee is required to upgrade IniMaint
  29. to SysMaint.
  30.  
  31. The help facility is designed to give a context-sensitive
  32. description of either the current window or the highlighted menu item
  33. within that window.
  34.  
  35. For more information about using the help facility, select
  36. Help for help on the Help pull-down.
  37.  
  38. ************************************************************************
  39. ************************************************************************
  40. ************************   INI HELP   **********************************
  41. ************************************************************************
  42. ************************************************************************
  43. ************************************************************************
  44. ************************************************************************
  45. ************************************************************************
  46. ************************ GENERAL INI HELP ******************************
  47. ************************************************************************
  48. ************************************************************************
  49. ************************************************************************
  50.  
  51. General Help Information
  52.  
  53. There are a number of General area of information that do not
  54. easily fit into any of the other Help categories.  The purpose of
  55. this section is to address these areas.
  56.  
  57.  
  58.  
  59. ************************************************************************
  60.  
  61.  
  62.  
  63. Getting Started Help Information
  64.  
  65. The primary purpose of this section is to help the user who did
  66. not get IniMaint or SysMaint to address a specific problem and one
  67. who is not familiar with the INI Files and Extended Attributes.
  68.  
  69. If you are a new OS2 user or are not familiar with INI Files and
  70. Extended Attributes, then you should first review the various Help
  71. entries that are listed under the See Also category for this Help
  72. item.  These General Help entries will give you an overview of
  73. IniMaint and SysMaint and the environment in which they operate.
  74.  
  75. One of the biggest concerns of those who are not knowledgeable
  76. about OS2 is that they do not want to do something that will damage
  77. their Desktop.  If this is your primary concern, then you should
  78. start with IniSafe or SysSafe.  Both of these have all of the menu
  79. items that the main program has.  However, all menu entries that
  80. could make any change to the INI Files or Extended Attributes have
  81. been disabled.  Therefore, it is not possible to make any changes
  82. with these programs.  You can use these program to explore the
  83. contents of the various INI files and Extended Attributes and can
  84. play with all of the menu items without worrying about causing a
  85. problem with your Desktop.
  86.  
  87. Once the user is ready to use the fully capable program, they
  88. should be sure that they have a good backup of their Desktop.  If you
  89. have SysMaint, this can be accomplished in less than a minute using
  90. the Desktop menu.  The user should make a Backup of his Desktop and
  91. be sure to create a Restore CMD file, so that the Restore can be done
  92. if a problem occurs with the Desktop.  If you are an IniMaint user,
  93. then you can upgrade to SysMaint for a reasonable amount.  If you
  94. already have a desktop Backup program, you should be sure you have a
  95. current Backup and make a new one anytime you make enough changes to
  96. your Desktop that you would be very unhappy to have to do them over
  97. again.
  98.  
  99. One word about making sure the Backup is a current one.  Much of
  100. the information about those Desktop items that are represented as
  101. files, which includes all folders, is kept in the Extended Attributes
  102. of the Desktop Directory structure.  Currently, the Extended
  103. Attributes for the Desktop are not updated except during a Shutdown
  104. of OS2.  Therefore, if you have made significant changes to the
  105. folders, the contents of folders or have rearranged the  folders on
  106. the Desktop, it would be a good idea to do a Shutdown and reboot
  107. before making a Backup.
  108.  
  109. The Backup is not recommended because of any known problem with
  110. IniMaint or SysMaint or even because using the programs will cause
  111. any Desktop problems.  It is recommended because there are many
  112. things which can cause problems with a Desktop and, as time goes on,
  113. the ways that a Desktop can be damaged will change.  Noone should be
  114. without a plan to recover from any kind of damage that might be done
  115. to their Desktop, unless they want to gain experience doing their
  116. Desktop customization over and over.  It takes but a minute to make
  117. the Backup and having it can save many hours of work.  Here are Carry
  118. Associates, we have clobbered the Desktop in many different ways, but
  119. have never had to reinstall OS2 because we have always had a Backup
  120. and a plan for how we would recover from a Desktop problem.
  121.  
  122. A word about the warnings that you will see both in the
  123. documentation and when you are about to perform certain INI File or
  124. Extended Attribute changes.  There are those who say that some of the
  125. warnings are too extreme and make the user very uncomfortable.  It is
  126. very possible that this is correct.  However, we have left things the
  127. way they are because we believe it is a good thing for any user to
  128. pause and make sure that they really want to do what they are
  129. attempting and to be sure that they understand what is happening.  If
  130. any user finds themselves at one of these warnings and is not sure
  131. about what is going to happen, then they should Cancel.  The purpose
  132. of this Help file is to explain things to the point that each user
  133. will understand each function before they use it.  If this is not the
  134. case, then we at Carry Associates will be more than happy to talk to
  135. you and help you understand what is going on.  This will also help us
  136. to know where additional Help explanation is warranted.
  137.  
  138. Once the Backup of the Desktop is safely done.  Each user should
  139. use the Repair INI Files entry on the Recover Menu to do a Repair of
  140. both the File Handles and the WPS Entries.  The best way to do this
  141. is to leave the Type of Repair at the default, Report Only, and ask
  142. for a Repair of the File Handles and then the WPS entries.  Once the
  143. user is comfortable that all of the listed items should be Repaired,
  144. the Do Repair button can be selected and then click on Execute to
  145. actually perform the Repairs.  These two Repair functions will remove
  146. any entries in the OS2.INI or OS2SYS.INI files that represent files
  147. or WPS Objects that no longer exist on the Desktop.
  148.  
  149. While the items discussed above are the primary Repair items,
  150. there is a long list of other kinds of Repair.  The best way to get
  151. more information on a specific type of Repair, simply highlight one
  152. of the Repair Types in the Drop Down Combox and hit the F1 key, this
  153. will give you the Help for that specific Repair Action.
  154.  
  155. Aside from the above and lacking a specific problem, it is
  156. suggested that users might want to go through both the OS2.INI and
  157. OS2SYS.INI files, just to review their contents.  Simply looking at
  158. the names of the Applications, Key Names and the values will give any
  159. user a lot of information on how OS2 works and the purpose of the INI
  160. files.
  161.  
  162. If you have SysMaint, then it is worthwhile to View the Extended
  163. Attributes for the Desktop Directory, all of its sub directories and
  164. files.  This will make the structure of OS2 much clearer and will
  165. help the user to understand the real power and utility of the
  166. Extended Attributes.
  167.  
  168. ************************************************************************
  169.  
  170. Help for What is an INI File?
  171.  
  172. This is not intended to be a replacement for the normal
  173. documentation on INI files, but just a very general orientation
  174. explaining the reason I started the development of IniMaint.
  175.  
  176. Many, if not all applications that run in any computer environment
  177. need to have a place to keep information that is system specific.  In
  178. a standard DOS environment, every application must define a place for
  179. this information and manage it themselves.  With the advent of
  180. Windows and it's requirement that a lot of Windows information be
  181. kept somewhere, a standard file approach was developed.  In the
  182. original Windows environment this file was called WIN.INI and could
  183. contain information about Applications as well as Windows itself. 
  184. This file was, and still is, a standard ASCII text file and this
  185. causes some problems.  Specifically, much of the data stored in the
  186. file could be more efficiently stored and used if it was in a binary
  187. format and, more important, an ASCII file meant that the user could,
  188. and almost always did, edit the file.  This editing can introduce
  189. errors, so the parsing of the file becomes a big problem.  Because of
  190. formatting and performance problems, some of the standard information
  191. needed to run individual programs was still not stored in the INI
  192. file, but was stored in individual Program Information Files or PIF
  193. files.  These files were binary, thus solving the performance and
  194. editing problems, since they were maintained by Windows itself. 
  195. However, this generated a huge number of tiny files, each one taking
  196. an entire allocation unit on the harddisk and generating a
  197. significant backup problem.  OS/2 takes the concept a step
  198. further by making the INI files binary files and incorporating all of
  199. the information that Windows stores in the PIF files in the same
  200. file.  These files OS2.INI, for user information, and OS2SYS.INI, for
  201. system information.  In addition, a set of OS/2 API's are
  202. supplied to manage these files.
  203.  
  204. The OS/2 INI files are organized on three levels:
  205.  
  206. The highest level is the Application Name.
  207.  
  208. Within each Application, there is a series of individual entries
  209. which are called Keys and identified by a Key name.
  210.  
  211. Associated with each Key name is the actual data for the
  212. Application/Key pair or Key value.
  213.  
  214. For example, IniMaint will create a new Application called "INI
  215. File Maintenance" in the OS2.INI file.  This is the IniMaint
  216. Application name.  One of the Keys that IniMaint will create is
  217. "Current INI" which is used to keep track of which INI file the user
  218. is currently working with.  The Key value for this
  219. Application/Key pair will be the path and filename of the current
  220. INI file.
  221.  
  222. Since the files are binary, the performance is reasonable,
  223. especially since the files do not have to be accessed that often.  In
  224. addition, the contents of the files are managed by OS/2, so there
  225. is not a problem of parsing the entries to insure that they are
  226. properly formatted.  
  227.  
  228. However, this creates other problems.  For example, there is no
  229. way for a user to even find out what is in the files, even for
  230. applications that he has installed.  One of the advantages of the
  231. fact that the Windows INI files were ASCII and the PIF files were
  232. application specific was that they user could install an application
  233. on one system and then move it, with customizing, to other systems by
  234. moving the PIF files and, sometimes, some entries from the INI
  235. files.  None of this is possible in an OS/2 environment.  Every
  236. machine must be customized manually and every change must be made in
  237. every system.  Further, it turns out that no application, including
  238. OS/2 itself, makes any provision for removing obsolete entries
  239. from the INI files.  Therefore, as you change your OS/2
  240. environment and upgrade or change your applications, the OS2.INI file
  241. and OS2SYS.INI files get bigger and bigger as they fill with
  242. information that no longer applies to your environment.  Finally,
  243. since OS/2 always has the User and System INI files open, there
  244. is no way to create a backup of these files except during boot time. 
  245. This normally means you have to keep several layers of copies, since
  246. you have to reboot to fix anything.
  247.  
  248. IniMaint was developed to address the new problems introduced by
  249. the new INI file approach in OS/2.  With IniMaint you can review
  250. what is in the files, change it, delete old entries, do complete or
  251. partial backups at any time and otherwise have an appropriate level
  252. of control over these files.
  253.  
  254. ************************************************************************
  255.  
  256. Help for What is an Extended Attribute?
  257.  
  258. Extended Attributes are added to directories and files to describe
  259. the contents, use, association and many other aspects of the
  260. directory or file.  The Extended Attributes are not an actual part of
  261. the file, but are associated with the file.  For HPFS this Extended
  262. Attribute information is kept in the Directory entry, for FAT the
  263. information is kept in a separate file, since there is not enough
  264. room in the directory.  Refer to the OS/2 documentation for a
  265. more complete discussion of Extended Attributes themselves.
  266.  
  267. One of the problems with OS/2 is that, while it makes extensive
  268. use of Extended Attributes, it does not provide the user with the
  269. tools necessary to deal with problems or give users the tools
  270. necessary to understand them.  While this is a problem for everyone,
  271. it is especially a problem for developers who might want to take
  272. advantage of Extended Attributes in their applications.
  273.  
  274. SysMaint is designed to all the user to look at the Extended
  275. Attributes that are present on their system, edit them, if necessary,
  276. and do a number of different kinds of maintenance functions. 
  277. However, before discussing how SysMaint handles Extended Attributes,
  278. it is necessary to be sure that everyone understands a little about
  279. how Extended Attributes are structured.  The following discussion
  280. assumes that the reader is already familiar with IniMaint, the
  281. structure of the IniMaint windows and how IniMaint displays and
  282. maintains INI Files.
  283.  
  284. The is a parallel between how INI files are structured and how
  285. Extended Attributes are structured so SysMaint uses most of the
  286. IniMaint code to handle the Extended Attributes.  INI Files are
  287. organized into Applications that have one or more Keys and each Key
  288. has a Value assigned to that Key.  Extended Attributes are associated
  289. with a Directory or a File, each of which can have more than one
  290. Extended Attribute and each Extended Attribute has a Name and an
  291. associated value.  Therefore, SysMaint will display the names of the
  292. Directories or Files in the Application Window, the Names of the
  293. Extended Attributes in the Key Name Window and the Extended Attribute
  294. Value in the Key Value Window.
  295.  
  296. The approach above works very well for Simple Extended Attributes.
  297. However, the parallel between INI Files and Extended Attributes
  298. breaks down when it encounters a Multiple Value Extended Attribute,
  299. so some modifications are needed to handle this situation.
  300.  
  301. There are three general types of Extended Attributes as far as
  302. SysMaint is concerned:
  303.  
  304. Extended Attributes that SysMaint does not understand and will
  305. display just as they are found.
  306.  
  307. Simple Extended Attributes that use the type identifiers that are
  308. documented in the OS/2 documentation.  These are Extended Attributes
  309. that closely parallel the INI File structure and are displayed that
  310. way.
  311.  
  312. Multiple Extended Attributes, which are Extended Attributes that
  313. contain other Extended Attributes.  These are the Extended Attributes
  314. that do not closely parallel the INI File structure.
  315.  
  316. There were two different ways that SysMaint could handle the Multiple
  317. Value Extended Attributes:
  318.  
  319. They could simply be identified as Multiple Value and the entire
  320. Extended Attribute could be placed in the Key Value Window.
  321.  
  322. The structure of the Multiple Value Extended Attribute could be
  323. decoded and displayed in the windows in a decoded form.
  324.  
  325. Since the decoding of the Multiple Value Extended Attributes is not a
  326. trivial task, especially since a Multiple Value Extended Attribute
  327. can contain other Multiple Value Extended Attributes, thus causing
  328. multiple levels of decoding, SysMaint will decode the Multiple Value
  329. Extended Attributes and display them in decoded form.  This causes a
  330. single Extended Attribute to have multiple entries in the Key Name
  331. window.  In order to create unique Key Entries and to display the
  332. level of the Extended Attribute, each Key Name will be followed by
  333. two additional pieces of data, each placed inside a pair of parens.
  334.  
  335. The Level of the Extended Attribute.  For a Simple Extended
  336. Attribute this will simply be: (01).  For a Multiple Value Extended
  337. Attribute the numbers will start with (01) and increase by one for
  338. each of the Extended Attributes within the initial one.  If another
  339. level of Multiple Value Extended Attributes is encountered, then an
  340. additional level will be added to the Level Information: (04.01),
  341. would mean that the fourth main level Extended Attribute is a
  342. Multiple Value Extended Attribute and this is the first entry for
  343. that Extended Attribute.
  344.  
  345. The type of Extended Attribute, such as Ascii, Binary, Icon or
  346. Multiple Value.
  347.  
  348. This arrangement sounds complicated, but it ends up looking very
  349. much like an outline would look and is not difficult to understand. 
  350. Since all of the entries will start with the name of the Extended
  351. Attribute, it is very easy to know which entries go with which.
  352.  
  353. The online Help for SysMaint has extensive detailed descriptions
  354. of how to select which Extended Attributes you want to operate on,
  355. what operation you want done and how you want to handle the various
  356. default actions.  Therefore, it might be very useful to review the
  357. Online Help before doing much with the actual Extended Attributes.
  358.  
  359. Finally, a word of warning and a request for help.
  360.  
  361. The warning is that Extended Attributes can be critical to the
  362. health of you environment.  Therefore, you should not do something
  363. with the Extended Attributes on your system if you are not sure you
  364. understand what you are doing.  You cannot hurt yourself if you
  365. simply look at Extended Attributes via the Edit Function or Save
  366. them.  However, something like Splitting the Extended Attributes from
  367. a file will leave the file without the Attributes.  If you are doing
  368. it so you can backup the file under DOS and will be careful to Join
  369. the Extended Attributes back to the files before you use them.  If
  370. you are not sure about what you want to do, please go to the OS2AVEND
  371. Forum on Compuserve, Section 1 and we will be more than happy to
  372. discuss your intentions and any potential problems.
  373.  
  374. The request for help involves supplying documentation on any
  375. unusual conditions you might encounter.  One of the items in the
  376. Default Dialog for the Extended Attributes is to activate a log to
  377. the INIEA.LOG file.  Anytime you encounter a condition where SysMaint
  378. cannot handle an Extended Attribute condition or have invalid
  379. Extended Attributes, I would ask you to turn on the logging, ask to
  380. Edit the Extended Attributes that are invalid or causing a problem,
  381. close SysMaint, zip the resulting INIEA.LOG file and Email it to use
  382. using the Compuserve ID in the main documentation or mail to the
  383. supplied address.  This will allow us to be able to see the various
  384. conditions that occur and modify the program to handle them.
  385.  
  386. ************************************************************************
  387.  
  388. Help for How to Modify Extended Attributes
  389.  
  390. The Extended Attributes for a set of Directories and/or Files
  391. can obviously be modified by using the Extended Attribute Menu Item
  392. Join. However, it is often the case that a user simply wants to look
  393. at the Extended Attributes for a specific Directory or File and then
  394. make some sort of minor modification to them. The purpose of this
  395. Help entry is to explain how to do that, since a number of users have
  396. expressed confusion in this area. Here is how it is done:
  397.  
  398. Use the View entry on the Extended Attribute Menu to get the
  399. Extended Attributes for the appropriate Directory and/File into a
  400. temporary file. It is okay to select more Directories and/Files
  401. than you want to modify, since any set of Extended Attributes that
  402. are not changed will simply get written back unchanged.
  403.  
  404. Modify the Extended Attributes in the various windows as desired.
  405. There are a number of checks in the code to prevent a user from
  406. making changes that would create illegal Extended Attributes,
  407. however, care should still be exercised in this area. In short, if
  408. you are clear on what is allowed and what is not allowed, then you
  409. should not make any changes or be sure you have a solid backup of the
  410. area you are changing.
  411.  
  412. Once the changes have been made, then the actual Extended
  413. Attributes can be updated by selecting the Update From Current File
  414. entry on the Extended Attribute Menu.
  415.  
  416. ************************************************************************
  417.  
  418. Help for What makes up the Desktop?
  419.  
  420. When OS/2 2.1 is booted and assuming the boot is from a
  421. Harddisk, the PM Shell is loaded and one of the first thing the PM
  422. Shell does is to start the Workplace Shell and the WPS, after
  423. thinking about it for awhile, brings up the Desktop.  While this is a
  424. loose description of the sequence of events, it is a accurate picture
  425. of what happens.
  426.  
  427. The Desktop consists of a Background and a bunch of Objects that 
  428. appear on the Background, most of which are called Folders and
  429. contain either other Folders, Programs or other sorts of useful
  430. things.  This Desktop is mentioned over and over in the documentation
  431. in order to teach the user how to use, maintain, modify and otherwise
  432. interact with OS/2 via the Desktop.
  433.  
  434. A lot of Applications have been written by people outside of IBM
  435. that are designed to help users maintain and backup the Desktop and
  436. both IniMaint and SysMaint are in this category.  However, little is
  437. said in the documentation about exactly what is the Desktop, so I
  438. thought I would address this question.
  439.  
  440. The WPS itself is actually a PM Application, much like any other
  441. PM Application and runs as a single Process under the control of
  442. OS/2.  However, the WPS is an extremely complex and powerful
  443. Application that controls the entire operating environment.  The
  444. Application code itself is made up of the same stuff that any other
  445. Application is made of and that is executable files, all of which are
  446. DLL's, I think.  The actual code that runs the Desktop is clearly the
  447. same for everyone that is using the same version of OS/2 and this
  448. code is never changed during the operation of WPS, so the unique
  449. characteristics of each Desktop must be somewhere else.
  450.  
  451. The is also a lot of discussion of INI files, especially the ones
  452. used by the operating system, OS2.INI and OS2SYS.INI, and there is
  453. some discussion of Extended Attributes.  Finally, there is a
  454. Directory structure that gets created on the drive used as the base
  455. for the WPS that appears to contain nothing more than a bunch of
  456. empty Directories.
  457.  
  458. The Desktop consists of a collection of Objects that are created
  459. by WPS from the Object information that is kept in two places.
  460.  
  461. The first kind of
  462. of Object on the Desktop is called a File Object and every File Object is
  463. represented by a Directory in the Desktop Directory, including the
  464. Desktop itself.  The reason the Desktop Directories appear to be empty is
  465. because all of the information needed to create a File Object is kept in
  466. the Extended Attributes for the specific Directory.
  467.  
  468. The second kind of Object on your Desktop is called an Abstract Object and
  469. the information needed to create this kind of Object is kept in the OS2*.INI
  470. files, mostly the OS2.INI files.
  471.  
  472. In summary, the entire Desktop is contained in the Desktop Directory
  473. structure, the Extended Attributes for the Desktop Directory and the
  474. contents of the OS2*.INI files.  With one exception, at least one of the
  475. Desktop Directories will have files in it, the Templates Directory, and
  476. these files along with their Extended Attributes are also part of the
  477. Desktop.  Therefore, all that is required to make a Simple Backup of the
  478. Desktop that can be used to restore the current environment on the current
  479. machine is to make a copy of the above items.
  480.  
  481. ************************************************************************
  482.  
  483. Help for System and User File Definition
  484.  
  485. There are two standard INI Files that are used by OS/2.  The System INI
  486. file, normally OS2SYS.INI, is used to store system level initialization
  487. and control information.  The User INI File, OS2.INI, is used to store
  488. application level initialization and control information.
  489.  
  490. The distinction between what is system level information and what is
  491. application level information appears to the author to be somewhat blurred.
  492. It looks like a lot of information that could be considered system level
  493. information is stored in the User INI file.
  494.  
  495. It makes little difference to the User how OS/2 decides where to put
  496. various pieces of information, since it does not change how applications
  497. that are installed on the Desktop should handle their initialization and
  498. control information.  The System INI File should not ever be used by any
  499. application installed on the Desktop, except things such as device drivers
  500. and other applications that are clearly System Applications.  All user
  501. Desktop applications must store their information in the User INI file or
  502. in their own application INI file.  To date, most applications have chosen
  503. to use the User INI file rather than create an INI file just for their
  504. application.
  505.  
  506. ************************************************************************
  507.  
  508. Help for Non Write INI Files
  509.  
  510. V2.1 of OS/2 changed the way the INI files are kept updated.  The new
  511. scheme was a welcome one because it greatly improved the performance of
  512. this area of OS/2 and removed the problem of INI files becoming very large
  513. because of a lot of unused space.  However, the change introduced a problem
  514. that had not existed previously, that is, it is possible to get into a
  515. situation where the OS2.INI and OS2SYS.INI files cannot be updated.  When this
  516. condition occurs and any changes are made to the Desktop, it appears that
  517. the changes are being made correctly.  However, only the INI file information
  518. that is kept in memory is being updated, that actual INI files are not
  519. changed in any way.  Even though this situation exists, the user is given
  520. not warning or information that there is a problem.  Normally, the user would
  521. discover the problem when the changes made to the Desktop disappeared the
  522. next time that OS/2 was booted.  Occasionally, the problem would be even more
  523. serious because one of the INI files could be updated, but the other could
  524. not.  This can cause serious problems with the Desktop.
  525.  
  526. Many users, when they realize they have this problem, look at the INI
  527. file entries in the directory and see that the RO attribute is turned on.
  528. They then assume that this is the problem and reset the bit.  However, the
  529. RO attribute should always be on for any INI file that is open, and resetting
  530. the attribute does not solve the problem.  The real problem is that the files
  531. used as a target for the INI file updates, zero length hidden files with a
  532. !!! extension are missing.  The reason these files are missing is because the
  533. INI files already had the RO attribute turned on when the PM Shell was
  534. started, therefore, the INI file code did not create the !!! files.  The
  535. best manual solution is to boot from a diskette or reboot, if the user has
  536. ShiftRun, and reset the RO attribute off while the PM Shell is not active.
  537. This will fix the problem and the INI files will now be updated normally.
  538.  
  539. ************************************************************************
  540.  
  541. Help for Automatic Repair of Non Write INI Files
  542.  
  543. Anytime that IniMaint or SysMaint attempts to update an INI file and the
  544. update fails, a check is made to see if the file is either the User or
  545. System INI files.  If either file is found, the it is assumed that one or
  546. both of the INI files is in a condition where is cannot be updated.
  547. Normally, this condition would cause IniMaint or SysMaint to terminate.
  548. Since there is a way to fix this situation, but the fix involves resetting
  549. WPS, IniMaint and SysMaint will inform the user of the situation and ask
  550. them if they want the condition fixed.  If the user replies no, then the
  551. application will terminate.  If the user replies yes, then the INI files will
  552. be fixed so that they can be updated.
  553.  
  554. Normally, IniMaint and SysMaint will recognize this condition during the
  555. startup of the application.  This is because the IniMaint and SysMaint
  556. operational information is normally stored in the OS2.INI file, thus this
  557. file is normally updated very often.  However, it is possible that no
  558. updates will be attempted to the file because all of the defaults are
  559. already set or because the user has moved the application operational
  560. information to a different INI file.  In the first case, the condition will
  561. be recognized as soon as any action is taken which changes any of the
  562. IniMaint or SysMaint operational information.  In the second case, the
  563. condition will not be recognized unless the User or System INI files are
  564. made the current INI file and an attempt is made to change something in
  565. one of these files.
  566.  
  567. ************************************************************************
  568.  
  569. Help for What is an IniMaint Group?
  570.  
  571. An IniMaint Group is a set of Applications in a specific INI file
  572. that has been formed and named by the user and is used as a
  573. convenient way to manipulate the contents of the INI file.  Without
  574. some way to form subsets of all of the Applications in an INI file,
  575. the only way to manipulate it is either Application by Application,
  576. which can be tedious, or by using the entire file, which provides no
  577. flexibility.  Since one of the objectives of IniMaint is to give the
  578. user an easy way to create backups of all or part of his INI files
  579. and to provide an easy way to restore an INI file, neither level of
  580. manipulation is satisfactory.
  581.  
  582. IniMaint solves this problem by giving the user the ability relate a
  583. set of Applications together into a Group.  Forming the Group does not
  584. change the Application information in the INI file, it simply creates
  585. an additional Application in the file that describes the Groups that
  586. the user has formed.  Once the Groups are created, then the Group
  587. name can be used in IniMaint operations and all the Applications in
  588. the Group will be included.
  589.  
  590. For example, many users install a number of programs that put entries
  591. into the standard User INI file, normally OS2.INI.  If there is a
  592. problem with the environment, something happens to the INI files or
  593. some other problem arises that clobbers the INI entries, then the
  594. only recovery is to re-customize all of these applications.  If the
  595. user were to put all of these Applications into a Group called
  596. 'My Applications', then he would not have this problem.  The My
  597. Applications Group could be backed up to a backup INI file at any
  598. time using the INICOPY program as follows:
  599.  
  600. INICOPY -IC:\OS2\OS2.INI -OC:\OS2\MYAPPS.INI -G"My Applications"
  601.  
  602. The above assumes the normal name and location for the INI files.  The
  603. name of the Group must be enclosed in ""'s if it contains any blanks
  604. or the Command Processor will split it into two different command
  605. line entries and INICOPY will return an error.
  606.  
  607. The same Group could be restored to the User INI file as follows:
  608.  
  609. INICOPY -OC:\OS2\OS2.INI -IC:\OS2\MYAPPS.INI -G"My Applications"
  610.  
  611. In other words, simply reverse the Input and Output filenames.
  612.  
  613. It is intended that this same approach can be used to keep multiple
  614. physical computers in synch with each other.  Right now, if the user
  615. has multiple systems, he must customize every installed application
  616. on every system.  You cannot move the INI files from one system to
  617. another, since there is a lot of information in the INI files that is
  618. system specific.  Using IniMaint, this process is made much easier,
  619. since the target INI file can be on a diskette and, even if there are
  620. some minor differences between the systems such as drive letters or
  621. something like that, IniMaint can be used to make modifications to
  622. the contents of the transfer INI file before it is copied to the new
  623. system.  This does not need to be limited to installation situations.
  624. One possible approach would be to form an Applications Group and,
  625. whenever any significant change is made to any application, the
  626. changes can be transferred to the other systems.  In fact, there is
  627. not reason, assuming the user had many systems and a LAN, that a
  628. separate transfer INI file could not be set up for every application,
  629. have it updated from a central source whenever a significant change
  630. is made and have a CMD file on individual client systems that would
  631. use the transfer INI files just for the applications installed on
  632. that system.
  633.  
  634. I suspect there are many ways to utilize the Group concept.  As of
  635. this writing, IniMaint has only been used by a few Beta testers and
  636. only for a short time.  Hopefully, as more users install and use
  637. IniMaint, more ideas on how the IniMaint Groups can be used will be
  638. developed.  I will do my best to include this new information into the
  639. IniMaint documentation and make it available on the Compuserve OS2AVEND
  640. Forum.
  641.  
  642. ************************************************************************
  643.  
  644. Help for What does Repair Do?
  645.  
  646. IniMaint has an item on the Recover menu called Repair.  This item
  647. gives the user the ability to perform a number of different automatic
  648. Repair actions on his INI files.  The Online Help documents how the
  649. Repair function works, however, it does not detail the rational and
  650. algorithms employed by IniMaint to accomplish the various Repairs.
  651. This document is an attempt to do that.
  652.  
  653. Type of Repair
  654.  
  655. There are four different type of Repair Options.
  656.  
  657. The first one, Report Only, will never make any changes, but will
  658. only list the items that would have been Repaired if the Do Repair
  659. Option had been chosen.
  660.  
  661. The Ask First, will ask the user if he wants each item repaired as
  662. the item is found and determined to be invalid.  This can take a very
  663. long time in some cases, since the number of items can become quite
  664. large
  665.  
  666. Do Repair, will automatically remove all invalid items for the
  667. category selected from the appropriate INI file.  This should only be
  668. used when the user is sure he wants all invalid items removed.
  669.  
  670. Do Selected can only be used after Report Only, since it requires
  671. that the invalid items be visible in the window.  When Execute is
  672. chosen with the Do Selected button checked, then every line in the
  673. window that is selected will be deleted.  The only exception to this
  674. is when doing either the Handles or WPS repair and a selected item
  675. has dependent items, such as subdirectories or files, in this case
  676. all dependent items will also be deleted.  For example, if a Drive
  677. name itself is selected and Do Selected is chosen, then all entries
  678. for the drive, including all directories and files, that have been
  679. identified as invalid will be deleted.
  680.  
  681. The easiest and safest way to remove invalid items when the user is
  682. not sure if they want everything done is to use the Report Only
  683. option, select the items that they want deleted and then use Do
  684. Selected.  This cycle can be repeated over and over until all of the
  685. desired items have been deleted.
  686.  
  687. Window Behavior
  688.  
  689. When and item is deleted for any reason, the word 'Deleted' will
  690. appear after the item in the window.  If there are deleted items in
  691. the window and additional items are selected for deletion then the
  692. previously deleted items will be removed from the window.  For
  693. example, if the first item in the window is selected and deleted, the
  694. word deleted would appear after the first item.  If then the second
  695. items is selected and deleted, the second item will now have the word
  696. deleted after it and the first item will be gone from the window.
  697.  
  698. Options
  699.  
  700. Different users want to handle directories and file that are on
  701. removable, not ready, cdrom and vdisk devices differently.  The
  702. Options dialog gives each user the ability to choose how they want
  703. each of these types of situations handled.
  704.  
  705. If Ignore is chosen, then directories and files on the appropriate
  706. type of device will be completely ignored and will never appear in
  707. the repair window.
  708.  
  709. If Report Only is selected, then the information will appear in the
  710. window, but will not get automatically deleted if the Do Repair
  711. option is chosen.  The Report Only items can still be deleted by
  712. selecting them and using the Do Selected option.
  713.  
  714. If Auto Repair, which is the default, is chosen, then the items will
  715. be reported and will be automatically deleted if Do Repair is chosen.
  716.  
  717. The Do Not Save Deleted Items button will cause IniMaint to not save
  718. items that are deleted from an INI file in the Save INI File.
  719. Normally, the user must specify a Save INI File and any entries
  720. removed from any INI file are written to the Save INI File before
  721. they are modified.  This allows the user to restore items that he has
  722. deleted if they discover that something has been deleted in error and
  723. no backup is available.
  724.  
  725. The Log to INIREP.LOG is used for diagnostic purposes.
  726.  
  727. List Items versus Repair Items
  728.  
  729. For a number of the repair categories there are multiple choices
  730. available.  The is always the Repair choice and it works the same for
  731. each category of Repair.  When the Repair choice is used, the only
  732. items that will appear in the window will be items that are invalid
  733. and should be deleted.
  734.  
  735. If the user want to see the valid items for the category or all the
  736. items, then the appropriate List entry can be used to display these
  737. entries.  The List Invalid items is the same as the Repair as far as
  738. the contents of the window is concerned, however, it is safer because
  739. it is not possible to select or otherwise delete any of the items.
  740.  
  741. Repair Pathnames and Filenames
  742.  
  743. Many, if not all, applications installed under OS/2 store things in
  744. various INI files.  However, few, if any, applications will remove
  745. things from these files when they are deinstalled or the directory
  746. structure is changed.  This Repair action looks at the Pathname and
  747. Filename entries in an INI file, compares them to the current Desktop
  748. and either identifies and/or removes entries that are obsolete.
  749.  
  750. The action IniMaint will take depends on the structure of the
  751. individual Key Name or Key Value.  There are two possibilities that
  752. IniMaint looks for:
  753.  
  754. A Filename with no preceding Path information.
  755.  
  756. A full Pathname or Filename combination.
  757.  
  758. Each of the above are handled differently.
  759.  
  760. General Processing applicable to both type of names:
  761.  
  762. Any name that is too short, less than 3 characters, or too long,
  763. longer than the maximum path length returned by DosQSysInfo, will not
  764. be tested further.
  765.  
  766. Any name which contains non-printable characters will not be tested.
  767.  
  768. Processing of Filename with no Path information:
  769.  
  770. If the beginning of a Key Name or Key Value starts with either X:\ or
  771. just \, IniMaint assumes it is a full Pathname or Filename and
  772. processes it as described below.  IniMaint will then check for a
  773. Filename of the form *.XXX and ignore them, since this is simply a
  774. definition of a type of file extension and not an actual file.
  775. IniMaint will then look for .XXX as the last four characters of the
  776. Filename and will search for the following combinations:
  777.  
  778. .EXE using the PATH Environment variable.
  779.  
  780. .CMD using the PATH Environment variable.
  781.  
  782. .DLL using the LIBPATH Environment variable.
  783.  
  784. .HLP using the HELP Environment variable.
  785.  
  786. Processing of full Pathname or Filename:
  787.  
  788. If the name starts with \, then the drive used as the drive for the
  789. OS2.INI file, which is the boot drive, will be appended to the start
  790. of the name.
  791.  
  792. Any name that starts with A: or B: will be ignored, since they are
  793. assumed to be floppy drives and probably do not contain any media.
  794.  
  795. Any trailing semicolons are removed from the name, since there are a
  796. number of entries that are valid Filenames except for the semicolons.
  797.  
  798. If the trailing character in the name is a \ or if the name contains
  799. any embedded semicolons, it will be tried as a Pathname and made a
  800. candidate for removal if it is not found.
  801.  
  802. All other qualifying names will be tried as both a Filename and a
  803. Pathname and will be made a candidate for removal if they fail both
  804. tests.
  805.  
  806. Remove Old PM_ProgramList Entries
  807.  
  808. There are some entries that can be left in the OS2.INI file from
  809. V1.3 or V2.0, but these entries are no longer needed for V2.1.  This
  810. item will remove these old entries.
  811.  
  812. Delete Unused Printer Entries
  813.  
  814. When Printer Objects are removed from the Desktop, sometimes old
  815. Printer information is left in the OS2SYS.INI file that will cause
  816. problems for various applications that use these entries to determine
  817. which Printers can be used for printing.  A number of Word Processing
  818. programs do this.  Many, if not all, of these programs do not check to
  819. verify that all of the entries in the OS2SYS.INI file actuall
  820. represent Printers that are actually installed, therefore, will
  821. sometimes attempt to use a Printer that does not exist.  This entry
  822. will remove all of the references to Printers that are no longer
  823. installed.
  824.  
  825. Destroy Objects
  826.  
  827. Most, if not all, of the items on the Desktop have been assigned an
  828. Object Number.  This number along with the name of the Object is
  829. stored in the OS2.INI file.  This Repair entry will display and give
  830. the user the option to delete and Object.  It is not currently
  831. possible for IniMaint to determine which Objects are valid and which
  832. are invalid, so IniMaint will never identify an Object as invalid.
  833. Great care should be exercised when deleting any of the Objects,
  834. since it is possible to do serious damage to your Desktop.
  835.  
  836. The structure which stores all of the Object cross reference is used
  837. by the WPS Repair code to determine if Objects are valid and to find
  838. the names of valid Objects.
  839.  
  840. Restore Missing Location Entries
  841.  
  842. A conflict can arise between the entries in the
  843. PM_Abstract:Objects entry in the OS2.INI file and the
  844. PM_Workplace:Location entry.  The conflict is that the Objects
  845. entry will reference Locations that are not actually in the Location
  846. entry.  This will not normally represent a problem, but if unusual
  847. things are going on with the Desktop, this entry allows the user to
  848. identify the conflicts and, if they choose, have them fixed.
  849.  
  850. Repair Directory/File Handles
  851.  
  852. Many Drives, Directories and Files are assigned Handles.  This Handle
  853. information is stored in the OS2SYS.INI file.  However, when files are
  854. moved, directories changed or other changes are made to the Desktop,
  855. the Handle information is not updated.  This Repair option gives the
  856. user the ability to see the contents of the INI file Handles entry
  857. and Repair any or all of the invalid entries.
  858.  
  859. It is difficult to remove incorrect information manually, even
  860. knowing the internal structure of the entries, because all of the
  861. Handles information is stored in a single INI file entry and a small
  862. mistake in modifying could cause serious Desktop problems and/or
  863. create a non-bootable situation.
  864.  
  865. The structure which stores all of the Handles information is used
  866. by the WPS Repair code to determine if Handles are valid and to find
  867. the names of Directories and Files.
  868.  
  869. Repair WPS Entries
  870.  
  871. WPS stores a variety of Desktop information in the INI files.  As with
  872. the Handles information above, obsolete information is not always
  873. removed from the INI files when changes are made to the Desktop.  This
  874. Repair option gives the user the ability to see what is in his INI
  875. files and remove those entries that are invalid.
  876.  
  877. As with the Handles above, it is difficult to make these changes
  878. manually because things are stored in a number of different formats
  879. and the cross reference between the random looking numbers and the
  880. actual Objects and Handles would be very tedious to track manually.
  881.  
  882. The Repair WPS Entries uses the Objects and Handles structures.  This
  883. means that these structures must be filled before the WPS structure
  884. can be filled.  This can take a significant amount of time in
  885. situations where the Desktop is complex and/or there are a large
  886. number of invalid entries.
  887.  
  888. Repair Both WPS and Handles Entries
  889.  
  890. This is simply a combination of Repair WPS Entries and Repair
  891. Directory/File Handles above.  It allows the user to do both types of
  892. Repair with a single action.
  893.  
  894. ************************************************************************
  895.  
  896. Help about the Operational Environment
  897.  
  898. There are a number of Operation Environment considerations when running
  899. IniMaint or SysMaint and they are discussed in this section.
  900.  
  901. There are situations where one or more recovery actions must be done
  902. when the PM Shell is not active, such as Restoring the Desktop.  Normally,
  903. it is necessary to boot from a diskette to get into this mode, since the
  904. PM Shell is loaded during the processing of the CONFIG.SYS file.  However,
  905. there is an IBM Employee Written program that is free and available on
  906. Compuserve, ShiftRun that will interrupt the processing of the
  907. CONFIG.SYS file at the point where all of the drivers are loaded, but the
  908. PM Shell has not been started.  All of the IniMaint and SysMaint recovery 
  909. activities that must be done without the PM Shell can be done during this
  910. interruption.  ShiftRun then allows the rest of the normal boot to continue.
  911. This application can greatly ease the recovery problems and is mentioned here
  912. for that reason.
  913.  
  914. The Simple Backup and Restore facilities in SysMaint assume that the user
  915. has installed an OS/2 version of Zip and UnZip and that
  916. the installed versions are ones that will handle Extended Attributes.  Any
  917. version of the programs from V1.93 and beyond have this capability.  It is
  918. further assumed that these programs are in a directory that is in the
  919. PATH so they can be run without specifying the directory in which
  920. the EXE files are located.  If both of these assumptions are not true, the
  921. Backup and Restore functions will not work correctly.
  922.  
  923. ************************************************************************
  924.  
  925. Help for Types of Desktop Backup
  926.  
  927. There are two different kinds of Desktop Backups, which will be
  928. referred to as Simple and Portable.  The purpose
  929. of this section is to discuss the difference between them.
  930.  
  931. The most common type of Desktop Backup is a Simple Backup.
  932. This is the fastest kind of Backup and is the easiest to use to restore
  933. a damaged Desktop.  This type of backup make an image, using one technique
  934. or another, of the existing Desktop and saves the information in one or
  935. more files that can then be used to Restore the Desktop to the condition
  936. that existed at the time the Backup was made.
  937.  
  938. The advantage of this kind of Backup is that it is fast and simple.
  939.  
  940. The disadvantage is that the Backup can only be used to Restore the
  941. Desktop of the machine it was run on and for the Version of OS/2 that
  942. produced it.  In other words, it is not possible to use the files generated
  943. to Restore the Desktop on a different machine, unless the machines are
  944. exactly the same and it is not possible to use to Restore the
  945. Desktop after a new Version of OS/2 has been installed and the Desktop was
  946. destroyed because the Harddisk had to be reformatted.
  947.  
  948. Most users will never need any other kind of Backup other than a Simple
  949. one because they do not need to move the Desktop from one machine to another
  950. and they can install each new Version of OS/2 over the previous Version and
  951. this will preserve the existing Desktop.
  952.  
  953. The second type of Desktop Backup is a Portable one.  This kind
  954. of Backup is normally more complex to create and more complex to use.  It
  955. will normally also take considerably more time to create a Portable
  956. Backup.
  957.  
  958. The advantage of a Portable Backup is that it can be used,
  959. normally, to set up a similar Desktop on another machine and can be used to
  960. restore the Desktop after an installation of a new Version of OS/2 that
  961. required that the Harddisk be reformatted.
  962.  
  963. The disadvantage of this kind of Backup is that it is harder to create,
  964. harder to use, requires more resources and does not create a Backup that is
  965. usable for simply Restoring the Desktop on the existing machine.  The reason
  966. a Portable Backup is not able to recreate the Desktop on the
  967. existing machine is because there is information in the OS2.INI and OS2SYS.INI
  968. files that is not saved in this process.  Therefore, the INI files that would
  969. exist after a Restore using this kind of Backup would be incomplete.  The files
  970. would lack both some of the OS/2 System information, which could be redone
  971. manually with not too much effort, and they would lack all of the information
  972. that was added to them by the various Applications that were installed.  Most,
  973. if not all, of these applications would have to be reinstalled or have their
  974. INI information saved in some other manner.  Since the easiest way to save the
  975. INI file information is to make a Simple Backup of the Desktop,
  976. there is little reason to make a Portable one for normal day to
  977. day operation.
  978.  
  979. ************************************************************************
  980.  
  981. Help for Extended Attribute Name Matching
  982.  
  983. Many of the Extended Attribute functions involve taking the Extended
  984. Attributes from one set of files and/or directories and adding them
  985. to another set of files and/or directories.  In order to do this,
  986. SysMaint must have a way of deciding which files and directories
  987. match each other.  The basic way this is done is by removing the base
  988. information from each path and doing the compare on the remainder of
  989. the name.  For example, if the Extended Attributes for all of the
  990. files and directories in the C:\OS2\SOURCE directory were to be
  991. copied to the D:\TARGET directory, then the file
  992. C:\OS2\SOURCE\FILE.NME would be determined to match
  993. D:\TARGET\FILE.NME and the Extended Attributes for the FILE.NME file
  994. would be copied from one file to the other.  In addition, the
  995. directory C:\OS2\SOURCE\SUBDIR1 would be determined to match
  996. D:\TARGET\SUBDIR1 and the directory Extended Attributes would be
  997. copied from one directory to the other.
  998.  
  999. ************************************************************************
  1000.  
  1001. Help for What are IniSafe and SysSafe
  1002.  
  1003. Both IniMaint and SysMaint are powerful applications with the ability
  1004. to make many changes to the INI files, Extended Attributes and other items
  1005. that are vital to the normal operation of the Desktop.  Sometimes it is not
  1006. desirable to have a program that has this much power, even though both
  1007. applications are structured so that the default settings will not allow a
  1008. user to make any critical change without confirming that they want it done.
  1009.  
  1010. Sometimes the user simply does not want to take the chance that he will
  1011. do something that will cause a problem with his Desktop.  In other cases,
  1012. Corporations have many users that they simply do not want to have an
  1013. application that can cause a problem with the Desktop, since it can create
  1014. serious and time consuming support problems.
  1015.  
  1016. IniSafe and SysSafe are designed to address this problem for IniMaint
  1017. and SysMaint users respectively.  IniSafe and SysSafe appear, as far as menus
  1018. are concerned, exactly the same as IniMaint and SysMaint.  The sole difference
  1019. is that all of the menu selections that could cause a problem with the
  1020. Desktop are deactivated.  Other than that, the programs are the same.  If a
  1021. user is using IniSafe or SysSafe and it is desired to make some changes to
  1022. their Desktop, all that is required is to copy IniMaint or SysMaint into
  1023. the appropriate directory or to run the program from a different directory
  1024. on the LAN.  IniMaint, SysMaint, IniSafe and SysSafe use the same DLL and HLP
  1025. files and the operational entries in the INI files are fully compatible
  1026. across all four applications.
  1027.  
  1028. ************************************************************************
  1029. * INIMAINT REGISTRATION HELP PANEL - This panel is displayed
  1030. * when the user asks about registration
  1031. ************************************************************************
  1032.  
  1033. Registration Information
  1034.  
  1035. IniMaint and SysMaint are Copyrighted programs owned and supported by:
  1036. Larry J. Martin
  1037. Carry Associates
  1038. 990 Ironwood Court
  1039. Marco Island FL 33937
  1040. Tel: 813-642-9126
  1041. Fax: 813-642-1007
  1042. Compuserve: 71435,470
  1043.  
  1044. Unregistered copies of IniMaint will display an initial dialog that will
  1045. note the unregistered condition.  This dialog will stay on the screen for 15
  1046. seconds, unless dismissed by clicking on the OK button.  The dialog cannot
  1047. be dismissed until it has been visible for 3 seconds.  In addition, the 
  1048. Title Bar will contain a note that this is an unregistered version of
  1049. IniMaint.  SysMaint, which includes the processing of the Extended Attributes,
  1050. requires a registered copy of IniMaint plus a registration ID for SysMaint,
  1051. which is separate from the Registration ID for IniMaint.  However, if a
  1052. registered copy of SysMaint is purchased, then it will include IniMaint.
  1053.  
  1054. To obtain your registration identifier for IniMaint please send a check
  1055. for 29.95 per license for single licenses or 299.00 for an unlimited copies
  1056. license made payable to Carry Associates to the address above.
  1057.  
  1058. To obtain your registration identifier for SysMaint please send a check
  1059. for 49.95 per license for single licenses or 499.00 for an unlimited copies
  1060. license made payable to Carry Associates to the address above.
  1061.  
  1062. If you are already a registered user of IniMaint and have purchased it
  1063. prior to the release of SysMaint, then you can upgrade from IniMaint to
  1064. SysMaint for a fee of 15.00 for a single license or 150.00 for an unlimited
  1065. license.
  1066.  
  1067. If you are a registered user of IniMaint and purchased it after SysMaint
  1068. was released, then the upgrade fee is 25.00 for a single license and
  1069. 250.00 for an unlimited license.
  1070.  
  1071. If you want to register either IniMaint or SysMaint and would
  1072. prefer to use a credit card, you can register with either a Visa or
  1073. Mastercard.
  1074.  
  1075. Once you have your registration identifier, you can register your copy
  1076. of IniMaint or SysMaint by selecting the appropriate Register
  1077. entry on the
  1078. Actions Menu.  Once you are registered, this entry will no longer
  1079. appear on the menu.
  1080.  
  1081. If you want a preregistered copy of IniMaint or SysMaint, add 7.00 for
  1082. postage and
  1083. handling.  We will return a diskette with a preregistered copy of IniMaint or
  1084. SysMaint,
  1085. an Install CMD file and a registration ID.  The purpose of the ID
  1086. is to allow preregistered users to download new versions, register and
  1087. use them until they can obtain a preregistered update.
  1088.  
  1089. The cost of a preregistered update is 10.00 per license for single
  1090. licenses or 100.00 for an unlimited copies license, plus 7.00 handling
  1091. and postage.
  1092.  
  1093. ************************************************************************
  1094. ************************************************************************
  1095. ***********************   MAIN WINDOW   ********************************
  1096. ************************************************************************
  1097. ************************************************************************
  1098. ************************************************************************
  1099.  
  1100. Help for Main Window
  1101.  
  1102. The MAIN WINDOW is the base of the IniMaint and SysMaint system.
  1103. When the
  1104. program is started, this window appears listing the options available.
  1105.  
  1106. ************************************************************************
  1107.  
  1108. Help for Menu Items
  1109.  
  1110. The IniMaint or SysMaint Menu Items are:
  1111.  
  1112.    File
  1113.    Options
  1114.    Groups
  1115.    Actions
  1116.    Recover
  1117.    Size
  1118.    Find
  1119.    Extended Attributes
  1120.    Desktop
  1121.  
  1122. ************************************************************************
  1123.  
  1124. Help for Popup Menus
  1125.  
  1126. Pressing the Right Mouse Button when the Mouse Pointer is in the
  1127. Application, Key Name or Key Value windows will popup a Menu that
  1128. contains action items that can be done on the entries in that
  1129. specific window.
  1130.  
  1131. Most of the items on the menus are the same as the items on the
  1132. normal menus and are described in the Help for that specific Menu.
  1133. The Help for the duplicated items is not included here.  However,
  1134. there are three entries on the Popup Menus that are unique to these
  1135. menus and the Help for these items is included here.
  1136.  
  1137. The IniMaint or SysMaint Special Popup Menu Items are:
  1138.  
  1139.    Write
  1140.    Print
  1141.    Explain
  1142.  
  1143. ************************************************************************
  1144.  
  1145. Help for Dialogs
  1146.  
  1147. The Dialogs for IniMaint or SysMaint are listed below:
  1148.  
  1149.    Add or Replace Key Value Dialog
  1150.    Dump Dialog
  1151.    Options Dialog
  1152.    Select Group Dialog
  1153.    Get Value or String Dialog
  1154.    Groups Dialog
  1155.    Find Dialog
  1156.    Compare Files Dialog
  1157.    Compare Files Write Options Dialog
  1158.    Repair File Dialog
  1159.    EA Test Dialog
  1160.    EA Defaults Dialog
  1161.    Explain Dialog
  1162.    Desktop Defaults Dialog
  1163.  
  1164. ************************************************************************
  1165.  
  1166. Help for Accelerator Keys
  1167.  
  1168. The Accelerator Keys for IniMaint or SysMaint are listed below.
  1169.  
  1170.    F1
  1171.    Help
  1172.    F3
  1173.    Exit
  1174.    F4
  1175.    Refresh File
  1176.    F5
  1177.    Dump Variables
  1178.    F6
  1179.    Associate with *.INI
  1180.    F7
  1181.    Switch to User INI File
  1182.    F8
  1183.    Switch to System INI File
  1184.    F9
  1185.    New File
  1186.    Ctrl-F1
  1187.    Find Application Name
  1188.    Ctrl-F2
  1189.    Find Current Key Name
  1190.    Ctrl-F3
  1191.    Find Current Key Value
  1192.    Ctrl-F4
  1193.    Find Application Value
  1194.    Ctrl-F5
  1195.    Find Any Name
  1196.    Ctrl-F6
  1197.    Find Any Value
  1198.    Ctrl-F7
  1199.    Repeat Last Find
  1200.    Ctrl-F11
  1201.    Compare Files on Application Level
  1202.    Ctrl-F8
  1203.    Compare Files on Key Name Level
  1204.    Ctrl-F9
  1205.    Compare Files on Key Value Level
  1206.    Alt-F1
  1207.    Condense Current INI File
  1208.    Alt-F2
  1209.    Condense System INI File
  1210.    Alt-F3
  1211.    Condense User INI File
  1212.    Alt-F4
  1213.    Condense Both System and User INI Files
  1214.    Ctrl-E
  1215.    Size Entire File
  1216.    Ctrl-S
  1217.    Size Selected Application
  1218.    Ctrl Alt-M
  1219.    Size System INI File
  1220.    Ctrl Alt-E
  1221.    Size User INI File
  1222.    Ctrl-G
  1223.    Write Updated Key Value to INI File
  1224.    Ctrl-D
  1225.    Delete Selected Application
  1226.    Ctrl-L
  1227.    Delete Selected Key
  1228.    Ctrl-M
  1229.    Add Application
  1230.    Ctrl-I
  1231.    Add Key
  1232.    Ctrl-R
  1233.    Add or Replace Key Value
  1234.    Ctrl-C
  1235.    Rename Selected Application
  1236.    Ctrl-W
  1237.    Rename Selected Key
  1238.    Ctrl-Z
  1239.    Duplicate Selected Application
  1240.    Ctrl-X
  1241.    Duplicate Selected Key
  1242.    Ctrl-N
  1243.    Copy Entire File
  1244.    Alt-F5
  1245.    Copy System INI File
  1246.    Alt-F6
  1247.    Copy User INI File
  1248.    Alt-F7
  1249.    Copy Both System and User INI Files
  1250.    Ctrl-A
  1251.    Copy Selected Application
  1252.    Ctrl-K
  1253.    Copy Selected Key
  1254.    Ctrl-V
  1255.    Move Entire File
  1256.    Ctrl-P
  1257.    Move Selected Application
  1258.    Ctrl-Y
  1259.    Move Selected Key
  1260.    Ctrl-T
  1261.    Register Your Copy
  1262.    Ctrl Alt-S
  1263.    Backup System INI File
  1264.    Ctrl Alt-U
  1265.    Backup User INI File
  1266.    Ctrl Alt-B
  1267.    Backup Both System and User INI Files
  1268.    Ctrl-U
  1269.    Change User INI File
  1270.    Ctrl-H
  1271.    Change System INI File
  1272.    Ctrl-B
  1273.    Change Both INI Files
  1274.    Ctrl-F10
  1275.    Repair File
  1276.    Ctrl Alt-F4
  1277.    Reset Non Write INI Files
  1278.    Ctrl Alt-F5
  1279.    Test for Non Write INI Files
  1280.    Ctrl Alt-F1
  1281.    EA Default Dialog
  1282.    Ctrl Alt-F2
  1283.    EA Describe Current File
  1284.    Ctrl Alt-F3
  1285.    EA Update File(s) from Current File
  1286.    Ctrl Alt-D
  1287.    Desktop Defaults Dialog
  1288.    Ctrl Alt-K
  1289.    Backup Desktop
  1290.    Ctrl Alt-C
  1291.    Generate Desktop Backup CMD File
  1292.    Ctrl Alt-O
  1293.    Generate Desktop Restore CMD File
  1294.    Ctrl Alt-R
  1295.    Reset WPS
  1296.    Ctrl Alt-F
  1297.    Restore Desktop INI Files
  1298.    Ctrl Alt-A
  1299.    Restore Desktop Directory
  1300.    Ctrl Alt-I
  1301.    Restore Desktop ID
  1302.    Ctrl Alt-F6
  1303.    Explain Current Selection
  1304.    Ctrl Alt-F7
  1305.    Write Window to File
  1306.    Ctrl Alt-F8
  1307.    Print Window
  1308.  
  1309. ************************************************************************
  1310.  
  1311. Help for Additional Programs
  1312.  
  1313. The Additional Programs for IniMaint or SysMaint are:
  1314.  
  1315.    IniCopy
  1316.    IniClean
  1317.  
  1318. ************************************************************************
  1319.  
  1320. Help for IniCopy Program
  1321.  
  1322. The IniCopy Program is the program that is used by IniMaint to do the actual
  1323. COPY/MOVE operations.  This option is implemented as a separate program
  1324. so that the user will have the ability to make copies of INI files,
  1325. including the User and System INI files, at any time during the day.
  1326.  
  1327. The parameters expected by IniCopy are:
  1328.  
  1329. Required Parameters:
  1330.  
  1331. -Ifilename  - The fully qualified path and filename of the Source,
  1332. Input, INI file.
  1333.  
  1334. -Ofilename  - The fully qualified path and filename of the Target,
  1335. Output, INI file.  The Target will be created if it does not exist.
  1336.  
  1337. Optional Parameters:
  1338.  
  1339. -Fx         - Function requested - Default is C(opy) C = C(opy) M = M(ove)
  1340.  
  1341. -E          - COPY/MOVE Entire INI file - Default
  1342.  
  1343. -A          - COPY/MOVE All Groups
  1344.  
  1345. -Ggroup     - COPY/MOVE Specific Group
  1346.  
  1347. -Sapp       - COPY/MOVE Specific Application
  1348.  
  1349. -T          - Use Fast Copy.  This is only valid if -E is also specified
  1350.  
  1351. ************************************************************************
  1352.  
  1353. Help for IniClean Program
  1354.  
  1355. The IniClean Program is designed to remove the Desktop
  1356. Directory Structure by deleting the Desktop Directory, all
  1357. Subdirectories, and all Files in all Directories.
  1358.  
  1359. IniClean is not normally designed to be run as a stand alone program.  However,
  1360. it can be run to remove any Directory with it's Subdirectories and all files
  1361. in all Directories by passing the starting Directory as the only parameter.
  1362.  
  1363. For example, to delete the OS2 Directory from drive C, all Subdirectories of
  1364. the OS2 Directory and all Files in the OS2 Directory and all Subdirectories
  1365. run IniClean as shown: IniClean -iC:\OS2
  1366.  
  1367. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  1368.  
  1369. DO NOT RUN this program unless you are sure you know what you want to delete.
  1370. Once the program is started, it will delete all Directories and Files without
  1371. requiring or asking for any additional input.
  1372.  
  1373. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  1374.  
  1375. ************************************************************************
  1376.  
  1377. Help for Application Listbox
  1378.  
  1379. The APPLICATION LISTBOX displays the list of applications 
  1380. that are in the current INI file, whose name is on the Title Bar.
  1381.  
  1382. ************************************************************************
  1383.  
  1384. Help for Key Listbox
  1385.  
  1386. The KEY LISTBOX displays the list of key names for the 
  1387. application that is currently selected in the Application Listbox.
  1388.  
  1389. ************************************************************************
  1390.  
  1391. Help for Key Data Window
  1392.  
  1393. The MLE WINDOW displays the value of key for the 
  1394. key that is currently selected in the Key Listbox.
  1395.  
  1396. ************************************************************************
  1397. ************************************************************************
  1398. ************************************************************************
  1399. *********************  ABOUT BOX  **************************************
  1400. ************************************************************************
  1401. ************************************************************************
  1402. ************************************************************************
  1403.  
  1404. Help for About
  1405.  
  1406. Select About on the Help pull down
  1407. to display copyright information about IniMaint or SysMaint.
  1408.  
  1409. ************************************************************************
  1410. ************************************************************************
  1411. ************************************************************************
  1412. *****************************  DUMP  ***********************************
  1413. ************************************************************************
  1414. ************************************************************************
  1415. ************************************************************************
  1416.  
  1417. Help for Dump Variables
  1418.  
  1419. Select Dump Variables to display a Dump Variables
  1420. debugging dialog.  This selection will allow the user to "dump" the program
  1421. variables to a file.
  1422.  
  1423. ************************************************************************
  1424. ************************************************************************
  1425. ************************************************************************
  1426. ************************  OPTIONS  *************************************
  1427. ************************************************************************
  1428. ************************************************************************
  1429. ************************************************************************
  1430.  
  1431. Help for Options Selection
  1432.  
  1433. Select Options to display an Options
  1434. dialog.  This selection will allow the user to change the various options that
  1435. control whether the initial dialog will be displayed and whether the user
  1436. is to be asked before the current INI file is updated.
  1437.  
  1438. ************************************************************************
  1439. ************************************************************************
  1440. ************************************************************************
  1441. ***************************  GROUPS  ***********************************
  1442. ************************************************************************
  1443. ************************************************************************
  1444. ************************************************************************
  1445.  
  1446. Help for Groups
  1447.  
  1448. Select Groups to display a Groups
  1449. dialog.  This selection will allow the user to define, change and delete
  1450. Application Groups
  1451.  
  1452. ************************************************************************
  1453. ************************************************************************
  1454. ************************************************************************
  1455. ***********************  FILE MENU  ************************************
  1456. ************************************************************************
  1457. ************************************************************************
  1458. ************************************************************************
  1459.  
  1460. Help for File Menu
  1461.  
  1462. Select File to display a File
  1463. menu.  This selection will allow the user to do a number of different file
  1464. actions and Exit from IniMaint or SysMaint.  The File Menu Items are:
  1465.  
  1466.    New File
  1467.    User INI File Selection
  1468.    System INI File Selection
  1469.    Recall Files
  1470.    Refresh File
  1471.    Compare Files
  1472.    Set INI File Association
  1473.    Exit
  1474.    Dump Variables
  1475.  
  1476. ************************************************************************
  1477. ************************************************************************
  1478. ************************************************************************
  1479. *******************  ACTIONS MENU  *************************************
  1480. ************************************************************************
  1481. ************************************************************************
  1482. ************************************************************************
  1483.  
  1484. Help for Actions Menu
  1485.  
  1486. Select Actions to display an Actions
  1487. menu.  This selection will allow the user to make various changes to the
  1488. current INI file.  The Actions Menu Items are:
  1489.  
  1490.    Update Current Key Value
  1491.    Delete Application
  1492.    Delete Key
  1493.    Add Application
  1494.    Add Key to Application
  1495.    Add or Replace Key Value
  1496.    Rename Key
  1497.    Duplicate Key
  1498.    Rename Application
  1499.    Duplicate Application
  1500.    Copy Application(s)
  1501.    Move Application(s)
  1502.    Backup INI File(s)
  1503.    Register Your Copy
  1504.  
  1505. ************************************************************************
  1506. ************************************************************************
  1507. ************************************************************************
  1508. *********************  RECOVER MENU  ***********************************
  1509. ************************************************************************
  1510. ************************************************************************
  1511. ************************************************************************
  1512.  
  1513. Help for Recover Menu
  1514.  
  1515. Select Recover to display a Recover
  1516. menu.  This selection will allow the user to do various things to recover
  1517. from problems with various INI files.  The Recover Menu Items are:
  1518.  
  1519.    Change User INI File
  1520.    Change System INI File
  1521.    Change Both INI Files
  1522.    Repair INI File
  1523.    Condense INI Files
  1524.    Reset Non Write INI Files
  1525.    Test for Non Write INI Files
  1526.  
  1527. ************************************************************************
  1528. ************************************************************************
  1529. ************************************************************************
  1530. ***********************  EA MENU  **************************************
  1531. ************************************************************************
  1532. ************************************************************************
  1533. ************************************************************************
  1534.  
  1535. Help for EA Menu
  1536.  
  1537. Select Ext. Att. to display the EA
  1538. menu.  This selection will allow the user to do various things with the
  1539. Extended Attributes for Directories and/or Files.  The EA Menu Items are:
  1540.  
  1541.    EA Defaults Dialog
  1542.    Describe EA File Contents
  1543.    Update EAs from the Current File
  1544.    View EAs
  1545.    Test EAs
  1546.    Save EAs
  1547.    Copy EAs
  1548.    Move EAs
  1549.    Split EAs
  1550.    Join EAs
  1551.    Compare EAs
  1552.    Compare to Saved EAs
  1553.  
  1554. ************************************************************************
  1555. ************************************************************************
  1556. ************************************************************************
  1557. ********************  DESKTOP MENU  ************************************
  1558. ************************************************************************
  1559. ************************************************************************
  1560. ************************************************************************
  1561.  
  1562. Help for Desktop Menu
  1563.  
  1564. Select Desktop. to display the Desktop
  1565. menu.  This selection will allow the user to do various things with the
  1566. OS/2 Desktop.  The Desktop Menu Items are:
  1567.  
  1568.    Defaults Dialog
  1569.    Reset Desktop
  1570.    Backup Desktop
  1571.    Create Backup CMD File
  1572.    Create Restore CMD File
  1573.    Restore Desktop ID
  1574.    Restore Desktop Directory
  1575.    Restore Desktop INI Files
  1576.  
  1577. ************************************************************************
  1578. ************************************************************************
  1579. ************************************************************************
  1580. ************************  SIZE  ****************************************
  1581. ************************************************************************
  1582. ************************************************************************
  1583. ************************************************************************
  1584.  
  1585. Help for Size
  1586.  
  1587. Select Size to display the number of bytes of disk storage
  1588. that would be required to hold all or part of the current INI file, the
  1589. System INI file or the User INI File.
  1590.  
  1591. The user will be presented with a Size submenu that will allow
  1592. the selection of what to Size.
  1593.  
  1594. The selection Dialog will always contain four entries, one for the entire
  1595. file, one for the currently selected Application, one for the System 
  1596. INI file and one for the User INI File.  If there are any
  1597. Groups defined for the current INI file, then the Groups will also be 
  1598. listed.  If there are more than on Group defined for the current INI file,
  1599. then an All Groups selection will be displayed.  Once the selection is made,
  1600. the Size calculation will commence.  There will be a Calculating
  1601. Box displayed until the calculation completes.
  1602.  
  1603. ************************************************************************
  1604. ************************************************************************
  1605. ************************************************************************
  1606. **********************FIND MENU*****************************************
  1607. ************************************************************************
  1608. ************************************************************************
  1609. ************************************************************************
  1610.  
  1611. Help for Find Menu
  1612.  
  1613. Select Find to display a Find
  1614. menu.  This selection will allow the user to do a number of different find
  1615. actions.  The Find Menu Items are:
  1616.  
  1617.    Find Application Name
  1618.    Find Current Key Name
  1619.    Find Current Key Value
  1620.    Find Application Key Value
  1621.    Find Any Key Name
  1622.    Find Any Key Value
  1623.    Repeat Last Find
  1624.  
  1625. ************************************************************************
  1626. ************************************************************************
  1627. ************************************************************************
  1628. ******************  POPUP MENU  ****************************************
  1629. ************************************************************************
  1630. ************************************************************************
  1631. ************************************************************************
  1632.  
  1633. Help for Write Window Contents
  1634.  
  1635. Select Write to Write the contents of the Window under
  1636. the Mouse Pointer to a File.  The user will be asked to select the
  1637. Target File via the Standard File Dialog.  Once the File is selected,
  1638. the Window contents will be written to the file or, if the file
  1639. already exists, appended to the current contents of the file.
  1640.  
  1641. There will be a Header line with the Date and Time.  If the window
  1642. being written is the Key Name or Key Value window, then the currently
  1643. selected Application will be included in the Header.  If the window
  1644. being written is the Key Value window, then the currently selected
  1645. Key Name will also be included in the Heading information.
  1646.  
  1647. ************************************************************************
  1648.  
  1649. Help for Print Window Contents
  1650.  
  1651. Select Print to Print the contents of the Window under
  1652. the Mouse Pointer.
  1653.  
  1654. There will be a Header line with the Date and Time.  If the window
  1655. being printed is the Key Name or Key Value window, then the currently
  1656. selected Application will be included in the Header.  If the window
  1657. being printed is the Key Value window, then the currently selected
  1658. Key Name will also be included in the Heading information.
  1659.  
  1660. ************************************************************************
  1661.  
  1662. Help for Explain
  1663.  
  1664. Select Explain to popup a Dialog with an Explanation of
  1665. the meaning and use of the currently selected Application and Key for
  1666. those Applications that are recognized as standard OS/2 Applications.
  1667.  
  1668. If the currently selected Application is not known, then the Dialog
  1669. will simply state that fact.
  1670.  
  1671. If the Mouse Pointer is over the Application Window when the
  1672. Explain is requested, then the Dialog will only contain a general
  1673. explanation of the use of the Application.  If the Mouse Pointer is
  1674. over the Key Name or Key Value windows, then an attempt will be made
  1675. to give additional explanation information on the currently selected
  1676. Key.  The amount of information available depends on a number of
  1677. things, not the least of which is Carry Associates current level of
  1678. knowledge about the various entries.  Therefore, there is no general
  1679. way to characterize what the more detailed Explanation.  It will vary
  1680. from nothing to a detailed list of items.
  1681.  
  1682. Carry Associates expects that this will be a continually evolving
  1683. area and we will make every attempt to include everything we learn
  1684. about the INI files in the Explain text.  We would be very happy to
  1685. hear from any user who has additional information that could help.
  1686.  
  1687. We can be reached via any of the following:
  1688. Larry J. Martin
  1689. Carry Associates
  1690. 990 Ironwood Court
  1691. Marco Island FL 33937
  1692. Tel: 813-642-9126
  1693. Fax: 813-642-1007
  1694. Compuserve: 71435,470
  1695.  
  1696. ************************************************************************
  1697. ************************************************************************
  1698. ***************MAIN WINDOW FILE*****************************************
  1699. ************************************************************************
  1700. ************************************************************************
  1701. ************************************************************************
  1702.  
  1703. Help for Exit
  1704.  
  1705. Select Exit on the File pull down
  1706. or press F3 to leave IniMaint or SysMaint.
  1707.  
  1708.  
  1709.  
  1710. Selecting Exit will shutdown all open "threads"
  1711. before actually exiting the program so there may be a slight delay.
  1712.  
  1713. ************************************************************************
  1714.  
  1715. Help for New File Selection
  1716.  
  1717. Select New File to display a Files
  1718. dialog.  This selection will allow the user change the current INI file.
  1719.  
  1720. ************************************************************************
  1721.  
  1722. Help for User INI File Selection
  1723.  
  1724. Select User INI File to make the User INI File the current
  1725. file being displayed by IniMaint.  The User INI File is normally
  1726. OS2.INI.
  1727.  
  1728. ************************************************************************
  1729.  
  1730. Help for System INI File Selection
  1731.  
  1732. Select System INI File to make the System INI File the current
  1733. file being displayed by IniMaint.  The System INI File is normally 
  1734. OS2SYS.INI.
  1735.  
  1736. ************************************************************************
  1737.  
  1738. Help for File Refresh
  1739.  
  1740. Select Refresh File to cause IniMaint to reload the contents
  1741. of the current INI file from disk.  This entry would be used if some event
  1742. has occurred that may have modified the current INI file and it is desired
  1743. that these changes be reflected in the IniMaint listboxes and value area.
  1744.  
  1745. ************************************************************************
  1746.  
  1747. Help for Set File Association
  1748.  
  1749. Select Set File Association to put an entry in the User INI
  1750. file that will cause IniMaint to be automatically started with a specific
  1751. INI file as the current file simply by double clicking on the INI file in
  1752. the File Manager.  This option only applies to versions prior to 2.0, since
  1753. the Workplace Shell provides this capability in subsequent versions.
  1754.  
  1755. ************************************************************************
  1756.  
  1757. Help for Compare Files
  1758.  
  1759. Select Compare Files to compare two different INI files on
  1760. any one of three different levels.  The Source File will be the
  1761. Current INI file.  The user will be prompted for the
  1762. Target File.
  1763.  
  1764. If the Application Level Compare is selected the Listbox in
  1765. the Compare Dialog will list all Application Names that are in
  1766. one INI file, but not in the other.
  1767.  
  1768. If the Key Name Level Compare is selected the Listbox in
  1769. the Compare Dialog will list everything that the Application Name Level
  1770. lists plus all Application/Key Names that are in
  1771. one INI file, but not in the other.
  1772.  
  1773. If the Key Value Level Compare is selected the Listbox in
  1774. the Compare Dialog will list everything in the other two Levels
  1775. lists plus all Application/Key Names that are in
  1776. both INI files, but have Unequal Key Values.
  1777.  
  1778. ************************************************************************
  1779.  
  1780. Help for Recall Files
  1781.  
  1782. Select Recall Files will display a submenu with a list of
  1783. previous INI and/or EA files that have been the current file.  If any of
  1784. these files are selected, that file will become the current file and all
  1785. of the windows will be updated.  The maximum number of files displayed in the
  1786. Recall Submenu is a user option that is set in the Options Dialog.
  1787.  
  1788. ************************************************************************
  1789. ************************************************************************
  1790. ***************MAIN WINDOW ACTIONS**************************************
  1791. ************************************************************************
  1792. ************************************************************************
  1793.  
  1794. Help for Update Selection
  1795.  
  1796. Select Update Current Key to write any changes made to the
  1797. selected key value to the current INI file.  Until this option is selected
  1798. or a new Key or Application is selected and the user chooses to allow an
  1799. update, the changes made to the Key Value in the bottom window will not be
  1800. reflected in the current INI file.
  1801.  
  1802. ************************************************************************
  1803.  
  1804. Help for Delete Application
  1805.  
  1806. Select Delete Application to Delete the Currently Selected
  1807. Application.  Unless the Option has been turned off, the user will be asked
  1808. to confirm that the Application should be deleted.
  1809.  
  1810. ************************************************************************
  1811.  
  1812. Help for Delete Key
  1813.  
  1814. Select Delete Key to Delete the Currently Selected
  1815. Key.  Unless the Option has been turned off, the user will be asked
  1816. to confirm that the Key should be deleted.
  1817.  
  1818. ************************************************************************
  1819.  
  1820. Help for Add Application
  1821.  
  1822. Select Add Application to Add a New Application to the current
  1823. INI File.  This Selection will ask the user for the name of the New
  1824. Application.  Once the name is verified, this Selection will fall through
  1825. to the Add Key Selection.
  1826.  
  1827. ************************************************************************
  1828.  
  1829. Help for Add Key
  1830.  
  1831. Select Add Key to Add a New Key to the current Application
  1832. This Selection will ask the user for the name of the New Key.  Once the name
  1833. is verified, this Selection will fall through to the Replace Key Selection.
  1834.  
  1835. ************************************************************************
  1836.  
  1837. Help for Add or Replace Key Value
  1838.  
  1839. Select Add or Replace Key Value to display a Dialog that will allow
  1840. the user to modify the Value of the current Key.  This is the only Selection
  1841. that will allow the user to change the length of a Key Value.  The bottom
  1842. Window of the Main Window can be used to modify the Value of a Key, but it
  1843. cannot be used to change the length of a Value.
  1844.  
  1845. ************************************************************************
  1846.  
  1847. Help for Rename Key
  1848.  
  1849. Select Rename Key to Rename the Currently Selected
  1850. Key.  The old Key Name will no longer exist in the Current INI file.  If you
  1851. want to retain the old Key Name use Duplicate Key.
  1852.  
  1853. ************************************************************************
  1854.  
  1855. Help for Duplicate Application
  1856.  
  1857. Select Duplicate Application to Duplicate the Currently Selected
  1858. Application using a different Application Name.
  1859. The user will first be prompted to enter a New Application Name, then all
  1860. Key Names and Key Values will be duplicated under the new Application.
  1861.  
  1862. No check is made to insure that the New Application Name is not a
  1863. duplicate of an existing Application.  If the New Application is a duplicate
  1864. then the effect of executing this item will be to copy every Key Name from
  1865. the Selected Application to the New Application.  If the Key Name already
  1866. exists in the New Application, the Value will be replaced by the Value from
  1867. the Selected Application.  If the Key Name does not exist in the New
  1868. Application, then it will be inserted into the New Application.
  1869.  
  1870. The old Application will still exist in the Current INI file.  If you do not
  1871. want to retain the old Application then the Delete Application
  1872. item on the Action Menu can be used to delete the old Application.
  1873.  
  1874. ************************************************************************
  1875.  
  1876. Help for Rename Application
  1877.  
  1878. Select Rename Application to Rename the Currently Selected
  1879. Application using a different Application Name.
  1880. The user will first be prompted to enter a New Application Name, then all
  1881. Key Names and Key Values will be copied to new Application.
  1882.  
  1883. No check is made to insure that the New Application Name is not a
  1884. duplicate of an existing Application.  If the New Application is a duplicate
  1885. then the effect of executing this item will be to copy every Key Name from
  1886. the Selected Application to the New Application.  If the Key Name already
  1887. exists in the New Application, the Value will be replaced by the Value from
  1888. the Selected Application.  If the Key Name does not exist in the New
  1889. Application, then it will be inserted into the New Application.
  1890.  
  1891. The old Application will no longer exist in the Current INI file.  If you
  1892. want to retain the old Application use Duplicate Application.
  1893.  
  1894. ************************************************************************
  1895.  
  1896. Help for Duplicate Key
  1897.  
  1898. Select Duplicate Key to Duplicate the Currently Selected
  1899. Key Value using a different Key Name and, optionally, a different Application
  1900. Name.  The user will first be prompted to enter a New Application Name and
  1901. can either change the Application or leave it the same.  If the Application
  1902. Name is changed, then the Key Name does not need to be changed and the Key
  1903. Value will be copied to the new Application using the current Key Name.  If
  1904. the Application Name is not changed, then Key Name must be changed.
  1905. The old Key Name will still exist in the Current INI file.  If you
  1906. do not want to retain the old Key Name use Rename Key.
  1907.  
  1908. ************************************************************************
  1909.  
  1910. Help for Copy
  1911.  
  1912. Select Copy to Copy one or more Applications from the current
  1913. INI file to a Target INI File, to make a copy of the System INI File, the
  1914. User INI File or Both the System and User INI Files.
  1915.  
  1916. The user will first be asked to select a Target for the Copy and will
  1917. be presented with a Copy submenu that will allow the selection
  1918. of what to Copy.
  1919.  
  1920. The submenu will always contain five entries, one for the entire
  1921. file, one for the currently selected Application and one each for
  1922. the System, User and Both INI Files.  If there are any
  1923. Groups defined for the current INI file, then the Groups will also be 
  1924. listed.  If there are more than on Group defined for the current INI file,
  1925. then an All Groups selection will be displayed.  Once the selection is made,
  1926. the Copy will commence.  There will be a Copy in Progress Box
  1927. displayed until the Copy completes.
  1928.  
  1929. ************************************************************************
  1930.  
  1931. Help for Backup
  1932.  
  1933. Select Backup to make a backup copy of either the System INI
  1934. File, the User INI file or both the System and User INI Files.  In order to
  1935. backup these files a target file must be chosen for each source file.  If
  1936. no target has been specified or if the Option to Ask Before Backup is set,
  1937. the user will be asked to specify a target file for the backup.  Once a
  1938. target is specified for the System and/or User INI Files, then the user
  1939. will not be asked to verify the target filename if the Ask Before Backup
  1940. Option is not set.
  1941.  
  1942. If the target backup file already exists, it will be erased before the
  1943. backup is done.  This is necessary to insure that the backup does not contain
  1944. old information.
  1945.  
  1946. If the option to display a copy in progress is set there will be a 
  1947. Copy in Progress Box displayed until the Copy completes.
  1948.  
  1949. ************************************************************************
  1950.  
  1951. Help for Move
  1952.  
  1953. Select Move to Move one or more Applications from the current
  1954. INI file to a Target INI File.  
  1955.  
  1956. The user will first be asked to select a Target for the Move and will
  1957. be presented with a Move submenu that will allow the selection
  1958. of what to Move.
  1959.  
  1960. The submenu will always contain two entries, one for the entire
  1961. file and another for the currently selected Application.  If there are any
  1962. Groups defined for the current INI file, then the Groups will also be 
  1963. listed.  If there are more than on Group defined for the current INI file,
  1964. then an All Groups selection will be displayed.  Once the selection is made,
  1965. the Move will commence.  There will be a Move in Progress Box
  1966. displayed until the Move completes.  Once the Move is complete, the Moved
  1967. Applications will be deleted from the Current INI file.
  1968.  
  1969. ************************************************************************
  1970. ************************************************************************
  1971. ***************MAIN WINDOW RECOVER**************************************
  1972. ************************************************************************
  1973. ************************************************************************
  1974. ************************************************************************
  1975.  
  1976. Help for Change User INI File
  1977.  
  1978. Select Change User INI File to change to a new User INI File.
  1979. The normal User INI file is OS2.INI.  Normally this
  1980. would only be done because the user was having trouble deleting an entry
  1981. from the User INI file, therefore, changing files would be part of a
  1982. multiple step process:
  1983. It is Strongly Suggested that you have a safe backup of your INI
  1984. files before you attempt to use this capability.  In addition insure that
  1985. you know what you are doing before you attempt to make changes
  1986. that OS/2 would not allow you to make.  It is possible that the actions 
  1987. described below will be successful and still leave you in a condition that
  1988. will cause you problems.
  1989. When you change either the User or System INI files, your Desktop will revert
  1990. back to the Desktop at Boot time.  Currently running PM Applications will
  1991. continue to run.  Currently, the effect on files being printed by the 
  1992. Spooler is not known.  It is suggested that you insure that the Spooler is
  1993. not doing anything when you change the User or System INI files.
  1994.  
  1995. In addition, the switch of the User and System INI files will not persist
  1996. across booting of OS/2.  In other words, if you change either of the files
  1997. and then re-boot, you will go back to the original User and System INI files.
  1998. Therefore, changing one of the files, then deleting a critical entry and
  1999. re-booting before you replace the critical entry will cause unknown, but
  2000. almost invariably bad, events to occur and could result in a system that
  2001. will not boot at all.
  2002.  
  2003. Insure that IniMaint was using the current User INI File.
  2004.  
  2005. Use the COPY IniMaint function to make a Copy of the current
  2006. User INI File.
  2007.  
  2008. Select this entry to change the User INI file to the Copy.
  2009.  
  2010. Use the DELETE or MOVE  ability of IniMaint to
  2011. modify the old User INI File, which will still be the current IniMaint INI
  2012. File.
  2013.  
  2014. Select this entry again to make the changed file the User INI file.  If
  2015. an error is encountered when an attempt is made to switch back, then you
  2016. must use the IniMaint COPY function to Copy any Applications you
  2017. modified from the Copy to the original File until you can switch back
  2018. successfully.
  2019.  
  2020. ************************************************************************
  2021.  
  2022. Help for Change System INI File
  2023.  
  2024. Select Change System INI File to change to a new System INI File.
  2025. The normal System INI file is OS2SYS.INI.  Normally this
  2026. would only be done because the user was having trouble deleting an entry
  2027. from the System INI file, therefore, changing files would be part of a
  2028. multiple step process:
  2029. It is Strongly Suggested that you have a safe backup of your INI
  2030. files before you attempt to use this capability.  In addition insure that
  2031. you know what you are doing before you attempt to make changes
  2032. that OS/2 would not allow you to make.  It is possible that the actions 
  2033. described below will be successful and still leave you in a condition that
  2034. will cause you problems.
  2035. When you change either the User or System INI files, your Desktop will revert
  2036. back to the Desktop at Boot time. Currently running PM Applications will
  2037. continue to run. Currently, the effect on files being printed by the 
  2038. Spooler is not known.  It is suggested that you insure that the Spooler is
  2039. not doing anything when you change the User or System INI files.
  2040.  
  2041. In addition, the switch of the User and System INI files will not persist
  2042. across booting of OS/2.  In other words, if you change either of the files
  2043. and then re-boot, you will go back to the original User and System INI files.
  2044. Therefore, changing one of the files, then deleting a critical entry and
  2045. re-booting before you replace the critical entry will cause unknown, but
  2046. almost invariably bad, events to occur and could result in a system that
  2047. will not boot at all.
  2048.  
  2049. Insure that IniMaint was using the current System INI File.
  2050.  
  2051. Use the COPY IniMaint function to make a Copy of the current
  2052. System INI File.
  2053.  
  2054. Select this entry to change the System INI file to the Copy.
  2055.  
  2056. Use the DELETE or MOVE ability of IniMaint to
  2057. modify the old System INI File, which will still be the current IniMaint INI
  2058. File.
  2059.  
  2060. Select this entry again to make the changed file the System INI file.  If
  2061. an error is encountered when an attempt is made to switch back, then you
  2062. must use the IniMaint COPY function to Copy any Applications you
  2063. modified from the Copy to the original File until you can switch back
  2064. successfully.
  2065.  
  2066. ************************************************************************
  2067.  
  2068. Help for Change User INI File
  2069.  
  2070. Select Change Both INI Files to change to a new User INI File
  2071. and a new System INI File.  The normal User INI file is 
  2072. OS2.INI.   The normal System INI file is 
  2073. OS2SYS.INI.  Normally this
  2074. would only be done because the user was having trouble deleting an entry
  2075. from the User INI file, therefore, changing files would be part of a
  2076. multiple step process:
  2077. It is Strongly Suggested that you have a safe backup of your INI
  2078. files before you attempt to use this capability.  In addition insure that
  2079. you know what you are doing before you attempt to make changes
  2080. that OS/2 would not allow you to make.  It is possible that the actions 
  2081. described below will be successful and still leave you in a condition that
  2082. will cause you problems.
  2083. When you change either the User or System INI files, your Desktop will revert
  2084. back to the Desktop at Boot time.  Currently running PM Applications will
  2085. continue to run.  Currently, the effect on files being printed by the 
  2086. Spooler is not known.  It is suggested that you insure that the Spooler is
  2087. not doing anything when you change the User or System INI files.
  2088.  
  2089. In addition, the switch of the User and System INI files will not persist
  2090. across booting of OS/2.  In other words, if you change either of the files
  2091. and then re-boot, you will go back to the original User and System INI files.
  2092. Therefore, changing one of the files, then deleting a critical entry and
  2093. re-booting before you replace the critical entry will cause unknown, but
  2094. almost invariably bad, events to occur and could result in a system that
  2095. will not boot at all.
  2096.  
  2097. Insure that IniMaint was using the current User INI File.
  2098.  
  2099. Use the COPY IniMaint function to make a Copy of the current
  2100. User INI File.
  2101.  
  2102. Change IniMaint to the current System INI File.
  2103.  
  2104. Use the COPY IniMaint function to make a Copy of the current
  2105. System INI File.
  2106.  
  2107. Select this entry to change Both INI files to the Copies.
  2108.  
  2109. Use the DELETE or MOVE ability of IniMaint to
  2110. modify the old User and System INI Files.
  2111. File.
  2112.  
  2113. Select this entry again to make the changed files the User and System
  2114. INI file.  If an error is encountered when an attempt is made to switch back,
  2115. then you must use the IniMaint COPY function to Copy any
  2116. Applications you modified from the Copy to the original File until you can
  2117. switch back successfully.
  2118.  
  2119. ************************************************************************
  2120.  
  2121. Help for Repair INI File
  2122.  
  2123. Select Repair INI File to have the currently available 
  2124. Repair actions performed on the appropriate INI File.  A dialog
  2125. will be displayed that gives the user the ability to select the Type of
  2126. Repair and which of the available Repair Checks they want done.  If a Repair
  2127. Type is chosen that will actually remove items from the Current INI file, a
  2128. Save INI file must be chosen and anything removed from or changed
  2129. in the Current file will be written to the Save file.
  2130.  
  2131. ************************************************************************
  2132.  
  2133. Help for Condense INI File
  2134.  
  2135. Select Condense to Condense one or more INI files.  Whenever
  2136. a change is made to any INI file the space used by to old version of the
  2137. changed data is marked unused.  Even though this space should be reclaimed
  2138. when subsequent changes are made, any INI file that has a lot of activity
  2139. will tend to accumulate a large amount of fragmented and unused space.  The
  2140. only way to reclaim this space to to use the Prf APIs to copy the contents
  2141. of the INI file to another file, erase the old file and copy the contents
  2142. back, this entry accomplishes this task.
  2143.  
  2144. In addition, for the System INI file, OS2SYS.INI, and the User INI file,
  2145. OS2.INI, there is an additional complication.  The existing file cannot be
  2146. erased as long as it is the System or User INI file currently being used by
  2147. OS/2.  However, there is an Prf API that can change the current System or
  2148. User INI file to another file.  IniMaint uses these APIs to change the files
  2149. so that it can delete the normal System or User INI files.  That way, when
  2150. these files are recovered, they have the same name, but all the extra unused
  2151. space has been removed.
  2152. It is Strongly Suggested that you have a safe backup of your INI
  2153. files before you attempt to use this capability.  In addition, it is 
  2154. Extremely Important that you not interrupt the Condense or you can
  2155. leave your desktop in an indeterminate condition.  The primary reason that
  2156. a backup is recommended is because it is possible for some external event,
  2157. such as a power failure, to occur during the Condense and this will require
  2158. that you go back to the backup copies.
  2159. If you are Condensing either the System or User
  2160. INI files, you should not make any modifications to your desktop during
  2161. the Condense.  Depending on the timing of the changes you could end up
  2162. with the modifications being wiped out  during the restore
  2163. portion of the Condense or, even worse, the modification could end up
  2164. partially reflected in the Condensed files 
  2165. resulting in unexpected, but invariably bad events.
  2166.  
  2167. The user will first be asked to select a Temporary INI file that will be
  2168. used to temporarily hold the contents of the INI file being Condensed.  This
  2169. should be a file that does not currently exist.  If the file does exist, the
  2170. contents will be destroyed but the user will receive a warning and have
  2171. an opportunity to cancel the Condense of the file if they wish to use a
  2172. different Temporary file.
  2173.  
  2174. The submenu shows the different files that can be Condensed.
  2175.  
  2176. ************************************************************************
  2177.  
  2178. Help for Reset Non Write INI Files
  2179.  
  2180. Select Reset Non Write INI Files to have the OS2.INI and
  2181. OS2SYS.INI files changed from a condition where they cannot be updated
  2182. back to a normal condition.  This menu item is not normally needed, since
  2183. IniMaint and SysMaint will both recognize when the INI files cannot be
  2184. written to and will automatically notify the user and ask them if they
  2185. want the condition corrected.  However, if a user has chosen to have
  2186. IniMaint or SysMaint store their operational information in a file other
  2187. than the OS2.INI file, then this condition would not be recognized unless
  2188. the user chose to make a change to the OS2.INI or OS2SYS.INI files.  For
  2189. this reason, a facility that would allow the user to manually fix the
  2190. situation has been added here.
  2191.  
  2192.  
  2193. Help for Test for Non Write INI Files
  2194.  
  2195. Select Test for Non Write INI Files to have the OS2.INI and
  2196. OS2SYS.INI files tested to see if they can be updated.
  2197. This menu item is not normally needed, since
  2198. IniMaint and SysMaint will both recognize when the INI files cannot be
  2199. written to and will automatically notify the user and ask them if they
  2200. want the condition corrected.  However, if a user has chosen to have
  2201. IniMaint or SysMaint store their operational information in a file other
  2202. than the OS2.INI file, then this condition would not be recognized unless
  2203. the user chose to make a change to the OS2.INI or OS2SYS.INI files.  For
  2204. this reason, a facility that would allow the user to manually make the
  2205. same test has been added here.
  2206.  
  2207. ************************************************************************
  2208. ************************************************************************
  2209. ***************MAIN WINDOW EAS******************************************
  2210. ************************************************************************
  2211. ************************************************************************
  2212. ************************************************************************
  2213.  
  2214. Help for Describe EA File Contents
  2215.  
  2216. Select Describe EA File Contents to display a Message
  2217. Box that will describe the root Directory or File that was used to
  2218. create the current displayed set of Extended Attributes, what is
  2219. included in terms of Files and Directories and whether Subdirectories
  2220. were also searched.
  2221.  
  2222.  
  2223. Help for Update EAs from the Current File
  2224.  
  2225. Select Update EAs from the Current File to Update the actual
  2226. Extended Attributes for the Files and/or Directories that are in the 
  2227. currently displayed file.
  2228.  
  2229. This would normally be used if a set of Extended Attributes were Edited,
  2230. had been modified by the user and the user now wanted the modified
  2231. Extended Attributes Joined to the actual Files and/or Directories.
  2232.  
  2233.  
  2234. Help for View Extended Attributes
  2235.  
  2236. Select View to display the submenu that lists the
  2237. different set of Directories and/or Files that can be viewed.  
  2238. Once one of the submenu selections are made, the user will be
  2239. presented with an appropriate File/Directory/Drive Dialog
  2240. that will allow the selection of the Root for the View.  Once the Root
  2241. is selected a file name will be built to hold the Extended
  2242. Attributes.  This name can be built automatically or can be selected
  2243. by the user depending on the appropriate Default option.  If the file
  2244. already exists it will be overwritten automatically or the user will
  2245. be asked if they want it overwritten, based on the appropriate
  2246. Default Option.  Once all of this is done the Extended Attributes for
  2247. the Directories and/or Files will be extracted and placed in the
  2248. selected EA file Once the EAs have all been processed, the EA file
  2249. will appear as the current INI file.
  2250.  
  2251. The Application Listbox will contain the names of the Directories
  2252. and/or Files that have been found.
  2253.  
  2254. The Key Listbox will contain the List of EAs for the Directory or
  2255. File that is currently selected in the Application Listbox.
  2256.  
  2257. The Key Value window will contain the actual data for the EA.
  2258.  
  2259. If the Default option Keep Temporary Files is not
  2260. checked, then the user will never be asked for an Extended Attribute
  2261. Filename, since the created file will be automatically deleted as
  2262. soon as the View is completed.  In addition, the generated filename
  2263. will not be placed in the File Recall list, since it does not make
  2264. sense to Recall a file that has been deleted.
  2265.  
  2266. Refer to the Whatisea.txt file for a more complete
  2267. description of how the Extended Attributes are displayed.
  2268.  
  2269.  
  2270. Help for Test Extended Attributes
  2271.  
  2272. Select Test to display the submenu that lists the
  2273. different set of Directories and/or Files that can be tested.  
  2274. Once one of the submenu selections are made, the user will be
  2275. presented with an appropriate File/Directory/Drive Dialog
  2276. that will allow the selection of the Root for the Test.  Once the Root
  2277. is selected the Extended Attributes for the Directories and/or
  2278. Files will be examined and a Dialog will appear listing each File
  2279. and/or Directory along with a notation as to whether the Extended
  2280. Attributes are Valid or, if they are not Valid, what error was found.
  2281.  
  2282.  
  2283. Help for Save Extended Attributes
  2284.  
  2285. Select Save to display the submenu that lists the
  2286. different set of Directories and/or Files that can have their
  2287. Extended Attributes saved.  Once one of the submenu selections are
  2288. made, the user will be presented with an appropriate
  2289. File/Directory/Drive Dialog that will allow the selection of
  2290. the Root for the Save.  Once the Root is selected a file name will be
  2291. built to hold the Extended Attributes.  This name can be built
  2292. automatically or can be selected by the user depending on the
  2293. appropriate Default option.  If the file already exists it will be
  2294. overwritten automatically or the user will be asked if they want it
  2295. overwritten, based on the appropriate Default Option.  Once all of
  2296. this is done the Extended Attributes for the Directories and/or
  2297. Files will be extracted and placed in the selected EA file.  The
  2298. actual Extended Attributes of the Source Files and/or Directories
  2299. will not be altered.
  2300.  
  2301.  
  2302. Help for Copy Extended Attributes
  2303.  
  2304. Select Copy to display the submenu that lists the
  2305. different set of Directories and/or Files that can have their
  2306. Extended Attributes copied.  Once one of the submenu selections are
  2307. made, the user will be presented with an appropriate
  2308. File/Directory/Drive Dialog that will allow the selection of
  2309. the Source Root for the Copy.  Once the Source Root is selected the
  2310. user will be presented with an appropriate
  2311. File/Directory/Drive Dialog that will allow the selection of
  2312. the Target Root for the Copy.  Once the Target Root is selected the
  2313. Extended Attributes for the Source Directories and/or Files will
  2314. be extracted and Copied to the File or Directory that has the same
  2315. name in the Target.  The Extended Attributes of the Source Files
  2316. and/or Directories will be not be modified so that after the Copy
  2317. these Files and/or Directories will have the same Extended
  2318. Attributes as before the Copy.
  2319.  
  2320. For example, if the Extended Attributes for Files were Copied from
  2321. a Directory \SOURCE on Drive D to a Directory \TARGET on Drive
  2322. E, and there was a file SOMESTUF.TXT in both Directories, then the
  2323. Extended Attributes for the file in the Source Directory would be
  2324. copied to the same file in the Target.
  2325.  
  2326.  
  2327. Help for Move Extended Attributes
  2328.  
  2329. Select Move to display the submenu that lists the
  2330. different set of Directories and/or Files that can have their
  2331. Extended Attributes moved.  Once one of the submenu selections are
  2332. made, the user will be presented with an appropriate
  2333. File/Directory/Drive Dialog that will allow the selection of
  2334. the Source Root for the Move.  Once the Source Root is selected the
  2335. user will be presented with an appropriate
  2336. File/Directory/Drive Dialog that will allow the selection of
  2337. the Target Root for the Move.  Once the Target Root is selected the
  2338. Extended Attributes for the Source Directories and/or Files will
  2339. be extracted and Moved to the File or Directory that has the same
  2340. name in the Target.  The Extended Attributes of the Source Files
  2341. and/or Directories will be Deleted so that after the Move these
  2342. Files and/or Directories will not have any Extended Attributes.
  2343.  
  2344. For example, if the Extended Attributes for Files were Moved from
  2345. a Directory \SOURCE on Drive D to a Directory \TARGET on Drive
  2346. E, and there was a file SOMESTUF.TXT in both Directories, then the
  2347. Extended Attributes for the file in the Source Directory would be
  2348. Moved to the same file in the Target.
  2349.  
  2350.  
  2351. Help for Split Extended Attributes
  2352.  
  2353. Select Split to display the submenu that lists the
  2354. different set of Directories and/or Files that can have their
  2355. Extended Attributes split.  Once one of the submenu selections are
  2356. made, the user will be presented with an appropriate
  2357. File/Directory/Drive Dialog that will allow the selection of
  2358. the Root for the Split.  Once the Root is selected a file name will
  2359. be built to hold the Extended Attributes.  This name can be built
  2360. automatically or can be selected by the user depending on the
  2361. appropriate Default option.  If the file already exists it will be
  2362. overwritten automatically or the user will be asked if they want it
  2363. overwritten, based on the appropriate Default Option.  Once all of
  2364. this is done the Extended Attributes for the Directories and/or
  2365. Files will be extracted and placed in the selected EA file.  The
  2366. actual Extended Attributes of the Source Files and/or Directories
  2367. will be deleted and these Files and/or Directories will no longer
  2368. have any Extended Attributes.
  2369.  
  2370.  
  2371. Help for Join Extended Attributes
  2372.  
  2373. Select Join to display the submenu that lists the
  2374. different set of Directories and/or Files that can have their
  2375. Extended Attributes Joined.  Once one of the submenu selections are
  2376. made, the user will be presented with an appropriate
  2377. File/Directory/Drive Dialog that will allow the selection of
  2378. the Root for the Join.  Once the Root is selected the Extended
  2379. Attributes in the Current File will be Joined to any Files and/or
  2380. Directories in the Target that have the same name as a corresponding
  2381. File or Directory in the Current File.
  2382.  
  2383. This function is very similar to the Update EA's from the Current
  2384. File except that the Extended Attributes can be Joined to a set of
  2385. Files and/or Directories different from the original ones.
  2386.  
  2387.  
  2388. Help for Compare Extended Attributes
  2389.  
  2390. Select Compare to Compare the Extended Attributes for
  2391. one set of Files and/or Directories to those current on another
  2392. set of Files and/or Directories.  When this selection is made the
  2393. first action is to display the submenu that lists the different set
  2394. of Directories and/or Files that can be compared.  Once one of the
  2395. submenu selections are made, the user will be presented with an
  2396. appropriate File/Directory/Drive Dialog that will allow the
  2397. selection of the Source Root for the Compare.  Once the Source Root
  2398. is selected the user will be presented with an appropriate
  2399. File/Directory/Drive Dialog that will allow the selection of
  2400. the Target Root for the Compare.  Once the Target Root is selected a
  2401. file name will be built to hold the Source Extended Attributes.  This
  2402. name can be built automatically or can be selected by the user
  2403. depending on the appropriate Default option.  If the file already
  2404. exists it will be overwritten automatically or the user will be asked
  2405. if they want it overwritten, based on the appropriate Default
  2406. Option.  Then a file name will be built to hold the Target Extended
  2407. Attributes.  This name can be built automatically or can be selected
  2408. by the user depending on the appropriate Default option.  If the file
  2409. already exists it will be overwritten automatically or the user will
  2410. be asked if they want it overwritten, based on the appropriate
  2411. Default Option.  Once all of this is done the Compare Dialog will
  2412. appear and do a Key Value level Compare of the Extended Attribute
  2413. information between the Source and Target.  Once the Compare is
  2414. completed, the files that contain the Extended Attributes will be
  2415. deleted if the user has selected this Default Option.
  2416.  
  2417. If the Default option Keep Temporary Files is not
  2418. checked, then the user will never be asked for an Extended Attribute
  2419. Filename, since the created file will be automatically deleted as
  2420. soon as the View is completed.  In addition, the generated filename
  2421. will not be placed in the File Recall list, since it does not make
  2422. sense to Recall a file that has been deleted.
  2423.  
  2424.  
  2425. Help for Compare to Saved Extended Attributes
  2426.  
  2427. Select Compare to Saved to Compare the Extended
  2428. Attributes that are currently on a set of Files and/or
  2429. Directories to those that have already been saved in an EA file.  For
  2430. example, this entry would be used to compare the current Extended
  2431. Attributes for a set of Files and/or Directories to those saved
  2432. previously, in order to see what kinds of changes have occurred. When
  2433. this selection is made the first action is to display the submenu
  2434. that lists the different set of Directories and/or Files that can
  2435. be compared.  Once one of the submenu selections are made, the user
  2436. will be presented with an appropriate File/Directory/Drive
  2437. Dialog that will allow the selection of the Source Root for the
  2438. Compare.  Once the Source Root is selected the user will be presented
  2439. with a File Dialog that will allow the selection of the Target EA
  2440. File for the Compare.  Once the Target Root is selected a file name
  2441. will be built to hold the Source Extended Attributes.  This name can
  2442. be built automatically or can be selected by the user depending on
  2443. the appropriate Default option.  If the file already exists it will
  2444. be overwritten automatically or the user will be asked if they want
  2445. it overwritten, based on the appropriate Default Option.  Once all of
  2446. this is done the Compare Dialog will appear and do a Key Value level
  2447. Compare of the Extended Attribute information between the Source and
  2448. Target.  Once the Compare is completed, the files that contain the
  2449. Source Extended Attributes will be deleted if the user has selected
  2450. this Default Option.
  2451.  
  2452. If the Default option Keep Temporary Files is not
  2453. checked, then the user will never be asked for an Extended Attribute
  2454. Filename, since the created file will be automatically deleted as
  2455. soon as the View is completed.  In addition, the generated filename
  2456. will not be placed in the File Recall list, since it does not make
  2457. sense to Recall a file that has been deleted.
  2458.  
  2459.  
  2460. Help for Select EAs for a Single File
  2461.  
  2462. Select EAs for File to display the Extended Attributes for a single
  2463. file.  A File Selection Dialog will be displayed allowing the user to select
  2464. the file.
  2465.  
  2466.  
  2467. Help for Select EAs for a Single Path
  2468.  
  2469. Select EAs for Path to display the Extended Attributes for a single
  2470. directory.  A File Selection Dialog will be displayed allowing the user to select
  2471. the directory.
  2472.  
  2473.  
  2474. Help for Select EAs for all Files in Directory
  2475.  
  2476. Select EAs for all Files in Directory to display the
  2477. Extended Attributes for all the Files in a single Subdirectory.  A
  2478. File Selection Dialog will be displayed allowing the user to select
  2479. the Root Directory to use.
  2480.  
  2481.  
  2482. Help for Select EAs for all Directories in Directory
  2483.  
  2484. Select EAs for all Directories in Directory to display
  2485. the Extended Attributes for all the Directories in a single
  2486. Subdirectory.  A File Selection Dialog will be displayed allowing the
  2487. user to select the Root Directory to use.
  2488.  
  2489.  
  2490. Help for Select EAs for all Files and Directories in Directory
  2491.  
  2492. Select EAs for all Files and Directories in Directory to
  2493. display the Extended Attributes for all the Files and Directories in
  2494. a single Subdirectory.  A File Selection Dialog will be displayed
  2495. allowing the user to select the Root Directory to use.
  2496.  
  2497.  
  2498. Help for Select EAs for all Files in Directory and Subdirectory
  2499.  
  2500. Select EAs for all Files in Directory and Subdirectory
  2501. to display the Extended Attributes for all the Files in a single
  2502. Directory and all of it's Subdirectories.  A File Selection Dialog
  2503. will be displayed allowing the user to select the Root Directory to
  2504. use.
  2505.  
  2506.  
  2507. Help for Select EAs for all Directories in Directory and Subdirectory
  2508.  
  2509. Select EAs for all Directories in Directory and
  2510. Subdirectory to display the Extended Attributes for all the
  2511. Directories in a single Directory and all of it's Subdirectories.  A
  2512. File Selection Dialog will be displayed allowing the user to select
  2513. the Root Directory to use.
  2514.  
  2515.  
  2516. Help for Select EAs for all Files and Directories in Directory and Subdirectory
  2517.  
  2518. Select EAs for all Files and Directories in Directory and
  2519. Subdirectory to display the Extended Attributes for all the
  2520. Files and Directories in a single Directory and all of it's
  2521. Subdirectories.  A File Selection Dialog will be displayed allowing
  2522. the user to select the Root Directory to use.
  2523.  
  2524.  
  2525. Help for Select EAs for all Files on Drive
  2526.  
  2527. Select EAs for all Files on Drive to display the
  2528. Extended Attributes for all the Files on a Drive.  A Drive Selection
  2529. Dialog will be displayed allowing the user to select the Drive to
  2530. use.
  2531.  
  2532.  
  2533. Help for Select EAs for all Directories on Drive
  2534.  
  2535. Select EAs for all Directories on Drive to display the
  2536. Extended Attributes for all the Directories on a Drive.  A Drive
  2537. Selection Dialog will be displayed allowing the user to select the
  2538. Drive to use.
  2539.  
  2540.  
  2541. Help for Select EAs for all Files and Directories on Drive
  2542.  
  2543. Select EAs for all Files and Directories on Drive to
  2544. display the Extended Attributes for all the Files and Directories on
  2545. a Drive.  A Drive Selection Dialog will be displayed allowing the
  2546. user to select the Drive to use.
  2547.  
  2548. ************************************************************************
  2549. ************************************************************************
  2550. ***************MAIN WINDOW FIND*****************************************
  2551. ************************************************************************
  2552. ************************************************************************
  2553. ************************************************************************
  2554.  
  2555. Help for Find Application Name
  2556.  
  2557. Select Application Name on the Find menu to do a
  2558. Find on the entries in the Application Listbox.  If the Find is successful
  2559. the Application Name will be Selected and the Listbox will be scrolled to
  2560. insure the found name is visible.
  2561.  
  2562. ************************************************************************
  2563.  
  2564. Help for Find Current Key Name
  2565.  
  2566. Select Current Key Name on the Find menu to do a
  2567. Find on the entries in the Current Key Listbox.  If the Find is successful
  2568. the Current Key Name will be Selected and the Listbox will be scrolled to
  2569. insure the found name is visible.
  2570.  
  2571. ************************************************************************
  2572.  
  2573. Help for Find Current Key Value
  2574.  
  2575. Select Current Key Value on the Find menu to do a
  2576. Find on the entries in the Current Key Value MLE.  If the Find is successful
  2577. the Current Key Value will be Selected and the MLE will be scrolled to
  2578. insure the found value is visible.
  2579.  
  2580. ************************************************************************
  2581.  
  2582. Help for Find Application Key Value
  2583.  
  2584. Select Application Key Value on the Find menu to
  2585. do a Find on all of the Key Values for the current Application.  If the Find
  2586. is successful the Current Key Name will be Selected, the Listbox will be
  2587. scrolled to insure the selected Name is visible, the found Key Value will be
  2588. loaded into the Key Value MLE, and the Key Value MLE will be scrolled to
  2589. insure the found Value is visible.
  2590.  
  2591. ************************************************************************
  2592.  
  2593. Help for Find Any Key Name
  2594.  
  2595. Select Any Key Name on the Find menu to do a
  2596. Find on all of the Key Names in the current INI file.  If the Find is
  2597. successful the Application that contains the Key Name will be selected in
  2598. the Application Listbox, the Application Listbox will be scrolled to insure
  2599. the selected Application is visible, the Key Names will be loaded into the
  2600. Key Listbox, the Current Key Name will be Selected and the Listbox will be
  2601. scrolled to insure the found Name is visible.
  2602.  
  2603. ************************************************************************
  2604.  
  2605. Help for Find Any Key Value
  2606.  
  2607. Select Any Key Value on the Find menu to do a
  2608. Find on all of the Key Values in the current INI file.  If the Find is
  2609. successful the Application that contains the Key Value will be selected in
  2610. the Application Listbox, the Application Listbox will be scrolled to insure
  2611. the selected Application is visible, the Key Names will be loaded into the
  2612. Key Listbox, the Current Key Name will be Selected, the Listbox will be
  2613. scrolled to insure the selected Name is visible, the found Key Value will be
  2614. loaded into the Key Value MLE, and the Key Value MLE will be scrolled to
  2615. insure the found Value is visible.
  2616.  
  2617. ************************************************************************
  2618.  
  2619. Help for Repeat Last Find
  2620.  
  2621. Select Repeat Last Find on the Find menu to
  2622. Repeat the Last Find that was requested. This item is really a short
  2623. hand way to Repeat a Find and has been placed on the Find Menu
  2624. because it is probably the most common thing a user will want to do.
  2625.  
  2626. ************************************************************************
  2627. ************************************************************************
  2628. ***************MAIN WINDOW DESKTOP**************************************
  2629. ************************************************************************
  2630. ************************************************************************
  2631. ************************************************************************
  2632.  
  2633. Help for Reset Desktop
  2634.  
  2635. Select Reset Desktop to Reset WPS to the same condition
  2636. as when OS/2 was last booted from the Harddisk.  This selection
  2637. should not be needed except in special situations.  Normally, all of
  2638. the Desktop menu selections will automatically do a Reset of the
  2639. Desktop, if it is necessary.  However, there are a number of different
  2640. kinds of manual things that can be done to the INI files and/or the
  2641. Desktop Extended Attributes that will not take effect until WPS has
  2642. been restarted, therefore, this option is provided for that purpose.
  2643.  
  2644. When WPS is reset, the visual effect is the same as when WPS
  2645. encounters an error that prevents if from continuing.  In this case,
  2646. all of the Icons and Folders on the Desktop will disappear and the
  2647. Desktop itself will appear to fold in on itself.  After a few seconds,
  2648. the Icons will start to reappear and, if the appropriate option is
  2649. selected in the OS2.INI file, the Folders that were open at the time
  2650. of the WPS termination should also reopen.  The first time this occurs
  2651. for each user, it is disconcerting.  However, this is actually a very
  2652. good feature of WPS and has saved many users the need to reboot
  2653. OS/2.
  2654.  
  2655.  
  2656. Help for Backup Desktop
  2657.  
  2658. Select Backup Desktop to create a Simple Backup of the
  2659. Desktop.  This selection will first rebuild the Backup CMD file, in
  2660. order to insure that it is current with the actual Desktop Directory
  2661. structure, and then will execute the CMD file.  Normally, the user
  2662. will see a window open on the Desktop and can watch the CMD file
  2663. while it makes the backup.
  2664.  
  2665. The actual Backup procedure consists of:
  2666.  
  2667. Erasing the oldest Backup Generation, if it exists.
  2668.  
  2669. Renaming each remaining Generation to the next oldest generation.
  2670.  
  2671. Using Zip to zip the OS2.INI and OS2SYS.INI files into a
  2672. temporary zip file.
  2673.  
  2674. Using Zip to zip the Desktop Directory structure and it's
  2675. Extended Attributes into a temporary zip file.
  2676.  
  2677. Zipping the temporary zip files from above into a single zip file.
  2678.  
  2679. Erasing the two temporary zip files.
  2680.  
  2681. The reason the INI Files and the Desktop Directory structure are
  2682. zipped into separate files is so that they can be Restored
  2683. individually.
  2684.  
  2685. This item will not operate correctly if the version of Zip that is
  2686. first found in the CONFIG.SYS PATH variable is not an OS/2
  2687. version of Zip and is a version that supports zipping Extended
  2688. Attributes.  If there is any question about this, please refer to the
  2689. discussion of the Operational Environment.
  2690.  
  2691.  
  2692. Help for Create Backup CMD File
  2693.  
  2694. Select Create Backup CMD File to create the CMD file
  2695. that would backup the current Desktop with the currently specified
  2696. number of Backup Generations.  The CMD file will automatically be
  2697. rebuilt anytime the Desktop is actually Backed up, but it can also be
  2698. built manually, so that it can be used in other situations, such as
  2699. when the system is booted.
  2700.  
  2701. Any time the number of Backup Generations is changed, then this
  2702. CMD file should get rebuilt.
  2703.  
  2704.  
  2705. Help for Create Restore CMD File
  2706.  
  2707. Select Create Restore CMD File to Restore the Desktop
  2708. from any one of the Backup Generations created by the Backup Menu
  2709. item or the Backup CMD file.
  2710.  
  2711. This CMD files cannot be run while WPS is active, so it must be
  2712. run after a boot from a floppy or while the boot is interrupted by
  2713. ShiftRun.  There are other menu items that will do a partial Restore
  2714. of the Desktop while WPS is active, but there did not seem to be much
  2715. of a reason to do a full Restore with WPS active, since it is
  2716. unlikely that WPS would even run if the Desktop is sufficiently
  2717. corrupted that a full Restore is necessary.
  2718.  
  2719. The Restore CMD file takes a single input parameter, which is the
  2720. Generation the user wants to use for the Restore.  If no parameter is
  2721. specified, the CMD file will default to the first, and most recent,
  2722. Generation and will PAUSE to tell the user that the default is being
  2723. used.
  2724.  
  2725. The steps involved in Restoring the Desktop are:
  2726.  
  2727. The current Desktop Directory and all files in any Subdirectories
  2728. are deleted.
  2729.  
  2730. The current OS2.INI and OS2SYS.INI files are erased.
  2731.  
  2732. The zipped Backup file is unzipped to create the two temporary
  2733. zip files.
  2734.  
  2735. One of the temporary zip files is unzipped into the Desktop
  2736. Directory structure.
  2737.  
  2738. The other temporary zip file is unzipped into the INI files.
  2739.  
  2740. ATTRIB is used to verify the unzipped INI files do not have
  2741. the RO Attribute set.
  2742.  
  2743. The temporary zip files are erased.
  2744.  
  2745. It is critical that the version of UNZIP used is one that will
  2746. restore the Extended Attributes.  If there is any question about this,
  2747. you should review the Operational Environment section of
  2748. this Help file.
  2749.  
  2750.  
  2751. Help for Restore Desktop ID
  2752.  
  2753. Select Restore Desktop ID to Restore the proper ID to
  2754. the Desktop.  For reasons that are unknown to this developer at this
  2755. time, the Desktop will sometimes forget that it is the Desktop and
  2756. revert to being a normal Folder.  If a user opens up the Desktop menu
  2757. by using the RMB on the Desktop and the resulting menu is missing the
  2758. Desktop items, such as Shutdown, then the Desktop has forgotten it is
  2759. the Desktop.  The actual problem is in the Extended Attributes for the
  2760. root Desktop Directory and this menu item will repair the error and
  2761. the Desktop menu will once again have the appropriate entries.
  2762.  
  2763.  
  2764. Help for Restore Desktop Directory
  2765.  
  2766. Select Restore Desktop Directory to Restore the Desktop
  2767. Directory structure while WPS is active.  It is critical that nothing
  2768. else be going on with the Desktop while this activity is being done.
  2769. If any attempt is made to update or access the Desktop during this
  2770. activity, it is extremely likely that WPS will fail and will not come
  2771. back up again.  In this case, it will be necessary to boot from a
  2772. floppy and do a full Desktop Restore.
  2773.  
  2774. The steps involved in Restoring the Desktop Directory are:
  2775.  
  2776. The current Desktop Directory and all files in any Subdirectories
  2777. are deleted.
  2778.  
  2779. The zipped Backup file is unzipped to create the two temporary
  2780. zip files.
  2781.  
  2782. One of the temporary zip files is unzipped into the Desktop
  2783. Directory structure.
  2784.  
  2785. The temporary zip files are erased.
  2786.  
  2787. It is unlikely that this particular menu item will be used very
  2788. often.  In almost every case where the Desktop Directory structure is
  2789. sufficiently corrupted that it needs to be Restored, the corruption
  2790. is sufficient to prevent WPS form even running.  When the Desktop is
  2791. corrupted, but WPS continues to run, the problem is seldom corruption
  2792. of the Desktop Directory structure, it is almost always a problem
  2793. with the INI files and this problem is fixed via a different menu
  2794. selection.
  2795.  
  2796.  
  2797. Help for Restore Desktop INI Files
  2798.  
  2799. Select Restore Desktop INI Files to Restore the
  2800. OS2*.INI files while WPS is active.  It is critical that nothing
  2801. else be going on with the Desktop while this activity is being done.
  2802. If any attempt is made to update or access the Desktop during this
  2803. activity, it is extremely likely that WPS will fail and will not come
  2804. back up again.  In this case, it will be necessary to boot from a
  2805. floppy and do a full Desktop Restore.
  2806.  
  2807. The steps involved in Restoring the INI Files are:
  2808.  
  2809. A copy is made of both INI files and these are made the current
  2810. System and User INI files.
  2811.  
  2812. The current OS2.INI and OS2SYS.INI files are erased.
  2813.  
  2814. The zipped Backup file is unzipped to create the two temporary
  2815. zip files.
  2816.  
  2817. One temporary zip file is unzipped into the INI files.
  2818.  
  2819. ATTRIB is used to verify the unzipped INI files do not have
  2820. the RO Attribute set.
  2821.  
  2822. The temporary zip files are erased.
  2823.  
  2824. The System and User INI files are switched back to the Restored
  2825. copies of OS2.INI and OS2SYS.INI.
  2826.  
  2827. The copies of the original INI files are erased.
  2828.  
  2829. Whenever the Desktop seems to be corrupted, but WPS will stay
  2830. active, it is most likely that this menu item will fix the problem,
  2831. as opposed to restoring the Desktop Directory structure.  If the
  2832. Directory structure is corrupted, it is not very likely that WPS will
  2833. even run and a full Restore of the Desktop will probably be
  2834. necessary.
  2835.  
  2836. ************************************************************************
  2837. ************************************************************************
  2838. ************************************************************************
  2839. ***************REPLACE KEY DIALOG***************************************
  2840. ************************************************************************
  2841. ************************************************************************
  2842. ************************************************************************
  2843.  
  2844. Help for Add or Replace Key Value Dialog
  2845.  
  2846. The Add or Replace Key Value Dialog will allow the user to modify
  2847. the Value of the current Key.  This is the only Selection that will allow
  2848. the user to change the length of a Key Value.  The bottom Window of the
  2849. Main Window can be used to modify the Value of a Key, but it cannot be
  2850. used to change the length of a Value.
  2851.  
  2852.  
  2853. Help for Application Name
  2854.  
  2855. The Application Name is the name of the Application that
  2856. is currently being modified.
  2857.  
  2858.  
  2859. Help for Key Name
  2860.  
  2861. The Key Name is the name of the Key that
  2862. is currently being modified.
  2863.  
  2864.  
  2865. Help for Key Value Length
  2866.  
  2867. The Data Length shows the current length of the Key Value
  2868. that is currently being modified.  This value will change dynamically as the
  2869. actual value length is changed.  However, the length will not change when
  2870. only one character is added to the Hexidecimal Value
  2871. field, since two Hexidecimal characters are required to make a
  2872. single Ascii character.
  2873.  
  2874.  
  2875. Help for Ascii Key Value
  2876.  
  2877. The Ascii Key Value is the current contents of the Key Value
  2878. being modified.  Any Ascii characters which would not print are replaced by
  2879. a '.' to improve readability.
  2880.  
  2881.  
  2882. Help for Items not yet done
  2883.  
  2884. The Hex Key Value is a two Hexidecimal character
  2885. display for each Ascii character of the current of the Key Value
  2886. being modified.
  2887.  
  2888.  
  2889. Help for Add Zero Terminator
  2890.  
  2891. The Add Zero Terminator Checkbox can be used to insure
  2892. that character string Key Values always end with a null character,
  2893. which is a binary zero. Since virtually all Applications which store
  2894. information in an INI file will store character strings with the null
  2895. character terminator, if this option is checked, the Dialog
  2896. termination code will insure that the Ascii value entered has the
  2897. null terminator. If the terminator is not there, then it will be
  2898. added and the length will be increased by one. This insures that both
  2899. the actual data and the stored length are as expected.
  2900.  
  2901. ************************************************************************
  2902. ************************************************************************
  2903. **********************DUMP DIALOG***************************************
  2904. ************************************************************************
  2905. ************************************************************************
  2906. ************************************************************************
  2907.  
  2908. Help for Dump Variables Dialog
  2909.  
  2910. The Dump Variables Dialog will display the current contents of
  2911. all Global Variables and various System and Application Error values.  This
  2912. Dialog will be displayed automatically whenever a terminal error occurs and
  2913. gives the user the option of recording the values in a Dump File.
  2914.  
  2915.  
  2916. Help for Dump File Name
  2917.  
  2918. The File Name is the name of the File that will be used
  2919. to contain all of the Dump variable information displayed in the Dialog
  2920. if the Write Button is selected.
  2921.  
  2922.  
  2923. Help for Dump Logic Error
  2924.  
  2925. The Logic Error is the IniMaint or SysMaint Internal Error Code.  Any
  2926. value other than zero is an error value.  A short description of the error
  2927. will be displayed in the Logic Error Text field.
  2928.  
  2929.  
  2930. Help for Dump DOS Error
  2931.  
  2932. The DOS Error is the error code returned from the last call
  2933. to an OS/2 DOS API.  It will normally be a further explanation of
  2934. the Logic Error, if IniMaint or SysMaint was terminated by an error.
  2935.  
  2936.  
  2937. Help for Dump Help Error
  2938.  
  2939. The Help Error is the error code returned from the last call
  2940. to an OS/2 Help API.  It will normally be a further explanation of
  2941. the Logic Error, if IniMaint or SysMaint was terminated by an error or the
  2942. Message Box saying that the Help is not available was displayed.
  2943.  
  2944.  
  2945. Help for Dump PM Error
  2946.  
  2947. The PM Error is the error code returned from the last call
  2948. to an OS/2 PM API.  It will normally be a further explanation of
  2949. the Logic Error, if IniMaint or SysMaint was terminated by an error.
  2950.  
  2951.  
  2952. Help for Dump PM Test Error
  2953.  
  2954. There are many situations where a call to an OS/2 PM API will
  2955. return a valid return, however, a call to the API that returns PM errors
  2956. will return a nonzero error.  IniMaint or SysMaint attempts to record this error code
  2957. whenever the Dump Dialog is invoked.  This error will normally be the last PM
  2958. non zero error code from an API that had a valid return.
  2959.  
  2960.  
  2961. Help for Dump PM Error Text
  2962.  
  2963. The PM Error Text is a short explanation of the 
  2964. PM Error or the PM Test Error if the PM Error is zero.
  2965.  
  2966. Due to a problem in OS/2 1.3 CSD WR5050, this text will not be correct
  2967. for this particular level of OS/2.
  2968.  
  2969.  
  2970. Help for Dump Logic Error Text
  2971.  
  2972. The Logic Error Text is a short explanation of the IniMaint or SysMaint
  2973. error shown in the Logic Error field.
  2974.  
  2975.  
  2976. Help for Dump Variable Window
  2977.  
  2978. This window contains the contents of all of the IniMaint or SysMaint Variables and
  2979. is only of use in Debugging problems.
  2980.  
  2981.  
  2982. Help for Dump Write to File
  2983.  
  2984. Selecting this Button will cause the IniMaint or SysMaint Variable information to
  2985. be written to the current Dump File.
  2986.  
  2987.  
  2988. Help for Dump Select New File
  2989.  
  2990. This selection will cause the New File Dialog to be opened
  2991. so that a new Dump File can be selected.
  2992.  
  2993. ************************************************************************
  2994. ************************************************************************
  2995. ******************OPTIONS DIALOG****************************************
  2996. ************************************************************************
  2997. ************************************************************************
  2998. ************************************************************************
  2999.  
  3000. Help for Options Dialog
  3001.  
  3002. The Options Dialog will display a set of Checkboxes that
  3003. allow the user to control the behavior of IniMaint or SysMaint in a number of different
  3004. situations.
  3005.  
  3006.  
  3007. Help for Options Recall Files
  3008.  
  3009. The Recall Files Option controls the maximum number of entries
  3010. that will appear on the File Recall submenu.  Once the number of 
  3011. files to be Recalled has reached this value, the oldest file will be
  3012. dropped from the list.  The default is 10 and the maximum value is 100.
  3013.  
  3014.  
  3015. Help for Options Use Fast Copy
  3016.  
  3017. The Use Fast Copy Option controls whether IniMaint or SysMaint will
  3018. use the special fast methods to access the INI files when doing a Copy
  3019. or Move of an entire INI file, Backup of an INI file or Condense of an
  3020. INI file.  This option significantly decreases the time needed to do these
  3021. functions.
  3022.  
  3023.  
  3024. Help for Options Apps and Keys in Alpha Order
  3025.  
  3026. The Apps and Keys in Alpha Order Option controls how IniMaint or SysMaint
  3027. will load the Application and Key Names into the Listboxes.  If this option
  3028. is selected, the Names will be loaded in alphabetic order, otherwise, they
  3029. will be loaded in the order encountered.  The default for this Option is
  3030. Yes.
  3031. Option.
  3032.  
  3033.  
  3034. Help for Options Ask Before Backup
  3035.  
  3036. The Ask Before Backup Option controls whether IniMaint or SysMaint will
  3037. ask for verification of the name of the backup file for the INI File
  3038. that is being backed up.  If no backup name has been specified, then
  3039. IniMaint or SysMaint will always ask.  The default for this Option is Yes.
  3040.  
  3041.  
  3042. Help for Options Ask Before Deleting
  3043.  
  3044. The Ask Before Deleting Option controls whether IniMaint or SysMaint will
  3045. ask for verification before deleting an Application or Key.  The default for
  3046. this Option is Yes.
  3047.  
  3048.  
  3049. Help for Options Ask Before Updating
  3050.  
  3051. The Ask Before Updating Option controls whether IniMaint or SysMaint will
  3052. ask for verification before writing changes to an Application or Key to
  3053. the current INI File.  The default for this Option is Yes.
  3054.  
  3055.  
  3056. Help for Options Display Initial Dialog
  3057.  
  3058. The Display Initial Dialog Option controls whether IniMaint or SysMaint
  3059. will Display the Initial Dialog Box each time it is run.  The default
  3060. for this Option is Yes.
  3061.  
  3062.  
  3063. Help for Options Display Size Calculation Box
  3064.  
  3065. The Display Size Calculation Box Option controls whether
  3066. IniMaint or SysMaint will Display a box saying that a Size Calculation
  3067. is in progress.  During the Size Calculation no user input to
  3068. IniMaint or SysMaint will be accepted and the Wait Pointer will be displayed.
  3069. However, the PM Message Queue will not be blocked so the user can switch
  3070. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3071. Yes.
  3072.  
  3073.  
  3074. Help for Options Display Loading Listbox Box
  3075.  
  3076. The Display Loading Listbox Box Option controls whether
  3077. IniMaint or SysMaint will Display a box saying that it is Loading the
  3078. Applications, Keys or Current Key Value information.  During the 
  3079. Loading process no user input to
  3080. IniMaint or SysMaint will be accepted and the Wait Pointer will be displayed.
  3081. However, the PM Message Queue will not be blocked so the user can switch
  3082. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3083. No.
  3084.  
  3085.  
  3086. Help for Options Display Copying/Moving Box
  3087.  
  3088. The Display Copying/Moving Box Option controls whether
  3089. IniMaint or SysMaint will Display a box saying that a Copy or Move
  3090. is in progress.  During the Copy or Move no user input to
  3091. IniMaint or SysMaint will be accepted and the Wait Pointer will be displayed.
  3092. However, the PM Message Queue will not be blocked so the user can switch
  3093. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3094. Yes.
  3095.  
  3096.  
  3097. Help for Options Display Find Box
  3098.  
  3099. The Display Find Box Option controls whether
  3100. IniMaint or SysMaint will Display a box saying that a Find
  3101. is in progress.  During the Find no user input to
  3102. IniMaint or SysMaint will be accepted and the Wait Pointer will be displayed.
  3103. However, the PM Message Queue will not be blocked so the user can switch
  3104. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3105. No.
  3106.  
  3107.  
  3108. Help for Options Display Compare Box
  3109.  
  3110. The Display Compare Box Option controls whether
  3111. IniMaint or SysMaint will Display a box saying that a Compare
  3112. is in progress.  During the filling of the Compare File Listbox
  3113. no user input to IniMaint or SysMaint will be accepted and the Wait Pointer
  3114. will be displayed.
  3115. However, the PM Message Queue will not be blocked so the user can switch
  3116. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3117. No.
  3118.  
  3119.  
  3120. Help for Options Display Compare Files Write or Print Box
  3121.  
  3122. The Display Compare Files Write or Print Box Option controls
  3123. whether IniMaint or SysMaint will Display a box saying that a
  3124. Compare Files Write or Print is in progress.  Until the operation
  3125. is completed no user input to IniMaint or SysMaint will be accepted and the 
  3126. Wait Pointer will be displayed.
  3127. However, the PM Message Queue will not be blocked so the user can switch
  3128. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3129. No.
  3130.  
  3131.  
  3132. Help for Options Display Repair Box
  3133.  
  3134. The Display Repair Box Option controls whether
  3135. IniMaint or SysMaint will Display a box saying that a Repair
  3136. is in progress.  During the execution of the Repair File Function
  3137. no user input to IniMaint or SysMaint will be accepted and the Wait Pointer
  3138. will be displayed.
  3139. However, the PM Message Queue will not be blocked so the user can switch
  3140. away from IniMaint or SysMaint during this process.  The default for this Option is 
  3141. No.
  3142.  
  3143. ************************************************************************
  3144. ************************************************************************
  3145. ************SELECT GROUPS DIALOG****************************************
  3146. ************************************************************************
  3147. ************************************************************************
  3148. ************************************************************************
  3149.  
  3150. Help for Select Group Dialog
  3151.  
  3152. The Select Group Dialog will display a set of choices for an
  3153. IniMaint operation that can be performed on the Entire File, a
  3154. Single Application, or a Group.  The options will
  3155. include the Groups, if there are any defined and an entry for
  3156. All Groups if there is more then one Group.
  3157.  
  3158. It is not possible to directly invoke this Dialog, it is
  3159. automatically called whenever some action is taken that requires the
  3160. user to select a Group.
  3161.  
  3162.  
  3163. Help for Select Group Group Listing
  3164.  
  3165. The Group Listing box will list all of the valid choices for
  3166. the selected IniMaint operation.  As soon as any one of the items in the box
  3167. are selected by clicking on them with the mouse, the IniMaint operation will
  3168. start using the selected choice.
  3169.  
  3170. It is not possible to directly invoke this Window, it is
  3171. automatically called whenever some action is taken that requires the
  3172. user to select a Group.
  3173.  
  3174. ************************************************************************
  3175. ************************************************************************
  3176. ***************GET STRING DIALOG****************************************
  3177. ************************************************************************
  3178. ************************************************************************
  3179. ************************************************************************
  3180.  
  3181. Help for Get Value or String Dialog
  3182.  
  3183. The Get Value or String Dialog is used to obtain any
  3184. Numberic or Character information that is needed from
  3185. the user.
  3186.  
  3187.  
  3188. Help for Get Value or String Data Entry Area
  3189.  
  3190. The Data Entry Area is where the requested information is
  3191. entered by the user.
  3192.  
  3193. ************************************************************************
  3194. ************************************************************************
  3195. ****************** GROUPS DIALOG****************************************
  3196. ************************************************************************
  3197. ************************************************************************
  3198. ************************************************************************
  3199.  
  3200. Help for Groups Dialog
  3201.  
  3202. The Groups Dialog contains a Listbox with all the 
  3203. Applications for the Current INI file.  Any of the 
  3204. Applications that are selected are included in the Group
  3205. whose name is in the Title of the Dialog.  The Groups menu item
  3206. allows the user to change the Group currently being shown and to
  3207. add a new Group.  A single Application can belong to
  3208. more than one Group.  Applications are added to or
  3209. removed from a specific Group by Selecting or Deselecting the
  3210. Application.
  3211.  
  3212.  
  3213. Help for Groups Application Listing
  3214.  
  3215. The Groups Listbox lists all Applications in
  3216. the Current INI file with every member of the Group whose
  3217. name is in the Title selected.
  3218.  
  3219. If the Group currently being displayed is All, then the
  3220. Applications selected are the Applications that are in any Group.
  3221. Therefore, any Application that is not selected, is not in any Group.
  3222. When in this mode, any Application that is deselected will be removed
  3223. from all Groups that it is a member of.  If an Application is
  3224. selected, the user will be asked which Group they want the
  3225. Application added to, unless there is only one Group defined, in
  3226. which case it will be added to that Group.
  3227.  
  3228.  
  3229. Help for Groups Add Group
  3230.  
  3231. The Add Group selection gives the user the ability to add
  3232. a new Group to the Current INI file.  The user will be prompted
  3233. for a Group Name, the new Group will become the current Group and
  3234. the user can then add Applications to the Group by
  3235. selecting them.
  3236.  
  3237.  
  3238. Help for Groups Delete Group
  3239.  
  3240. The Delete Group selection gives the user the ability to
  3241. delete a Group from those defined for the Current INI file.
  3242.  
  3243. ************************************************************************
  3244. ************************************************************************
  3245. ************************************************************************
  3246. **********************FIND DIALOG***************************************
  3247. ************************************************************************
  3248. ************************************************************************
  3249. ************************************************************************
  3250.  
  3251. Help for Find Dialog
  3252.  
  3253. The Find Dialog will allow the user to do a number of different
  3254. Finds.  The current Application and Key Listboxes and Key Value MLE can be
  3255. searched, or the search can be extended to all the Key Values in an
  3256. Application or the entire current INI file.
  3257.  
  3258.  
  3259. Help for Find Text
  3260.  
  3261. The Find Text is the text that will be used to do the next
  3262. Find.  The text will be displayed in Ascii or Hex format, depending on the
  3263. format the user has selected.  When doing a Find on Application Name or Key
  3264. Name, only Ascii text is valid.
  3265.  
  3266.  
  3267. Help for Find from Beginning
  3268.  
  3269. The Find from Beginning button causes the Find to start from
  3270. the beginning of the Listbox, MLE, or file, depending on which Find is
  3271. requested.
  3272.  
  3273. Help for Find from Current
  3274.  
  3275. The Find from Current button causes the Find to start from
  3276. the current position in the Listbox, MLE, or file, depending on which Find is
  3277. requested.
  3278.  
  3279. Help for Repeat Find
  3280.  
  3281. The Repeat Find button causes the previous Find to be
  3282. repeated.  This option will ignore any changes made in the Find Text
  3283. Entryfield and will use the same field as the previous find.
  3284.  
  3285.  
  3286. Help for Ascii Find Text
  3287.  
  3288. The Ascii Find Text button causes the Find text field to
  3289. be displayed in Ascii format.  This is the only valid format for all Finds
  3290. for Application and Key names.
  3291.  
  3292.  
  3293. Help for Hex Find Text
  3294.  
  3295. The Hex Find Text button causes the Find text field to
  3296. be displayed in Hex format.  This is format is not valid for Finds
  3297. on Application and Key names.
  3298.  
  3299.  
  3300. Help for Case Sensitive
  3301.  
  3302. The Case Sensitive checkbox causes the Find to be case
  3303. sensitive.  If this box is not checked, then the Find will force all fields
  3304. to upper case before doing a compare.  This option does not apply to Hex
  3305. text format searches.
  3306.  
  3307.  
  3308. Help for Global Find Text
  3309.  
  3310. The Global Find Text checkbox causes the Find text to be
  3311. copied to the Default Find Text for all other Finds of the same
  3312. type.  For example, if this Find is for a Key Value, then if this item is
  3313. selected and the FIND Button is selected, the text for this Find will become
  3314. the text for all Key Value Finds.  If this checkbox is not selected, then the
  3315. text for this Find will only be copied to the other finds of the same type
  3316. if the other Finds have no current search text.
  3317.  
  3318. ************************************************************************
  3319. ************************************************************************
  3320. ************************************************************************
  3321. ********************COMPARE DIALOG**************************************
  3322. ************************************************************************
  3323. ************************************************************************
  3324. ************************************************************************
  3325.  
  3326. Help for Compare Files Dialog
  3327.  
  3328. The Compare Files Dialog will allow the user to compare two
  3329. INI files on any of three different levels of detail.
  3330.  
  3331.  
  3332. Help for Source INI File
  3333.  
  3334. The Source INI File is the INI File that will be used as the
  3335. Source INI File.
  3336.  
  3337.  
  3338. Help for Target INI File
  3339.  
  3340. The Target INI File is the INI File that will be used as the
  3341. Target INI File.
  3342.  
  3343.  
  3344. Help for Application Level Compare
  3345.  
  3346. The Application Level Compare selection will cause the Listbox
  3347. to contain a list of any Application Name that is in one of the Compare Files
  3348. but not in the other.
  3349.  
  3350.  
  3351. Help for Key Name Level Compare
  3352.  
  3353. The Key Name Level Compare selection will cause the Listbox
  3354. to contain a list of any Application Name that is in one of the Compare Files
  3355. but not in the other.  In addition it will list any Key Name that is in an
  3356. Application that is common to the two files, but where the Key Name is missing
  3357. from one of the files.
  3358.  
  3359.  
  3360. Help for Key Value Level Compare
  3361.  
  3362. The Key Value Level Compare selection will cause the Listbox
  3363. to contain a list of any Application Name that is in one of the Compare Files
  3364. but not in the other.  It will also list any Key Name that is in an
  3365. Application that is common to the two files, but where the Key Name is missing
  3366. from one of the files.  Finally, it will list any situation where the
  3367. Application and Key Names are in both files, but the Key Values are not
  3368. equal.
  3369.  
  3370.  
  3371. Help for New Target File
  3372.  
  3373. Selecting New Target File will cause the File Selection
  3374. Dialog to appear and ask for a New Target File.  If a new file
  3375. is selected, it will become the current Target File and the Listbox will
  3376. be filled with the appropriate level compare entries for this file and
  3377. the current Source File.
  3378.  
  3379.  
  3380. Help for Write
  3381.  
  3382. Selecting Write will cause the Write Options Dialog to
  3383. appear allowing the user to decide what he wants to Write.  If OK is
  3384. selected and the user has chosen to Write any data, the requested data
  3385. will then be written to the chosen files.
  3386.  
  3387.  
  3388. Help for Print
  3389.  
  3390. Selecting Print will cause the contents of the Listbox to
  3391. be printed.  The printing is done in a separate thread, so that the message
  3392. queue is not blocked.  However, the Compare Dialog cannot be dismissed until
  3393. the Print is finished, since dismissing the Dialog will cause the memory
  3394. allocated to hold the Listbox items to be released.
  3395.  
  3396. ************************************************************************
  3397. ************************************************************************
  3398. ************************************************************************
  3399. ****************COMPARE WRITE OPTIONS DIALOG****************************
  3400. ************************************************************************
  3401. ************************************************************************
  3402. ************************************************************************
  3403.  
  3404. Help for Compare Files Write Options Dialog
  3405.  
  3406. The Compare Files Write Options Dialog will allow the user to
  3407. select the type(s) of writes and which files they want to use for the
  3408. Writing.
  3409.  
  3410.  
  3411. Help for Write INI File
  3412.  
  3413. The Write INI File is the INI file that will be used as the
  3414. output INI file for all of the write options except the Write Listbox.  This
  3415. must be a valid INI file.  If the file does not exist, a valid INI file will
  3416. be created using the filename.  If the INI file does exist, then the selected
  3417. INI write items will be added to those already in the INI file if they do
  3418. not already exist there and replace those items that do exist.
  3419.  
  3420.  
  3421. Help for Select New Write INI File
  3422.  
  3423. Select the Select New Write INI File checkbox to cause the New
  3424. File Dialog to be displayed asking for the name of the Write INI file.  Once
  3425. the new file is selected and validated as an INI file or created, it will
  3426. be displayed as the Write INI file.
  3427.  
  3428.  
  3429. Help for Write Listbox File
  3430.  
  3431. The Write Listbox File is the Ascii file that will be used as the
  3432. output file for the Write Listbox selection.  If the file does not exist, a valid Listbox file will
  3433. be created using the filename.  If the file does exist, then the current
  3434. contents of the file will be replaced by the contents of the Listbox.
  3435.  
  3436.  
  3437. Help for Select New Write Listbox File
  3438.  
  3439. Select the Select New Write Listbox File checkbox to cause the
  3440. New File Dialog to be displayed asking for the name of the Write Listbox file.
  3441. Once the new file is selected and validated as a valid filename, it will
  3442. be displayed as the Write Listbox file.
  3443.  
  3444.  
  3445. Help for Write from Source INI File
  3446.  
  3447. Select Write from Source INI File to cause the Source INI
  3448. File to be used as the source for the INI entries that will be written
  3449. to the output INI file.  For example, if Write Missing Applications is one
  3450. of the chosen options and this item is selected, then the output INI file
  3451. will contain all Applications that are in the Source INI File but not in
  3452. the Target File.
  3453.  
  3454.  
  3455. Help for Write from Target INI File
  3456.  
  3457. Select Write from Target INI File to cause the Target INI
  3458. File to be used as the source for the INI entries that will be written
  3459. to the output INI file.  For example, if Write Missing Applications is one
  3460. of the chosen options and this item is selected, then the output INI file
  3461. will contain all Applications that are in the Target INI File but not in
  3462. the Source File.
  3463.  
  3464.  
  3465. Help for Write Missing Applications
  3466.  
  3467. Select Write Missing Applications to cause Applications which
  3468. are in one INI file, but not in the other, to be written to the output INI
  3469. File.  Which Applications are written depends on whether the Source or Target
  3470. INI file was chosen as the Write From file.
  3471.  
  3472.  
  3473. Help for Write Missing Key Names
  3474.  
  3475. Select Write Missing Key Names to cause Key Names which
  3476. are in one INI file, but not in the other, to be written to the output INI
  3477. File.  Which Key Names are written depends on whether the Source or Target
  3478. INI file was chosen as the Write From file.
  3479.  
  3480. In order for a Key Name to be considered a missing Key Name, the 
  3481. Application must be in both the Source and the Target INI files, but the
  3482. specific Key Name missing from one or the other.
  3483.  
  3484. If this Write option is selected, but the Compare level is
  3485. Application, then there cannot be entries in the Listbox that would
  3486. qualify for this Write.  In this case, this option would have no effect.
  3487.  
  3488.  
  3489. Help for Write Unequal Key Values
  3490.  
  3491. Select Write Unequal Key Values to cause Key Values for any
  3492. Application Key Name pair that is in both files but have Key Values that
  3493. are not the same, to be written to the output INI
  3494. File.  Which Key Values are written depends on whether the Source or Target
  3495. INI file was chosen as the Write From file.
  3496.  
  3497. If this Write option is selected, but the Compare level is
  3498. Application or Key Name, then there cannot be entries in the Listbox
  3499. that would qualify for this Write.  In this case, this option would have
  3500. no effect.
  3501.  
  3502.  
  3503. Help for Write Selected Items
  3504.  
  3505. Select Write Selected Items to cause an entry to be written
  3506. to the output INI file for each item in the Listbox that has been
  3507. highlighted.  In this case, the Write From file will only apply to those
  3508. items that list Unequal Key Values, in which case, the Key Value in the
  3509. Write From file will be the one that is written to the output INI file.
  3510.  
  3511. If there are no items highlighted in the Compare Listbox, then this
  3512. option will have no effect, since there are no selected entries.
  3513.  
  3514.  
  3515. Help for Write Listbox Contents
  3516.  
  3517. Select Write Listbox Contents to cause the contents of the
  3518. Listbox to be written to a File.  In this case, the output file is not an
  3519. INI file, but a flat Ascii File that contains one line for every entry in
  3520. the Compare Files Listbox.
  3521.  
  3522. ************************************************************************
  3523. ************************************************************************
  3524. ************************************************************************
  3525. ********************REPAIR DIALOG***************************************
  3526. ************************************************************************
  3527. ************************************************************************
  3528. ************************************************************************
  3529.  
  3530. Help for Repair File Dialog
  3531.  
  3532. The Repair File Dialog will allow the user to Repair the Current
  3533. INI File.
  3534.  
  3535.  
  3536. Help for Save INI File
  3537.  
  3538. The Save INI File is the INI File that will be used to hold
  3539. any entries from the Source INI file that are changed or deleted during the
  3540. Repair process.  It is possible to bypass saving the removed items via the
  3541. Options Dialog.
  3542.  
  3543.  
  3544. Help for Select New Save INI File
  3545.  
  3546. Select the Select New Save INI File checkbox to cause the New
  3547. File Dialog to be displayed asking for the name of the Save INI file.  Once
  3548. the new file is selected and validated as an INI file or created, it will
  3549. be displayed as the Save INI file.
  3550.  
  3551.  
  3552. Help for Write Window File
  3553.  
  3554. The Write Window File is the Ascii file that will be used as the
  3555. output file for the Write selection.  If the file does not exist, a valid file will
  3556. be created using the filename.  If the file does exist, then the current
  3557. contents of the file will be replaced by the contents of the Window.
  3558.  
  3559.  
  3560. Help for Select New Write File
  3561.  
  3562. Select the Select New Write File checkbox to cause the
  3563. New File Dialog to be displayed asking for the name of the Write file.
  3564. Once the new file is selected and validated as a valid filename, it will
  3565. be displayed as the Write file.
  3566.  
  3567.  
  3568. Help for Report Only
  3569.  
  3570. The Report Only selection will cause the Window
  3571. to contain a list of any Repair that would have been made based on the
  3572. Repair Checks chosen and the contents of the INI file.  No actual changes
  3573. will be made to the INI file.
  3574.  
  3575.  
  3576. Help for Ask First
  3577.  
  3578. The Ask First selection will cause the next Repair
  3579. to find an situation that needs to be Repaired.  Once the condition is 
  3580. identified, the user will be asked if he wants the Repair done.  If the
  3581. response is No, then no Repair will be done and an entry will be
  3582. added to the Window saying that a Repair is needed.  If the response is
  3583. Yes then the Repair will be done.
  3584.  
  3585.  
  3586. Help for Do Repair
  3587.  
  3588. The Do Repair selection will cause the next Repair
  3589. to find all appropriate items that need to be Repaired.
  3590. Once the condition is identified, the Repair will be done.
  3591. The user will not be asked if he wants each
  3592. Repair to be done, all requested repairs will be done automatically.
  3593.  
  3594.  
  3595. Help for Do Selected
  3596.  
  3597. The Do Selected selection will repair those items that
  3598. have been selected by the user.  If a selected item has dependent items,
  3599. then the dependent items will be repaired also.  For example, if a directory
  3600. is selected for repair, then all files in the directory, any
  3601. subdirectories and any files in those subdirectories will also be
  3602. repaired.
  3603.  
  3604.  
  3605. Help for Write
  3606.  
  3607. Selecting Write will cause the contents of the Window
  3608. to be written to the Write File.
  3609.  
  3610.  
  3611. Help for Options
  3612.  
  3613. Selecting Options will cause Repair Options Dialog
  3614. to be displayed.
  3615.  
  3616.  
  3617. Help for Print
  3618.  
  3619. Selecting Print will cause the contents of the Window to
  3620. be printed.  The printing is done in a separate thread, so that the message
  3621. queue is not blocked.  However, the Repair Dialog cannot be dismissed until
  3622. the Print is finished, since dismissing the Dialog will cause the memory
  3623. allocated to hold the Window items to be released.
  3624.  
  3625.  
  3626. Help for Execute
  3627.  
  3628. Selecting Execute will cause the actual repair action to start.
  3629. All Checks that the user has selected will be made and the action
  3630. taken will depend on the Type that has been selected.  Every Repair
  3631. action will cause a line of information to be added to the Window.
  3632.  
  3633. ************************************************************************
  3634. ************************************************************************
  3635. ************************************************************************
  3636. ********************REPAIR TYPES****************************************
  3637. ************************************************************************
  3638. ************************************************************************
  3639. ************************************************************************
  3640.  
  3641. Help for Check Path and FileNames
  3642.  
  3643. The Check Path and FileNames selection will cause the
  3644. next Repair Execution to find every Key Name or Key Value in the
  3645. Current INI File that is a path or filename, compare it to
  3646. the actual paths and filenames on the various hardrives and remove or
  3647. report any entries that are not found on the harddisk.
  3648.  
  3649. Whether the entries
  3650. are removed or reported, depends on which Repair Type of button the user
  3651. has chosen.
  3652.  
  3653.  
  3654. Help for Look For Zero Length Key Values
  3655.  
  3656. The Look For Zero Length Key Values selection will cause the
  3657. next Repair Execution to look for any entries in the 
  3658. Current INI File that have a zero length key value.  This is a
  3659. condition which should never occur, but has been seen from time to time
  3660. in some INI files.  Normally, when an entry is written to an INI file with
  3661. a zero length key, the entry is deleted by the INI file code.
  3662.  
  3663. Whether the entries
  3664. are removed or reported, depends on which Repair Type of button the user
  3665. has chosen.
  3666.  
  3667.  
  3668. Help for Remove Old PM_ProgramList Entries
  3669.  
  3670. The Remove Old PM_ProgramList Entries selection will cause the
  3671. PM_ProgramListxxx Entries from the OS2.INI file to be displayed.
  3672. These entries are a leftover from V1.3 and V2.0 and are no longer
  3673. needed.  However, if these entries remain in the file, any Objects
  3674. referenced by these entries cannot be deleted.  If it is deleted, it
  3675. will reappear as soon as the Folder that contained the Object is
  3676. reopened.
  3677.  
  3678. Whether the entries
  3679. are removed or reported, depends on which Repair Type of button the user
  3680. has chosen.
  3681.  
  3682.  
  3683. Help for Delete Unused Printer Entries
  3684.  
  3685. The Delete Unused Printer Entries selection will cause the
  3686. Printer entries from the OS2SYS.INI file that are no longer OBjects
  3687. on the Desktop to be displayed.  These entries are not really an
  3688. operational problem, however, they are not removed from the file when
  3689. the Printer Object is deleted and there are a number of PM
  3690. Applications that look in the OS2SYS.INI file to obtain the Printer
  3691. information and these Applications will treat these entries as real
  3692. Printers.  However, any attempt to Print to the entries will not work.  
  3693.  
  3694. Whether the entries
  3695. are removed or reported, depends on which Repair Type of button the user
  3696. has chosen.
  3697.  
  3698.  
  3699. Help for Display Valid Dir/File Handles
  3700.  
  3701. The Display Valid Dir/File Handles selection will cause the
  3702. next Repair Execution to
  3703. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3704. compare each Drive, Directory and Filename entry to the actual contents
  3705. of the appropriate drive and place all valid entries into the Repair
  3706. Window.
  3707.  
  3708. The only type of Repair that is valid when listing items is the 
  3709. Report Only button.
  3710.  
  3711. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  3712. determined by the selections in the Repair Options Dialog.
  3713.  
  3714.  
  3715. Help for Display Invalid Dir/File Handles
  3716.  
  3717. The Display Invalid Dir/File Handles selection will cause the
  3718. next Repair Execution to
  3719. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3720. compare each Drive, Directory and Filename entry to the actual contents
  3721. of the appropriate drive and place all invalid entries into the Repair
  3722. Window.
  3723.  
  3724. The only type of Repair that is valid when listing items is the 
  3725. Report Only button.
  3726.  
  3727. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  3728. determined by the selections in the Repair Options Dialog.
  3729.  
  3730.  
  3731. Help for Display All Dir/File Handles
  3732.  
  3733. The Display All Dir/File Handles selection will cause the
  3734. next Repair Execution to
  3735. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3736. compare each Drive, Directory and Filename entry to the actual contents
  3737. of the appropriate drive and place all entries into the Repair
  3738. Window with an identification as to which are valid and which are invalid.
  3739.  
  3740. The only type of Repair that is valid when listing items is the 
  3741. Report Only button.
  3742.  
  3743. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  3744. determined by the selections in the Repair Options Dialog.
  3745.  
  3746.  
  3747. Help for Repair Dir/File Handles
  3748.  
  3749. The Repair Dir/File Handles selection will cause the
  3750. next Repair Execution to
  3751. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3752. compare each Drive, Directory and Filename entry to the actual contents
  3753. of the appropriate drive, place all invalid entries into the Repair
  3754. Window and do the Repair action specified by the Type of Repair button.
  3755.  
  3756. Whether the entries
  3757. are removed or reported, depends on which Repair Type of button the user
  3758. has chosen.
  3759.  
  3760. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  3761. determined by the selections in the Repair Options Dialog.
  3762.  
  3763.  
  3764. Help for Display Objects
  3765.  
  3766. The Display Objects selection will cause the
  3767. next Repair Execution to
  3768. analyze the PM_Abstract Objects entry in the OS2.INI file,
  3769. and place all entries into the Repair
  3770. Window.  There is no automatic way to validate the Objects, so it is
  3771. assumed that they are all valid.
  3772.  
  3773. The only type of Repair that is valid when listing items is the 
  3774. Report Only button.
  3775.  
  3776.  
  3777. Help for Destroy Objects
  3778.  
  3779. The Destroy Objects selection will cause the
  3780. next Repair Execution to
  3781. analyze the PM_Abstract Objects entry in the OS2.INI file,
  3782. and place all entries into the Repair
  3783. Window.  There is no automatic way to validate the Objects, so it is
  3784. assumed that they are all valid, therefore, the Do Repair button will
  3785. not delete anything from the Repair Window.  The items can be deleted
  3786. by Selecting individual items.  Extreme care must be taken before deleting
  3787. any Objects as it can cause problems with the Desktop.
  3788.  
  3789.  
  3790. Help for Restore Missing Location Entries
  3791.  
  3792. The Restore Missing Location Entries selection will
  3793. examine each of the entries in the PM_Abstract:Objects entry in
  3794. the OS2.INI file looking for Location information.  If the Location
  3795. information is found, then the PM_WorkPlace:Location entry will
  3796. be checked to see if the location is listed.  If the Location is
  3797. listed then the Object Name and the Location will be added to the
  3798. Repair window.
  3799.  
  3800. Whether the entries are fixed or reported, depends on which Repair
  3801. Type of button the user has chosen.
  3802.  
  3803.  
  3804. Help for Display Valid WPS Entries
  3805.  
  3806. The Display Valid WPS Entries selection will cause the
  3807. next Repair Execution to
  3808. analyze the various WPS entries in the OS2.INI file,
  3809. validate the value range for each one,
  3810. compare each to the Handles or Objects structure
  3811. and place all valid entries into the Repair
  3812. Window.
  3813.  
  3814. The only type of Repair that is valid when listing items is the 
  3815. Report Only button.
  3816.  
  3817. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3818. handles is determined by the selections in the Repair Options Dialog.
  3819.  
  3820. The WPS Repair selections can take a considerable amount of time to
  3821. actually fill the Repair Window.  The reason for this is because both the
  3822. Handles and Objects structures must be filled before the analysis of the
  3823. WPS entries in the INI files can start.
  3824.  
  3825.  
  3826. Help for Display Invalid WPS Entries
  3827.  
  3828. The Display Invalid WPS Entries selection will cause the
  3829. next Repair Execution to
  3830. analyze the various WPS entries in the OS2.INI file,
  3831. validate the value range for each one,
  3832. compare each to the Handles or Objects structure
  3833. and place all invalid entries into the Repair
  3834. Window with an notation as to why they are not valid.
  3835.  
  3836. The only type of Repair that is valid when listing items is the 
  3837. Report Only button.
  3838.  
  3839. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3840. handles is determined by the selections in the Repair Options Dialog.
  3841.  
  3842. The WPS Repair selections can take a considerable amount of time to
  3843. actually fill the Repair Window.  The reason for this is because both the
  3844. Handles and Objects structures must be filled before the analysis of the
  3845. WPS entries in the INI files can start.
  3846.  
  3847.  
  3848. Help for Display All WPS Entries
  3849.  
  3850. The Display All WPS Entries selection will cause the
  3851. next Repair Execution to
  3852. analyze the various WPS entries in the OS2.INI file,
  3853. validate the value range for each one,
  3854. compare each to the Handles or Objects structure
  3855. and place all entries into the Repair
  3856. Window with an notation as to whether each item is valid or invalid.
  3857. For the invalid items there will also be a notation as to why they are
  3858. not valid.
  3859.  
  3860. The only type of Repair that is valid when listing items is the 
  3861. Report Only button.
  3862.  
  3863. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3864. handles is determined by the selections in the Repair Options Dialog.
  3865.  
  3866. The WPS Repair selections can take a considerable amount of time to
  3867. actually fill the Repair Window.  The reason for this is because both the
  3868. Handles and Objects structures must be filled before the analysis of the
  3869. WPS entries in the INI files can start.
  3870.  
  3871.  
  3872. Help for Repair WPS Entries
  3873.  
  3874. The Repair WPS Entries selection will cause the
  3875. next Repair Execution to
  3876. analyze the various WPS entries in the OS2.INI file,
  3877. validate the value range for each one,
  3878. compare each to the Handles or Objects structure,
  3879. place all invalid entries into the Repair
  3880. Window with an notation as to why they are not valid
  3881. and do the Repair action specified by the Type of Repair button.
  3882.  
  3883. Whether the entries
  3884. are removed or reported, depends on which Repair Type of button the user
  3885. has chosen.
  3886.  
  3887. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3888. handles is determined by the selections in the Repair Options Dialog.
  3889.  
  3890. The WPS Repair selections can take a considerable amount of time to
  3891. actually fill the Repair Window.  The reason for this is because both the
  3892. Handles and Objects structures must be filled before the analysis of the
  3893. WPS entries in the INI files can start.
  3894.  
  3895.  
  3896. Help for Display All Valid WPS and Handle Entries
  3897.  
  3898. The Display All Valid WPS and Handle Entries selection will cause the
  3899. next Repair Execution to 
  3900. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3901. compare each Drive, Directory and Filename entry to the actual contents
  3902. of the appropriate drive and
  3903. analyze the various WPS entries in the OS2.INI file,
  3904. validate the value range for each one,
  3905. compare each to the Handles or Objects structure
  3906. and place all valid entries into the Repair
  3907. Window.
  3908.  
  3909. The only type of Repair that is valid when listing items is the 
  3910. Report Only button.
  3911.  
  3912. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3913. handles is determined by the selections in the Repair Options Dialog.
  3914.  
  3915. The WPS Repair selections can take a considerable amount of time to
  3916. actually fill the Repair Window.  The reason for this is because both the
  3917. Handles and Objects structures must be filled before the analysis of the
  3918. WPS entries in the INI files can start.
  3919.  
  3920.  
  3921. Help for Display All Invalid WPS and Handle Entries
  3922.  
  3923. The Display All Invalid WPS and Handle Entries selection will cause the
  3924. next Repair Execution to
  3925. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3926. compare each Drive, Directory and Filename entry to the actual contents
  3927. of the appropriate drive and
  3928. analyze the various WPS entries in the OS2.INI file,
  3929. validate the value range for each one,
  3930. compare each to the Handles or Objects structure
  3931. and place all invalid entries into the Repair
  3932. Window with an notation as to why they are not valid.
  3933.  
  3934. The only type of Repair that is valid when listing items is the 
  3935. Report Only button.
  3936.  
  3937. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3938. handles is determined by the selections in the Repair Options Dialog.
  3939.  
  3940. The WPS Repair selections can take a considerable amount of time to
  3941. actually fill the Repair Window.  The reason for this is because both the
  3942. Handles and Objects structures must be filled before the analysis of the
  3943. WPS entries in the INI files can start.
  3944.  
  3945.  
  3946. Help for Display All WPS and Handle Entries
  3947.  
  3948. The Display All WPS and Handle Entries selection will cause the
  3949. next Repair Execution to
  3950. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3951. compare each Drive, Directory and Filename entry to the actual contents
  3952. of the appropriate drive and
  3953. analyze the various WPS entries in the OS2.INI file,
  3954. validate the value range for each one,
  3955. compare each to the Handles or Objects structure
  3956. and place all entries into the Repair
  3957. Window with an notation as to whether each item is valid or invalid.
  3958. For the invalid items there will also be a notation as to why they are
  3959. not valid.
  3960.  
  3961. The only type of Repair that is valid when listing items is the 
  3962. Report Only button.
  3963.  
  3964. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3965. handles is determined by the selections in the Repair Options Dialog.
  3966.  
  3967. The WPS Repair selections can take a considerable amount of time to
  3968. actually fill the Repair Window.  The reason for this is because both the
  3969. Handles and Objects structures must be filled before the analysis of the
  3970. WPS entries in the INI files can start.
  3971.  
  3972.  
  3973. Help for Repair Both WPS and Handle Entries
  3974.  
  3975. The Repair Both WPS and Handle Entries selection will cause the
  3976. next Repair Execution to
  3977. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  3978. compare each Drive, Directory and Filename entry to the actual contents
  3979. of the appropriate drive and
  3980. analyze the various WPS entries in the OS2.INI file,
  3981. validate the value range for each one,
  3982. compare each to the Handles or Objects structure,
  3983. place all invalid entries into the Repair
  3984. Window with an notation as to why they are not valid
  3985. and do the Repair action specified by the Type of Repair button.
  3986.  
  3987. Whether the entries
  3988. are removed or reported, depends on which Repair Type of button the user
  3989. has chosen.
  3990.  
  3991. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  3992. handles is determined by the selections in the Repair Options Dialog.
  3993.  
  3994. The WPS Repair selections can take a considerable amount of time to
  3995. actually fill the Repair Window.  The reason for this is because both the
  3996. Handles and Objects structures must be filled before the analysis of the
  3997. WPS entries in the INI files can start.
  3998.  
  3999. ************************************************************************
  4000. ************************************************************************
  4001. ************************************************************************
  4002. ****************REPAIR OPTIONS DIALOG***********************************
  4003. ************************************************************************
  4004. ************************************************************************
  4005. ************************************************************************
  4006.  
  4007. Help for Repair Options Dialog
  4008.  
  4009. The Repair Options Dialog will allow the user to control various
  4010. options during the repair process.
  4011.  
  4012.  
  4013. Help for Bypass Known Errors
  4014.  
  4015. The Bypass Known Errors.LOG checkbox will cause the Repair
  4016. function to bypass entries that are known to IniMaint and will quickly
  4017. reappear even if they are deleted.
  4018.  
  4019. The default for this item is Yes.
  4020.  
  4021. Among the kinds of things bypassed are:
  4022.  
  4023. Temporary files with the extension of files are updated.
  4024.  
  4025. The temporary NFD73 file that is created when WPSBKUP runs.
  4026.  
  4027. The zero entry in the Abstracts Icons Application generated by Deskman/2.
  4028.  
  4029.  
  4030. Help for Do Not Save Deleted Items
  4031.  
  4032. The Do Not Save Deleted Items checkbox will cause the items
  4033. that are removed from an INI file to simply be deleted and not saved.  If this
  4034. option is chosen, then Repairs can be performed without specifying a
  4035. Save INI File.
  4036.  
  4037.  
  4038. Help for Log to INIREP.LOG
  4039.  
  4040. The Log to INIREP.LOG checkbox will cause diagnostic
  4041. information to be written to the INIREP.LOG file.  This should only be
  4042. used as part of a problem determination sequence, since the saved
  4043. information will make little sense without a knowledge of the program
  4044. internals.
  4045.  
  4046.  
  4047. Help for Ignore CD-ROM Handles
  4048.  
  4049. The Ignore CD-ROM Handles button will cause all directories
  4050. and files on CD-ROM drives to be ignored, even if they are not valid.  This
  4051. option would be used if the User normally has a specific CD-ROM mounted
  4052. and does not want to know if the Handles in the OS2SYS.INI file agree with
  4053. the directories and files on the drive.
  4054.  
  4055.  
  4056. Help for Report CD-ROM Handles
  4057.  
  4058. The Report CD-ROM Handles button will cause all directories
  4059. and files on CD-ROM drives to be reported in the Repair Window.  However,
  4060. if the Do Repair button is selected in the Repair Dialog, the
  4061. invalid directories and files will not be removed from the OS2SYS.INI
  4062. file.  This option would be used if the User wants to know about invalid
  4063. Directories and Files on the CD-ROM drive, but does not want them removed
  4064. unless they are specifically selected.
  4065.  
  4066.  
  4067. Help for Auto Repair CD-ROM Handles
  4068.  
  4069. The Auto Repair CD-ROM Handles button will cause all directories
  4070. and files on CD-ROM drives to be removed
  4071. if the Do Repair button is selected in the Repair Dialog.  This is
  4072. the Default selection.
  4073.  
  4074.  
  4075. Help for Ignore Virtual Disk Drive Handles
  4076.  
  4077. The Ignore Virtual Disk Drive Handles button will cause all directories
  4078. and files on Virtual Disk drives to be ignored, even if they are not valid.  This
  4079. option would be used if the User normally has a specific Virtual Disk Drive
  4080. and does not want to know if the Handles in the OS2SYS.INI file agree with
  4081. the directories and files on the drive.
  4082.  
  4083.  
  4084. Help for Report Virtual Disk Drive Handles
  4085.  
  4086. The Report Virtual Disk Drive Handles button will cause all directories
  4087. and files on Virtual Disk drives to be reported in the Repair Window.  However,
  4088. if the Do Repair button is selected in the Repair Dialog, the
  4089. invalid directories and files will not be removed from the OS2SYS.INI
  4090. file.  This option would be used if the User wants to know about invalid
  4091. Directories and Files on the Virtual Disk Drive, but does not want them removed
  4092. unless they are specifically selected.
  4093.  
  4094.  
  4095. Help for Auto Repair Virtual Disk Drive Handles
  4096.  
  4097. The Auto Repair Virtual Disk Drive Handles button will cause all directories
  4098. and files on Virtual Disk drives to be removed
  4099. if the Do Repair button is selected in the Repair Dialog.  This is
  4100. the Default selection.
  4101.  
  4102.  
  4103. Help for Ignore Floppy Drive Handles
  4104.  
  4105. The Ignore Floppy Drive Handles button will cause all directories
  4106. and files on Floppy drives to be ignored, even if they are not valid.  This
  4107. option would be used if the User normally has a specific Floppy mounted
  4108. and does not want to know if the Handles in the OS2SYS.INI file agree with
  4109. the directories and files on the drive.
  4110.  
  4111.  
  4112. Help for Report Floppy Drive Handles
  4113.  
  4114. The Report Floppy Drive Handles button will cause all directories
  4115. and files on Floppy drives to be reported in the Repair Window.  However,
  4116. if the Do Repair button is selected in the Repair Dialog, the
  4117. invalid directories and files will not be removed from the OS2SYS.INI
  4118. file.  This option would be used if the User wants to know about invalid
  4119. Directories and Files on the Floppy Drive, but does not want them removed
  4120. unless they are specifically selected.
  4121.  
  4122.  
  4123. Help for Auto Repair Floppy Drive Handles
  4124.  
  4125. The Auto Repair Floppy Drive Handles button will cause all directories
  4126. and files on Floppy drives to be removed
  4127. if the Do Repair button is selected in the Repair Dialog.  This is
  4128. the Default selection.
  4129.  
  4130.  
  4131. Help for Ignore Not Ready Drive Handles
  4132.  
  4133. The Ignore Not Ready Drive Handles button will cause all directories
  4134. and files on Not Ready drives to be ignored, even if they are not valid.  This
  4135. option would be used if the User has drives that normally have specific
  4136. voluems mounted, but are not currently ready, 
  4137. and does not want to see the Handles in the OS2SYS.INI file for the drive.
  4138.  
  4139.  
  4140. Help for Report Not Ready Drive Handles
  4141.  
  4142. The Report Not Ready Drive Handles button will cause all directories
  4143. and files on Not Ready drives to be reported in the Repair Window.  However,
  4144. if the Do Repair button is selected in the Repair Dialog, the
  4145. invalid directories and files will not be removed from the OS2SYS.INI
  4146. file.  This option would be used if the User wants to know about invalid
  4147. Directories and Files on the Not Ready drive, but does not want them removed
  4148. unless they are specifically selected.
  4149.  
  4150.  
  4151. Help for Auto Repair Not Ready Drive Handles
  4152.  
  4153. The Auto Repair Not Ready Drive Handles button will cause all directories
  4154. and files on Not Ready drives to be removed
  4155. if the Do Repair button is selected in the Repair Dialog.  This is
  4156. the Default selection.
  4157.  
  4158.  
  4159. Help for Ignore Network Type Handles
  4160.  
  4161. The Ignore Network Type Handles button will cause all directories
  4162. and files on Network Types to be ignored, even if they are not valid.  This
  4163. option would be used if the User normally has a specific Network Entry
  4164. and does not want to know if the Handles in the OS2SYS.INI file agree with
  4165. the directories and files.
  4166.  
  4167.  
  4168. Help for Report Network Type Handles
  4169.  
  4170. The Report Network Type Handles button will cause all directories
  4171. and files on Network Entry to be reported in the Repair Window.  However,
  4172. if the Do Repair button is selected in the Repair Dialog, the
  4173. invalid directories and files will not be removed from the OS2SYS.INI
  4174. file.  This option would be used if the User wants to know about invalid
  4175. Directories and Files, but does not want them removed
  4176. unless they are specifically selected.
  4177.  
  4178.  
  4179. Help for Auto Repair Network Type Handles
  4180.  
  4181. The Auto Repair Network Type Handles button will cause all directories
  4182. and files on Network Entry to be removed
  4183. if the Do Repair button is selected in the Repair Dialog.  This is
  4184. the Default selection.
  4185.  
  4186. ************************************************************************
  4187. ************************************************************************
  4188. ************************************************************************
  4189. ******************EA DEFAULT DIALOG*************************************
  4190. ************************************************************************
  4191. ************************************************************************
  4192. ************************************************************************
  4193.  
  4194. Help for EA Defaults Dialog
  4195.  
  4196. The EA Defaults Dialog will allow the user to control various
  4197. options while working with the Extended Attributes.
  4198.  
  4199. The items that can be set are:
  4200.  
  4201.  
  4202. Help for EA File Directory
  4203.  
  4204. The EA File Directory is the Directory that will be
  4205. used whenever the name for a file to hold Extended Attributes is 
  4206. automatically generated.  This will also be used as the starting directory
  4207. for the File Dialog when the user is asked to select a filename.
  4208.  
  4209.  
  4210. Help for Display In Progress Box
  4211.  
  4212. The Display In Progress Box checkbox will cause the
  4213. Processing EAs Dialog to appear while the EAs are being
  4214. processed.  If this option is not chosen, then only the Wait pointer
  4215. will apppear on the screen.
  4216.  
  4217. The Default for this item is YES.
  4218.  
  4219.  
  4220. Help for Ignore No EAs for View/Test
  4221.  
  4222. The Ignore No EAs for View/Test checkbox will prevent an
  4223. entry in the Edit of Test Windows for any Directory or Path that does not have any EAs.
  4224. If this item is set to NO and there is a Directory or File with no
  4225. EAs, there will be an entry in the Appropriate Window for this Directory
  4226. or File and, for the Edit, the Key Name will simply say there are no EAs.
  4227. If the user
  4228. is not interested in knowing which files do not have EAs, then this
  4229. option should be left as YES, since it will reduce the number of entries
  4230. in the Windows for those situations where a number of Directories or Files
  4231. are included.
  4232. p.The Default for this item is YES.
  4233.  
  4234.  
  4235. Help for Include Hidden Files
  4236.  
  4237. The Include Hidden Files checkbox will cause files with
  4238. the Hidden Attribute set to be included in the files that are candidates
  4239. to have their EAs processed.
  4240.  
  4241. The Default for this item is NO.
  4242.  
  4243.  
  4244. Help for Include System Files
  4245.  
  4246. The Include System Files checkbox will cause files with
  4247. the System Attribute set to be included in the files that are candidates
  4248. to have their EAs processed.
  4249.  
  4250. The Default for this item is NO.
  4251.  
  4252.  
  4253. Help for Ask for EA Filename
  4254.  
  4255. The Ask for EA Filename checkbox will cause the user to be
  4256. prompted for a Filename anytime that one is needed to contain the EAs
  4257. for the selected Directories and/or Files.  If this items is left as the
  4258. Default NO, then the filenames will be constructed automatically and will
  4259. be a combination of the range of Directories and/or Files requested and the
  4260. root entry picked by the user.
  4261.  
  4262. The only exception to the above is when the Keep Temporary Files
  4263. option is not checked and the View or Compare menu items 
  4264. are selected.  Since all
  4265. files needed to accomplish the View or Compare will be automatically
  4266. deleted as soon as the function is completed, the user will not be asked
  4267. for a filename unless the filename constructed already exists and the
  4268. Overwrite Existing Files option is not selected.
  4269.  
  4270. The Default for this item is NO.
  4271.  
  4272.  
  4273. Help for Keep Temporary Files
  4274.  
  4275. The Keep Temporary Files checkbox will cause files that are
  4276. created to temporarily hold EA information, such as for a Compare of the
  4277. EAs between two sets of Directories and/or Files, to be kept after the
  4278. files are no longer needed.  If this item is left as the Default NO, then
  4279. these files will be deleted.  This will apply whether or not the name of the
  4280. files is chosen by the user or done automatically.
  4281.  
  4282. Selecting this option will also disable the Ask for EA Filename
  4283. for those
  4284. selections that use temporary files, such as View and Compare, since the
  4285. files used for these selections will be automatically deleted once the
  4286. user is  finished with them.
  4287.  
  4288. The Default for this item is NO.
  4289.  
  4290.  
  4291. Help for Overwrite Existing Files
  4292.  
  4293. The Overwrite Existing Files checkbox will cause any existing
  4294. file that already exists to be overwritten when the same filename is chosen
  4295. by the user or built automatically.  If this item is left as the Default NO,
  4296. then the user will always be prompted before a file is overwritten.
  4297.  
  4298. The Default for this item is NO.
  4299.  
  4300.  
  4301. Help for Log to INIEA.LOG
  4302.  
  4303. The Log to INIEA.LOG checkbox will cause diagnostic
  4304. information to be written to the INIEA.LOG file.  This should only be
  4305. used as part of a problem determination sequence, since the saved
  4306. information will make little sense without a knowledge of the program
  4307. internals.
  4308.  
  4309. The Default for this item is NO.
  4310.  
  4311.  
  4312. Help for Continue on Sharing Violations
  4313.  
  4314. The Continue on Sharing Violations checkbox will prevent the
  4315. user from being asked if he wants to continue whenever a Sharing Violation
  4316. is encountered while attempting to access the Extended Attributes for a
  4317. Directory or File.  If this item is checked, then SysMaint will assume that
  4318. the user wants to continue to the next Directory or File.
  4319.  
  4320. The Default for this item is NO.
  4321.  
  4322. ************************************************************************
  4323. ************************************************************************
  4324. ************************************************************************
  4325. ********************EA TEST DIALOG**************************************
  4326. ************************************************************************
  4327. ************************************************************************
  4328. ************************************************************************
  4329.  
  4330. Help for EA Test Dialog
  4331.  
  4332. The EA Test Dialog displays the results of the Extended
  4333. Attribute Test that the user has requested.
  4334.  
  4335.  
  4336. Help for Print
  4337.  
  4338. Selecting Print will cause the contents of the Listbox to
  4339. be printed.  The printing is done in a separate thread, so that the message
  4340. queue is not blocked.  However, the Test Dialog cannot be dismissed until
  4341. the Print is finished, since dismissing the Dialog will cause the memory
  4342. allocated to hold the Listbox items to be released.
  4343.  
  4344.  
  4345. Help for Write
  4346.  
  4347. Selecting Write will cause the contents of the Listbox to
  4348. be written to the file that is selected from the File Selection Dialog.
  4349. The writing is done in a separate thread, so that the message
  4350. queue is not blocked.  However, the Test Dialog cannot be dismissed until
  4351. the Write is finished, since dismissing the Dialog will cause the memory
  4352. allocated to hold the Listbox items to be released.
  4353.  
  4354. ************************************************************************
  4355. ************************************************************************
  4356. ************************************************************************
  4357. ******************  EXPLAIN DIALOG  ************************************
  4358. ************************************************************************
  4359. ************************************************************************
  4360. ************************************************************************
  4361.  
  4362. Help for Explain Dialog
  4363.  
  4364. The Explain Dialog displays the results of the Explain
  4365. requested by the user via one of the Popup Menus.
  4366.  
  4367.  
  4368. Help for Print
  4369.  
  4370. Selecting Print will cause the contents of the Listbox to
  4371. be printed.  The printing is done in a separate thread, so that the message
  4372. queue is not blocked.  However, the Explain Dialog cannot be dismissed until
  4373. the Print is finished, since dismissing the Dialog will cause the memory
  4374. allocated to hold the Listbox items to be released.
  4375.  
  4376.  
  4377. Help for Write
  4378.  
  4379. Selecting Write will cause the contents of the Listbox to
  4380. be written to the file that is selected from the File Selection Dialog.
  4381. The writing is done in a separate thread, so that the message
  4382. queue is not blocked.  However, the Explain Dialog cannot be dismissed until
  4383. the Write is finished, since dismissing the Dialog will cause the memory
  4384. allocated to hold the Listbox items to be released.
  4385.  
  4386. ************************************************************************
  4387. ************************************************************************
  4388. ************************************************************************
  4389. ******************DESK DEFAULT DIALOG***********************************
  4390. ************************************************************************
  4391. ************************************************************************
  4392. ************************************************************************
  4393.  
  4394. Help for Desktop Defaults Dialog
  4395.  
  4396. The Desktop Defaults Dialog will allow the user to control various
  4397. options while working with the Extended Attributes.
  4398.  
  4399. The items that can be set are:
  4400.  
  4401.  
  4402. Help for Save Desktop Directory
  4403.  
  4404. The Save Desktop Directory is the Directory that will be
  4405. used as the target directory for all Simple Backups of the Desktop.
  4406. This Directory will also be used as the default directory for the
  4407. Backup and Restore CMD files.
  4408.  
  4409.  
  4410. Help for Backup CMD Filename
  4411.  
  4412. The Backup CMD Filename is the Filename that will be
  4413. used for the Backup CMD file.  This Filename must have an extension of
  4414. CMD.
  4415.  
  4416.  
  4417. Help for Restore CMD Fileneame
  4418.  
  4419. The Restore CMD Filename is the Filename that will be
  4420. used for the Restore CMD file.  This Filename must have an extension of
  4421. CMD.
  4422.  
  4423.  
  4424. Help for Maximum Backup Generations
  4425.  
  4426. The Maximum Backup Generations is the number of
  4427. generations of Simple Backups that will be automatically maintained.
  4428. Once the number of Backups reaches the maximum, each new Backup will
  4429. cause the oldest generation to be deleted.  The default value is 10
  4430. generations.
  4431.  
  4432. If the number of generations is increased, there will be no
  4433. problems with the actual backup files.  However, if the number of
  4434. generations is reduced below the number of actual generations of
  4435. Backup that currently exist, then the extra generations must be
  4436. deleted manually.  For example, if the maximum generations were to be
  4437. reduced from 10 to 5 and there were 10 generations of backup
  4438. currently in the Backup Directory, Backup generations 6 thru 10 would
  4439. not be deleted automatically.  The reason for this is because  it is
  4440. very possible that the user does not want the higher generations
  4441. deleted and this approach gives them complete control over deleting
  4442. old generations when the maximum is changed.
  4443.  
  4444. ************************************************************************
  4445. ************************************************************************
  4446. *********************