home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 6 / The_Pier_Shareware_Number_6_(The_Pier_Exchange)_(1995).iso / 035 / inimt33b.zip / mltmaint.txt < prev    next >
Text File  |  1994-11-09  |  39KB  |  762 lines

  1.                          MultiMaint
  2.               Copyright 1993, 1994 by Carry Associates
  3.  
  4. MultiMaint is an OS/2 PM program to display and manage *.INI files,
  5. all Extended Attributes and provide for both a snapshot and portable
  6. backup of the Desktop. It is distributed by Carry Associates, 990
  7. Ironwood Court, Marco Island, FL, 33937-4458. Telephone number is
  8. 813-642-9126. The application was written by and is supported by
  9. Larry J. Martin. You can obtain Technical support by calling the
  10. number above, by leaving an Email on Compuserve for 72662,3616 or for
  11. the same ID in the OS2AVEND Forum Section 1.
  12.  
  13. MultiMaint is an upgrade to SysMaint that adds the ability to create
  14. a 'portable' object by object backup of the Desktop that can be used
  15. to recreate the Desktop on a different machine or on a different
  16. version of OS/2 where the Desktop customization was lost because it
  17. was necessary to reformat the Harddisk.
  18.  
  19. SysMaint is an extension of IniMaint and shares many of the same
  20. files with IniMaint. Therefore, some of the discussion below will
  21. appear to apply to IniMaint rather than SysMaint. However, because of
  22. the close relationship between the two programs, the discussion
  23. applies to both programs. SysMaint and IniMaint also share some
  24. common files such as documentation files, the same help file and the
  25. same API DLL. In order to ease compatibility problems with those who
  26. are using IniMaint, these common files will still start with ini...
  27. rather than the expected mlt....
  28.  
  29. The cost for MultiMaint is $69.95 for a single user license and $699.00
  30. for an unlimited corporate license. There is a $7.00 shipping and
  31. handling charge to ship a diskette.  Payment can be made via a check
  32. drawn on a US bank, we will invoice against a corporate purchase
  33. order or we will charge either a Visa or MasterCard credit card.
  34.  
  35. If you are already a licensed owner of SysMaint you can upgrade to
  36. MultiMaint for $25.00.
  37.  
  38. If you are already a licensed owner of IniMaint you can upgrade to
  39. MultiMaint for $45.00.
  40.  
  41. All of the upgrade amounts above are for a single license, the cost
  42. to upgrade a corporate license is 10 times the appropriate single
  43. license fee.
  44.  
  45. When MultiMaint extracts the Extended Attributes from a file or
  46. directory, the Extended Attributes are placed in a file that has an
  47. internal structure and organization that is very similar to the OS/2
  48. INI files. Therefore, when the user is viewing a set of Extended
  49. Attributes, the appearance of the information is very similar to what
  50. you would see when editing an INI file. This makes the discussions
  51. below, which often refer to INI files, equally applicable to files
  52. which contain Extended Attributes.
  53.  
  54. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  55.  
  56. MultiMaint gives you the ability to make virtually any change you want
  57. to any of the INI files or any of the Extended Attributes in your
  58. OS/2 environment. Making changes to these files must be done with
  59. care because you can do serious and unpredictable damage to your
  60. environment. It is STRONGLY SUGGESTED that you insure that you have a
  61. usable backup of any INI file or Extended Attribute that you modify in
  62. any way.
  63.  
  64. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  65.  
  66. The enclosed is Version 3.3b of MultiMaint and has the following known
  67. problems and/or incomplete features:
  68.  
  69. 1. The Initial Dialog cannot be dismissed using the Enter Key, the
  70. Mouse must be used.
  71.  
  72. 2. If the Groups Dialog is displayed, a new Group is selected and
  73. then OK is selected without actually making any changes to any of the
  74. Groups or the Applications in a Group, then the Last Group Displayed
  75. is not updated and a subsequent use of the Groups Dialog will revert
  76. back to the previous Last Group.
  77.  
  78. 3. There is no Help available for the standard OS/2 New File Dialog.
  79.  
  80.  
  81.                  REPORTED COMMENTS OR PROBLEMS
  82.  
  83. The following items are problems that have been reported, but cannot
  84. be reproduced or comments that I have received from one or more
  85. users. Any assistance on the problems or additions to the comments is
  86. more than welcome.
  87.  
  88. 1. It was pointed out that although the Cursor in the Value MLE can
  89. be an Insert Cursor, there is no way to Insert information. My
  90. response is that the only way to change the length of a Value is by
  91. using the Replace Value Dialog because changing the expected length
  92. of an INI Key Value can cause unusual and unexpected errors. I
  93. further responded that the only way to change the cursor is to
  94. change it System wide, therefore, changing it only when it is in the
  95. MLE is a non trivial problem and I have not attempted to do it even
  96. though it leaves the apparent conflict between the appearance of the
  97. Cursor and the actual effect when a key is depressed.
  98.  
  99.                         INSTALLATION
  100.  
  101. To install the this version you must:
  102.  
  103. 1. Run the Install program that is on the supplied diskette and
  104. follow the instructions in the Readme and as displayed by Install.
  105.  
  106. 2. You may optionally add the entry: SET INIMAINT= to your CONFIG.SYS
  107. file specifying the path and filename of an INI file that you want
  108. MultiMaint to use to store it's operational information. If this entry
  109. is not found in the Environment, MultiMaint will store it's operational
  110. information in the OS2.INI file.
  111.  
  112.                      GETTING STARTED
  113.  
  114. If you did not obtain your copy of MultiMaint to address a specific
  115. problem or you are not familiar with INI files, Extended Attributes
  116. and the kinds of things that MultiMaint allows you to do with them,
  117. then it is strongly suggested that you review the Getting Started
  118. entry in the Help file along with the other General Help subjects.
  119.  
  120.  
  121.  
  122.                     VALIDATING INSTALLATION
  123.  
  124. Once the DLL's and the AcsTest program have been installed, it is
  125. suggested that the AcsTest program be run to verify that everything
  126. is working correctly. The AcsTest program has no command line
  127. parameters and, if everything is working correctly it will:
  128.  
  129. 1. Sound a rising series of tones that indicate the program
  130. is starting.
  131.  
  132. 2. A window will appear with a Listbox as the Client area.
  133.  
  134. 3. You will see a series of messages that will appear as the test
  135. program goes through it's cycle. There should be no messages that
  136. indicate that any of the functions was completed unsuccessfully.
  137.  
  138. 4. There will normally be a delay of a few seconds from the time you
  139. see the message that the creation of the Agent Object is starting and
  140. the message that it is complete. This is because the AcsAgent and
  141. Accsswps DLL's are loaded at this point.
  142.  
  143. 5. Once the Object is created. You will see a line with the Version
  144. information on it. If there are any problems, you might be asked for
  145. this version information, so it is worth while noting it.
  146.  
  147. 6. Once the version information has been displayed, several lines of
  148. internal variable information will be displayed. These are the
  149. internal variables for both the Agent Object and the AccssWPS module.
  150. This is done primarily to give the developer some idea of the kind of
  151. information that is returned when the dump lines are requested. It
  152. also provides a sample of how to get the dump information, since the
  153. source code for the AcsTest program is now included in the package.
  154.  
  155. 7. To terminate the AcsTest program, simply use the Close entry on
  156. the System Menu. You will hear a falling series of tones as the
  157. program terminates indicating that the termination was successful.
  158.  
  159. 8. If there is any error during the execution of AcsTest, you will
  160. see the error message surrounded by several lines of asterisks. In
  161. addition, you will see an error message telling you that the test was
  162. not successful at the very end of the display. If you do not see the
  163. error lines at the end of the display, then the test was successful.
  164.  
  165. 9. There are two common errors that can occur because of some sort of
  166. problem installing and/or running AccessWPS. The error codes are
  167. 10200 and 10201. If you see either of these errors during the running
  168. of the test, simply run the test a second time and it should work
  169. without an error. If you get the error two times in a row, then there
  170. is no reason to try any further.
  171.  
  172.  
  173.                  WHAT ARE SAFE BACKUP AND RESTORE?
  174.  
  175. The current version of WPS does not supply all of the methods that
  176. are necessary to Save and Restore all of the pieces of information
  177. that make up an Object. IBM has promised that this will be fixed in a
  178. new release of WPS, but there is no timetable.
  179.  
  180. If you select Safe Save, then only the 'official' methods will be
  181. used to save the instance information for each Object. This will not
  182. be a complete set of instance information. If you do not select Safe
  183. Save, then all of the instance information on an Object will be
  184. saved. The extra information is collected using publicly available
  185. WPS and SOM methods, however, some of them are used in ways that were
  186. not originally thought of by the developers inside of IBM.
  187.  
  188. If you select Safe Restore, then only the instance information that
  189. can be Restored using the 'official' methods will be Restored. Even
  190. if additional information was collected by not using the Safe
  191. this information will be ignored and no attempt will be made to fully
  192. update the Object. If Safe Restore is left off and Safe Save was also
  193. left off, then all of the instance information for the Restored
  194. Objects will be set. Just as with the Save above, public WPS and SOM
  195. methods are used, they are just used in unusual ways.
  196.  
  197. One problem that is caused by the Restore when Safe Restore is not
  198. used is that the settings for the Object and the instance information
  199. that is in the Extended Attributes and the OS2.INI file are not in
  200. synch with each other. It is possible to force the Objects to reload
  201. the instance information from where it is stored, but the Objects
  202. think they know what they are going to get back, but they sometimes
  203. get back something different and this causes problems. Therefore, if
  204. you choose to not use the Safe Restore, the Desktop is reset when the
  205. Restore Dialog is dismissed. This causes all the Objects to start
  206. from scratch and will leave all of them in synch. It might be
  207. possible in the future to bypass this step, but I do not know how to
  208. do it right now.
  209.  
  210.  
  211.                         OPERATION
  212.  
  213. The application can be run in either of two modes. Normal Mode will simply 
  214. run the application in the normal manner, starting with the INI File that was 
  215. current that last time the Application was shut down. Tools Mode will run a 
  216. specifc function and, once that function is complete, the application will 
  217. automatically exit.
  218.  
  219.                         TOOLS MODE
  220.  
  221. The Install Program created a Tools Folder. This Folder contains an Icon for 
  222. each of the Tools that is appropriate to this application. In order to run a 
  223. specific Tool all you need to do is click on the appropriate Icon. If the 
  224. Tool starts with a Menu, for example Copy, you will see the Menu appear on 
  225. the Desktop and the Tool will execute once a Selection is made. If the Tool 
  226. involves a Dialog, for example Repair INI File, the Dialog will appear on 
  227. the Desktop and the Tool will terminate as soon as the Dialog is dismissed. 
  228. If the Tool simply does some function, for example Backup the Desktop, then 
  229. the function will run and then terminate.
  230.  
  231. The purpose of the Tools is to make it much easier for the user to use the 
  232. various features of the application without having to navigate through all of 
  233. the Menus. There is no difference between running a feature via the Tools and 
  234. selecting it from the Menu while running in Normal Mode. The Tools run the 
  235. exact same EXE file as the Normal Mode does, the only difference is that the 
  236. Tools pass a parameter to the EXE file telling to to run in Tools Mode and 
  237. which Tool to run.
  238.  
  239.                        NORMAL MODE
  240.  
  241. To run MultiMaint simply start it by clicking on the MultiMaint.EXE file
  242. or start it from the Group to which it has been added. When MultiMaint
  243. first comes up, it will default to editing the INI file that is
  244. identified by the system as the user INI file. This is normally
  245. C:\OS2\OS2.INI. The name of the current file is always displayed in
  246. the TITLE bar of the main window.
  247.  
  248. MultiMaint can also be started with an initial INI file specified on
  249. the command line. This allows MultiMaint to be started with a new file
  250. by using the command line, but also allows for it to be started by
  251. dropping a file on the ICON on the desktop or double clicking on an
  252. INI file, once the association is set up.
  253.  
  254. MultiMaint will locate the window in a default location, but you can
  255. move and or size the window as you choose. When MultiMaint is shut
  256. down, it will remember the file that it was currently working with as
  257. well as the size and location of the window and will restore all of
  258. these the next time it is run.
  259.  
  260. There are a number of MultiMaint functions which will take some time
  261. to execute. For example, the maximum length Key Value that MultiMaint
  262. will load into the Key Value Window is 60,000 bytes. Since each line
  263. only displays 8 bytes, this comes to 7,500 lines and it takes well
  264. over a minute. There are other similar types of functions, although
  265. the example is the longest. During these long operations, it is not
  266. possible to do any other MultiMaint operations. However, the long
  267. functions are done in separate threads and the Message Queue is not
  268. blocked, therefore it is possible to go do some other, non-MultiMaint,
  269. function during this time. In addition, since there are a number of
  270. reasons why a user might not want to wait until the lengthy function
  271. is completed, for example, it might have been selected in error,
  272. any MultiMaint operation that takes a long time and displays the Wait
  273. Pointer can be terminated by hitting the ESC key.
  274.  
  275. MultiMaint will normally store the current operating information such
  276. as the size and position of the windows, that INI file that is
  277. currently being edited and a large number of other items, in the User
  278. INI file, OS2.INI. This is sometimes not a convenient location, since
  279. this file gets completely replaced when a new version is installed
  280. and a problem with the OS2.INI file would mean that MultiMaint would
  281. not run. MultiMaint will use a different INI file and will create the
  282. file, if necessary, if an Environment Variable MultiMaint= is placed in
  283. the CONFIG.SYS file or in a CMD file that executes MultiMaint. For
  284. example, if the user wanted MultiMaint to use the file MultiMaint.INI in
  285. the C:\OS2\APPS subdirectory, they would code:
  286.     SET INIMAINT=C:\OS2\APPS\MultiMaint.INI
  287.  
  288.                    MAIN WINDOW DESCRIPTION
  289.  
  290. The Main Window contains three standard child windows. Two of these
  291. windows are Listboxes and the third is a MLE.
  292.  
  293. The upper left Listbox will always contain the list of Applications
  294. for the current INI file or Current set of Extended Attributes.
  295.  
  296. The upper right Listbox will contain the list of Key Names for the
  297. Application that is currently selected in the Application Listbox.
  298.  
  299. The MLE, at the bottom, will contain the hex and ASCII display of the
  300. contents of the Key Name that is selected in the Key Listbox.
  301.  
  302. The Cursor will normally be forced to the MLE and the value of the
  303. data can be modified by changing either the hex or the ASCII fields
  304. of the MLE. The cursor cannot be moved to any portion of the MLE that
  305. does not contain data that can be modified and any modification to
  306. one type of data, hex or ASCII, will immediately be reflected in the
  307. other data.
  308.  
  309. The actual data in the INI or Extended Attribute file is not changed
  310. until the user selects the Update Item on the Action Menu or selects
  311. a different Key or Application in the same INI or Extended Attribute
  312. file. At this time, you will be asked to confirm that you want the
  313. INI or Extended Attribute file modified, unless you have turned the
  314. warning option off, see below.
  315.  
  316.                  MultiMaint POPUP MENUS
  317.  
  318. In addition to the standard menu entries described below, each window
  319. has a Popup Menu that will appear when the standard action is taken,
  320. clicking once with the Right Mouse Button is the default. Each of the
  321. three primary windows has its own Menu and the Menu will contain those
  322. items which are general to the entire Application and those that
  323. apply to the entries in that particular window. Most of the items on
  324. these menus are discussed below, however, there are three items on
  325. each menu that are unique to the Popup Menus and they are:
  326.  
  327. 1. Explain will attempt to give the user an explanation of the
  328. meaning of the currently selected Application and Key. Not every
  329. Application will have an explanation, but an attempt has been made to
  330. explain all of the standard OS/2 entries as completely as possible.
  331.  
  332. 2. Write Window to a File will cause the entries in the window in
  333. question to be written to a file, so they could be reviewed without
  334. MultiMaint running.
  335.  
  336. 3. Print Window will cause the entries in the Window to be printed on
  337. the default printer.
  338.  
  339.                  MultiMaint MENU OPTIONS
  340.  
  341. The various MultiMaint Menu options are:
  342.  
  343. 1. File gives the user the ability to change INI or Extended Attribute
  344. files, refresh the current INI or Extended Attribute file, Dump the
  345. contents of the MultiMaint variables, compare two INI or Extended
  346. Attribute files and Exit from MultiMaint.
  347.  
  348. The Compare option allows the user to Compare two INI or Extended
  349. Attribute files on any one of three different levels:
  350.  
  351.    A. List Applications that are in one INI or Extended Attribute file,
  352.       but not the other.
  353.  
  354.    B. A. above plus any Key Names that are in one file, but not the
  355.       other.
  356.  
  357.    C. A. and B. above plus any Key Values that are in both files, but
  358.       are not equal.
  359.  
  360. The differences are displayed in a Listbox within a Dialog that
  361. allows the user to print or write a listing of the Listbox contents
  362. and/or create an INI or Extended Attribute file with some or all of
  363. the Applications or Keys that have differences.
  364.  
  365. 2. Options will display a Dialog that gives you the ability to:
  366.  
  367.    A. Turn off the display of the opening MultiMaint Dialog.
  368.  
  369.    B. Turn off the dialogs that will ask for confirmation before
  370.       Deleting or Modifying the contents of the Current INI or
  371.       Extended Attribute file.
  372.  
  373. 3. Groups will display a Dialog that allows you to define and manage
  374. the various Groups for this INI or Extended Attribute file. A bit of
  375. explanation is needed here. MultiMaint gives the user the ability to
  376. arrange the applications in any INI or Extended Attribute file into
  377. Groups. These Groups can then be used in a number of different
  378. MultiMaint areas and greatly ease the problems of handling an INI or
  379. Extended Attribute file with a large number of applications. For
  380. example, the OS2.INI or Extended Attribute file might be divided into
  381. two Groups, System and Private. The System Group would be the
  382. applications put in the file by OS/2 Install and the Private Group
  383. would be the remaining applications. More or fewer Groups could be
  384. defined. How the user can use Groups within the MultiMaint structure
  385. will become more clear below. The Groups Dialog gives the user the
  386. ability to define new Groups, to add and delete Applications and
  387. Delete Groups.
  388.  
  389. The procedure for establishing a new Group is to select Groups in the
  390. Group Dialog, select New Group, and supply a name. Once this is done,
  391. the Title of the Dialog will show the current Group and the new Group
  392. will be added to the Group Menu. You add Applications to the Group by
  393. selecting them in the Listbox.
  394.  
  395. The Listbox will display a specific Group or, if you want to know if
  396. there are any Applications that are not in a Group, will display all
  397. Groups. A single Application can be a member of up to 5 different
  398. Groups at any one time, so it is possible to define overlapping
  399. Groups.
  400.  
  401. 4. Size will calculate the minimum amount of Disk Space that would be
  402. required for an INI or Extended Attribute file that contained a
  403. selected set of Applications in the current INI or Extended Attribute
  404. file. When this item is selected, the user will be asked what he
  405. wants to Size. There will always be several choices, the various
  406. standard INI or Extended Attribute files, the current file and the
  407. currently selected Application. If there are any Groups defined, then
  408. they will be included among the selections. If there are more than
  409. one Group defined, then there will be an All Groups selection.
  410.  
  411. 5. Actions gives the user the ability to do a number of things:
  412.    A. Update Current Key will write any changes that have been made
  413.       to the data in the MLE into the current INI or Extended Attribute file.
  414.  
  415.    B. Delete Application and Delete Key will do the obvious.
  416.  
  417.    C. Add Application, Add Key and Replace Key Value are all the same
  418.       function except entered at different points. Add Application
  419.       will ask for the name of a new Application to add to the
  420.       current INI or Extended Attribute file and then fall through to
  421.       the Add Key, since the Applications must have at least one Key.
  422.       The Add Key will ask for the name of the new Key and then fall
  423.       through to the Replace Key Value, since any Key Name must have
  424.       an associated Value. This will cause the Key Dialog box to be
  425.       displayed. The Application and Key Names will be shown at the
  426.       top of the Dialog, followed by the current length of the data,
  427.       the ASCII representation of the data and the hex representation of
  428.       the data. This is the only option that will change the length of
  429.       a Key Value. Care must be taken when doing this, as many
  430.       applications depend on knowing the length of the INI items. As
  431.       the ASCII or hex values are changed, the changes will appear in
  432.       the other window and the length will be updated. The only
  433.       exception is when only a single hex digit is entered. The ASCII
  434.       window is not updated until two hex characters are entered.
  435.  
  436.    D. Rename and Duplicate Key give the user the ability to change
  437.       the name of an existing Key or to make a duplicate copy of the
  438.       Key using a different Key Name.
  439.  
  440.    E. Copy and Move will ask the user to select a Target File for the
  441.       Copy/Move and will then give the user the same choices as Size
  442.       above. The selected Applications will then be moved or copied
  443.       to the Target INI or Extended Attribute file, which will be created, if it does not
  444.       exist. This function is done Key by Key, so it will sometimes
  445.       take some time. However, the PM message queue is not blocked
  446.       while the move/copy is being done. The actual move or copy is
  447.       done by a separate program INICOPY, that can also be run as a
  448.       batch program, see below.
  449.  
  450.    F. Backup allows for an easy Backup of the System INI file, User 
  451.       INI file or both the System and User INI files. Once the user
  452.       has selected names for the normal backups for the two files,
  453.       these files will be presented as the default for additional
  454.       backups. The user can set an Option that will bypass asking
  455.       the user if he wants to use the defaults. This selection will
  456.       always delete the target files before doing the backup, which
  457.       is one of the ways it varies from the Copy selection.
  458.  
  459. 6. Recover contains a list of capabilities designed to give the user
  460. the ability to recover from corrupted INI or Extended Attribute files.
  461. These capabilities are:
  462.  
  463.    A. Change User and/or System INI files give the user the ability
  464.       to change the INI files that OS/2 is currently using to new
  465.       files. The primary use of this capability is to allow the user
  466.       to make changes to the User or System INI files that he knows
  467.       need to be made, but cannot make to the current User or System
  468.       Files because of protection built into OS/2. Great care must be
  469.       exercised when doing this, but it will sometimes represent the
  470.       only way that problem entries can be removed from an INI file.
  471.  
  472.    B. Repair inconsistencies between the INI files and the Desktop.
  473.  
  474.    C. Condense the Current INI file, the System INI file, the User
  475.       INI file or both the System and User INI files. The Condense
  476.       is necessary because of the way updating is done to the INI
  477.       files. The updating will leave empty areas in the INI files and
  478.       these areas tend to get fragmented, thus causing the overall
  479.       size of the INI file to grow, sometimes grow very large.
  480.       Condensing the System or User INI files is not a simple task,
  481.       since they cannot be copied or erased while they are being used
  482.       by OS/2. This item switches the files to the copies long enough
  483.       to erase the old files and copy a condensed backup to the
  484.       original names. The only problem this causes is that it will
  485.       reset the desktop to the boot desktop. This function is removed
  486.       for Version 2.1 of OS/2 and beyond, since the handling of the
  487.       INI files was changed to automatically remove the empty space.
  488.  
  489.    D. There are two items to Test for and Reset the condition where
  490.       the User and System INI files cannot be updated. When this
  491.       condition is found, the user will be asked if he wants to 
  492.       correct the condition and, if he answers yes, the User and
  493.       System INI files will get changed so that they will be able
  494.       to be updated. The process involves making a copy of the INI
  495.       files and switching to them, so it takes a minute or so and
  496.       involves resetting the Desktop.
  497.  
  498. 7. Find allows the user to search the Application Listbox, the Key
  499. Name Listbox, the Key Value MLE, all of the Key Names in the current
  500. INI or Extended Attribute file, all of the Key Values for the current
  501. Application or all of the Key Values in the current INI or Extended
  502. Attribute file for either an Ascii string or a Hex value.
  503.  
  504. 8. The Desktop menu has a number of entries that are associated with
  505. the maintenance of the Desktop.
  506.  
  507.    A. A Defaults Dialog that allows the user to set various Default
  508.       entries and values for the Desktop Items.
  509.  
  510.    B. Reset Desktop will simply reset WPS and is normally used for
  511.       testing purposes. However, there are certain kinds of manual
  512.       changes that can be made to the OS2.INI and OS2SYS.INI files
  513.       that require that the WPS be reset in order for them to become
  514.       effective and this entry will accomplish the reset.
  515.  
  516.    C. Backup Desktop will make a Simple Backup of the Desktop. This
  517.       menu item will maintain the number of backup generations
  518.       currently specified in the Desktop Defaults.
  519.  
  520.    D. Create Backup CMD file will generate a CMD file using the name
  521.       that is specified in the Defaults Dialog and generate a CMD
  522.       file that will create a Simple Backup of the Desktop, including
  523.       maintenance of the number of generations that are specified in
  524.       the Defaults.
  525.  
  526.    E. Create Restore CMD File will create a CMD file that can only be
  527.       run when the PM Shell and WPS are not active, such as after a
  528.       boot from a diskette. This CMD file will accept a generation
  529.       number as a parameter and, if no generation is specified, will
  530.       default to generation 01, tell the user that the default is
  531.       being used and only do the restore with the default if the user
  532.       hits the enter key.
  533.  
  534.    F. Restore the Desktop ID will fix the problem where the Desktop
  535.       Menu has lost the items which are unique to the Desktop, such
  536.       as Shutdown. This condition is caused by a problem in the
  537.       Extended Attributes for the Desktop Directory and this menu
  538.       item will fix that problem.
  539.  
  540.    G. Restore Desktop Directory will restore the Desktop Directory
  541.       structure from any one of the generations of Simple Backup
  542.       files created by the Backup facilities of MultiMaint. While this
  543.       can be done while WPS and PM are active, it can cause a problem
  544.       if there is anything else running at the time.
  545.  
  546.    H. Restore Desktop INI Files is similar to the item above, except
  547.       it will restore the OS2.INI and OS2SYS.INI files from the 
  548.       backup. Once again, it can be done while WPS and PM are active
  549.       but problems can occur if other things are running while this
  550.       restore is being done.
  551.  
  552.    I. Portable Backup Defaults will display a dialog that allows the
  553.       user to customize the options used during the Portable backup
  554.       and Restore activities.
  555.  
  556.    J. Create Portable Backup will do just that, create 4 files that
  557.       represent a portable backup of the current desktop. One of the
  558.       files is a copy of the OS2.INI file, one is a copy of the
  559.       OS2SYS.INI file, one contains the Desktop Extended Attributes
  560.       and the last one contains the Desktop Object information.
  561.  
  562.    K. Do Portable Restore will, eventually, use the Portable Backup
  563.       to do a partial or complete restore of the Desktop.
  564.  
  565. 9. Extended Attributes is the menu used to access Extended Attributes
  566. for a file, directory or a group of files and/or directories. The
  567. menu structure has two levels. The first selection is the function
  568. desired and this will cause a second menu to appear which will allow
  569. selection of which files and/or directories the function should apply
  570. to. All of these are described more completely in the on-line help
  571. files.
  572.  
  573. Many of the Extended Attribute functions involve taking the Extended
  574. Attributes from one set of files and/or directories and adding them
  575. to another set of files and/or directories. In order to do this,
  576. MultiMaint must have a way of deciding which files and directories
  577. match each other. The basic way this is done is by removing the base
  578. information from each path and doing the compare on the remainder of
  579. the name. For example, if the Extended Attributes for all of the
  580. files and directories in the C:\OS2\SOURCE directory were to be
  581. copied to the D:\TARGET directory, then the file
  582. C:\OS2\SOURCE\FILE.NME would be determined to match
  583. D:\TARGET\FILE.NME and the Extended Attributes for the FILE.NME file
  584. would be copied from one file to the other. In addition, the
  585. directory C:\OS2\SOURCE\SUBDIR1 would be determined to match
  586. D:\TARGET\SUBDIR1 and the directory Extended Attributes would be
  587. copied from one directory to the other.
  588.  
  589. Aside from the functions that act on the Extended Attributes, there
  590. are a few utility functions on this menu:
  591.  
  592.    A. Defaults will present a Dialog box that allows the user to set the
  593.       various defaults for the Extended Attribute menu operations.
  594.  
  595.    B. Describe Current File will tell the user the selection criteria
  596.       used to create the set of Extended Attributes that are currently
  597.       being displayed in the window. This information is kept in special
  598.       control areas of the file and is not visible, thus the need to give
  599.       the user some way of verifying the source for the current set of
  600.       Extended Attributes.
  601.  
  602.    C. Update From Current File will use the Extended Attribute
  603.       information in the currently displayed file and the internal control
  604.       information to Join the displayed Extended Attribute information to
  605.       the files and/or directories from which it was extracted. For
  606.       example, if a user want to modify the Extended Attributes for some
  607.       files and/or directories they would use View to extract the Extended
  608.       Attributes to a temporary file, use the normal editing capabilities
  609.       to make the desired modifications and then use Update to replace the
  610.       Extended Attributes for the files and/or directories.
  611.  
  612. The available functions are:
  613.  
  614.    A. View allows the user to view and, if desired, modify the Extended
  615.       Attributes.
  616.  
  617.    B. Test will examine the Extended Attributes for the selected set of
  618.       files and/or directories and present a window that will tell the user
  619.       whether the Extended Attributes are valid or invalid.
  620.  
  621.    C. Save will copy the Extended Attributes to a save file which can
  622.       later be used to View the Extended Attributes or can be used to Join
  623.       them back to the original files and/or directories.
  624.  
  625.    D. Copy will Copy the Extended Attributes from one set of files
  626.       and/or directories to another set of files or directories. The
  627.       Extended Attributes of the original files are not modified. The
  628.       Extended Attributes will be attached to files and/or directories on
  629.       the Target based on the name matching algorithm described above.
  630.  
  631.    E. Move does exactly the same thing as the Copy does with the
  632.       exception that the Extended Attributes for the Source files and/or
  633.       directories will be deleted.
  634.  
  635.    F. Split does the same as Move, except the Extended Attributes are
  636.       added to a file that can be Viewed or used to Join the Extended
  637.       Attributes to another set of files and/or directories.
  638.  
  639.    G. Join takes the Extended Attributes in a Saved, or Split file and
  640.       rejoins them to the files and/or directories selected. If the
  641.       Extended Attributes are not Joined to the original files and/or
  642.       directories, then the matching algorithm above will be used to
  643.       determine which files and/or directories to update.
  644.  
  645.    H. Compare will compare the Extended Attributes for one set of files
  646.       and/or directories to those for another set of files and/or
  647.       directories. The matching algorithm described above is used to
  648.       determine which sets of files and/or directories should be compared
  649.       to each other.
  650.  
  651.    I. Compare to Saved EAs will compare the Extended Attributes for a
  652.       set of files and/or directories to the Extended Attributes in a Saved
  653.       or Split EA file. This can be used to see what kind of changes were
  654.       made to the Extended Attributes for a set of files and/or directories
  655.       because of some action on the Desktop.
  656.  
  657. Once the function is selected, the list of what type files and/or
  658. directories the function should apply to is presented. These
  659. selections and their effects are:
  660.  
  661.    A. Single File will perform the function against a single file. The
  662.       user will be presented with a file selection dialog that will allow
  663.       them to select the file.
  664.  
  665.    B. Single Directory will perform the function against a single
  666.       directory. The user will be presented with a modified file
  667.       selection dialog that will only show the drive and directory entries.
  668.       The directory must be selected by double clicking on the desired
  669.       directory. Simply selecting the directory and then clicking on OK
  670.       will not work because of the way that the file selection dialog
  671.       handles the various messages.
  672.  
  673.    C. All Files in Directory will perform the function against all the
  674.       files in a selected directory. The user will be presented with a
  675.       modified file selection dialog that will only show the drive and
  676.       directory entries.  The directory must be selected by double clicking
  677.       on the desired directory. Simply selecting the directory and then
  678.       clicking on OK will not work because of the way that the file
  679.       selection dialog handles the various messages.
  680.  
  681.    D. All Directories in Directory will perform the function against
  682.       all the subdirectories in a selected directory. The user will be
  683.       presented with a modified file selection dialog that will only show
  684.       the drive and directory entries.  The directory must be selected by
  685.       double clicking on the desired directory. Simply selecting the
  686.       directory and then clicking on OK will not work because of the way
  687.       that the file selection dialog handles the various messages.
  688.  
  689.    E. All Files & Dirs. in Directory will perform the function against
  690.       all the files and subdirectories in a selected directory. The user
  691.       will be presented with a modified file selection dialog that will
  692.       only show the drive and directory entries.  The directory must be
  693.       selected by double clicking on the desired directory. Simply
  694.       selecting the directory and then clicking on OK will not work because
  695.       of the way that the file selection dialog handles the various
  696.       messages.
  697.  
  698.    F. All Files in Directory and SubDirs. is the same as C. above,
  699.       except that MultiMaint will include not only the files in the
  700.       directory but any files found in any subdirectory of the selected
  701.       directory.
  702.  
  703.    G. All Directories in Directory and SubDirs. is the same as D. above,
  704.       except that MultiMaint will include not only the subdirectories in the
  705.       directory but any subdirectories found in any subdirectory of the selected
  706.       directory.
  707.  
  708.    H. All Files & Dirs. in Directory and SubDirs. is the same as E.
  709.       above, except that MultiMaint will include not only the files and/or
  710.       subdirectories in the directory but any files and/or subdirectories
  711.       found in any subdirectory of the selected directory.
  712.  
  713.    I. All Files on Drive will perform the function against all the
  714.       files on a selected drive. The user will be presented with a
  715.       modified file selection dialog that will only show the drive
  716.       entries.  The drive must be selected followed then the OK box.
  717.  
  718.    J. All Directories on Drive will perform the function against all the
  719.       directories on a selected drive. The user will be presented with a
  720.       modified file selection dialog that will only show the drive
  721.       entries.  The drive must be selected followed then the OK box.
  722.  
  723.    K. All Files & Directories on Drive will perform the function against
  724.       all the files and/or directories on a selected drive. The user will
  725.       be presented with a modified file selection dialog that will only
  726.       show the drive entries.  The drive must be selected followed then the
  727.       OK box.
  728.  
  729.                              INICOPY
  730.  
  731. INICOPY is the program that is used by MultiMaint to do the actual
  732. COPY/MOVE operations. This option is implemented as a separate program
  733. so that the user will have the ability to make copies of INI or Extended Attribute files,
  734. including the User and System INI or Extended Attribute files, at any time during the day.
  735.  
  736. The parameters expected by INICOPY are:
  737.  
  738. Required Parameters:
  739.  
  740. -Ifilename  - The fully qualified path and filename of the Source,
  741.               Input, INI or Extended Attribute file.
  742.  
  743. -Ofilename  - The fully qualified path and filename of the Target,
  744.               Output, INI or Extended Attribute file. The Target will be created if it does
  745.               not exist.
  746.  
  747. Optional Parameters:
  748.  
  749. -Fx         - Function requested - Default is C(opy)
  750.               C = C(opy)
  751.               M = M(ove)
  752.  
  753. -E          - COPY/MOVE Entire INI or Extended Attribute file - Default
  754.                                             
  755. -A          - COPY/MOVE All Groups
  756.                                              
  757. -Ggroup     - COPY/MOVE Specific Group
  758.                                              
  759. -Sapp       - COPY/MOVE Specific Application
  760.  
  761. -T          - Use Fast Copy. This is only valid if -E is also specified
  762.