home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / wptool32.zip / WPTOOL.ZIP / wpsbkp.txt < prev    next >
Text File  |  1999-09-11  |  15KB  |  388 lines
  1.                          === DISCLAIMER ===
  2.  
  3.  
  4. I allow you to use and distribute WPSBKP and WPSREST freely under the 
  5. condition that I am in no way responsible for any damage or loss you 
  6. may suffer. 
  7.  
  8. Henk Kelder,
  9. hkelder@capgemini.nl
  10. http://www.os2ss.com/information/kelder/
  11.  
  12.  
  13.  
  14.                 === NOTES ON WPSBKP & WPSREST ===
  15.  
  16.  
  17. DESCRIPTION:
  18. ============
  19.  
  20. WPSBKP.EXE and WPSREST.EXE are two programs that allow you to (partially)
  21. backup you workplace shell. 
  22.  
  23. Before using WPSBKP.EXE make sure you have moved WPTOOLS.DLL to a 
  24. directory that is mentioned in the LIBPATH line from your config.sys.
  25. \OS2\DLL is a good place.
  26.  
  27. Whenever you have to reinstall you desktop by either recreating the 
  28. ini using MAKEINI or by re-installing OS/2 you can use the WPSREST 
  29. program the recreate all your WPProgram and WPShadow objects, 
  30. as well as the folders they reside in.
  31.  
  32. WPSBKP.EXE and WPSREST.EXE work best on OS/2 2.0 with the 'Service Pack'
  33. installed and on OS/2 2.1. Read further for more information.
  34.  
  35.  
  36.         SYNTAX: WPSBKP  [targetdirectory] [options]
  37.  
  38.                 WPSREST [backupfile] [options]
  39.  
  40. You are advised to run WPSBKP in a empty directory.
  41.  
  42. WPSREST allows you to specify a alternate input file. If you do not specify
  43. an input file, WPSBKP.DAT in the current directory is used as default.
  44.  
  45. The /Y option can be used for WPSBKP so no questions will be asked, and Yes
  46. answers are assumed.
  47.  
  48. BACKGROUND INFORMATION:
  49. =======================
  50.  
  51.  
  52. WPSBKP.EXE creates a text file (WPSBKP.DAT) the contains the instructions
  53. to recreate all Program and Shadow objects (WPProgram & WPShadow) as well
  54. as the folders these objects reside in. 
  55.  
  56. This text file can be inspected or modified, and can be used by 
  57. WPSREST to recreate program and shadow objects. 
  58. Also, all icons you have assigned to the objects are saved.
  59.  
  60.  
  61.  
  62.                 === FURTHER INFORMATION ===
  63.  
  64.  
  65. When WPSBKP extracts information from the workplace shell, all objects 
  66. that do not have an unique OBJECTID are assigned one (after confirmation 
  67. by the user). 
  68.  
  69. An OBJECTID is a the **only** way to refer to existing objects.
  70. (e.g. <WP_DESKTOP> for the desktop). 
  71.  
  72. It is possible that there is a problem with these OBJECTID's:
  73. sometimes two objects contain the same OBJECTID. WPSBKP will report this 
  74. problem and will ask if it may assign a new OBJECTID to resolve this problem.
  75.  
  76. When restoring the objects the WPSREST program checks for these OBJECTID's. 
  77.  
  78. If an object with a given OBJECTID exists, only the settings are applied 
  79. to it, if it does not exist, you are asked if you want to create the object.
  80.  
  81. Shadow objects:
  82. ===============
  83.  
  84. If a shadow object points to an abstract object (not a file or directory)
  85. and this abstract object does not have an unique OBJECTID, the shadow will
  86. NOT be backup'd. This will be reported.
  87.  
  88.  
  89. Icon positions
  90. ==============
  91.  
  92. WPSBKP does also save the icon position for objects on the desktop, 
  93. but not for objects in other folders. However these iconpositions are only
  94. handled properly when recreating the object and not when the object still
  95. exists. So you can NOT use WPSBKP as a backup-tool for you icon positions. 
  96.  
  97.  
  98. If you have added objects and have not shutdown your system before making a
  99. backup it is possible that some settings are not extracted properly. This 
  100. because WPSBKP uses information in your ini-files and some values are only
  101. written to it when you shutdown. This applies a specially to the ICONPOS. If
  102. WPSBKP cannot find a icon position for an object on the desktop, it will
  103. be reported.
  104.  
  105.  
  106. OS/2 2.0 GA, No service pack installed:
  107. =======================================
  108.  
  109. When you run the WPSREST program on OS/2 2.0 GA you must make sure you 
  110. have no open folders or other objects. In some cases your system 
  111. will hang when WPSREST tries to apply settings to open folders. 
  112. This is due to a bug in the workplace shell.
  113.  
  114. For WPSREST to work best, you should have installed the SOMFIX patch dated
  115. September 4, 1992. This patch solves a problem in the WinSetObjectData call
  116. the would not allow a setting string to be longer than 255 characters.
  117. Also, installing the service pack for OS/2 2.0 from october 1992, solves 
  118. this problem.
  119.  
  120.  
  121.  
  122. NEW VERSIONS of OS/2
  123. ====================
  124.  
  125. You should take care when using this program on new versions of
  126. OS/2 since this program interprets data from the ini-files. 
  127. The internal structure of this data can change, and the
  128. program might fail or even corrupt information
  129. This was the case with the new OS/2 2.00.1 (or 2.01) version as well
  130. as the Service Pack release in october 1992.
  131.  
  132. The best way to test this is run checkini WITHOUT the /C option! 
  133. (Optionally use the /W option to write out all checkini's findings and 
  134. inspect the logfile)
  135. If Checkini reports un unusual amount of errors, the internal structure of
  136. the workplace shells data inside the ini-files might have changed. 
  137. Look in CHECKINI's logfile at the  
  138. "PM_Abstract:Objects & PM_Abstract:FldrContents" section with special care.
  139. If this section contains a lot of errors while your workplace shell seems to
  140. function properly there might have been a change, so:
  141.  
  142.  
  143.          DO NOT USE CHECKINI.EXE or WPSBKP.EXE then!
  144.          ===========================================
  145.  
  146. (see DANGER.TXT about this)
  147. Note: The warning above does not apply to WPSREST.EXE and COPYINI.EXE!
  148.  
  149.  
  150. If you are using to *original* OS/2 2.0 version (the so-called GA version)
  151. restoring a backup might result in lost properties such a icons and various
  152. settings. The cause for these problems lies in OS/2 self.
  153. Installing the service pack from October 1992 solves these problems.
  154.  
  155.  
  156.  
  157.  
  158.  
  159. CORRECTIONS in version 0.91:
  160.  
  161. o   In this version a problem has been corrected that ICONPOS setting was not
  162.     added for objects on the desktop other than WPFolder.
  163.  
  164. o   Another problem was that when restoring a WPShadow object for a folder, 
  165.     the TITLE=xxxx setting made that the original folder name was renamed.
  166.     The program than hung the desktop. This has been corrected so that a 
  167.     WPShadow object does not contain a TITLE=xxxx setting. Also when
  168.     restoring objects, a existing WPShadow object is not updated.
  169.  
  170. o   WPShadow objects are always backuped last.
  171.  
  172. o   Performance has been improved.
  173.  
  174.  
  175. CHANGES in version 0.92:
  176.  
  177. o   WPSBKP now accepts a directory name as parameter. This directory must
  178.     exist and is used to place the backup information in. If no parameter
  179.     is specified the current directory is used.
  180.  
  181. o   WPSBKP prompts the location where the backup information will be placed
  182.     and the user must confirm this with a 'Y'.
  183.  
  184. CHANGES in version 0.94:
  185.  
  186. o   WPSBKP now support OS/2 2.00.1 (beta version)
  187.  
  188. o   Since the needed PROGTYPE strings for WINOS231 (OS/2 2.00.1) programs 
  189.     are unknown WINOS231 programs will backup as WINOS2 (3.0) programs.
  190.  
  191. o   Template WPProgram objects are no longer backup'd.
  192.  
  193.  
  194. CHANGES is version 0.96:
  195.  
  196. o   WPSBKP now works properly after installing the october '92 service pack
  197.  
  198. CHANGES is version 0.97:
  199.  
  200. o   In some occasions a problem could occur that multiple objects have the
  201.     same OBJECTID assigned. WPSBKP now assigns a new OBJECTID id to the
  202.     object that incorrectly claims to have a duplicate OBJECTID.
  203.  
  204. o   Updated the documentation files (this file)
  205.  
  206. o   When creating the text file (WPSBKP.DAT) an existing version of this
  207.     file will be renamed to WPSBKP.OLD.
  208.  
  209. o   A simple test has been build in to see if OBJECTID's can be found
  210.     in the ini-files, to determine if the internal data structure of the
  211.     ini-files might have been changed and WPSBKP will fail completely.
  212.     This is however no guarantee that WPSBKP will function properly on
  213.     new versions of OS/2 2.0.
  214.  
  215. o   Whenever WPSBKP wants to assign an OBJECTID to an object, the user 
  216.     will be prompted for a confirmation to assign this OBJECTID to the 
  217.     object. Whatever the reply is, the new OBJECTID is always written to
  218.     the backup file.
  219.  
  220. CHANGES in version 0.98:
  221.  
  222. o   Due to an error in the OS/2 2.0 Toolkit the ICONVIEWPOS (size and
  223.     position of a folder) was incorrectly backup'd.  The positions were
  224.     backup's as ICONVIEWPOS=x1,y1,x2,y2 while they should have been backup'd
  225.     as ICONVIEWPOS=x,y,cx,cy (xpos, ypos, widht, height) in percentages.
  226.  
  227. CHANGES in version 0.99:
  228.  
  229. o   Trailing spaces in DOS settings and Objecttitles are removed
  230.  
  231. o   WIN-OS/2 3.1 program types are backup'd properly. (OS/2 BETA 2.1). 
  232.     So the problem mentioned with version 0.94 no longer exists.
  233.  
  234. CHANGES in version 1.01:
  235.  
  236. o   Some minor text enhancements were made.
  237.  
  238. o   When a problems was encountered with the format of the INI files 
  239.     WPSBKP now advises to run CheckIni.
  240.  
  241. CHANGES in version 1.02:
  242.  
  243. o   A problem existed in 2.1 BETA when DOS SETTINGS were backup'd.
  244.     Appearantly 2.1 BETA handled comma's different from the GA version.
  245.     A correction has been build in WPSBKP that will handle DOS SETTINGS
  246.     properly for 2.1 BETA.
  247.     WPSBKP now backups DOS Settings as documented in the OS/2 Toolkits
  248.     documentation files. A comma is seen as a newline and whenever a literal
  249.     comma is needed a ^ is put in before it.
  250.  
  251.     The effect of the problem was the each comma was interpreted as a
  252.     newline character. This actually resulted in a TRAP E when trying
  253.     to start a restored DOS program that contained DOS_VERSION settings.
  254.     If you encounter these problems open the settings for the Dos program 
  255.     objects, go to setting page 2, press on 'DOS settings', go to
  256.     DOS_VERSION and press the 'DEFAULT' button.
  257.  
  258.  
  259. Notes on version 1.10:
  260.  
  261. o     This version now supports all known versions of OS/2 2.0 and 
  262.       OS/2 2.1 Beta versions uptill release level 6.498 (March '93)
  263.  
  264. o     Some time ago (version 0.99) Trailing spaces were removed in 
  265.       DosSettings.
  266.       Appearantly the 'NETWARE_RESOURCES' always must be padded with 
  267.       spaces to 7 positions. Now the trailing spaces in DosSettings are
  268.       back in again.
  269.  
  270. Notes on version 1.11:
  271.  
  272. o     The format of the output (WPSBKP.DAT) file was changed to a more
  273.       readable format. Version 1.11 of WPSREST supports both the old and
  274.       the new format.
  275.  
  276. o     The version number of WPSREST now matches the version number of 
  277.       WPSBKP.
  278.  
  279. o     An error was corrected were individual DOS_SETTINGS were limited to
  280.       100 characters. This lead to the problem that long DOS_SETTINGS 
  281.       (e.g. DOS_VERSION strings) being truncated.
  282.  
  283. o     The format of the .ICONPOS extended attribute was changed in OS/2 2.1.
  284.       WPSBKP now handles the EA correct for all supported versions.
  285.  
  286. o     The OS/2 2.0 GA version contained a BUG in a vital API call that I
  287.       tried to get around by actually doing two calls when restoring objects. 
  288.       The first to re-create the object, the second to apply some settings.
  289.       When using OS/2 2.1 BETA's this method lead to loosing the restored
  290.       object ICON on the second call. 
  291.  
  292.       When WPSREST detects OS/2 2.1 it does no longer do two calls when
  293.       restoring an object. (The BUG was fixed in the Service Pack already).
  294.  
  295. Notes on version 1.12:
  296.  
  297. o     Whenever an object (WPShadow or WPProgram) was located in a root 
  298.       directory, WPSBKP would issue the message 
  299.       'Unable to find folder in array' and would terminate.
  300.       This has been corrected.
  301.  
  302. o     A new command switch has been added. /Y makes wpsbkp not to ask any
  303.       questions but always anwer all questions with yes.
  304.  
  305. Notes on version 1.13:
  306.  
  307. o     When the workplace shell had more then 64 Kb of object-handle-to-file
  308.       data (PM_Workplace:HandlesX) WPSBKP would mess up. Now WPSBKP
  309.       can handle multiple BLOCK records.
  310.  
  311. Notes on version 1.14:
  312.  
  313. o     An error was corrected where WPSBKP sometimes would run into an 
  314.       exception error when handling WPShadow objects.
  315.  
  316.  
  317. Notes on version 1.15:
  318.  
  319. o     When using the OS/2 3.0 (Warp) some settings were not backup'd
  320.       properly. This has been corrected.
  321.  
  322. o     Coding has been added to backup customized menues. 
  323.       Although the syntax to restore such a menu is documented (MENU=..) 
  324.       the workplace shell seems to ignore the settings.
  325.  
  326. Notes on version 1.16:
  327.  
  328. o     The animated icon for folders will be backup'd also now as well
  329.       as folder backgrounds.
  330.  
  331. o     Although the syntax for setting customized menues was in WARPS beta
  332.       toolkit it is gone from the official toolkit. If have left the
  333.       code in, maybe in the future it will work.
  334.  
  335. Notes on version 1.17:
  336.  
  337. o     Don't know why I've never notived it but the setupstring for
  338.       the minimize/hide icon appearantly was incorrect. It was
  339.       'VIEWBUTTON=HIDE/MAXIMIZE'. I've changed it to 'HIDEBUTTON=YES/NO'.
  340.  
  341. o     For all minimize settings (Minimize to, concurent view, hide button)
  342.       I've added the DEFAULT option to be written when no other setting was
  343.       specified.
  344.  
  345. Notes on version 1.20:
  346.  
  347. o     Did quite a view changes in order to make (parts of) the functions
  348.       within WPSBKP available for usage from REXX. See WPTOOLS.TXT
  349.  
  350. Notes on version 1.21:
  351.  
  352. o     This version will now also backup any launchpads. Restoring a launchpad
  353.       however is a tricky thing because applying setupstrings to an existing
  354.       launchpad will add icons to it. Therefore WPSREST will always recreate
  355.       the launchpad.
  356.  
  357.       There is a potential problem with the launchpad. When a new icon is 
  358.       created on the launchpad the workplace shell first creates a shadow of
  359.       this object in the Nowhere folder and then places this shadow object
  360.       on the launchpad. (WPSBKP does not backup these shadows.)
  361.       When the launchpad itself is deleted all these shadow objects are 
  362.       left in the nowhere folder and there is no way other then manually to
  363.       get rid of them. 
  364.       This problem also occurs when WPSREST restores an existing launchpad.
  365.       One could use a tool like Deskman/2 or my own ICONTOOL to delete all
  366.       these no longer needed shadow objects.
  367.  
  368. Notes on version 1.30:
  369.  
  370.       Added the option /Y to WPSREST to automatically recreate all missing
  371.       objects.
  372.  
  373. Notes on version 1.31:
  374.  
  375.       WPSREST had problems with restoring objects if the PARAMETER argument
  376.       had quotes in it. Has been fixed.
  377.  
  378. Notes on version 1.33:
  379.       Slightly modified WPSREST so the /Y options also skips the first 
  380.       confirmation.
  381.  
  382. Notes on version 1.34:
  383.       Corrected a problem where an empty folder could cause WPSBKP to 
  384.       terminate.
  385.  
  386. Notes on version 1.40:
  387.       Changed compiler to VAC 3.0.
  388.