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