home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / inimt33a.zip / inihelp.txt < prev    next >
Text File  |  1994-11-04  |  285KB  |  6,625 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. ************************************************************************
  17. ************************   INI HELP   **********************************
  18. ************************************************************************
  19. ************************************************************************
  20. ************************************************************************
  21. ************************************************************************
  22. ************************************************************************
  23. ************************************************************************
  24. ************************* EXTENDED HELP ********************************
  25. ************************************************************************
  26. ************************************************************************
  27. ************************************************************************
  28. * INIMAINT EXTENDED HELP PANEL - This panel is displayed
  29. * for a help request when no dialogs or message boxes are visible.
  30. ************************************************************************
  31.  
  32. About The Ini File Maintenance Program
  33.  
  34. Ini File Maintenance is a Presentation Manager-based
  35. application which is an utility for the maintenance of the various
  36. OS/2 INI Files. IniMaint is a Shareware product, therefore, it can be
  37. tried by simply downloading it from any one of a number of electronic
  38. sources.
  39.  
  40. System Maintenance is an upgrade from IniMaint that
  41. will also process Extended Attributes.  If SysMaint is purchased,
  42. then IniMaint is included, since SysMaint is the more capable
  43. program.  If IniMaint is purchased, then only the INI file code is
  44. activated.  An additional license fee is required to upgrade IniMaint
  45. to SysMaint. SysMaint is not a Shareware product, therefore, the only
  46. way to try SysMaint is to obtain a SysMaint Registration ID.
  47.  
  48. Multi Maintenance is an upgrade from SysMaint that will also Save
  49. and Restore the desktop on an Object by Object basis. This Object by
  50. Object backup can be used to move the Desktop from one machine to
  51. another or used to restore the Desktop after the installation of a
  52. new version of OS/2 that required the user to reformat the boot
  53. partition before doing the new install.  If MultiMaint is purchased,
  54. then SysMaint and IniMaint are included, since MultiMaint is the more
  55. capable program.  An additional license fee is required to upgrade
  56. SysMaint or IniMaint to MultiMaint.  MultiMaint is not a Shareware
  57. product, therefore, the only way to try MultiMaint is to obtain a
  58. MultiMaint Registration ID.
  59.  
  60. The help facility is designed to give a context-sensitive
  61. description of either the current window or the highlighted menu item
  62. within that window.
  63.  
  64. For more information about using the help facility, select
  65. Help for help on the Help pull-down.
  66.  
  67. ************************************************************************
  68. ************************************************************************
  69. ************************************************************************
  70. ************************ GENERAL INI HELP ******************************
  71. ************************************************************************
  72. ************************************************************************
  73. ************************************************************************
  74.  
  75. General Help Information
  76.  
  77. There are a number of General area of information that do not
  78. easily fit into any of the other Help categories.  The purpose of
  79. this section is to address these areas.
  80.  
  81. ************************************************************************
  82. ************************************************************************
  83. ************************************************************************
  84. **************************** TOOLS HELP ********************************
  85. ************************************************************************
  86. ************************************************************************
  87. ************************************************************************
  88.  
  89. Help for the Tools
  90.  
  91. Tools are a quick and easy way to use virtually all of the 
  92. IniMaint, SysMaint or MultiMaint functions without having to bring up the 
  93. Main Window and work your way through the Menus.  Each of the Icons in the 
  94. Tools Folder represents a function that is already on one of the Menus, but 
  95. the function can be called upon directly and the Tool will terminate as soon 
  96. as the Function is complete.
  97.  
  98. Each of the Tools will actually execute the same EXE file as is executed 
  99. when the Application is run normally.  However, a Command Line parameter is 
  100. apssed to the Application that tells it to run in Tools Mode and which 
  101. Function the user wants to run.  By using a single EXE for all of the normal 
  102. functions as well as the Tools, there is no chance that the capabilities of 
  103. the various Tools and the basic Application will get out of synch.
  104.  
  105. Although the user can gererate the Tool Icons for any of the Applications, 
  106. IniMaint, SysMaint or MultiMaint, when they run the Install program, each of 
  107. the Tools will check to see if the user is registered at the proper level 
  108. before running.  If an attempt is made to run a SysMaint Tool and the user 
  109. has not registered SysMaint, then the Tool will not run and the user will see 
  110. a Message Box informaing him of this.
  111.  
  112. None of the Tools will work with the unregistered Shareware version of 
  113. IniMaint.  In order to use the Tools, just as with the Explain function, a 
  114. registered copy of the Application is required.
  115.  
  116.  
  117.  
  118. ************************************************************************
  119.  
  120.  
  121.  
  122. Getting Started Help Information
  123.  
  124. The primary purpose of this section is to help the user who did
  125. not get IniMaint or SysMaint to address a specific problem and one
  126. who is not familiar with the INI Files and Extended Attributes.
  127.  
  128. If you are a new OS/2 user or are not familiar with INI Files and
  129. Extended Attributes, then you should first review the various Help
  130. entries that are listed under the See Also category for this Help
  131. item.  These General Help entries will give you an overview of
  132. IniMaint, MultiMaint and SysMaint and the environment in which they operate.
  133.  
  134. One of the biggest concerns of those who are not knowledgeable
  135. about OS/2 is that they do not want to do something that will damage
  136. their Desktop.  If this is your primary concern, then you should
  137. start with IniSafe, SysSafe or MltSafe.  Both of these have all of the menu
  138. items that the main program has.  However, all menu entries that
  139. could make any change to the INI Files or Extended Attributes have
  140. been disabled.  Therefore, it is not possible to make any changes
  141. with these programs.  You can use these program to explore the
  142. contents of the various INI files and Extended Attributes and can
  143. play with all of the menu items without worrying about causing a
  144. problem with your Desktop.
  145.  
  146. Once the user is ready to use the fully capable program, they
  147. should be sure that they have a good backup of their Desktop.  If you
  148. have SysMaint, this can be accomplished in less than a minute using
  149. the Desktop menu.  The user should make a Backup of his Desktop and
  150. be sure to create a Restore CMD file, so that the Restore can be done
  151. if a problem occurs with the Desktop.  If you are an IniMaint user,
  152. then you can upgrade to SysMaint for a reasonable amount.  If you
  153. already have a desktop Backup program, you should be sure you have a
  154. current Backup and make a new one anytime you make enough changes to
  155. your Desktop that you would be very unhappy to have to do them over
  156. again.
  157.  
  158. One word about making sure the Backup is a current one.  Much of
  159. the information about those Desktop items that are represented as
  160. files, which includes all folders, is kept in the Extended Attributes
  161. of the Desktop Directory structure.  Currently, the Extended
  162. Attributes for the Desktop are not updated except during a Shutdown
  163. of OS/2.  Therefore, if you have made significant changes to the
  164. folders, the contents of folders or have rearranged the  folders on
  165. the Desktop, it would be a good idea to do a Shutdown and reboot
  166. before making a Backup.
  167.  
  168. The Backup is not recommended because of any known problem with
  169. IniMaint, SysMaint or MultiMaint or even because using the programs
  170. will cause any Desktop problems.  It is recommended because there are
  171. many things which can cause problems with a Desktop and, as time goes
  172. on, the ways that a Desktop can be damaged will change.  No one
  173. should be without a plan to recover from any kind of damage that
  174. might be done to their Desktop, unless they want to gain experience
  175. doing their Desktop customization over and over.  It takes but a
  176. minute to make the Backup and having it can save many hours of work. 
  177. Here are Carry Associates, we have clobbered the Desktop in many
  178. different ways, but have never had to reinstall OS/2 because we
  179. have always had a Backup and a plan for how we would recover from a
  180. Desktop problem.
  181.  
  182. A word about the warnings that you will see both in the
  183. documentation and when you are about to perform certain INI File or
  184. Extended Attribute changes.  There are those who say that some of the
  185. warnings are too extreme and make the user very uncomfortable.  It is
  186. very possible that this is correct.  However, we have left things the
  187. way they are because we believe it is a good thing for any user to
  188. pause and make sure that they really want to do what they are
  189. attempting and to be sure that they understand what is happening.  If
  190. any user finds themselves at one of these warnings and is not sure
  191. about what is going to happen, then they should Cancel.  The purpose
  192. of this Help file is to explain things to the point that each user
  193. will understand each function before they use it.  If this is not the
  194. case, then we at Carry Associates will be more than happy to talk to
  195. you and help you understand what is going on.  This will also help us
  196. to know where additional Help explanation is warranted.
  197.  
  198. Once the Backup of the Desktop is safely done.  Each user should
  199. use the Repair INI Files entry on the Recover Menu to do a Repair of
  200. both the File Handles and the WPS Entries.  The best way to do this
  201. is to leave the Type of Repair at the default, Report Only, and ask
  202. for a Repair of the File Handles and then the WPS entries.  Once the
  203. user is comfortable that all of the listed items should be Repaired,
  204. the Do Repair button can be selected and then click on Execute to
  205. actually perform the Repairs.  These two Repair functions will remove
  206. any entries in the OS2.INI or OS2SYS.INI files that represent files
  207. or WPS Objects that no longer exist on the Desktop.
  208.  
  209. While the items discussed above are the primary Repair items,
  210. there is a long list of other kinds of Repair.  The best way to get
  211. more information on a specific type of Repair, simply highlight one
  212. of the Repair Types in the Drop Down Combobox and hit the F1 key, this
  213. will give you the Help for that specific Repair Action.
  214.  
  215. Aside from the above and lacking a specific problem, it is
  216. suggested that users might want to go through both the OS2.INI and
  217. OS2SYS.INI files, just to review their contents.  Simply looking at
  218. the names of the Applications, Key Names and the values will give any
  219. user a lot of information on how OS/2 works and the purpose of the INI
  220. files.
  221.  
  222. If you have SysMaint, then it is worthwhile to View the Extended
  223. Attributes for the Desktop Directory, all of its sub directories and
  224. files.  This will make the structure of OS/2 much clearer and will
  225. help the user to understand the real power and utility of the
  226. Extended Attributes.
  227.  
  228. ************************************************************************
  229.  
  230. Help for What is an INI File?
  231.  
  232. This is not intended to be a replacement for the normal
  233. documentation on INI files, but just a very general orientation
  234. explaining the reason I started the development of IniMaint.
  235.  
  236. Many, if not all applications that run in any computer environment
  237. need to have a place to keep information that is system specific.  In
  238. a standard DOS environment, every application must define a place for
  239. this information and manage it themselves.  With the advent of
  240. Windows and it's requirement that a lot of Windows information be
  241. kept somewhere, a standard file approach was developed.  In the
  242. original Windows environment this file was called WIN.INI and could
  243. contain information about Applications as well as Windows itself. 
  244. This file was, and still is, a standard ASCII text file and this
  245. causes some problems.  Specifically, much of the data stored in the
  246. file could be more efficiently stored and used if it was in a binary
  247. format and, more important, an ASCII file meant that the user could,
  248. and almost always did, edit the file.  This editing can introduce
  249. errors, so the parsing of the file becomes a big problem.  Because of
  250. formatting and performance problems, some of the standard information
  251. needed to run individual programs was still not stored in the INI
  252. file, but was stored in individual Program Information Files or PIF
  253. files.  These files were binary, thus solving the performance and
  254. editing problems, since they were maintained by Windows itself. 
  255. However, this generated a huge number of tiny files, each one taking
  256. an entire allocation unit on the harddisk and generating a
  257. significant backup problem.  OS/2 takes the concept a step
  258. further by making the INI files binary files and incorporating all of
  259. the information that Windows stores in the PIF files in the same
  260. file.  These files OS2.INI, for user information, and OS2SYS.INI, for
  261. system information.  In addition, a set of OS/2 API's are
  262. supplied to manage these files.
  263.  
  264. The OS/2 INI files are organized on three levels:
  265.  
  266. The highest level is the Application Name.
  267.  
  268. Within each Application, there is a series of individual entries
  269. which are called Keys and identified by a Key name.
  270.  
  271. Associated with each Key name is the actual data for the
  272. Application/Key pair or Key value.
  273.  
  274. For example, IniMaint will create a new Application called "INI
  275. File Maintenance" in the OS2.INI file.  This is the IniMaint
  276. Application name.  One of the Keys that IniMaint will create is
  277. "Current INI" which is used to keep track of which INI file the user
  278. is currently working with.  The Key value for this
  279. Application/Key pair will be the path and filename of the current
  280. INI file.
  281.  
  282. Since the files are binary, the performance is reasonable,
  283. especially since the files do not have to be accessed that often.  In
  284. addition, the contents of the files are managed by OS/2, so there
  285. is not a problem of parsing the entries to insure that they are
  286. properly formatted.  
  287.  
  288. However, this creates other problems.  For example, there is no
  289. way for a user to even find out what is in the files, even for
  290. applications that he has installed.  One of the advantages of the
  291. fact that the Windows INI files were ASCII and the PIF files were
  292. application specific was that they user could install an application
  293. on one system and then move it, with customizing, to other systems by
  294. moving the PIF files and, sometimes, some entries from the INI
  295. files.  None of this is possible in an OS/2 environment.  Every
  296. machine must be customized manually and every change must be made in
  297. every system.  Further, it turns out that no application, including
  298. OS/2 itself, makes any provision for removing obsolete entries
  299. from the INI files.  Therefore, as you change your OS/2
  300. environment and upgrade or change your applications, the OS2.INI file
  301. and OS2SYS.INI files get bigger and bigger as they fill with
  302. information that no longer applies to your environment.  Finally,
  303. since OS/2 always has the User and System INI files open, there
  304. is no way to create a backup of these files except during boot time. 
  305. This normally means you have to keep several layers of copies, since
  306. you have to reboot to fix anything.
  307.  
  308. IniMaint was developed to address the new problems introduced by
  309. the new INI file approach in OS/2.  With IniMaint you can review
  310. what is in the files, change it, delete old entries, do complete or
  311. partial backups at any time and otherwise have an appropriate level
  312. of control over these files.
  313.  
  314. ************************************************************************
  315.  
  316. Help for What is an Extended Attribute?
  317.  
  318. Extended Attributes are added to directories and files to describe
  319. the contents, use, association and many other aspects of the
  320. directory or file.  The Extended Attributes are not an actual part of
  321. the file, but are associated with the file.  For HPFS this Extended
  322. Attribute information is kept in the Directory entry, for FAT the
  323. information is kept in a separate file, since there is not enough
  324. room in the directory.  Refer to the OS/2 documentation for a
  325. more complete discussion of Extended Attributes themselves.
  326.  
  327. One of the problems with OS/2 is that, while it makes extensive
  328. use of Extended Attributes, it does not provide the user with the
  329. tools necessary to deal with problems or give users the tools
  330. necessary to understand them.  While this is a problem for everyone,
  331. it is especially a problem for developers who might want to take
  332. advantage of Extended Attributes in their applications.
  333.  
  334. SysMaint is designed to all the user to look at the Extended
  335. Attributes that are present on their system, edit them, if necessary,
  336. and do a number of different kinds of maintenance functions. 
  337. However, before discussing how SysMaint handles Extended Attributes,
  338. it is necessary to be sure that everyone understands a little about
  339. how Extended Attributes are structured.  The following discussion
  340. assumes that the reader is already familiar with IniMaint, the
  341. structure of the IniMaint windows and how IniMaint displays and
  342. maintains INI Files.
  343.  
  344. The is a parallel between how INI files are structured and how
  345. Extended Attributes are structured so SysMaint uses most of the
  346. IniMaint code to handle the Extended Attributes.  INI Files are
  347. organized into Applications that have one or more Keys and each Key
  348. has a Value assigned to that Key.  Extended Attributes are associated
  349. with a Directory or a File, each of which can have more than one
  350. Extended Attribute and each Extended Attribute has a Name and an
  351. associated value.  Therefore, SysMaint will display the names of the
  352. Directories or Files in the Application Window, the Names of the
  353. Extended Attributes in the Key Name Window and the Extended Attribute
  354. Value in the Key Value Window.
  355.  
  356. The approach above works very well for Simple Extended Attributes.
  357. However, the parallel between INI Files and Extended Attributes
  358. breaks down when it encounters a Multiple Value Extended Attribute,
  359. so some modifications are needed to handle this situation.
  360.  
  361. There are three general types of Extended Attributes as far as
  362. SysMaint is concerned:
  363.  
  364. Extended Attributes that SysMaint does not understand and will
  365. display just as they are found.
  366.  
  367. Simple Extended Attributes that use the type identifiers that are
  368. documented in the OS/2 documentation.  These are Extended Attributes
  369. that closely parallel the INI File structure and are displayed that
  370. way.
  371.  
  372. Multiple Extended Attributes, which are Extended Attributes that
  373. contain other Extended Attributes.  These are the Extended Attributes
  374. that do not closely parallel the INI File structure.
  375.  
  376. There were two different ways that SysMaint could handle the Multiple
  377. Value Extended Attributes:
  378.  
  379. They could simply be identified as Multiple Value and the entire
  380. Extended Attribute could be placed in the Key Value Window.
  381.  
  382. The structure of the Multiple Value Extended Attribute could be
  383. decoded and displayed in the windows in a decoded form.
  384.  
  385. Since the decoding of the Multiple Value Extended Attributes is not a
  386. trivial task, especially since a Multiple Value Extended Attribute
  387. can contain other Multiple Value Extended Attributes, thus causing
  388. multiple levels of decoding, SysMaint will decode the Multiple Value
  389. Extended Attributes and display them in decoded form.  This causes a
  390. single Extended Attribute to have multiple entries in the Key Name
  391. window.  In order to create unique Key Entries and to display the
  392. level of the Extended Attribute, each Key Name will be followed by
  393. two additional pieces of data, each placed inside a pair of parens.
  394.  
  395. The Level of the Extended Attribute.  For a Simple Extended
  396. Attribute this will simply be: (01).  For a Multiple Value Extended
  397. Attribute the numbers will start with (01) and increase by one for
  398. each of the Extended Attributes within the initial one.  If another
  399. level of Multiple Value Extended Attributes is encountered, then an
  400. additional level will be added to the Level Information: (04.01),
  401. would mean that the fourth main level Extended Attribute is a
  402. Multiple Value Extended Attribute and this is the first entry for
  403. that Extended Attribute.
  404.  
  405. The type of Extended Attribute, such as Ascii, Binary, Icon or
  406. Multiple Value.
  407.  
  408. This arrangement sounds complicated, but it ends up looking very
  409. much like an outline would look and is not difficult to understand. 
  410. Since all of the entries will start with the name of the Extended
  411. Attribute, it is very easy to know which entries go with which.
  412.  
  413. The on-line Help for SysMaint has extensive detailed descriptions
  414. of how to select which Extended Attributes you want to operate on,
  415. what operation you want done and how you want to handle the various
  416. default actions.  Therefore, it might be very useful to review the
  417. On-line Help before doing much with the actual Extended Attributes.
  418.  
  419. Finally, a word of warning and a request for help.
  420.  
  421. The warning is that Extended Attributes can be critical to the
  422. health of you environment.  Therefore, you should not do something
  423. with the Extended Attributes on your system if you are not sure you
  424. understand what you are doing.  You cannot hurt yourself if you
  425. simply look at Extended Attributes via the Edit Function or Save
  426. them.  However, something like Splitting the Extended Attributes from
  427. a file will leave the file without the Attributes.  If you are doing
  428. it so you can backup the file under DOS and will be careful to Join
  429. the Extended Attributes back to the files before you use them.  If
  430. you are not sure about what you want to do, please go to the OS2AVEND
  431. Forum on Compuserve, Section 1 and we will be more than happy to
  432. discuss your intentions and any potential problems.
  433.  
  434. The request for help involves supplying documentation on any
  435. unusual conditions you might encounter.  One of the items in the
  436. Default Dialog for the Extended Attributes is to activate a log to
  437. the INIEA.LOG file.  Anytime you encounter a condition where SysMaint
  438. cannot handle an Extended Attribute condition or have invalid
  439. Extended Attributes, I would ask you to turn on the logging, ask to
  440. Edit the Extended Attributes that are invalid or causing a problem,
  441. close SysMaint, zip the resulting INIEA.LOG file and Email it to use
  442. using the Compuserve ID in the main documentation or mail to the
  443. supplied address.  This will allow us to be able to see the various
  444. conditions that occur and modify the program to handle them.
  445.  
  446. ************************************************************************
  447.  
  448. Help for How to Modify Extended Attributes
  449.  
  450. The Extended Attributes for a set of Directories and/or Files
  451. can obviously be modified by using the Extended Attribute Menu Item
  452. Join. However, it is often the case that a user simply wants to look
  453. at the Extended Attributes for a specific Directory or File and then
  454. make some sort of minor modification to them. The purpose of this
  455. Help entry is to explain how to do that, since a number of users have
  456. expressed confusion in this area. Here is how it is done:
  457.  
  458. Use the View entry on the Extended Attribute Menu to get the
  459. Extended Attributes for the appropriate Directory and/File into a
  460. temporary file. It is okay to select more Directories and/Files
  461. than you want to modify, since any set of Extended Attributes that
  462. are not changed will simply get written back unchanged.
  463.  
  464. Modify the Extended Attributes in the various windows as desired.
  465. There are a number of checks in the code to prevent a user from
  466. making changes that would create illegal Extended Attributes,
  467. however, care should still be exercised in this area. In short, if
  468. you are clear on what is allowed and what is not allowed, then you
  469. should not make any changes or be sure you have a solid backup of the
  470. area you are changing.
  471.  
  472. Once the changes have been made, then the actual Extended
  473. Attributes can be updated by selecting the Update From Current File
  474. entry on the Extended Attribute Menu.
  475.  
  476. ************************************************************************
  477.  
  478. Help for What makes up the Desktop?
  479.  
  480. When OS/2 2.1 is booted and assuming the boot is from a
  481. Harddisk, the PM Shell is loaded and one of the first thing the PM
  482. Shell does is to start the Workplace Shell and the WPS, after
  483. thinking about it for awhile, brings up the Desktop.  While this is a
  484. loose description of the sequence of events, it is a accurate picture
  485. of what happens.
  486.  
  487. The Desktop consists of a Background and a bunch of Objects that 
  488. appear on the Background, most of which are called Folders and
  489. contain either other Folders, Programs or other sorts of useful
  490. things.  This Desktop is mentioned over and over in the documentation
  491. in order to teach the user how to use, maintain, modify and otherwise
  492. interact with OS/2 via the Desktop.
  493.  
  494. A lot of Applications have been written by people outside of IBM
  495. that are designed to help users maintain and backup the Desktop and
  496. both IniMaint, MultiMaint and SysMaint are in this category.  However,
  497. little is said in the documentation about exactly what is the
  498. Desktop, so I thought I would address this question.
  499.  
  500. The WPS itself is actually a PM Application, much like any other
  501. PM Application and runs as a single Process under the control of
  502. OS/2.  However, the WPS is an extremely complex and powerful
  503. Application that controls the entire operating environment.  The
  504. Application code itself is made up of the same stuff that any other
  505. Application is made of and that is executable files, all of which are
  506. DLL's, I think.  The actual code that runs the Desktop is clearly the
  507. same for everyone that is using the same version of OS/2 and this
  508. code is never changed during the operation of WPS, so the unique
  509. characteristics of each Desktop must be somewhere else.
  510.  
  511. The is also a lot of discussion of INI files, especially the ones
  512. used by the operating system, OS2.INI and OS2SYS.INI, and there is
  513. some discussion of Extended Attributes.  Finally, there is a
  514. Directory structure that gets created on the drive used as the base
  515. for the WPS that appears to contain nothing more than a bunch of
  516. empty Directories.
  517.  
  518. The Desktop consists of a collection of Objects that are created
  519. by WPS from the Object information that is kept in two places.
  520.  
  521. The first kind of
  522. of Object on the Desktop is called a File Object and every File Object is
  523. represented by a Directory in the Desktop Directory, including the
  524. Desktop itself.  The reason the Desktop Directories appear to be empty is
  525. because all of the information needed to create a File Object is kept in
  526. the Extended Attributes for the specific Directory.
  527.  
  528. The second kind of Object on your Desktop is called an Abstract Object and
  529. the information needed to create this kind of Object is kept in the OS2*.INI
  530. files, mostly the OS2.INI files.
  531.  
  532. In summary, the entire Desktop is contained in the Desktop Directory
  533. structure, the Extended Attributes for the Desktop Directory and the
  534. contents of the OS2*.INI files.  With one exception, at least one of the
  535. Desktop Directories will have files in it, the Templates Directory, and
  536. these files along with their Extended Attributes are also part of the
  537. Desktop.  Therefore, all that is required to make a Simple Backup of the
  538. Desktop that can be used to restore the current environment on the current
  539. machine is to make a copy of the above items.
  540.  
  541. ************************************************************************
  542.  
  543. Help for System and User File Definition
  544.  
  545. There are two standard INI Files that are used by OS/2.  The
  546. System INI file, normally OS2SYS.INI, is used to store system level
  547. initialization and control information.  The User INI File, OS2.INI,
  548. is used to store application level initialization and control
  549. information.
  550.  
  551. The distinction between what is system level information and what is
  552. application level information appears to the author to be somewhat blurred.
  553. It looks like a lot of information that could be considered system level
  554. information is stored in the User INI file.
  555.  
  556. It makes little difference to the User how OS/2 decides where to put
  557. various pieces of information, since it does not change how applications
  558. that are installed on the Desktop should handle their initialization and
  559. control information.  The System INI File should not ever be used by any
  560. application installed on the Desktop, except things such as device drivers
  561. and other applications that are clearly System Applications.  All user
  562. Desktop applications must store their information in the User INI file or
  563. in their own application INI file.  To date, most applications have chosen
  564. to use the User INI file rather than create an INI file just for their
  565. application.
  566.  
  567. ************************************************************************
  568.  
  569. Help for Non Write INI Files
  570.  
  571. V2.1 of OS/2 changed the way the INI files are kept updated. 
  572. The new scheme was a welcome one because it greatly improved the
  573. performance of this area of OS/2 and removed the problem of INI
  574. files becoming very large because of a lot of unused space.  However,
  575. the change introduced a problem that had not existed previously, that
  576. is, it is possible to get into a situation where the OS2.INI and
  577. OS2SYS.INI files cannot be updated.  When this condition occurs and
  578. any changes are made to the Desktop, it appears that the changes are
  579. being made correctly.  However, only the INI file information that is
  580. kept in memory is being updated, that actual INI files are not
  581. changed in any way.  Even though this situation exists, the user is
  582. given not warning or information that there is a problem.  Normally,
  583. the user would discover the problem when the changes made to the
  584. Desktop disappeared the next time that OS/2 was booted. 
  585. Occasionally, the problem would be even more serious because one of
  586. the INI files could be updated, but the other could not.  This can
  587. cause serious problems with the Desktop.
  588.  
  589. Many users, when they realize they have this problem, look at the
  590. INI file entries in the directory and see that the RO attribute is
  591. turned on.  They then assume that this is the problem and reset the
  592. bit.  However, the RO attribute should always be on for any INI file
  593. that is open, and resetting the attribute does not solve the
  594. problem.  The real problem is that the files used as a target for the
  595. INI file updates, zero length hidden files with a !!! extension are
  596. missing.  The reason these files are missing is because the INI files
  597. already had the RO attribute turned on when the PM Shell was started,
  598. therefore, the INI file code did not create the !!! files.  The best
  599. manual solution is to boot from a diskette or reboot, if the user has
  600. ShiftRun, and reset the RO attribute off while the PM Shell is not
  601. active.  This will fix the problem and the INI files will now be
  602. updated normally.
  603.  
  604. ************************************************************************
  605.  
  606. Help for Automatic Repair of Non Write INI Files
  607.  
  608. Anytime that IniMaint, SysMaint or MultiMaint attempts to update an
  609. INI file and the update fails, a check is made to see if the file is
  610. either the User or System INI files.  If either file is found, the it
  611. is assumed that one or both of the INI files is in a condition where
  612. is cannot be updated.  Normally, this condition would cause IniMaint,
  613. SysMaint or MultiMaint to terminate.  Since there is a way to fix
  614. this situation, but the fix involves resetting WPS, IniMaint,
  615. MultiMaint and SysMaint will inform the user of the situation and ask
  616. them if they want the condition fixed.  If the user replies no, then
  617. the application will terminate.  If the user replies yes, then the
  618. INI files will be fixed so that they can be updated.
  619.  
  620. Normally, IniMaint, MultiMaint and SysMaint will recognize this
  621. condition during the start-up of the application.  This is because
  622. the IniMaint, MultiMaint and SysMaint operational information is
  623. normally stored in the OS2.INI file, thus this file is normally
  624. updated very often.  However, it is possible that no updates will be
  625. attempted to the file because all of the defaults are already set or
  626. because the user has moved the application operational information to
  627. a different INI file.  In the first case, the condition will be
  628. recognized as soon as any action is taken which changes any of the
  629. IniMaint, SysMaint or MultiMaint operational information.  In the
  630. second case, the condition will not be recognized unless the User or
  631. System INI files are made the current INI file and an attempt is made
  632. to change something in one of these files.
  633.  
  634. ************************************************************************
  635.  
  636. Help for What is an IniMaint Group?
  637.  
  638. An IniMaint Group is a set of Applications in a specific INI file
  639. that has been formed and named by the user and is used as a
  640. convenient way to manipulate the contents of the INI file.  Without
  641. some way to form subsets of all of the Applications in an INI file,
  642. the only way to manipulate it is either Application by Application,
  643. which can be tedious, or by using the entire file, which provides no
  644. flexibility.  Since one of the objectives of IniMaint is to give the
  645. user an easy way to create backups of all or part of his INI files
  646. and to provide an easy way to restore an INI file, neither level of
  647. manipulation is satisfactory.
  648.  
  649. IniMaint solves this problem by giving the user the ability relate a
  650. set of Applications together into a Group.  Forming the Group does not
  651. change the Application information in the INI file, it simply creates
  652. an additional Application in the file that describes the Groups that
  653. the user has formed.  Once the Groups are created, then the Group
  654. name can be used in IniMaint operations and all the Applications in
  655. the Group will be included.
  656.  
  657. For example, many users install a number of programs that put entries
  658. into the standard User INI file, normally OS2.INI.  If there is a
  659. problem with the environment, something happens to the INI files or
  660. some other problem arises that clobbers the INI entries, then the
  661. only recovery is to re-customize all of these applications.  If the
  662. user were to put all of these Applications into a Group called
  663. 'My Applications', then he would not have this problem.  The My
  664. Applications Group could be backed up to a backup INI file at any
  665. time using the INICOPY program as follows:
  666.  
  667. INICOPY -IC:\OS2\OS2.INI -OC:\OS2\MYAPPS.INI -G"My Applications"
  668.  
  669. The above assumes the normal name and location for the INI files.  The
  670. name of the Group must be enclosed in ""'s if it contains any blanks
  671. or the Command Processor will split it into two different command
  672. line entries and INICOPY will return an error.
  673.  
  674. The same Group could be restored to the User INI file as follows:
  675.  
  676. INICOPY -OC:\OS2\OS2.INI -IC:\OS2\MYAPPS.INI -G"My Applications"
  677.  
  678. In other words, simply reverse the Input and Output filenames.
  679.  
  680. It is intended that this same approach can be used to keep multiple
  681. physical computers in synch with each other.  Right now, if the user
  682. has multiple systems, he must customize every installed application
  683. on every system.  You cannot move the INI files from one system to
  684. another, since there is a lot of information in the INI files that is
  685. system specific.  Using IniMaint, this process is made much easier,
  686. since the target INI file can be on a diskette and, even if there are
  687. some minor differences between the systems such as drive letters or
  688. something like that, IniMaint can be used to make modifications to
  689. the contents of the transfer INI file before it is copied to the new
  690. system.  This does not need to be limited to installation situations.
  691. One possible approach would be to form an Applications Group and,
  692. whenever any significant change is made to any application, the
  693. changes can be transferred to the other systems.  In fact, there is
  694. not reason, assuming the user had many systems and a LAN, that a
  695. separate transfer INI file could not be set up for every application,
  696. have it updated from a central source whenever a significant change
  697. is made and have a CMD file on individual client systems that would
  698. use the transfer INI files just for the applications installed on
  699. that system.
  700.  
  701. I suspect there are many ways to utilize the Group concept.  As of
  702. this writing, IniMaint has only been used by a few Beta testers and
  703. only for a short time.  Hopefully, as more users install and use
  704. IniMaint, more ideas on how the IniMaint Groups can be used will be
  705. developed.  I will do my best to include this new information into the
  706. IniMaint documentation and make it available on the Compuserve OS2AVEND
  707. Forum.
  708.  
  709. ************************************************************************
  710.  
  711. Help for What does Repair Do?
  712.  
  713. IniMaint has an item on the Recover menu called Repair.  This item
  714. gives the user the ability to perform a number of different automatic
  715. Repair actions on his INI files.  The On-line Help documents how the
  716. Repair function works, however, it does not detail the rational and
  717. algorithms employed by IniMaint to accomplish the various Repairs.
  718.  
  719. In general there are two different catagories of Repair.  Some of
  720. the Repair items act on the INI file that is the current INI file,
  721. whose name is displayed in the Title Bar.  For example the Check for
  722. Zero Length Key Values will look in the current INI file for any Key
  723. Value that has a Zero Length, which is not a valid condition.  The
  724. other catagory of Repair item behaves the same no matter what is the
  725. current INI file.  These Repair items act on the files that are
  726. currently being used by OS/2 as the User INI, normally OS2.INI,
  727. and the System INI, normally OS2SYS.INI, files.  For these System
  728. Level Repairs, it makes no difference which INI file is the current
  729. INI file, because the Repair item is not working on that file.  For
  730. example, the Repair File Handles item will look at the File Handle
  731. Structure that is in the INI file that OS/2 is currently using as
  732. the System INI file, check these Handles against the actual Paths and
  733. Files that exist on the HD and Repair those that do not exist.
  734. This section is an attempt to do that.
  735.  
  736. Type of Repair
  737.  
  738. There are four different type of Repair Options.
  739.  
  740. The first one, Report Only, will never make any changes, but will
  741. only list the items that would have been Repaired if the Do Repair
  742. Option had been chosen.
  743.  
  744. The Ask First, will ask the user if he wants each item repaired as
  745. the item is found and determined to be invalid.  This can take a very
  746. long time in some cases, since the number of items can become quite
  747. large
  748.  
  749. Do Repair, will automatically remove all invalid items for the
  750. category selected from the appropriate INI file.  This should only be
  751. used when the user is sure he wants all invalid items removed.
  752.  
  753. Do Selected can only be used after Report Only, since it requires
  754. that the invalid items be visible in the window.  When Execute is
  755. chosen with the Do Selected button checked, then every line in the
  756. window that is selected will be deleted.  The only exception to this
  757. is when doing either the Handles or WPS repair and a selected item
  758. has dependent items, such as subdirectories or files, in this case
  759. all dependent items will also be deleted.  For example, if a Drive
  760. name itself is selected and Do Selected is chosen, then all entries
  761. for the drive, including all directories and files, that have been
  762. identified as invalid will be deleted.
  763.  
  764. The easiest and safest way to remove invalid items when the user is
  765. not sure if they want everything done is to use the Report Only
  766. option, select the items that they want deleted and then use Do
  767. Selected.  This cycle can be repeated over and over until all of the
  768. desired items have been deleted.
  769.  
  770. Window Behavior
  771.  
  772. When and item is deleted for any reason, the word 'Deleted' will
  773. appear after the item in the window.  If there are deleted items in
  774. the window and additional items are selected for deletion then the
  775. previously deleted items will be removed from the window.  For
  776. example, if the first item in the window is selected and deleted, the
  777. word deleted would appear after the first item.  If then the second
  778. items is selected and deleted, the second item will now have the word
  779. deleted after it and the first item will be gone from the window.
  780.  
  781. Options
  782.  
  783. Different users want to handle directories and file that are on
  784. removable, not ready, cdrom and vdisk devices differently.  The
  785. Options dialog gives each user the ability to choose how they want
  786. each of these types of situations handled.
  787.  
  788. If Ignore is chosen, then directories and files on the appropriate
  789. type of device will be completely ignored and will never appear in
  790. the repair window.
  791.  
  792. If Report Only is selected, then the information will appear in the
  793. window, but will not get automatically deleted if the Do Repair
  794. option is chosen.  The Report Only items can still be deleted by
  795. selecting them and using the Do Selected option.
  796.  
  797. If Auto Repair, which is the default, is chosen, then the items will
  798. be reported and will be automatically deleted if Do Repair is chosen.
  799.  
  800. The Do Not Save Deleted Items button will cause IniMaint to not save
  801. items that are deleted from an INI file in the Save INI File.
  802. Normally, the user must specify a Save INI File and any entries
  803. removed from any INI file are written to the Save INI File before
  804. they are modified.  This allows the user to restore items that he has
  805. deleted if they discover that something has been deleted in error and
  806. no backup is available.
  807.  
  808. The Log to INIREP.LOG is used for diagnostic purposes.
  809.  
  810. List Items versus Repair Items
  811.  
  812. For a number of the repair categories there are multiple choices
  813. available.  The is always the Repair choice and it works the same for
  814. each category of Repair.  When the Repair choice is used, the only
  815. items that will appear in the window will be items that are invalid
  816. and should be deleted.
  817.  
  818. If the user want to see the valid items for the category or all the
  819. items, then the appropriate List entry can be used to display these
  820. entries.  The List Invalid items is the same as the Repair as far as
  821. the contents of the window is concerned, however, it is safer because
  822. it is not possible to select or otherwise delete any of the items.
  823.  
  824. Repair Pathnames and Filenames
  825.  
  826. Many, if not all, applications installed under OS/2 store things in
  827. various INI files.  However, few, if any, applications will remove
  828. things from these files when they are deinstalled or the directory
  829. structure is changed.  This Repair action looks at the Pathname and
  830. Filename entries in an INI file, compares them to the current Desktop
  831. and either identifies and/or removes entries that are obsolete.
  832.  
  833. The action IniMaint will take depends on the structure of the
  834. individual Key Name or Key Value.  There are two possibilities that
  835. IniMaint looks for:
  836.  
  837. A Filename with no preceding Path information.
  838.  
  839. A full Pathname or Filename combination.
  840.  
  841. Each of the above are handled differently.
  842.  
  843. General Processing applicable to both type of names:
  844.  
  845. Any name that is too short, less than 3 characters, or too long,
  846. longer than the maximum path length returned by DosQSysInfo, will not
  847. be tested further.
  848.  
  849. Any name which contains non-printable characters will not be tested.
  850.  
  851. Processing of Filename with no Path information:
  852.  
  853. If the beginning of a Key Name or Key Value starts with either
  854. X:\ or just \, IniMaint assumes it is a full Pathname
  855. or Filename and processes it as described below.  IniMaint will then
  856. check for a Filename of the form *.XXX and ignore them, since this is
  857. simply a definition of a type of file extension and not an actual
  858. file.  IniMaint will then look for .XXX as the last four characters
  859. of the Filename and will search for the following combinations:
  860.  
  861. .EXE using the PATH Environment variable.
  862.  
  863. .CMD using the PATH Environment variable.
  864.  
  865. .DLL using the LIBPATH Environment variable.
  866.  
  867. .HLP using the HELP Environment variable.
  868.  
  869. Processing of full Pathname or Filename:
  870.  
  871. If the name starts with \, then the drive used as the drive for the
  872. OS2.INI file, which is the boot drive, will be appended to the start
  873. of the name.
  874.  
  875. Any name that starts with A: or B: will be ignored, since they are
  876. assumed to be floppy drives and probably do not contain any media.
  877.  
  878. Any trailing semicolons are removed from the name, since there are a
  879. number of entries that are valid Filenames except for the semicolons.
  880.  
  881. If the trailing character in the name is a \ or if the name contains
  882. any embedded semicolons, it will be tried as a Pathname and made a
  883. candidate for removal if it is not found.
  884.  
  885. All other qualifying names will be tried as both a Filename and a
  886. Pathname and will be made a candidate for removal if they fail both
  887. tests.
  888.  
  889. Remove Old PM_ProgramList Entries
  890.  
  891. There are some entries that can be left in the OS2.INI file from
  892. V1.3 or V2.0, but these entries are no longer needed for V2.1.  This
  893. item will remove these old entries.
  894.  
  895. Delete Unused Printer Entries
  896.  
  897. When Printer Objects are removed from the Desktop, sometimes old
  898. Printer information is left in the OS2SYS.INI file that will cause
  899. problems for various applications that use these entries to determine
  900. which Printers can be used for printing.  A number of Word Processing
  901. programs do this.  Many, if not all, of these programs do not check to
  902. verify that all of the entries in the OS2SYS.INI file actually
  903. represent Printers that are actually installed, therefore, will
  904. sometimes attempt to use a Printer that does not exist.  This entry
  905. will remove all of the references to Printers that are no longer
  906. installed.
  907.  
  908. Destroy Objects
  909.  
  910. Most, if not all, of the items on the Desktop have been assigned an
  911. Object Number.  This number along with the name of the Object is
  912. stored in the OS2.INI file.  This Repair entry will display and give
  913. the user the option to delete and Object.  It is not currently
  914. possible for IniMaint to determine which Objects are valid and which
  915. are invalid, so IniMaint will never identify an Object as invalid.
  916. Great care should be exercised when deleting any of the Objects,
  917. since it is possible to do serious damage to your Desktop.
  918.  
  919. The structure which stores all of the Object cross reference is used
  920. by the WPS Repair code to determine if Objects are valid and to find
  921. the names of valid Objects.
  922.  
  923. Restore Missing Location Entries
  924.  
  925. A conflict can arise between the entries in the
  926. PM_Abstract:Objects entry in the OS2.INI file and the
  927. PM_Workplace:Location entry.  The conflict is that the Objects
  928. entry will reference Locations that are not actually in the Location
  929. entry.  This will not normally represent a problem, but if unusual
  930. things are going on with the Desktop, this entry allows the user to
  931. identify the conflicts and, if they choose, have them fixed.
  932.  
  933. Repair Directory/File Handles
  934.  
  935. Many Drives, Directories and Files are assigned Handles.  This Handle
  936. information is stored in the OS2SYS.INI file.  However, when files are
  937. moved, directories changed or other changes are made to the Desktop,
  938. the Handle information is not updated.  This Repair option gives the
  939. user the ability to see the contents of the INI file Handles entry
  940. and Repair any or all of the invalid entries.
  941.  
  942. It is difficult to remove incorrect information manually, even
  943. knowing the internal structure of the entries, because all of the
  944. Handles information is stored in a single INI file entry and a small
  945. mistake in modifying could cause serious Desktop problems and/or
  946. create a non-bootable situation.
  947.  
  948. The structure which stores all of the Handles information is used
  949. by the WPS Repair code to determine if Handles are valid and to find
  950. the names of Directories and Files.
  951.  
  952. Repair WPS Entries
  953.  
  954. WPS stores a variety of Desktop information in the INI files.  As with
  955. the Handles information above, obsolete information is not always
  956. removed from the INI files when changes are made to the Desktop.  This
  957. Repair option gives the user the ability to see what is in his INI
  958. files and remove those entries that are invalid.
  959.  
  960. As with the Handles above, it is difficult to make these changes
  961. manually because things are stored in a number of different formats
  962. and the cross reference between the random looking numbers and the
  963. actual Objects and Handles would be very tedious to track manually.
  964.  
  965. The Repair WPS Entries uses the Objects and Handles structures.  This
  966. means that these structures must be filled before the WPS structure
  967. can be filled.  This can take a significant amount of time in
  968. situations where the Desktop is complex and/or there are a large
  969. number of invalid entries.
  970.  
  971. Repair Both WPS and Handles Entries
  972.  
  973. This is simply a combination of Repair WPS Entries and Repair
  974. Directory/File Handles above.  It allows the user to do both types of
  975. Repair with a single action.
  976.  
  977. Do All WPS, PM and File Handle Repairs
  978.  
  979. This is a short hand way to do all of the Repairs that Repair
  980. System level things, as opposed to Individual File Repairs.  This
  981. Repair currently includes the Delete Unused Printers, Repair WPS
  982. Entries, and Repair File Handles.  There are a couple of other
  983. Repairs that are actually System level Repairs, such as Destroy
  984. Objects and Restore Missing Location Entries which are not included. 
  985. The reason these Repairs are not included is because it is up to the
  986. user to decide which entries need to be Repaired, so there is no way
  987. to automatically identify which entries to include in the Repair.
  988.  
  989. Do All Individual INI File Repairs
  990.  
  991. This is a short hand way to do all of the Repairs that apply to
  992. the current INI file, as opposed to the Repair of the System Level
  993. entries.  This Repair currently includes the Check for missing Path
  994. and File Names and the Deletion of Zero Length Key Values.
  995.  
  996. ************************************************************************
  997.  
  998. Help about the Operational Environment
  999.  
  1000. There are a number of Operation Environment considerations when running
  1001. IniMaint, SysMaint or MultiMaint and they are discussed in this section.
  1002.  
  1003. There are situations where one or more recovery actions must be
  1004. done when the PM Shell is not active, such as Restoring the Desktop. 
  1005. Normally, it is necessary to boot from a diskette to get into this
  1006. mode, since the PM Shell is loaded during the processing of the
  1007. CONFIG.SYS file.  However, there is an IBM Employee Written program
  1008. that is free and available on Compuserve, ShiftRun that
  1009. will interrupt the processing of the CONFIG.SYS file at the point
  1010. where all of the drivers are loaded, but the PM Shell has not been
  1011. started.  All of the IniMaint, MultiMaint and SysMaint recovery 
  1012. activities that must be done without the PM Shell can be done during
  1013. this interruption.  ShiftRun then allows the rest of the normal boot
  1014. to continue.  This application can greatly ease the recovery problems
  1015. and is mentioned here for that reason.
  1016.  
  1017. The Simple Backup and Restore facilities in SysMaint assume that
  1018. the user has installed an OS/2 version of Zip and
  1019. UnZip and that the installed versions are ones that will
  1020. handle Extended Attributes.  Any version of the programs from V1.93
  1021. and beyond have this capability.  It is further assumed that these
  1022. programs are in a directory that is in the PATH so they
  1023. can be run without specifying the directory in which the EXE files
  1024. are located.  If both of these assumptions are not true, the Backup
  1025. and Restore functions will not work correctly.
  1026.  
  1027. ************************************************************************
  1028.  
  1029. Help for Types of Desktop Backup
  1030.  
  1031. There are two different kinds of Desktop Backups, which will be
  1032. referred to as Simple and Portable.  The purpose
  1033. of this section is to discuss the difference between them.
  1034.  
  1035. The most common type of Desktop Backup is a Simple Backup.
  1036. This is the fastest kind of Backup and is the easiest to use to restore
  1037. a damaged Desktop.  This type of backup make an image, using one technique
  1038. or another, of the existing Desktop and saves the information in one or
  1039. more files that can then be used to Restore the Desktop to the condition
  1040. that existed at the time the Backup was made.
  1041.  
  1042. The advantage of this kind of Backup is that it is fast and simple.
  1043.  
  1044. The disadvantage is that the Backup can only be used to Restore
  1045. the Desktop of the machine it was run on and for the Version of
  1046. OS/2 that produced it.  In other words, it is not possible to use
  1047. the files generated to Restore the Desktop on a different machine,
  1048. unless the machines are exactly the same and it is not
  1049. possible to use to Restore the Desktop after a new Version of
  1050. OS/2 has been installed and the Desktop was destroyed because the
  1051. Harddisk had to be reformatted.
  1052.  
  1053. Most users will never need any other kind of Backup other than a
  1054. Simple one because they do not need to move the Desktop from one
  1055. machine to another and they can install each new Version of OS/2
  1056. over the previous Version and this will preserve the existing
  1057. Desktop.
  1058.  
  1059. The second type of Desktop Backup is a Portable one. 
  1060. This kind of Backup is normally more complex to create and more
  1061. complex to use.  It will normally also take considerably more time to
  1062. create a Portable  Backup.
  1063.  
  1064. The advantage of a Portable Backup is that it can be used,
  1065. normally, to set up a similar Desktop on another machine and can be used to
  1066. restore the Desktop after an installation of a new Version of OS/2 that
  1067. required that the Harddisk be reformatted.
  1068.  
  1069. The disadvantage of this kind of Backup is that it is harder to
  1070. create, harder to use, requires more resources and does not create a
  1071. Backup that is usable for simply Restoring the Desktop on the
  1072. existing machine.  The reason a Portable Backup is not
  1073. able to recreate the Desktop on the existing machine is because there
  1074. is information in the OS2.INI and OS2SYS.INI files that is not saved
  1075. in this process.  Therefore, the INI files that would exist after a
  1076. Restore using this kind of Backup would be incomplete.  The files
  1077. would lack both some of the OS/2 System information, which could
  1078. be redone manually with not too much effort, and they would lack all
  1079. of the information that was added to them by the various Applications
  1080. that were installed.  Most, if not all, of these applications would
  1081. have to be reinstalled or have their INI information saved in some
  1082. other manner.  Since the easiest way to save the INI file information
  1083. is to make a Simple Backup of the Desktop, there is little
  1084. reason to make a Portable one for normal day to day
  1085. operation.
  1086.  
  1087. ************************************************************************
  1088.  
  1089. Help for The Problem with Shadows
  1090.  
  1091. When MultiMaint attempts to Restore an Object that has a Shadow on
  1092. the Desktop or attempts to restore the an Object that is a Shadow,
  1093. there are some additional things that need to be considered.  The way
  1094. that WPS keeps track of the Object being Shadowed, that is the
  1095. original Object, is via the Object Handle of the Original Object. The
  1096. Object Handle of an Object will be different on different machines
  1097. and can be different if the Object is destroyed and recreated on the
  1098. same machine.  The result of this is that the connection between a
  1099. Shadow and the original Object will be broken under many of the
  1100. combinations that are possible during an Object by Object Restore of
  1101. the Desktop.
  1102.  
  1103. When a Shadow Object is Restored, MultiMaint uses information
  1104. other than the Object Handle to locate the Original Object.  If the
  1105. Original Object does not exist, then the Shadow will not be Restored,
  1106. since there is no Object to tie it to.  In order to be sure that all
  1107. of the Original Objects that should exist, do exist, before an
  1108. attempt is made to Restore a Shadow, MultiMaint does the Restore of
  1109. all non-Shadow Objects and then goes back and attempts the Restore of
  1110. all Shadow Objects.  This approach insures that the Shadow will get
  1111. Restored if it is possible on the Target Desktop.  It is still
  1112. possible for the Restore of the Shadow to fail if the Type of Restore
  1113. is to do selected items and the Original Object was not selected.
  1114.  
  1115. When an Object which has a Shadow is Restored to the Desktop, it
  1116. is very possible that the Object Handle for the Original Object will
  1117. be different from that saved in the Instance information for the
  1118. Shadow.  Therefore, MultiMaint keeps track of all of the Shadows for
  1119. all Objects and when the Original Object is Restored, MultiMaint
  1120. checks the Instance information for all Shadows and insures that the
  1121. connection between the Original Object and all of the Shadows is
  1122. correct.
  1123.  
  1124. None of the above requires any action on the part of the user,
  1125. however, it will result in situations where the user asks for an
  1126. Object to be Restored and, because the Object has at least one
  1127. Shadow, the Shadow Objects are Restored automatically because of a
  1128. change that would break the connection between the Original Object
  1129. and the Shadow on the Target Desktop.
  1130.  
  1131. ************************************************************************
  1132.  
  1133. Help for Extended Attribute Name Matching
  1134.  
  1135. Many of the Extended Attribute functions involve taking the
  1136. Extended Attributes from one set of files and/or directories and
  1137. adding them to another set of files and/or directories.  In order
  1138. to do this, SysMaint must have a way of deciding which files and
  1139. directories match each other.  The basic way this is done is by
  1140. removing the base information from each path and doing the compare on
  1141. the remainder of the name.  For example, if the Extended Attributes
  1142. for all of the files and directories in the
  1143. C:\OS2\SOURCE directory were to be copied to the
  1144. D:\TARGET directory, then the file
  1145. C:\OS2\SOURCE\FILE.NME would be determined to match
  1146. D:\TARGET\FILE.NME and the Extended Attributes for the
  1147. FILE.NME file would be copied from one file to the other.  In
  1148. addition, the directory C:\OS2\SOURCE\SUBDIR1 would
  1149. be determined to match D:\TARGET\SUBDIR1 and the
  1150. directory Extended Attributes would be copied from one directory to
  1151. the other.
  1152.  
  1153. ************************************************************************
  1154.  
  1155. Help for What are IniSafe, MltSafe and SysSafe
  1156.  
  1157. IniMaint, MultiMaint and SysMaint are powerful applications with
  1158. the ability to make many changes to the INI files, Extended
  1159. Attributes and other items that are vital to the normal operation of
  1160. the Desktop.  Sometimes it is not desirable to have a program that
  1161. has this much power, even though both applications are structured so
  1162. that the default settings will not allow a user to make any critical
  1163. change without confirming that they want it done.
  1164.  
  1165. Sometimes the user simply does not want to take the chance that he will
  1166. do something that will cause a problem with his Desktop.  In other cases,
  1167. Corporations have many users that they simply do not want to have an
  1168. application that can cause a problem with the Desktop, since it can create
  1169. serious and time consuming support problems.
  1170.  
  1171. IniSafe, MltSafe and SysSafe are designed to address this problem for
  1172. IniMaint, MultiMaint and SysMaint users respectively.  IniSafe, MltSafe
  1173. and SysSafe appear, as far as menus are concerned, exactly the same as
  1174. IniMaint, MultiMaint and SysMaint.  The sole difference
  1175. is that all of the menu selections that could cause a problem with the
  1176. Desktop are deactivated.  Other than that, the programs are the same.  If a
  1177. user is using IniSafe, MltSafe or SysSafe and it is desired to make some
  1178. changes to their Desktop, all that is required is to copy IniMaint,
  1179. MultiMaint or SysMaint into
  1180. the appropriate directory or to run the program from a different directory
  1181. on the LAN.  IniMaint, MultiMaint, SysMaint, IniSafe, MltSafe and SysSafe
  1182. use the same DLL and HLP
  1183. files and the operational entries in the INI files are fully compatible
  1184. across all six applications.
  1185.  
  1186. ************************************************************************
  1187. * INIMAINT REGISTRATION HELP PANEL - This panel is displayed
  1188. * when the user asks about registration
  1189. ************************************************************************
  1190.  
  1191. Registration Information
  1192.  
  1193. IniMaint, MultiMaint and SysMaint are Copyrighted programs owned
  1194. and supported by:
  1195. Larry J. Martin
  1196. Carry Associates
  1197. 990 Ironwood Court
  1198. Marco Island FL 33937-4458
  1199. Tel: 813-642-9126
  1200. Fax: 813-642-1007
  1201. Compuserve: 72662,3616
  1202.  
  1203. Unregistered copies of IniMaint will display an initial dialog that will
  1204. note the unregistered condition.  This dialog will stay on the screen for 15
  1205. seconds, unless dismissed by clicking on the OK button.  The dialog cannot
  1206. be dismissed until it has been visible for 3 seconds.  In addition, the 
  1207. Title Bar will contain a note that this is an unregistered version of
  1208. IniMaint.  SysMaint, which includes the processing of the Extended Attributes
  1209. and MultiMaint which adds an Object by Object Desktop Backup and
  1210. Restore capability onto SysMaint, require a registered copy of IniMaint plus
  1211. a registration ID for SysMaint or MultiMaint.
  1212. which is separate from the Registration ID for IniMaint.  However, if a
  1213. registered copy of SysMaint is purchased, then it will include IniMaint.
  1214. A registered copy of MultiMaint will include both SysMaint and
  1215. IniMaint.
  1216.  
  1217. IniMaint is the only one of the three products which is a
  1218. Shareware product and can, therefore, be tried without registering
  1219. the program. Even if the version of the code that is downloaded from
  1220. and electronic source contains the code necessary to run SysMaint
  1221. and/or MultiMaint, it is not possible to get the menu entries for
  1222. these applications to appear in the Main Menu Window without the
  1223. Registration ID for the appropriate product.
  1224.  
  1225. To obtain your registration identifier for IniMaint please send a check
  1226. for 29.95 per license for single licenses or 299.00 for an unlimited copies
  1227. license made payable to Carry Associates to the address above.  We
  1228. will also invoice against a Company Purchase Order and will accept
  1229. payment via Visa or Mastercard.
  1230.  
  1231. To obtain your registration identifier for SysMaint please send a check
  1232. for 49.95 per license for single licenses or 499.00 for an unlimited copies
  1233. license made payable to Carry Associates to the address above.  We
  1234. will also invoice against a Company Purchase Order and will accept
  1235. payment via Visa or Mastercard.
  1236.  
  1237. To obtain your registration identifier for MultiMaint please send a check
  1238. for 69.95 per license for single licenses or 699.00 for an unlimited copies
  1239. license made payable to Carry Associates to the address above.  We
  1240. will also invoice against a Company Purchase Order and will accept
  1241. payment via Visa or Mastercard.
  1242.  
  1243. If you are already a registered user of IniMaint and have purchased it
  1244. prior to the release of SysMaint, then you can upgrade from IniMaint to
  1245. SysMaint for a fee of 15.00 for a single license or 150.00 for an unlimited
  1246. license.
  1247.  
  1248. If you are a registered user of IniMaint and purchased it after SysMaint
  1249. was released, then the upgrade fee is 25.00 for a single license and
  1250. 250.00 for an unlimited license.
  1251.  
  1252. If you are already a registered user of IniMaint and have purchased it
  1253. prior to the release of MultiMaint, then you can upgrade from IniMaint to
  1254. MultiMaint for a fee of 30.00 for a single license or 300.00 for an unlimited
  1255. license.
  1256.  
  1257. If you are a registered user of IniMaint and purchased it after MultiMaint
  1258. was released, then the upgrade fee is 45.00 for a single license and
  1259. 450.00 for an unlimited license.
  1260.  
  1261. If you are already a registered user of SysMaint and have purchased it
  1262. prior to the release of MultiMaint, then you can upgrade from SysMaint to
  1263. MultiMaint for a fee of 15.00 for a single license or 150.00 for an unlimited
  1264. license.
  1265.  
  1266. If you are a registered user of SysMaint and purchased it after MultiMaint
  1267. was released, then the upgrade fee is 25.00 for a single license and
  1268. 250.00 for an unlimited license.
  1269.  
  1270. If you want to register either IniMaint or SysMaint and would
  1271. prefer to use a credit card, you can register with either a Visa or
  1272. Mastercard.
  1273.  
  1274. Once you have your registration identifier, you can register your copy
  1275. of IniMaint, MultiMaint or SysMaint by selecting the appropriate
  1276. Register entry on the
  1277. Actions Menu.  Once you are registered, this entry will no longer
  1278. appear on the menu.
  1279.  
  1280. If you want a preregistered copy of IniMaint, MultiMaint or SysMaint, 
  1281. add $7.00 for postage and
  1282. handling.  We will return a diskette with a preregistered copy of IniMaint, 
  1283. MultiMaint or SysMaint,
  1284. an Install CMD file and a registration ID.  The purpose of the ID
  1285. is to allow preregistered users to download new versions, register and
  1286. use them until they can obtain a preregistered update.
  1287.  
  1288. The cost of a preregistered update is 10.00 per license for single
  1289. licenses or 100.00 for an unlimited copies license, plus 7.00 handling
  1290. and postage.
  1291.  
  1292. ************************************************************************
  1293. ************************************************************************
  1294. ***********************   MAIN WINDOW   ********************************
  1295. ************************************************************************
  1296. ************************************************************************
  1297. ************************************************************************
  1298.  
  1299. Help for Main Window
  1300.  
  1301. The MAIN WINDOW is the base of the IniMaint, MultiMaint
  1302. and SysMaint system.  When the program is started, this window
  1303. appears listing the options available.
  1304.  
  1305. ************************************************************************
  1306.  
  1307. Help for Menu Items
  1308.  
  1309. The IniMaint, SysMaint or MultiMaint Menu Items are:
  1310.  
  1311.    File
  1312.    Options
  1313.    Groups
  1314.    Actions
  1315.    Recover
  1316.    Size
  1317.    Find
  1318.    Extended Attributes
  1319.    Desktop
  1320.  
  1321. ************************************************************************
  1322.  
  1323. Help for Popup Menus
  1324.  
  1325. Pressing the Right Mouse Button when the Mouse Pointer is in the
  1326. Application, Key Name or Key Value windows will popup a Menu that
  1327. contains action items that can be done on the entries in that
  1328. specific window.
  1329.  
  1330. Most of the items on the menus are the same as the items on the
  1331. normal menus and are described in the Help for that specific Menu.
  1332. The Help for the duplicated items is not included here.  However,
  1333. there are three entries on the Popup Menus that are unique to these
  1334. menus and the Help for these items is included here.
  1335.  
  1336. The IniMaint, SysMaint or MultiMaint Special Popup Menu Items are:
  1337.  
  1338.    Write
  1339.    Print
  1340.    Explain
  1341.  
  1342. ************************************************************************
  1343.  
  1344. Help for Dialogs
  1345.  
  1346. The Dialogs for IniMaint, SysMaint or MultiMaint are listed below:
  1347.  
  1348.    Add or Replace Key Value Dialog
  1349.    Dump Dialog
  1350.    Options Dialog
  1351.    Select Group Dialog
  1352.    Get Value or String Dialog
  1353.    Groups Dialog
  1354.    Find Dialog
  1355.    Compare Files Dialog
  1356.    Compare Files Write Options Dialog
  1357.    Repair File Dialog
  1358.    EA Test Dialog
  1359.    EA Defaults Dialog
  1360.    Explain Dialog
  1361.    Desktop Defaults Dialog
  1362.    Portable Backup Defaults Dialog
  1363.    Portable Restore Dialog
  1364.    Select Supplemental Backup Files
  1365.    Display and Modify Object Settings
  1366.  
  1367. ************************************************************************
  1368.  
  1369. Help for Accelerator Keys
  1370.  
  1371. The Accelerator Keys for IniMaint, SysMaint or MultiMaint are listed below.
  1372.  
  1373.    F1
  1374.    Help
  1375.    F3
  1376.    Exit
  1377.    F4
  1378.    Refresh File
  1379.    F5
  1380.    Dump Variables
  1381.    F6
  1382.    Associate with *.INI
  1383.    F7
  1384.    Switch to User INI File
  1385.    F8
  1386.    Switch to System INI File
  1387.    F9
  1388.    New File
  1389.    Ctrl-F1
  1390.    Find Application Name
  1391.    Ctrl-F2
  1392.    Find Current Key Name
  1393.    Ctrl-F3
  1394.    Find Current Key Value
  1395.    Ctrl-F4
  1396.    Find Application Value
  1397.    Ctrl-F5
  1398.    Find Any Name
  1399.    Ctrl-F6
  1400.    Find Any Value
  1401.    Ctrl-F7
  1402.    Repeat Last Find
  1403.    Ctrl-F11
  1404.    Compare Files on Application Level
  1405.    Ctrl-F8
  1406.    Compare Files on Key Name Level
  1407.    Ctrl-F9
  1408.    Compare Files on Key Value Level
  1409.    Alt-F1
  1410.    Copy System INI File
  1411.    Alt-F2
  1412.    Copy User INI File
  1413.    Alt-F3
  1414.    Copy Both System and User INI Files
  1415.    Ctrl-E
  1416.    Size Entire File
  1417.    Ctrl-S
  1418.    Size Selected Application
  1419.    Ctrl Alt-M
  1420.    Size System INI File
  1421.    Ctrl Alt-N
  1422.    Size User INI File
  1423.    Ctrl-G
  1424.    Write Updated Key Value to INI File
  1425.    Ctrl-D
  1426.    Delete Selected Application
  1427.    Ctrl-L
  1428.    Delete Selected Key
  1429.    Ctrl-M
  1430.    Add Application
  1431.    Ctrl-I
  1432.    Add Key
  1433.    Ctrl-R
  1434.    Add or Replace Key Value
  1435.    Ctrl-C
  1436.    Rename Selected Application
  1437.    Ctrl-W
  1438.    Rename Selected Key
  1439.    Ctrl-Z
  1440.    Duplicate Selected Application
  1441.    Ctrl-X
  1442.    Duplicate Selected Key
  1443.    Ctrl-A
  1444.    Copy Selected Application
  1445.    Ctrl-K
  1446.    Copy Selected Key
  1447.    Ctrl-V
  1448.    Move Entire File
  1449.    Ctrl-P
  1450.    Move Selected Application
  1451.    Ctrl-Y
  1452.    Move Selected Key
  1453.    Ctrl-T
  1454.    Register Your Copy
  1455.    Ctrl Alt-S
  1456.    Backup System INI File
  1457.    Ctrl Alt-U
  1458.    Backup User INI File
  1459.    Ctrl Alt-B
  1460.    Backup Both System and User INI Files
  1461.    Ctrl-U
  1462.    Change User INI File
  1463.    Ctrl-H
  1464.    Change System INI File
  1465.    Ctrl-B
  1466.    Change Both INI Files
  1467.    Ctrl-F10
  1468.    Repair File
  1469.    Ctrl Alt-F4
  1470.    Reset Non Write INI Files
  1471.    Ctrl Alt-F5
  1472.    Test for Non Write INI Files
  1473.    Ctrl Alt-F1
  1474.    EA Default Dialog
  1475.    Ctrl Alt-F2
  1476.    EA Describe Current File
  1477.    Ctrl Alt-F3
  1478.    EA Update File(s) from Current File
  1479.    Ctrl Alt-D
  1480.    Desktop Defaults Dialog
  1481.    Ctrl Alt-K
  1482.    Backup Desktop
  1483.    Ctrl Alt-W
  1484.    Do Supplemental Backup
  1485.    Ctrl Alt-V
  1486.    Select Supplemental Backup Files
  1487.    Ctrl Alt-C
  1488.    Create Desktop Backup CMD File
  1489.    Ctrl Alt-X
  1490.    Create Supplemental Backup CMD File
  1491.    Ctrl Alt-O
  1492.    Create Desktop Restore CMD File
  1493.    Ctrl Alt-Y
  1494.    Create Supplemental Restore CMD File
  1495.    Ctrl Alt-R
  1496.    Reset WPS
  1497.    Ctrl Alt-A
  1498.    Restore Desktop Directory
  1499.    Ctrl Alt-I
  1500.    Restore Desktop ID
  1501.    Ctrl Alt-F
  1502.    Restore Desktop INI Files
  1503.    Ctrl Alt-Z
  1504.    Do Supplemental Restore
  1505.    Ctrl Alt-P
  1506.    Portable Backup Defaults
  1507.    Ctrl Alt-G
  1508.    Create Portable Backup
  1509.    Ctrl Alt-H
  1510.    Do Portable Restore
  1511.    Ctrl Alt-J
  1512.    Desktop Object Settings
  1513.    Ctrl Alt-F6
  1514.    Explain Current Selection
  1515.    Ctrl Alt-F7
  1516.    Write Window to File
  1517.    Ctrl Alt-F8
  1518.    Print Window
  1519.  
  1520. ************************************************************************
  1521.  
  1522. Help for Additional Programs
  1523.  
  1524. The Additional Programs for IniMaint, SysMaint or MultiMaint are:
  1525.  
  1526.    IniCopy
  1527.    IniClean
  1528.  
  1529. ************************************************************************
  1530.  
  1531. Help for IniCopy Program
  1532.  
  1533. The IniCopy Program is the program that is used by IniMaint to do the actual
  1534. COPY/MOVE operations.  This option is implemented as a separate program
  1535. so that the user will have the ability to make copies of INI files,
  1536. including the User and System INI files, at any time during the day.
  1537.  
  1538. The parameters expected by IniCopy are:
  1539.  
  1540. Required Parameters:
  1541.  
  1542. -Ifilename  - The fully qualified path and filename of the Source,
  1543. Input, INI file.
  1544.  
  1545. -Ofilename  - The fully qualified path and filename of the Target,
  1546. Output, INI file.  The Target will be created if it does not exist.
  1547.  
  1548. Optional Parameters:
  1549.  
  1550. -Fx         - Function requested - Default is C(opy) C = C(opy) M = M(ove)
  1551.  
  1552. -E          - COPY/MOVE Entire INI file - Default
  1553.  
  1554. -A          - COPY/MOVE All Groups
  1555.  
  1556. -Ggroup     - COPY/MOVE Specific Group
  1557.  
  1558. -Sapp       - COPY/MOVE Specific Application
  1559.  
  1560. -T          - Use Fast Copy.  This is only valid if -E is also specified
  1561.  
  1562. ************************************************************************
  1563.  
  1564. Help for IniClean Program
  1565.  
  1566. The IniClean Program is designed to remove the Desktop
  1567. Directory Structure by deleting the Desktop Directory, all
  1568. Subdirectories, and all Files in all Directories.
  1569.  
  1570. IniClean is not normally designed to be run as a stand alone
  1571. program.  However, it can be run to remove any Directory with it's
  1572. Subdirectories and all files in all Directories by passing the
  1573. starting Directory as the only parameter.
  1574.  
  1575. For example, to delete the OS/2 Directory from drive C, all
  1576. Subdirectories of the OS/2 Directory and all Files in the
  1577. OS/2 Directory and all Subdirectories run IniClean as shown:
  1578. IniClean -iC:\OS2
  1579.  
  1580. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  1581.  
  1582. DO NOT RUN this program unless you are sure you know what you want
  1583. to delete.  Once the program is started, it will delete all
  1584. Directories and Files without requiring or asking for any additional
  1585. input.
  1586.  
  1587. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  1588.  
  1589. ************************************************************************
  1590.  
  1591. Help for Application Listbox
  1592.  
  1593. The APPLICATION LISTBOX displays the list of applications 
  1594. that are in the current INI file, whose name is on the Title Bar.
  1595.  
  1596. ************************************************************************
  1597.  
  1598. Help for Key Listbox
  1599.  
  1600. The KEY LISTBOX displays the list of key names for the 
  1601. application that is currently selected in the Application Listbox.
  1602.  
  1603. ************************************************************************
  1604.  
  1605. Help for Key Data Window
  1606.  
  1607. The MLE WINDOW displays the value of key for the 
  1608. key that is currently selected in the Key Listbox.
  1609.  
  1610. ************************************************************************
  1611. ************************************************************************
  1612. ************************************************************************
  1613. *********************  ABOUT BOX  **************************************
  1614. ************************************************************************
  1615. ************************************************************************
  1616. ************************************************************************
  1617.  
  1618. Help for About
  1619.  
  1620. Select About on the Help pull down
  1621. to display copyright information about IniMaint, SysMaint or
  1622. MultiMaint.
  1623.  
  1624. ************************************************************************
  1625. ************************************************************************
  1626. ************************************************************************
  1627. *****************************  DUMP  ***********************************
  1628. ************************************************************************
  1629. ************************************************************************
  1630. ************************************************************************
  1631.  
  1632. Help for Dump Variables
  1633.  
  1634. Select Dump Variables to display a Dump Variables
  1635. debugging dialog.  This selection will allow the user to "dump" the program
  1636. variables to a file.
  1637.  
  1638. ************************************************************************
  1639. ************************************************************************
  1640. ************************************************************************
  1641. ************************  OPTIONS  *************************************
  1642. ************************************************************************
  1643. ************************************************************************
  1644. ************************************************************************
  1645.  
  1646. Help for Options Selection
  1647.  
  1648. Select Options to display an Options
  1649. dialog.  This selection will allow the user to change the various options that
  1650. control whether the initial dialog will be displayed and whether the user
  1651. is to be asked before the current INI file is updated.
  1652.  
  1653. ************************************************************************
  1654. ************************************************************************
  1655. ************************************************************************
  1656. ***************************  GROUPS  ***********************************
  1657. ************************************************************************
  1658. ************************************************************************
  1659. ************************************************************************
  1660.  
  1661. Help for Groups
  1662.  
  1663. Select Groups to display a Groups
  1664. dialog.  This selection will allow the user to define, change and delete
  1665. Application Groups
  1666.  
  1667. ************************************************************************
  1668. ************************************************************************
  1669. ************************************************************************
  1670. ***********************  FILE MENU  ************************************
  1671. ************************************************************************
  1672. ************************************************************************
  1673. ************************************************************************
  1674.  
  1675. Help for File Menu
  1676.  
  1677. Select File to display a File  menu.  This
  1678. selection will allow the user to do a number of different file
  1679. actions and Exit from IniMaint, SysMaint or MultiMaint.  The File Menu
  1680. Items are:
  1681.  
  1682. ************************************************************************
  1683. ************************************************************************
  1684. ************************************************************************
  1685. *******************  ACTIONS MENU  *************************************
  1686. ************************************************************************
  1687. ************************************************************************
  1688. ************************************************************************
  1689.  
  1690. Help for Actions Menu
  1691.  
  1692. Select Actions to display an Actions
  1693. menu.  This selection will allow the user to make various changes to the
  1694. current INI file.  The Actions Menu Items are:
  1695.  
  1696.    Update Current Key Value
  1697.    Delete Application
  1698.    Delete Key
  1699.    Add Application
  1700.    Add Key to Application
  1701.    Add or Replace Key Value
  1702.    Rename Key
  1703.    Duplicate Key
  1704.    Rename Application
  1705.    Duplicate Application
  1706.    Copy Application(s)
  1707.    Move Application(s)
  1708.    Backup INI File(s)
  1709.    Register Your Copy
  1710.  
  1711. ************************************************************************
  1712. ************************************************************************
  1713. ************************************************************************
  1714. *********************  RECOVER MENU  ***********************************
  1715. ************************************************************************
  1716. ************************************************************************
  1717. ************************************************************************
  1718.  
  1719. Help for Recover Menu
  1720.  
  1721. Select Recover to display a Recover
  1722. menu.  This selection will allow the user to do various things to recover
  1723. from problems with various INI files.  The Recover Menu Items are:
  1724.  
  1725.    Change User INI File
  1726.    Change System INI File
  1727.    Change Both INI Files
  1728.    Repair INI File
  1729.    Condense INI Files
  1730.    Reset Non Write INI Files
  1731.    Test for Non Write INI Files
  1732.  
  1733. ************************************************************************
  1734. ************************************************************************
  1735. ************************************************************************
  1736. ***********************  EA MENU  **************************************
  1737. ************************************************************************
  1738. ************************************************************************
  1739. ************************************************************************
  1740.  
  1741. Help for EA Menu
  1742.  
  1743. Select Ext. Att. to display the EA
  1744. menu.  This selection will allow the user to do various things with the
  1745. Extended Attributes for Directories and/or Files.  The EA Menu Items are:
  1746.  
  1747.    EA Defaults Dialog
  1748.    Describe EA File Contents
  1749.    Update EAs from the Current File
  1750.    View EAs
  1751.    Test EAs
  1752.    Save EAs
  1753.    Copy EAs
  1754.    Move EAs
  1755.    Split EAs
  1756.    Delete EAs
  1757.    Join EAs
  1758.    Compare EAs
  1759.    Compare to Saved EAs
  1760.  
  1761. ************************************************************************
  1762. ************************************************************************
  1763. ************************************************************************
  1764. ********************  DESKTOP MENU  ************************************
  1765. ************************************************************************
  1766. ************************************************************************
  1767. ************************************************************************
  1768.  
  1769. Help for Desktop Menu
  1770.  
  1771. Select Desktop. to display the Desktop
  1772. menu.  This selection will allow the user to do various things with the
  1773. OS/2 Desktop.  The Desktop Menu Items are:
  1774.  
  1775.    Defaults Dialog
  1776.    Select Supplemental Backup Files
  1777.    Reset Desktop
  1778.    Backup Desktop
  1779.    Do Supplemental Backup
  1780.    Create Backup CMD File
  1781.    Create Supplemental Backup CMD File
  1782.    Create Restore CMD File
  1783.    Create Supplemental Restore CMD File
  1784.    Restore Desktop ID
  1785.    Restore Desktop Directory
  1786.    Restore Desktop INI Files
  1787.    Do Supplemental Restore
  1788.    Portable Backup Defaults Dialog
  1789.    Create Portable Backup
  1790.    Do Portable Restore
  1791.    Desktop Object Settings
  1792.    Display Backup Descriptions
  1793.  
  1794. ************************************************************************
  1795. ************************************************************************
  1796. ************************************************************************
  1797. ************************  SIZE  ****************************************
  1798. ************************************************************************
  1799. ************************************************************************
  1800. ************************************************************************
  1801.  
  1802. Help for Size
  1803.  
  1804. Select Size to display the number of bytes of disk storage
  1805. that would be required to hold all or part of the current INI file, the
  1806. System INI file or the User INI File.
  1807.  
  1808. The user will be presented with a Size submenu that will allow
  1809. the selection of what to Size.
  1810.  
  1811. The selection Dialog will always contain four entries, one for the entire
  1812. file, one for the currently selected Application, one for the System 
  1813. INI file and one for the User INI File.  If there are any
  1814. Groups defined for the current INI file, then the Groups will also be 
  1815. listed.  If there are more than on Group defined for the current INI file,
  1816. then an All Groups selection will be displayed.  Once the selection is made,
  1817. the Size calculation will commence.  There will be a Calculating
  1818. Box displayed until the calculation completes.
  1819.  
  1820. ************************************************************************
  1821. ************************************************************************
  1822. ************************************************************************
  1823. **********************FIND MENU*****************************************
  1824. ************************************************************************
  1825. ************************************************************************
  1826. ************************************************************************
  1827.  
  1828. Help for Find Menu
  1829.  
  1830. Select Find to display a Find
  1831. menu.  This selection will allow the user to do a number of different find
  1832. actions.  The Find Menu Items are:
  1833.  
  1834.    Find Application Name
  1835.    Find Current Key Name
  1836.    Find Current Key Value
  1837.    Find Application Key Value
  1838.    Find Any Key Name
  1839.    Find Any Key Value
  1840.    Repeat Last Find
  1841.  
  1842. ************************************************************************
  1843. ************************************************************************
  1844. ************************************************************************
  1845. ******************  POPUP MENU  ****************************************
  1846. ************************************************************************
  1847. ************************************************************************
  1848. ************************************************************************
  1849.  
  1850. Help for Write Window Contents
  1851.  
  1852. Select Write to Write the contents of the Window under
  1853. the Mouse Pointer to a File.  The user will be asked to select the
  1854. Target File via the Standard File Dialog.  Once the File is selected,
  1855. the Window contents will be written to the file or, if the file
  1856. already exists, appended to the current contents of the file.
  1857.  
  1858. There will be a Header line with the Date and Time.  If the window
  1859. being written is the Key Name or Key Value window, then the currently
  1860. selected Application will be included in the Header.  If the window
  1861. being written is the Key Value window, then the currently selected
  1862. Key Name will also be included in the Heading information.
  1863.  
  1864. ************************************************************************
  1865.  
  1866. Help for Print Window Contents
  1867.  
  1868. Select Print to Print the contents of the Window under
  1869. the Mouse Pointer.
  1870.  
  1871. There will be a Header line with the Date and Time.  If the window
  1872. being printed is the Key Name or Key Value window, then the currently
  1873. selected Application will be included in the Header.  If the window
  1874. being printed is the Key Value window, then the currently selected
  1875. Key Name will also be included in the Heading information.
  1876.  
  1877. ************************************************************************
  1878.  
  1879. Help for Explain
  1880.  
  1881. Select Explain to popup a Dialog with an Explanation of
  1882. the meaning and use of the currently selected Application and Key for
  1883. those Applications that are recognized as standard OS/2 Applications.
  1884.  
  1885. If the currently selected Application is not known, then the Dialog
  1886. will simply state that fact.
  1887.  
  1888. If the Mouse Pointer is over the Application Window when the
  1889. Explain is requested, then the Dialog will only contain a general
  1890. explanation of the use of the Application.  If the Mouse Pointer is
  1891. over the Key Name or Key Value windows, then an attempt will be made
  1892. to give additional explanation information on the currently selected
  1893. Key.  The amount of information available depends on a number of
  1894. things, not the least of which is Carry Associates current level of
  1895. knowledge about the various entries.  Therefore, there is no general
  1896. way to characterize what the more detailed Explanation.  It will vary
  1897. from nothing to a detailed list of items.
  1898.  
  1899. Carry Associates expects that this will be a continually evolving
  1900. area and we will make every attempt to include everything we learn
  1901. about the INI files in the Explain text.  We would be very happy to
  1902. hear from any user who has additional information that could help.
  1903.  
  1904. We can be reached via any of the following:
  1905. Larry J. Martin
  1906. Carry Associates
  1907. 990 Ironwood Court
  1908. Marco Island FL 33937-4458
  1909. Tel: 813-642-9126
  1910. Fax: 813-642-1007
  1911. Compuserve: 72662,3616
  1912.  
  1913. ************************************************************************
  1914. ************************************************************************
  1915. ***************MAIN WINDOW FILE*****************************************
  1916. ************************************************************************
  1917. ************************************************************************
  1918. ************************************************************************
  1919.  
  1920. Help for Exit
  1921.  
  1922. Select Exit on the File pull down
  1923. or press F3 to leave IniMaint, SysMaint or MultiMaint.
  1924.  
  1925.  
  1926.  
  1927. Selecting Exit will shutdown all open "threads"
  1928. before actually exiting the program so there may be a slight delay.
  1929.  
  1930. ************************************************************************
  1931.  
  1932. Help for New File Selection
  1933.  
  1934. Select New File to display a Files
  1935. dialog.  This selection will allow the user change the current INI file.
  1936.  
  1937. ************************************************************************
  1938.  
  1939. Help for User INI File Selection
  1940.  
  1941. Select User INI File to make the User INI File the current
  1942. file being displayed by IniMaint.  The User INI File is normally
  1943. OS2.INI.
  1944.  
  1945. ************************************************************************
  1946.  
  1947. Help for System INI File Selection
  1948.  
  1949. Select System INI File to make the System INI File the current
  1950. file being displayed by IniMaint.  The System INI File is normally 
  1951. OS2SYS.INI.
  1952.  
  1953. ************************************************************************
  1954.  
  1955. Help for File Refresh
  1956.  
  1957. Select Refresh File to cause IniMaint to reload the contents
  1958. of the current INI file from disk.  This entry would be used if some event
  1959. has occurred that may have modified the current INI file and it is desired
  1960. that these changes be reflected in the IniMaint listboxes and value area.
  1961.  
  1962. ************************************************************************
  1963.  
  1964. Help for Compare Files
  1965.  
  1966. Select Compare Files to compare two different INI files on
  1967. any one of three different levels.  The Source File will be the
  1968. Current INI file.  The user will be prompted for the
  1969. Target File.
  1970.  
  1971. If the Application Level Compare is selected the Listbox in
  1972. the Compare Dialog will list all Application Names that are in
  1973. one INI file, but not in the other.
  1974.  
  1975. If the Key Name Level Compare is selected the Listbox in
  1976. the Compare Dialog will list everything that the Application Name Level
  1977. lists plus all Application/Key Names that are in
  1978. one INI file, but not in the other.
  1979.  
  1980. If the Key Value Level Compare is selected the Listbox in
  1981. the Compare Dialog will list everything in the other two Levels
  1982. lists plus all Application/Key Names that are in
  1983. both INI files, but have Unequal Key Values.
  1984.  
  1985. ************************************************************************
  1986.  
  1987. Help for Recall Files
  1988.  
  1989. Select Recall Files will display a submenu with a list of
  1990. previous INI and/or EA files that have been the current file.  If any of
  1991. these files are selected, that file will become the current file and all
  1992. of the windows will be updated.  The maximum number of files displayed in the
  1993. Recall Submenu is a user option that is set in the Options Dialog.
  1994.  
  1995. ************************************************************************
  1996. ************************************************************************
  1997. ***************MAIN WINDOW ACTIONS**************************************
  1998. ************************************************************************
  1999. ************************************************************************
  2000.  
  2001. Help for Update Selection
  2002.  
  2003. Select Update Current Key to write any changes made to the
  2004. selected key value to the current INI file.  Until this option is selected
  2005. or a new Key or Application is selected and the user chooses to allow an
  2006. update, the changes made to the Key Value in the bottom window will not be
  2007. reflected in the current INI file.
  2008.  
  2009. ************************************************************************
  2010.  
  2011. Help for Delete Application
  2012.  
  2013. Select Delete Application to Delete the Currently Selected
  2014. Application.  Unless the Option has been turned off, the user will be asked
  2015. to confirm that the Application should be deleted.
  2016.  
  2017. ************************************************************************
  2018.  
  2019. Help for Delete Key
  2020.  
  2021. Select Delete Key to Delete the Currently Selected
  2022. Key.  Unless the Option has been turned off, the user will be asked
  2023. to confirm that the Key should be deleted.
  2024.  
  2025. ************************************************************************
  2026.  
  2027. Help for Add Application
  2028.  
  2029. Select Add Application to Add a New Application to the current
  2030. INI File.  This Selection will ask the user for the name of the New
  2031. Application.  Once the name is verified, this Selection will fall through
  2032. to the Add Key Selection.
  2033.  
  2034. ************************************************************************
  2035.  
  2036. Help for Add Key
  2037.  
  2038. Select Add Key to Add a New Key to the current Application
  2039. This Selection will ask the user for the name of the New Key.  Once the name
  2040. is verified, this Selection will fall through to the Replace Key Selection.
  2041.  
  2042. ************************************************************************
  2043.  
  2044. Help for Add or Replace Key Value
  2045.  
  2046. Select Add or Replace Key Value to display a Dialog that
  2047. will allow the user to modify the Value of the current Key.  This is
  2048. the only Selection that will allow the user to change the length of a
  2049. Key Value.  The bottom Window of the Main Window can be used to
  2050. modify the Value of a Key, but it cannot be used to change the length
  2051. of a Value.
  2052.  
  2053. ************************************************************************
  2054.  
  2055. Help for Rename Key
  2056.  
  2057. Select Rename Key to Rename the Currently Selected
  2058. Key.  The old Key Name will no longer exist in the Current INI file.  If you
  2059. want to retain the old Key Name use Duplicate Key.
  2060.  
  2061. ************************************************************************
  2062.  
  2063. Help for Duplicate Application
  2064.  
  2065. Select Duplicate Application to Duplicate the Currently
  2066. Selected Application using a different Application Name.  The user
  2067. will first be prompted to enter a New Application Name, then all Key
  2068. Names and Key Values will be duplicated under the new Application.
  2069.  
  2070. No check is made to insure that the New Application Name is not a
  2071. duplicate of an existing Application.  If the New Application is a
  2072. duplicate then the effect of executing this item will be to copy
  2073. every Key Name from the Selected Application to the New Application. 
  2074. If the Key Name already exists in the New Application, the Value will
  2075. be replaced by the Value from the Selected Application.  If the Key
  2076. Name does not exist in the New Application, then it will be inserted
  2077. into the New Application.
  2078.  
  2079. The old Application will still exist in the Current INI file.  If
  2080. you do not want to retain the old Application then the Delete
  2081. Application  item on the Action Menu can be used to
  2082. delete the old Application.
  2083.  
  2084. ************************************************************************
  2085.  
  2086. Help for Rename Application
  2087.  
  2088. Select Rename Application to Rename the Currently Selected
  2089. Application using a different Application Name.
  2090. The user will first be prompted to enter a New Application Name, then all
  2091. Key Names and Key Values will be copied to new Application.
  2092.  
  2093. No check is made to insure that the New Application Name is not a
  2094. duplicate of an existing Application.  If the New Application is a duplicate
  2095. then the effect of executing this item will be to copy every Key Name from
  2096. the Selected Application to the New Application.  If the Key Name already
  2097. exists in the New Application, the Value will be replaced by the Value from
  2098. the Selected Application.  If the Key Name does not exist in the New
  2099. Application, then it will be inserted into the New Application.
  2100.  
  2101. The old Application will no longer exist in the Current INI file.  If you
  2102. want to retain the old Application use Duplicate Application.
  2103.  
  2104. ************************************************************************
  2105.  
  2106. Help for Duplicate Key
  2107.  
  2108. Select Duplicate Key to Duplicate the Currently Selected
  2109. Key Value using a different Key Name and, optionally, a different Application
  2110. Name.  The user will first be prompted to enter a New Application Name and
  2111. can either change the Application or leave it the same.  If the Application
  2112. Name is changed, then the Key Name does not need to be changed and the Key
  2113. Value will be copied to the new Application using the current Key Name.  If
  2114. the Application Name is not changed, then Key Name must be changed.
  2115. The old Key Name will still exist in the Current INI file.  If you
  2116. do not want to retain the old Key Name use Rename Key.
  2117.  
  2118. ************************************************************************
  2119.  
  2120. Help for Copy
  2121.  
  2122. Select Copy to Copy one or more Applications from the current
  2123. INI file to a Target INI File, to make a copy of the System INI File, the
  2124. User INI File or Both the System and User INI Files.
  2125.  
  2126. The user will first be asked to select a Target for the Copy and will
  2127. be presented with a Copy submenu that will allow the selection
  2128. of what to Copy.
  2129.  
  2130. The submenu will always contain five entries, one for the entire
  2131. file, one for the currently selected Application and one each for
  2132. the System, User and Both INI Files.  If there are any
  2133. Groups defined for the current INI file, then the Groups will also be 
  2134. listed.  If there are more than on Group defined for the current INI file,
  2135. then an All Groups selection will be displayed.  Once the selection is made,
  2136. the Copy will commence.  There will be a Copy in Progress Box
  2137. displayed until the Copy completes.
  2138.  
  2139. ************************************************************************
  2140.  
  2141. Help for Backup
  2142.  
  2143. Select Backup to make a backup copy of either the System INI
  2144. File, the User INI file or both the System and User INI Files.  In order to
  2145. backup these files a target file must be chosen for each source file.  If
  2146. no target has been specified or if the Option to Ask Before Backup is set,
  2147. the user will be asked to specify a target file for the backup.  Once a
  2148. target is specified for the System and/or User INI Files, then the user
  2149. will not be asked to verify the target filename if the Ask Before Backup
  2150. Option is not set.
  2151.  
  2152. If the target backup file already exists, it will be erased before the
  2153. backup is done.  This is necessary to insure that the backup does not contain
  2154. old information.
  2155.  
  2156. If the option to display a copy in progress is set there will be a 
  2157. Copy in Progress Box displayed until the Copy completes.
  2158.  
  2159. ************************************************************************
  2160.  
  2161. Help for Move
  2162.  
  2163. Select Move to Move one or more Applications from the current
  2164. INI file to a Target INI File.  
  2165.  
  2166. The user will first be asked to select a Target for the Move and will
  2167. be presented with a Move submenu that will allow the selection
  2168. of what to Move.
  2169.  
  2170. The submenu will always contain two entries, one for the entire
  2171. file and another for the currently selected Application.  If there are any
  2172. Groups defined for the current INI file, then the Groups will also be 
  2173. listed.  If there are more than on Group defined for the current INI file,
  2174. then an All Groups selection will be displayed.  Once the selection is made,
  2175. the Move will commence.  There will be a Move in Progress Box
  2176. displayed until the Move completes.  Once the Move is complete, the Moved
  2177. Applications will be deleted from the Current INI file.
  2178.  
  2179. ************************************************************************
  2180. ************************************************************************
  2181. ***************MAIN WINDOW RECOVER**************************************
  2182. ************************************************************************
  2183. ************************************************************************
  2184. ************************************************************************
  2185.  
  2186. Help for Change User INI File
  2187.  
  2188. Select Change User INI File to change to a new User INI File.
  2189. The normal User INI file is OS2.INI.  Normally this
  2190. would only be done because the user was having trouble deleting an entry
  2191. from the User INI file, therefore, changing files would be part of a
  2192. multiple step process:
  2193. It is Strongly Suggested that you have a safe backup of your INI
  2194. files before you attempt to use this capability.  In addition insure that
  2195. you know what you are doing before you attempt to make changes
  2196. that OS/2 would not allow you to make.  It is possible that the actions 
  2197. described below will be successful and still leave you in a condition that
  2198. will cause you problems.
  2199. When you change either the User or System INI files, your Desktop will
  2200. revert back to the Desktop at Boot time.  Currently running PM
  2201. Applications will continue to run.  Currently, the effect on files
  2202. being printed by the Spooler is not known.  It is suggested that you
  2203. insure that the Spooler is not doing anything when you change the
  2204. User or System INI files.
  2205.  
  2206. In addition, the switch of the User and System INI files will not
  2207. persist across booting of OS/2.  In other words, if you change
  2208. either of the files and then re-boot, you will go back to the
  2209. original User and System INI files.  Therefore, changing one of the
  2210. files, then deleting a critical entry and re-booting before you
  2211. replace the critical entry will cause unknown, but almost invariably
  2212. bad, events to occur and could result in a system that will not boot
  2213. at all.
  2214.  
  2215. Insure that IniMaint was using the current User INI File.
  2216.  
  2217. Use the COPY IniMaint function to make a Copy of the current
  2218. User INI File.
  2219.  
  2220. Select this entry to change the User INI file to the Copy.
  2221.  
  2222. Use the DELETE or MOVE  ability of IniMaint to
  2223. modify the old User INI File, which will still be the current IniMaint INI
  2224. File.
  2225.  
  2226. Select this entry again to make the changed file the User INI file.  If
  2227. an error is encountered when an attempt is made to switch back, then you
  2228. must use the IniMaint COPY function to Copy any Applications you
  2229. modified from the Copy to the original File until you can switch back
  2230. successfully.
  2231.  
  2232. ************************************************************************
  2233.  
  2234. Help for Change System INI File
  2235.  
  2236. Select Change System INI File to change to a new System
  2237. INI File.  The normal System INI file is
  2238. OS2SYS.INI.  Normally this would only be done because the
  2239. user was having trouble deleting an entry from the System INI file,
  2240. therefore, changing files would be part of a multiple step process:
  2241. It is Strongly Suggested that you have a safe backup of your INI
  2242. files before you attempt to use this capability.  In addition insure that
  2243. you know what you are doing before you attempt to make changes
  2244. that OS/2 would not allow you to make.  It is possible that the actions 
  2245. described below will be successful and still leave you in a condition that
  2246. will cause you problems.
  2247. When you change either the User or System INI files, your Desktop will revert
  2248. back to the Desktop at Boot time. Currently running PM Applications will
  2249. continue to run. Currently, the effect on files being printed by the 
  2250. Spooler is not known.  It is suggested that you insure that the Spooler is
  2251. not doing anything when you change the User or System INI files.
  2252.  
  2253. In addition, the switch of the User and System INI files will not
  2254. persist across booting of OS/2.  In other words, if you change
  2255. either of the files and then re-boot, you will go back to the
  2256. original User and System INI files.  Therefore, changing one of the
  2257. files, then deleting a critical entry and re-booting before you
  2258. replace the critical entry will cause unknown, but almost invariably
  2259. bad, events to occur and could result in a system that will not boot
  2260. at all.
  2261.  
  2262. Insure that IniMaint was using the current System INI File.
  2263.  
  2264. Use the COPY IniMaint function to make a Copy of the current
  2265. System INI File.
  2266.  
  2267. Select this entry to change the System INI file to the Copy.
  2268.  
  2269. Use the DELETE or MOVE ability of IniMaint to
  2270. modify the old System INI File, which will still be the current IniMaint INI
  2271. File.
  2272.  
  2273. Select this entry again to make the changed file the System INI file.  If
  2274. an error is encountered when an attempt is made to switch back, then you
  2275. must use the IniMaint COPY function to Copy any Applications you
  2276. modified from the Copy to the original File until you can switch back
  2277. successfully.
  2278.  
  2279. ************************************************************************
  2280.  
  2281. Help for Change User INI File
  2282.  
  2283. Select Change Both INI Files to change to a new User INI File
  2284. and a new System INI File.  The normal User INI file is 
  2285. OS2.INI.   The normal System INI file is 
  2286. OS2SYS.INI.  Normally this
  2287. would only be done because the user was having trouble deleting an entry
  2288. from the User INI file, therefore, changing files would be part of a
  2289. multiple step process:
  2290. It is Strongly Suggested that you have a safe backup of your INI
  2291. files before you attempt to use this capability.  In addition insure that
  2292. you know what you are doing before you attempt to make changes
  2293. that OS/2 would not allow you to make.  It is possible that the actions 
  2294. described below will be successful and still leave you in a condition that
  2295. will cause you problems.
  2296. When you change either the User or System INI files, your Desktop will revert
  2297. back to the Desktop at Boot time.  Currently running PM Applications will
  2298. continue to run.  Currently, the effect on files being printed by the 
  2299. Spooler is not known.  It is suggested that you insure that the Spooler is
  2300. not doing anything when you change the User or System INI files.
  2301.  
  2302. In addition, the switch of the User and System INI files will not persist
  2303. across booting of OS/2.  In other words, if you change either of the files
  2304. and then re-boot, you will go back to the original User and System INI files.
  2305. Therefore, changing one of the files, then deleting a critical entry and
  2306. re-booting before you replace the critical entry will cause unknown, but
  2307. almost invariably bad, events to occur and could result in a system that
  2308. will not boot at all.
  2309.  
  2310. Insure that IniMaint was using the current User INI File.
  2311.  
  2312. Use the COPY IniMaint function to make a Copy of the current
  2313. User INI File.
  2314.  
  2315. Change IniMaint to the current System INI File.
  2316.  
  2317. Use the COPY IniMaint function to make a Copy of the current
  2318. System INI File.
  2319.  
  2320. Select this entry to change Both INI files to the Copies.
  2321.  
  2322. Use the DELETE or MOVE ability of IniMaint to
  2323. modify the old User and System INI Files.
  2324. File.
  2325.  
  2326. Select this entry again to make the changed files the User and System
  2327. INI file.  If an error is encountered when an attempt is made to switch back,
  2328. then you must use the IniMaint COPY function to Copy any
  2329. Applications you modified from the Copy to the original File until you can
  2330. switch back successfully.
  2331.  
  2332. ************************************************************************
  2333.  
  2334. Help for Repair INI File
  2335.  
  2336. Select Repair INI File to have the currently available 
  2337. Repair actions performed on the appropriate INI File.  A dialog
  2338. will be displayed that gives the user the ability to select the Type of
  2339. Repair and which of the available Repair Checks they want done.  If a Repair
  2340. Type is chosen that will actually remove items from the Current INI file, a
  2341. Save INI file must be chosen and anything removed from or changed
  2342. in the Current file will be written to the Save file.
  2343.  
  2344. ************************************************************************
  2345.  
  2346. Help for Condense INI File
  2347.  
  2348. Select Condense to Condense one or more INI files.  Whenever
  2349. a change is made to any INI file the space used by to old version of the
  2350. changed data is marked unused.  Even though this space should be reclaimed
  2351. when subsequent changes are made, any INI file that has a lot of activity
  2352. will tend to accumulate a large amount of fragmented and unused space.  The
  2353. only way to reclaim this space to to use the Prf APIs to copy the contents
  2354. of the INI file to another file, erase the old file and copy the contents
  2355. back, this entry accomplishes this task.
  2356.  
  2357. In addition, for the System INI file, OS2SYS.INI, and the User INI file,
  2358. OS2.INI, there is an additional complication.  The existing file cannot be
  2359. erased as long as it is the System or User INI file currently being used by
  2360. OS/2.  However, there is an Prf API that can change the current System or
  2361. User INI file to another file.  IniMaint uses these APIs to change the files
  2362. so that it can delete the normal System or User INI files.  That way, when
  2363. these files are recovered, they have the same name, but all the extra unused
  2364. space has been removed.
  2365.  
  2366. Because of a change in the way that the INI files are updated
  2367. in OS/2 V2.1 and beyond, the Condense is no longer needed for
  2368. these versions and will not appear on any of the Menus.  V2.1 and
  2369. beyond update the INI files so that there is never any empty space in
  2370. the files, so the Condense would no accomplish anything.
  2371. It is Strongly Suggested that you have a safe backup of your INI
  2372. files before you attempt to use this capability.  In addition, it is 
  2373. Extremely Important that you not interrupt the Condense or you can
  2374. leave your desktop in an indeterminate condition.  The primary reason that
  2375. a backup is recommended is because it is possible for some external event,
  2376. such as a power failure, to occur during the Condense and this will require
  2377. that you go back to the backup copies.
  2378. If you are Condensing either the System or User
  2379. INI files, you should not make any modifications to your desktop during
  2380. the Condense.  Depending on the timing of the changes you could end up
  2381. with the modifications being wiped out  during the restore
  2382. portion of the Condense or, even worse, the modification could end up
  2383. partially reflected in the Condensed files 
  2384. resulting in unexpected, but invariably bad events.
  2385.  
  2386. The user will first be asked to select a Temporary INI file that will be
  2387. used to temporarily hold the contents of the INI file being Condensed.  This
  2388. should be a file that does not currently exist.  If the file does exist, the
  2389. contents will be destroyed but the user will receive a warning and have
  2390. an opportunity to cancel the Condense of the file if they wish to use a
  2391. different Temporary file.
  2392.  
  2393. The submenu shows the different files that can be Condensed.
  2394.  
  2395. ************************************************************************
  2396.  
  2397. Help for Reset Non Write INI Files
  2398.  
  2399. Select Reset Non Write INI Files to have the OS2.INI
  2400. and OS2SYS.INI files changed from a condition where they cannot be
  2401. updated back to a normal condition.  This menu item is not normally
  2402. needed, since IniMaint, MultiMaint and SysMaint will both recognize
  2403. when the INI files cannot be written to and will automatically notify
  2404. the user and ask them if they want the condition corrected.  However,
  2405. if a user has chosen to have IniMaint, SysMaint or MultiMaint store
  2406. their operational information in a file other than the OS2.INI file,
  2407. then this condition would not be recognized unless the user chose to
  2408. make a change to the OS2.INI or OS2SYS.INI files.  For this reason, a
  2409. facility that would allow the user to manually fix the situation has
  2410. been added here.
  2411.  
  2412.  
  2413. Help for Test for Non Write INI Files
  2414.  
  2415. Select Test for Non Write INI Files to have the OS2.INI
  2416. and OS2SYS.INI files tested to see if they can be updated.  This menu
  2417. item is not normally needed, since IniMaint, MultiMaint and SysMaint
  2418. will both recognize when the INI files cannot be written to and will
  2419. automatically notify the user and ask them if they want the condition
  2420. corrected.  However, if a user has chosen to have IniMaint, SysMaint
  2421. or MultiMaint store their operational information in a file other
  2422. than the OS2.INI file, then this condition would not be recognized
  2423. unless the user chose to make a change to the OS2.INI or OS2SYS.INI
  2424. files.  For this reason, a facility that would allow the user to
  2425. manually make the same test has been added here.
  2426.  
  2427. ************************************************************************
  2428. ************************************************************************
  2429. ***************MAIN WINDOW EAS******************************************
  2430. ************************************************************************
  2431. ************************************************************************
  2432. ************************************************************************
  2433.  
  2434. Help for Describe EA File Contents
  2435.  
  2436. Select Describe EA File Contents to display a Message
  2437. Box that will describe the root Directory or File that was used to
  2438. create the current displayed set of Extended Attributes, what is
  2439. included in terms of Files and Directories and whether Subdirectories
  2440. were also searched.
  2441.  
  2442.  
  2443. Help for Update EAs from the Current File
  2444.  
  2445. Select Update EAs from the Current File to Update the actual
  2446. Extended Attributes for the Files and/or Directories that are in the 
  2447. currently displayed file.
  2448.  
  2449. This would normally be used if a set of Extended Attributes were Edited,
  2450. had been modified by the user and the user now wanted the modified
  2451. Extended Attributes Joined to the actual Files and/or Directories.
  2452.  
  2453.  
  2454. Help for View Extended Attributes
  2455.  
  2456. Select View to display the submenu that lists the
  2457. different set of Directories and/or Files that can be viewed.  
  2458. Once one of the submenu selections are made, the user will be
  2459. presented with an appropriate File/Directory/Drive Dialog
  2460. that will allow the selection of the Root for the View.  Once the Root
  2461. is selected a file name will be built to hold the Extended
  2462. Attributes.  This name can be built automatically or can be selected
  2463. by the user depending on the appropriate Default option.  If the file
  2464. already exists it will be overwritten automatically or the user will
  2465. be asked if they want it overwritten, based on the appropriate
  2466. Default Option.  Once all of this is done the Extended Attributes for
  2467. the Directories and/or Files will be extracted and placed in the
  2468. selected EA file Once the EAs have all been processed, the EA file
  2469. will appear as the current INI file.
  2470.  
  2471. The Application Listbox will contain the names of the Directories
  2472. and/or Files that have been found.
  2473.  
  2474. The Key Listbox will contain the List of EAs for the Directory or
  2475. File that is currently selected in the Application Listbox.
  2476.  
  2477. The Key Value window will contain the actual data for the EA.
  2478.  
  2479. If the Default option Keep Temporary Files is not
  2480. checked, then the user will never be asked for an Extended Attribute
  2481. Filename, since the created file will be automatically deleted as
  2482. soon as the View is completed.  In addition, the generated filename
  2483. will not be placed in the File Recall list, since it does not make
  2484. sense to Recall a file that has been deleted.
  2485.  
  2486. Refer to the Whatisea.txt file for a more complete
  2487. description of how the Extended Attributes are displayed.
  2488.  
  2489.  
  2490. Help for Test Extended Attributes
  2491.  
  2492. Select Test to display the submenu that lists the
  2493. different set of Directories and/or Files that can be tested.  
  2494. Once one of the submenu selections are made, the user will be
  2495. presented with an appropriate File/Directory/Drive Dialog
  2496. that will allow the selection of the Root for the Test.  Once the Root
  2497. is selected the Extended Attributes for the Directories and/or
  2498. Files will be examined and a Dialog will appear listing each File
  2499. and/or Directory along with a notation as to whether the Extended
  2500. Attributes are Valid or, if they are not Valid, what error was found.
  2501.  
  2502.  
  2503. Help for Save Extended Attributes
  2504.  
  2505. Select Save to display the submenu that lists the
  2506. different set of Directories and/or Files that can have their
  2507. Extended Attributes saved.  Once one of the submenu selections are
  2508. made, the user will be presented with an appropriate
  2509. File/Directory/Drive Dialog that will allow the selection of
  2510. the Root for the Save.  Once the Root is selected a file name will be
  2511. built to hold the Extended Attributes.  This name can be built
  2512. automatically or can be selected by the user depending on the
  2513. appropriate Default option.  If the file already exists it will be
  2514. overwritten automatically or the user will be asked if they want it
  2515. overwritten, based on the appropriate Default Option.  Once all of
  2516. this is done the Extended Attributes for the Directories and/or
  2517. Files will be extracted and placed in the selected EA file.  The
  2518. actual Extended Attributes of the Source Files and/or Directories
  2519. will not be altered.
  2520.  
  2521.  
  2522. Help for Copy Extended Attributes
  2523.  
  2524. Select Copy to display the submenu that lists the
  2525. different set of Directories and/or Files that can have their
  2526. Extended Attributes copied.  Once one of the submenu selections are
  2527. made, the user will be presented with an appropriate
  2528. File/Directory/Drive Dialog that will allow the selection of
  2529. the Source Root for the Copy.  Once the Source Root is selected the
  2530. user will be presented with an appropriate
  2531. File/Directory/Drive Dialog that will allow the selection of
  2532. the Target Root for the Copy.  Once the Target Root is selected the
  2533. Extended Attributes for the Source Directories and/or Files will
  2534. be extracted and Copied to the File or Directory that has the same
  2535. name in the Target.  The Extended Attributes of the Source Files
  2536. and/or Directories will be not be modified so that after the Copy
  2537. these Files and/or Directories will have the same Extended
  2538. Attributes as before the Copy.
  2539.  
  2540. For example, if the Extended Attributes for Files were Copied from
  2541. a Directory \SOURCE on Drive D to a Directory \TARGET on Drive
  2542. E, and there was a file SOMESTUF.TXT in both Directories, then the
  2543. Extended Attributes for the file in the Source Directory would be
  2544. copied to the same file in the Target.
  2545.  
  2546.  
  2547. Help for Move Extended Attributes
  2548.  
  2549. Select Move to display the submenu that lists the
  2550. different set of Directories and/or Files that can have their
  2551. Extended Attributes moved.  Once one of the submenu selections are
  2552. made, the user will be presented with an appropriate
  2553. File/Directory/Drive Dialog that will allow the selection of
  2554. the Source Root for the Move.  Once the Source Root is selected the
  2555. user will be presented with an appropriate
  2556. File/Directory/Drive Dialog that will allow the selection of
  2557. the Target Root for the Move.  Once the Target Root is selected the
  2558. Extended Attributes for the Source Directories and/or Files will
  2559. be extracted and Moved to the File or Directory that has the same
  2560. name in the Target.  The Extended Attributes of the Source Files
  2561. and/or Directories will be Deleted so that after the Move these
  2562. Files and/or Directories will not have any Extended Attributes.
  2563.  
  2564. For example, if the Extended Attributes for Files were Moved from
  2565. a Directory \SOURCE on Drive D to a Directory \TARGET on Drive
  2566. E, and there was a file SOMESTUF.TXT in both Directories, then the
  2567. Extended Attributes for the file in the Source Directory would be
  2568. Moved to the same file in the Target.
  2569.  
  2570.  
  2571. Help for Split Extended Attributes
  2572.  
  2573. Select Split to display the submenu that lists the
  2574. different set of Directories and/or Files that can have their
  2575. Extended Attributes split.  Once one of the submenu selections are
  2576. made, the user will be presented with an appropriate
  2577. File/Directory/Drive Dialog that will allow the selection of
  2578. the Root for the Split.  Once the Root is selected a file name will
  2579. be built to hold the Extended Attributes.  This name can be built
  2580. automatically or can be selected by the user depending on the
  2581. appropriate Default option.  If the file already exists it will be
  2582. overwritten automatically or the user will be asked if they want it
  2583. overwritten, based on the appropriate Default Option.  Once all of
  2584. this is done the Extended Attributes for the Directories and/or
  2585. Files will be extracted and placed in the selected EA file.  The
  2586. actual Extended Attributes of the Source Files and/or Directories
  2587. will be deleted and these Files and/or Directories will no longer
  2588. have any Extended Attributes.
  2589.  
  2590.  
  2591. Help for Delete Extended Attributes
  2592.  
  2593. Select Delete to display the submenu that lists the
  2594. different set of Directories and/or Files that can have their
  2595. Extended Attributes deleted.  Once one of the submenu selections are
  2596. made, the user will be presented with an appropriate
  2597. File/Directory/Drive Dialog that will allow the selection of
  2598. the Root for the Delete.  The actual Extended Attributes of the
  2599. Source Files and/or Directories will be deleted and these Files
  2600. and/or Directories will no longer have any Extended Attributes.
  2601.  
  2602.  
  2603. Help for Join Extended Attributes
  2604.  
  2605. Select Join to display the submenu that lists the
  2606. different set of Directories and/or Files that can have their
  2607. Extended Attributes Joined.  Once one of the submenu selections are
  2608. made, the user will be presented with an appropriate
  2609. File/Directory/Drive Dialog that will allow the selection of
  2610. the Root for the Join.  Once the Root is selected the Extended
  2611. Attributes in the Current File will be Joined to any Files and/or
  2612. Directories in the Target that have the same name as a corresponding
  2613. File or Directory in the Current File.
  2614.  
  2615. This function is very similar to the Update EA's from the Current
  2616. File except that the Extended Attributes can be Joined to a set of
  2617. Files and/or Directories different from the original ones.
  2618.  
  2619.  
  2620. Help for Compare Extended Attributes
  2621.  
  2622. Select Compare to Compare the Extended Attributes for
  2623. one set of Files and/or Directories to those current on another
  2624. set of Files and/or Directories.  When this selection is made the
  2625. first action is to display the submenu that lists the different set
  2626. of Directories and/or Files that can be compared.  Once one of the
  2627. submenu selections are made, the user will be presented with an
  2628. appropriate File/Directory/Drive Dialog that will allow the
  2629. selection of the Source Root for the Compare.  Once the Source Root
  2630. is selected the user will be presented with an appropriate
  2631. File/Directory/Drive Dialog that will allow the selection of
  2632. the Target Root for the Compare.  Once the Target Root is selected a
  2633. file name will be built to hold the Source Extended Attributes.  This
  2634. name can be built automatically or can be selected by the user
  2635. depending on the appropriate Default option.  If the file already
  2636. exists it will be overwritten automatically or the user will be asked
  2637. if they want it overwritten, based on the appropriate Default
  2638. Option.  Then a file name will be built to hold the Target Extended
  2639. Attributes.  This name can be built automatically or can be selected
  2640. by the user depending on the appropriate Default option.  If the file
  2641. already exists it will be overwritten automatically or the user will
  2642. be asked if they want it overwritten, based on the appropriate
  2643. Default Option.  Once all of this is done the Compare Dialog will
  2644. appear and do a Key Value level Compare of the Extended Attribute
  2645. information between the Source and Target.  Once the Compare is
  2646. completed, the files that contain the Extended Attributes will be
  2647. deleted if the user has selected this Default Option.
  2648.  
  2649. If the Default option Keep Temporary Files is not
  2650. checked, then the user will never be asked for an Extended Attribute
  2651. Filename, since the created file will be automatically deleted as
  2652. soon as the View is completed.  In addition, the generated filename
  2653. will not be placed in the File Recall list, since it does not make
  2654. sense to Recall a file that has been deleted.
  2655.  
  2656.  
  2657. Help for Compare to Saved Extended Attributes
  2658.  
  2659. Select Compare to Saved to Compare the Extended
  2660. Attributes that are currently on a set of Files and/or
  2661. Directories to those that have already been saved in an EA file.  For
  2662. example, this entry would be used to compare the current Extended
  2663. Attributes for a set of Files and/or Directories to those saved
  2664. previously, in order to see what kinds of changes have occurred. When
  2665. this selection is made the first action is to display the submenu
  2666. that lists the different set of Directories and/or Files that can
  2667. be compared.  Once one of the submenu selections are made, the user
  2668. will be presented with an appropriate File/Directory/Drive
  2669. Dialog that will allow the selection of the Source Root for the
  2670. Compare.  Once the Source Root is selected the user will be presented
  2671. with a File Dialog that will allow the selection of the Target EA
  2672. File for the Compare.  Once the Target Root is selected a file name
  2673. will be built to hold the Source Extended Attributes.  This name can
  2674. be built automatically or can be selected by the user depending on
  2675. the appropriate Default option.  If the file already exists it will
  2676. be overwritten automatically or the user will be asked if they want
  2677. it overwritten, based on the appropriate Default Option.  Once all of
  2678. this is done the Compare Dialog will appear and do a Key Value level
  2679. Compare of the Extended Attribute information between the Source and
  2680. Target.  Once the Compare is completed, the files that contain the
  2681. Source Extended Attributes will be deleted if the user has selected
  2682. this Default Option.
  2683.  
  2684. If the Default option Keep Temporary Files is not
  2685. checked, then the user will never be asked for an Extended Attribute
  2686. Filename, since the created file will be automatically deleted as
  2687. soon as the View is completed.  In addition, the generated filename
  2688. will not be placed in the File Recall list, since it does not make
  2689. sense to Recall a file that has been deleted.
  2690.  
  2691.  
  2692. Help for Select EAs for a Single File
  2693.  
  2694. Select EAs for File to display the Extended Attributes
  2695. for a single file.  A File Selection Dialog will be displayed
  2696. allowing the user to select the file.
  2697.  
  2698.  
  2699. Help for Select EAs for a Single Path
  2700.  
  2701. Select EAs for Path to display the Extended Attributes
  2702. for a single directory.  A File Selection Dialog will be displayed
  2703. allowing the user to select the directory.
  2704.  
  2705.  
  2706. Help for Select EAs for all Files in Directory
  2707.  
  2708. Select EAs for all Files in Directory to display the
  2709. Extended Attributes for all the Files in a single Subdirectory.  A
  2710. File Selection Dialog will be displayed allowing the user to select
  2711. the Root Directory to use.
  2712.  
  2713.  
  2714. Help for Select EAs for all Directories in Directory
  2715.  
  2716. Select EAs for all Directories in Directory to display
  2717. the Extended Attributes for all the Directories in a single
  2718. Subdirectory.  A File Selection Dialog will be displayed allowing the
  2719. user to select the Root Directory to use.
  2720.  
  2721.  
  2722. Help for Select EAs for all Files and Directories in Directory
  2723.  
  2724. Select EAs for all Files and Directories in Directory to
  2725. display the Extended Attributes for all the Files and Directories in
  2726. a single Subdirectory.  A File Selection Dialog will be displayed
  2727. allowing the user to select the Root Directory to use.
  2728.  
  2729.  
  2730. Help for Select EAs for all Files in Directory and Subdirectory
  2731.  
  2732. Select EAs for all Files in Directory and Subdirectory
  2733. to display the Extended Attributes for all the Files in a single
  2734. Directory and all of it's Subdirectories.  A File Selection Dialog
  2735. will be displayed allowing the user to select the Root Directory to
  2736. use.
  2737.  
  2738.  
  2739. Help for Select EAs for all Directories in Directory and Subdirectory
  2740.  
  2741. Select EAs for all Directories in Directory and
  2742. Subdirectory to display the Extended Attributes for all the
  2743. Directories in a single Directory and all of it's Subdirectories.  A
  2744. File Selection Dialog will be displayed allowing the user to select
  2745. the Root Directory to use.
  2746.  
  2747.  
  2748. Help for Select EAs for all Files and Directories in Directory and Subdirectory
  2749.  
  2750. Select EAs for all Files and Directories in Directory and
  2751. Subdirectory to display the Extended Attributes for all the
  2752. Files and Directories in a single Directory and all of it's
  2753. Subdirectories.  A File Selection Dialog will be displayed allowing
  2754. the user to select the Root Directory to use.
  2755.  
  2756.  
  2757. Help for Select EAs for all Files on Drive
  2758.  
  2759. Select EAs for all Files on Drive to display the
  2760. Extended Attributes for all the Files on a Drive.  A Drive Selection
  2761. Dialog will be displayed allowing the user to select the Drive to
  2762. use.
  2763.  
  2764.  
  2765. Help for Select EAs for all Directories on Drive
  2766.  
  2767. Select EAs for all Directories on Drive to display the
  2768. Extended Attributes for all the Directories on a Drive.  A Drive
  2769. Selection Dialog will be displayed allowing the user to select the
  2770. Drive to use.
  2771.  
  2772.  
  2773. Help for Select EAs for all Files and Directories on Drive
  2774.  
  2775. Select EAs for all Files and Directories on Drive to
  2776. display the Extended Attributes for all the Files and Directories on
  2777. a Drive.  A Drive Selection Dialog will be displayed allowing the
  2778. user to select the Drive to use.
  2779.  
  2780. ************************************************************************
  2781. ************************************************************************
  2782. ***************MAIN WINDOW FIND*****************************************
  2783. ************************************************************************
  2784. ************************************************************************
  2785. ************************************************************************
  2786.  
  2787. Help for Find Application Name
  2788.  
  2789. Select Application Name on the Find menu to do a
  2790. Find on the entries in the Application Listbox.  If the Find is successful
  2791. the Application Name will be Selected and the Listbox will be scrolled to
  2792. insure the found name is visible.
  2793.  
  2794. ************************************************************************
  2795.  
  2796. Help for Find Current Key Name
  2797.  
  2798. Select Current Key Name on the Find menu to do a
  2799. Find on the entries in the Current Key Listbox.  If the Find is successful
  2800. the Current Key Name will be Selected and the Listbox will be scrolled to
  2801. insure the found name is visible.
  2802.  
  2803. ************************************************************************
  2804.  
  2805. Help for Find Current Key Value
  2806.  
  2807. Select Current Key Value on the Find menu to do a
  2808. Find on the entries in the Current Key Value MLE.  If the Find is successful
  2809. the Current Key Value will be Selected and the MLE will be scrolled to
  2810. insure the found value is visible.
  2811.  
  2812. ************************************************************************
  2813.  
  2814. Help for Find Application Key Value
  2815.  
  2816. Select Application Key Value on the Find menu to
  2817. do a Find on all of the Key Values for the current Application.  If the Find
  2818. is successful the Current Key Name will be Selected, the Listbox will be
  2819. scrolled to insure the selected Name is visible, the found Key Value will be
  2820. loaded into the Key Value MLE, and the Key Value MLE will be scrolled to
  2821. insure the found Value is visible.
  2822.  
  2823. ************************************************************************
  2824.  
  2825. Help for Find Any Key Name
  2826.  
  2827. Select Any Key Name on the Find menu to do a
  2828. Find on all of the Key Names in the current INI file.  If the Find is
  2829. successful the Application that contains the Key Name will be selected in
  2830. the Application Listbox, the Application Listbox will be scrolled to insure
  2831. the selected Application is visible, the Key Names will be loaded into the
  2832. Key Listbox, the Current Key Name will be Selected and the Listbox will be
  2833. scrolled to insure the found Name is visible.
  2834.  
  2835. ************************************************************************
  2836.  
  2837. Help for Find Any Key Value
  2838.  
  2839. Select Any Key Value on the Find menu to do a
  2840. Find on all of the Key Values in the current INI file.  If the Find is
  2841. successful the Application that contains the Key Value will be selected in
  2842. the Application Listbox, the Application Listbox will be scrolled to insure
  2843. the selected Application is visible, the Key Names will be loaded into the
  2844. Key Listbox, the Current Key Name will be Selected, the Listbox will be
  2845. scrolled to insure the selected Name is visible, the found Key Value will be
  2846. loaded into the Key Value MLE, and the Key Value MLE will be scrolled to
  2847. insure the found Value is visible.
  2848.  
  2849. ************************************************************************
  2850.  
  2851. Help for Repeat Last Find
  2852.  
  2853. Select Repeat Last Find on the Find menu to
  2854. Repeat the Last Find that was requested. This item is really a short
  2855. hand way to Repeat a Find and has been placed on the Find Menu
  2856. because it is probably the most common thing a user will want to do.
  2857.  
  2858. ************************************************************************
  2859. ************************************************************************
  2860. ***************MAIN WINDOW DESKTOP**************************************
  2861. ************************************************************************
  2862. ************************************************************************
  2863. ************************************************************************
  2864.  
  2865. Help for Reset Desktop
  2866.  
  2867. Select Reset Desktop to Reset WPS to the same condition
  2868. as when OS/2 was last booted from the Harddisk.  This selection
  2869. should not be needed except in special situations.  Normally, all of
  2870. the Desktop menu selections will automatically do a Reset of the
  2871. Desktop, if it is necessary.  However, there are a number of different
  2872. kinds of manual things that can be done to the INI files and/or the
  2873. Desktop Extended Attributes that will not take effect until WPS has
  2874. been restarted, therefore, this option is provided for that purpose.
  2875.  
  2876. When WPS is reset, the visual effect is the same as when WPS
  2877. encounters an error that prevents if from continuing.  In this case,
  2878. all of the Icons and Folders on the Desktop will disappear and the
  2879. Desktop itself will appear to fold in on itself.  After a few seconds,
  2880. the Icons will start to reappear and, if the appropriate option is
  2881. selected in the OS2.INI file, the Folders that were open at the time
  2882. of the WPS termination should also reopen.  The first time this occurs
  2883. for each user, it is disconcerting.  However, this is actually a very
  2884. good feature of WPS and has saved many users the need to reboot
  2885. OS/2.
  2886.  
  2887.  
  2888. Help for Backup Desktop
  2889.  
  2890. Select Backup Desktop to create a Simple Backup of the
  2891. Desktop.  This selection will first rebuild the Backup CMD file, in
  2892. order to insure that it is current with the actual Desktop Directory
  2893. structure, and then will execute the CMD file.  Normally, the user
  2894. will see a window open on the Desktop and can watch the CMD file
  2895. while it makes the backup.
  2896.  
  2897. The actual Backup procedure consists of:
  2898.  
  2899. Erasing the oldest Backup Generation, if it exists.
  2900.  
  2901. Renaming each remaining Generation to the next oldest generation.
  2902.  
  2903. Using Zip to zip the OS2.INI and OS2SYS.INI files into a
  2904. temporary zip file.
  2905.  
  2906. Using Zip to zip the Desktop Directory structure and it's
  2907. Extended Attributes into a temporary zip file.
  2908.  
  2909. Zipping the temporary zip files from above into a single zip file.
  2910.  
  2911. Erasing the two temporary zip files.
  2912.  
  2913. The reason the INI Files and the Desktop Directory structure are
  2914. zipped into separate files is so that they can be Restored
  2915. individually.
  2916.  
  2917. This item will not operate correctly if the version of Zip that is
  2918. first found in the CONFIG.SYS PATH variable is not an OS/2
  2919. version of Zip and is a version that supports zipping Extended
  2920. Attributes.  If there is any question about this, please refer to the
  2921. discussion of the Operational Environment.
  2922.  
  2923.  
  2924. Help for Do Supplemental Backup
  2925.  
  2926. Select Do Supplemental Backup to create a Backup of the
  2927. Supplemental Backup files.  This selection will first rebuild the
  2928. Supplemental Backup CMD file, in order to insure that it is current
  2929. with the actual set of Supplemental File, and then will execute the
  2930. CMD file.  Normally, the user will see a window open on the Desktop
  2931. and can watch the CMD file while it makes the backup.
  2932.  
  2933. The actual Backup procedure consists of:
  2934.  
  2935. Erasing the oldest Backup Generation, if it exists.
  2936.  
  2937. Renaming each remaining Generation to the next oldest generation.
  2938.  
  2939. Using Zip to zip the Supplemental Files into different ZIP files,
  2940. one for each drive that contains at least one Supplemental Backup
  2941. File.
  2942. Extended Attributes into a temporary zip file.
  2943.  
  2944. Zipping the temporary zip files from above into a single zip file.
  2945.  
  2946. Erasing the temporary zip files.
  2947.  
  2948. The reason the Supplemental Files zipped into separate files is so
  2949. that they can be Restored correctly.  The Unzip program will Unzip
  2950. files to the default drive unless it is directed to Unzip to a
  2951. specific drive.
  2952.  
  2953. This item will not operate correctly if the version of Zip that is
  2954. first found in the CONFIG.SYS PATH variable is not an OS/2
  2955. version of Zip and is a version that supports zipping Extended
  2956. Attributes.  If there is any question about this, please refer to the
  2957. discussion of the Operational Environment.
  2958.  
  2959.  
  2960. Help for Create Backup CMD File
  2961.  
  2962. Select Create Backup CMD File to create the CMD file
  2963. that would backup the current Desktop with the currently specified
  2964. number of Backup Generations.  The CMD file will automatically be
  2965. rebuilt anytime the Desktop is actually Backed up, but it can also be
  2966. built manually, so that it can be used in other situations, such as
  2967. when the system is booted.
  2968.  
  2969. Any time the number of Backup Generations is changed, then this
  2970. CMD file should get rebuilt.
  2971.  
  2972.  
  2973. Help for Create Restore CMD File
  2974.  
  2975. Select Create Restore CMD File to Restore the Desktop
  2976. from any one of the Backup Generations created by the Backup Menu
  2977. item or the Backup CMD file.
  2978.  
  2979. This CMD files cannot be run while WPS is active, so it must be
  2980. run after a boot from a floppy or while the boot is interrupted by
  2981. ShiftRun.  There are other menu items that will do a partial Restore
  2982. of the Desktop while WPS is active, but there did not seem to be much
  2983. of a reason to do a full Restore with WPS active, since it is
  2984. unlikely that WPS would even run if the Desktop is sufficiently
  2985. corrupted that a full Restore is necessary.
  2986.  
  2987. The Restore CMD file takes a single input parameter, which is the
  2988. Generation the user wants to use for the Restore.  If no parameter is
  2989. specified, the CMD file will default to the first, and most recent,
  2990. Generation and will PAUSE to tell the user that the default is being
  2991. used.
  2992.  
  2993. The steps involved in Restoring the Desktop are:
  2994.  
  2995. The current Desktop Directory and all files in any Subdirectories
  2996. are deleted.
  2997.  
  2998. The current OS2.INI and OS2SYS.INI files are erased.
  2999.  
  3000. The zipped Backup file is unzipped to create the two temporary
  3001. zip files.
  3002.  
  3003. One of the temporary zip files is unzipped into the Desktop
  3004. Directory structure.
  3005.  
  3006. The other temporary zip file is unzipped into the INI files.
  3007.  
  3008. ATTRIB is used to verify the unzipped INI files do not have
  3009. the RO Attribute set.
  3010.  
  3011. The temporary zip files are erased.
  3012.  
  3013. It is critical that the version of UNZIP used is one that will
  3014. restore the Extended Attributes.  If there is any question about this,
  3015. you should review the Operational Environment section of
  3016. this Help file.
  3017.  
  3018.  
  3019. Help for Create Supplemental Backup CMD File
  3020.  
  3021. Select Create Supplemental Backup CMD File to create
  3022. the CMD file that would backup the current set of Supplemental Backup
  3023. Files with the currently specified number of Backup Generations.  The
  3024. CMD file will automatically be rebuilt anytime the Supplemental
  3025. Backup is done, but it can also be built manually, so that it can be
  3026. used in other situations, such as when the system is booted.
  3027.  
  3028. Any time the number of Backup Generations is changed, then this
  3029. CMD file should get rebuilt.
  3030.  
  3031.  
  3032. Help for Create Supplemental Restore CMD File
  3033.  
  3034. Select Create Supplemental Restore CMD File to Restore
  3035. the Supplemental Backup Files from any one of the Backup Generations
  3036. created by the Supplemental Backup Menu item or the Supplemental
  3037. Backup CMD file.
  3038.  
  3039. The Supplemental Restore CMD file takes a single input parameter,
  3040. which is the Generation the user wants to use for the Restore.  If no
  3041. parameter is specified, the CMD file will default to the first, and
  3042. most recent, Generation and will PAUSE to tell the user that the
  3043. default is being used.
  3044.  
  3045.  
  3046. Help for Restore Desktop ID
  3047.  
  3048. Select Restore Desktop ID to Restore the proper ID to
  3049. the Desktop.  For reasons that are unknown to this developer at this
  3050. time, the Desktop will sometimes forget that it is the Desktop and
  3051. revert to being a normal Folder.  If a user opens up the Desktop menu
  3052. by using the RMB on the Desktop and the resulting menu is missing the
  3053. Desktop items, such as Shutdown, then the Desktop has forgotten it is
  3054. the Desktop.  The actual problem is in the Extended Attributes for the
  3055. root Desktop Directory and this menu item will repair the error and
  3056. the Desktop menu will once again have the appropriate entries.
  3057.  
  3058.  
  3059. Help for Restore Desktop Directory
  3060.  
  3061. Select Restore Desktop Directory to Restore the Desktop
  3062. Directory structure while WPS is active.  It is critical that nothing
  3063. else be going on with the Desktop while this activity is being done.
  3064. If any attempt is made to update or access the Desktop during this
  3065. activity, it is extremely likely that WPS will fail and will not come
  3066. back up again.  In this case, it will be necessary to boot from a
  3067. floppy and do a full Desktop Restore.
  3068.  
  3069. The steps involved in Restoring the Desktop Directory are:
  3070.  
  3071. The current Desktop Directory and all files in any Subdirectories
  3072. are deleted.
  3073.  
  3074. The zipped Backup file is unzipped to create the two temporary
  3075. zip files.
  3076.  
  3077. One of the temporary zip files is unzipped into the Desktop
  3078. Directory structure.
  3079.  
  3080. The temporary zip files are erased.
  3081.  
  3082. It is unlikely that this particular menu item will be used very
  3083. often.  In almost every case where the Desktop Directory structure is
  3084. sufficiently corrupted that it needs to be Restored, the corruption
  3085. is sufficient to prevent WPS form even running.  When the Desktop is
  3086. corrupted, but WPS continues to run, the problem is seldom corruption
  3087. of the Desktop Directory structure, it is almost always a problem
  3088. with the INI files and this problem is fixed via a different menu
  3089. selection.
  3090.  
  3091.  
  3092. Help for Restore Desktop INI Files
  3093.  
  3094. Select Restore Desktop INI Files to Restore the
  3095. OS2*.INI files while WPS is active.  It is critical that nothing
  3096. else be going on with the Desktop while this activity is being done.
  3097. If any attempt is made to update or access the Desktop during this
  3098. activity, it is extremely likely that WPS will fail and will not come
  3099. back up again.  In this case, it will be necessary to boot from a
  3100. floppy and do a full Desktop Restore.
  3101.  
  3102. The steps involved in Restoring the INI Files are:
  3103.  
  3104. A copy is made of both INI files and these are made the current
  3105. System and User INI files.
  3106.  
  3107. The current OS2.INI and OS2SYS.INI files are erased.
  3108.  
  3109. The zipped Backup file is unzipped to create the two temporary
  3110. zip files.
  3111.  
  3112. One temporary zip file is unzipped into the INI files.
  3113.  
  3114. ATTRIB is used to verify the unzipped INI files do not have
  3115. the RO Attribute set.
  3116.  
  3117. The temporary zip files are erased.
  3118.  
  3119. The System and User INI files are switched back to the Restored
  3120. copies of OS2.INI and OS2SYS.INI.
  3121.  
  3122. The copies of the original INI files are erased.
  3123.  
  3124. Whenever the Desktop seems to be corrupted, but WPS will stay
  3125. active, it is most likely that this menu item will fix the problem,
  3126. as opposed to restoring the Desktop Directory structure.  If the
  3127. Directory structure is corrupted, it is not very likely that WPS will
  3128. even run and a full Restore of the Desktop will probably be
  3129. necessary.
  3130.  
  3131.  
  3132. Help for Do Supplemental Restore
  3133.  
  3134. Select Do Supplemental Restore to Restore all of the
  3135. Supplemental Backup Files for the selected Generation.
  3136.  
  3137.  
  3138. Help for Create Portable Backup
  3139.  
  3140. Select Create Portable Backup to create an Object 
  3141. by Object Backup of the Desktop. As each step below is done, a Dialog
  3142. Box will be displayed identifying the step in progress. The
  3143. collection of the Detail Information on each Object can take some
  3144. time, so you should not worry if this Dialog stays on the screen for
  3145. a few minutes.
  3146.  
  3147. Before this item is selected, it is a good idea to make sure that
  3148. the Portable Backup Defaults are set appropriately.
  3149.  
  3150. The actual Backup procedure consists of:
  3151.  
  3152. Erasing the oldest Backup Generation, if it exists.
  3153.  
  3154. Renaming each remaining Generation to the next oldest generation.
  3155.  
  3156. Making a special copy of the OS2.INI and OS2SYS.INI files.
  3157.  
  3158. Making a special copy of the Desktop Directory structure and it's
  3159. Extended Attributes.
  3160.  
  3161. Finding all of the Objects on the Desktop and collecting some
  3162. initial data on each Object.
  3163.  
  3164. Going through the list of Objects and Collecting the Detail
  3165. Object data on each Object.
  3166.  
  3167.  
  3168. Help for Do Portable Restore
  3169.  
  3170. Select Do Portable Restore to Restore one or more
  3171. Objects that were backed up in the Portable Backup. Most of the
  3172. Restore work is actually done with the Restore Desktop Dialog.
  3173.  
  3174. Before this item is selected, it is a good idea to make sure that
  3175. the Portable Backup Defaults are set appropriately.
  3176.  
  3177. The actual Restore procedure consists of:
  3178.  
  3179. Since several Generations of Backup are normally maintained, the
  3180. user will be asked to select the Generation to use. The default is
  3181. the latest Generation, 01, which is the default.
  3182.  
  3183. Several initialization things must be done, including the
  3184. creation of the WPS Object that will do the actual Restore of the WPS
  3185. information, opening of a number of files, loading the Objects into
  3186. the Restore Dialog Window and sorting the entries.
  3187.  
  3188. The Restore Dialog will then be displayed and the user can
  3189. Restore all thos Objects they wish to Restore.
  3190.  
  3191. Once the Restore is completed, the Desktop will be Reset if one
  3192. of the Restore actions require it. If the Desktop needs to be Reset,
  3193. the user will be warned when they do the first action that will make
  3194. the Reset necessary.
  3195.  
  3196.  
  3197. Help for Desktop Object Settings
  3198.  
  3199. Select Desktop Object Settings to popup the Dialog that
  3200. allows the user to Display and/or Modify the WPS Settings for one
  3201. or more Objects on the Desktop.  This option would not normally be
  3202. used in situations where only a single Object was of interest, since
  3203. it takes a while for all of the Desktop Objects to be found and
  3204. initial information collected.  If only a single Object is of
  3205. interest, it is probably easier to use the Object Settings Notebook. 
  3206. However, if the user wants to look at or modify the WPS Settings for a
  3207. collection of Objects, then this option is a much easier way to
  3208. accomplish this task.
  3209.  
  3210. Since the dialog needs a considerable amount of information on the
  3211. Desktop, it will take a few seconds before the Dialog Window is
  3212. displayed.  The necessary actions are:
  3213.  
  3214. The WPS Access Agent Object must be started.
  3215.  
  3216. All of the Objects on the Desktop must be found.  This requires
  3217. that all of the Folders be populated and this will take a second or
  3218. so the first time through after a boot.
  3219.  
  3220. Each of the Objects must be inserted in the Window and then the
  3221. contents must be sorted, so that Objects will be easy to find.
  3222.  
  3223.  
  3224. Help for Display Backup Descriptions
  3225.  
  3226. Select Display Backup Descriptions to Display the Descriptions 
  3227. of all of the current generations of the Desktop, Supplemental or Portable 
  3228. Backup Files.  These files will have a Description if the appropriate 
  3229. checkbox is checked in the Defaults Dialog and the User entered a description 
  3230. when it was requested.  If any of the Generations does not have a 
  3231. Description, then the Generations Number will be displayed along with a 
  3232. notification that there is no Description.
  3233.  
  3234. ************************************************************************
  3235. ************************************************************************
  3236. ************************************************************************
  3237. ***************REPLACE KEY DIALOG***************************************
  3238. ************************************************************************
  3239. ************************************************************************
  3240. ************************************************************************
  3241.  
  3242. Help for Add or Replace Key Value Dialog
  3243.  
  3244. The Add or Replace Key Value Dialog will allow the user
  3245. to modify the Value of the current Key.  This is the only Selection
  3246. that will allow the user to change the length of a Key Value.  The
  3247. bottom Window of the Main Window can be used to modify the Value of a
  3248. Key, but it cannot be used to change the length of a Value.
  3249.  
  3250.  
  3251. Help for Application Name
  3252.  
  3253. The Application Name is the name of the Application that
  3254. is currently being modified.
  3255.  
  3256.  
  3257. Help for Key Name
  3258.  
  3259. The Key Name is the name of the Key that
  3260. is currently being modified.
  3261.  
  3262.  
  3263. Help for Key Value Length
  3264.  
  3265. The Data Length shows the current length of the Key Value
  3266. that is currently being modified.  This value will change dynamically as the
  3267. actual value length is changed.  However, the length will not change when
  3268. only one character is added to the Hexidecimal Value
  3269. field, since two Hexidecimal characters are required to make a
  3270. single Ascii character.
  3271.  
  3272.  
  3273. Help for Ascii Key Value
  3274.  
  3275. The Ascii Key Value is the current contents of the Key Value
  3276. being modified.  Any Ascii characters which would not print are replaced by
  3277. a '.' to improve readability.
  3278.  
  3279.  
  3280. Help for Items not yet done
  3281.  
  3282. The Hex Key Value is a two Hexidecimal character
  3283. display for each Ascii character of the current of the Key Value
  3284. being modified.
  3285.  
  3286.  
  3287. Help for Add Zero Terminator
  3288.  
  3289. The Add Zero Terminator Checkbox can be used to insure
  3290. that character string Key Values always end with a null character,
  3291. which is a binary zero. Since virtually all Applications which store
  3292. information in an INI file will store character strings with the null
  3293. character terminator, if this option is checked, the Dialog
  3294. termination code will insure that the Ascii value entered has the
  3295. null terminator. If the terminator is not there, then it will be
  3296. added and the length will be increased by one. This insures that both
  3297. the actual data and the stored length are as expected.
  3298.  
  3299. ************************************************************************
  3300. ************************************************************************
  3301. **********************DUMP DIALOG***************************************
  3302. ************************************************************************
  3303. ************************************************************************
  3304. ************************************************************************
  3305.  
  3306. Help for Dump Variables Dialog
  3307.  
  3308. The Dump Variables Dialog will display the current contents of
  3309. all Global Variables and various System and Application Error values.  This
  3310. Dialog will be displayed automatically whenever a terminal error occurs and
  3311. gives the user the option of recording the values in a Dump File.
  3312.  
  3313.  
  3314. Help for Dump File Name
  3315.  
  3316. The File Name is the name of the File that will be used
  3317. to contain all of the Dump variable information displayed in the Dialog
  3318. if the Write Button is selected.
  3319.  
  3320.  
  3321. Help for Dump Logic Error
  3322.  
  3323. The Logic Error is the IniMaint, SysMaint or MultiMaint
  3324. Internal Error Code.  Any value other than zero is an error value.  A
  3325. short description of the error will be displayed in the Logic
  3326. Error Text field.
  3327.  
  3328.  
  3329. Help for Dump DOS Error
  3330.  
  3331. The DOS Error is the error code returned from the last
  3332. call to an OS/2 DOS API.  It will normally be a
  3333. further explanation of the Logic Error, if IniMaint,
  3334. SysMaint or MultiMaint was terminated by an error.
  3335.  
  3336.  
  3337. Help for Dump Help Error
  3338.  
  3339. The Help Error is the error code returned from the last
  3340. call to an OS/2 Help API.  It will normally be a
  3341. further explanation of the Logic Error, if IniMaint,
  3342. SysMaint or MultiMaint was terminated by an error or the Message Box
  3343. saying that the Help is not available was displayed.
  3344.  
  3345.  
  3346. Help for Dump PM Error
  3347.  
  3348. The PM Error is the error code returned from the last
  3349. call to an OS/2 PM API.  It will normally be a further
  3350. explanation of the Logic Error, if IniMaint, SysMaint or
  3351. MultiMaint was terminated by an error.
  3352.  
  3353.  
  3354. Help for Dump PM Test Error
  3355.  
  3356. There are many situations where a call to an OS/2 PM
  3357. API will return a valid return, however, a call to the API that
  3358. returns PM errors will return a nonzero error.  IniMaint, SysMaint or
  3359. MultiMaint attempts to record this error code whenever the Dump
  3360. Dialog is invoked.  This error will normally be the last PM non zero
  3361. error code from an API that had a valid return.
  3362.  
  3363.  
  3364. Help for Dump PM Error Text
  3365.  
  3366. The PM Error Text is a short explanation of the 
  3367. PM Error or the PM Test Error if the PM Error is zero.
  3368.  
  3369. Due to a problem in OS/2 1.3 CSD WR5050, this text will not be correct
  3370. for this particular level of OS/2.
  3371.  
  3372.  
  3373. Help for Dump Logic Error Text
  3374.  
  3375. The Logic Error Text is a short explanation of the
  3376. IniMaint, SysMaint or MultiMaint error shown in the Logic
  3377. Error field.
  3378.  
  3379.  
  3380. Help for Dump Variable Window
  3381.  
  3382. This window contains the contents of all of the IniMaint, SysMaint or MultiMaint Variables and
  3383. is only of use in Debugging problems.
  3384.  
  3385.  
  3386. Help for Dump Write to File
  3387.  
  3388. Selecting this Button will cause the IniMaint, SysMaint or
  3389. MultiMaint Variable information to be written to the current
  3390. Dump File.
  3391.  
  3392.  
  3393. Help for Dump Select New File
  3394.  
  3395. This selection will cause the New File Dialog to be opened
  3396. so that a new Dump File can be selected.
  3397.  
  3398. ************************************************************************
  3399. ************************************************************************
  3400. ******************OPTIONS DIALOG****************************************
  3401. ************************************************************************
  3402. ************************************************************************
  3403. ************************************************************************
  3404.  
  3405. Help for Options Dialog
  3406.  
  3407. The Options Dialog will display a set of Checkboxes
  3408. that allow the user to control the behavior of IniMaint, SysMaint or
  3409. MultiMaint in a number of different situations.
  3410.  
  3411.  
  3412. Help for Options Ask Before Switch INI Files
  3413.  
  3414. The Ask Before Switch INI Files Option controls whether
  3415. the user will be warned before they change either the User or System
  3416. INI files to a new file.  Since changing these files can have a
  3417. serious affect on the Desktop and require that the Desktop be Reset,
  3418. the default behavior is to warn the user before this function is
  3419. done.  However, experienced users know the consequences and do not
  3420. want to be bothered by the warning, so this Option allows it to be
  3421. turned off.
  3422.  
  3423. The Default for this Option is Yes.
  3424.  
  3425.  
  3426. Help for Options Recall Files
  3427.  
  3428. The Recall Files Option controls the maximum number of entries
  3429. that will appear on the File Recall submenu.  Once the number of 
  3430. files to be Recalled has reached this value, the oldest file will be
  3431. dropped from the list.  The default is 10 and the maximum value is 100.
  3432.  
  3433.  
  3434. Help for Options Use Fast Copy
  3435.  
  3436. The Use Fast Copy Option controls whether IniMaint,
  3437. SysMaint or MultiMaint will use the special fast methods to access
  3438. the INI files when doing a Copy or Move of an entire INI file, Backup
  3439. of an INI file or Condense of an INI file.  This option significantly
  3440. decreases the time needed to do these functions.
  3441.  
  3442.  
  3443. Help for Options Apps and Keys in Alpha Order
  3444.  
  3445. The Apps and Keys in Alpha Order Option controls how
  3446. IniMaint, SysMaint or MultiMaint will load the Application and Key
  3447. Names into the Listboxes.  If this option is selected, the Names will
  3448. be loaded in alphabetic order, otherwise, they will be loaded in the
  3449. order encountered.  The default for this Option is Yes.
  3450. Option.
  3451.  
  3452.  
  3453. Help for Options Ask Before Backup
  3454.  
  3455. The Ask Before Backup Option controls whether IniMaint,
  3456. SysMaint or MultiMaint will ask for verification of the name of the
  3457. backup file for the INI File that is being backed up.  If no backup
  3458. name has been specified, then IniMaint, SysMaint or MultiMaint will
  3459. always ask.  The default for this Option is Yes.
  3460.  
  3461.  
  3462. Help for Options Ask Before Deleting
  3463.  
  3464. The Ask Before Deleting Option controls whether
  3465. IniMaint, SysMaint or MultiMaint will ask for verification before
  3466. deleting an Application or Key.  The default for this Option is
  3467. Yes.
  3468.  
  3469.  
  3470. Help for Options Ask Before Updating
  3471.  
  3472. The Ask Before Updating Option controls whether
  3473. IniMaint, SysMaint or MultiMaint will ask for verification before
  3474. writing changes to an Application or Key to the current INI File. The
  3475. default for this Option is Yes.
  3476.  
  3477.  
  3478. Help for Options Display Initial Dialog
  3479.  
  3480. The Display Initial Dialog Option controls whether
  3481. IniMaint, SysMaint or MultiMaint will Display the Initial Dialog Box
  3482. each time it is run.  The default for this Option is Yes.
  3483.  
  3484.  
  3485. Help for Options Display Size Calculation Box
  3486.  
  3487. The Display Size Calculation Box Option controls
  3488. whether IniMaint, SysMaint or MultiMaint will Display a box saying
  3489. that a Size Calculation  is in progress.  During the
  3490. Size Calculation no user input to IniMaint, SysMaint or
  3491. MultiMaint will be accepted and the Wait Pointer will be
  3492. displayed.  However, the PM Message Queue will not be blocked so the
  3493. user can switch away from IniMaint, SysMaint or MultiMaint during
  3494. this process.  The default for this Option is Yes.
  3495.  
  3496.  
  3497. Help for Options Display Loading Listbox Box
  3498.  
  3499. The Display Loading Listbox Box Option controls whether
  3500. IniMaint, SysMaint or MultiMaint will Display a box saying that it is
  3501. Loading the Applications, Keys or Current Key Value
  3502. information.  During the Loading process no user input to
  3503. IniMaint, SysMaint or MultiMaint will be accepted and the Wait
  3504. Pointer will be displayed.  However, the PM Message Queue will
  3505. not be blocked so the user can switch away from IniMaint, SysMaint or
  3506. MultiMaint during this process.  The default for this Option is 
  3507. No.
  3508.  
  3509.  
  3510. Help for Options Display Copying/Moving Box
  3511.  
  3512. The Display Copying/Moving Box Option controls
  3513. whether IniMaint, SysMaint or MultiMaint will Display a box saying
  3514. that a Copy or Move  is in progress.  During the Copy
  3515. or Move no user input to IniMaint, SysMaint or MultiMaint will
  3516. be accepted and the Wait Pointer will be displayed.
  3517. However, the PM Message Queue will not be blocked so the user can
  3518. switch away from IniMaint, SysMaint or MultiMaint during this
  3519. process.  The default for this Option is Yes.
  3520.  
  3521.  
  3522. Help for Options Display Find Box
  3523.  
  3524. The Display Find Box Option controls whether IniMaint,
  3525. SysMaint or MultiMaint will Display a box saying that a
  3526. Find  is in progress.  During the Find no user
  3527. input to IniMaint, SysMaint or MultiMaint will be accepted and the
  3528. Wait Pointer will be displayed.  However, the PM Message
  3529. Queue will not be blocked so the user can switch away from IniMaint,
  3530. SysMaint or MultiMaint during this process.  The default for this
  3531. Option is No.
  3532.  
  3533.  
  3534. Help for Options Display Compare Box
  3535.  
  3536. The Display Compare Box Option controls whether
  3537. IniMaint, SysMaint or MultiMaint will Display a box saying that a
  3538. Compare  is in progress.  During the filling of the
  3539. Compare File Listbox  no user input to IniMaint, SysMaint
  3540. or MultiMaint will be accepted and the Wait Pointer  will
  3541. be displayed.  However, the PM Message Queue will not be blocked so
  3542. the user can switch away from IniMaint, SysMaint or MultiMaint during
  3543. this process.  The default for this Option is No.
  3544.  
  3545.  
  3546. Help for Options Display Compare Files Write or Print Box
  3547.  
  3548. The Display Compare Files Write or Print Box Option
  3549. controls whether IniMaint, SysMaint or MultiMaint will Display a box
  3550. saying that a Compare Files Write or Print is in
  3551. progress.  Until the operation is completed no user input to
  3552. IniMaint, SysMaint or MultiMaint will be accepted and the Wait
  3553. Pointer will be displayed.  However, the PM Message Queue will
  3554. not be blocked so the user can switch away from IniMaint, SysMaint or
  3555. MultiMaint during this process.  The default for this Option is 
  3556. No.
  3557.  
  3558.  
  3559. Help for Options Display Repair Box
  3560.  
  3561. The Display Repair Box Option controls whether
  3562. IniMaint, SysMaint or MultiMaint will Display a box saying that a
  3563. Repair  is in progress.  During the execution of the
  3564. Repair File Function  no user input to IniMaint, SysMaint
  3565. or MultiMaint will be accepted and the Wait Pointer  will
  3566. be displayed.  However, the PM Message Queue will not be blocked so
  3567. the user can switch away from IniMaint, SysMaint or MultiMaint during
  3568. this process.  The default for this Option is No.
  3569.  
  3570. ************************************************************************
  3571. ************************************************************************
  3572. ************SELECT GROUPS DIALOG****************************************
  3573. ************************************************************************
  3574. ************************************************************************
  3575. ************************************************************************
  3576.  
  3577. Help for Select Group Dialog
  3578.  
  3579. The Select Group Dialog will display a set of choices for an
  3580. IniMaint operation that can be performed on the Entire File, a
  3581. Single Application, or a Group.  The options will
  3582. include the Groups, if there are any defined and an entry for
  3583. All Groups if there is more then one Group.
  3584.  
  3585. It is not possible to directly invoke this Dialog, it is
  3586. automatically called whenever some action is taken that requires the
  3587. user to select a Group.
  3588.  
  3589.  
  3590. Help for Select Group Group Listing
  3591.  
  3592. The Group Listing box will list all of the valid choices for
  3593. the selected IniMaint operation.  As soon as any one of the items in the box
  3594. are selected by clicking on them with the mouse, the IniMaint operation will
  3595. start using the selected choice.
  3596.  
  3597. It is not possible to directly invoke this Window, it is
  3598. automatically called whenever some action is taken that requires the
  3599. user to select a Group.
  3600.  
  3601. ************************************************************************
  3602. ************************************************************************
  3603. ***************GET STRING DIALOG****************************************
  3604. ************************************************************************
  3605. ************************************************************************
  3606. ************************************************************************
  3607.  
  3608. Help for Get Value or String Dialog
  3609.  
  3610. The Get Value or String Dialog is used to obtain any
  3611. Numberic or Character information that is needed from
  3612. the user.
  3613.  
  3614.  
  3615. Help for Get Value or String Data Entry Area
  3616.  
  3617. The Data Entry Area is where the requested information is
  3618. entered by the user.
  3619.  
  3620. ************************************************************************
  3621. ************************************************************************
  3622. ****************** GROUPS DIALOG****************************************
  3623. ************************************************************************
  3624. ************************************************************************
  3625. ************************************************************************
  3626.  
  3627. Help for Groups Dialog
  3628.  
  3629. The Groups Dialog contains a Listbox with all the 
  3630. Applications for the Current INI file.  Any of the 
  3631. Applications that are selected are included in the
  3632. Group  whose name is in the Title of the Dialog.  The
  3633. Groups menu item allows the user to change the
  3634. Group currently being shown and to add a new
  3635. Group.  A single Application can belong to more
  3636. than one Group.  Applications are added to or
  3637. removed from a specific Group by Selecting or Deselecting
  3638. the Application.
  3639.  
  3640.  
  3641. Help for Groups Application Listing
  3642.  
  3643. The Groups Listbox lists all Applications in
  3644. the Current INI file with every member of the Group whose
  3645. name is in the Title selected.
  3646.  
  3647. If the Group currently being displayed is All, then the
  3648. Applications selected are the Applications that are in any Group.
  3649. Therefore, any Application that is not selected, is not in any Group.
  3650. When in this mode, any Application that is deselected will be removed
  3651. from all Groups that it is a member of.  If an Application is
  3652. selected, the user will be asked which Group they want the
  3653. Application added to, unless there is only one Group defined, in
  3654. which case it will be added to that Group.
  3655.  
  3656.  
  3657. Help for Groups Add Group
  3658.  
  3659. The Add Group selection gives the user the ability to add
  3660. a new Group to the Current INI file.  The user will be prompted
  3661. for a Group Name, the new Group will become the current Group and
  3662. the user can then add Applications to the Group by
  3663. selecting them.
  3664.  
  3665.  
  3666. Help for Groups Delete Group
  3667.  
  3668. The Delete Group selection gives the user the ability to
  3669. delete a Group from those defined for the Current INI file.
  3670.  
  3671. ************************************************************************
  3672. ************************************************************************
  3673. ************************************************************************
  3674. **********************FIND DIALOG***************************************
  3675. ************************************************************************
  3676. ************************************************************************
  3677. ************************************************************************
  3678.  
  3679. Help for Find Dialog
  3680.  
  3681. The Find Dialog will allow the user to do a number of different
  3682. Finds.  The current Application and Key Listboxes and Key Value MLE can be
  3683. searched, or the search can be extended to all the Key Values in an
  3684. Application or the entire current INI file.
  3685.  
  3686.  
  3687. Help for Find Text
  3688.  
  3689. The Find Text is the text that will be used to do the next
  3690. Find.  The text will be displayed in Ascii or Hex format, depending on the
  3691. format the user has selected.  When doing a Find on Application Name or Key
  3692. Name, only Ascii text is valid.
  3693.  
  3694.  
  3695. Help for Find from Beginning
  3696.  
  3697. The Find from Beginning button causes the Find to start from
  3698. the beginning of the Listbox, MLE, or file, depending on which Find is
  3699. requested.
  3700.  
  3701. Help for Find from Current
  3702.  
  3703. The Find from Current button causes the Find to start from
  3704. the current position in the Listbox, MLE, or file, depending on which Find is
  3705. requested.
  3706.  
  3707. Help for Repeat Find
  3708.  
  3709. The Repeat Find button causes the previous Find to be
  3710. repeated.  This option will ignore any changes made in the Find Text
  3711. Entryfield and will use the same field as the previous find.
  3712.  
  3713.  
  3714. Help for Ascii Find Text
  3715.  
  3716. The Ascii Find Text button causes the Find text field to
  3717. be displayed in Ascii format.  This is the only valid format for all Finds
  3718. for Application and Key names.
  3719.  
  3720.  
  3721. Help for Hex Find Text
  3722.  
  3723. The Hex Find Text button causes the Find text field to
  3724. be displayed in Hex format.  This is format is not valid for Finds
  3725. on Application and Key names.
  3726.  
  3727.  
  3728. Help for Case Sensitive
  3729.  
  3730. The Case Sensitive checkbox causes the Find to be case
  3731. sensitive.  If this box is not checked, then the Find will force all fields
  3732. to upper case before doing a compare.  This option does not apply to Hex
  3733. text format searches.
  3734.  
  3735.  
  3736. Help for Global Find Text
  3737.  
  3738. The Global Find Text checkbox causes the Find text to be
  3739. copied to the Default Find Text for all other Finds of the same
  3740. type.  For example, if this Find is for a Key Value, then if this item is
  3741. selected and the FIND Button is selected, the text for this Find will become
  3742. the text for all Key Value Finds.  If this checkbox is not selected, then the
  3743. text for this Find will only be copied to the other finds of the same type
  3744. if the other Finds have no current search text.
  3745.  
  3746. ************************************************************************
  3747. ************************************************************************
  3748. ************************************************************************
  3749. ********************COMPARE DIALOG**************************************
  3750. ************************************************************************
  3751. ************************************************************************
  3752. ************************************************************************
  3753.  
  3754. Help for Compare Files Dialog
  3755.  
  3756. The Compare Files Dialog will allow the user to compare two
  3757. INI files on any of three different levels of detail.
  3758.  
  3759.  
  3760. Help for Source INI File
  3761.  
  3762. The Source INI File is the INI File that will be used as the
  3763. Source INI File.
  3764.  
  3765.  
  3766. Help for Target INI File
  3767.  
  3768. The Target INI File is the INI File that will be used as the
  3769. Target INI File.
  3770.  
  3771.  
  3772. Help for Application Level Compare
  3773.  
  3774. The Application Level Compare selection will cause the
  3775. Listbox to contain a list of any Application Name that is in one of
  3776. the Compare Files but not in the other.
  3777.  
  3778.  
  3779. Help for Key Name Level Compare
  3780.  
  3781. The Key Name Level Compare selection will cause the
  3782. Listbox to contain a list of any Application Name that is in one of
  3783. the Compare Files but not in the other.  In addition it will list any
  3784. Key Name that is in an Application that is common to the two files,
  3785. but where the Key Name is missing from one of the files.
  3786.  
  3787.  
  3788. Help for Key Value Level Compare
  3789.  
  3790. The Key Value Level Compare selection will cause the
  3791. Listbox to contain a list of any Application Name that is in one of
  3792. the Compare Files but not in the other.  It will also list any Key
  3793. Name that is in an Application that is common to the two files, but
  3794. where the Key Name is missing from one of the files.  Finally, it
  3795. will list any situation where the Application and Key Names are in
  3796. both files, but the Key Values are not equal.
  3797.  
  3798.  
  3799. Help for New Target File
  3800.  
  3801. Selecting New Target File will cause the File Selection
  3802. Dialog to appear and ask for a New Target File.  If a new file
  3803. is selected, it will become the current Target File and the Listbox will
  3804. be filled with the appropriate level compare entries for this file and
  3805. the current Source File.
  3806.  
  3807.  
  3808. Help for Write
  3809.  
  3810. Selecting Write will cause the Write Options Dialog to
  3811. appear allowing the user to decide what he wants to Write.  If OK is
  3812. selected and the user has chosen to Write any data, the requested data
  3813. will then be written to the chosen files.
  3814.  
  3815.  
  3816. Help for Print
  3817.  
  3818. Selecting Print will cause the contents of the Listbox to
  3819. be printed.  The printing is done in a separate thread, so that the message
  3820. queue is not blocked.  However, the Compare Dialog cannot be dismissed until
  3821. the Print is finished, since dismissing the Dialog will cause the memory
  3822. allocated to hold the Listbox items to be released.
  3823.  
  3824. ************************************************************************
  3825. ************************************************************************
  3826. ************************************************************************
  3827. ****************COMPARE WRITE OPTIONS DIALOG****************************
  3828. ************************************************************************
  3829. ************************************************************************
  3830. ************************************************************************
  3831.  
  3832. Help for Compare Files Write Options Dialog
  3833.  
  3834. The Compare Files Write Options Dialog will allow the user to
  3835. select the type(s) of writes and which files they want to use for the
  3836. Writing.
  3837.  
  3838.  
  3839. Help for Write INI File
  3840.  
  3841. The Write INI File is the INI file that will be used as the
  3842. output INI file for all of the write options except the Write Listbox.  This
  3843. must be a valid INI file.  If the file does not exist, a valid INI file will
  3844. be created using the filename.  If the INI file does exist, then the selected
  3845. INI write items will be added to those already in the INI file if they do
  3846. not already exist there and replace those items that do exist.
  3847.  
  3848.  
  3849. Help for Select New Write INI File
  3850.  
  3851. Select the Select New Write INI File checkbox to cause the New
  3852. File Dialog to be displayed asking for the name of the Write INI file.  Once
  3853. the new file is selected and validated as an INI file or created, it will
  3854. be displayed as the Write INI file.
  3855.  
  3856.  
  3857. Help for Write Listbox File
  3858.  
  3859. The Write Listbox File is the Ascii file that will be
  3860. used as the output file for the Write Listbox selection.  If the file
  3861. does not exist, a valid Listbox file will be created using the
  3862. filename.  If the file does exist, then the current contents of the
  3863. file will be replaced by the contents of the Listbox.
  3864.  
  3865.  
  3866. Help for Select New Write Listbox File
  3867.  
  3868. Select the Select New Write Listbox File checkbox to
  3869. cause the New File Dialog to be displayed asking for the name of the
  3870. Write Listbox file.  Once the new file is selected and validated as a
  3871. valid filename, it will be displayed as the Write Listbox file.
  3872.  
  3873.  
  3874. Help for Write from Source INI File
  3875.  
  3876. Select Write from Source INI File to cause the Source INI
  3877. File to be used as the source for the INI entries that will be written
  3878. to the output INI file.  For example, if Write Missing Applications is one
  3879. of the chosen options and this item is selected, then the output INI file
  3880. will contain all Applications that are in the Source INI File but not in
  3881. the Target File.
  3882.  
  3883.  
  3884. Help for Write from Target INI File
  3885.  
  3886. Select Write from Target INI File to cause the Target INI
  3887. File to be used as the source for the INI entries that will be written
  3888. to the output INI file.  For example, if Write Missing Applications is one
  3889. of the chosen options and this item is selected, then the output INI file
  3890. will contain all Applications that are in the Target INI File but not in
  3891. the Source File.
  3892.  
  3893.  
  3894. Help for Write Missing Applications
  3895.  
  3896. Select Write Missing Applications to cause Applications
  3897. which are in one INI file, but not in the other, to be written to the
  3898. output INI File.  Which Applications are written depends on whether
  3899. the Source or Target INI file was chosen as the Write From file.
  3900.  
  3901.  
  3902. Help for Write Missing Key Names
  3903.  
  3904. Select Write Missing Key Names to cause Key Names which
  3905. are in one INI file, but not in the other, to be written to the output INI
  3906. File.  Which Key Names are written depends on whether the Source or Target
  3907. INI file was chosen as the Write From file.
  3908.  
  3909. In order for a Key Name to be considered a missing Key Name, the 
  3910. Application must be in both the Source and the Target INI files, but the
  3911. specific Key Name missing from one or the other.
  3912.  
  3913. If this Write option is selected, but the Compare level is
  3914. Application, then there cannot be entries in the Listbox that would
  3915. qualify for this Write.  In this case, this option would have no effect.
  3916.  
  3917.  
  3918. Help for Write Unequal Key Values
  3919.  
  3920. Select Write Unequal Key Values to cause Key Values for any
  3921. Application Key Name pair that is in both files but have Key Values that
  3922. are not the same, to be written to the output INI
  3923. File.  Which Key Values are written depends on whether the Source or Target
  3924. INI file was chosen as the Write From file.
  3925.  
  3926. If this Write option is selected, but the Compare level is
  3927. Application or Key Name, then there cannot be entries in the Listbox
  3928. that would qualify for this Write.  In this case, this option would have
  3929. no effect.
  3930.  
  3931.  
  3932. Help for Write Selected Items
  3933.  
  3934. Select Write Selected Items to cause an entry to be written
  3935. to the output INI file for each item in the Listbox that has been
  3936. highlighted.  In this case, the Write From file will only apply to those
  3937. items that list Unequal Key Values, in which case, the Key Value in the
  3938. Write From file will be the one that is written to the output INI file.
  3939.  
  3940. If there are no items highlighted in the Compare Listbox, then this
  3941. option will have no effect, since there are no selected entries.
  3942.  
  3943.  
  3944. Help for Write Listbox Contents
  3945.  
  3946. Select Write Listbox Contents to cause the contents of the
  3947. Listbox to be written to a File.  In this case, the output file is not an
  3948. INI file, but a flat Ascii File that contains one line for every entry in
  3949. the Compare Files Listbox.
  3950.  
  3951. ************************************************************************
  3952. ************************************************************************
  3953. ************************************************************************
  3954. ********************REPAIR DIALOG***************************************
  3955. ************************************************************************
  3956. ************************************************************************
  3957. ************************************************************************
  3958.  
  3959. Help for Repair File Dialog
  3960.  
  3961. The Repair File Dialog will allow the user to Repair the Current
  3962. INI File.
  3963.  
  3964.  
  3965. Help for Save INI File
  3966.  
  3967. The Save INI File is the INI File that will be used to hold
  3968. any entries from the Source INI file that are changed or deleted during the
  3969. Repair process.  It is possible to bypass saving the removed items via the
  3970. Options Dialog.
  3971.  
  3972.  
  3973. Help for Select New Save INI File
  3974.  
  3975. Select the Select New Save INI File checkbox to cause the New
  3976. File Dialog to be displayed asking for the name of the Save INI file.  Once
  3977. the new file is selected and validated as an INI file or created, it will
  3978. be displayed as the Save INI file.
  3979.  
  3980.  
  3981. Help for Write Window File
  3982.  
  3983. The Write Window File is the Ascii file that will be
  3984. used as the output file for the Write selection.  If the file does
  3985. not exist, a valid file will be created using the filename.  If the
  3986. file does exist, then the current contents of the file will be
  3987. replaced by the contents of the Window.
  3988.  
  3989.  
  3990. Help for Select New Write File
  3991.  
  3992. Select the Select New Write File checkbox to cause the
  3993. New File Dialog to be displayed asking for the name of the Write file.
  3994. Once the new file is selected and validated as a valid filename, it will
  3995. be displayed as the Write file.
  3996.  
  3997.  
  3998. Help for Report Only
  3999.  
  4000. The Report Only selection will cause the Window
  4001. to contain a list of any Repair that would have been made based on the
  4002. Repair Checks chosen and the contents of the INI file.  No actual changes
  4003. will be made to the INI file.
  4004.  
  4005.  
  4006. Help for Ask First
  4007.  
  4008. The Ask First selection will cause the next Repair
  4009. to find an situation that needs to be Repaired.  Once the condition is 
  4010. identified, the user will be asked if he wants the Repair done.  If the
  4011. response is No, then no Repair will be done and an entry will be
  4012. added to the Window saying that a Repair is needed.  If the response is
  4013. Yes then the Repair will be done.
  4014.  
  4015.  
  4016. Help for Do Repair
  4017.  
  4018. The Do Repair selection will cause the next Repair
  4019. to find all appropriate items that need to be Repaired.
  4020. Once the condition is identified, the Repair will be done.
  4021. The user will not be asked if he wants each
  4022. Repair to be done, all requested repairs will be done automatically.
  4023.  
  4024.  
  4025. Help for Do Selected
  4026.  
  4027. The Do Selected selection will repair those items that
  4028. have been selected by the user.  If a selected item has dependent items,
  4029. then the dependent items will be repaired also.  For example, if a directory
  4030. is selected for repair, then all files in the directory, any
  4031. subdirectories and any files in those subdirectories will also be
  4032. repaired.
  4033.  
  4034.  
  4035. Help for Repair Item Window
  4036.  
  4037. The Repair Item Window contains the list of Items that
  4038. will be Repaired if Do Repair or Ask First are checked.  If Do
  4039. Selected is checked, then only those items in the Window that are
  4040. highlighted will be Repaired.  If Report Only is checked, then the
  4041. window is simply a list of the items that satisfied the last type of
  4042. Repair that was requested.
  4043.  
  4044.  
  4045. Help for Write
  4046.  
  4047. Selecting Write will cause the contents of the Window
  4048. to be written to the Write File.
  4049.  
  4050.  
  4051. Help for Options
  4052.  
  4053. Selecting Options will cause Repair Options Dialog
  4054. to be displayed.
  4055.  
  4056.  
  4057. Help for Print
  4058.  
  4059. Selecting Print will cause the contents of the Window to
  4060. be printed.  The printing is done in a separate thread, so that the message
  4061. queue is not blocked.  However, the Repair Dialog cannot be dismissed until
  4062. the Print is finished, since dismissing the Dialog will cause the memory
  4063. allocated to hold the Window items to be released.
  4064.  
  4065.  
  4066. Help for Execute
  4067.  
  4068. Selecting Execute will cause the actual repair action to
  4069. start.  All Checks that the user has selected will be made
  4070. and the action taken will depend on the Type that has been
  4071. selected.  Every Repair action will cause a line of information to be
  4072. added to the Window.
  4073.  
  4074. ************************************************************************
  4075. ************************************************************************
  4076. ************************************************************************
  4077. ********************REPAIR TYPES****************************************
  4078. ************************************************************************
  4079. ************************************************************************
  4080. ************************************************************************
  4081.  
  4082. Help for Do All WPS, PM and File Handle Repairs
  4083.  
  4084. The Do All WPS, PM and File Handle Repairs selection will cause
  4085. the next Repair Execution to do all of the WPS, PM and File Handle
  4086. Repair actions and is a short hand way to do all of these Repairs
  4087. with a single selection.  This selection currently includes Delete
  4088. Unused Printers, Repair Directory and File Handles, Repair WPS
  4089. Entries and Repair Both WPS and File Handle Entries.
  4090.  
  4091. These Repair functions are always done on the INI files in use by
  4092. OS/2 at the time and are independent of the current INI file.  In
  4093. other words, this Repair action will always be the same, no matter
  4094. what INI file is currently being worked on.
  4095.  
  4096. Whether the entries are removed or reported, depends on which 
  4097. Repair Type of button the user has chosen.
  4098.  
  4099. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4100. handles is determined by the selections in the Repair Options Dialog.
  4101.  
  4102. The WPS Repair selections can take a considerable amount of time to
  4103. actually fill the Repair Window.  The reason for this is because both the
  4104. Handles and Objects structures must be filled before the analysis of the
  4105. WPS entries in the INI files can start.
  4106.  
  4107.  
  4108. Help for Do All Individual INI File Repairs
  4109.  
  4110. The Do All Individual INI File Repairs selection will cause
  4111. the next Repair Execution to do all of the Repair actions that are
  4112. specific to the currently selected INI file and is a short hand way to 
  4113. do all of these Repairs with a single selection. The Repairs that are
  4114. currently included in this group are the Check Path and File Names
  4115. and Look for Zero Length Key Values.  These Repairs are always done
  4116. on the current INI file, as opposed to those that are always done on
  4117. the INI Files currently being used by OS/2.
  4118.  
  4119. Whether the entries are removed or reported, depends on which 
  4120. Repair Type of button the user has chosen.
  4121.  
  4122. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4123. handles is determined by the selections in the Repair Options Dialog.
  4124.  
  4125. The WPS Repair selections can take a considerable amount of time to
  4126. actually fill the Repair Window.  The reason for this is because both the
  4127. Handles and Objects structures must be filled before the analysis of the
  4128. WPS entries in the INI files can start.
  4129.  
  4130.  
  4131. Help for Check Path and FileNames
  4132.  
  4133. The Check Path and FileNames selection will cause the
  4134. next Repair Execution to find every Key Name or Key Value in the
  4135. Current INI File that is a path or filename, compare it to
  4136. the actual paths and filenames on the various hardrives and remove or
  4137. report any entries that are not found on the harddisk.
  4138.  
  4139. Whether the entries
  4140. are removed or reported, depends on which Repair Type of button the user
  4141. has chosen.
  4142.  
  4143.  
  4144. Help for Look For Zero Length Key Values
  4145.  
  4146. The Look For Zero Length Key Values selection will cause the
  4147. next Repair Execution to look for any entries in the 
  4148. Current INI File that have a zero length key value.  This is a
  4149. condition which should never occur, but has been seen from time to time
  4150. in some INI files.  Normally, when an entry is written to an INI file with
  4151. a zero length key, the entry is deleted by the INI file code.
  4152.  
  4153. Whether the entries
  4154. are removed or reported, depends on which Repair Type of button the user
  4155. has chosen.
  4156.  
  4157.  
  4158. Help for Remove Old PM_ProgramList Entries
  4159.  
  4160. The Remove Old PM_ProgramList Entries selection will cause the
  4161. PM_ProgramListxxx Entries from the OS2.INI file to be displayed.
  4162. These entries are a leftover from V1.3 and V2.0 and are no longer
  4163. needed.  However, if these entries remain in the file, any Objects
  4164. referenced by these entries cannot be deleted.  If it is deleted, it
  4165. will reappear as soon as the Folder that contained the Object is
  4166. reopened.
  4167.  
  4168. These Repair functions are always done on the INI files in use by
  4169. OS/2 at the time and are independent of the current INI file.  In
  4170. other words, this Repair action will always be the same, no matter
  4171. what INI file is currently being worked on.
  4172.  
  4173. Whether the entries
  4174. are removed or reported, depends on which Repair Type of button the user
  4175. has chosen.
  4176.  
  4177.  
  4178. Help for Delete Unused Printer Entries
  4179.  
  4180. The Delete Unused Printer Entries selection will cause the
  4181. Printer entries from the OS2SYS.INI file that are no longer OBjects
  4182. on the Desktop to be displayed.  These entries are not really an
  4183. operational problem, however, they are not removed from the file when
  4184. the Printer Object is deleted and there are a number of PM
  4185. Applications that look in the OS2SYS.INI file to obtain the Printer
  4186. information and these Applications will treat these entries as real
  4187. Printers.  However, any attempt to Print to the entries will not work.  
  4188.  
  4189. These Repair functions are always done on the INI files in use by
  4190. OS/2 at the time and are independent of the current INI file.  In
  4191. other words, this Repair action will always be the same, no matter
  4192. what INI file is currently being worked on.
  4193.  
  4194. Whether the entries
  4195. are removed or reported, depends on which Repair Type of button the user
  4196. has chosen.
  4197.  
  4198.  
  4199. Help for Display Valid Dir/File Handles
  4200.  
  4201. The Display Valid Dir/File Handles selection will
  4202. cause the next Repair Execution to analyze the active PM_Workplace
  4203. Handles entry in the OS2SYS.INI file, compare each Drive, Directory
  4204. and Filename entry to the actual contents of the appropriate drive
  4205. and place all valid entries into the Repair Window.
  4206.  
  4207. The only type of Repair that is valid when listing items is the 
  4208. Report Only button.
  4209.  
  4210. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  4211. determined by the selections in the Repair Options Dialog.
  4212.  
  4213.  
  4214. Help for Display Invalid Dir/File Handles
  4215.  
  4216. The Display Invalid Dir/File Handles selection will
  4217. cause the next Repair Execution to analyze the active PM_Workplace
  4218. Handles entry in the OS2SYS.INI file, compare each Drive, Directory
  4219. and Filename entry to the actual contents of the appropriate drive
  4220. and place all invalid entries into the Repair Window.
  4221.  
  4222. The only type of Repair that is valid when listing items is the 
  4223. Report Only button.
  4224.  
  4225. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  4226. determined by the selections in the Repair Options Dialog.
  4227.  
  4228.  
  4229. Help for Display All Dir/File Handles
  4230.  
  4231. The Display All Dir/File Handles selection will
  4232. cause the next Repair Execution to analyze the active PM_Workplace
  4233. Handles entry in the OS2SYS.INI file, compare each Drive, Directory
  4234. and Filename entry to the actual contents of the appropriate drive
  4235. and place all entries into the Repair Window with an identification
  4236. as to which are valid and which are invalid.
  4237.  
  4238. The only type of Repair that is valid when listing items is the 
  4239. Report Only button.
  4240.  
  4241. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  4242. determined by the selections in the Repair Options Dialog.
  4243.  
  4244.  
  4245. Help for Repair Dir/File Handles
  4246.  
  4247. The Repair Dir/File Handles selection will cause the
  4248. next Repair Execution to
  4249. analyze the active PM_Workplace Handles entry in the OS2SYS.INI file,
  4250. compare each Drive, Directory and Filename entry to the actual contents
  4251. of the appropriate drive, place all invalid entries into the Repair
  4252. Window and do the Repair action specified by the Type of Repair button.
  4253.  
  4254. These Repair functions are always done on the INI files in use by
  4255. OS/2 at the time and are independent of the current INI file.  In
  4256. other words, this Repair action will always be the same, no matter
  4257. what INI file is currently being worked on.
  4258.  
  4259. Whether the entries
  4260. are removed or reported, depends on which Repair Type of button the user
  4261. has chosen.
  4262.  
  4263. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drives is
  4264. determined by the selections in the Repair Options Dialog.
  4265.  
  4266.  
  4267. Help for Display Objects
  4268.  
  4269. The Display Objects selection will cause the
  4270. next Repair Execution to
  4271. analyze the PM_Abstract Objects entry in the OS2.INI file,
  4272. and place all entries into the Repair
  4273. Window.  There is no automatic way to validate the Objects, so it is
  4274. assumed that they are all valid.
  4275.  
  4276. The only type of Repair that is valid when listing items is the 
  4277. Report Only button.
  4278.  
  4279.  
  4280. Help for Destroy Objects
  4281.  
  4282. The Destroy Objects selection will cause the
  4283. next Repair Execution to
  4284. analyze the PM_Abstract Objects entry in the OS2.INI file,
  4285. and place all entries into the Repair
  4286. Window.  There is no automatic way to validate the Objects, so it is
  4287. assumed that they are all valid, therefore, the Do Repair button will
  4288. not delete anything from the Repair Window.  The items can be deleted
  4289. by Selecting individual items.  Extreme care must be taken before deleting
  4290. any Objects as it can cause problems with the Desktop.
  4291.  
  4292. These Repair functions are always done on the INI files in use by
  4293. OS/2 at the time and are independent of the current INI file.  In
  4294. other words, this Repair action will always be the same, no matter
  4295. what INI file is currently being worked on.
  4296.  
  4297.  
  4298. Help for Restore Missing Location Entries
  4299.  
  4300. The Restore Missing Location Entries selection will
  4301. examine each of the entries in the PM_Abstract:Objects entry in
  4302. the OS2.INI file looking for Location information.  If the Location
  4303. information is found, then the PM_WorkPlace:Location entry will
  4304. be checked to see if the location is listed.  If the Location is
  4305. listed then the Object Name and the Location will be added to the
  4306. Repair window.
  4307.  
  4308. These Repair functions are always done on the INI files in use by
  4309. OS/2 at the time and are independent of the current INI file.  In
  4310. other words, this Repair action will always be the same, no matter
  4311. what INI file is currently being worked on.
  4312.  
  4313. Whether the entries are fixed or reported, depends on which Repair
  4314. Type of button the user has chosen.
  4315.  
  4316.  
  4317. Help for Display Valid WPS Entries
  4318.  
  4319. The Display Valid WPS Entries selection will cause the
  4320. next Repair Execution to
  4321. analyze the various WPS entries in the OS2.INI file,
  4322. validate the value range for each one,
  4323. compare each to the Handles or Objects structure
  4324. and place all valid entries into the Repair
  4325. Window.
  4326.  
  4327. The only type of Repair that is valid when listing items is the 
  4328. Report Only button.
  4329.  
  4330. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4331. handles is determined by the selections in the Repair Options Dialog.
  4332.  
  4333. The WPS Repair selections can take a considerable amount of time to
  4334. actually fill the Repair Window.  The reason for this is because both the
  4335. Handles and Objects structures must be filled before the analysis of the
  4336. WPS entries in the INI files can start.
  4337.  
  4338.  
  4339. Help for Display Invalid WPS Entries
  4340.  
  4341. The Display Invalid WPS Entries selection will cause the
  4342. next Repair Execution to
  4343. analyze the various WPS entries in the OS2.INI file,
  4344. validate the value range for each one,
  4345. compare each to the Handles or Objects structure
  4346. and place all invalid entries into the Repair
  4347. Window with an notation as to why they are not valid.
  4348.  
  4349. The only type of Repair that is valid when listing items is the 
  4350. Report Only button.
  4351.  
  4352. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4353. handles is determined by the selections in the Repair Options Dialog.
  4354.  
  4355. The WPS Repair selections can take a considerable amount of time to
  4356. actually fill the Repair Window.  The reason for this is because both the
  4357. Handles and Objects structures must be filled before the analysis of the
  4358. WPS entries in the INI files can start.
  4359.  
  4360.  
  4361. Help for Display All WPS Entries
  4362.  
  4363. The Display All WPS Entries selection will cause the
  4364. next Repair Execution to
  4365. analyze the various WPS entries in the OS2.INI file,
  4366. validate the value range for each one,
  4367. compare each to the Handles or Objects structure
  4368. and place all entries into the Repair
  4369. Window with an notation as to whether each item is valid or invalid.
  4370. For the invalid items there will also be a notation as to why they are
  4371. not valid.
  4372.  
  4373. The only type of Repair that is valid when listing items is the 
  4374. Report Only button.
  4375.  
  4376. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4377. handles is determined by the selections in the Repair Options Dialog.
  4378.  
  4379. The WPS Repair selections can take a considerable amount of time to
  4380. actually fill the Repair Window.  The reason for this is because both the
  4381. Handles and Objects structures must be filled before the analysis of the
  4382. WPS entries in the INI files can start.
  4383.  
  4384.  
  4385. Help for Repair WPS Entries
  4386.  
  4387. The Repair WPS Entries selection will cause the
  4388. next Repair Execution to
  4389. analyze the various WPS entries in the OS2.INI file,
  4390. validate the value range for each one,
  4391. compare each to the Handles or Objects structure,
  4392. place all invalid entries into the Repair
  4393. Window with an notation as to why they are not valid
  4394. and do the Repair action specified by the Type of Repair button.
  4395.  
  4396. These Repair functions are always done on the INI files in use by
  4397. OS/2 at the time and are independent of the current INI file.  In
  4398. other words, this Repair action will always be the same, no matter
  4399. what INI file is currently being worked on.
  4400.  
  4401. Whether the entries
  4402. are removed or reported, depends on which Repair Type of button the user
  4403. has chosen.
  4404.  
  4405. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4406. handles is determined by the selections in the Repair Options Dialog.
  4407.  
  4408. The WPS Repair selections can take a considerable amount of time to
  4409. actually fill the Repair Window.  The reason for this is because both the
  4410. Handles and Objects structures must be filled before the analysis of the
  4411. WPS entries in the INI files can start.
  4412.  
  4413.  
  4414. Help for Display All Valid WPS and Handle Entries
  4415.  
  4416. The Display All Valid WPS and Handle Entries selection
  4417. will cause the next Repair Execution to analyze the active
  4418. PM_Workplace Handles entry in the OS2SYS.INI file, compare each
  4419. Drive, Directory and Filename entry to the actual contents of the
  4420. appropriate drive and analyze the various WPS entries in the OS2.INI
  4421. file, validate the value range for each one, compare each to the
  4422. Handles or Objects structure and place all valid entries into the
  4423. Repair Window.
  4424.  
  4425. The only type of Repair that is valid when listing items is the 
  4426. Report Only button.
  4427.  
  4428. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4429. handles is determined by the selections in the Repair Options Dialog.
  4430.  
  4431. The WPS Repair selections can take a considerable amount of time to
  4432. actually fill the Repair Window.  The reason for this is because both the
  4433. Handles and Objects structures must be filled before the analysis of the
  4434. WPS entries in the INI files can start.
  4435.  
  4436.  
  4437. Help for Display All Invalid WPS and Handle Entries
  4438.  
  4439. The Display All Invalid WPS and Handle Entries selection
  4440. will cause the next Repair Execution to analyze the active
  4441. PM_Workplace Handles entry in the OS2SYS.INI file, compare each
  4442. Drive, Directory and Filename entry to the actual contents of the
  4443. appropriate drive and analyze the various WPS entries in the OS2.INI
  4444. file, validate the value range for each one, compare each to the
  4445. Handles or Objects structure and place all invalid entries into the
  4446. Repair Window with an notation as to why they are not valid.
  4447.  
  4448. The only type of Repair that is valid when listing items is the 
  4449. Report Only button.
  4450.  
  4451. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4452. handles is determined by the selections in the Repair Options Dialog.
  4453.  
  4454. The WPS Repair selections can take a considerable amount of time to
  4455. actually fill the Repair Window.  The reason for this is because both the
  4456. Handles and Objects structures must be filled before the analysis of the
  4457. WPS entries in the INI files can start.
  4458.  
  4459.  
  4460. Help for Display All WPS and Handle Entries
  4461.  
  4462. The Display All WPS and Handle Entries selection will
  4463. cause the next Repair Execution to analyze the active PM_Workplace
  4464. Handles entry in the OS2SYS.INI file, compare each Drive, Directory
  4465. and Filename entry to the actual contents of the appropriate drive
  4466. and analyze the various WPS entries in the OS2.INI file, validate the
  4467. value range for each one, compare each to the Handles or Objects
  4468. structure and place all entries into the Repair Window with an
  4469. notation as to whether each item is valid or invalid.  For the
  4470. invalid items there will also be a notation as to why they are not
  4471. valid.
  4472.  
  4473. The only type of Repair that is valid when listing items is the 
  4474. Report Only button.
  4475.  
  4476. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4477. handles is determined by the selections in the Repair Options Dialog.
  4478.  
  4479. The WPS Repair selections can take a considerable amount of time to
  4480. actually fill the Repair Window.  The reason for this is because both the
  4481. Handles and Objects structures must be filled before the analysis of the
  4482. WPS entries in the INI files can start.
  4483.  
  4484.  
  4485. Help for Repair Both WPS and Handle Entries
  4486.  
  4487. The Repair Both WPS and Handle Entries selection will
  4488. cause the next Repair Execution to analyze the active PM_Workplace
  4489. Handles entry in the OS2SYS.INI file, compare each Drive, Directory
  4490. and Filename entry to the actual contents of the appropriate drive
  4491. and analyze the various WPS entries in the OS2.INI file, validate the
  4492. value range for each one, compare each to the Handles or Objects
  4493. structure, place all invalid entries into the Repair Window with an
  4494. notation as to why they are not valid and do the Repair action
  4495. specified by the Type of Repair button.
  4496.  
  4497. These Repair functions are always done on the INI files in use by
  4498. OS/2 at the time and are independent of the current INI file.  In
  4499. other words, this Repair action will always be the same, no matter
  4500. what INI file is currently being worked on.
  4501.  
  4502. Whether the entries
  4503. are removed or reported, depends on which Repair Type of button the user
  4504. has chosen.
  4505.  
  4506. The handling of CD-ROM, Virtual Disk, Floppy and Not Ready Drive
  4507. handles is determined by the selections in the Repair Options Dialog.
  4508.  
  4509. The WPS Repair selections can take a considerable amount of time to
  4510. actually fill the Repair Window.  The reason for this is because both the
  4511. Handles and Objects structures must be filled before the analysis of the
  4512. WPS entries in the INI files can start.
  4513.  
  4514. ************************************************************************
  4515. ************************************************************************
  4516. ************************************************************************
  4517. ****************REPAIR OPTIONS DIALOG***********************************
  4518. ************************************************************************
  4519. ************************************************************************
  4520. ************************************************************************
  4521.  
  4522. Help for Repair Options Dialog
  4523.  
  4524. The Repair Options Dialog will allow the user to control various
  4525. options during the repair process.
  4526.  
  4527.  
  4528. Help for Bypass Known Errors
  4529.  
  4530. The Bypass Known Errors.LOG checkbox will cause the Repair
  4531. function to bypass entries that are known to IniMaint and will quickly
  4532. reappear even if they are deleted.
  4533.  
  4534. The default for this item is Yes.
  4535.  
  4536. Among the kinds of things bypassed are:
  4537.  
  4538. Temporary files with the extension of files are updated.
  4539.  
  4540. The zero entry in the Abstracts Icons Application generated by Deskman/2.
  4541.  
  4542. All entries in PM_Workplace:Locations for Objects with an Object
  4543. handle that indicates the Object is a WPTransient or derived Class
  4544. Object.  These Object Handles are in the 0x10000 to 0x1FFFF range.
  4545.  
  4546.  
  4547. Help for Do Not Save Deleted Items
  4548.  
  4549. The Do Not Save Deleted Items checkbox will cause the items
  4550. that are removed from an INI file to simply be deleted and not saved.  If this
  4551. option is chosen, then Repairs can be performed without specifying a
  4552. Save INI File.
  4553.  
  4554.  
  4555. Help for Ask Before Change Handles
  4556.  
  4557. The Ask Before Change Handles checkbox controls whether
  4558. the user is warned before the File Handle Structure in the OS2SYS.INI
  4559. file is updated.  Since modifying this structure can have a serious
  4560. effect on the Desktop, the user is normally warned about this before
  4561. they are allowed to make any changes.  However, experienced users
  4562. already understand the issues and do not want to be bothered with the
  4563. warning time after time, so this option allows them to turn it off.
  4564.  
  4565. The Default for this Option is Yes.
  4566.  
  4567.  
  4568. Help for Ask Before Destroy Objects
  4569.  
  4570. The Ask Before Destroy Objects checkbox controls whether
  4571. the user is warned before they are given a chance to manually destroy
  4572. and of the Objects on the Desktop.  Since destroying Objects can have
  4573. a serious effect on the Desktop and will result in the Desktop being
  4574. Reset, the user is normally warned about this before
  4575. they are allowed to make any changes.  However, experienced users
  4576. already understand the issues and do not want to be bothered with the
  4577. warning time after time, so this option allows them to turn off the
  4578. warning.
  4579.  
  4580. The Default for this Option is Yes.
  4581.  
  4582.  
  4583. Help for Log to INIREP.LOG
  4584.  
  4585. The Log to INIREP.LOG checkbox will cause diagnostic
  4586. information to be written to the INIREP.LOG file.  This should only be
  4587. used as part of a problem determination sequence, since the saved
  4588. information will make little sense without a knowledge of the program
  4589. internals.
  4590.  
  4591.  
  4592. Help for Ignore CD-ROM Handles
  4593.  
  4594. The Ignore CD-ROM Handles button will cause all
  4595. directories and files on CD-ROM drives to be ignored, even if
  4596. they are not valid.  This option would be used if the User normally
  4597. has a specific CD-ROM mounted and does not want to know if the
  4598. Handles in the OS2SYS.INI file agree with the directories and files
  4599. on the drive.
  4600.  
  4601.  
  4602. Help for Report CD-ROM Handles
  4603.  
  4604. The Report CD-ROM Handles button will cause all
  4605. directories and files on CD-ROM drives to be reported in the
  4606. Repair Window.  However, if the Do Repair button is
  4607. selected in the Repair Dialog, the invalid directories and files will
  4608. not be removed from the OS2SYS.INI file.  This option would be used
  4609. if the User wants to know about invalid Directories and Files on the
  4610. CD-ROM drive, but does not want them removed unless they are
  4611. specifically selected.
  4612.  
  4613.  
  4614. Help for Auto Repair CD-ROM Handles
  4615.  
  4616. The Auto Repair CD-ROM Handles button will cause
  4617. all directories and files on CD-ROM drives to be removed if the
  4618. Do Repair button is selected in the Repair Dialog.  This
  4619. is the Default selection.
  4620.  
  4621.  
  4622. Help for Ignore Virtual Disk Drive Handles
  4623.  
  4624. The Ignore Virtual Disk Drive Handles button will cause
  4625. all directories and files on Virtual Disk drives to be ignored, even
  4626. if they are not valid.  This option would be used if the User
  4627. normally has a specific Virtual Disk Drive and does not want to know
  4628. if the Handles in the OS2SYS.INI file agree with the directories and
  4629. files on the drive.
  4630.  
  4631.  
  4632. Help for Report Virtual Disk Drive Handles
  4633.  
  4634. The Report Virtual Disk Drive Handles button will cause
  4635. all directories and files on Virtual Disk drives to be reported in
  4636. the Repair Window.  However, if the Do Repair button is
  4637. selected in the Repair Dialog, the invalid directories and files will
  4638. not be removed from the OS2SYS.INI file.  This option would be used
  4639. if the User wants to know about invalid Directories and Files on the
  4640. Virtual Disk Drive, but does not want them removed unless they are
  4641. specifically selected.
  4642.  
  4643.  
  4644. Help for Auto Repair Virtual Disk Drive Handles
  4645.  
  4646. The Auto Repair Virtual Disk Drive Handles button will
  4647. cause all directories and files on Virtual Disk drives to be removed
  4648. if the Do Repair button is selected in the Repair Dialog. 
  4649. This is the Default selection.
  4650.  
  4651.  
  4652. Help for Ignore Floppy Drive Handles
  4653.  
  4654. The Ignore Floppy Drive Handles button will cause all
  4655. directories and files on Floppy drives to be ignored, even if they
  4656. are not valid.  This option would be used if the User normally has a
  4657. specific Floppy mounted and does not want to know if the Handles in
  4658. the OS2SYS.INI file agree with the directories and files on the
  4659. drive.
  4660.  
  4661.  
  4662. Help for Report Floppy Drive Handles
  4663.  
  4664. The Report Floppy Drive Handles button will cause all
  4665. directories and files on Floppy drives to be reported in the Repair
  4666. Window.  However, if the Do Repair button is selected in
  4667. the Repair Dialog, the invalid directories and files will not be
  4668. removed from the OS2SYS.INI file.  This option would be used if the
  4669. User wants to know about invalid Directories and Files on the Floppy
  4670. Drive, but does not want them removed unless they are specifically
  4671. selected.
  4672.  
  4673.  
  4674. Help for Auto Repair Floppy Drive Handles
  4675.  
  4676. The Auto Repair Floppy Drive Handles button will cause
  4677. all directories and files on Floppy drives to be removed if the
  4678. Do Repair button is selected in the Repair Dialog.  This
  4679. is the Default selection.
  4680.  
  4681.  
  4682. Help for Ignore Not Ready Drive Handles
  4683.  
  4684. The Ignore Not Ready Drive Handles button will cause all
  4685. directories and files on Not Ready drives to be ignored, even if they
  4686. are not valid.  This option would be used if the User has drives that
  4687. normally have specific volumes mounted, but are not currently ready, 
  4688. and does not want to see the Handles in the OS2SYS.INI file for the
  4689. drive.
  4690.  
  4691.  
  4692. Help for Report Not Ready Drive Handles
  4693.  
  4694. The Report Not Ready Drive Handles button will cause all
  4695. directories and files on Not Ready drives to be reported in the
  4696. Repair Window.  However, if the Do Repair button is
  4697. selected in the Repair Dialog, the invalid directories and files will
  4698. not be removed from the OS2SYS.INI file.  This option would be used
  4699. if the User wants to know about invalid Directories and Files on the
  4700. Not Ready drive, but does not want them removed unless they are
  4701. specifically selected.
  4702.  
  4703.  
  4704. Help for Auto Repair Not Ready Drive Handles
  4705.  
  4706. The Auto Repair Not Ready Drive Handles button will
  4707. cause all directories and files on Not Ready drives to be removed if
  4708. the Do Repair button is selected in the Repair Dialog. 
  4709. This is the Default selection.
  4710.  
  4711.  
  4712. Help for Ignore Network Type Handles
  4713.  
  4714. The Ignore Network Type Handles button will cause all
  4715. directories and files on Network Types to be ignored, even if they
  4716. are not valid.  This option would be used if the User normally has a
  4717. specific Network Entry and does not want to know if the Handles in
  4718. the OS2SYS.INI file agree with the directories and files.
  4719.  
  4720.  
  4721. Help for Report Network Type Handles
  4722.  
  4723. The Report Network Type Handles button will cause all
  4724. directories and files on Network Entry to be reported in the Repair
  4725. Window.  However, if the Do Repair button is selected in
  4726. the Repair Dialog, the invalid directories and files will not be
  4727. removed from the OS2SYS.INI file.  This option would be used if the
  4728. User wants to know about invalid Directories and Files, but does not
  4729. want them removed unless they are specifically selected.
  4730.  
  4731.  
  4732. Help for Auto Repair Network Type Handles
  4733.  
  4734. The Auto Repair Network Type Handles button will cause
  4735. all directories and files on Network Entry to be removed if the
  4736. Do Repair button is selected in the Repair Dialog.  This
  4737. is the Default selection.
  4738.  
  4739.  
  4740. Help for Ignore Unknown Drive Handles
  4741.  
  4742. The Ignore Unknown Drive Handles button will cause all
  4743. directories and files on Unknown drives to be ignored, even if they
  4744. are not valid.  This option would be used if the User has drives that
  4745. are identified by the Repair File Handle code as Unknown Drives and
  4746. does not want to see the Handles in the OS2SYS.INI file for the
  4747. drive.  This situation can occur with some of the newer VDISK Device
  4748. Drivers,
  4749.  
  4750.  
  4751. Help for Report Unknown Drive Handles
  4752.  
  4753. The Report Unknown Drive Handles button will cause all
  4754. directories and files on Unknown drives to be reported in the
  4755. Repair Window.  However, if the Do Repair button is
  4756. selected in the Repair Dialog, the directories and files will
  4757. not be removed from the OS2SYS.INI file.  This option would be used
  4758. if the User wants to know about invalid Directories and Files on the
  4759. Unknown drive, but does not want them removed unless they are
  4760. specifically selected.
  4761.  
  4762.  
  4763. Help for Auto Repair Unknown Drive Handles
  4764.  
  4765. The Auto Repair Unknown Drive Handles button will
  4766. cause all directories and files on Unknown drives to be removed if
  4767. the Do Repair button is selected in the Repair Dialog. 
  4768. This is the Default selection.
  4769.  
  4770.  
  4771. Help for Ignore Invalid Drive Handles
  4772.  
  4773. The Ignore Invalid Drive Handles button will cause all
  4774. directories and files on Invalid drives to be ignored, even if they
  4775. are not valid.  This option would be used if the User has drives that
  4776. are identified as Invalid drives by the Repair File Handle code and
  4777. does not want to see the Handles in the OS2SYS.INI file for the
  4778. drive.  This is most commonly the case for Network Drives if the user
  4779. is not currently logged onto the Network,
  4780.  
  4781.  
  4782. Help for Report Invalid Drive Handles
  4783.  
  4784. The Report Invalid Drive Handles button will cause all
  4785. directories and files on Invalid drives to be reported in the
  4786. Repair Window.  However, if the Do Repair button is
  4787. selected in the Repair Dialog, the directories and files will
  4788. not be removed from the OS2SYS.INI file.  This option would be used
  4789. if the User wants to know about invalid Directories and Files on the
  4790. Invalid drive, but does not want them removed unless they are
  4791. specifically selected.
  4792.  
  4793.  
  4794. Help for Auto Repair Invalid Drive Handles
  4795.  
  4796. The Auto Repair Invalid Drive Handles button will
  4797. cause all directories and files on Invalid drives to be removed if
  4798. the Do Repair button is selected in the Repair Dialog. 
  4799. This is the Default selection.
  4800.  
  4801. ************************************************************************
  4802. ************************************************************************
  4803. ************************************************************************
  4804. ******************EA DEFAULT DIALOG*************************************
  4805. ************************************************************************
  4806. ************************************************************************
  4807. ************************************************************************
  4808.  
  4809. Help for EA Defaults Dialog
  4810.  
  4811. The EA Defaults Dialog will allow the user to control various
  4812. options while working with the Extended Attributes.
  4813.  
  4814. The items that can be set are:
  4815.  
  4816.  
  4817. Help for EA File Directory
  4818.  
  4819. The EA File Directory is the Directory that will be
  4820. used whenever the name for a file to hold Extended Attributes is 
  4821. automatically generated.  This will also be used as the starting directory
  4822. for the File Dialog when the user is asked to select a filename.
  4823.  
  4824.  
  4825. Help for Display In Progress Box
  4826.  
  4827. The Display In Progress Box checkbox will cause the
  4828. Processing EAs Dialog to appear while the EAs are being
  4829. processed.  If this option is not chosen, then only the Wait pointer
  4830. will apppear on the screen.
  4831.  
  4832. The Default for this item is YES.
  4833.  
  4834.  
  4835. Help for Ignore No EAs for View/Test
  4836.  
  4837. The Ignore No EAs for View/Test checkbox will prevent an
  4838. entry in the Edit of Test Windows for any Directory or Path that does not have any EAs.
  4839. If this item is set to NO and there is a Directory or File with no
  4840. EAs, there will be an entry in the Appropriate Window for this Directory
  4841. or File and, for the Edit, the Key Name will simply say there are no EAs.
  4842. If the user
  4843. is not interested in knowing which files do not have EAs, then this
  4844. option should be left as YES, since it will reduce the number of entries
  4845. in the Windows for those situations where a number of Directories or Files
  4846. are included.
  4847.  
  4848. The Default for this item is YES.
  4849.  
  4850.  
  4851. Help for Include Hidden Files 
  4852.  
  4853. The Include Hidden Files checkbox will cause files with
  4854. the Hidden Attribute set to be included in the files that are candidates
  4855. to have their EAs processed.
  4856.  
  4857. The Default for this item is NO.
  4858.  
  4859.  
  4860. Help for Include System Files
  4861.  
  4862. The Include System Files checkbox will cause files with
  4863. the System Attribute set to be included in the files that are candidates
  4864. to have their EAs processed.
  4865.  
  4866. The Default for this item is NO.
  4867.  
  4868.  
  4869. Help for Ask for EA Filename
  4870.  
  4871. The Ask for EA Filename checkbox will cause the user to
  4872. be prompted for a Filename anytime that one is needed to contain the
  4873. EAs for the selected Directories and/or Files.  If this items is
  4874. left as the Default NO, then the filenames will be constructed
  4875. automatically and will be a combination of the range of Directories
  4876. and/or Files requested and the root entry picked by the user.
  4877.  
  4878. The only exception to the above is when the Keep Temporary
  4879. Files  option is not checked and the View or Compare
  4880. menu items are selected.  Since all files needed to accomplish the
  4881. View or Compare will be automatically deleted as soon as the function
  4882. is completed, the user will not be asked for a filename unless the
  4883. filename constructed already exists and the Overwrite Existing Files
  4884. option is not selected.
  4885.  
  4886. The Default for this item is NO.
  4887.  
  4888.  
  4889. Help for Keep Temporary Files
  4890.  
  4891. The Keep Temporary Files checkbox will cause files that are
  4892. created to temporarily hold EA information, such as for a Compare of the
  4893. EAs between two sets of Directories and/or Files, to be kept after the
  4894. files are no longer needed.  If this item is left as the Default NO, then
  4895. these files will be deleted.  This will apply whether or not the name of the
  4896. files is chosen by the user or done automatically.
  4897.  
  4898. Selecting this option will also disable the Ask for EA
  4899. Filename  for those selections that use temporary files, such
  4900. as View and Compare, since the files used for these
  4901. selections will be automatically deleted once the user is  finished
  4902. with them.
  4903.  
  4904. The Default for this item is NO.
  4905.  
  4906.  
  4907. Help for Overwrite Existing Files
  4908.  
  4909. The Overwrite Existing Files checkbox will cause any existing
  4910. file that already exists to be overwritten when the same filename is chosen
  4911. by the user or built automatically.  If this item is left as the Default NO,
  4912. then the user will always be prompted before a file is overwritten.
  4913.  
  4914. The Default for this item is NO.
  4915.  
  4916.  
  4917. Help for Log to INIEA.LOG
  4918.  
  4919. The Log to INIEA.LOG checkbox will cause diagnostic
  4920. information to be written to the INIEA.LOG file.  This should only be
  4921. used as part of a problem determination sequence, since the saved
  4922. information will make little sense without a knowledge of the program
  4923. internals.
  4924.  
  4925. The Default for this item is NO.
  4926.  
  4927.  
  4928. Help for Continue on Sharing Violations
  4929.  
  4930. The Continue on Sharing Violations checkbox will prevent the
  4931. user from being asked if he wants to continue whenever a Sharing Violation
  4932. is encountered while attempting to access the Extended Attributes for a
  4933. Directory or File.  If this item is checked, then SysMaint will assume that
  4934. the user wants to continue to the next Directory or File.
  4935.  
  4936. The Default for this item is NO.
  4937.  
  4938. ************************************************************************
  4939. ************************************************************************
  4940. ************************************************************************
  4941. ********************EA TEST DIALOG**************************************
  4942. ************************************************************************
  4943. ************************************************************************
  4944. ************************************************************************
  4945.  
  4946. Help for EA Test Dialog
  4947.  
  4948. The EA Test Dialog displays the results of the Extended
  4949. Attribute Test that the user has requested.
  4950.  
  4951.  
  4952. Help for Print
  4953.  
  4954. Selecting Print will cause the contents of the Listbox to
  4955. be printed.  The printing is done in a separate thread, so that the message
  4956. queue is not blocked.  However, the Test Dialog cannot be dismissed until
  4957. the Print is finished, since dismissing the Dialog will cause the memory
  4958. allocated to hold the Listbox items to be released.
  4959.  
  4960.  
  4961. Help for Write
  4962.  
  4963. Selecting Write will cause the contents of the Listbox to
  4964. be written to the file that is selected from the File Selection Dialog.
  4965. The writing is done in a separate thread, so that the message
  4966. queue is not blocked.  However, the Test Dialog cannot be dismissed until
  4967. the Write is finished, since dismissing the Dialog will cause the memory
  4968. allocated to hold the Listbox items to be released.
  4969.  
  4970. ************************************************************************
  4971. ************************************************************************
  4972. ************************************************************************
  4973. ******************  EXPLAIN DIALOG  ************************************
  4974. ************************************************************************
  4975. ************************************************************************
  4976. ************************************************************************
  4977.  
  4978. Help for Explain Dialog
  4979.  
  4980. The Explain Dialog displays the results of the Explain
  4981. requested by the user via one of the Popup Menus.
  4982.  
  4983.  
  4984. Help for Print
  4985.  
  4986. Selecting Print will cause the contents of the Listbox to
  4987. be printed.  The printing is done in a separate thread, so that the message
  4988. queue is not blocked.  However, the Explain Dialog cannot be dismissed until
  4989. the Print is finished, since dismissing the Dialog will cause the memory
  4990. allocated to hold the Listbox items to be released.
  4991.  
  4992.  
  4993. Help for Write
  4994.  
  4995. Selecting Write will cause the contents of the Listbox to
  4996. be written to the file that is selected from the File Selection Dialog.
  4997. The writing is done in a separate thread, so that the message
  4998. queue is not blocked.  However, the Explain Dialog cannot be dismissed until
  4999. the Write is finished, since dismissing the Dialog will cause the memory
  5000. allocated to hold the Listbox items to be released.
  5001.  
  5002. ************************************************************************
  5003. ************************************************************************
  5004. ************************************************************************
  5005. ******************DESK DEFAULT DIALOG***********************************
  5006. ************************************************************************
  5007. ************************************************************************
  5008. ************************************************************************
  5009.  
  5010. Help for Desktop Defaults Dialog
  5011.  
  5012. The Desktop Defaults Dialog will allow the user to
  5013. control various options that apply to the Desktop items and the
  5014. Snapshot Backup of the Desktop.
  5015.  
  5016. The items that can be set are:
  5017.  
  5018.  
  5019. Help for Save Desktop Directory
  5020.  
  5021. The Save Desktop Directory is the Directory that will be
  5022. used as the target directory for all Simple Backups of the Desktop.
  5023. This Directory will also be used as the default directory for the
  5024. Backup and Restore CMD files.
  5025.  
  5026.  
  5027. Help for Backup CMD Filename
  5028.  
  5029. The Backup CMD Filename is the Filename that will be
  5030. used for the Backup CMD file.  This Filename must have an extension of
  5031. CMD.
  5032.  
  5033.  
  5034. Help for Restore CMD Filename
  5035.  
  5036. The Restore CMD Filename is the Filename that will be
  5037. used for the Restore CMD file.  This Filename must have an extension of
  5038. CMD.
  5039.  
  5040.  
  5041. Help for Supplemental Backup CMD Filename
  5042.  
  5043. The Supplemental Backup CMD Filename is the Filename
  5044. that will be used for the Supplemental Backup CMD file.  This
  5045. Filename must have an extension of CMD.
  5046.  
  5047.  
  5048. Help for Supplemental Restore CMD Filename
  5049.  
  5050. The Supplemental Restore CMD Filename is the Filename
  5051. that will be used for the Supplemental Restore CMD file.  This
  5052. Filename must have an extension of CMD.
  5053.  
  5054.  
  5055. Help for User Backup CMD Filename
  5056.  
  5057. The User Backup CMD Filename is the Filename
  5058. that will be used for the User Backup CMD file.  This
  5059. Filename must have an extension of CMD.
  5060.  
  5061.  
  5062. Help for User Restore CMD Filename
  5063.  
  5064. The User Restore CMD Filename is the Filename
  5065. that will be used for the User Restore CMD file.  This
  5066. Filename must have an extension of CMD.
  5067.  
  5068.  
  5069. Help for Maximum Backup Generations
  5070.  
  5071. The Maximum Backup Generations is the number of
  5072. generations of Simple Backups that will be automatically maintained.
  5073. Once the number of Backups reaches the maximum, each new Backup will
  5074. cause the oldest generation to be deleted.  The default value is 10
  5075. generations.
  5076.  
  5077. If the number of generations is increased, there will be no
  5078. problems with the actual backup files.  However, if the number of
  5079. generations is reduced below the number of actual generations of
  5080. Backup that currently exist, then the extra generations must be
  5081. deleted manually.  For example, if the maximum generations were to be
  5082. reduced from 10 to 5 and there were 10 generations of backup
  5083. currently in the Backup Directory, Backup generations 6 thru 10 would
  5084. not be deleted automatically.  The reason for this is because  it is
  5085. very possible that the user does not want the higher generations
  5086. deleted and this approach gives them complete control over deleting
  5087. old generations when the maximum is changed.
  5088.  
  5089.  
  5090. Help for Reset System Attribute
  5091.  
  5092. The Reset System Attribute checkbox controls whether the
  5093. System Attribute is turned back on for the OS2.INI and OS2SYS.INI
  5094. files after a Snapshot Backup of the Desktop is made.  This setting
  5095. only applies to versions of OS/2 after the OS/2 V2.1 Service
  5096. Pack, since this is the first version that turned the System
  5097. Attribute on for these files.  It does not appear to cause a problem
  5098. to leave the Attribute off, but should probably be reset after the
  5099. Backup of the Desktop.  The only reason that a user would not leave
  5100. this option at it's default setting would be if the Backup CMD File
  5101. that is generated was to be used on an earlier version of OS/2.
  5102.  
  5103. The Default for this Option is On.
  5104.  
  5105.  
  5106. Help for Ask Before Reset Directory
  5107.  
  5108. The Ask Before Reset Directory checkbox controls
  5109. whether the user is warned before the Desktop Directory Structure is
  5110. replaced.  Since modifying this structure can have a serious
  5111. effect on the Desktop, the user is normally warned about this before
  5112. they are allowed to make any changes.  However, experienced users
  5113. already understand the issues and do not want to be bothered with the
  5114. warning time after time, so this option allows them to turn it off.
  5115.  
  5116. The Default for this Option is On.
  5117.  
  5118.  
  5119. Help for Ask Before Restore INI Files
  5120.  
  5121. The Ask Before Restore INI Files checkbox controls
  5122. whether the user is warned before the Desktop INI Files are
  5123. replaced.  Since modifying these files can have a serious effect on
  5124. the Desktop and will result in the Desktop being reset, the user is
  5125. normally warned about this before they are allowed to make any
  5126. changes.  However, experienced users already understand the issues
  5127. and do not want to be bothered with the warning time after time, so
  5128. this option allows them to turn it off.
  5129.  
  5130. The Default for this Option is On.
  5131.  
  5132.  
  5133. Help for Ask Before Build Restore CMD File
  5134.  
  5135. The Ask Before Build Restore CMD File checkbox controls
  5136. whether the user is notified before the Desktop Restore CMD File is
  5137. rebuilt.  Since it is critical that the user know that they must
  5138. rebuild this CMD file whenever certain kinds of changes are made ot
  5139. the Desktop, the user is normally informed of this whenever they
  5140. recreate this file.  However, experienced users already understand
  5141. the issues and do not want to be bothered with the warning time after
  5142. time, so this option allows them to turn it off.
  5143.  
  5144. The Default for this Option is On.
  5145.  
  5146.  
  5147. Help for Ask Before Reset Desktop ID
  5148.  
  5149. The Ask Before Reset Desktop ID checkbox controls
  5150. whether the user is warned before the Desktop ID is reset.  Since
  5151. modifying the Desktop ID can have a serious effect on the Desktop,
  5152. the user is normally warned about this before they are allowed to
  5153. make any changes.  However, experienced users already understand the
  5154. issues and do not want to be bothered with the warning time after
  5155. time, so this option allows them to turn it off.
  5156.  
  5157. The Default for this Option is On.
  5158.  
  5159.  
  5160. Help for Do Restore CMD when Backup
  5161.  
  5162. The Do Restore CMD when Backup checkbox controls
  5163. whether or not the Restore CMD file is automatically recreated
  5164. whenever the Backup CMD file is created or the Desktop is Backed up.
  5165.  
  5166. If this Option is turned on then the user can be sure that the
  5167. Backup and Restore CMD files are always in synch with each other.
  5168.  
  5169. The Default for this Option is Off.
  5170.  
  5171.  
  5172. Help for Include Supplemental Backup
  5173.  
  5174. The Include Supplemental Backup checkbox controls
  5175. whether the Supplemental Backup and Restore are automatically done
  5176. when the Desktop Backup or Restore are done.
  5177.  
  5178. The Default for this Option is Off.
  5179.  
  5180.  
  5181. Help for Change All Paths
  5182.  
  5183. If the Change All Paths checkbox is checked, then any
  5184. change to the Path for the Backup or any of the CMD Files will be
  5185. reflected in all of the other entries.  This is an easy way to modify
  5186. the Path for the Backup and all of the Backup CMD Files, since
  5187. changing one of them will automatically change all of them while
  5188. leaving the filename the same.
  5189.  
  5190. The Default for this Option is Off.
  5191.  
  5192.  
  5193. Help for Use Backup Descriptions
  5194.  
  5195. If the Use Backup Descriptions checkbox is checked, then the 
  5196. user can add a Description to each set of backup files.
  5197.  
  5198. When any of the Backups are requested and completed, the user will be 
  5199. presented with a Dialog that will ask for a Description.  If no Description 
  5200. is entered, then a default one will be generated that includes the date and 
  5201. time of the Backup.
  5202.  
  5203. When any of the Restores are requested, the user will see a dialog with 
  5204. the Descriptions of each of the Backup Generations in place of the Dialog 
  5205. that simply requests the Generation Number to use.  If the User selects OK 
  5206. then the Description that is highlighted will be used for the Restore.
  5207.  
  5208. There is also an item on the Desktop Menu that allows the user to display 
  5209. the Descriptions for the current Generations for the Desktop, Supplemental or 
  5210. Portable Backups.
  5211.  
  5212. The Default for this Option is Off.
  5213.  
  5214.  
  5215. Help for Make OS2*.INI Backup Copy
  5216.  
  5217. If the Make OS2*.INI Backup Copy checkbox is checked, then the 
  5218. Desktop Restore CMD File will include lines that will make a copy of the 
  5219. current User and System INI files before they are ERASED as part of the 
  5220. normal Desktop Restore operation.
  5221.  
  5222. The primary purpose of this option is to preserve the current INI files so 
  5223. that any information that the user might want to copy from the Current files 
  5224. to the Restored  Files is preserved past the actual Restore operation.
  5225.  
  5226. The Current User and System INI files will be written to files that are
  5227. in the same Directory and have the same name except that the extension will 
  5228. be changed to PRV, which stands for PReVious.  The PRV extension was chosen 
  5229. so that the name will not conflict with a similar file in the same Direstory 
  5230. with an extension of BAK and in hope that it will be a unique filename.
  5231.  
  5232. The Default for this Option is Off.
  5233.  
  5234. ************************************************************************
  5235. ************************************************************************
  5236. ************************************************************************
  5237. **************SELECT SUPPLEMENTAL BACKUP FILES DIALOG*******************
  5238. ************************************************************************
  5239. ************************************************************************
  5240. ************************************************************************
  5241.  
  5242. Help for Select Supplemental Backup Files
  5243.  
  5244. The Select Supplemental Backup Files Dialog manages the
  5245. file that are included in the Supplemental Backup.
  5246.  
  5247. The files that will be included in the default list of files the
  5248. first time this Dialog is displayed are all of the following files
  5249. that can be found.
  5250.  
  5251. CONFIG.SYS
  5252.  
  5253. AUTOEXEC.BAT
  5254.  
  5255. STARTUP.CMD
  5256.  
  5257. WIN.INI
  5258.  
  5259. SYSTEM.INI
  5260.  
  5261. CONTROL.INI
  5262.  
  5263. PROGMAN.INI
  5264.  
  5265. The items that can be set are:
  5266.  
  5267.  
  5268. Help for Add Supplemental Backup File
  5269.  
  5270. The Add Supplemental Backup File will display the New
  5271. File Dialog and, if a file is selected, the file will be added to the
  5272. list of files to be included in the Supplemental Backup.
  5273.  
  5274.  
  5275. Help for Add DOS AUTOEXEC Files
  5276.  
  5277. The Add DOS AUTOEXEC Files will search the Abstract
  5278. Objects information in the INI files, find all of the Files that are
  5279. identified as DOS_AUTOEXEC Files for DOS Program Objects and add
  5280. these files to the list of Supplemental Backup Files if they are not
  5281. already there.
  5282.  
  5283.  
  5284. Help for Add Multiple Files
  5285.  
  5286. The Add Multiple Files allows the user to add more than
  5287. one File from more than on Directory using mutiple Directory entries
  5288. and Filename wildcards.
  5289.  
  5290. When this selection is made, the user will see a Message Box that
  5291. explains the selection process followed by a dialog that asks for the
  5292. Path or Paths to be searched.  Multiple Paths can be entered as long
  5293. as they as separated by semicolons the same way that entries are made
  5294. in the CONFIG.SYS file.  If no Path is entered, then the DPATH
  5295. variable in the CONFIG.SYS will be used for the list of Paths to
  5296. search.  Finally, the user will be asked for a starting Filename and
  5297. this Filename can contain the normal wildcard characters ? and * with
  5298. the normal rules.
  5299.  
  5300. Once all of the information is entered, then the Filename is
  5301. cmbined with each of the Paths and all Files which meet the criteria
  5302. are added to the Supplemental Backup File list.
  5303.  
  5304. Before a file is added to the Supplemental File List, a check is
  5305. made to insure that the file is not already in the list.  Therefore,
  5306. there is no need to worry about duplicate Files, the routine that
  5307. adds the Files will insure that no duplicates exist.
  5308.  
  5309.  
  5310. Help for Delete Supplemental Backup File
  5311.  
  5312. The Delete Supplemental Backup File will delete the
  5313. currently highlighted filename from the list of files to be included
  5314. in the Supplemental Backup.
  5315.  
  5316. ************************************************************************
  5317. ************************************************************************
  5318. ************************************************************************
  5319. ******************PORTABLE DEFAULT DIALOG*******************************
  5320. ************************************************************************
  5321. ************************************************************************
  5322. ************************************************************************
  5323.  
  5324. Help for Portable Backup Defaults Dialog
  5325.  
  5326. The Portable Backup Defaults Dialog will allow the user to
  5327. control various options that apply to the Portable Backup of the
  5328. Desktop.
  5329.  
  5330. The items that can be set are:
  5331.  
  5332.  
  5333. Help for Save Desktop Directory
  5334.  
  5335. The Save Desktop Directory is the Directory that will be
  5336. used as the target directory for all Portable Backups of the Desktop.  
  5337. For each Portable Backup Generation there will be four files placed
  5338. in this Directory.
  5339.  
  5340.  
  5341. Help for Backup File Root
  5342.  
  5343. The Backup File Root is the Root that will be used for
  5344. the names of the files that hold the Portable Backup information.  The
  5345. Generation Number will be appended to the Root and an Extension added
  5346. to the file name to identify the contents of each of the files.  There
  5347. will be four files for each Backup Generation.
  5348.  
  5349.  
  5350. Help for WPS Logging File
  5351.  
  5352. The WPS Logging File is the name of the file that will
  5353. be used to record a detailed Log of the Portable Backup or Restore. 
  5354. The Logging should not normally be turned on, since it will degrade
  5355. the performance of both the Backup and the Restore and is of little
  5356. use except to diagnose problems.
  5357.  
  5358.  
  5359. Help for Maximum Backup Generations
  5360.  
  5361. The Maximum Backup Generations is the number of
  5362. generations of Portable Backups that will be automatically maintained.
  5363. Once the number of Backups reaches the maximum, each new Backup will
  5364. cause the oldest generation to be deleted.  The default value is 10
  5365. generations.
  5366.  
  5367. If the number of generations is increased, there will be no
  5368. problems with the actual backup files.  However, if the number of
  5369. generations is reduced below the number of actual generations of
  5370. Backup that currently exist, then the extra generations must be
  5371. deleted manually.  For example, if the maximum generations were to be
  5372. reduced from 10 to 5 and there were 10 generations of backup
  5373. currently in the Backup Directory, Backup generations 6 thru 10 would
  5374. not be deleted automatically.  The reason for this is because  it is
  5375. very possible that the user does not want the higher generations
  5376. deleted and this approach gives them complete control over deleting
  5377. old generations when the maximum is changed.
  5378.  
  5379.  
  5380. Help for OS2.INI System Entries
  5381.  
  5382. Select OS2.INI System Entries to include the OS/2,
  5383. PM and WPS entries in the window that displays the contents of the
  5384. OS2.INI file.  The System type entries are not normally included in
  5385. the window because the intent of displaying these entries in the
  5386. first place is to allow for an easy movement of the information to
  5387. the new Desktop.  Since the new Desktop will already have the System
  5388. level information set based on the install and any System level
  5389. entries that need to be set because of any of the Restores will be
  5390. set by PM or WPS, there is little reason to clutter the window with
  5391. this information.  However, there will certainly be situations where
  5392. there will be a need to copy over at least one of the System level
  5393. entries.  Therefore, if this item is selected, the all of the
  5394. Applications from the original OS2.INI file will be displayed in the
  5395. window.
  5396.  
  5397. The default for the item is Off.
  5398.  
  5399.  
  5400. Help for Do Safe Backup
  5401.  
  5402. Select Do Safe Backup if you want MultiMaint to ignore
  5403. all Object information that cannot be gathered via standard published
  5404. WPS methods and PM API's during the Portable Save operations.
  5405.  
  5406. WPS does not currently provide a way to Save or Restore all of the
  5407. instance information for the various WPS Objects.  IBM has said that
  5408. this capability will be available sometime in a future release of
  5409. OS/2, but that release is still quite a distance away. 
  5410. MultiMaint has the capability to both Save and Restore the instance
  5411. information that is outside the scope of the published Methods and
  5412. API's.  Both the Save and the Restore are done using publically
  5413. available Methods and API's, however, some of them are used in a way
  5414. that was not originally envisioned by the IBM developers.  Both the
  5415. Save and the Restore have been done many many times with the
  5416. addtional collection and restoration capability turned on.  However,
  5417. it is recognized that there are those users who would prefer to be
  5418. absolutely safe and would rather spend the time manually resetting
  5419. all of the instance information that cannot be saved via the standard
  5420. Methods and API's.  Therefore, this mechanism has been provided to
  5421. all the user to turn off the additional instance information
  5422. collection and restoration.
  5423.  
  5424. The default for the item is Off.
  5425.  
  5426.  
  5427. Help for Do Safe Restore
  5428.  
  5429. Select Do Safe Restore if you want MultiMaint to ignore
  5430. all Object information that cannot be gathered via standard published
  5431. WPS methods and PM API's during the Portable Restore operations.  If
  5432. the Safe Save Option was set during the save for the Generation being
  5433. used for the Restore, then this option has no effect, since non of
  5434. the additional information was collected during the Portable Save.
  5435.  
  5436. WPS does not currently provide a way to Save or Restore all of the
  5437. instance information for the various WPS Objects.  IBM has said that
  5438. this capability will be available sometime in a future release of
  5439. OS/2, but that release is still quite a distance away. 
  5440. MultiMaint has the capability to both Save and Restore the instance
  5441. information that is outside the scope of the published Methods and
  5442. API's.  Both the Save and the Restore are done using publically
  5443. available Methods and API's, however, some of them are used in a way
  5444. that was not originally envisioned by the IBM developers.  Both the
  5445. Save and the Restore have been done many many times with the
  5446. addtional collection and restoration capability turned on.  However,
  5447. it is recognized that there are those users who would prefer to be
  5448. absolutely safe and would rather spend the time manually resetting
  5449. all of the instance information that cannot be saved via the standard
  5450. Methods and API's.  Therefore, this mechanism has been provided to
  5451. all the user to turn off the additional instance information
  5452. collection and restoration.
  5453.  
  5454. The default for the item is Off.
  5455.  
  5456.  
  5457. Help for Log to WPS Log File
  5458.  
  5459. Select Log to WPS Log File to turn on the logging
  5460. function for either the Portable Save or Restore operations.  Turning
  5461. on this option will degrade the performance of both the Save and
  5462. Restore and is intended primarily for identifying problems with
  5463. either the Save or Restore.  Normally, this option would be left off
  5464. unless a log file was requested as part of the technical support
  5465. functions.
  5466.  
  5467. The default for the item is Off.
  5468.  
  5469.  
  5470. Help for Automatic Desktop Reset
  5471.  
  5472. Select Automatic Desktop Reset to have MultiMaint
  5473. automatically issue the Desktop Reset when it is called for because
  5474. of the nature of the Restore that was done and the version of
  5475. OS/2 that is being run.  If this Option is turned Off then the
  5476. Desktop Reset will not be done, however, if a Reset of the Desktop is
  5477. indicated by the type of Restore, when the Restore is complete the
  5478. user will be notified that a Reset is indicated and given the option
  5479. to have MultiMaint do the Reset.
  5480.  
  5481. The default for the item is On.
  5482.  
  5483.  
  5484. Help for Automatic Desktop Shutdown
  5485.  
  5486. Select Automatic Desktop Shutdown to have MultiMaint
  5487. automatically issue the Desktop Shutdown when it is called for
  5488. because of the nature of the Restore that was done and the version of
  5489. OS/2 that is being run.  If this Option is turned Off then the
  5490. Desktop Shutdown will not be done, however, if an immediate Shutdown
  5491. of the Desktop is indicated by the type of Restore, when the Restore
  5492. is complete the user will be notified that a Shutdown is indicated and
  5493. given the option to have MultiMaint do the Shutdown.
  5494.  
  5495. If the Shutdown is not done and the system is rebooted, it is
  5496. possible that some of the Instance Information will not be saved.  One
  5497. example of this is the position of Objects that are on the actual
  5498. Desktop, the Objects can end up in the default position in the upper
  5499. left hand corner of the Desktop.
  5500.  
  5501. The default for the item is Off.
  5502.  
  5503.  
  5504. Help for Desktop Shutdown Ask
  5505.  
  5506. Select Desktop Shutdown Ask to cause MultiMaint to ask
  5507. the user if they want MultiMaint to Shutdown the Desktop because at
  5508. least one Object has been Restored.  This Option will only be checked
  5509. if the Automatic Desktop Reset Option does not apply to the Restore
  5510. just completed.  In other words, if some Objects were Restored, but an
  5511. immediate Shutdown of the Desktop is not indicated and the Desktop is
  5512. not Reset for one reason or another, the user is simply informed that
  5513. the safest action ot take at this point is to do a Shutdown so that
  5514. all of the Instance Information for all of the Restored Objects is
  5515. written to the appropriate locations.
  5516.  
  5517. If the Shutdown is not done and the system is rebooted, it is
  5518. possible that some of the Instance Information will not be saved.  One
  5519. example of this is the position of Objects that are on the actual
  5520. Desktop, the Objects can end up in the default position in the upper
  5521. left hand corner of the Desktop.
  5522.  
  5523. The default for the item is On.
  5524.  
  5525.  
  5526. Help for Select Lower Level
  5527.  
  5528. Select Select Lower Level to change the how the
  5529. selection of Objects is handled in the Portable Restore and Settings
  5530. windows.  If this Option is off, then only the Objects specifically
  5531. selected will be highlighted. For example, if a Folder is selected, but
  5532. the Objects in the Folder are not selected, then only the Folder will
  5533. be highlighted.  If this Option is on, then the selection of any Object
  5534. will automatically cause all Objects contained in the selected Object
  5535. to also be selected. For example, if a Folder is selected, then all
  5536. of the Objects inside the Folder will also be selected, even if there
  5537. are multiple levels of Objects contained in the Folder, all of them
  5538. will be selected.
  5539.  
  5540. If the User is in the process of updating or displaying specific
  5541. Objects, then this Option should be left in it's default Off
  5542. condition.  If the User is in the process of Restoring or Displaying a
  5543. set of Objects to a new Desktop, setting this Option to On will make
  5544. it much easier to accomplish this task, since only the highest level
  5545. Object need be selected.
  5546.  
  5547. If this option is On and the Desktop entry is selected, then every
  5548. Object on the Desktop will be highlighted and any further operations
  5549. will be done on every Object on the Desktop.
  5550.  
  5551. The default for the item is Off.
  5552.  
  5553.  
  5554. Help for Ignore Floppy Drives
  5555.  
  5556. Select Ignore Floppy Drives to have the code that saves
  5557. the Folder type information for the Drives Object to ignore the
  5558. information for the Drive A: and Drive B: Objects. If this option is
  5559. turned off, then an attempt will be made to collect the information
  5560. for Drives A: and B:. If there is no media in either or both of the
  5561. drives when this is done, the operation will wait until the drives
  5562. timeout. At this point, the drives will be ignored.
  5563.  
  5564. Turning Off this option, which activates the collection of the
  5565. Drive A: and B: Objects, will never cause a problem, even when there
  5566. is no media in the drives. However, it can significantly extend the
  5567. amount of time that it takes to do either the Backup or the Restore.
  5568. the Drives Object 
  5569.  
  5570. The default for the item is On.
  5571.  
  5572.  
  5573. Help for Display Default Settings
  5574.  
  5575. Select Display Default Settings to cause the WPS
  5576. Settings Dialog to display all of the Object Settings for the
  5577. requested type, even if they are still in the default condition.
  5578.  
  5579. For example, there are a very large number of possible DOS
  5580. settings and quite a number of Style settings. If this option is in
  5581. it's default condition, Off, the only DOS or Style settings that will
  5582. be displayed will be the ones which are no longer defaults. If the
  5583. option is turned on, then all of the DOS settings and all of the
  5584. Style settings will be displayed in the appropriate settings window.
  5585.  
  5586. The default for the item is Off.
  5587.  
  5588.  
  5589. Help for Use Backup Descriptions
  5590.  
  5591. If the Use Backup Descriptions checkbox is checked, then the 
  5592. user can add a Description to each set of backup files.
  5593.  
  5594. When any of the Backups are requested and completed, the user will be 
  5595. presented with a Dialog that will ask for a Description.  If no Description 
  5596. is entered, then a default one will be generated that includes the date and 
  5597. time of the Backup.
  5598.  
  5599. When any of the Restores are requested, the user will see a dialog with 
  5600. the Descriptions of each of the Backup Generations in place of the Dialog 
  5601. that simply requests the Generation Number to use.  If the User selects OK 
  5602. then the Description that is highlighted will be used for the Restore.
  5603.  
  5604. There is also an item on the Desktop Menu that allows the user to display 
  5605. the Descriptions for the current Generations for the Desktop, Supplemental or 
  5606. Portable Backups.
  5607.  
  5608. The Default for this Option is Off.
  5609.  
  5610. ************************************************************************
  5611. ************************************************************************
  5612. ************************************************************************
  5613. ******************WPS RESTORE DIALOG************************************
  5614. ************************************************************************
  5615. ************************************************************************
  5616. ************************************************************************
  5617.  
  5618. Help for Portable Restore Dialog
  5619.  
  5620. The Portable Restore Dialog is used to control the
  5621. Portable Restore of the various WPS Desktop Objects.
  5622.  
  5623.  
  5624. Help for Write File
  5625.  
  5626. The Write File is the file that will be used to hold
  5627. the contents of the Portable Restore Window if the Write button is
  5628. selected.
  5629.  
  5630.  
  5631. Help for Existing Object
  5632.  
  5633. The Existing Object buttons determine the action to
  5634. take when an Object being Restored already exists in the same Folder.
  5635.  
  5636. The selections and their effect are:
  5637.  
  5638. Bypass  - The Object will not be Restored.
  5639.  
  5640. Ask     - The user will be asked what they want done.
  5641.  
  5642. Replace - The existing Object will be deleted and recreated.
  5643.  
  5644. Update  - The Instance information for the existing Object will
  5645. be updated.
  5646.  
  5647.  
  5648. Help for Class Not Registered
  5649.  
  5650. The Class Not Registered selections control what will
  5651. be done when a Restore is attempted for an Object and the Class for
  5652. the Object is not a standard Class and is not currently registered
  5653. for the Desktop that is the target of the Restore.
  5654.  
  5655. If the Class is Registered, either automatically or because the
  5656. user asks that it be Registered, the DLL that implements the Class
  5657. must already exist on the Target machine and must be in a Directory
  5658. that is in the LIBPATH.  If either of these conditions are not met,
  5659. then the Registration of the Class will fail and the Object will not
  5660. be Restored.
  5661.  
  5662. The selections and their effect are:
  5663.  
  5664. Bypass        - The Object will not be Restored.
  5665.  
  5666. Ask           - The user will be asked what they want done.
  5667.  
  5668. Auto Register - The Class will automatically be Registered using
  5669. the information from the Saved Desktop.
  5670.  
  5671.  
  5672. Help for Replaces Class
  5673.  
  5674. Replaces Class determines the action to be taken if
  5675. the Class of an Object being Restored Replaces one of the existing
  5676. Classes and the Replacement has not yet been done.  If a Class
  5677. Replacement is done, then the Desktop will be Reset once the Portable
  5678. Restore Dialog is dismissed, even if Do Safe Restore is selected in
  5679. the Portable Defaults Dialog.
  5680.  
  5681. The selections and their effect are:
  5682.  
  5683. Bypass       - The Object will not be Restored.
  5684.  
  5685. Ask          - The user will be asked what they want done.
  5686.  
  5687. Auto Replace - The New Class will automatically Replace the old
  5688. Class.
  5689.  
  5690.  
  5691. Help for Folder not Found
  5692.  
  5693. Folder not Found determines what action to take if
  5694. an Object is being Restored and the Folder that should contain the
  5695. Object does not currently exist on the Desktop.
  5696.  
  5697. The selections and their effect are:
  5698.  
  5699. Bypass      - The Object will not be Restored.
  5700.  
  5701. Ask         - The user will be asked what they want done.
  5702.  
  5703. Create      - The Folder will automatically be Created, this is
  5704. the same as Restoring the Folder as well as the current Object.
  5705.  
  5706. To Desktop  - The Folder will not be Created and the Selected
  5707. Object will be Restored Directly to the Desktop.
  5708.  
  5709.  
  5710. Help for Restore Type
  5711.  
  5712. The Restore Type selection determines how to choose
  5713. which Objects to Restore when the Execute is selected.
  5714.  
  5715. If the Portable Restore Window contains a list of Objects then 
  5716. the selections and their effect are:
  5717.  
  5718. Do Selected - The Objects which are currently highlighted will be
  5719. Restored.
  5720.  
  5721. Do All      - All Objects currently displayed in the Portable
  5722. Restore window will be Restored.
  5723.  
  5724. If the Portable Restore Window contains the contents of the
  5725. OS2.INI file then the selections and their effect are:
  5726.  
  5727. Do Selected - The Entries which are currently highlighted will be
  5728. copied to the existing OS2.INI file.
  5729.  
  5730. Do All      - All Entries currently displayed in the Portable
  5731. Restore window will be copied to the existing OS2.INI file.
  5732.  
  5733.  
  5734. Help for Execute
  5735.  
  5736. The Execute button will cause the Restore to be done
  5737. based on the contents of the Portable Restore Window and the
  5738. currently set options.
  5739.  
  5740.  
  5741. Help for Write
  5742.  
  5743. The Write button will cause the contents of the
  5744. Portable Restore Window to be written to the current Write File.
  5745.  
  5746.  
  5747. Help for Print
  5748.  
  5749. The Printbutton will cause the contents of the
  5750. Portable Restore Window to be printer on the default printer.
  5751.  
  5752.  
  5753. Help for Change Window Contents
  5754.  
  5755. The Change Window Contents button swaps the contents of
  5756. the Portable Restore Window between the list of Objects to Restore
  5757. and the list of OS2.INI Applications to copy to the current OS2.INI
  5758. file.  The actual text on this button will depend on the current
  5759. contents of the Portable Restore Window.
  5760.  
  5761. If the Portable Restore Window current contains a list of Objects
  5762. to Restore, then the text on this button will be OS2.INI.
  5763.  
  5764. If the Portable Restore Window current contains a list of the 
  5765. Appplication in the OS2.INI File to Restore, then the text on this
  5766. button will be Objects.
  5767.  
  5768.  
  5769. Help for System
  5770.  
  5771. The System button will cause the System Settings from
  5772. the Source Desktop to be set on the Target Desktop.  These settings
  5773. are things like the Cursor type and size, Keyboard Repeat Rate,
  5774. Window Border Size and other general Desktop settings.  These
  5775. settings do not include the Desktop Colors or the Desktop Color
  5776. Palette.
  5777.  
  5778.  
  5779. Help for Portable Restore Item Window
  5780.  
  5781. The Portable Restore Item Window is the window that
  5782. contains the items that can be restored.  The listing will either be
  5783. the Objects that can be Restored to the Target Desktop or the OS2.INI
  5784. Applications from the Source Desktop that can be Restored to the
  5785. OS2.INI file on the Target Desktop.
  5786.  
  5787. Initially, the window will simply list the appropriate items.  As
  5788. items are Restored, the text for the items in the window will be
  5789. updated to reflect the result of the attempt to Restore that specific
  5790. item.  The result will normally be, Restore Successful, which means
  5791. that no problems were encountered.  if the Restore was not successful
  5792. because of the settings of one of the Options, then the additional
  5793. text will say Restore Unsuccessful and give the reason for the
  5794. failure.  If an unexpected problem was encountered during the Restore
  5795. attempt for the item, then the Restore Unsuccessful text will appear
  5796. along with some reason information.
  5797.  
  5798. If an attempt to Restore an item fails because of an unexpected
  5799. problem, then the user should do the following and contact technical
  5800. support.
  5801.  
  5802. Write the Contents of the Restore Window to the Write File.
  5803.  
  5804. Assuming the Logging was not turned on in the Defaults Dialog,
  5805. the user should exit from the Restore Dialog, go to the Defaults
  5806. Dialog, turn on the Logging, restart the Restore Dialog and redo the
  5807. Restore that failed.
  5808.  
  5809. Both the copy of the Portable Restore Window that was written and
  5810. the Log File should be zipped and sent to Carry Associates via a
  5811. diskette or via our Compuserve ID, 72662,3616, along with any
  5812. additional information available.
  5813.  
  5814. ************************************************************************
  5815. ************************************************************************
  5816. ************************************************************************
  5817. ******************WPS SETTINGS WHY**************************************
  5818. ************************************************************************
  5819. ************************************************************************
  5820. ************************************************************************
  5821.  
  5822. Help for Why is the Display and Modify Object Settings Dialog Needed?
  5823.  
  5824. The question could easily be asked why there is any need for a
  5825. feature like the Display and Modify Object Settings, since everything
  5826. that this feature can do can be duplicated by using the Object
  5827. Settings Notebook.  The answer is simple.  Using the Object Settings
  5828. Notebook works well if the user is interested in looking at the
  5829. current settings for a specific Object or needs to modify the
  5830. settings for a specific Object.  However, using the Settings Notebook
  5831. is not an easy tool if the user wants to be able to examine or modify the
  5832. settings for a large number of Objects.  This feature is designed to
  5833. address this problem.  Using the Display and Modify Object Settings Dialog
  5834. makes it very easy to display or modify the settings for multiple
  5835. Objects in only a few steps.
  5836.  
  5837. For example, it is possible to set the
  5838. Always Maintain Sort Flag for every Folder on the Desktop by simply:
  5839.  
  5840. Opening the Display and Modify Object Settings Dialog.
  5841.  
  5842. Making sure the Select Lower Levels is set in the Defaults.
  5843.  
  5844. Clicking on the Desktop entry in the window and waiting for all
  5845. of the Objects to be selected.
  5846.  
  5847. Select the Set Folder Sort from the Set Menu.
  5848.  
  5849. Set the Folder Sort in the first Folder Sort Dialog that appears.
  5850.  
  5851. Setting the Do Remaining checkbox in the Folder Sort Dialog.
  5852.  
  5853. Click on the OK button.
  5854.  
  5855. This will set the Sort Flag for every single Folder, including
  5856. Folders that are contained in other Folders and including special
  5857. Folder Objects that are derived from the WPFolder Class.  For
  5858. example, if Icon Heaven is installed, it subclasses the WPFolder
  5859. Class and creates a new Class.  The MultiMaint code will always work
  5860. up the Class structure to find the standard Class from which new
  5861. Classes are derived and, if they are derived from the WPFolder Class,
  5862. they will be included in the set of Objects whose Sort Flag will be
  5863. changed.
  5864.  
  5865. ************************************************************************
  5866. ************************************************************************
  5867. ************************************************************************
  5868. ******************WPS SETTINGS DIALOG***********************************
  5869. ************************************************************************
  5870. ************************************************************************
  5871. ************************************************************************
  5872.  
  5873. Help for Display and Modify Object Settings
  5874.  
  5875. The Display and Modify Object Settings Dialog is used to
  5876. Display and/or Modify the Settings for any of the Objects on the
  5877. Desktop.
  5878.  
  5879. When this item is selected from the Desktop menu, the following
  5880. events occur:
  5881.  
  5882. The AccessWPS Agent Object is created, if it does not already
  5883. exist.
  5884.  
  5885. The Desktop is found and then, using the Desktop Folder as a
  5886. root, all of the other Objects on the Desktop are found.  During this
  5887. process, a basic amount of information is collected on each Object.
  5888.  
  5889. Everytime a Shadow Object is found, that additional information
  5890. needed to crossreference the Shadow information is also collected.
  5891.  
  5892. The Object entries are inserted into the Settings Window and
  5893. sorted.  If the original defaults are in effect, then all of the
  5894. Objects will appear in the window.  However, if there are defaults
  5895. that have been saved from a previous use of this feature, then it is
  5896. possible that the window will contain only a subset of all of the
  5897. Objects on the Desktop.
  5898.  
  5899. There are a number of ways to control which Objects are included in the 
  5900. Display and/or modification and, since it is not obvious, I have included a 
  5901. short description here.
  5902.  
  5903. Selecting Items in the Window:
  5904.  
  5905. You can do the normal selection of the Objects you want to Display or 
  5906. change by simply selecting them.
  5907.  
  5908. The Portable Default Dialog has a Checkbox, Select Lower Levels, that 
  5909. controls how the selection works. If you check this item in the Default 
  5910. Dialog then selecting an item, such as a Folder, will also select all of 
  5911. the Object contained in the Folder. You can select evey Object by turning 
  5912. this Option on and clicking on the Desktop entry.
  5913.  
  5914. You can select the items in the window by name.
  5915.  
  5916. Using the Filter Menu:
  5917.  
  5918. There are two ways to control the list of Objects via the Filer Menu. 
  5919. One is by type of Object, File or Abstract, and the other is by individual
  5920. Object Class.
  5921.  
  5922. The Object Type menu item will include or exclude Objects based on the 
  5923. type of Object. The Default is to include all Objects and the menu items 
  5924. allow the user to specify that only File Based Objects, such as Folders, 
  5925. only Abstract Objects, such as Program Objects, or No Objects be included.  
  5926.  
  5927. The Object Type can then be further refined by Including or Excluding 
  5928. specific Classes. The Include and Exclude override the Object Type. In the 
  5929. default situation where all Types are Included, the Include Menu will be 
  5930. empty, since everything is already Included. All of the Objects will be on 
  5931. the Exclude menu. If any of the Objects on the Exclude menu are selected, 
  5932. then that Class will be Excluded from an Display or Modification actions 
  5933. and the Class will not appear on the Excluded Menu. If only the File Type 
  5934. Objects are selected, then all of the File Type Objects, such as Folders, 
  5935. will appear on the Exclude Menu and all Abstract Object will appear on the 
  5936. Include menu.
  5937.  
  5938. The Reset Exclude/Include menu item will display all classes that have 
  5939. been specifically Included or Excluded and the user can reset this flag 
  5940. for the individual Classes or can reset it for all of the Classes.
  5941.  
  5942. For example, if a user wanted to Display something for only Folders they 
  5943. would:
  5944.  
  5945. Make sure that Select Lower Level is turned on in the Defaults.
  5946.  
  5947. Set the Object Type on the Filter menu to None.
  5948.  
  5949. Use the Include menu item on the Filter menu to Include the WPFolder 
  5950. Class.
  5951.  
  5952. Highlight the entire Desktop by clicking on the first itme in the Window.
  5953.  
  5954. Display and/or Modify whatever settings they are interested in.
  5955.  
  5956.  
  5957. Help for Object Settings Item Window
  5958.  
  5959. The Object Settings Item Window is the window that
  5960. contains the Objects that can Displayed or Modified.
  5961.  
  5962.  
  5963. Help for Display Class
  5964.  
  5965. The Display Class will cause the Class information for
  5966. all of the Classes of the Objects currently on the Desktop to be
  5967. displayed.
  5968.  
  5969.  
  5970. Help for Select by Name
  5971.  
  5972. The Select by Name allows the user to select the items
  5973. in the Settings Dialog Window by Name.
  5974.  
  5975. The Name Selection code uses a substring approach.  In other
  5976. words, all Objects will be selected if they contain the entered name
  5977. anywhere in the name of the Object. Doing a selection on 'Prod' would
  5978. select every Object that had the word 'Prod' anywhere in the name. 
  5979. There is an entry on the Filter Menu that controls whether or not the
  5980. selection will pat attention to case.
  5981.  
  5982. The '*' character can be used as a wildcard character in the
  5983. selection. For example, the seletion 'Prod*File' will select all
  5984. Objects that have the characters 'Prod' in them followed by the
  5985. characters 'File'.
  5986.  
  5987. ************************************************************************
  5988. ************************************************************************
  5989. ************************************************************************
  5990. ******************* OBJECT SETTINGS DIALOG******************************
  5991. ************************************************************************
  5992. ************************************************************************
  5993. ************************************************************************
  5994.  
  5995. Help for Set Objects Dialog
  5996.  
  5997. The Set Objects Dialog is the Dialog that will appear
  5998. whenever the user selects an item from the Set Object Menu and there
  5999. is at least one Object that qualifies.  Although the actual Object
  6000. Settings that can be modified will naturally change from menu item to
  6001. menu item, this dialog is a standard one and works the same way in
  6002. each case.
  6003.  
  6004. The dialog consists of a number of elements:
  6005.  
  6006. The top line will always be the name of the Object whose settings
  6007. are potentially going to be changed.
  6008.  
  6009. Each of the Object Settings that can be changed with this dialog
  6010. will be listed along the left side of the window.
  6011.  
  6012. The current value for each of the settings will be displayed to
  6013. the right of the name of the setting.  Even though some of the
  6014. current values look like they can be modified, all of these are Read
  6015. Only areas.
  6016.  
  6017. An area that can be used to modify the setting will be displayed
  6018. to the right of or immediately under the current setting, depending
  6019. on the format of the item.
  6020.  
  6021. At the bottom of the dialog there are two checkboxes along with
  6022. the OK and Cancel buttons.
  6023.  
  6024. Even though the formats vary, in all cases, the current settings
  6025. for the Object will not be modified if the changed area for that
  6026. setting is empty, with the exception of YES or NO settings where the
  6027. Unset button indicates that nothing will be changed.
  6028.  
  6029. It is possible to see entries in the changed areas as soon as the
  6030. dialog appears for a particular Object because this is not the first
  6031. Object in the series to be changed and change information was entered
  6032. for previous Objects.
  6033.  
  6034. If the OK button is selected, then the indicated changes will be
  6035. made to this current Object, the dialog will disappear and the next
  6036. Object will be displayed and so on until all of the Objects have been
  6037. displayed or the process terminated by using one of the checkboxes as
  6038. described below.  The Cancel button has the same effect except that
  6039. the current Object will not be modified, but the following Objects
  6040. will still be displayed until all of them have been acted on or the
  6041. process terminated.
  6042.  
  6043. Before either the OK or Cancel buttons are selected, the process
  6044. of displaying qualified Objects can be terminated with either of the
  6045. two checkboxes.
  6046.  
  6047. If you simply want to stop making changes, then set the Ignore Remaining 
  6048. checkbox.  If you select this checkbox, the action on the current Object will 
  6049. depend on which button you select, but you will not be asked about any 
  6050. remaining Objects that qualify and none of them will be modified.
  6051.  
  6052. If you want the modifications you have made applied to all of the remaining 
  6053. qualified Objects without your being asked about them, then check the Do All 
  6054. Remaining checkbox.  This will cause any of the settings you have specifically 
  6055. set in the Dialog to be applied to all of the remaining Objects that qualify.
  6056.  
  6057. ************************************************************************
  6058. ************************************************************************
  6059. ************************************************************************
  6060. ******************WPS SETTINGS MENUS************************************
  6061. ************************************************************************
  6062. ************************************************************************
  6063. ************************************************************************
  6064.  
  6065. Help for Object Settings Menu
  6066.  
  6067. The Object Settings Menu contains the items that
  6068. control the entire Object Display and Modify area.
  6069.  
  6070. The Menu Items are:
  6071.  
  6072.    Set Object Menu
  6073.    Display Object Menu
  6074.    Filter Menu
  6075.    Display Class
  6076.    Select by Name
  6077.  
  6078. ************************************************************************
  6079. ************************************************************************
  6080. ************************************************************************
  6081. ******************WPS SETTINGS SET OBJECT MENU**************************
  6082. ************************************************************************
  6083. ************************************************************************
  6084. ************************************************************************
  6085.  
  6086. Help for Set Object Menu
  6087.  
  6088. The Set Object Menu contains the items that
  6089. control the dialogs that Modify the various Object Settings.
  6090.  
  6091. The Menu Items are:
  6092.  
  6093.    Object Styles
  6094.    View Attributes and Fonts
  6095.    Program Executable Information
  6096.    Position and Size
  6097.    Miscellaneous and ObjectID
  6098.    Folder Sort
  6099.    WINOS2 Settings
  6100.    DOS File Settings
  6101.    DOS COM and HW Settings
  6102.    DOS Mouse, Prt and Key Settings
  6103.    DOS Video Settings
  6104.    DOS DPMI and EMS Memory Settings
  6105.    DOS Other Memory Settings
  6106.    DOS Miscellaneous Settings
  6107.  
  6108.  
  6109. Help for Set Object Styles
  6110.  
  6111. The Set Object Styles will pop up the Set Object Style
  6112. Dialog for each of the selected Objects that pass the Class Type and
  6113. Class Exclude/Include Filters.  In other words, in order to be
  6114. modified, an Object must be selected in the Object Settings Window
  6115. and the Object's Class must pass the Class Filter.
  6116.  
  6117. A Set Objects Dialog will be displayed for each qualified Object
  6118. starting with the first Object and continuing until the final Object,
  6119. unless the user stops the process in one way or another.  The general
  6120. information on the common aspects of the Set Objects Dialog can be
  6121. found in the Help item for the Dialog.
  6122.  
  6123.  
  6124. Help for Set View Attributes and Fonts
  6125.  
  6126. The Set View Attributes and Fonts will pop up the Set
  6127. View Attributes and Fonts Dialog for each of the selected Objects
  6128. that pass the Class Type and Class Exclude/Include Filters.  In other
  6129. words, in order to be modified, an Object must be selected in the
  6130. Object Settings Window and the Object's Class must pass the Class
  6131. Filter.
  6132.  
  6133. A Set Objects Dialog will be displayed for each qualified Object
  6134. starting with the first Object and continuing until the final Object,
  6135. unless the user stops the process in one way or another.  The general
  6136. information on the common aspects of the Set Objects Dialog can be
  6137. found in the Help item for the Dialog.
  6138.  
  6139.  
  6140. Help for Set Program Executable Information
  6141.  
  6142. The Set Program Executable Information will pop up the
  6143. Set Program Executable Information Dialog for each of the selected
  6144. Objects that pass the Class Type and Class Exclude/Include Filters. 
  6145. In other words, in order to be modified, an Object must be selected
  6146. in the Object Settings Window and the Object's Class must pass the
  6147. Class Filter.
  6148.  
  6149. A Set Objects Dialog will be displayed for each qualified Object
  6150. starting with the first Object and continuing until the final Object,
  6151. unless the user stops the process in one way or another.  The general
  6152. information on the common aspects of the Set Objects Dialog can be
  6153. found in the Help item for the Dialog.
  6154.  
  6155.  
  6156. Help for Set Position and Size
  6157.  
  6158. The Set Position and Size will pop up the Set Position and Size
  6159. Dialog for each of the selected Objects that pass the Class Type and
  6160. Class Exclude/Include Filters.  In other words, in order to be
  6161. modified, an Object must be selected in the Object Settings Window
  6162. and the Object's Class must pass the Class Filter.
  6163.  
  6164. A Set Objects Dialog will be displayed for each qualified Object
  6165. starting with the first Object and continuing until the final Object,
  6166. unless the user stops the process in one way or another.  The general
  6167. information on the common aspects of the Set Objects Dialog can be
  6168. found in the Help item for the Dialog.
  6169.  
  6170.  
  6171. Help for Set Miscellaneous and ObjectID
  6172.  
  6173. The Set Miscellaneous and ObjectID will pop up the Set
  6174. Miscellaneous and ObjectID Dialog for each of the selected Objects
  6175. that pass the Class Type and Class Exclude/Include Filters.  In other
  6176. words, in order to be modified, an Object must be selected in the
  6177. Object Settings Window and the Object's Class must pass the Class
  6178. Filter.
  6179.  
  6180. A Set Objects Dialog will be displayed for each qualified Object
  6181. starting with the first Object and continuing until the final Object,
  6182. unless the user stops the process in one way or another.  The general
  6183. information on the common aspects of the Set Objects Dialog can be
  6184. found in the Help item for the Dialog.
  6185.  
  6186.  
  6187. Help for Set Folder Sort
  6188.  
  6189. The Set Folder Sort will pop up the Set Folder Sort
  6190. Dialog for each of the selected Objects that pass the Class Type and
  6191. Class Exclude/Include Filters.  In other words, in order to be
  6192. modified, an Object must be selected in the Object Settings Window
  6193. and the Object's Class must pass the Class Filter.
  6194.  
  6195. A Set Objects Dialog will be displayed for each qualified Object
  6196. starting with the first Object and continuing until the final Object,
  6197. unless the user stops the process in one way or another.  The general
  6198. information on the common aspects of the Set Objects Dialog can be
  6199. found in the Help item for the Dialog.
  6200.  
  6201.  
  6202. Help for Set WINOS2 Settings
  6203.  
  6204. The Set WINOS2 Settings will pop up the Set WINOS2 Settings
  6205. Dialog for each of the selected Objects that pass the Class Type and
  6206. Class Exclude/Include Filters.  In other words, in order to be
  6207. modified, an Object must be selected in the Object Settings Window
  6208. and the Object's Class must pass the Class Filter.
  6209.  
  6210. A Set Objects Dialog will be displayed for each qualified Object
  6211. starting with the first Object and continuing until the final Object,
  6212. unless the user stops the process in one way or another.  The general
  6213. information on the common aspects of the Set Objects Dialog can be
  6214. found in the Help item for the Dialog.
  6215.  
  6216.  
  6217. Help for Set DOS File Settings
  6218.  
  6219. The Set DOS File Settings will pop up the Set DOS File Settings
  6220. Dialog for each of the selected Objects that pass the Class Type and
  6221. Class Exclude/Include Filters.  In other words, in order to be
  6222. modified, an Object must be selected in the Object Settings Window
  6223. and the Object's Class must pass the Class Filter.
  6224.  
  6225. A Set Objects Dialog will be displayed for each qualified Object
  6226. starting with the first Object and continuing until the final Object,
  6227. unless the user stops the process in one way or another.  The general
  6228. information on the common aspects of the Set Objects Dialog can be
  6229. found in the Help item for the Dialog.
  6230.  
  6231.  
  6232. Help for Set DOS COM and HW Settings
  6233.  
  6234. The Set DOS COM and HW Settings will pop up the Set DOS
  6235. COM and HW Settings Dialog for each of the selected Objects that pass
  6236. the Class Type and Class Exclude/Include Filters.  In other words, in
  6237. order to be modified, an Object must be selected in the Object
  6238. Settings Window and the Object's Class must pass the Class Filter.
  6239.  
  6240. A Set Objects Dialog will be displayed for each qualified Object
  6241. starting with the first Object and continuing until the final Object,
  6242. unless the user stops the process in one way or another.  The general
  6243. information on the common aspects of the Set Objects Dialog can be
  6244. found in the Help item for the Dialog.
  6245.  
  6246.  
  6247. Help for Set DOS Mouse, Prt and Key Settings
  6248.  
  6249. The Set DOS Mouse, Prt and Key Settings will pop up the Set DOS
  6250. Mouse, Prt and Key Settings Dialog for each of the selected Objects that pass
  6251. the Class Type and Class Exclude/Include Filters.  In other words, in
  6252. order to be modified, an Object must be selected in the Object
  6253. Settings Window and the Object's Class must pass the Class Filter.
  6254.  
  6255. A Set Objects Dialog will be displayed for each qualified Object
  6256. starting with the first Object and continuing until the final Object,
  6257. unless the user stops the process in one way or another.  The general
  6258. information on the common aspects of the Set Objects Dialog can be
  6259. found in the Help item for the Dialog.
  6260.  
  6261.  
  6262. Help for Set DOS Video Settings
  6263.  
  6264. The Set DOS Video Settings will pop up the Set DOS
  6265. Video Settings Dialog for each of the selected Objects that pass
  6266. the Class Type and Class Exclude/Include Filters.  In other words, in
  6267. order to be modified, an Object must be selected in the Object
  6268. Settings Window and the Object's Class must pass the Class Filter.
  6269.  
  6270. A Set Objects Dialog will be displayed for each qualified Object
  6271. starting with the first Object and continuing until the final Object,
  6272. unless the user stops the process in one way or another.  The general
  6273. information on the common aspects of the Set Objects Dialog can be
  6274. found in the Help item for the Dialog.
  6275.  
  6276.  
  6277. Help for Set DOS DPMI and EMS Memory Settings
  6278.  
  6279. The Set DOS DPMI and EMS Memory Settings will pop up the Set DOS
  6280. DPMI and EMS Memory Settings Dialog for each of the selected Objects that pass
  6281. the Class Type and Class Exclude/Include Filters.  In other words, in
  6282. order to be modified, an Object must be selected in the Object
  6283. Settings Window and the Object's Class must pass the Class Filter.
  6284.  
  6285. A Set Objects Dialog will be displayed for each qualified Object
  6286. starting with the first Object and continuing until the final Object,
  6287. unless the user stops the process in one way or another.  The general
  6288. information on the common aspects of the Set Objects Dialog can be
  6289. found in the Help item for the Dialog.
  6290.  
  6291.  
  6292. Help for Set DOS Other Memory Settings
  6293.  
  6294. The Set DOS Other Memory Settings will pop up the Set DOS
  6295. Other Memory Settings Dialog for each of the selected Objects that pass
  6296. the Class Type and Class Exclude/Include Filters.  In other words, in
  6297. order to be modified, an Object must be selected in the Object
  6298. Settings Window and the Object's Class must pass the Class Filter.
  6299.  
  6300. A Set Objects Dialog will be displayed for each qualified Object
  6301. starting with the first Object and continuing until the final Object,
  6302. unless the user stops the process in one way or another.  The general
  6303. information on the common aspects of the Set Objects Dialog can be
  6304. found in the Help item for the Dialog.
  6305.  
  6306.  
  6307. Help for Set DOS Miscellaneous Settings
  6308.  
  6309. The Set DOS Miscellaneous Settings will pop up the Set DOS
  6310. Miscellaneous Settings Dialog for each of the selected Objects that pass
  6311. the Class Type and Class Exclude/Include Filters.  In other words, in
  6312. order to be modified, an Object must be selected in the Object
  6313. Settings Window and the Object's Class must pass the Class Filter.
  6314.  
  6315. A Set Objects Dialog will be displayed for each qualified Object
  6316. starting with the first Object and continuing until the final Object,
  6317. unless the user stops the process in one way or another.  The general
  6318. information on the common aspects of the Set Objects Dialog can be
  6319. found in the Help item for the Dialog.
  6320.  
  6321. ************************************************************************
  6322. ************************************************************************
  6323. ************************************************************************
  6324. ******************WPS SETTINGS DISPLAY OBJECTS MENU*********************
  6325. ************************************************************************
  6326. ************************************************************************
  6327. ************************************************************************
  6328.  
  6329. Help for Display Object Menu
  6330.  
  6331. The Display Object Menu contains the items that
  6332. control the items that can be Displayed for the various Objects.
  6333.  
  6334. The Menu Items are:
  6335.  
  6336.    Object Styles
  6337.    Class, Name and Location
  6338.    View Attributes and Fonts
  6339.    Program Executable Information
  6340.    Position and Size
  6341.    Miscellaneous
  6342.    Folder Sort
  6343.    Shadow Information
  6344.    WINOS2 Settings
  6345.    DOS Settings
  6346.  
  6347.  
  6348. Help for Display Object Styles
  6349.  
  6350. The Display Object Styles will display the Style 
  6351. information for the selected Objects.
  6352.  
  6353. If the Display Defaults box is checked in the Defaults Dialog,
  6354. then all of the Styles for the Object will be displayed.  If this
  6355. option is not checked, then the only Styles that will be displayed
  6356. are those that are not the Defaults for the Object.
  6357.  
  6358.  
  6359. Help for Display Class, Name and Location
  6360.  
  6361. The DisplayClass, Name and Location will display the
  6362. Class, Title and Name of the Folder that contains the selected Objects.
  6363.  
  6364.  
  6365. Help for Display View Attributes and Fonts
  6366.  
  6367. The View Attributes and Fonts will display the
  6368. Attributes and Fonts for the various views for selected Folder Objects.
  6369.  
  6370.  
  6371. Help for Display Program Executable Information
  6372.  
  6373. The Display Program Executable Information will display the
  6374. program type of information for the selected Objects.  This consists
  6375. of things like the EXE Name, Startup Directory and Parameters.
  6376.  
  6377.  
  6378. Help for Display Position and Size
  6379.  
  6380. The Display Position and Size will display the Icon 
  6381. position in the appropriate Folder both as a raw value and as a
  6382. percentage of the maximum size of the Folder that contains the
  6383. Object.  If the Folder that contains the Object has the Always
  6384. Maintain Sort Order box checked, then it is possible there will be no
  6385. position information for the Icon and, even if there is position
  6386. information, it will be that last position before the Always Maintain
  6387. Sort Order was checked.
  6388.  
  6389. For those Objects where it is appropriate and the information is
  6390. other than the Desktop default, the Open Position and Size of the
  6391. Object will also be displayed.
  6392.  
  6393.  
  6394. Help for Display Miscellaneous
  6395.  
  6396. The Display Miscellaneous will display the Object
  6397. information that does not easily fit into other catagories.  This
  6398. includes things like the Real Name and the ObjectID of the Object.
  6399.  
  6400.  
  6401. Help for Display Folder Sort
  6402.  
  6403. The Display Folder Sort will display the Always
  6404. Maintain Sort Order flag for all Folders.
  6405.  
  6406.  
  6407. Help for Display Shadow Information
  6408.  
  6409. The Display Shadow Information will display the Shadow
  6410. information for the selected Objects that are Shadows and all Objects
  6411. that have a Shadow.  This will include the Object that is being
  6412. Shadowed and the Shadow Object Name.
  6413.  
  6414.  
  6415. Help for Display WINOS2 Settings
  6416.  
  6417. The Display WINOS2 Settings will display the DOS and
  6418. WINOS2 information for the selected Objects that are Windows Program
  6419. Objects.
  6420.  
  6421. If the Display Defaults box is checked in the Defaults Dialog,
  6422. then all of the items for the Object will be displayed.  If this
  6423. option is not checked, then the only items that will be displayed
  6424. are those that are not the Defaults for the Object.
  6425.  
  6426.  
  6427. Help for Display DOS Settings
  6428.  
  6429. The Display DOS Settings will display the DOS 
  6430. information for the selected Objects that are DOS or Windows
  6431. programs.
  6432.  
  6433. If the Display Defaults box is checked in the Defaults Dialog,
  6434. then all of the items for the Object will be displayed.  If this
  6435. option is not checked, then the only items that will be displayed
  6436. are those that are not the Defaults for the Object.
  6437.  
  6438. ************************************************************************
  6439. ************************************************************************
  6440. ************************************************************************
  6441. ******************WPS SETTINGS FILTER MENU******************************
  6442. ************************************************************************
  6443. ************************************************************************
  6444. ************************************************************************
  6445.  
  6446. Help for Filter Menu
  6447.  
  6448. The Filter Menu contains the items that
  6449. control the Filtering of the Objects and the Control of the contents
  6450. of the Display Settings Window.
  6451.  
  6452. The Menu Items are:
  6453.  
  6454.    Object Type
  6455.    Display Filtered Classes Only
  6456.    Ignore Case for Name Selection
  6457.    Remember Filter Information
  6458.    Exclude Class
  6459.    Include Class
  6460.    Reset Include/Exclude
  6461.  
  6462.  
  6463. Help for Display Filtered Classes Only
  6464.  
  6465. The Display Filtered Classes Only will control how
  6466. Objects are selected to be displayed in the Settings Window. 
  6467. Normally, all Objects on the Desktop will be displayed, even if the 
  6468. Object has been Excluded from the Displays because of the Class Type
  6469. Filter or the specific Class Exclusion.  It is easy to become
  6470. confused as to what Objects will be candidates and which will not. 
  6471. If this item is checked, then the only Objects in the Settings window
  6472. will be the Objects that have passed both the Object Type and the
  6473. Include/Exclude Class Filters.
  6474.  
  6475.  
  6476. Help for Ignore Case for Name Selection
  6477.  
  6478. The Ignore Case for Name Selection will cause the
  6479. search for Objects that satisfy the Select by Name criteria to ignore
  6480. the case of the selection criteria and the Object Name and this is
  6481. the default condition.  If the user wants the Name Search to be case
  6482. sensitive, then this menu item can be used.
  6483.  
  6484.  
  6485. Help for Remember Filter Information
  6486.  
  6487. The Remember Filter Information will cause the various
  6488. Filter settings to be remembered from one execution of the Object
  6489. Settings Dialog to another.  Normally, the Display and Filter
  6490. Settings will always start with the Defaults.  However, if this item
  6491. is checked, then the current selections will be remembered and will
  6492. be the Default setting the next time the Object Settings Dialog is
  6493. invoked.  The only thing that is not remembered from one execution to
  6494. the next is the specific Class Includes and Excludes.
  6495.  
  6496.  
  6497. Help for Exclude Class
  6498.  
  6499. The Exclude Class item allows the user to specifically
  6500. Exclude and of the Classes of Objects that are currently Included as
  6501. candidates for Display or Modification.  This item will override the
  6502. Class Type item on the Filter Menu.  In other words, if a Class is
  6503. specifically Excluded, then the Objects of that Class will never be
  6504. candidates for the Display or Modify menu items.
  6505.  
  6506.  
  6507. Help for Include Class
  6508.  
  6509. The Include Class item allows the user to specifically
  6510. Include and of the Classes of Objects that are currently Excluded as
  6511. candidates for Display or Modification.  This item will override the
  6512. Class Type item on the Filter Menu.  In other words, if a Class is
  6513. specifically Included, then the Objects of that Class will always be
  6514. candidates for the Display or Modify menu items.
  6515.  
  6516.  
  6517. Help for Reset Include/Exclude
  6518.  
  6519. The Reset Include/Exclude item allows the user to reset
  6520. the Exclude or Include Flag for any one Class or to Reset the Flag
  6521. for all of the Classes that have it set.
  6522.  
  6523. ************************************************************************
  6524. ************************************************************************
  6525. ************************************************************************
  6526. ******************WPS SETTINGS FILTER TYPE MENU*************************
  6527. ************************************************************************
  6528. ************************************************************************
  6529. ************************************************************************
  6530.  
  6531. Help for Filter Object Type Menu
  6532.  
  6533. The Filter Object Type Menu displays and selects which
  6534. types of Objects are to be included in the Settings Window based on
  6535. their Class Type, File Based or Abstract.
  6536.  
  6537. This entry works in cooperation with the Filter Menu items to
  6538. specifically Include or Exclude specific Classes.  If a specific
  6539. Class is Included or Excluded using the appropriate entries on the
  6540. Filter Menu, then the Include or Exclude will override this
  6541. selection.  In other words, a Class that is specifically Included
  6542. will always be a candidate for Display or Modification and a Class
  6543. that is specifically Excluded will never be a candidate, no matter
  6544. which Object Types are selected.
  6545.  
  6546. The Menu Items are:
  6547.  
  6548.    Both
  6549.    File Objects Only
  6550.    Abstract Objects Only
  6551.    None
  6552.  
  6553.  
  6554. Help for Filter Object Type Both
  6555.  
  6556. The Filter Object Type Both will include all types of
  6557. Objects in as candidates for the various Display or Modify Menu
  6558. Actions.  If there are no Classes that are specifically Excluded,
  6559. then all Objects will be candidates.
  6560.  
  6561.  
  6562. Help for Filter Object Type File Objects Only
  6563.  
  6564. The Filter Object Type File Objects Only will include
  6565. only those Objects that are File Based Objects as candidates for the
  6566. various Display or Modify Menu Actions.  These kinds of Objects
  6567. include things like the Desktop itself and all Folders.
  6568.  
  6569.  
  6570. Help for Filter Object Type Abstract Objects Only
  6571.  
  6572. The Filter Object Type Abstract Objects Only will include
  6573. only those Objects that are Abstract Objects as candidates for the various
  6574. Display or Modify Menu Actions.  Abstract Objects are those Objects
  6575. that are not File Based.  These Objects include all Program Objects,
  6576. the Shredder and many other types.
  6577.  
  6578.  
  6579. Help for Filter Object Type None
  6580.  
  6581. The Filter Object Type None will include no types of
  6582. Objects in as candidates for the various Display or Modify Menu
  6583. Actions.  If there are no Classes that are specifically Included,
  6584. then no Objects will be candidates.  This can be used to restrict the
  6585. Display or Modification to a single Class of Objects by using this
  6586. selection along with Including the Class of interest.
  6587.  
  6588. ************************************************************************
  6589. ************************************************************************
  6590. ************************************************************************
  6591. ************DISPLAY OBJECT SETTINGS DIALOG******************************
  6592. ************************************************************************
  6593. ************************************************************************
  6594. ************************************************************************
  6595.  
  6596. Help for Display Object Settings
  6597.  
  6598. The Display Object Settings Dialog displays the Object
  6599. Settings for the selected Objects.
  6600.  
  6601.  
  6602. Help for Settings Display Window
  6603.  
  6604. The Settings Display Window contains the list of Items that
  6605. are appropriate for the selected Objects and the Display menu item
  6606. that was selected.
  6607.  
  6608.  
  6609. Help for Write
  6610.  
  6611. Selecting Write will cause the contents of the Window
  6612. to be written to the Write File that the user selects from the New
  6613. File Dialog.
  6614.  
  6615. Help for Print
  6616.  
  6617. Selecting Print will cause the contents of the Window to
  6618. be printed.  The printing is done in a separate thread, so that the message
  6619. queue is not blocked.  However, the Repair Dialog cannot be dismissed until
  6620. the Print is finished, since dismissing the Dialog will cause the memory
  6621. allocated to hold the Window items to be released.
  6622.  
  6623. ************************************************************************
  6624. ************************************************************************
  6625. *********************