home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / wps / system / deskman / deskman.hlp (.txt) < prev    next >
OS/2 Help File  |  1993-03-28  |  164KB  |  4,346 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. DeskMan/2 ΓòÉΓòÉΓòÉ
  3.  
  4.                                     DeskMan/2
  5.  
  6.                         The Desktop Manager for OS/2 2.X
  7.  
  8.                                    Online Help
  9.  
  10. (C) Copyright 1993 Development Technologies, Inc. and Gregory Czaja.  All 
  11. Rights Reserved. 
  12. DeskMan and DeskMan/2 are trademarks of Development Technologies, Inc. and 
  13. Gregory Czaja. 
  14. Presentation Manager and Workplace Shell are trademarks of International 
  15. Business Machines Corporation. 
  16. IBM, Operating System/2, and OS/2 are registered trademarks of International 
  17. Business Machines Corporation. 
  18. CompuServe is a registered trademark of CompuServe, Inc.. 
  19. PKZIP and PKUNZIP are registered trademarks of PKWARE, Inc. 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ 2. Software License Agreement ΓòÉΓòÉΓòÉ
  23.  
  24.                                 Software License
  25. Agreement
  26.  
  27. Please read this license agreement carefully and be sure that you accept its 
  28. terms before you install or use DeskMan/2.  By installing or using DeskMan/2, 
  29. you signify that you consent to be bound by the terms and conditions of this 
  30. agreement. 
  31.  
  32. This software is protected by United States copyright law and international 
  33. treaty provisions.  You must treat this software just like a book, except that 
  34. you may copy it onto a computer to be used and you may make archival copies of 
  35. the software for the sole purpose of backing up our software and protecting 
  36. your investment from loss. 
  37.  
  38. Just like a book, this software may be used by any number of people, and may be 
  39. freely moved from one computer location to another, so long as there is no 
  40. possibility of it being used at more than one location at the same time.  You 
  41. can, for example, use this software on both your personal computer at home, and 
  42. on your personal computer at work, so long as you are the only person who uses 
  43. those systems. 
  44.  
  45. Development Technologies, Inc. and Gregory Czaja disclaim all warranties as to 
  46. this software, whether express or implied, including without limitation any 
  47. implied warranties of merchantability, fitness for a particular purpose, 
  48. functionality, data integrity or protection. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ 3. Introduction ΓòÉΓòÉΓòÉ
  52.  
  53. What will you do in the event of a Workplace Shell (WPS) Crash? 
  54.  
  55. Your Workplace Shell desktop represents a substantial investment of time and 
  56. effort.  It may contain hundreds of objects and dozens of folders, and you may 
  57. have spent hours getting them customized to suit yourself.  Now, due to one 
  58. mishap, you may have to do it all over again! 
  59.  
  60. Introducing DeskMan/2, the drag and drop solution to selectively backup, 
  61. restore, and migrate your Workplace Shell desktop. 
  62.  
  63.  The WPS stores information about your objects in .INI files and in Extended 
  64. Attributes (EAs).  This makes it difficult to backup objects or copy them 
  65. between systems.  Also, file backup programs aren't notified to perform 
  66. incremental backups when only EAs have changed (this may change in OS/2 2.1, 
  67. but hasn't as of the December CD-ROM).  In addition, the internal data formats 
  68. change between versions of 0S/2 so that programs which work by copying the .INI 
  69. files and EAs don't insure compatibility.  IBM does provide you with forward 
  70. migration (although not necessarily during beta tests), but not backward 
  71. migration (something that is sometimes useful during beta tests).  Because 
  72. DeskMan/2 is a WPS extension, it is immune to these problems, providing you 
  73. with reliable forward and backward migration of your objects. 
  74.  
  75.  DeskMan/2 also contains features, such as drive mapping and REXX program 
  76. generation, to make it easy to exchange objects with other users, or to migrate 
  77. your customized desktop to other machines. 
  78.  
  79. AND THAT'S NOT ALL!
  80.  
  81.  DeskMan/2 has a host of special functions  that allow you to manage and learn 
  82. more about the objects on your desktop. 
  83.  
  84.  Occasionally, you may come across WPS objects on your desktop which don't 
  85. have a Delete option.  Once in a while, even the WPS has been known to be a bit 
  86. flaky, and create undeleteable objects on its own.  Whenever you want to be rid 
  87. of unwanted objects, and your Shredder won't delete them, DeskMan/2 is the 
  88. solution!  Simply select the special Destroy object on drop function to change 
  89. the DeskMan/2 icon into a flush bowl.  You can then drop your unwanted objects 
  90. into it, and watch them disappear! 
  91.  
  92.  One of DeskMan/2's useful features for REXX users is the ability to query an 
  93. object to learn its class, OBJECTID, and other settings! Simply select the 
  94. Query object Settings on drop function, and drop your object onto the DeskMan/2 
  95. icon to get an instant answer! 
  96.  
  97.  Another valuable feature for REXX users is the ability to assign an OBJECTID 
  98. to any WPS object in order to provide for unique identification of an object. 
  99. This enables REXX programs to manipulate individual objects using various 
  100. calls, such as SysCreateObject, SysDestroyObject, or SysSetObjectData. Just 
  101. select the DeskMan/2 Assign OBJECTID on drop special function, and provide your 
  102. own unique identifier! 
  103.  
  104.  Additional features include easing the assignment of icons to objects (even 
  105. when you don't have an .ICO file), and much more! 
  106.  
  107. DeskMan/2 is also very easy to use.  For example, to backup almost any object, 
  108. just select the object's icon on your desktop, and drop it on the DeskMan/2 
  109. icon.  DeskMan/2 will use SOM and PM functions to analyze the object you 
  110. provided, and immediately supply you with almost (See: Limitations) everything 
  111. required to recreate a duplicate of the original object on any OS/2 2.X 
  112. desktop.  If you drop a folder object on DeskMan/2, it will be saved along with 
  113. all the objects that it contains.  If it contains other folders, those will be 
  114. saved as well, until everything is resolved.  This way, when you drop a Desktop 
  115. icon on DeskMan/2, your entire desktop contents will be saved in the object 
  116. description file. Of course, the OS/2 1.3 style program groups are handled in 
  117. the same way as the OS/2 2.X folders. 
  118.  
  119. DeskMan/2 will create a special object description file for you, and optionally 
  120. a REXX program.  You can use them to recreate objects on your system or move 
  121. objects to another machine - you can also use the generated REXX program on 
  122. systems not having DeskMan/2 installed. 
  123.  
  124. If you would like to get information about a specific subject, please select 
  125. one of the topics below or use the Index button. 
  126.  
  127. o Saving objects or the entire Desktop 
  128.  
  129. o Restoring objects 
  130.  
  131. o Settings and options 
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 4. Read Me First ΓòÉΓòÉΓòÉ
  135.  
  136.                                   Read Me First
  137.  
  138.  
  139. ΓòÉΓòÉΓòÉ 5. Installing DeskMan/2 ΓòÉΓòÉΓòÉ
  140.  
  141. To install DeskMan/2, follow these simple instructions: 
  142.  
  143.  1. If you have received the product in a compressed form, decompress it using 
  144.     the appropriate command.  For example, if you have received a DESKMAN.ZIP 
  145.     file, copy the file unto your hard drive, and type 'pkunzip -x 
  146.     deskman.zip'. Note: You do not need to do this in the directory within 
  147.     which you plan on installing the product.  If you received the product on 
  148.     diskette, either run INSTALL.EXE from the diskette, or copy the files into 
  149.     a directory on your hard disk, and continue with Step 2. 
  150.  
  151.  2. Once you have the various DeskMan/2  installation files on your system, 
  152.     simply type 'install' from a command line in that directory.  If you have 
  153.     not previously installed DeskMan/2, you can specify the drive that you are 
  154.     running the installation program from, in order to reduce the time spent 
  155.     searching for any previously installed versions.  This would be in the 
  156.     form: 'install ?:', where '?' is the drive from you are which you are 
  157.     installing. 
  158.  
  159. Note:   If you have any questions about how to use the graphical installation 
  160. program, online help is available.  Just select the item for which you need 
  161. help, and hit F1.  If you have any other problems, please read the following 
  162. installation requirements. 
  163.  
  164. Installation Requirements: 
  165.  
  166. o REXX must be installed on your OS/2 system. The minimum required REXX level 
  167.   is the one contained in REXX20.ZIP (available on CompuServe).  * 
  168.  
  169. o The System Object Model (SOM) installed on your OS/2 system must at least 
  170.   match the level available from the file, SOMFIX.ZIP (available on 
  171.   CompuServe).  * 
  172.  
  173. * If you have installed the OS/2 Service Pak or OS/2 2.1, you already meet or 
  174. exceed the required levels of REXX and SOM. 
  175.  
  176. The installation program will verify that the above requirements are met before 
  177. proceeding with the installation of DeskMan/2.  If there are any problems, the 
  178. installation program will notify you as to the problems detected. 
  179.  
  180. The DeskMan/2 package being electronically distributed is in the form of a 
  181. PKZIPped file.  If you don't have PKZIP you can contact Development 
  182. Technologies, Inc. to receive the package unpacked on a diskette, or packed 
  183. using other available programs: OS/2 2.X native PACK format or LHA format. 
  184.  
  185. When initially installing DeskMan/2, the installation program defaults to 
  186. placing its DLL into the \OS2\DLL directory, its Help file into the \OS2\HELP 
  187. directory, and its online documention into the \OS2\BOOK directory on the 
  188. system partition.  When reinstalling DeskMan/2, the installation program will 
  189. default to installing the replacement files over any previously used locations. 
  190.  
  191. Of course, you do have the option, during the installation process, to choose 
  192. to install the DLL, HLP, and INF files in directories of your choice. However, 
  193. if you do choose to do this, you must make sure that the path names you provide 
  194. are valid.  Thus, the directory for the DLL file must be on your LIBPATH; the 
  195. one used for the HLP file must be among the directories specified for HELP; and 
  196. the one used for for the INF file must be one of the directories specified in 
  197. the BOOKSHELF environment variable. 
  198.  
  199. Note:   The option of specifying a private directory for the DLL seems to work 
  200. correctly only on systems having Service Pak installed (or better). This looks 
  201. like a SOM problem in the original release of OS/2 2.0. 
  202.  
  203. The initial installation process will, by default, use the current directory to 
  204. set the path information for the Save, Restore, Log and REXX files.  You can 
  205. also specify a different default directory to use for those files.  However, if 
  206. you had a previous version of DeskMan/2 installed on your system and you did 
  207. not alter OS2.INI, your previous selections for the locations of those files 
  208. will be retained.  Of course, you can always change the settings at any time by 
  209. opening up the DeskMan/2 Settings notebook and altering the information 
  210. contained therein. 
  211.  
  212. Note:   Values entered for the various DeskMan/2 files can be changed any time 
  213. after the installation using the object's Settings notebook. 
  214.  
  215. Note:   If you do not enter a correct registration number, or if you do not 
  216. have a registerable version of DeskMan/2, you should be aware of the following! 
  217.  
  218. The unregistered version of the program has some limitations compared to the 
  219. registered version: 
  220.  
  221. Note:   For the special "OS/2 Unleashed" version, the Save Desktop feature is 
  222. enabled. 
  223.  
  224. o The Save Desktop and Restore Desktop features are disabled. 
  225. o Folders will not be automatically populated; you will have to save the 
  226.   folders and their contents manually. 
  227. o Generation of REXX programs to restore objects independently of DeskMan/2 is 
  228.   disabled. 
  229. o the Skip if objects exists option is disabled. 
  230. o the Map drives function is disabled. 
  231. o the Save System Settings and Restore System Settings options are disabled 
  232.  
  233. Because DeskMan/2 saves its settings in the OS2.INI file, you will need to 
  234. reinstall DeskMan/2 and reconfigure it if you ever reinstall the operating 
  235. system and format the system partition. 
  236.  
  237. Note also that the current version of DeskMan/2 does NOT allow you to create 
  238. multiple DeskMan/2 objects.  This restriction will be lifted in a future 
  239. release. 
  240.  
  241. If you don't like the DeskMan/2 icon  supplied, you can prepare any icon you 
  242. like and replace the DESKMAN2.ICO before running the install program, or 
  243. replace the icon for the created object using DeskMan/2's Settings notebook. 
  244.  
  245.  
  246. ΓòÉΓòÉΓòÉ 5.1. Location of the DESKMAN.DLL file ΓòÉΓòÉΓòÉ
  247.  
  248. The file, DESKMAN.DLL, is DeskMan/2's key component.  On OS/2 - GA release 
  249. systems, it must be placed in a directory listed in the LIBPATH statement in 
  250. your CONFIG.SYS.  On Service Pak, OS/2 2.1, and later versions of the OS, it 
  251. can be placed in any directory. 
  252.  
  253. If DeskMan/2 is already installed on your system, the installation program will 
  254. detect your current file, and suggest using its directory as the default 
  255. location for the new file.  If an old file is not found, then the installation 
  256. program will suggest that you use the \OS2\DLL directory on your system 
  257. partition as the default location. Of course, you can always override the 
  258. installation program's suggested defaults by typing in different pathnames. 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 5.2. Location of the DESKMAN.INF file ΓòÉΓòÉΓòÉ
  262.  
  263. The DESKMAN.INF file is DeskMan/2's User's Guide.  You can read it using OS/2's 
  264. VIEW command.  It should be placed in a directory specified by the SET 
  265. BOOKSHELF statement in your CONFIG.SYS file. 
  266.  
  267. If DeskMan/2 is already installed on your system, the installation program will 
  268. detect your current file, and suggest using its directory as the default 
  269. location for the new file.  If an old file is not found, then the installation 
  270. program will suggest that you use the \OS2\BOOK directory on your system 
  271. partition as the default location. Of course, you can always override the 
  272. installation program's suggested defaults by typing in different pathnames. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 5.3. Location of the DESKMAN.HLP file ΓòÉΓòÉΓòÉ
  276.  
  277. The DESKMAN.HLP file is DeskMan/2's Help file.  It provides context-sensitive 
  278. help about all of DeskMan/2's functions. It should be placed in a directory 
  279. located on the HELP path defined in your CONFIG.SYS file. 
  280.  
  281. If DeskMan/2 is already installed on your system, the installation program will 
  282. detect your current file, and suggest using its directory as the default 
  283. location for the new file.  If an old file is not found, then the installation 
  284. program will suggest that you use the \OS2\HELP directory on your system 
  285. partition as the default location. Of course, you can always override the 
  286. installation program's suggested defaults by typing in different pathnames. 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 5.4. Object description file for the Save operations ΓòÉΓòÉΓòÉ
  290.  
  291. DeskMan/2 stores the information about your objects in a special object 
  292. description file.  By default, DeskMan/2 uses the same filenames for the Save 
  293. and Restore operations, but this can be altered at the user's discretion. 
  294.  
  295. If DeskMan/2 was previously installed, and the information is still available 
  296. from the .INI files, then the installation program will use the previously 
  297. selected pathnames for defaults during installation.  Otherwise, the 
  298. installation program will use the installation directory as the default 
  299. directory. 
  300.  
  301. If you specify a pathname with a directory that does not exist, you will be 
  302. asked if you want to create it.  We suggest that you may want to use or create 
  303. a dedicated directory to keep all the description files together. 
  304.  
  305. Note:   The default file extension for the object description file should be 
  306. DRC. 
  307.  
  308.  
  309. ΓòÉΓòÉΓòÉ 5.5. Object description file for the Restore operations ΓòÉΓòÉΓòÉ
  310.  
  311. DeskMan/2 stores the information about your objects in a special object 
  312. description file.  By default, DeskMan/2 uses the same filenames for the Save 
  313. and Restore operations, but this can be altered at the user's discretion. 
  314.  
  315. If DeskMan/2 was previously installed, and the information is still available 
  316. from the .INI files, then the installation program will use the previously 
  317. selected pathnames for defaults during installation.  Otherwise, the 
  318. installation program will use the installation directory as the default 
  319. directory. 
  320.  
  321. If you specify a pathname with a directory that does not exist, you will be 
  322. asked if you want to create it.  We suggest that you may want to use or create 
  323. a dedicated directory to keep all the description files together. 
  324.  
  325. Note:   The default file extension for the object description file should be 
  326. DRC. 
  327.  
  328.  
  329. ΓòÉΓòÉΓòÉ 5.6. Generated REXX program name ΓòÉΓòÉΓòÉ
  330.  
  331. One of the options that DeskMan/2 provides allows you to generate REXX programs 
  332. capable of recreating saved objects. 
  333.  
  334. The default location for the generated REXX program depends on whether or not 
  335. DeskMan/2 was previously installed.  If previously installed, and its 
  336. information is still available from the .INI files, then the installation 
  337. program will use the previously selected pathname by default during 
  338. installation.  Otherwise, the installation program will use the installation 
  339. directory as the default directory. 
  340.  
  341. If you specify a pathname with a directory that does not exist, you will be 
  342. asked if you want to create it.  We suggest that you may want to use or create 
  343. a dedicated directory to keep all the description files together. 
  344.  
  345. Note:   The generated REXX program should always have the CMD file extension. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 5.7. Location of the saved ICONs ΓòÉΓòÉΓòÉ
  349.  
  350. DeskMan/2 gives you the option of saving your objects' icons.  If you choose to 
  351. do this, they will be saved in .ICO files when you save your objects using 
  352. DeskMan/2's normal Save procedure.  If you later restore your objects, either 
  353. using the generated REXX program or using DeskMan/2's Restore procedure, then 
  354. these .ICO files will be used to restore your saved object icons. 
  355.  
  356. The default location for the generated .ICO files depends on whether or not 
  357. DeskMan/2 was previously installed.  If previously installed, and its 
  358. information is still available from the .INI files, then the installation 
  359. program will use the previously selected pathname by default during 
  360. installation.  Otherwise, the installation program will use the installation 
  361. directory as the default directory. 
  362.  
  363. If you specify a pathname with a directory that does not exist, you will be 
  364. asked if you want to create it.  We suggest that you may want to use or create 
  365. a dedicated directory within the directory that you use to keep all of your 
  366. description files together, just to hold your .ICO files. 
  367.  
  368.  
  369. ΓòÉΓòÉΓòÉ 5.8. Description file for System settings ΓòÉΓòÉΓòÉ
  370.  
  371. The System settings and colors of your Desktop can be saved and restored using 
  372. DeskMan/2.  The default location for this file is the installation directory. 
  373. However, if you have had DeskMan/2 installed on your system and this setting is 
  374. still available in the INI files, this directory will be used by default. 
  375.  
  376. Note:   The file should have the IRC file extension. 
  377.  
  378. These settings include: 
  379.  
  380. o Border Width 
  381. o Animation 
  382. o Print Screen 
  383. o Logo Display Time 
  384. o Cursor Blink Rate 
  385. o Key Repeat Rate 
  386. o Key Repeat Delay 
  387. o Double Click Speed 
  388. o Mouse Tracking Speed 
  389. o Display 
  390. o Active Border 
  391. o Active Title 
  392. o Background 
  393. o Button Default 
  394. o Entry Field 
  395. o Icon Text 
  396. o Menu 
  397. o Shadow Text 
  398. o Window 
  399. o Window Frame 
  400. o and many more... 
  401.  
  402. Note:   If you restore these settings, they will take effect after you reboot 
  403. the system. 
  404.  
  405. Warning:  Do not attempt to restore the color settings unto a system that does 
  406. not have the same type of video card as they were saved under. 
  407.  
  408.  
  409. ΓòÉΓòÉΓòÉ 5.9. REXX program for System settings ΓòÉΓòÉΓòÉ
  410.  
  411. The System settings and colors of your Desktop can be saved and restored using 
  412. a REXX program generated by DeskMan/2.  The default location for this file is 
  413. the installation directory. However, if you have had DeskMan/2 installed on 
  414. your system and this setting is still available in the INI files, this 
  415. directory will be used by default. 
  416.  
  417. Note:   The REXX program should always have the CMD file extension. 
  418.  
  419. These settings include: 
  420.  
  421. o Border Width 
  422. o Animation 
  423. o Print Screen 
  424. o Logo Display Time 
  425. o Cursor Blink Rate 
  426. o Key Repeat Rate 
  427. o Key Repeat Delay 
  428. o Double Click Speed 
  429. o Mouse Tracking Speed 
  430. o Display 
  431. o Active Border 
  432. o Active Title 
  433. o Background 
  434. o Button Default 
  435. o Entry Field 
  436. o Icon Text 
  437. o Menu 
  438. o Shadow Text 
  439. o Window 
  440. o Window Frame 
  441. o and many more... 
  442.  
  443. Note:   If you restore these settings, they will take effect after you reboot 
  444. the system. 
  445.  
  446. Warning:  Do not attempt to restore the color settings unto a system that does 
  447. not have the same type of video card as they were saved under. 
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ 5.10. Registering DeskMan/2 ΓòÉΓòÉΓòÉ
  451.  
  452. If you acquired a registered copy of DeskMan/2, you will be asked to register 
  453. it either during the installation process (if you check the "Do you want to 
  454. register DeskMan/2?" box), or any time after installing the product using the 
  455. online registration procedure available on the DeskMan/2  object menu. 
  456.  
  457.  
  458. ΓòÉΓòÉΓòÉ 5.11. Start installation process ΓòÉΓòÉΓòÉ
  459.  
  460. The installation process will be started after you push the Install  button. 
  461. You will see messages providing information about the progress of the 
  462. installation process. 
  463.  
  464. In case of an error (incorrect path/file information) you can correct the 
  465. values in error and restart the process. 
  466.  
  467. Note:   If you receive error messages about the program not being able to 
  468. replace the DeskMan/2 files, you should shut down your system and rerun the 
  469. installation program. 
  470.  
  471.  
  472. ΓòÉΓòÉΓòÉ 5.12. File for the debug log ΓòÉΓòÉΓòÉ
  473.  
  474. This entry field is used to specify the location and name for the debug log 
  475. used by the DeskMan/2 debug window. 
  476.  
  477. If DeskMan/2 is already installed on your system, the installation program will 
  478. detect your current file, and suggest using its directory as the default 
  479. location for the new file.  If an old file is not found, then the installation 
  480. program will suggest that you use the current installation directory as the 
  481. default location.  Of course, you can always override the installation 
  482. program's suggested defaults by typing in different pathnames. 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 5.13. Remove DeskMan/2 files ΓòÉΓòÉΓòÉ
  486.  
  487. This button enables you to remove DeskMan/2's files from the computer system, 
  488. and its entries from the .INI files.  It first confirms that you do want to 
  489. remove DeskMan/2 from your system, and then it removes the .INI entries, and 
  490. brings up the Remove Dialog box. 
  491.  
  492.  
  493. ΓòÉΓòÉΓòÉ 5.14. Default Directory Dialog ΓòÉΓòÉΓòÉ
  494.  
  495. This popup dialog appears only on initial installations of DeskMan/2. It allows 
  496. the user to declare an initial default location/path for the various storage 
  497. files. 
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ 5.15. Default Directory Field ΓòÉΓòÉΓòÉ
  501.  
  502. This is the entry field for the initial default directory within which the 
  503. various storage files will be placed.  If it does not exist, you will be given 
  504. the option of creating it. 
  505.  
  506.  
  507. ΓòÉΓòÉΓòÉ 5.16. Directory Dialog Okay ΓòÉΓòÉΓòÉ
  508.  
  509. Required to accept the displayed/entered directory.  If the user closes the 
  510. dialog box without hitting the OK button first, then the current installation 
  511. directory will be used by default. 
  512.  
  513.  
  514. ΓòÉΓòÉΓòÉ 5.17. Remove Dialog Confirmation Box ΓòÉΓòÉΓòÉ
  515.  
  516.  The Remove Dialog Confirmation box lists those files found and then allows you 
  517. to selectively choose and remove any of the files listed. 
  518.  
  519. Note:   This does not remove any object or system settings storage files, only 
  520. the product files (DESKMAN.DLL, DESKMAN.INF, etc..) 
  521.  
  522. Warning:  At this time, this option will not delete the DESKMAN.HLP file from 
  523. within the installation directory. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 5.18. Registration procedure ΓòÉΓòÉΓòÉ
  527.  
  528. DeskMan/2 displays the registration dialog during the installation process of a 
  529. registerable DeskMan/2 version. 
  530.  
  531. Enter the customer name. and the registration number in the appropriate fields, 
  532. and then confirm the entries. 
  533.  
  534. The failure to enter the correct registration number (you may try twice), will 
  535. cause DeskMan/2 to be installed as an unregistered copy with certain 
  536. limitations. The installation procedure can be repeatedly executed as desired. 
  537.  
  538.  
  539. ΓòÉΓòÉΓòÉ 5.18.1. Registration number ΓòÉΓòÉΓòÉ
  540.  
  541. A unique registration number is provided for each registered copy of DeskMan/2. 
  542. Please enter it during the installation procedure if you have a registerable 
  543. version of the product. 
  544.  
  545.  
  546. ΓòÉΓòÉΓòÉ 5.18.2. Customer name ΓòÉΓòÉΓòÉ
  547.  
  548. A customer name is recorded for each registered copy of DeskMan/2.  It is 
  549. recorded for you when you order DeskMan/2, or when you register a shareware 
  550. version of DeskMan/2.  It will be used by DeskMan/2's tech support to keep 
  551. track of your problems. 
  552.  
  553. The current customer name can be displayed using the Product information menu 
  554. item in the restore or debug windows. 
  555.  
  556.  
  557. ΓòÉΓòÉΓòÉ 6. Getting Started ΓòÉΓòÉΓòÉ
  558.  
  559. Welcome to DeskMan/2! You have obtained the finest Workplace Shell desktop 
  560. management tool available today.  To get you started, we will quickly review 
  561. the most basic functions of DeskMan/2: 
  562.  
  563. o How to Save your entire Desktop 
  564. o How to Restore your entire Desktop 
  565. o How to Restore your entire Desktop using REXX 
  566. o How to Save one or more selected objects 
  567. o How to Restore one or more selected objects 
  568. o How to Restore one or more selected objects using REXX 
  569. o How to Restore your objects onto another system (See Below) 
  570. o A brief overview of DeskMan/2's special functions 
  571.  
  572. Note:   When the Templates folder is being saved, it may cause Help for the 
  573. Data file to be displayed.  This is caused by a bug in WPS.  The Help can be 
  574. closed, although it might open itself again if still processing the Templates 
  575. folder, but there are no known negative side effects of this strange behavior. 
  576.  
  577. Additionally, here are a few tricks and tips which we have learned: 
  578.  
  579. o If you want to transfer your desktop objects between two (or more) systems, 
  580.   such as between your home and your office, try this: 
  581.  
  582.     1. Set up a dedicated directory on each of your systems to hold DeskMan/2's 
  583.        various description files.  Set up a second directory within the first, 
  584.        just to hold the various .ICO files. 
  585.  
  586.     2. Make sure that the Save and Restore settings pages properly indicate 
  587.        filenames within the dedicated directories.  For example, use 
  588.        C:\TRANSFER\DESKMAN.DRC for your Restore and Save .DRC files, and use 
  589.        C:\TRANSFER\ICON for your .ICO directory.  You can also disable your 
  590.        REXX Save in order to conserve time and space, at this time. 
  591.  
  592.     3. Before leaving home or work, simply run Save Desktop, then copy, or 
  593.        compress and then copy, the files out of the dedicated directories 
  594.        (including all the .ICO files), onto a transportable media, such as a 
  595.        floppy disk. 
  596.  
  597.     4. Upon arriving at the other computer, simply replace the files currently 
  598.        on the system with the saved files from the other system, decompressing 
  599.        them if necessary, into the proper directory or directories. 
  600.  
  601.     5. Run CLEANUP.CMD to remove all non-used .ICO files from the icon 
  602.        directory.  This is done in the form, CLEANUP (description file 
  603.        directory) (icon file directory).  For example, in the setup described 
  604.        above, it would be Cleanup C:\TRANSFER C:\TRANSFER\ICON. 
  605.  
  606.     6. Run Restore Desktop - Update if exists, or do a selective restore, as 
  607.        described below. 
  608.  
  609. o One of the best ways that we've found to do a fast selective restoration of 
  610.   your objects is to open up the Restore container window, display it in Tree 
  611.   view by selecting that option off of the container window's main menu's 
  612.   Window submenu, and use the drag and drop interface to simply drag off the 
  613.   objects that you want restored onto your desktop, placing them where you want 
  614.   them. This has the added feature of recreating all objects, including 
  615.   folders, contained within the object dragged out of the Restore container 
  616.   window. 
  617.  
  618.   Note:   If you try a Restore Desktop using the new OS/2 2.1 beta, and the WPS 
  619.   locks up, try the above method of restoration. 
  620.  
  621. o You may have noticed, when bringing up the Restore container window, that 
  622.   some of your objects, particularly your system objects, display a white 
  623.   question mark on a green circle, instead of what you've come to recognize as 
  624.   their normal icons.  If ALL your objects are displayed in this fashion, you 
  625.   have not turned on the Save Icon feature.  If only some of your objects are 
  626.   being displayed in this way, then there is another reason.  Many of your 
  627.   system objects do not have .ICO files associated with them, but rather have 
  628.   what are called Icon Resources, which are stored in various .DLLs in the 
  629.   system.  When you perform a normal Save of that object, the information being 
  630.   saved includes a reference to that Icon Resource, rather than to an .ICO 
  631.   file.  The Restore container window, when it obtains the icons displayed 
  632.   within it, does so from the .ICO files, and does not access the various DLLs 
  633.   on your system.  Of course, objects restored by DeskMan/2 which use Icon 
  634.   Resources will display, after restoration, the correct icon, assuming that 
  635.   the resource is present. 
  636.  
  637. o However, if you want to see the actual icons of those objects now displayed 
  638.   by a white question mark on a green circle, and you have the Save Icon 
  639.   feature turned on, then you will need to force the object to use an .ICO 
  640.   file.  This can be done quite simply.  All you need do is first open the 
  641.   settings on the object whose icon you wish to save, go to the general 
  642.   settings page, and edit the icon image.  You need not make any actual 
  643.   changes, just click on a single spot on the image, using the same color, and 
  644.   then tell the window to close.  As it starts to do so, it will ask you if the 
  645.   changes should be saved.  Say 'yes', and proceed accordingly.  When next you 
  646.   save this object, its image will be saved along with it.  Of course, when you 
  647.   install a later version of OS/2, this saved image will no longer be in use, 
  648.   as the new object, replacing the old one, will undoubtedly use an Icon 
  649.   Resource, once more.  Of course, this procedure can be repeated, as desired. 
  650.  
  651. o If you want to see the object, its class, location, settings, and when it was 
  652.   saved, just open up EPM (or any PM editor that supports Drag and Drop 
  653.   protocols), from any OS/2 command prompt, and then open up the DeskMan/2 
  654.   restore container.  Drag the icon of the object for which you want this 
  655.   information from the restore container onto the editor's window, drop it, and 
  656.   the object's information will be imported into your editor! 
  657.  
  658. o Please note that this product will not completely save all settings with 
  659.   Printer objects, since they are not handled by the Workplace Shell, but 
  660.   rather by the Printer objects themselves.  It will backup the object, and 
  661.   restore it, but you will have to install the drivers yourself.  IBM does have 
  662.   a product for remote installation of printer objects over a network, if such 
  663.   is your need. 
  664.  
  665. o If you open the DeskMan/2 restore container (double click on the DeskMan/2 
  666.   icon) and you don't see it open immediately - check the window list. If you 
  667.   can see the DeskMan/2 entry there, it means that the window DID open but that 
  668.   it is positioned outside of the visible desktop area.  Select the DeskMan/2 
  669.   entry in the Window list, bring up the popup menu (right Mouse Button) and 
  670.   select Tile or Cascade.  If you now close the window, its position, size, 
  671.   fonts and colors will be saved and remebered from this time now on... The 
  672.   same procedure will work with the DeskMan/2 Debug window. 
  673.  
  674.  
  675. ΓòÉΓòÉΓòÉ 7. Saving objects ΓòÉΓòÉΓòÉ
  676.  
  677. Saving your objects is easy! You simply select an object and drag it to the 
  678. DeskMan/2 icon. You will see a dialog box displaying information about objects 
  679. processed - when it disappears, the save is complete. 
  680.  
  681. You can select multiple objects at the same time (Ctrl-MouseButton1 or Ctrl-/ 
  682. for all objects) and drag them all to DeskMan/2 - they will be saved one after 
  683. another. The folders will be automagically populated (registered version 
  684. only!), so there is no need to open folders and save the contents after you 
  685. saved the folder itself (unless the resolve folders option is not set). 
  686.  
  687. If you wondered whether there is a simple way to save your complete Desktop, 
  688. the answer is: yes.! 
  689.  
  690. There are three possible ways of doing that: 
  691.  
  692. o DeskMan/2's context menu has a Save Desktop item available. When you select 
  693.   it, all objects existing on your desktop will be saved in the current object 
  694.   description file, 
  695.  
  696. o you can open Drives, select the drive with your Desktop on it, find the 
  697.   Desktop's icon, drop it on DeskMan/2. If the Resolve folders option was set, 
  698.   your entire desktop will be saved. 
  699.  
  700. o you can select all objects on your Desktop (by pressing Ctrl-/) and drag to 
  701.   DeskMan/2. All of them will be saved one after another. 
  702.  
  703. Note:   You must be aware that if you perform a "total" save for the entire 
  704. desktop, some of the saved standard system objects (productivity, games, etc.) 
  705. will be saved with settings appropriate for the current version of the 
  706. operating system. Caution is recommended when restoring them on a different 
  707. version of the operating system. You may want to inspect the setup strings for 
  708. those objects and modify them if necessary using the Change setup function of 
  709. the Restore window. 
  710.  
  711. If you opened the default DeskMan/2 view by clicking on its icon or selected 
  712. Open -> DeskMan file from the context menu, and the current object description 
  713. file is the same as the file selected for the Restore operation, the contents 
  714. of the view (the container displaying the file) will be updated with the saved 
  715. objects, using the settings for the Save operation, i.e. objects will be 
  716. replaced or updated. However, if a Save operation is currently in progress, the 
  717. restore window will not open until Save finishes. 
  718.  
  719. During the processing of dropped objects (Save function), you will see a 
  720. DeskMan/2 window telling you which object is currently being processed. This 
  721. window also has a single menu item available - Cancel processing. If you should 
  722. decide that the Save operation is performing incorrectly, you can select this 
  723. item to interrupt the processing. 
  724.  
  725. Note:   DeskMan/2 functions as a Workplace Shell process. This means that the 
  726. WPS (desktop) will respond very slowly to any user's activities once DeskMan/2 
  727. is performing a Save operation. The Save operation requires the desktop to be 
  728. in stable condition at the moment the operation is performed. Please avoid any 
  729. actions that may affect it! This especially includes creating, deleting, 
  730. opening and changing objects. 
  731.  
  732. DeskMan/2 is a very resource hungry beast! Please close all running processes 
  733. before performing complex Save operations. 
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 8. Restoring objects ΓòÉΓòÉΓòÉ
  737.  
  738. When you need to (re)create any object you previously saved, you can do so in 
  739. one of two different ways: 
  740.  
  741. o by running the generated REXX program (if this option was checked at the time 
  742.   of save). 
  743.  
  744. o by selecting the Open item from DeskMan/2's context menu and one of the 
  745.   items: DeskMan file or Standard objects. 
  746.  
  747. The Standard objects are the objects created on your desktop by the install 
  748. program when you installed OS/2. Their description is kept in a special system 
  749. file (INI.RC) located in \OS2 directory. This file may contain objects that 
  750. were not necessarily created on your system (if you have done a Selective 
  751. install or installed Preselected features). If you try to create such an 
  752. object, you may succeed, but the object may not work correctly because the 
  753. files needed will be missing. 
  754.  
  755. Note:   If you open DeskMan/2 for the restore function and don't see any 
  756. window, this means that you closed it the last time (or did a "Shut down") in 
  757. the minimized/hidden state. To make it visible, display the Window List, select 
  758. the entry for DeskMan/2, bring up the context menu, select cascade. The window 
  759. should come back. 
  760.  
  761. DeskMan/2 functions as a Workplace Shell process. This means, that WPS 
  762. (desktop) will respond very slowly to any user's activities once DeskMan/2 is 
  763. performing a Restore operation. The Restore operation requires the desktop to 
  764. be in stable condition at the moment the operation is performed. Please avoid 
  765. any actions that may affect it! This includes especially creating, deleting, 
  766. opening and changing objects. 
  767.  
  768. DeskMan/2 is a very resource hungry beast! Please close all running processes 
  769. before performing complex Restore operations. 
  770.  
  771.  
  772. ΓòÉΓòÉΓòÉ 8.1. Running the REXX program ΓòÉΓòÉΓòÉ
  773.  
  774. The generated REXX program allows you to restore your objects without needing 
  775. to have DeskMan/2 installed on the current system (a specific REXX version is 
  776. required - see: Installing DeskMan/2).  This method, although very simple and 
  777. sufficient in most cases, offers you very limited options. 
  778.  
  779. After you start the program, you will be asked which restore option you want to 
  780. use: 
  781.  
  782. o Replace - will replace objects if they already exist on the desktop, missing 
  783.   objects will be restored. 
  784.  
  785. o Update - already existing objects will be updated, missing objects will be 
  786.   restored. 
  787.  
  788. o Skip - objects will not be changed if they already exist on the desktop, 
  789.   missing objects will be restored. 
  790.  
  791. Note:   All of the above options require the setting Assign OBJECTID for each 
  792. object to be checked for Save.  This is set by default during a new 
  793. installation.  If not set, duplicate objects may be created. However, you can 
  794. safely remove the duplicates and really don't need to worry about OBJECTIDs not 
  795. being assigned during the Save operation. 
  796.  
  797. If you want to keep the restore option that was active when you saved the 
  798. objects, enter blank. You will see messages telling you about objects that 
  799. could not be (re)created - those do not necessarily mean an error. If the 
  800. current option is Skip If Exist, and the object already exists on the desktop, 
  801. the message is OK. Otherwise, it may point to a potential problem with the 
  802. WPS... 
  803.  
  804. Note:   The objects need to be recreated in certain sequence, i.e. the folders 
  805. before their contents. When you perform Save operations by dropping complete 
  806. folders or executing Save desktop, this sequence will be automatically created 
  807. for the REXX program. If you perform a single-object Save operation, you may 
  808. need to inspect the generated REXX program and eventually to modify it, if 
  809. required. 
  810.  
  811. When you save objects that do not have one of the default WPS classes, i.e. the 
  812. class name does not start with the letters WP, the following line will be added 
  813. to the generated REXX program: 
  814.  
  815.        rc=SysRegisterObjectClass('DMan','C:\OS2\DLL\DESKMAN.DLL');
  816.  
  817. which will try to register the class (in this example the class name is DMan) 
  818. prior to creating the object. As you can see, it contains a reference to the 
  819. class DLL. It is the user's responsibility to assure that this DLL is located 
  820. in the correct directory, or to modify the program to reflect the current 
  821. location. 
  822.  
  823. The REXX program contains calls to SysCreateObject function, which will 
  824. (re)create the objects in the sequence they were originally processed by 
  825. DeskMan/2. It may happen that this sequence will be disturbed (for example you 
  826. processed the contents of the folder before processing the folder itself) and 
  827. may not work when restoring objects. It can be necessary to examine the 
  828. generated program before attempting to run it. Note also that the objects 
  829. created using the program will be restored properly only if the folder in which 
  830. they are located already exists on your desktop. If you want to recreate a 
  831. single object (or a group of objects) without recreating the folder, you will 
  832. have to edit the program and change the object's location (i.e. the third 
  833. parameter of the SysCreateObject call). For example, if you have following call 
  834. in the REXX program: 
  835.  
  836. rc=SysCreateObject("DMan","DeskMan/2","<My_folder>",,
  837.   "OBJECTID=<DeskMan1>;"||,
  838.   "HELPPANEL=0;"||,
  839.   "NOCOPY=YES;"||,
  840.   "NOPRINT=YES;"||,
  841.   "ICONFILE=C:\0011FBF6.ICO;"||,
  842.   '', reply);
  843. and the folder My_folder does not exist on your desktop, you can change it to: 
  844.  
  845. rc=SysCreateObject("DMan","DeskMan/2","<WP_DESKTOP>",,
  846.   "OBJECTID=<DeskMan1>;"||,
  847.   "HELPPANEL=0;"||,
  848.   "NOCOPY=YES;"||,
  849.   "NOPRINT=YES;"||,
  850.   "ICONFILE=C:\0011FBF6.ICO;"||,
  851.   '', reply);
  852. to recreate the object on your desktop and then move the object to any folder 
  853. you want. 
  854.  
  855.  
  856. ΓòÉΓòÉΓòÉ 9. The Special Functions ΓòÉΓòÉΓòÉ
  857.  
  858. DeskMan/2 offers a number of Special functions which can be very useful.. 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ 10. Restore window Menus ΓòÉΓòÉΓòÉ
  862.  
  863. DeskMan/2's Restore Window, this window (which implements a container window) 
  864. will be displayed after you: 
  865.  
  866. o Double-click on the DeskMan/2 icon.  This causes the default action for this 
  867.   object, opening the DeskMan/2 object description file's restore window. 
  868.  
  869. o Activate DeskMan/2's context menu (also called a popup menu) by using the 
  870.   right mouse button and select Open -> DeskMan file or  Open -> Standard 
  871.   objects 
  872.  
  873. The container can be displayed in a variety of views and each of the views 
  874. (except the tree view) supports the extended selection mechanism. 
  875.  
  876. Various actions can be performed using the system menu or the menu bar items or 
  877. the context menus: 
  878.  
  879. o container context menu 
  880.  
  881. o objects' context menu, or the 
  882.  
  883. o drag and drop interface. 
  884.  
  885.  
  886. ΓòÉΓòÉΓòÉ 10.1. System menu ΓòÉΓòÉΓòÉ
  887.  
  888. The container's system menu has the following items upon it: 
  889.  
  890. o the Open submenu 
  891.  
  892. o the DeskMan/2 and System Help submenu, which includes the online registration 
  893.   menu item 
  894.  
  895. o the Window submenu with features described below 
  896.  
  897. o the Save desktop menu item 
  898.  
  899. o the Restore desktop submenu 
  900.  
  901. o the Save System settings menu item 
  902.  
  903. o the Restore System settings menu item 
  904.  
  905. o the Save objects menu item 
  906.  
  907. o the Special functions submenu 
  908.  
  909. o the Close menu item to close the restore window 
  910.  
  911. The container's Window submenu has additional items for the view selection: 
  912.  
  913. o icon view 
  914.  
  915. o details view 
  916.  
  917. o name view 
  918.  
  919. o text view 
  920.  
  921. o tree icon view 
  922.  
  923. o use mini icons changes the icon size used in view having icons displayed. 
  924.  
  925. All views provide the same functions - except the tree view which has the Sort 
  926. and Select all menu items disabled. 
  927.  
  928.  
  929. ΓòÉΓòÉΓòÉ 10.1.1. Icon view ΓòÉΓòÉΓòÉ
  930.  
  931. The container contents will be displayed in the Icon view in a non-grid format. 
  932. The icons will be located randomly about the screen without any ordered 
  933. arrangement. However, you can use the sort function to order them in one of the 
  934. possible orders or use the arrange to spread them over the entire window. 
  935.  
  936. The icons can be displayed in their default size or in "mini" size - the size 
  937. can be selected using the window's system menu system menu  or by checking Use 
  938. mini icons on the  Restore  page of DeskMan/2's settings. 
  939.  
  940. This view provides you only with the name and the icon of an object. 
  941.  
  942.  
  943. ΓòÉΓòÉΓòÉ 10.1.2. Details View ΓòÉΓòÉΓòÉ
  944.  
  945. The container contents will be displayed in the Details view. The icons will be 
  946. arranged in a column across the screen in the order in which they were found in 
  947. the object description file. However, you can use the sort function to order 
  948. them in one of the possible sequences. The information about the objects will 
  949. be displayed in the following categories: 
  950.  
  951.  1. Icon - shows the icon assigned to this object, or the  icon, or the icon. 
  952.     will be displayed for objects having their icons located in private or 
  953.     system DLL's.  Since those DLLs can't be loaded by DeskMan/2 (they may 
  954.     require a specific initialization sequence and/or environment), a generic 
  955.     icon is used. 
  956.     The shadows will have a special icon displayed. 
  957.  
  958.     The icons can be displayed in their default size or in "mini" size - the 
  959.     size can be selected using the window's system menu  or by checking Use 
  960.     mini icons on the  Restore  page of DeskMan/2's settings, 
  961.  
  962.  2. Title - is object's title. 
  963.  
  964.  3. Class - is the object's class. 
  965.  
  966.  4. Location - is the OBJECTID of the folder where the object was located at 
  967.     the time of Save or the physical path for objects of the WP*File classes. 
  968.  
  969.  5. Date - is the date when the object was saved or updated last time using 
  970.     DeskMan/2, or blank for default objects. 
  971.  
  972.  6. Time - the time the object was saved or updated last, or blank for default 
  973.     objects. 
  974.  
  975.  7. Folder's title - the parent folder's title, if it could be found in the 
  976.     current object description file. 
  977.  
  978.  
  979. ΓòÉΓòÉΓòÉ 10.1.3. Name View ΓòÉΓòÉΓòÉ
  980.  
  981. The container contents will be displayed in the name view in a flowed format. 
  982. The icons will be arranged in columns across the screen in the order in which 
  983. they were found in the object description file. However, you can use the sort 
  984. function to order them in one of the possible sequences. 
  985.  
  986. The icons can be displayed in their default size or in "mini" size - the size 
  987. can be selected using the window's system menu  or by checking Use mini icons 
  988. on the  Restore  page of DeskMan/2's settings. 
  989.  
  990. This view provides you only with the name and the icon of an object. 
  991.  
  992.  
  993. ΓòÉΓòÉΓòÉ 10.1.4. Text View ΓòÉΓòÉΓòÉ
  994.  
  995. The container contents will be displayed in the text view in a flowed format. 
  996. The icons will be arranged in columns across the screen in the order in which 
  997. they were found in the object description file. However, you can use the sort 
  998. function to order them in one of the possible sequences. 
  999.  
  1000. This view provides you only with the name of an object. 
  1001.  
  1002.  
  1003. ΓòÉΓòÉΓòÉ 10.1.5. Tree icon View ΓòÉΓòÉΓòÉ
  1004.  
  1005. The container contents will be displayed in the tree icon view in a lines 
  1006. format. The icons will be arranged in a tree-like structure reflecting the 
  1007. dependencies between the objects. 
  1008.  
  1009. The icons can be displayed in their default size or in "mini" size - the size 
  1010. can be selected using the window's system menu  or by checking Use mini icons 
  1011. on the  Restore  page of DeskMan/2's settings. 
  1012.  
  1013. This view provides you only with the name and the icon of an object. 
  1014.  
  1015. Note:   Switching to/from this view from/to any other view requires the 
  1016. container contents to be reloaded, so it may take some time to display the new 
  1017. view selected. 
  1018.  
  1019.  
  1020. ΓòÉΓòÉΓòÉ 10.1.6. Icon size selection ΓòÉΓòÉΓòÉ
  1021.  
  1022. The size of the icons used in views having icons displayed can be changed. 
  1023.  
  1024. The icons can be displayed in their default size or in "mini" size - the size 
  1025. can be selected using the window's system menu  or by checking Use mini icons 
  1026. on the  Restore  page of DeskMan/2's settings. 
  1027.  
  1028. Note:   Preparing the view using mini icons takes more time than if using the 
  1029. default size. 
  1030.  
  1031.  
  1032. ΓòÉΓòÉΓòÉ 10.2. Container menu bar items ΓòÉΓòÉΓòÉ
  1033.  
  1034. The container's menu bar has the following items available: 
  1035.  
  1036. o the File submenu. 
  1037.  
  1038. o the Objects submenu. 
  1039.  
  1040. o the Help submenu. 
  1041.  
  1042.  
  1043. ΓòÉΓòÉΓòÉ 10.2.1. File ΓòÉΓòÉΓòÉ
  1044.  
  1045. The file menubar item gives the choice of: 
  1046.  
  1047. o Open to open another object description file or the OS/2 INI.RC file 
  1048.   describing the standard WPS objects. 
  1049.  
  1050. o Save to save the current container contents. 
  1051.  
  1052. o Save As to save the current container contents under a different file name. 
  1053.  
  1054. o Sort to sort the current container contents using one of the provided sort 
  1055.   criteria. 
  1056.  
  1057.  
  1058. ΓòÉΓòÉΓòÉ 10.2.1.1. File - Open ΓòÉΓòÉΓòÉ
  1059.  
  1060. Open another decription file. A file dialog will allow you to select any object 
  1061. description file in RC file format, including the file containing the 
  1062. description for the standard OS/2 objects - \OS2\INI.RC. 
  1063.  
  1064.  
  1065. ΓòÉΓòÉΓòÉ 10.2.1.2. Save ΓòÉΓòÉΓòÉ
  1066.  
  1067. The current contents of the object description file displayed in the Restore 
  1068. container will be saved. 
  1069.  
  1070. The order in which the objects will be written to the object description file 
  1071. depends upon the order in which they were displayed in the container, i.e. if 
  1072. the current view is a tree view, the objects will be saved in their 
  1073. hierarchical order, folders before their contents. This can be the most 
  1074. desirable order.  On the other hand, if the current view is any other view 
  1075. (which may have been sorted using any of the sort orders), the objects will be 
  1076. written to the object description file in this established order. 
  1077.  
  1078. Note:   This selection is disabled for the standard OS/2 INI.RC file. 
  1079.  
  1080.  
  1081. ΓòÉΓòÉΓòÉ 10.2.1.3. Save As ΓòÉΓòÉΓòÉ
  1082.  
  1083. The current contents of the object description file displayed in the Restore 
  1084. container will be saved. You can select a new name for the file. 
  1085.  
  1086. The order in which the objects will be written to the object description file 
  1087. depends upon the order in which they were displayed in the container, i.e. if 
  1088. the current view is a tree view, the objects will be saved in their 
  1089. hierarchical order, folders before their contents. This can be the most 
  1090. desirable order.  On the other hand, if the current view is any other view 
  1091. (which may have been sorted using any of the sort orders), the objects will be 
  1092. written to the object description file in this established order. 
  1093.  
  1094.  
  1095. ΓòÉΓòÉΓòÉ 10.2.1.4. Sort ΓòÉΓòÉΓòÉ
  1096.  
  1097. The current contents of the object description file displayed in the Restore 
  1098. container can be sorted. 
  1099.  
  1100. The following sort criteria can be used: 
  1101.  
  1102. o by object's title, this is the default selection from the sort submenu. 
  1103.  
  1104. o by folder's title, the parent folder's name (i.e. the folder in which the 
  1105.   object is located). 
  1106.  
  1107. o by date and time of the save or the last update. 
  1108.  
  1109. o by object's class. 
  1110.  
  1111. Note:   The sort order will be preserved when you save the object description 
  1112. file. 
  1113.  
  1114.  
  1115. ΓòÉΓòÉΓòÉ 10.2.1.4.1. Sort by Title ΓòÉΓòÉΓòÉ
  1116.  
  1117. The current contents of the object description file displayed in the Restore 
  1118. container will be sorted using the object's title as the sort criteria. 
  1119.  
  1120. Note:   The sort order will be preserved when you save the object description 
  1121. file. 
  1122.  
  1123.  
  1124. ΓòÉΓòÉΓòÉ 10.2.1.4.2. Sort by folders's Title ΓòÉΓòÉΓòÉ
  1125.  
  1126. The current contents of the object description file displayed in the Restore 
  1127. container will be sorted using the title of the folder in which the object is 
  1128. located, as the sort criteria. 
  1129.  
  1130. Note:   The sort order will be preserved when you save the object description 
  1131. file. 
  1132.  
  1133.  
  1134. ΓòÉΓòÉΓòÉ 10.2.1.4.3. Sort by date and time ΓòÉΓòÉΓòÉ
  1135.  
  1136. The current contents of the object description file displayed in the Restore 
  1137. container will be sorted using the date and time when the object was saved or 
  1138. last time changed using change setup, as the sort criteria. 
  1139.  
  1140. Note:   The sort order will be preserved when you save the object description 
  1141. file. 
  1142.  
  1143.  
  1144. ΓòÉΓòÉΓòÉ 10.2.1.4.4. Sort by class ΓòÉΓòÉΓòÉ
  1145.  
  1146. The current contents of the object description file displayed in the Restore 
  1147. container will be sorted using the class name as the sort criteria. 
  1148.  
  1149. Note:   The sort order will be preserved when you save the object description 
  1150. file. 
  1151.  
  1152.  
  1153. ΓòÉΓòÉΓòÉ 10.2.2. Objects ΓòÉΓòÉΓòÉ
  1154.  
  1155. Various actions can be performed on objects selected (highlighted) in the 
  1156. restore container.  Multiple objects can be selected using the mouse and the 
  1157. keyboard.  To select multiple objects you can: 
  1158.  
  1159. o press Ctrl and click multiple objects using the mouse, or 
  1160.  
  1161. o press Ctrl and use Space bar to select/deselect the objects. 
  1162.  
  1163. o press Ctrl-/ to select or Ctrl-\ to deselect all the objects. 
  1164.  
  1165. The following submenu items are available: 
  1166.  
  1167. o create object to (re)create selected objects. 
  1168.  
  1169. o create folder to (re)recreate selected folders. 
  1170.  
  1171. o select all for folder to select objects located in the same folder. 
  1172.  
  1173. o find folder to locate the parent folder. 
  1174.  
  1175. o change setup to change the setup string for an object. 
  1176.  
  1177. o map drives to change references to a certain drive letter. 
  1178.  
  1179. o remove description to remove the description of an object from the displayed 
  1180.   object description file 
  1181.  
  1182. o generate REXX to generate a REXX program capable of recreating the selected 
  1183.   object. 
  1184.  
  1185.  
  1186. ΓòÉΓòÉΓòÉ 10.2.2.1. Create object ΓòÉΓòÉΓòÉ
  1187.  
  1188. All selected (highlighted) objects will be recreated. 
  1189.  
  1190. The object's location will be the same as it was when the Save operation was 
  1191. performed. 
  1192.  
  1193. The current restore option will be used: 
  1194.  
  1195. o Replace if object exists 
  1196.  
  1197.   if the prompt on update option is checked, you will be asked for 
  1198.   confirmation. 
  1199.  
  1200. o Update if object exists 
  1201.  
  1202.   if the prompt on update option is checked, you will be asked for 
  1203.   confirmation. 
  1204.  
  1205. o Skip if object exists 
  1206.  
  1207.   if the search everywhere option is checked, DeskMan/2 will search your entire 
  1208.   desktop trying to locate the selected object before recreating it. 
  1209.  
  1210. Before the object is recreated, DeskMan/2 checks for the existence of the 
  1211. folder in which the object should be placed. If the target folder does not 
  1212. exist, you will be notified, and will have an option of either cancelling the 
  1213. request or requesting that the object be placed on the Desktop. You can move 
  1214. the object to any folder after it is created. 
  1215.  
  1216. Warning:   If you use the Replace option for existing objects on your desktop 
  1217. and you recreate a folder which already exists, its entire contents will be 
  1218. deleted as the result of the create operation. 
  1219.  
  1220. If multiple objects were selected for this operation, they will be created in 
  1221. their hierarchical order.  Their hierarchical order means that the folders will 
  1222. be created before any object that is located in them. 
  1223.  
  1224.  
  1225. ΓòÉΓòÉΓòÉ 10.2.2.2. Create folder ΓòÉΓòÉΓòÉ
  1226.  
  1227. Create folder function allows you to create complete folders including all 
  1228. objects located in them. 
  1229. If the selected (highlighted) object is a Folder, all objects from the object 
  1230. description file having this folder as the location, will participate in the 
  1231. create operation. 
  1232. If the selected object is NOT a folder, all objects having the same location as 
  1233. the selected one and the folder holding this object, will participate in the 
  1234. create operation. 
  1235. The current recreate option for the Restore operation (as specified in the 
  1236. Settings) will be used if the object already exists in the target folder. 
  1237.  
  1238. o Replace if object exists 
  1239.  
  1240.   if the prompt on update option is checked, you will be asked for 
  1241.   confirmation. 
  1242.  
  1243. o Update if object exists 
  1244.  
  1245.   if the prompt on update option is checked, you will be asked for 
  1246.   confirmation. 
  1247.  
  1248. o Skip if object exists 
  1249.  
  1250.   if the search everywhere option is checked, DeskMan/2 will search your entire 
  1251.   desktop trying to locate the selected object before recreating it. 
  1252.  
  1253. You can also select the depth for the restore operation: 
  1254.  
  1255. o this folder only - if selected, will create objects from the selected 
  1256.   folder(s) only (default selection). 
  1257.  
  1258. o include subfolders - if selected, will create objects from the selected 
  1259.   folder(s) and all subfolders located in it. 
  1260.  
  1261. Warning:   If you use the Replace option for existing objects on your desktop 
  1262. and you recreate a folder which already exists, its entire contents will be 
  1263. deleted as the result of the create operation. 
  1264.  
  1265. If multiple objects were selected for this operation, they will be created in 
  1266. their hierarchical order.  The hierarchical order means that the folders will 
  1267. be created before any object located in them. 
  1268.  
  1269.  
  1270. ΓòÉΓòÉΓòÉ 10.2.2.2.1. Create folder - this folder only ΓòÉΓòÉΓòÉ
  1271.  
  1272. The Create folder function allows you to create complete folders including all 
  1273. objects located in them. 
  1274. If the selected (highlighted) object is a Folder, all objects from the object 
  1275. description file having this folder as the location, will participate in the 
  1276. create operation. 
  1277. This function will not recreate automatically the contents of the subfolders 
  1278. located in the selected folder. 
  1279. If the selected object is not a folder, all objects having the same location as 
  1280. the selected one and the folder holding this object itself, will participate in 
  1281. the create operation. 
  1282.  
  1283. Warning:   If you use the Replace option for existing objects on your desktop 
  1284. and you recreate a folder which already exists, its entire contents will be 
  1285. deleted as the result of the create operation. 
  1286.  
  1287. If multiple objects were selected for this operation, they will be created in 
  1288. their hierarchical order.  The hierarchical order means that the folders will 
  1289. be created before any object located in them. 
  1290.  
  1291.  
  1292. ΓòÉΓòÉΓòÉ 10.2.2.2.2. Create folder - include subfolders ΓòÉΓòÉΓòÉ
  1293.  
  1294. The Create folder function allows you to create complete folders including all 
  1295. objects located in them. 
  1296. If the selected (highlighted) object is a Folder, all objects from the object 
  1297. description file having this folder as the location, will participate in the 
  1298. create operation. 
  1299. This function will recreate automatically the contents of the subfolders 
  1300. located in the selected folder. 
  1301. If the selected object is NOT a folder, all objects having the same location as 
  1302. the selected one and the folder holding this object itself, will participate in 
  1303. the create operation. 
  1304.  
  1305. Warning:   If you use the Replace option for existing objects on your desktop 
  1306. and you recreate a folder which already exists, its entire contents will be 
  1307. deleted as the result of the create operation. 
  1308.  
  1309. If multiple objects were selected for this operation, they will be created in 
  1310. their hierarchical order. The hierarchical order means that the folders will be 
  1311. created before any object located in them. 
  1312.  
  1313.  
  1314. ΓòÉΓòÉΓòÉ 10.2.2.3. Select all for folder ΓòÉΓòÉΓòÉ
  1315.  
  1316. The Select all for folder function allows you to select complete folders 
  1317. including all objects located in them. It can be used before performing the 
  1318. recreate folder or recreate object operation, or any other operation if you 
  1319. want to customize the set of objects passed to them. 
  1320.  
  1321. Objects can be selected for: 
  1322.  
  1323. o one level only, i.e. the objects located in subfolders will not be selected, 
  1324.   or 
  1325.  
  1326. o including subfolders, i.e. the objects located in the subfolders in the 
  1327.   folder selected will be selected, too. 
  1328.  
  1329. o parent folders. 
  1330.  
  1331.  
  1332. ΓòÉΓòÉΓòÉ 10.2.2.3.1. Select all - one level only ΓòÉΓòÉΓòÉ
  1333.  
  1334. The One level only option selects objects located in the already selected 
  1335. folders or objects having the same location as the selected object. It will not 
  1336. select objects for (sub)folders located in the selected folder. 
  1337.  
  1338.  
  1339. ΓòÉΓòÉΓòÉ 10.2.2.3.2. Select all - including subfolders ΓòÉΓòÉΓòÉ
  1340.  
  1341. The including subfolders option selects objects located in the already selected 
  1342. folders or objects having the same location as the selected object. It will 
  1343. select objects for (sub)folders located in the selected folder. 
  1344.  
  1345.  
  1346. ΓòÉΓòÉΓòÉ 10.2.2.3.3. Select all - parent folders ΓòÉΓòÉΓòÉ
  1347.  
  1348. The parent folders option selects folders which are necessary to recreate given 
  1349. object in his original location. 
  1350.  
  1351.  
  1352. ΓòÉΓòÉΓòÉ 10.2.2.4. Find folder ΓòÉΓòÉΓòÉ
  1353.  
  1354. This function will search for the parent folder for the selected object, i.e. 
  1355. the folder in which the object is located, and put the cursored emphasis on it 
  1356. (a thin continuous border), and highlight it as well. 
  1357.  
  1358.  
  1359. ΓòÉΓòÉΓòÉ 10.2.2.5. Change setup ΓòÉΓòÉΓòÉ
  1360.  
  1361. Allows you to change the setup string for the selected object. 
  1362.  
  1363.  
  1364. ΓòÉΓòÉΓòÉ 10.2.2.6. Map drives ΓòÉΓòÉΓòÉ
  1365.  
  1366. This function will scan and change the setup string for selected objects. 
  1367.  
  1368. If the setup string contains references to physical drives (.EXE or .CMD files 
  1369. for program names, working directory, etc.) and you recreate the objects on a 
  1370. system with different drive letters, those references will be incorrect. You 
  1371. can either manually change the setup strings for each object or request 
  1372. DeskMan/2 to perform the change for you for all selected objects.  After you 
  1373. select this option, a map drives dialog will ask you which drive letter should 
  1374. be substituted (the from value) with a current value (the to value).  This 
  1375. function will, upon completion, notify you as to the number of objects's setup 
  1376. strings that had to be changed. 
  1377.  
  1378. Note:   This operation has nothing to do with the physical location of the 
  1379. object, i.e. you can not request an object that was located on the desktop in 
  1380. partition C to be placed on the desktop in partition X.  The object's location 
  1381. is determined by the folder's location (the desktop in the highest instance). 
  1382.  
  1383. It is designed primarily for changes of Path and Current directory values 
  1384. specified for Program objects.  They will have to change if you have moved the 
  1385. directories, in which they were located at the time of the save operation, to 
  1386. another partition. 
  1387.  
  1388. Warning:   This function does NOT remap the location of your saved icon files! 
  1389. You must either manually edit and change the pathnames in your .DRC or .CMD 
  1390. files, or place your .ICO files in the same physical location, in order to 
  1391. allow DeskMan/2 to properly access them. 
  1392.  
  1393.  
  1394. ΓòÉΓòÉΓòÉ 10.2.2.7. Remove description ΓòÉΓòÉΓòÉ
  1395.  
  1396.  Remove description - will remove the description of the selected (highlighted) 
  1397. items from the window (and the object description file, if you save the file). 
  1398. If the object selected is a folder, all objects located in this folder will 
  1399. also be removed. 
  1400.  
  1401.  
  1402. ΓòÉΓòÉΓòÉ 10.2.2.8. Generate REXX ΓòÉΓòÉΓòÉ
  1403.  
  1404. This function creates a REXX program capable of recreating the selected 
  1405. object(s). The default .CMD file is used for the initial file name, but can be 
  1406. overridden. REXX code will then be generated for the selected object(s) in 
  1407. hierarchical order, i.e.  it will recreate folders before any object located in 
  1408. them.  However, if you do not select the parent folders for inclusion within 
  1409. the generated REXX file, then DeskMan/2 will generate the REXX file without 
  1410. those folders being included.  When the unmodified REXX code is later executed, 
  1411. the presence of all containing folders is required.  Of course, after the REXX 
  1412. code is first generated, it can be modified to change the object's designated 
  1413. recreation location. 
  1414.  
  1415.  
  1416. ΓòÉΓòÉΓòÉ 10.2.3. Help Menu ΓòÉΓòÉΓòÉ
  1417.  
  1418. The default helps item are provided. You can select: 
  1419.  
  1420. o the help index, 
  1421.  
  1422. o the general help, 
  1423.  
  1424. o the using help, or 
  1425.  
  1426. o the product information. 
  1427.  
  1428. Note:   The Help function is provided on most DeskMan/2 windows (except the 
  1429. Save and Restore processing windows) and for all menus. It is available by 
  1430. pressing the default Help key - F1. 
  1431.  
  1432.  
  1433. ΓòÉΓòÉΓòÉ 10.2.3.1. Index ΓòÉΓòÉΓòÉ
  1434.  
  1435. Use Help index to display an alphabetic list of references to the help topics 
  1436. for DeskMan/2. 
  1437.  
  1438. Note:   To see all text of the index entries, maximize the Index window. 
  1439.  
  1440. You can select an index entry to display the help topic that is related to that 
  1441. index entry. 
  1442.  
  1443.  
  1444. ΓòÉΓòÉΓòÉ 10.2.3.2. General help ΓòÉΓòÉΓòÉ
  1445.  
  1446. General help display information about the active window or menu on which you 
  1447. request help. 
  1448.  
  1449.  
  1450. ΓòÉΓòÉΓòÉ 10.2.3.3. Using Help ΓòÉΓòÉΓòÉ
  1451.  
  1452. Use Using help to find out how to use the help facility. 
  1453.  
  1454.  
  1455. ΓòÉΓòÉΓòÉ 10.2.3.4. Product information ΓòÉΓòÉΓòÉ
  1456.  
  1457. Use the Product information dialog to display the copyright information and 
  1458. your registered customer name. 
  1459.  
  1460.  
  1461. ΓòÉΓòÉΓòÉ 10.3. Restore window context menu ΓòÉΓòÉΓòÉ
  1462.  
  1463. There are context menus in the Restore window that are available by clicking 
  1464. the Mouse Button 2 (usually the right mouse button) over the container or its 
  1465. objects. 
  1466.  
  1467. The container context menu will appear if you activate it over an empty space 
  1468. or the column titles. It has following items available: 
  1469.  
  1470. o View - for the container view selection. 
  1471.  
  1472. o Select - for selecting or deselecting of all the container objects. 
  1473.  
  1474. o Sort - for sorting the container objects. 
  1475.  
  1476. o Arrange - for arranging of the container records. 
  1477.  
  1478. o Restore Desktop - for the restoration to the desktop of the container 
  1479.   objects. 
  1480.  
  1481. o Help - for displaying this help information. 
  1482.  
  1483.  
  1484. ΓòÉΓòÉΓòÉ 10.3.1. Restore Desktop ΓòÉΓòÉΓòÉ
  1485.  
  1486. When selecting Restore Desktop from the container's context menu, three options 
  1487. are available: 
  1488.  
  1489. o Update if exists 
  1490.  
  1491. o Replace if exists 
  1492.  
  1493. o Skip if exists 
  1494.  
  1495.  
  1496. ΓòÉΓòÉΓòÉ 10.3.1.1. Restore Desktop - Update if exists ΓòÉΓòÉΓòÉ
  1497.  
  1498. Locates the WPS Desktop object within the current DeskMan/2 object description 
  1499. file.  If the WPS Desktop object is not found, this function can not continue. 
  1500. If it is found, then DeskMan/2 begins to restore, in hierarchical order, those 
  1501. objects saved within the DeskMan/2 object description file.  When attempting to 
  1502. restore an object that already exists, the object is updated with the 
  1503. information saved in the object description file. 
  1504.  
  1505.  
  1506. ΓòÉΓòÉΓòÉ 10.3.1.2. Restore Desktop - Replace if exists ΓòÉΓòÉΓòÉ
  1507.  
  1508. Locates the WPS Desktop object within the current DeskMan/2 object description 
  1509. file.  If the WPS Desktop object is not found, this function can not continue. 
  1510. If it is found, then DeskMan/2 begins to restore, in hierarchical order, those 
  1511. objects saved within the DeskMan/2 object description file.  When attempting to 
  1512. restore an object that already exists, the object is replaced with the 
  1513. information saved in the object description file.  Note that this means that 
  1514. any containers that are restored will have their contents erased, then replaced 
  1515. with any saved information. 
  1516.  
  1517. Note:   This option is ignored with the WPS Desktop object, as replacing this 
  1518. object would cause the loss of all other objects on the WPS desktop. 
  1519.  
  1520.  
  1521. ΓòÉΓòÉΓòÉ 10.3.1.3. Restore Desktop - Skip if exists ΓòÉΓòÉΓòÉ
  1522.  
  1523. Locates the WPS Desktop object within the current DeskMan/2 object description 
  1524. file.  If the WPS Desktop object is not found, this function can not continue. 
  1525. If it is found, then DeskMan/2 begins to restore, in hierarchical order, those 
  1526. objects saved within the DeskMan/2 object description file.  When attempting to 
  1527. restore an object that already exists, the restore skips that object, leaving 
  1528. it unchanged. 
  1529.  
  1530.  
  1531. ΓòÉΓòÉΓòÉ 10.3.2. View selection ΓòÉΓòÉΓòÉ
  1532.  
  1533. The container's context menu item has following submenu items for the view 
  1534. selection: 
  1535.  
  1536. o icon view 
  1537.  
  1538. o details view 
  1539.  
  1540. o name view 
  1541.  
  1542. o text view 
  1543.  
  1544. o tree icon view 
  1545.  
  1546. o use mini icons changes the icon size used in view having icons displayed. 
  1547.  
  1548. All views provide the same functions - except the tree view which has the Sort 
  1549. and Select all menu items disabled. 
  1550.  
  1551.  
  1552. ΓòÉΓòÉΓòÉ 10.3.3. Select ΓòÉΓòÉΓòÉ
  1553.  
  1554. All container objects can be selected or deselected using the submenu items. 
  1555.  
  1556.  
  1557. ΓòÉΓòÉΓòÉ 10.3.3.1. Select all ΓòÉΓòÉΓòÉ
  1558.  
  1559. All container objects will be selected. The key combination Ctrl-/ can be used 
  1560. instead. 
  1561.  
  1562. This is the default selection for the Select submenu. 
  1563.  
  1564. This function is disabled if the container displays the tree view. 
  1565.  
  1566.  
  1567. ΓòÉΓòÉΓòÉ 10.3.3.2. Deselect all ΓòÉΓòÉΓòÉ
  1568.  
  1569. All container objects will be deselected. The key combination Ctrl-\ can be 
  1570. used instead. 
  1571.  
  1572. This function is disabled if the container displays the tree view. 
  1573.  
  1574.  
  1575. ΓòÉΓòÉΓòÉ 10.3.4. Sort ΓòÉΓòÉΓòÉ
  1576.  
  1577. The current contents of the object description file displayed in the Restore 
  1578. container can be sorted. 
  1579.  
  1580. The following sort criteria can be used: 
  1581.  
  1582. o by object's title, this is the default selection from the sort submenu. 
  1583.  
  1584. o by folder's title, the parent folder's name (i.e. the folder in which the 
  1585.   object is located). 
  1586.  
  1587. o by date and time of the save or the last update. 
  1588.  
  1589. o by object's class. 
  1590.  
  1591. This function is disabled if the container displays the tree view. 
  1592.  
  1593. Note:   The sort order will be preserved when you save the object description 
  1594. file. 
  1595.  
  1596.  
  1597. ΓòÉΓòÉΓòÉ 10.3.5. Arrange ΓòÉΓòÉΓòÉ
  1598.  
  1599. The container objects can be arranged, i.e. spread over the entire window area, 
  1600. if the container is in icon view. 
  1601.  
  1602. If the container displays the details view, only the splitbar between the title 
  1603. and class columns will be repositioned. 
  1604.  
  1605. If the container displays any other view, this function has no effect on it. 
  1606.  
  1607.  
  1608. ΓòÉΓòÉΓòÉ 10.4. Restore window objects' context menu ΓòÉΓòÉΓòÉ
  1609.  
  1610. The Restore window supports context menus, available by clicking the right 
  1611. mouse button (or mouse button 2) over the container or its objects. 
  1612.  
  1613. The container objects' context menu will appear if you activate it over any 
  1614. container record. It provides the following choices: 
  1615.  
  1616. o recreate object to create selected objects. 
  1617.  
  1618. o recreate folder to create selected folders including their contents and 
  1619.   optionally the contents of subfolders. 
  1620.  
  1621. o select all for folder to select all objects located in a specific folder, 
  1622.   optionally including the subfolders. 
  1623.  
  1624. o find folder to find (select) a parent folder for selected objects. 
  1625.  
  1626. o change setup to change the setup string for selected objects. 
  1627.  
  1628. o map drives to change references to certain drives or partitions. 
  1629.  
  1630. o remove description to remove the description of selected objects from the 
  1631.   container. 
  1632.  
  1633. o generate REXX to generate a REXX program capable of creating selected objects 
  1634.   stand-alone. 
  1635.  
  1636. Note:   The following rules are observed for the container record selection 
  1637. when using the record context menu: 
  1638.  
  1639.  1. If the record, for which the context menu was displayed, is selected 
  1640.     (highlighted), all selected (highlighted) container objects will have the 
  1641.     source emphasis (thin dashed line around them) and participate in the 
  1642.     action chosen, 
  1643.  
  1644.  2. If the record, for which the context menu was displayed, is not selected 
  1645.     (no highlighting), only this record will have the source emphasis and 
  1646.     participate in the action chosen. 
  1647.  
  1648.  
  1649. ΓòÉΓòÉΓòÉ 10.4.1. Recreate object ΓòÉΓòÉΓòÉ
  1650.  
  1651. The selected container objects will be recreated in their hierarchical order. 
  1652. The current option for recreating objects will be used by default, unless you 
  1653. select one of the items available on the submenu: 
  1654.  
  1655. o update if exists. 
  1656.  
  1657. o replace if exists. 
  1658.  
  1659. o skip if exists. 
  1660.  
  1661.  
  1662. ΓòÉΓòÉΓòÉ 10.4.1.1. Update if exists ΓòÉΓòÉΓòÉ
  1663.  
  1664. If the object you are trying to create already exists on your desktop, it will 
  1665. not be created.  However, its setup string will be updated with the current 
  1666. values defined in the object description file. 
  1667.  
  1668. If the prompt on update option is checked, you will be asked for confirmation. 
  1669.  
  1670.  
  1671. ΓòÉΓòÉΓòÉ 10.4.1.2. Replace if exists ΓòÉΓòÉΓòÉ
  1672.  
  1673. If the object you are trying to create already exists on your desktop, it will 
  1674. be replaced by the selected object. 
  1675.  
  1676. If the prompt on update option is checked, you will be asked for confirmation. 
  1677.  
  1678. Note:   If the object selected is a folder, all objects currently located in it 
  1679. will be deleted. 
  1680.  
  1681.  
  1682. ΓòÉΓòÉΓòÉ 10.4.1.3. Skip if exists ΓòÉΓòÉΓòÉ
  1683.  
  1684. If the objects you are trying to create already exist on your desktop, it will 
  1685. be not created. 
  1686.  
  1687. If the search everywhere option is checked, DeskMan/2 will search your entire 
  1688. desktop trying to locate the selected object before an attempt to create it. 
  1689.  
  1690.  
  1691. ΓòÉΓòÉΓòÉ 10.4.2. Recreate folder ΓòÉΓòÉΓòÉ
  1692.  
  1693. The Recreate folder function allows you to recreate complete folders, including 
  1694. all objects located in them. 
  1695. If the selected object is a folder, all objects in the object description file 
  1696. which have this folder as their location, will participate in the create 
  1697. operation. 
  1698. If the selected object is not a folder, this selection will recreate the folder 
  1699. containing this object, the object itself, and all other objects within that 
  1700. folder, as well. 
  1701. The current recreate option for the Restore operation (as specified in the 
  1702. DeskMan/2 settings notebook) will be used if the object already exists in the 
  1703. target folder and you do not select an option from the submenu. 
  1704.  
  1705. o Replace if object exists 
  1706.  
  1707.   if the prompt on update option is checked, you will be asked for 
  1708.   confirmation. 
  1709.  
  1710. o Update if object exists 
  1711.  
  1712.   if the prompt on update option is checked, you will be asked for 
  1713.   confirmation. 
  1714.  
  1715. o Skip if object exists 
  1716.  
  1717.   if the search everywhere option is checked, DeskMan/2 will search your entire 
  1718.   desktop trying to locate the selected object before recreating it. 
  1719.  
  1720. You can also select the depth for the restore operation: 
  1721.  
  1722. o this folder only - if selected, will create objects from the selected 
  1723.   folder(s) only (default selection), 
  1724.  
  1725. o include subfolders - if selected, will create objects from the selected 
  1726.   folder(s) and all subfolders located in it. 
  1727.  
  1728. Warning:   If you use the Replace option for existing objects on your desktop 
  1729. and you recreate a folder which already exists, its entire contents will be 
  1730. deleted as the result of the create operation. 
  1731.  
  1732. If multiple objects were selected for this operation, they will be created in 
  1733. their hierarchical order.  The hierarchical order means that the folders will 
  1734. be created before any object located in them. 
  1735.  
  1736.  
  1737. ΓòÉΓòÉΓòÉ 10.4.2.1. This folder only ΓòÉΓòÉΓòÉ
  1738.  
  1739. The participating objects will be recreated in their hierarchical order. The 
  1740. current option for recreating objects will be used by default, unless you 
  1741. select one of the items available on the submenu: 
  1742.  
  1743. o update if exists. 
  1744.  
  1745. o replace if exists. 
  1746.  
  1747. o skip if exists. 
  1748.  
  1749. This function will handle one level of the hierarchy. This means that the 
  1750. subfolders will not be recreated. 
  1751.  
  1752.  
  1753. ΓòÉΓòÉΓòÉ 10.4.2.1.1. Update if exists ΓòÉΓòÉΓòÉ
  1754.  
  1755. If the objects you are trying to create already exist on your desktop, it will 
  1756. be not created. However, its setup string will be updated with the current 
  1757. values defined in the object description file. 
  1758.  
  1759. If the prompt on update option is checked, you will be asked for confirmation. 
  1760.  
  1761.  
  1762. ΓòÉΓòÉΓòÉ 10.4.2.1.2. Replace if exists ΓòÉΓòÉΓòÉ
  1763.  
  1764. If the objects you are trying to create already exist on your desktop, it will 
  1765. be replaced by the selected object. 
  1766.  
  1767. If the prompt on update option is checked, you will be asked for confirmation. 
  1768.  
  1769. Note:   If the object selected is a folder, all objects currently located in it 
  1770. will be deleted. 
  1771.  
  1772.  
  1773. ΓòÉΓòÉΓòÉ 10.4.2.1.3. Skip if exists ΓòÉΓòÉΓòÉ
  1774.  
  1775. If the objects you are trying to create already exist on your desktop, it will 
  1776. be not created. 
  1777.  
  1778. If the search everywhere option is checked, DeskMan/2 will search your entire 
  1779. desktop trying to locate the selected object before an attempt to create it. 
  1780.  
  1781.  
  1782. ΓòÉΓòÉΓòÉ 10.4.2.2. Include subfolders ΓòÉΓòÉΓòÉ
  1783.  
  1784. The participating objects will be recreated in their hierarchical order. The 
  1785. current option for recreating objects will be used by default, unless you 
  1786. select one of the items available on the submenu: 
  1787.  
  1788. o update if exists. 
  1789.  
  1790. o replace if exists. 
  1791.  
  1792. o skip if exists. 
  1793.  
  1794. This function will handle all levels of the hierarchy below the current folder. 
  1795. This means that the subfolders will be recreated. 
  1796.  
  1797.  
  1798. ΓòÉΓòÉΓòÉ 10.4.2.2.1. Update if exists ΓòÉΓòÉΓòÉ
  1799.  
  1800. If the objects you are trying to create already exist on your desktop, it will 
  1801. be not created. However, its setup string will be updated with the current 
  1802. values defined in the object description file. 
  1803.  
  1804. If the prompt on update option is checked, you will be asked for confirmation. 
  1805.  
  1806.  
  1807. ΓòÉΓòÉΓòÉ 10.4.2.2.2. Replace if exists ΓòÉΓòÉΓòÉ
  1808.  
  1809. If the objects you are trying to create already exist on your desktop, it will 
  1810. be replaced by the selected object. 
  1811.  
  1812. If the prompt on update option is checked, you will be asked for confirmation. 
  1813.  
  1814. Note:   If the object selected is a folder, all objects currently located in it 
  1815. will be deleted. 
  1816.  
  1817.  
  1818. ΓòÉΓòÉΓòÉ 10.4.2.2.3. Skip if exists ΓòÉΓòÉΓòÉ
  1819.  
  1820. If the objects you are trying to create already exist on your desktop, it will 
  1821. be not created. 
  1822.  
  1823. If the search everywhere option is checked, DeskMan/2 will search your entire 
  1824. desktop trying to locate the selected object before an attempt to create it. 
  1825.  
  1826.  
  1827. ΓòÉΓòÉΓòÉ 10.4.3. Select all for folder ΓòÉΓòÉΓòÉ
  1828.  
  1829. The Select all for folder function allows you to select complete folders 
  1830. including all objects located in them. It can be used before performing the 
  1831. recreate folder or recreate object operation, or any other operation if you 
  1832. want to customize the set of objects passed to them. 
  1833.  
  1834. Objects can be selected for: 
  1835.  
  1836. o one level only, i.e. the objects located in subfolders will not be selected, 
  1837.   or 
  1838.  
  1839. o including subfolders, i.e. the objects located in the subfolders in the 
  1840.   folder selected will be selected, too. 
  1841.  
  1842. o parent folders. 
  1843.  
  1844.  
  1845. ΓòÉΓòÉΓòÉ 10.4.3.1. Select all - this folder only ΓòÉΓòÉΓòÉ
  1846.  
  1847. The One level only option selects objects located in the already selected 
  1848. folders or objects having the same location as the selected object. It will not 
  1849. select objects for subfolders located in the selected folder. 
  1850.  
  1851.  
  1852. ΓòÉΓòÉΓòÉ 10.4.3.2. Select all - include subfolders ΓòÉΓòÉΓòÉ
  1853.  
  1854. The including subfolders option selects objects located in the already selected 
  1855. folders or objects having the same location as the selected object. It will 
  1856. select objects for (sub)folders located in the selected folder. 
  1857.  
  1858.  
  1859. ΓòÉΓòÉΓòÉ 10.4.3.3. Select all - parent folders ΓòÉΓòÉΓòÉ
  1860.  
  1861. The parent folders option selects folders which are necessary to recreate given 
  1862. object in his original location. 
  1863.  
  1864.  
  1865. ΓòÉΓòÉΓòÉ 10.4.4. Find folder ΓòÉΓòÉΓòÉ
  1866.  
  1867. This function will search for the parent folder for the selected object, i.e. 
  1868. the folder in which the object is located, and put the cursored emphasis on it 
  1869. (a thin continuous border), and highlight it as well. 
  1870.  
  1871.  
  1872. ΓòÉΓòÉΓòÉ 10.4.5. Change setup ΓòÉΓòÉΓòÉ
  1873.  
  1874. Allows you to change the setup string for the selected objects. 
  1875.  
  1876.  
  1877. ΓòÉΓòÉΓòÉ 10.4.6. Map drives ΓòÉΓòÉΓòÉ
  1878.  
  1879. This function will scan and change the setup string for selected objects. 
  1880.  
  1881. If the setup string contains references to physical drives (.EXE or .CMD files 
  1882. for program names, working directory, etc.) and you recreate the objects on a 
  1883. system with different drive letters, those references will be incorrect. You 
  1884. can either manually change the setup strings for each object or request 
  1885. DeskMan/2 to perform the change for you for all selected objects.  After you 
  1886. select this option, a map drives dialog will ask you which drive letter should 
  1887. be substituted (the from value) with a current value (the to value).  This 
  1888. function will, upon completion, notify you as to the number of objects's setup 
  1889. strings that had to be changed. 
  1890.  
  1891. Note:   This operation has nothing to do with the physical location of the 
  1892. object, i.e. you can not request an object that was located on the desktop in 
  1893. partition C to be placed on the desktop in partition X.  The object's location 
  1894. is determined by the folder's location (the desktop in the highest instance). 
  1895.  
  1896. It is designed primarily for changes of Path and Current directory values 
  1897. specified for Program objects.  They will have to change if you have moved the 
  1898. directories, in which they were located at the time of the save operation, to 
  1899. another partition. 
  1900.  
  1901. Warning:   This function does NOT remap the location of your saved icon files! 
  1902. You must either manually edit and change the pathnames in your .DRC or .CMD 
  1903. files, or place your .ICO files in the same physical location, in order to 
  1904. allow DeskMan/2 to properly access them. 
  1905.  
  1906.  
  1907. ΓòÉΓòÉΓòÉ 10.4.7. Remove description ΓòÉΓòÉΓòÉ
  1908.  
  1909.  Remove description - will remove the description of the selected items from 
  1910. the window (and the object description file, if you save the file).  If the 
  1911. object selected is a folder, all objects located in this folder will also be 
  1912. removed. 
  1913.  
  1914.  
  1915. ΓòÉΓòÉΓòÉ 10.4.8. Generate REXX ΓòÉΓòÉΓòÉ
  1916.  
  1917. This function creates a REXX program capable of recreating the selected 
  1918. object(s). The default .CMD file is used for the initial file name, but can be 
  1919. overridden. REXX code will then be generated for the selected object(s) in 
  1920. hierarchical order, i.e.  it will recreate folders before any object located in 
  1921. them.  However, if you do not select the parent folders for inclusion within 
  1922. the generated REXX file, then DeskMan/2 will generate the REXX file without 
  1923. those folders being included.  When the unmodified REXX code is later executed, 
  1924. the presence of all containing folders is required.  Of course, after the REXX 
  1925. code is first generated, it can be modified to change the object's designated 
  1926. recreation location. 
  1927.  
  1928.  
  1929. ΓòÉΓòÉΓòÉ 10.5. Using Drag and Drop ΓòÉΓòÉΓòÉ
  1930.  
  1931. The Restore window (container) implements a standardized Drag and Drop 
  1932. mechanism. By dragging objects (or their graphic representation in form of an 
  1933. icon) out of the window and dropping them on any object or window on your 
  1934. desktop, you are initiating a create operation. 
  1935.  
  1936. The objects participating in the Drag and Drop are selected based on their 
  1937. selection emphasis (highlighted or not), and also depend on what view is 
  1938. displayed by the container. 
  1939.  
  1940. The following rules are observed: 
  1941.  
  1942.  1. if the object being dragged is not in selected state, only this one object 
  1943.     will participate in the drag operation. 
  1944.  
  1945.  2. if the object being dragged is in the selected state, all objects being in 
  1946.     the selected state will participate in the drag operation and will be 
  1947.     recreated in their hierarchical sequence, i.e. folders before their 
  1948.     contents. 
  1949.  
  1950.  3. if the container displays the tree icon view, and the object being dragged 
  1951.     is a composite object (it is a parent for other objects), all objects 
  1952.     having this object as a parent, will participate in the drag operation. 
  1953.  
  1954. The target of the drop operation can be any WPS object or any open view of an 
  1955. object. Windows that do not represent views of WPS objects are not allowed and 
  1956. may cause unexpected results. 
  1957.  
  1958. If the target represents a folder, the dragged objects will be created in this 
  1959. folder - if it represents an object of a different class, the dropped objects 
  1960. will be created in the folder holding the target. 
  1961.  
  1962. The objects dropped will be created using the current restore settings (which 
  1963. are explained in Restore objects settings ). 
  1964.  
  1965.  
  1966. ΓòÉΓòÉΓòÉ 11. Assign OBJECTID ΓòÉΓòÉΓòÉ
  1967.  
  1968. The assign OBJECTID special function can be used to assign an OBJECTID to any 
  1969. object located on your desktop. 
  1970.  
  1971. The OBJECTID is a unique identifier which allows you to refer to a specific 
  1972. object from programs executed outside of the Workplace Shell, especially from 
  1973. REXX or Presentation Manager applications. 
  1974.  
  1975. Note:   This function may also be used for fixing the problem of the Desktop 
  1976. losing its default OBJECTID - see: Limitations. 
  1977.  
  1978.  
  1979. ΓòÉΓòÉΓòÉ 11.1. OBJECTID entry field ΓòÉΓòÉΓòÉ
  1980.  
  1981. This entry field is used to enter the OBJECTID. The character string entered 
  1982. must be enclosed in < and > and should be unique for a given OS/2 2.X system. 
  1983.  
  1984.  
  1985. ΓòÉΓòÉΓòÉ 11.2. Assign ΓòÉΓòÉΓòÉ
  1986.  
  1987. Push the Assign button after you have entered the OBJECTID. 
  1988.  
  1989.  
  1990. ΓòÉΓòÉΓòÉ 11.3. Cancel ΓòÉΓòÉΓòÉ
  1991.  
  1992. Push this button if you want to cancel the Assign OBJECTID special function. 
  1993.  
  1994.  
  1995. ΓòÉΓòÉΓòÉ 12. Map drives ΓòÉΓòÉΓòÉ
  1996.  
  1997. This function will scan and change the setup string for selected objects. 
  1998.  
  1999. If the setup string contains references to physical drives (.EXE or .CMD files 
  2000. for program names, working directory, etc.) and you recreate the objects on a 
  2001. system with different drive letters, those references will be incorrect. You 
  2002. can either manually change the setup strings for each object or request 
  2003. DeskMan/2 to perform the change for you for all selected objects.  After you 
  2004. select this option, a map drives dialog will ask you which drive letter should 
  2005. be substituted (the from value) with a current value (the to value).  This 
  2006. function will, upon completion, notify you as to the number of objects's setup 
  2007. strings that had to be changed. 
  2008.  
  2009. Note:   This operation has nothing to do with the physical location of the 
  2010. object, i.e. you can not request an object that was located on the desktop in 
  2011. partition C to be placed on the desktop in partition X.  The object's location 
  2012. is determined by the folder's location (the desktop in the highest instance). 
  2013.  
  2014. It is designed primarily for changes of Path and Current directory values 
  2015. specified for Program objects.  They will have to change if you have moved the 
  2016. directories, in which they were located at the time of the save operation, to 
  2017. another partition. 
  2018.  
  2019. Warning:   This function does NOT remap the location of your saved icon files! 
  2020. You must either manually edit and change the pathnames in your .DRC or .CMD 
  2021. files, or place your .ICO files in the same physical location, in order to 
  2022. allow DeskMan/2 to properly access them. 
  2023.  
  2024.  
  2025. ΓòÉΓòÉΓòÉ 12.1. OK ΓòÉΓòÉΓòÉ
  2026.  
  2027. Push the OK button to perform the map drives operation after you entered the 
  2028. from  and to values, or Cancel to cancel the request. 
  2029.  
  2030.  
  2031. ΓòÉΓòÉΓòÉ 12.2. Cancel ΓòÉΓòÉΓòÉ
  2032.  
  2033. Use the Cancel button to cancel the map drives operation. 
  2034.  
  2035.  
  2036. ΓòÉΓòÉΓòÉ 12.3. Change from ΓòÉΓòÉΓòÉ
  2037.  
  2038. Enter the drive letter which should be replaced by the to value for the map 
  2039. drives operation. 
  2040.  
  2041.  
  2042. ΓòÉΓòÉΓòÉ 12.4. Change to ΓòÉΓòÉΓòÉ
  2043.  
  2044. Enter the drive letter which should be used as the substitute for the from 
  2045. value for the map drives operation. 
  2046.  
  2047.  
  2048. ΓòÉΓòÉΓòÉ 13. Change Setup ΓòÉΓòÉΓòÉ
  2049.  
  2050. Use Change setup function available on the restore window menu bar or on the 
  2051. object's context menu to modify the setup string objects from the object 
  2052. description file currently displayed in the Restore window. 
  2053.  
  2054. Note:   No formal checking is performed at this time on the values entered! 
  2055.  
  2056.  
  2057. ΓòÉΓòÉΓòÉ 13.1. Setup string ΓòÉΓòÉΓòÉ
  2058.  
  2059. The setup string is a character string consisting of keyname=value pairs 
  2060. separated by semicolons that change or define the behavior of an WPS object. 
  2061.  
  2062. Each object class defines its specific accepted keynames and the values it 
  2063. expects to see. 
  2064.  
  2065. Some of the keynames and accepted values are documented in OS/2 2.0 
  2066. Presentation Programming Reference, vol. 2. The most comprehensive description 
  2067. available can be found in CRTOBJ.TXT on CompuServe in OS2USER forum, library 5. 
  2068.  
  2069.  
  2070. ΓòÉΓòÉΓòÉ 13.2. OK ΓòÉΓòÉΓòÉ
  2071.  
  2072. Push the OK button to accept any changes to the object's setup string. 
  2073.  
  2074.  
  2075. ΓòÉΓòÉΓòÉ 13.3. CANCEL ΓòÉΓòÉΓòÉ
  2076.  
  2077. Push the Cancel button to ignore any changes to the object's setup string. 
  2078.  
  2079.  
  2080. ΓòÉΓòÉΓòÉ 14. Debug window ΓòÉΓòÉΓòÉ
  2081.  
  2082. The Debug window will be visible if you perform a Save objects or Save desktop 
  2083. operation and the Debug ON option is checked, or you selected Debug log from 
  2084. the DeskMan/2 object's Open menu. 
  2085.  
  2086. This window, if active, will give you some additional information about objects 
  2087. being processed. This information will be presented in the Processing log 
  2088. window and simultaneously written to the DeskMan/2's log file. 
  2089.  
  2090. Note:   The Processing log window has a limited capacity and may overflow if 
  2091. you process a large number of objects. However, the log file will contain all 
  2092. records. The first time the window overflows, you will be notified about this 
  2093. event - unless you checked No warnings during processing on the Save settings 
  2094. page. 
  2095.  
  2096. The debug window offers the following menu selections: 
  2097.  
  2098. o No debug - you can close the debug window and deactivate the Debug function 
  2099.   immediately. Closing the window itself (using the Close from window's system 
  2100.   menu), does not switch the Debug function off. 
  2101.  
  2102.   Note:   The Close selection is disabled as long as DeskMan/2 is processing 
  2103.   dropped objects for a Save request. 
  2104.  
  2105. o Cancel processing - will interrupt a currently executed Save operation. 
  2106.  
  2107. o Special functions - offers some advanced options. 
  2108.  
  2109. o Help - to access the DeskMan/2 help system. 
  2110.  
  2111. Note:   If you open the window and it does not appear on the screen, that means 
  2112. tha you closed it or performed a system Shut down when it was in a minimized 
  2113. state. Select the window from the window list, push Tile or Cascade to bring it 
  2114. back into the visible area. 
  2115.  
  2116.  
  2117. ΓòÉΓòÉΓòÉ 14.1. Debug window menu ΓòÉΓòÉΓòÉ
  2118.  
  2119. The debug window offers the following menu selections: 
  2120.  
  2121. o No debug - you can close the debug window and deactivate the Debug function 
  2122.   immediately. Closing the window itself (using the Close from window's system 
  2123.   menu), does not switch the Debug function off. 
  2124.  
  2125.   Note:   The Close selection is disabled as long as DeskMan/2 is processing 
  2126.   dropped objects for a Save request. 
  2127.  
  2128. o Cancel processing - will interrupt a currently executed Save operation. 
  2129.  
  2130. o Special functions - offers some advanced options. 
  2131.  
  2132. o Help - to access the DeskMan/2 help system. 
  2133.  
  2134.  
  2135. ΓòÉΓòÉΓòÉ 14.1.1. No debug ΓòÉΓòÉΓòÉ
  2136.  
  2137. Use No debug menu item to close the debug window and switch the debug function 
  2138. permanently off. 
  2139.  
  2140.  
  2141. ΓòÉΓòÉΓòÉ 14.1.2. Cancel processing ΓòÉΓòÉΓòÉ
  2142.  
  2143. Use Cancel processing to interrupt the currently executed Save objects or Save 
  2144. desktop operation. 
  2145.  
  2146.  
  2147. ΓòÉΓòÉΓòÉ 14.1.3. Special functions ΓòÉΓòÉΓòÉ
  2148.  
  2149. The Special functions menu offers some advanced options.  These options remain 
  2150. in effect until the user selects another option: 
  2151.  
  2152. o Destroy an object on drop - next object dropped on DeskMan/2's icon will be 
  2153.   destroyed. 
  2154.  
  2155. o Assign an OBJECTID - you can assign a unique OBJECTID to any WPS object. 
  2156.  
  2157. o Query object Settings - will display the object's class, OBJECTID, and other 
  2158.   settings! 
  2159.  
  2160. o Open Default - will open the default view for a dropped object. 
  2161.  
  2162. o Open Settings - will open the Settings notebook for any object. 
  2163.  
  2164. o Assign ICON - this function allows you to attach any icon to any WPS object. 
  2165.  
  2166. o Change Object Style - this function allows you to see and change certain WPS 
  2167.   object styles. 
  2168.  
  2169. Note:   When you select one of the Special functions, the Save objects function 
  2170. will be suspended - this is made visible by unchecking the Save objects item on 
  2171. the DeskMan/2 context menu. Also, the DeskMan/2 icon will change from the 
  2172. default icon to: 
  2173.  
  2174. o for the Assign icon before the first object is dropped and to as the sign 
  2175.   that DeskMan/2 is expecting the second object to be dropped. 
  2176.  
  2177. o for the Query object Settings. 
  2178.  
  2179. o for the Open object. 
  2180.  
  2181. o for the Destroy object. 
  2182.  
  2183. o for the Assign OBJECTID. 
  2184.  
  2185. o for the Change Object Style. 
  2186.  
  2187. When you decide to cancel the special function you just selected, you can open 
  2188. the DeskMan/2 context menu and select Save objects - this will disable the 
  2189. currently selected special function and reenable the default operation. 
  2190.  
  2191. The Special functions are available on the DeskMan/2 context menu, as well. 
  2192.  
  2193.  
  2194. ΓòÉΓòÉΓòÉ 14.1.3.1. Destroy an object ΓòÉΓòÉΓòÉ
  2195.  
  2196. Use Destroy object on drop to remove any unwanted objects WPS from your 
  2197. desktop. 
  2198.  
  2199. Even objects which does not have the Delete option can be removed. DeskMan/2 
  2200. will also remove objects having read only or template attribute set. You are 
  2201. also allowed to remove extra desktops which may have been created as a result 
  2202. of using MAKEINI or Alt-F1 to restore the default desktop. 
  2203.  
  2204. However, some objects (Drives, shadows of thereof, System setup objects) may 
  2205. refuse to be deleted and the only working method then is to create a folder, 
  2206. move the offending objects to it and use RD command to remove the directory 
  2207. corresponding to the created folder. 
  2208.  
  2209.  
  2210. ΓòÉΓòÉΓòÉ 14.1.3.2. Query object Settings ΓòÉΓòÉΓòÉ
  2211.  
  2212. Use Query object Settings to learn about the object's class, OBJECTID, and 
  2213. other settings! The window thus brought up is a Read-Only window, but the 
  2214. standard Select and Copy functions will work within it.  All you need do is 
  2215. select the text you want to copy, copy it into the clipboard by hitting 
  2216. ctrl-insert on your keyboard, bring up an editor such as EPM, and paste the 
  2217. text into it from the clipboard, by hitting shift-insert or selecting Paste 
  2218. from its menu. 
  2219.  
  2220. Note:   If you Query the settings for a container, all objects in that 
  2221. container must be examined, and this can take some time, particularly for WPS 
  2222. Desktop object! 
  2223.  
  2224.  
  2225. ΓòÉΓòÉΓòÉ 14.1.3.3. Assign OBJECTID ΓòÉΓòÉΓòÉ
  2226.  
  2227. Use Assign OBJECTID to assign a unique ID to any object.  See Assign objectid 
  2228. dialog help for details. 
  2229.  
  2230.  
  2231. ΓòÉΓòÉΓòÉ 14.1.3.4. Open an object ΓòÉΓòÉΓòÉ
  2232.  
  2233. Use Open an object to open a view of any WPS object. You can open: 
  2234.  
  2235. o the default view, or 
  2236.  
  2237. o the settings. 
  2238.  
  2239.  
  2240. ΓòÉΓòÉΓòÉ 14.1.3.4.1. Open default view ΓòÉΓòÉΓòÉ
  2241.  
  2242. Use Open default view to open the default view of any WPS object. The default 
  2243. view is dependent on the class of the object and the changes you may have made 
  2244. to the primary object's menu, using its Settings. 
  2245.  
  2246.  
  2247. ΓòÉΓòÉΓòÉ 14.1.3.4.2. Open Settings ΓòÉΓòÉΓòÉ
  2248.  
  2249. Use Open Settings to open the Settings notebook for any WPS object. 
  2250.  
  2251.  
  2252. ΓòÉΓòÉΓòÉ 14.1.3.5. Assign an icon ΓòÉΓòÉΓòÉ
  2253.  
  2254. Use Assign an icon function to attach an icon to any WPS objects. 
  2255.  
  2256. After selecting it, you have to drop an object and an ICO file (the sequence 
  2257. doesn't matter) on the DeskMan/2 icon.  If neither of the dropped objects is a 
  2258. WPIcon object  (i.e. it must be a real icon file, usually every ICO file edited 
  2259. with the Icon editor is one...) the second dropped object's icon will be 
  2260. assigned to the first object dropped. You will be asked to accept this action. 
  2261.  
  2262.  
  2263. ΓòÉΓòÉΓòÉ 14.1.3.6. Change Object Style ΓòÉΓòÉΓòÉ
  2264.  
  2265. This function allows certain object styles to be seen and changed. 
  2266.  
  2267. Warning:   Do NOT change the DeskMan/2 object's style settings! Doing so may 
  2268. require the reinstallation of the product. 
  2269.  
  2270. By selecting this option from the menu, an object's various style settings can 
  2271. be brought up in a window, viewed, and changed.  These style settings are: 
  2272.  
  2273. o Copy - indicating whether or not the object can be copied. 
  2274. o Move - indicating whether or not the object can be moved. 
  2275. o Shadow - indicating whether or not the object can have a Shadow. 
  2276. o Settings - indicating whether or not the object's Settings notebook can be 
  2277.   opened. 
  2278. o Rename - indicating whether or not the object can be renamed. 
  2279. o Delete - indicating whether or not the object can be deleted. 
  2280. o Drag - indicating whether or not the object can be dragged. 
  2281. o Print - indicating whether or not the object can be printed. 
  2282. o Template - indicating whether or not the object is a template 
  2283. o Visible - indicating whether or not the object is visible on the desktop. 
  2284.  
  2285.  
  2286. ΓòÉΓòÉΓòÉ 14.1.3.6.1. Change Object Style - Change ΓòÉΓòÉΓòÉ
  2287.  
  2288. Select this button to have DeskMan/2 change the current object's styles as per 
  2289. the current indicators in the Change Object Style window. 
  2290.  
  2291.  
  2292. ΓòÉΓòÉΓòÉ 14.1.3.6.2. Change Object Style - Cancel ΓòÉΓòÉΓòÉ
  2293.  
  2294. Select this button to have DeskMan/2 cancel any selected changes to the current 
  2295. object's styles, and to close the Change Object Style window. 
  2296.  
  2297.  
  2298. ΓòÉΓòÉΓòÉ 14.1.3.6.3. Change Object Style - Copy ΓòÉΓòÉΓòÉ
  2299.  
  2300. Copy - indicating whether or not the object can be copied. 
  2301.  
  2302.  
  2303. ΓòÉΓòÉΓòÉ 14.1.3.6.4. Change Object Style - Move ΓòÉΓòÉΓòÉ
  2304.  
  2305. Move - indicating whether or not the object can be moved. 
  2306.  
  2307.  
  2308. ΓòÉΓòÉΓòÉ 14.1.3.6.5. Change Object Style - Shadow ΓòÉΓòÉΓòÉ
  2309.  
  2310. Shadow - indicating whether or not the object can have a Shadow. 
  2311.  
  2312.  
  2313. ΓòÉΓòÉΓòÉ 14.1.3.6.6. Change Object Style - Settings ΓòÉΓòÉΓòÉ
  2314.  
  2315. Settings - indicating whether or not the object's Settings notebook can be 
  2316. opened. 
  2317.  
  2318.  
  2319. ΓòÉΓòÉΓòÉ 14.1.3.6.7. Change Object Style - Rename ΓòÉΓòÉΓòÉ
  2320.  
  2321. Rename - indicating whether or not the object can be renamed. 
  2322.  
  2323.  
  2324. ΓòÉΓòÉΓòÉ 14.1.3.6.8. Change Object Style - Delete ΓòÉΓòÉΓòÉ
  2325.  
  2326. Delete - indicating whether or not the object can be deleted. 
  2327.  
  2328.  
  2329. ΓòÉΓòÉΓòÉ 14.1.3.6.9. Change Object Style - Drag ΓòÉΓòÉΓòÉ
  2330.  
  2331. Drag - indicating whether or not the object can be dragged. 
  2332.  
  2333. Warning:  If No Drag is set, the object can NOT be dragged anymore.  This means 
  2334. that you cannot drag it back to the DeskMan/2 object to undo what you have 
  2335. done! If the object is not inside a container on the desktop, the only way to 
  2336. undo this action is to reinstall the object from either the DeskMan/2 object 
  2337. description file, a REXX program, or from the object's original installation 
  2338. disks. 
  2339.  
  2340.  
  2341. ΓòÉΓòÉΓòÉ 14.1.3.6.10. Change Object Style - Print ΓòÉΓòÉΓòÉ
  2342.  
  2343. Print - indicating whether or not the object can be printed. 
  2344.  
  2345.  
  2346. ΓòÉΓòÉΓòÉ 14.1.3.6.11. Change Object Style - Template ΓòÉΓòÉΓòÉ
  2347.  
  2348. Template - indicating whether or not the object is a template 
  2349.  
  2350.  
  2351. ΓòÉΓòÉΓòÉ 14.1.3.6.12. Change Object Style - Visible ΓòÉΓòÉΓòÉ
  2352.  
  2353. Visible - indicating whether or not the object is visible on the desktop. 
  2354.  
  2355.  
  2356. ΓòÉΓòÉΓòÉ 15. DeskMan/2 Settings ΓòÉΓòÉΓòÉ
  2357.  
  2358. The DeskMan/2 settings can be accessed by opening the object's context menu and 
  2359. selecting Open and Settings.  The following setting notebook pages can be 
  2360. selected: 
  2361.  
  2362. o Save - three pages of settings for the Save function. 
  2363. o Restore - the Restore function settings. 
  2364. o Debug - the Debug function settings. 
  2365. o System - the Save System function settings. 
  2366. o General - the DeskMan/2 object name and icon. 
  2367.  
  2368.  
  2369. ΓòÉΓòÉΓòÉ 15.1. Save (1 of 3) ΓòÉΓòÉΓòÉ
  2370.  
  2371. The first (of 3) page of the save function settings can be used to set 
  2372. following values: 
  2373.  
  2374. o generate the object description file, 
  2375.  
  2376. o object description file name, 
  2377.  
  2378. o DeskMan/2's behavior if the object description file already exists, replace 
  2379.   or update can be selected. 
  2380.  
  2381. o prompting on file update. 
  2382.  
  2383. o resolve composite objects like the desktop or folders, 
  2384.  
  2385.  
  2386. ΓòÉΓòÉΓòÉ 15.1.1. Object description file name ΓòÉΓòÉΓòÉ
  2387.  
  2388. Use Object description file for Save entry field to specify the location and 
  2389. name of DeskMan/2's object description file. 
  2390.  
  2391. Alternatively the Select push button can be used to display the default OS/2 
  2392. file selection dialog. 
  2393.  
  2394.  
  2395. ΓòÉΓòÉΓòÉ 15.1.2. Selecting an object description file for Save ΓòÉΓòÉΓòÉ
  2396.  
  2397. Use the Select push button to activate the standard OS/2 file open dialog which 
  2398. allows you to select a DeskMan/2  object description file for the Save 
  2399. operation. 
  2400.  
  2401.  
  2402. ΓòÉΓòÉΓòÉ 15.1.3. Replace the object description file on Save ΓòÉΓòÉΓòÉ
  2403.  
  2404. Use replace radio button to request DeskMan/2 to overwrite the object 
  2405. description file for the Save operation if it already exists. This option can 
  2406. be preferably used for performing Save desktop operations, since it replaces 
  2407. the object description file for each and every object saved - dropped on 
  2408. DeskMan/2, 
  2409.  
  2410. Warning:   If you check replace as the desired behavior for an existing object 
  2411. description file and/or REXX program and perform a multi-object drop (you 
  2412. select more than one object and drop all of them at the same time on 
  2413. DeskMan/2), every object will initiate a separate thread by DeskMan/2, causing 
  2414. the object description file to be overlaid by the final object only. DeskMan/2 
  2415. will try to notify you in such case and give you the option of cancelling the 
  2416. operation. 
  2417.  
  2418.  
  2419. ΓòÉΓòÉΓòÉ 15.1.4. Update the object description file on Save ΓòÉΓòÉΓòÉ
  2420.  
  2421. Use the update radio button to force DeskMan/2 to search the current contents 
  2422. of the object description file and check for the presence of the object it is 
  2423. currently processing. If such an object already exists in the object 
  2424. description file (i.e., an object having the same  class, title and location ), 
  2425. its description will be updated with the current one. If the object cannot be 
  2426. found in the object description file, its description will be appended to the 
  2427. file. This option allows you to maintain the complete set of your objects, i.e. 
  2428. only newly created objects will be added to the object description file. The 
  2429. object's description will be updated in the current object description file 
  2430. and/or in the REXX program. 
  2431.  
  2432.  
  2433. ΓòÉΓòÉΓòÉ 15.1.5. Resolve composite objects ΓòÉΓòÉΓòÉ
  2434.  
  2435. Use the resolve folders setting to request all composite objects Desktop, 
  2436. folders, program groups, etc. processed by the Save operation, to be 
  2437. automatically populated with their contents and saved along with all objects 
  2438. located in them. 
  2439.  
  2440.  
  2441. ΓòÉΓòÉΓòÉ 15.1.6. Prompt on object description file update ΓòÉΓòÉΓòÉ
  2442.  
  2443. Use Prompt if you want DeskMan/2 to notity you when an object's description is 
  2444. about to be updated in the DeskMan/2 object description file. 
  2445.  
  2446.  
  2447. ΓòÉΓòÉΓòÉ 15.1.7. Generate the object description file ΓòÉΓòÉΓòÉ
  2448.  
  2449. Use the Generate object description file check box to switch the generation of 
  2450. the DeskMan/2 object description file on or off. 
  2451.  
  2452.  
  2453. ΓòÉΓòÉΓòÉ 15.2. Save (2 of 3) ΓòÉΓòÉΓòÉ
  2454.  
  2455. The second (of 3) page of the save function settings can be used to set 
  2456. following values: 
  2457.  
  2458. o generate REXX program on Save, 
  2459.  
  2460. o REXX program name, 
  2461.  
  2462. o DeskMan/2's behavior if the REXX program already exists, replace or update 
  2463.   can be selected. 
  2464.  
  2465. o prompting on REXX program update. 
  2466.  
  2467.  
  2468. ΓòÉΓòÉΓòÉ 15.2.1. REXX program name ΓòÉΓòÉΓòÉ
  2469.  
  2470. Use Program name entry field to specify the location and name of the generated 
  2471. REXX program. 
  2472.  
  2473. Alternatively the Select push button can be used to display the default OS/2 
  2474. file selection dialog. 
  2475.  
  2476.  
  2477. ΓòÉΓòÉΓòÉ 15.2.2. Replace REXX program on Save ΓòÉΓòÉΓòÉ
  2478.  
  2479. Use replace radio button to request DeskMan/2 to overwrite the REXX program for 
  2480. the Save operation if it already exists. This option can be preferably used for 
  2481. performing Save desktop operations, since it replaces the object description 
  2482. file for each every object saved - dropped on DeskMan/2, 
  2483.  
  2484. Warning:   If you check replace as the desired behavior for an existing object 
  2485. description file and/or REXX program and perform a multi-object drop (you 
  2486. select more than one object and drop all of them at the same time on 
  2487. DeskMan/2), every object will initiate a separate thread by DeskMan/2, causing 
  2488. the object description file to be overlaid by the final object only. DeskMan/2 
  2489. will try to notify you in such case and give you the option of cancelling the 
  2490. operation. 
  2491.  
  2492.  
  2493. ΓòÉΓòÉΓòÉ 15.2.3. Update REXX program ΓòÉΓòÉΓòÉ
  2494.  
  2495. Use the update radio button to force DeskMan/2 to search the current contents 
  2496. of the REXX program and check for the presence of the object it is currently 
  2497. processing. If such an object already exists in the object description file 
  2498. (i.e., an object having the same  class, title and location ), its description 
  2499. will be updated with the current one. If the object cannot be found in the REXX 
  2500. program, its description will be appended to the file.  This option allows you 
  2501. to maintain the complete set of your objects, i.e. only newly created objects 
  2502. will be added to the object description file.  The object's description will be 
  2503. updated in the current object description file and/or in the REXX program. 
  2504.  
  2505.  
  2506. ΓòÉΓòÉΓòÉ 15.2.4. Prompt on REXX program update ΓòÉΓòÉΓòÉ
  2507.  
  2508. Use Prompt if you want DeskMan/2 to notity you when an object's code is about 
  2509. to be updated in the REXX program generated by DeskMan/2. 
  2510.  
  2511.  
  2512. ΓòÉΓòÉΓòÉ 15.2.5. Generate REXX program on Save ΓòÉΓòÉΓòÉ
  2513.  
  2514. Use Generate REXX program check box to switch the generation of the program on 
  2515. or off. 
  2516.  
  2517.  
  2518. ΓòÉΓòÉΓòÉ 15.2.6. Select REXX program name ΓòÉΓòÉΓòÉ
  2519.  
  2520. Use the Select push button to activate the standard OS/2 file open dialog which 
  2521. allows you to select the name of the generated REXX program for the Save 
  2522. operation. 
  2523.  
  2524.  
  2525. ΓòÉΓòÉΓòÉ 15.3. Save (3 of 3) ΓòÉΓòÉΓòÉ
  2526.  
  2527. The third (of 3) page of the save function settings can be used to set 
  2528. following values: 
  2529.  
  2530. o create icons for saved objects, 
  2531.  
  2532. o icons location, 
  2533.  
  2534. o assign OBJECTID to shadows' orginals, 
  2535.  
  2536. o assign OBJECTID to every object, 
  2537.  
  2538. o suppress warnings during processing, 
  2539.  
  2540. o suppress warnings for invalid settings. 
  2541.  
  2542.  
  2543. ΓòÉΓòÉΓòÉ 15.3.1. Icons location ΓòÉΓòÉΓòÉ
  2544.  
  2545. Use the Icons location entry field to specify the location of a directory which 
  2546. will keep the icons for the saved objects. 
  2547.  
  2548. You can also use the Select pushbutton to select a directory using a standard 
  2549. OS/2 open file dialog. 
  2550.  
  2551. Note:   The directory must exist at the time of performing the Save operation. 
  2552. It will be validated at the time you enter it, and created if it does not 
  2553. exist. 
  2554.  
  2555. The generated object description file and/or REXX program will contain 
  2556. references to the directory specified.  If you restore the objects on another 
  2557. system, be sure to place the icon files in a directory having the same physical 
  2558. location as the one used for the save operation - unless you modify the object 
  2559. description file and/or the REXX program manually.  The Map drives function can 
  2560. not be used to change those references. Note also, that there is an OS/2 limit 
  2561. on the number of files you can put into a root directory: 
  2562.  
  2563. o 128 files for a root directory on a diskette. 
  2564.  
  2565. o 512 files for a root directory on a hard disk partition. 
  2566.  
  2567.  
  2568. ΓòÉΓòÉΓòÉ 15.3.2. Icon directory selection ΓòÉΓòÉΓòÉ
  2569.  
  2570. Use the Select pushbutton to select a directory as the icons location for the 
  2571. Save operation. 
  2572.  
  2573. Note:   Since the standard OS/2 open dialog does not provide a way to select a 
  2574. directory only, you will have to select either a file from a directory you want 
  2575. to use or enter a fake file name into the dialog's file name entry field. 
  2576.  
  2577.  
  2578. ΓòÉΓòÉΓòÉ 15.3.3. Create icons for saved objects ΓòÉΓòÉΓòÉ
  2579.  
  2580. Use the Create icons checkbox to request that when saving objects, the objects' 
  2581. icons be saved along with them.  This is set by default. 
  2582.  
  2583.  
  2584. ΓòÉΓòÉΓòÉ 15.3.4. Assign OBJECTID to shadow's original ΓòÉΓòÉΓòÉ
  2585.  
  2586. Use the Assign OBJECTID for original to control the way DeskMan/2 is handling 
  2587. the shadows of WPS objects. See Limitations for details. 
  2588.  
  2589. Note:   If Assign OBJECTID for original is not checked, DeskMan/2 will not be 
  2590. able to restore shadows of the saved objects. 
  2591.  
  2592.  
  2593. ΓòÉΓòÉΓòÉ 15.3.5. Assign OBJECTID to each object ΓòÉΓòÉΓòÉ
  2594.  
  2595. Use the Assign OBJECTID to each object to request an OBJECTID to be assigned 
  2596. for each processed object. See Limitations for details. 
  2597.  
  2598.  
  2599. ΓòÉΓòÉΓòÉ 15.3.6. Suppress warnings for invalid settings ΓòÉΓòÉΓòÉ
  2600.  
  2601. Sometimes it happens that the DOS or WinOs2 Settings for an object become 
  2602. corrupted, especially when you delete the associated file and WPS is not 
  2603. notified. In this case, DeskMan/2 will get an invalid pointer to those settings 
  2604. and will ignore them. Do not check this option if you want to be notified in 
  2605. such a case. 
  2606.  
  2607. Note:   The "invalid" settings can be fixed in most cases by opening settings, 
  2608. changing any setting and saving them. 
  2609.  
  2610.  
  2611. ΓòÉΓòÉΓòÉ 15.3.7. Suppress warnings during processing ΓòÉΓòÉΓòÉ
  2612.  
  2613. When the No warnings during processing check box is checked, you will not 
  2614. receive any noncritical warning messages.  This includes messages about: 
  2615.  
  2616. o Broken shadows - A broken shadow occurs when the original object of that 
  2617.   shadow can no longer be found.  When this happens, the shadow's icon changes 
  2618.   into the "broken link" icon.  These objects can not be 
  2619.   resolved/saved/restored by DeskMan/2 and will be ignored.  If the No warnings 
  2620.   during processing check box is checked, then no warning will be issued. 
  2621.  
  2622. o Objects DeskMan/2 can not resolve (for example shadows of Drives or objects 
  2623.   not located on your current desktop). 
  2624.  
  2625. o No confirmation is required when Cancel processing is selected. 
  2626.  
  2627. o Overflowing the Debug window. 
  2628.  
  2629.  
  2630. ΓòÉΓòÉΓòÉ 15.4. Restore Settings ΓòÉΓòÉΓòÉ
  2631.  
  2632. The Restore page of the Settings notebook contains a set of controls which 
  2633. affect the operation of online restore (recreate) processing.  The following 
  2634. options can be set: 
  2635.  
  2636. o the name and the location of the object description file for the restore 
  2637.   function. 
  2638.  
  2639. o the name and the location of the system's INI.RC file, used to recreate the 
  2640.   default WPS objects. 
  2641.  
  2642. o options for recreating objects - existing objects can be replaced, updated, 
  2643.   or skipped entirely.  Note that choosing this last option is functionally 
  2644.   equivalent to a Restore Missing Only option. 
  2645.  
  2646. o request to be prompted on object update or replace. 
  2647.  
  2648. o request to look everywhere when checking for an object's existence if 
  2649.   existing objects are skipped. 
  2650.  
  2651. o set the default view displayed by the restore container. 
  2652.  
  2653. o set the default icon size used in views displaying icons. 
  2654.  
  2655.  
  2656. ΓòÉΓòÉΓòÉ 15.4.1. Object description file name for Restore ΓòÉΓòÉΓòÉ
  2657.  
  2658. Use the Object description file for Restore entry field to enter the location 
  2659. and name of the DeskMan/2 object description file to be displayed in the 
  2660. restore window.  You can also use the Open push button to display a standard 
  2661. OS/2 file open dialog. 
  2662.  
  2663. The name of the object description file can be the same as the one used for the 
  2664. Save operation.  This will have the advantage of being able to visually control 
  2665. the contents of the object description file (when you open the Restore window 
  2666. before you start the Save). 
  2667.  
  2668.  
  2669. ΓòÉΓòÉΓòÉ 15.4.2. File name selection for Restore ΓòÉΓòÉΓòÉ
  2670.  
  2671. Use the Select push button located close to the Description file for Restore: 
  2672. entry field to display a standard OS/2 file open dialog and to select a valid 
  2673. DeskMan/2 object description file. 
  2674.  
  2675.  
  2676. ΓòÉΓòÉΓòÉ 15.4.3. System INI.RC file location ΓòÉΓòÉΓòÉ
  2677.  
  2678. Use the Standard OS/2 INI.RC file entry field to enter the name and location of 
  2679. the OS/2 INI.RC file which contains a description of the default WPS objects. 
  2680. Any valid INI.RC file may be used - not necessarily the one from the system you 
  2681. are currently running. However, this will be the default selected by DeskMan/2. 
  2682.  
  2683.  
  2684. ΓòÉΓòÉΓòÉ 15.4.4. System INI.RC file selection ΓòÉΓòÉΓòÉ
  2685.  
  2686. Use the Select push button located close to the Standard OS/2 INI.RC file: 
  2687. entry field to display a standard OS/2 file open dialog and to select a valid 
  2688. OS/2 INI.RC file file which contains a description of the default WPS objects. 
  2689. Any valid INI.RC file may be used - not necessarily the one from the system you 
  2690. are currently running.  However, this will be the default selected by 
  2691. DeskMan/2. 
  2692.  
  2693.  
  2694. ΓòÉΓòÉΓòÉ 15.4.5. Replace object if exists ΓòÉΓòÉΓòÉ
  2695.  
  2696. Use the Replace radio buton if you want objects already existing on your 
  2697. desktop to be replaced when recreating/restoring objects. 
  2698.  
  2699. You may want to use the prompt setting to request a notification when an object 
  2700. is about to be replaced. 
  2701.  
  2702. Warning:   If you use the Replace option for existing objects on your desktop 
  2703. and you recreate a folder which already exists, its entire contents will be 
  2704. deleted as the result of the create operation. 
  2705.  
  2706.  
  2707. ΓòÉΓòÉΓòÉ 15.4.6. Update object if exists ΓòÉΓòÉΓòÉ
  2708.  
  2709. Use the Update radio buton if you want objects already existing on your desktop 
  2710. to be updated when recreating/restoring objects. 
  2711.  
  2712. You may want to use the prompt setting to request a notification when an object 
  2713. is about to be updated. 
  2714.  
  2715.  
  2716. ΓòÉΓòÉΓòÉ 15.4.7. Prompt on object update ΓòÉΓòÉΓòÉ
  2717.  
  2718. Use the Prompt check box to request a notification (confirmation) from 
  2719. DeskMan/2 when it is about to replace or update an existing object when 
  2720. performing the restore operation. 
  2721.  
  2722. Note:   This setting is also used when the skip if object exists option is 
  2723. checked.  If you want DeskMan/2, during the Skip if object exists processing, 
  2724. to assume that if an object with same title and class is found in a folder 
  2725. other than the target folder, then the currently processed object should not be 
  2726. created; and you don't want to see the notification about those objects, then 
  2727. don't check the Prompt option. 
  2728.  
  2729.  
  2730. ΓòÉΓòÉΓòÉ 15.4.8. Skip object if exists ΓòÉΓòÉΓòÉ
  2731.  
  2732. Use the Skip radio buton if you want objects already in existence on your 
  2733. desktop to be skipped when recreating/restoring objects. 
  2734.  
  2735. You can also use the search everywhere option to request DeskMan/2 to check the 
  2736. entire desktop for the presence of the object being restored.  Normally, 
  2737. DeskMan/2 only searches the object's stored path for the object to be restored, 
  2738. but with this option set, it will check the entire desktop until it either 
  2739. finds it, or has completed its search for the object. If it finds the object, 
  2740. and the prompt checkbox is not set, then it will skip the object.  If the 
  2741. prompt checkbox is set, then a notification will be provided asking if the 
  2742. object should be restored to its original location, or if it should be skipped. 
  2743.  
  2744.  
  2745. ΓòÉΓòÉΓòÉ 15.4.9. Search everywhere for missing objects ΓòÉΓòÉΓòÉ
  2746.  
  2747. You can use the search everywhere option to request that DeskMan/2 check the 
  2748. entire desktop for the presence of the object being restored.  This option may 
  2749. be useful to check for objects you might have moved to another folder after you 
  2750. performed the Save operation.  If DeskMan/2 finds such an object in another 
  2751. folder, and if the prompt checkbox is set, then you will be notified as to the 
  2752. names of the folder(s), and have the option of recreating the object in its 
  2753. default location or cancelling the request.  If it finds the object, and the 
  2754. prompt checkbox is not set, then it will skip the object. 
  2755.  
  2756. You can use the prompt for the Skip if object exists with search everywhere 
  2757. option. If you want DeskMan/2, during the Skip if object exists processing, to 
  2758. assume that if an object with same title and class is found in a folder 
  2759. different than the target folder, the currently processed object should not be 
  2760. created, and you don't want to see the notification about those objects, don't 
  2761. check the Prompt option. 
  2762.  
  2763.  
  2764. ΓòÉΓòÉΓòÉ 15.4.10. Use mini icons ΓòÉΓòÉΓòÉ
  2765.  
  2766. The size of the icons used in views having icons displayed can be changed. 
  2767.  
  2768. The icons can be displayed in their default size or in "mini" size - the size 
  2769. can be selected using the window's system menu  or by checking Use mini icons 
  2770. on the  Restore  page of DeskMan/2's settings. 
  2771.  
  2772. Note:   Preparing the view using mini icons takes more time than if using the 
  2773. default size. 
  2774.  
  2775.  
  2776. ΓòÉΓòÉΓòÉ 15.4.11. Icon view ΓòÉΓòÉΓòÉ
  2777.  
  2778. The container contents will be displayed in the Icon view in a non-grid format. 
  2779. The icons will be located randomly about the screen without any ordered 
  2780. arrangement. However, you can use the sort function to order them in one of the 
  2781. possible orders or use the arrange to spread them over the entire window. 
  2782.  
  2783. The icons can be displayed in their default size or in "mini" size - the size 
  2784. can be selected using the window's system menu system menu  or by checking Use 
  2785. mini icons on the  Restore  page of DeskMan/2's settings. 
  2786.  
  2787. This view provides you only with the name and the icon of an object. 
  2788.  
  2789.  
  2790. ΓòÉΓòÉΓòÉ 15.4.12. Details view ΓòÉΓòÉΓòÉ
  2791.  
  2792. The container contents will be displayed in the Details view. The icons will be 
  2793. arranged in a column across the screen in the order in which they were found in 
  2794. the object description file. However, you can use the sort function to order 
  2795. them in one of the possible sequences. The information about the objects will 
  2796. be displayed in the following categories: 
  2797.  
  2798.  1. Icon - shows the icon assigned to this object, or the  icon, or the icon. 
  2799.     will be displayed for objects having their icons located in private or 
  2800.     system DLL's. Since those DLLs can't be loaded by DeskMan/2 (they may 
  2801.     require a specific initialization sequence and/or environment), a generic 
  2802.     icon is used. 
  2803.     The shadows will have a special icon displayed. 
  2804.  
  2805.     The icons can be displayed in their default size or in "mini" size - the 
  2806.     size can be selected using the window's system menu  or by checking Use 
  2807.     mini icons on the  Restore  page of DeskMan/2's settings, 
  2808.  
  2809.  2. Title - is object's title. 
  2810.  
  2811.  3. Class - is the object's class. 
  2812.  
  2813.  4. Location - is the OBJECTID of the folder where the object was located at 
  2814.     the time of Save or the physical path for objects of the WP*File classes. 
  2815.  
  2816.  5. Date - is the date when the object was saved or updated last time using 
  2817.     DeskMan/2, or blank for default objects. 
  2818.  
  2819.  6. Time - the time the object was saved or updated last, or blank for default 
  2820.     objects. 
  2821.  
  2822.  7. Folder's title - the parent folder's title, if it could be found in the 
  2823.     current object description file. 
  2824.  
  2825.  
  2826. ΓòÉΓòÉΓòÉ 15.4.13. Name view ΓòÉΓòÉΓòÉ
  2827.  
  2828. The container contents will be displayed in the name view in a flowed format. 
  2829. The icons will be arranged in columns across the screen in the order in which 
  2830. they were found in the object description file. However, you can use the sort 
  2831. function to order them in one of the possible sequences. 
  2832.  
  2833. The icons can be displayed in their default size or in "mini" size - the size 
  2834. can be selected using the window's system menu  or by checking Use mini icons 
  2835. on the  Restore  page of DeskMan/2's settings. 
  2836.  
  2837. This view provides you only with the name and the icon of an object. 
  2838.  
  2839.  
  2840. ΓòÉΓòÉΓòÉ 15.4.14. Text view ΓòÉΓòÉΓòÉ
  2841.  
  2842. The container contents will be displayed in the text view in a flowed format. 
  2843. The icons will be arranged in columns across the screen in the order in which 
  2844. they were found in the object description file. However, you can use the sort 
  2845. function to order them in one of the possible sequences. 
  2846.  
  2847. This view provides you only with the name of an object. 
  2848.  
  2849.  
  2850. ΓòÉΓòÉΓòÉ 15.4.15. Tree view ΓòÉΓòÉΓòÉ
  2851.  
  2852. The container contents will be displayed in the tree icon view in a lines 
  2853. format. The icons will be arranged in a tree-like structure reflecting the 
  2854. dependencies between the objects. 
  2855.  
  2856. The icons can be displayed in their default size or in "mini" size - the size 
  2857. can be selected using the window's system menu  or by checking Use mini icons 
  2858. on the  Restore  page of DeskMan/2's settings. 
  2859.  
  2860. This view provides you only with the name and the icon of an object. 
  2861.  
  2862. Note:   Switching to/from this view from/to any other view requires the 
  2863. container contents to be reloaded, so it may take some time to display the new 
  2864. view selected. 
  2865.  
  2866.  
  2867. ΓòÉΓòÉΓòÉ 15.5. Debug Settings ΓòÉΓòÉΓòÉ
  2868.  
  2869. The Debug page of the DeskMan/2 settings notebook allows you to customize the 
  2870. settings for the Debug function. 
  2871.  
  2872. The debug information will be displayed in the debug window and simultaneously 
  2873. written to the debug LOG file; or, if the PMPRINTF check box is selected, it 
  2874. will be written to PMPRINTF. 
  2875.  
  2876. This information may be usefull for debugging and educational purposes. The 
  2877. following settings can be customized: 
  2878.  
  2879. o the debug function status, 
  2880.  
  2881. o the debug LOG file name. 
  2882.  
  2883.  
  2884. ΓòÉΓòÉΓòÉ 15.5.1. Switch Debug ON ΓòÉΓòÉΓòÉ
  2885.  
  2886. Use the On radio button to switch the debug function on.  Use the Off radio 
  2887. button to switch the function off. 
  2888.  
  2889. Note:   The debug function can be also activated by using the Debug log menu 
  2890. item on the DeskMan/2 object's Open menu. 
  2891.  
  2892.  
  2893. ΓòÉΓòÉΓòÉ 15.5.2. Switch Debug OFF ΓòÉΓòÉΓòÉ
  2894.  
  2895. Use the Off radio button to switch the debug function off.  Use the On radio 
  2896. button to switch the function on. 
  2897.  
  2898. Note:   The debug function can be also deactivated by using the No debug menu 
  2899. item on the Debug window menu. 
  2900.  
  2901.  
  2902. ΓòÉΓòÉΓòÉ 15.5.3. Debug .LOG file name ΓòÉΓòÉΓòÉ
  2903.  
  2904. Use the DeskMan/2 .LOG file entry field to specify the name and location of the 
  2905. debug file. 
  2906.  
  2907. Alternatively you can use the Select push button to display the standard OS/2 
  2908. file open dialog to select the .LOG file. 
  2909.  
  2910.  
  2911. ΓòÉΓòÉΓòÉ 15.5.4. Debug .LOG file selection ΓòÉΓòÉΓòÉ
  2912.  
  2913. Use the Select push button to display the standard OS/2 file open dialog to 
  2914. select the name and location of the DeskMan/2 debug file. 
  2915.  
  2916.  
  2917. ΓòÉΓòÉΓòÉ 15.5.5. Set DEBUG .LOG to PMPRINTF ΓòÉΓòÉΓòÉ
  2918.  
  2919. If PMPRINTF is checked, all debugging information is sent from DeskMan/2 to 
  2920. PMPRINTF.  If PMPRINTF is in use, and either DeskMan/2 or the WPS crashes, 
  2921. PMPRINTF will retain the debugging information up to the point of the crash, 
  2922. where DeskMan/2's native debugger may lose some or all of the most recent 
  2923. information. 
  2924.  
  2925. Warning:   If this option is selected, PMPRINTF must be started prior to using 
  2926. DeskMan/2, or the debugging information will be lost. 
  2927.  
  2928.  
  2929. ΓòÉΓòÉΓòÉ 15.6. Settings for Save System Settings ΓòÉΓòÉΓòÉ
  2930.  
  2931. The System settings and colors of your Desktop can be saved and restored using 
  2932. DeskMan/2.  This notebook settings control is used to control what is saved or 
  2933. restored, and to where. 
  2934.  
  2935. The following are controlled from here: 
  2936.  
  2937. o The IRC file name used for the saved System Settings 
  2938. o The Control Panel checkbox that determines if the System Control panel 
  2939.   settings are saved. 
  2940. o The PM Colors checkbox that determines if the WPS desktop color settings are 
  2941.   saved. 
  2942. o The REXX file name used for the saved System Settings 
  2943.  
  2944.  
  2945. ΓòÉΓòÉΓòÉ 15.6.1. File name for settings ΓòÉΓòÉΓòÉ
  2946.  
  2947. If this option is selected, then the System settings and colors of your Desktop 
  2948. can be saved and restored using DeskMan/2.  This entry field contains the full 
  2949. pathname for the file used to store the saved system settings.  If you wish to 
  2950. change the file to be used for this purpose to another file, you can either 
  2951. enter the new file path and name in this field, or use the Select pushbutton to 
  2952. display the default OS/2 file selection dialog. 
  2953.  
  2954. Note:   The file should have the IRC file extension. 
  2955.  
  2956.  
  2957. ΓòÉΓòÉΓòÉ 15.6.2. Select pushbutton for file name ΓòÉΓòÉΓòÉ
  2958.  
  2959. Use the Select push button to activate the standard OS/2 file open dialog which 
  2960. allows you to select a file within which to store the saved System settings. 
  2961.  
  2962. Note:   The file should have the IRC file extension. 
  2963.  
  2964.  
  2965. ΓòÉΓòÉΓòÉ 15.6.3. Control panel checkbox ΓòÉΓòÉΓòÉ
  2966.  
  2967. Determines whether or not the PM Control panel settings are backed up. These 
  2968. settings include: 
  2969.  
  2970. o Border Width 
  2971. o Animation 
  2972. o Print Screen 
  2973. o Logo Display Time 
  2974. o Cursor Blink Rate 
  2975. o Key Repeat Rate 
  2976. o Key Repeat Delay 
  2977. o Double Click Speed 
  2978. o Mouse Tracking Speed 
  2979. o and more... 
  2980.  
  2981. Note:   If you restore these settings, they will take effect after you reboot 
  2982. the system. 
  2983.  
  2984.  
  2985. ΓòÉΓòÉΓòÉ 15.6.4. PM Colors checkbox ΓòÉΓòÉΓòÉ
  2986.  
  2987. Determines whether or not the PM color settings are backed up. These settings 
  2988. include: 
  2989.  
  2990. o Display 
  2991. o Active Border 
  2992. o Active Title 
  2993. o Background 
  2994. o Button Default 
  2995. o Entry Field 
  2996. o Icon Text 
  2997. o Menu 
  2998. o Shadow Text 
  2999. o Window 
  3000. o Window Frame 
  3001. o and many more... 
  3002.  
  3003. Note:   If you restore these settings, they will take effect after you reboot 
  3004. the system. 
  3005.  
  3006. Warning:  Do not attempt to restore these settings unto a system that does not 
  3007. have the same type of video card as they were saved under. 
  3008.  
  3009.  
  3010. ΓòÉΓòÉΓòÉ 15.6.5. Generate REXX checkbox ΓòÉΓòÉΓòÉ
  3011.  
  3012. If this checkbox is selected, then REXX file generation is enabled for the 
  3013. saving of the selected System Settings. 
  3014.  
  3015.  
  3016. ΓòÉΓòÉΓòÉ 15.6.6. REXX Program Generation for System Settings ΓòÉΓòÉΓòÉ
  3017.  
  3018. If this option is selected, then the System settings and colors of your Desktop 
  3019. can be saved into a generated REXX file, which need only be run to restore your 
  3020. saved settings.  This entry field contains the full pathname for the file used 
  3021. to store the saved system settings.  If you wish to change the file to be used 
  3022. for this purpose to another file, you can either enter the new file path and 
  3023. name in this field, or use the Select pushbutton to display the default OS/2 
  3024. file selection dialog. 
  3025.  
  3026. Note:   The file should have the CMD file extension. 
  3027.  
  3028.  
  3029. ΓòÉΓòÉΓòÉ 15.6.7. Select pushbutton for REXX ΓòÉΓòÉΓòÉ
  3030.  
  3031. Use the Select push button to activate the standard OS/2 file open dialog which 
  3032. allows you to select a file within which to store the saved System settings. 
  3033.  
  3034. Note:   The file should have the CMD file extension. 
  3035.  
  3036.  
  3037. ΓòÉΓòÉΓòÉ 15.6.8. Generate IRC file checkbox ΓòÉΓòÉΓòÉ
  3038.  
  3039. If this checkbox is selected, then IRC file generation is enabled for the 
  3040. online save and restore of the selected System Settings. 
  3041.  
  3042.  
  3043. ΓòÉΓòÉΓòÉ 16. DeskMan/2 object Help ΓòÉΓòÉΓòÉ
  3044.  
  3045. The DeskMan/2 object located on your desktop is a very special Workplace Shell 
  3046. object.  It is not an executable program, even though it performs online 
  3047. functions.  It is not a folder, even though it displays a window containing the 
  3048. objects that it 'holds'.  It is not a desktop, even though it easily holds all 
  3049. the objects found on the desktop... It is simply the Desktop Manager. 
  3050.  
  3051. DeskMan/2 has a distinctive icon and it's own object menu - both of them are 
  3052. very important. 
  3053.  
  3054. The icon is used to activate the main DeskMan/2 function:  the Save operation. 
  3055. It is started by dragging other objects onto DeskMan/2 - the icon (and the 
  3056. associated DeskMan/2 class DLL)  then performs its magic acquiring from the WPS 
  3057. all information available about the dropped objects.  Depending on the current 
  3058. Settings, a special object description file, a bunch of icons, and a REXX 
  3059. program will be generated. 
  3060.  
  3061. DeskMan/2's icon has also another important feature: when you double-click on 
  3062. it (i.e. perform the default action on it), a container window will open.  This 
  3063. is the window used to launch a variety of functions, the most important being 
  3064. the restore (or create) function. 
  3065.  
  3066. DeskMan/2's context menu (also known as a popup menu) will be available after 
  3067. you press Mouse Button 2 (usually the right button) while pointing at 
  3068. DeskMan/2's icon.  This menu allows you to access other important functions: 
  3069.  
  3070. o the Open submenu 
  3071.  
  3072. o the DeskMan/2 and System Help submenu, which includes the online registration 
  3073.   menu item 
  3074.  
  3075. o the Save desktop menu item 
  3076.  
  3077. o the Restore desktop submenu 
  3078.  
  3079. o the Save System settings menu item 
  3080.  
  3081. o the Restore System settings menu item 
  3082.  
  3083. o the Save objects menu item 
  3084.  
  3085. o the Special functions submenu 
  3086.  
  3087.  
  3088. ΓòÉΓòÉΓòÉ 16.1. Open ΓòÉΓòÉΓòÉ
  3089.  
  3090. You can use the Open submenu off of the DeskMan/2 object's context menu to open 
  3091. the following: 
  3092.  
  3093. o the Settings notebook 
  3094.  
  3095. o the DeskMan file 
  3096.  
  3097. o the Standard objects system file 
  3098.  
  3099. o the Debug log 
  3100.  
  3101.  
  3102. ΓòÉΓòÉΓòÉ 16.1.1. Open DeskMan file ΓòÉΓòÉΓòÉ
  3103.  
  3104. Use the DeskMan file menu item to open a restore window displaying the objects 
  3105. saved in DeskMan/2's object description file. The default window format and 
  3106. style can be customized on the Restore page of the Settings notebook. 
  3107.  
  3108.  
  3109. ΓòÉΓòÉΓòÉ 16.1.2. Open default objects file ΓòÉΓòÉΓòÉ
  3110.  
  3111. Use the Standard objects menu item to request the description of the default 
  3112. Workplace Shell objects to be displayed. 
  3113.  
  3114. The description is kept in special INI.RC file located in the OS2 directory on 
  3115. your system partition. Since DeskMan/2 supports the format of the INI.RC files, 
  3116. you can perform all the functions available in the restore window the same way 
  3117. you can perform them on the DeskMan/2 object description file. 
  3118.  
  3119.  
  3120. ΓòÉΓòÉΓòÉ 16.1.3. Open DeskMan/2 debug window ΓòÉΓòÉΓòÉ
  3121.  
  3122. Use the Debug log menu item to display the DeskMan/2 debug window and to 
  3123. activate debugging. 
  3124.  
  3125.  
  3126. ΓòÉΓòÉΓòÉ 16.2. Save objects ΓòÉΓòÉΓòÉ
  3127.  
  3128. DeskMan/2 performs the Save object(s) operation everytime you drop an object on 
  3129. its icon while Save Objects, its default operation, is selected.  The 
  3130. characteristic DeskMan/2 icon, displayed here:  clearly indicates that the Save 
  3131. Objects option is selected. 
  3132.  
  3133. However, the special functions also use the drop interface.  After you select 
  3134. one of the special functions, the Save object(s) function is suspended, the 
  3135. DeskMan/2 icon is changed to the icon appropriate to the particular special 
  3136. function selected, and the Save objects menu item is unchecked.. 
  3137.  
  3138. To return DeskMan/2 to its default Save object(s) operation, select the Save 
  3139. objects menu item.  This will restore the original DeskMan/2 desktop icon, 
  3140. place a check next to the menu item, and cause DeskMan/2 to resume its default 
  3141. Save function. 
  3142.  
  3143. This menu item can be also used to cancel a Special function request in the 
  3144. case where it's no longer desired. 
  3145.  
  3146.  
  3147. ΓòÉΓòÉΓòÉ 16.3. Register DeskMan ΓòÉΓòÉΓòÉ
  3148.  
  3149. If this copy of DeskMan/2 has not been previously registered, then it can be 
  3150. registered online through this selection off of the DeskMan/2 object's context 
  3151. help menu.  Simply select, Register DeskMan, and the registration dialog will 
  3152. pop up, allowing you to complete the product registration.  If the product is 
  3153. not properly installed, then it will function with certain limitations. 
  3154.  
  3155. Note:   Please make sure that you have a valid customer name and registration 
  3156. number 
  3157.  
  3158.  
  3159. ΓòÉΓòÉΓòÉ 16.4. Save Desktop ΓòÉΓòÉΓòÉ
  3160.  
  3161. Use Save desktop to perform a save operation for the entire desktop. If the 
  3162. resolve folders setting is enabled, all composite objects, including the 
  3163. Workplace Shell desktop, folders, program groups, etc., will be populated with 
  3164. their contents and saved. 
  3165.  
  3166. Note:   When the Templates folder is being saved, it may cause Help for the 
  3167. Data file to be displayed.  This is caused by a bug in WPS.  The Help can be 
  3168. closed, although it might open itself again if still processing the Templates 
  3169. folder, but there are no known negative side effects of this strange behavior. 
  3170.  
  3171.  
  3172. ΓòÉΓòÉΓòÉ 16.5. Restore Desktop ΓòÉΓòÉΓòÉ
  3173.  
  3174. When selecting Restore Desktop, three options are available: 
  3175.  
  3176. o Update if exists 
  3177.  
  3178. o Replace if exists 
  3179.  
  3180. o Skip if exists 
  3181.  
  3182.  
  3183. ΓòÉΓòÉΓòÉ 16.6. Save desktop System Settings ΓòÉΓòÉΓòÉ
  3184.  
  3185. Saves the WPS Desktop System Settings to a IRC file, and optionally generates a 
  3186. REXX program. 
  3187.  
  3188. These settings include: 
  3189.  
  3190. o Border Width 
  3191. o Animation 
  3192. o Print Screen 
  3193. o Logo Display Time 
  3194. o Cursor Blink Rate 
  3195. o Key Repeat Rate 
  3196. o Key Repeat Delay 
  3197. o Double Click Speed 
  3198. o Mouse Tracking Speed 
  3199. o Display 
  3200. o Active Border 
  3201. o Active Title 
  3202. o Background 
  3203. o Button Default 
  3204. o Entry Field 
  3205. o Icon Text 
  3206. o Menu 
  3207. o Shadow Text 
  3208. o Window 
  3209. o Window Frame 
  3210. o and many more... 
  3211.  
  3212. Note:   If you restore these settings, they will take effect after you reboot 
  3213. the system. 
  3214.  
  3215. Warning:  Do not attempt to restore the color settings unto a system that does 
  3216. not have the same type of video card as they were saved under. 
  3217.  
  3218.  
  3219. ΓòÉΓòÉΓòÉ 16.7. Restore desktop System Settings ΓòÉΓòÉΓòÉ
  3220.  
  3221. Restores the WPS Desktop System Settings from the IRC file. 
  3222.  
  3223. These settings include: 
  3224.  
  3225. o Border Width 
  3226. o Animation 
  3227. o Print Screen 
  3228. o Logo Display Time 
  3229. o Cursor Blink Rate 
  3230. o Key Repeat Rate 
  3231. o Key Repeat Delay 
  3232. o Double Click Speed 
  3233. o Mouse Tracking Speed 
  3234. o Display 
  3235. o Active Border 
  3236. o Active Title 
  3237. o Background 
  3238. o Button Default 
  3239. o Entry Field 
  3240. o Icon Text 
  3241. o Menu 
  3242. o Shadow Text 
  3243. o Window 
  3244. o Window Frame 
  3245. o and many more... 
  3246.  
  3247. Note:   If you restore these settings, they will take effect after you reboot 
  3248. the system. 
  3249.  
  3250. Warning:  Do not attempt to restore the color settings unto a system that does 
  3251. not have the same type of video card as they were saved under. 
  3252.  
  3253.  
  3254. ΓòÉΓòÉΓòÉ 17. What are your options? ΓòÉΓòÉΓòÉ
  3255.  
  3256. Before you start using DeskMan/2, you can customize its behavior. The values 
  3257. set during the installation process will give you a set of "safe" options, and 
  3258. usually it is not necessary to change them. 
  3259.  
  3260. The values entered using Settings are stored in the OS2.INI file and will be 
  3261. preserved across system starts and DeskMan/2 reinstalls, unless you format your 
  3262. system partition. 
  3263.  
  3264. DeskMan/2's settings can be accessed by using the context menu, i.e. by 
  3265. clicking Mouse Button2 (usually the right button...) on DeskMan/2's icon. The 
  3266. Open conditional menu has the item - Settings. 
  3267.  
  3268. To learn more about specific settings select a topic from the list below or use 
  3269. the Index button: 
  3270.  
  3271. o About DeskMan/2's object description file 
  3272.  
  3273. o Settings for Save 
  3274.  
  3275. o Settings for Restore 
  3276.  
  3277.  
  3278. ΓòÉΓòÉΓòÉ 17.1. DeskMan/2's object description file ΓòÉΓòÉΓòÉ
  3279.  
  3280. The description of your objects is kept in a special object description file 
  3281. maintained by DeskMan/2. It contains all the information DeskMan/2 could 
  3282. acquire from the WPS about a specific object and which is necessary to recreate 
  3283. it on any OS/2 2.X system. 
  3284.  
  3285. The format of this file is compatible with the format used by OS/2 for the 
  3286. INI.RC file used to create the default WPS objects. So, if you have a set of 
  3287. your private objects that you wold like to be created automatically when you 
  3288. use MAKEINI or Alt-F1 to restore your default desktop objects, you can use the 
  3289. entries from the DeskMan/2's object description file and put them into the 
  3290. INI.RC file. 
  3291.  
  3292.  
  3293. ΓòÉΓòÉΓòÉ 17.2. Save objects ΓòÉΓòÉΓòÉ
  3294.  
  3295. If you don't want the object description file to be generated, uncheck the 
  3296. Generate object description file check box. You can specify the name and 
  3297. location of this file using the first page (of 3) of the Save settings. You can 
  3298. use different files or keep everything in one file. This file is used as the 
  3299. basis for DeskMan/2's restore function - so you can have multiple desktop 
  3300. setups and use them selectively, or document the changes to your desktop as 
  3301. they happen, over time, in one file. I'd like to suggest you to keep the 
  3302. objects in the object description file(s) grouped in logical units, i.e. 
  3303. containing the folders with their complete contents. Otherwise, some features 
  3304. available for the Restore function will have to be limited. 
  3305.  
  3306. You can customize DeskMan/2's behavior when the object description file does 
  3307. already exists at the time you perform Save. You have a choice of: 
  3308.  
  3309. o replace - the file will be overwritten and the previous contents will be 
  3310.   destroyed. This option should be used for performing Save desktop operations, 
  3311.   since it replaces the object description file for each and every object saved 
  3312.   - dropped on DeskMan/2, 
  3313.  
  3314. o update - DeskMan/2 will search the current contents of the object description 
  3315.   file and check for the presence of the object it is currently processing. If 
  3316.   such an object already exists in the object description file (i.e., an object 
  3317.   having the same  class, title and location ), its description will be updated 
  3318.   with the current one. If the object cannot be found in the object description 
  3319.   file, its description will be appended to the file. This option allows you to 
  3320.   maintain the complete set of your objects, i.e. only newly created objects 
  3321.   will be added to the object description file. The object's description will 
  3322.   be updated in the current object description file and/or in the REXX program. 
  3323.  
  3324.    - if you check Prompt on update in addition to update, DeskMan/2 will notify 
  3325.      you about every object already present in the object description file, and 
  3326.      ask you for permission to change the description before performing the 
  3327.      update operation. 
  3328.  
  3329. o Resolve folders - the composite objects dropped on DeskMan/2's icon (folders, 
  3330.   program groups, desktop ) will be automatically populated with their 
  3331.   contents. This is the default for the registered version - this setting is 
  3332.   not available for the shareware version. 
  3333.  
  3334. Additionally, a REXX program can be generated (by checking Generate REXX 
  3335. program on page 2 of 3), which can be used to recreate objects "standalone" - 
  3336. on a system without DeskMan/2 being installed (in case you would like to pass 
  3337. those objects to a friend or another user in your department...). You can 
  3338. specify the name of the program file and customize the behavior in case the 
  3339. file already exists, the same way you do for the object description file. Note 
  3340. that the update option is based on a specific layout of the generated REXX 
  3341. program - please do NOT change it manually - especially do not remove 
  3342. DeskMan/2's markers from the text! 
  3343.  
  3344. Warning:   If you check replace as the desired behavior for an existing object 
  3345. description file and/or REXX program and perform a multi-object drop (you 
  3346. select more than one object and drop all of them at the same time on 
  3347. DeskMan/2), every object will initiate a separate thread by DeskMan/2, causing 
  3348. the object description file to be overlaid by the final object only. DeskMan/2 
  3349. will try to notify you in such case and give you the option of cancelling the 
  3350. operation. 
  3351.  
  3352. Object descriptions can be saved without their customized icons or can include 
  3353. them (which is the default). This option is selected by checking the Create 
  3354. icons box. The icons can be put in any directory, which allows you to maintain 
  3355. a collection of your ICO files.  You can specify the drive and directory for 
  3356. the icon collection on page 3 of 3 for Save.  If you use the file dialog (after 
  3357. you push Select on this page), you will have to supply a fake filename in order 
  3358. to be able to select a drive/directory. For example, if you select a directory 
  3359. D:\DMAN\ICONS, you can select any ICO file from this directory, or put any name 
  3360. into the Open filename field of the selection dialog. Be careful if you use the 
  3361. same directory for icons referred to by different object description files; it 
  3362. will be difficult to identify which are needed by which... Of course, you have 
  3363. to copy any saved icons to the system on which you want to recreate your 
  3364. objects. 
  3365.  
  3366. Warning:   If you have checked the Update if exists option for Save, the 
  3367. current object description file/REXX program will not contain any 
  3368. changes/additions for the objects affected by the interrupted operation. If 
  3369. Replace if exists was checked, the object description file will contain 
  3370. descriptions for objects processed up to the moment you interrupted the 
  3371. operation. 
  3372.  
  3373. There are additional settings on page 3: 
  3374.  
  3375. o Assign OBJECTID for original - checked by default. It tells DeskMan/2 to 
  3376.   assign an OBJECTID to the original of the processed shadow (if it has not one 
  3377.   already assigned). If you don't check this option, DeskMan/2 will not be able 
  3378.   to process shadows. 
  3379.  
  3380. o Assign OBJECTID to each object - if checked, DeskMan/2 will assign an 
  3381.   OBJECTID to each saved object. This setting is NOT required for DeskMan/2 to 
  3382.   perform any of its online functions. You may want to use it to have the 
  3383.   ability to refer to any object on the Desktop from programs executing outside 
  3384.   of WPS (regular .EXE or .CMD processing). But you must be aware of the side 
  3385.   effect of this option: every OBJECTID is saved in the OS2.INI file. And since 
  3386.   they must be unique, you shouldn't have multiple copies of the same object in 
  3387.   different folders because DeskMan/2 uses the object's title for constructing 
  3388.   the OBJECTID. 
  3389.  
  3390.   Note:   DeskMan/2 is assigning an OBJECTID by default, regardless of this 
  3391.   setting, to every folder and an original of a shadow (unless Assign OBJECTID 
  3392.   for original is not checked). This is required to identify the location of 
  3393.   the object. 
  3394.  
  3395.   Now you are wondering "What's that OBJECTID  stuff?". OBJECTID is an unique 
  3396.   identifier the system or the user can assign to an object when it is created. 
  3397.   Most default WPS objects have an OBJECTID assigned (look into INI.RC file, if 
  3398.   you are curious). It is the only reliable way to refer to a specific object. 
  3399.   OBJECTIDs should be unique across a given 2.X system. 
  3400.  
  3401. o No warnings during processing - when checked, you will not receive any 
  3402.   messages that are not critical for the processing. This includes messages 
  3403.   about: 
  3404.  
  3405.    - broken shadows - sometimes it happens that a shadow becomes a broken 
  3406.      shadow, i.e. the original of such a shadow cannot be located anymore and 
  3407.      you will see the "broken link" icon. These objects can not be 
  3408.      resolved/saved/restored by DeskMan/2 and will be ignored - if you check 
  3409.      this setting, you will not be notified when it encounters such a shadow. 
  3410.  
  3411.    - objects DeskMan/2 can not resolve (for example shadows of Drives or 
  3412.      objects not located on your current desktop). 
  3413.  
  3414.    - you will be not asked for confirmation when you select Cancel processing. 
  3415.  
  3416.    - overflowing Debug window. 
  3417.  
  3418. o No warning for invalid settings - sometimes it happens that the DOS or WinOs2 
  3419.   Settings for an object become corrupted, especially when you delete the 
  3420.   associated file and WPS is not notified. In this case, DeskMan/2 will get an 
  3421.   invalid pointer to those settings and will ignore them. Do not check this 
  3422.   option if you want to be notified in such a case. 
  3423.  
  3424.   Note:   The "invalid" settings can be fixed in most cases by opening 
  3425.   settings, changing any setting and saving them. 
  3426.  
  3427.  
  3428. ΓòÉΓòÉΓòÉ 17.3. Restore objects ΓòÉΓòÉΓòÉ
  3429.  
  3430. Whenever you need to recreate your objects, you can use either the REXX program 
  3431. supplied by the Save function, or DeskMan/2's object description file 
  3432. (DeskMan/2 file option), or the default OS/2 INI.RC file. 
  3433.  
  3434. The Restore function is available on DeskMan/2's context menu, which will 
  3435. appear after you press Mouse Button 2 while pointing at DeskMan/2's icon. The 
  3436. Open conditional menu allows you to select the file for the current restore 
  3437. operation. 
  3438.  
  3439. You can also open the restore window by double-clicking on the DeskMan/2 icon - 
  3440. it is the default action for it. 
  3441.  
  3442. You can customize the Restore function on the Restore page of the settings 
  3443. notebook. You can specify the location/name of DeskMan/2's object description 
  3444. file or the standard OS/2 INI.RC file (which is used to rebuild default WPS 
  3445. objects on your desktop). The name of the object description file can be the 
  3446. same as the one used for the Save operation. This will have the advantage of 
  3447. being able to visually control the contents of the object description file 
  3448. (when you open the Restore window). 
  3449.  
  3450. In addition, you can select the size of icons used for the Restore window by 
  3451. checking Use mini icons or leaving it unchecked for the default size (using 
  3452. default size icons will give a little better performance). 
  3453.  
  3454. You can recreate manually-selected single objects, or request DeskMan/2 to 
  3455. recreate all those selected objects that do not exist on your system  (when you 
  3456. move objects to another system, or after you install a new version of OS/2). 
  3457. This is controlled by checking the Skip if object exists option. 
  3458.  
  3459. DeskMan/2 is able to check if the object you want to restore using Skip if 
  3460. object exists is already present on your desktop (or any other folder located 
  3461. on the desktop). By default, it only searches the folder in which the object 
  3462. was located at the moment of the save operation (if such folder can be found on 
  3463. the target system). However, if you, for example, moved your object after you 
  3464. performed the save and it is still present on your desktop, DeskMan/2 wouldn't 
  3465. be able to find it and would create a duplicate. If you want to prevent this, 
  3466. you can check search everywhere option, which will force DeskMan/2 to look in 
  3467. every folder in search for the object to be restored. But remember - this 
  3468. search operation will take a considerable amount of time! 
  3469.  
  3470. You can force a Replace or Update for objects already existing on your desktop. 
  3471. You can command DeskMan/2 to ask you for an appropriate action for each 
  3472. processed object by checking Prompt option. 
  3473.  
  3474. Warning:   If you use the Replace option for existing objects on your desktop 
  3475. and you recreate a folder which already exists, its entire contents will be 
  3476. deleted as the result of the create operation. 
  3477.  
  3478. And as mentioned previously, you can recreate any default WPS object that you 
  3479. may have destroyed by accident (Standard objects option). The default location 
  3480. of the INI.RC file (which is the \OS2\ directory) can be set to any directory 
  3481. containing a valid INI.RC file. 
  3482.  
  3483. The window style for displaying the current object description file for the 
  3484. Restore operation can be selected by checking one of the choices under the View 
  3485. group. You can select: 
  3486.  
  3487. o the Details view (default) - the object information will be displayed in 
  3488.   columns with following titles: 
  3489.  
  3490.     1. Icon - displays the object's icon. 
  3491.  
  3492.     2. Title - is the object's title. 
  3493.  
  3494.     3. Class - is the object's class. 
  3495.  
  3496.     4. Location - it the OBJECTID of the folder in which the object was/will be 
  3497.        located. 
  3498.  
  3499.     5. Date - is the day on which the object's description was saved or 
  3500.        recently updated. 
  3501.  
  3502.     6. Time - the time at which the description was created or modified. 
  3503.  
  3504.     7. Folder's title - the parent folder's title, if it could be found in the 
  3505.        current object description file. 
  3506.  
  3507. o the Icon view - the window will contain the object's icon and the title. This 
  3508.   is the Non-grid icon view format. 
  3509.  
  3510. o the Name view - it is the same as above in Flowed format. 
  3511.  
  3512. o the Text view - it is the same as above in Flowed format without icons, i.e. 
  3513.   the title only. 
  3514.  
  3515. o the Tree view - the window will contain the objects grouped by folder and 
  3516.   including the relationship between the folders, as far as it can be resolved 
  3517.   using the contents of the current object description file. 
  3518.  
  3519.  
  3520. ΓòÉΓòÉΓòÉ 18. Limitations ΓòÉΓòÉΓòÉ
  3521.  
  3522. At this time, DeskMan/2 has some processing limitations: 
  3523.  
  3524. o A maximum of 2048 objects can be saved in a single .DRC or .CMD file. 
  3525. o A maximum of 512 folders can be selected for a recreate operation. 
  3526. o A maximum of 2048 objects can be selected for a recreate operation. 
  3527. o Objects within the restore container can be selected at a maximum depth of 
  3528.   512 nested folders. 
  3529.  
  3530. The destroy object on drop function will remove almost anything, but not 
  3531. everything.  It cannot, at this time, always remove certain WPS objects, 
  3532. including Drives objects and broken shadows. 
  3533.  
  3534. The destroy object on drop function makes its best efforts to remove from your 
  3535. desktop anything dropped into the flush bowl.  But it may happen that it fails 
  3536. on specific WPS objects, such as Drives, broken shadows, etc. Sometimes it 
  3537. helps to remove the contents of a folder before trying to get rid of the folder 
  3538. itself. 
  3539.  
  3540. Note:   This function may not work correctly if your system has any problems 
  3541. with INI files or Extended Attributes for the desktop. 
  3542.  
  3543. As mentioned before, there are some limitations in the spectrum of information 
  3544. DeskMan/2 can acquire about WPS objects and therefore some manual user 
  3545. intervention may be required when restoring them. The objects affected are 
  3546. those from class WPFolder, shadows of WPDrives and WPPrinter, as well as user 
  3547. defined classes.. 
  3548.  
  3549. DeskMan/2 will NOT save objects that are: 
  3550.  
  3551. o not located on your desktop (i.e. you can not save a directory dragged out of 
  3552.   the Drives folder). 
  3553.  
  3554. o objects of class WPTransient or descendents of thereof. Those objects are of 
  3555.   a temporary nature and usually created directly by the system or by programs. 
  3556.   Examples include printer ports and printer drivers. 
  3557.  
  3558.  Another limitation you must be aware of arises from the object's location 
  3559. identification concept, as implemented by WPS. There are two ways to identify 
  3560. (specify) a location for any WPS object: 
  3561.  
  3562.  1. by using the physical path pointing to a folder(directory) or 
  3563.  
  3564.  2. by using unique object's identifier (OBJECTID) assigned either by default 
  3565.     (by WPS when installing OS/2) or by the user. 
  3566.  
  3567. Each of the above methods has its drawbacks: 
  3568.  
  3569.  1. the physical path may change when migrating objects to a different file 
  3570.     system than the one on which they were originally created. Also, a change 
  3571.     in the desktop's name/location by the user would affect the ability to 
  3572.     recreate them (by any method). 
  3573.  
  3574.  2. assigning a unique OBJECTID to all WPS objects would have a heavy impact on 
  3575.     the WPS - there is a limit to the size and number of entries that are kept 
  3576.     in the OS2.INI files. Besides, all those objects would have to be recreated 
  3577.     when migrating, and controlling the completeness of the setup file(s) would 
  3578.     be a tremendous task. 
  3579.  
  3580. Those are the reasons that DeskMan/2 is using a mixed approach, combining 
  3581. methods 1 and 2, which provides the most flexibility with the least 
  3582. limitations. 
  3583.  
  3584. When resolving an object's structure and looking for its location, DeskMan/2 
  3585. will assign unique OBJECTIDs for any folder that has not had an OBJECTID 
  3586. assigned yet. This means that: 
  3587.  
  3588.  1. you will have to first create an entry in the object description file for 
  3589.     the folder containing the objects you want to save. If you drop an object 
  3590.     on DeskMan/2's icon before you drop the folder in which the object is 
  3591.     located, the description will not be created, and you'll get a popup 
  3592.     notifying you of the reason. 
  3593.  
  3594.  2. when selectively (re)creating objects, you will have to recreate the 
  3595.     folders before the objects located in them. 
  3596.  
  3597. If the object is located in a folder that already has a default OBJECTID (like 
  3598. the Desktop = <WP_DESKTOP> has), you will not have to do anything. 
  3599.  
  3600. More serious limitations concern the saving/(re)creation of shadows: 
  3601.  
  3602. o if the object is a shadow of an object that already has an OBJECTID assigned, 
  3603.   its description can be easily created. Otherwise, to satisfy a request to 
  3604.   save a description for a shadow, DeskMan/2 will assign an OBJECTID to the 
  3605.   original, unless it has a class of WP*File. 
  3606.  
  3607. o if the object is a shadow of a real object (WPFile, WPProgramFile), the real 
  3608.   file name is used to establish the shadow - original relationship and the 
  3609.   shadow's description can be created. 
  3610. However, it is the user's responsibility to assure that the original exists on 
  3611. the target system before (re)creating the shadow. 
  3612.  
  3613. And last, but not least, a word of caution - it is not a DeskMan/2 limitation! 
  3614.  
  3615. It was discovered that, after mysterious WPS crashes, the default OBJECTID for 
  3616. the desktop may change to a value different than <WP_DESKTOP>.  The visual 
  3617. symptom of this would be the lack of Shut down and Lockup choices for the 
  3618. desktop's popup menu. 
  3619.  
  3620. DeskMan/2 will detect this error situation when you try to process the Desktop 
  3621. or any object located on the desktop - it will notify you and give you a choice 
  3622. to: 
  3623.  
  3624. o continue the operation regardless of the error condition. 
  3625.  
  3626. o abort. 
  3627.  
  3628. o assign a default OBJECTID (<WP_DESKTOP>) to the desktop and continue. 
  3629.  
  3630. The suggested fix for this problem is to start a Save Desktop operation, and 
  3631. when DeskMan/2 alerts you to the corrupted OBJECTID, allow it to assign the 
  3632. default OBJECTID to the desktop and continue the Save operation. 
  3633. Alternatively, you can use the Special Function - Assign OBJECTID on drop, to 
  3634. assign an OBJECTID of <WP_DESKTOP> to the desktop object.  You will find this 
  3635. object located in the OS/2 system partition located in the Drives folder.  For 
  3636. example, if you use drive D as your OS/2 system partition, your desktop object 
  3637. will be located at the root level of drive D, in your Drives folder. 
  3638.  
  3639.  
  3640. ΓòÉΓòÉΓòÉ <hidden> Hierarchical order ΓòÉΓòÉΓòÉ
  3641.  
  3642. Hierarchical order means that the objects will be created (restored) in a 
  3643. certain sequence: folders before any object located in them. 
  3644.  
  3645. This sequence is necessary in order to define an object location, a folder 
  3646. identified by an OBJECTID., properly.  The OBJECTID is the only way to 
  3647. establish a unique relationship between objects and a folder holding them. 
  3648.  
  3649.  
  3650. ΓòÉΓòÉΓòÉ <hidden> ReadMe document for Beta-5 ΓòÉΓòÉΓòÉ
  3651.  
  3652. From:  Noel J. Bergman, Development Technologies, Inc. (DevTech) 
  3653. To:   DeskMan/2 Beta Testers 
  3654.  
  3655. REGISTRATION PROCEDURE: When registering this version of DeskMan/2, please 
  3656. enter "Beta-5" for the customer name and "260176" for the registration number. 
  3657. This will register the product to the Beta-5 release.  When we ship the final 
  3658. product, each user will be assigned their own individual registration number. 
  3659. If you've any problems, please contact us as soon as possible. 
  3660.  
  3661.                                      WELCOME
  3662.  
  3663. Welcome to Beta-5! This version contains a number of bug fixes, several 
  3664. enhancements, and additional changes to the documentation.  It also improves 
  3665. upon the graphical installation procedure, new with Beta-4.  We have tested it 
  3666. with all of the old versions of the OS, as well as the new March release of 
  3667. OS/2 2.1.  We hope that you find this version even more reliable and easy to 
  3668. use. 
  3669.  
  3670. Warning:  THIS BETA WILL CEASE TO FUNCTION AFTER APRIL 30, 1993! 
  3671.  
  3672. Note:   This version is being distributed as an open Beta! This pre-release 
  3673. version is being distributed as a courtesy to support those people who need to 
  3674. convert to the March OS/2 2.1 Beta.  This version of DeskMan/2 may be freely 
  3675. distributed and used throughout the months of March and April, 1993. Support 
  3676. will ONLY be provided to those people who have REGISTERED  their product, or 
  3677. who are on our internal Beta list. 
  3678.  
  3679. README.001 contains the README file from BETA-1.  README.002 contains the 
  3680. README file from BETA-2.  README.003 contains the README file from BETA-3. 
  3681. README.004 contains the README file from BETA-4.  We will continue to provide 
  3682. the entire series of README files, unless we get complaints, since that gives 
  3683. new testers complete information. 
  3684.  
  3685.                                     FEEDBACK
  3686.  
  3687. We hope to have only one more beta release, after this one.  Your feedback is 
  3688. very valuable to us.  Please let us know how you like the program, whether or 
  3689. not you are having any problems, how you like the direction that the 
  3690. documentation is taking, etc.; defect reports are not the only feedback that we 
  3691. have consider valuable. 
  3692.  
  3693. To all of those who have provided feedback, thus far: Many Thanks! 
  3694.  
  3695.                                   INSTALLATION
  3696.  
  3697. To install this version of DeskMan/2, simply place the uncompressed 
  3698. installation files onto your system in a single directory, and run INSTALL.EXE. 
  3699. This can be done from your hard drive or from a diskette.  If you specify a 
  3700. drive letter, as in "INSTALL C:", then the installation program will not search 
  3701. the other drives when looking for files. 
  3702.  
  3703. If you wish to do a clean installation, you can use the Remove command in the 
  3704. new INSTALL.EXE, or you can use the REMOVE.CMD file which is still being 
  3705. provided to you.  Either will remove DeskMan/2's object, class registration, 
  3706. and .INI entry for both the alpha and beta levels. 
  3707.  
  3708.                                ABOUT THIS RELEASE
  3709.  
  3710. The online help and user's guide are undergoing complete re-writes.  This 
  3711. version has been extensively updated, with more yet to come. Please let us know 
  3712. what you think of the documentation and the direction it is taking. 
  3713.  
  3714. Bugs have been fixed in a number of areas, and enhancements added: 
  3715.  
  3716. o Numerous errors in the the online help documents have been rectified 
  3717. o Processing windows should now be positioned in the middle of the screen 
  3718. o Copyright notices have been fixed 
  3719. o Path checking for Install and Settings fixed 
  3720. o Additional diagnostics have been implemented with regard to file i/o errors 
  3721. o Should no longer steal the focus from other PM apps during installation 
  3722. o Cancel Processing in the Debug window will cancel Save and Restore processing 
  3723. o Positioning of the container splitbar outside the visible area fixed 
  3724. o Crashing when executing commands upon the contents of an empty container, 
  3725.   fixed 
  3726. o Fixed problem with locating folders during restore operation 
  3727. o Fixed crash if error occurs on writing icons 
  3728. o Removed "in use" emphasis if DeskMan/2 crashes 
  3729. o Checkboxes synchronized in Settings 
  3730. o Confirmations for Save System settings fixed 
  3731. o Fixed loss of '%' out of parameters 
  3732. o Crashes on Save in restore container, due to stack problems, fixed 
  3733. o Change in the generated REXX program to alter the option from 'Fail if 
  3734.   Exists' to 'Skip if Exists' 
  3735. o On installation, file system is checked for FAT or HPFS, and if not found, 
  3736.   that file system is skipped.  This prevents the long search of CD-ROM disks. 
  3737. o Replaced Special Function: Query OBJECTID and Class to Query Object Settings. 
  3738. o Notification upon printer object restoration of installation requirement. 
  3739. o Includes Date Validation code to terminate program effectivity at the end of 
  3740.   April, 1993. 
  3741. o The Templates folder's contents are now saved correctly. 
  3742.  
  3743.   Note:   When the Templates folder is being saved, it may cause Help for the 
  3744.   Data file to be displayed.  This is caused by a bug in WPS.  The Help can be 
  3745.   closed, although it might open itself again if still processing the Templates 
  3746.   folder, but there are no known negative side effects of this strange 
  3747.   behavior. 
  3748.  
  3749.  
  3750. ΓòÉΓòÉΓòÉ <hidden> ReadMe document for Beta-4 ΓòÉΓòÉΓòÉ
  3751.  
  3752. From:  Noel J. Bergman, Development Technologies, Inc. (DevTech) 
  3753. To:   DeskMan/2 Beta Testers 
  3754.  
  3755. NEW REGISTRATION PROCEDURE: When registering this version of DeskMan/2, please 
  3756. enter "Beta-4" for the customer name and "423269" for the registration number. 
  3757. This will register the product to the Beta-4 release.  When we ship the final 
  3758. product, each user will be assigned their own individual registration number. 
  3759. If you've any problems, please contact us as soon as possible. 
  3760.  
  3761.                                      WELCOME
  3762.  
  3763. Welcome to BETA-4!  This version has a number of bug fixes, several 
  3764. enhancements, and additional changes to the documentation.  It also has a 
  3765. completely new graphical installation procedure.  We have tested it with all of 
  3766. the old versions of the OS, as well as the new March release of OS/2 2.1.  We 
  3767. hope that you find it as reliable and easy to use as we have. 
  3768.  
  3769. README.001 contains the README file from BETA-1.  README.002 contains the 
  3770. README file from BETA-2.  README.003 contains the README file from BETA-3.  We 
  3771. will continue to provide the entire series of README files, unless we get 
  3772. complaints, since that gives new testers complete information. 
  3773.  
  3774.                                     FEEDBACK
  3775.  
  3776. We hope to have only one more beta release, after this one.  Your feedback is 
  3777. very valuable to us.  Please let us know how you like the program, whether or 
  3778. not you are having any problems, how you like the direction that the 
  3779. documentation is taking, etc.; defect reports are not the only feedback that we 
  3780. have consider valuable. 
  3781.  
  3782. To all of those who have provided feedback, thus far: Many Thanks! 
  3783.  
  3784.                                   INSTALLATION
  3785.  
  3786. To install this version of DeskMan/2, simply place the uncompressed 
  3787. installation files onto your system in a single directory, and run INSTALL.EXE. 
  3788. This can be done from your hard drive or from a diskette.  If you specify a 
  3789. drive letter, as in "INSTALL C:", then the installation program will not search 
  3790. the other drives when looking for files. 
  3791.  
  3792. If you wish to do a clean installation, you can use the Remove command in the 
  3793. new INSTALL.EXE, or you can use the REMOVE.CMD file which is still being 
  3794. provided to you.  Either will remove the object, class registration, and .INI 
  3795. entry for both the alpha and beta levels of DeskMan/2. 
  3796.  
  3797.                                ABOUT THIS RELEASE
  3798.  
  3799. The online help and user's guide are undergoing complete re-writes.  This 
  3800. version has been extensively updated, with more yet to come.  Please let us 
  3801. know what you think of the documentation and the direction it is taking. 
  3802.  
  3803. Bugs have been fixed in a number of areas, and enhancements added: 
  3804.  
  3805. o New PM-based graphical installation procedure 
  3806.  
  3807. o New Special function: Change Object Style 
  3808.  
  3809. o Style Changes disabled for the DeskMan/2 object 
  3810.  
  3811. o The System settings and colors of your Desktop can be saved and restored 
  3812.  
  3813. o Save / Restore system settings disabled for unregistered version 
  3814.  
  3815. o New Registration Code to use unique customer name / registration number 
  3816.  
  3817. o Online Registration is enabled for unregistered copies, only 
  3818.  
  3819. o Container sort traps on sort by folder title or date/time - fixed 
  3820.  
  3821. o Crash when removing objects from restore container - fixed 
  3822.  
  3823. o DeskMan/2 object menu added to the container's system menu 
  3824.  
  3825. o Restore missing only renamed to Skip if exists and mutually exclusive with 
  3826.   other restore options 
  3827.  
  3828. o Restore desktop added to the object's menu with the same options as in the 
  3829.   container 
  3830.  
  3831. o Special functions stick till reset 
  3832.  
  3833. o Private class registration for restore processing fixed 
  3834.  
  3835. o Fixed problem of incorrect OBJECTIDs assigned for folders with multi-line 
  3836.   titles 
  3837.  
  3838. o Entry fields for various settings made wider (up to 255 characters) 
  3839.  
  3840. o Errors in Debug log processing fixed 
  3841.  
  3842. o DMANHELP.HLP file renamed to DESKMAN.HLP 
  3843.  
  3844. o This copy licensed to:... messages added to the processing windows. 
  3845.  
  3846.  
  3847. ΓòÉΓòÉΓòÉ <hidden> ReadMe document for Beta-3 ΓòÉΓòÉΓòÉ
  3848.  
  3849. From:  Noel J. Bergman, Development Technologies, Inc. (DevTech) 
  3850. To:   DeskMan/2 Beta Testers 
  3851.  
  3852.                                      WELCOME
  3853.  
  3854. Welcome to BETA-3!  This version has several bug fixes and additional changes 
  3855. to the documentation. 
  3856.  
  3857. README.001 contains the README file from BETA-1.  README.002 contains the 
  3858. README file from BETA-2.  We will continue to provide the entire series of 
  3859. README files, unless we get complaints, since that gives new testers complete 
  3860. information. 
  3861.  
  3862.                                     FEEDBACK
  3863.  
  3864. Your feedback is very valuable to us.  Let us know how you like the program, 
  3865. whether or not you are having any problems, how you like the direction that the 
  3866. documentation is taking, etc.; defect reports are not the only feedback that we 
  3867. have consider valuable. 
  3868.  
  3869. To all of those who have provided feedback, thus far: Many Thanks! 
  3870.  
  3871.                                   INSTALLATION
  3872.  
  3873. Please VIEW DESKMAN, and read the step by step instructions. 
  3874.  
  3875. When asked, please provide DeskMan/2 with your name (it will appear in the 
  3876. Product Information dialog), and the registration number: 000009. 
  3877.  
  3878. If you wish to do a clean installation, REMOVE.CMD has been extended to remove 
  3879. the object, class registration, and .INI entry for both the alpha and beta 
  3880. levels of DeskMan/2. 
  3881.  
  3882. --------------------------- 
  3883.  
  3884. Note:   TO EARLY TEST GROUP: We are in the process of changing from the 
  3885. internal name "DMAN" to the formal name "DeskMan".  REMOVE.CMD will remove the 
  3886. old stuff from your system (object, class and INI entry), as well as the newer 
  3887. information.  You also no longer need to do a manual deletion of the files. 
  3888.  
  3889. Note:   TO CD-ROM USERS: Please put a CD-ROM in your CD-ROM drive; otherwise, 
  3890. the installation procedure may generate a popup when it scans that drive. 
  3891.  
  3892. Note:   TO OS/2 2.0 GA USERS: You must have SOMFIX and REXX20 installed in 
  3893. order for DeskMan/2 to work. 
  3894.  
  3895. --------------------------- 
  3896.  
  3897. VIEW DESKMAN for more information on all of these issues. 
  3898.  
  3899.                                ABOUT THIS RELEASE
  3900.  
  3901. The online help and user's guide are undergoing complete re-writes.  This 
  3902. version has been extensively updated, with more yet to come.  Please let us 
  3903. know what you think of the documentation and the direction it is taking. 
  3904.  
  3905. Bugs have been fixed in a number of areas, and enhancements added: 
  3906.  
  3907. o The README documentation has now been incorporated into the general help 
  3908.   system for DeskMan/2. 
  3909.  
  3910. o REMOVE.CMD will remove both Alpha test and Beta test objects.  You no longer 
  3911.   need to remove the .DLL, .INF, and .HLP files manually, if you want them 
  3912.   deleted. 
  3913.  
  3914. o DeskMan/2's Icon's Restore Desktop RESTORES MISSING OBJECTS ONLY! 
  3915.  
  3916. o DeskMan/2's Container Context menu Restore Desktop now has three separate 
  3917.   Restore options (update, replace, or fail [skip] if the object exists), which 
  3918.   are selected from at runtime. 
  3919.  
  3920. o Directories specified in the Settings notebook have their existence verified 
  3921.   when DeskMan/2 is notified of any changes.  If any directory is specified but 
  3922.   not found, it is optionally created.  If not found and not created, the 
  3923.   change in directory is not accepted. 
  3924.   Note:  The directory checking is still a bit kludgy, as DeskMan/2 is not 
  3925.   notified of any changes in the Notebook Settings by the WPS until the 
  3926.   notebook page is turned, the entry field loses focus, or the dialogue box is 
  3927.   closed. 
  3928.  
  3929. o Initial path info for Settings during installation fixed. 
  3930.  
  3931. o Error in handling folder shadows processed prior to the original object and 
  3932.   with multiple line names, fixed. 
  3933.  
  3934. o Increased stack size for Save processing. 
  3935.  
  3936. o Temp and/or TMP environment variables no longer required. 
  3937.  
  3938. o The new INSTALL.CMD automatically opens, briefly, a DOS window to get some 
  3939.   system specific information for debugging purposes.  The information being 
  3940.   collected includes: dates for SOM.DLL, REXXUTIL.DLL, DeskMan.DLL, and system 
  3941.   ver/internal release. 
  3942.  
  3943. o REMOVE.CMD will remove ALL DeskMan files from all drives or a drive specified 
  3944.   as parameter, 
  3945.  
  3946. o Create ICONS setting is by default TRUE now, 
  3947.  
  3948. o Restore desktop will be disabled for the shareware/demo version. 
  3949.  
  3950. o The option to register DeskMan/2 is now available on the object's context 
  3951.   menu under Help.  It allows a user to register, or reregister, DeskMan/2, 
  3952.   without having to reinstall the product. 
  3953.  
  3954. o The Cancel option for the Open dialog that pops up when doing a Restore 
  3955.   Desktop is fixed. 
  3956.  
  3957. o INSTALL.CMD's DOS information retrieval now works when INSTALL.CMD is run 
  3958.   from an HPFS directory. 
  3959.  
  3960. o NEW SPECIAL FUNCTION! Change Object Style now added. 
  3961.  
  3962.  
  3963. ΓòÉΓòÉΓòÉ <hidden> ReadMe document for Beta-2 ΓòÉΓòÉΓòÉ
  3964.  
  3965. From:  Noel J. Bergman, Development Technologies, Inc. (DevTech) 
  3966. To:   DeskMan/2 Beta Testers 
  3967.  
  3968.                                      WELCOME
  3969.  
  3970. Welcome to BETA-2!  This version has several bug fixes and additional changes 
  3971. to the documentation. 
  3972.  
  3973. README.001 contains the README file from BETA-1.  We will continue to provide 
  3974. the entire series of README files, unless we get complaints, since that gives 
  3975. new testers complete information. 
  3976.  
  3977.                                     FEEDBACK
  3978.  
  3979. Your feedback is very valuable to us.  Let us know how you like the program, 
  3980. whether or not you are having any problems, how you like the direction that the 
  3981. documentation is taking, etc.; defect reports are not the only feedback that we 
  3982. have consider valuable. 
  3983.  
  3984. To all of those who have provided feedback, thus far: Many Thanks! 
  3985.  
  3986.                                   INSTALLATION
  3987.  
  3988. Please VIEW DESKMAN, and read the step by step instructions. 
  3989.  
  3990. When asked, please provide DeskMan/2 with your name (it will appear in the 
  3991. Product Information dialog), and the registration number: 000009. 
  3992.  
  3993. If you wish to do a clean installation, REMOVE.CMD has been extended to remove 
  3994. the object, class registration, and .INI entry for both the alpha and beta 
  3995. levels of DeskMan/2. 
  3996.  
  3997. --------------------------- 
  3998.  
  3999. Note:   TO EARLY TEST GROUP: We are in the process of changing from the 
  4000. internal name "DMAN" to the formal name "DeskMan".  REMOVE.CMD will remove the 
  4001. old stuff from your system (object, class & INI entry).  After running it, you 
  4002. will still need to remove DMAN.DLL, DMAN.INF & DMANHELP.HLP manually. 
  4003.  
  4004. Note:   TO CD-ROM USERS: Please put a CD-ROM in your CD-ROM drive; otherwise, 
  4005. the installation procedure may generate a popup when it scans that drive. 
  4006.  
  4007. Note:   TO OS/2 2.0 GA USERS: You must have SOMFIX and REXX20 installed in 
  4008. order for DeskMan/2 to work. 
  4009.  
  4010. --------------------------- 
  4011.  
  4012. VIEW DESKMAN for more information on all of these issues. 
  4013.  
  4014.                                ABOUT THIS RELEASE
  4015.  
  4016. The online help and user's guide are undergoing complete re-writes.  This 
  4017. version has been extensively updated, with more yet to come.  Please let us 
  4018. know what you think of the documentation and the direction it is taking. 
  4019.  
  4020. Bugs have been fixed in a number of areas, and enhancements added: 
  4021.  
  4022. o The Help window is resized to 50/90% of the screen, except off of the WPS 
  4023.   desktop icon (still 25/25%). 
  4024.  
  4025. o Double quotes (") can be put into the parameter fields of objects and will be 
  4026.   correctly recreated using either DeskMan/2 or the generated REXX scripts. 
  4027.  
  4028. o The maximum number of objects and other limits have been raised to match the 
  4029.   online documentation. 
  4030.  
  4031. o The install program, when doing a clean install, will ask for a directory for 
  4032.   the .DRC, .CMD, .ICO, and .LOG files.  If you do not specify a directory, it 
  4033.   will default to the current directory.  Otherwise, the current .INI settings 
  4034.   are preserved. 
  4035.  
  4036. o Fixed the problem where DeskMan/2 crashed when closing the debug window 
  4037.  
  4038. o Fixed problems where a dropped object might be accessed after its SOM pointer 
  4039.   was unlocked. 
  4040.  
  4041. o Fixed problem where X:\YYYY (a four character path) was improperly handled 
  4042.   (we are checking to see if it was really our bug, or a bug in 
  4043.   PrfQueryProfileString). 
  4044.  
  4045. o REMOVE.CMD will remove both Alpha test and Beta test objects.  You still need 
  4046.   to remove the .DLL, .INF, and .HLP files manually, if you want them deleted. 
  4047.  
  4048.  
  4049. ΓòÉΓòÉΓòÉ <hidden> ReadMe document for Beta-1 ΓòÉΓòÉΓòÉ
  4050.  
  4051. From:  Noel J. Bergman, Development Technologies, Inc. (DevTech) 
  4052. To:   DeskMan/2 Beta Testers 
  4053.  
  4054.                                      WELCOME
  4055.  
  4056. Thank you for offering to test DeskMan/2.  We look forward to receiving great 
  4057. feedback from you during the beta period.  Amongst the things that we hope to 
  4058. hear about are: 
  4059.  
  4060. Reliability - This is our primary concern for this first release.  Changes to 
  4061. the User Interface and feature set will probably be postponed until the next 
  4062. version. 
  4063.  
  4064. User Interface - We have plans to change it quite a bit in the future, going to 
  4065. a more independent, icon oriented appearance.  Each drag and drop function 
  4066. would be accessed through a different icon, rather than setting a special 
  4067. state, and we'd be able to have multiple copies of each, as appropriate.  What 
  4068. do you think?  As with all things, feedback from our customers is the real 
  4069. driving force. 
  4070.  
  4071. Feature Set - We have a list of new features that we'd like to see in future 
  4072. versions of DeskMan/2 (including network oriented features), but what would 
  4073. _you_ like added? 
  4074.  
  4075. Beyond that, we would like to continue the dialogue on packaging, pricing, etc. 
  4076. with you.  Your initial responses have been very helpful.  We aren't a huge, 
  4077. multi-national conglomerate; we are very much geared to low overhead, creative 
  4078. solutions that serve both us and our neighbors in this OS/2 community. Your 
  4079. ideas will always be welcomed here.  The entire purpose for the signup form was 
  4080. to raise questions and gather information.  We've already been surprised by how 
  4081. many of you are running various revisions of OS/2 2.X. 
  4082.  
  4083. Just to let you know, the vast majority of you favored SOME form of limitation 
  4084. to the "unregistered" version.  A few of you questioned the approach, both in 
  4085. terms of effectiveness, and from an ASP perspective.  From our perspective, we 
  4086. are interested in providing a useful product to people that still preserves an 
  4087. incentive for them to purchase it. 
  4088.  
  4089. Almost everyone mentioned site licenses.  Yes, we are quite willing to talk to 
  4090. companies about site and corporate licensing, as well as possible technology 
  4091. licensing.  If IBM wanted to bundle it with OS/2, we'd consider that, too. 
  4092.  
  4093.                                  A JOINT VENTURE
  4094.  
  4095. Some of you, particularly our early testers, have asked about the relationship 
  4096. between Development Technologies, and Gregory Czaja.  The relationship has been 
  4097. in place for some 5 months, but we've been fairly quiet about it, so it appears 
  4098. to have come as something of a surprise.  Judging from some of the messages we 
  4099. received, I erred when I sent Gregory the signup letter and beta list, and 
  4100. asked him to send it out; that only added to the confusion. My apologies for 
  4101. the confusion. 
  4102.  
  4103. Late last summer we (DevTech) started work on a tool to generate REXX scripts 
  4104. that would rebuild objects.  Since DevTech's primary project is a family of C++ 
  4105. class libraries, the tool wouldn't have been as ambitious as DeskMan/2.  In 
  4106. early October, Gregory and I became aware of each other's work; by mid- 
  4107. October, DeskMan/2 began operating as a joint venture; and in early January, we 
  4108. finished all of the paperwork.  Early on it was jointly decided that the work 
  4109. would be split, with Gregory focusing on the code for version 1.0, and DevTech 
  4110. handling the other aspects of the project, with an advisory role on the code 
  4111. for version 1.0. 
  4112.  
  4113. We're all very happy with the progress that we've made with DeskMan/2.  From 
  4114. bug fixes; to changes in the feature set and UI; to going multi-threaded and 
  4115. adding support for exceptions; to the online help and user's guide, this 
  4116. venture has been mutually beneficial.  We've been able to get an early version 
  4117. added to the upcoming "OS/2 Unleashed", what looks to be a great book from the 
  4118. SAMS division of Prentice-Hall.  There will be "Show Special" flyers for 
  4119. DeskMan/2 at trade shows (e.g., the OS/2 Technical Interchange in Phoenix). 
  4120.  
  4121. DeskMan/2 is the result of this collaboration, and while we have great plans 
  4122. for its future, we hope that you will be as pleased with its present as we have 
  4123. been.  All feedback that we receive from you will be given the utmost 
  4124. consideration for inclusion into the product. 
  4125.  
  4126.                                   INSTALLATION
  4127.  
  4128. [Yes, Virginia, we will do more work on the installation process.] 
  4129.  
  4130. Completely rewritten installation instructions are available in the new online 
  4131. manual.  Please VIEW DESKMAN, and read the step by step instructions. 
  4132.  
  4133. When asked, please provide DeskMan/2 with your name (it will appear in the 
  4134. Product Information dialog), and the registration number: 000009. 
  4135.  
  4136. --------------------------- 
  4137.  
  4138. NOTE TO EARLY TEST GROUP: We are in the process of changing from the internal 
  4139. name "DMAN" to the formal name "DeskMan".  REMOVE.CMD will remove the old stuff 
  4140. from your system ( object, class & INI entry).  After running it, you will 
  4141. still need to remove DMAN.DLL, DMAN.INF & DMANHELP.HLP manually. 
  4142.  
  4143. NOTE TO CD-ROM USERS: Please put a CD-ROM in your CD-ROM drive; otherwise, the 
  4144. installation procedure may generate a popup when it scans that drive. 
  4145.  
  4146. NOTE TO OS/2 2.0 GA USERS: You must have SOMFIX and REXX20 installed in order 
  4147. for DeskMan/2 to work. 
  4148.  
  4149. --------------------------- 
  4150.  VIEW DESKMAN for more information on all of these issues. 
  4151.  
  4152.                                ABOUT THIS RELEASE
  4153.  
  4154. There are quite a few changes in this release, compared to the last one sent 
  4155. out to our early test group. 
  4156.  
  4157. The online help and user's guide are undergoing complete re-writes.  This 
  4158. version has some of the changes, but the documentation does lag behind the 
  4159. software changes; we wanted to get the beta out to you without further delay. 
  4160. Please let us know what you think of the documentation. 
  4161.  
  4162. Bugs have been fixed in a number of areas, and enhancements added: 
  4163.  
  4164. o Exception handling has been added.  Please report any exception dialogs that 
  4165.   you receive. 
  4166.  
  4167. o Context help has been added for all windows and menus. 
  4168.  
  4169. o The processing window can be minimized. 
  4170.  
  4171. o More debugging information has been added, and the product has been PMPRINTF 
  4172.   enabled.  Using PMPRINTF is a more reliable way to dealing with debugging 
  4173.   messages than maintaining our own debugging log; the old debug log has been 
  4174.   left in for those who don't have PMPRINTF.  When debugging is turned on, 
  4175.   messages either go to the internal debugging log and window, or to PMPRINTF. 
  4176.   See the "Use PMPrintf" setting on the Debug page of DeskMan/2's settings 
  4177.   notebook. 
  4178.  
  4179. o The Save/Restore processing window is sizable and minimizable. 
  4180.  
  4181. o The Window page was removed from DeskMan/2 settings. 
  4182.  
  4183. o The drag & drop support improved.  It now allows a drag to windows accepting 
  4184.   the OS2FILE protocol (e.g., EPM) and an object description will be generated 
  4185.   as a result of the drop. 
  4186.  
  4187. o DMANINS2.CMD renamed to INSTALL.CMD. 
  4188.  
  4189. o INSTALL.CMD will no longer search removable media (it still errors on CD-ROM 
  4190.   drives). 
  4191.  
  4192. o Improved class checking for Save and Restore (accepts descendent and replaced 
  4193.   object classes). 
  4194.  
  4195. o Multi-line object titles are recreated correctly. 
  4196.  
  4197. o Save/Restore operations have better synchronization 
  4198.  
  4199. o Restore desktop added to both container and object context menus.  Selected 
  4200.   from the object context menu, it will perform a selective restore for all 
  4201.   objects from the Restore decription file (as specified in the Restore 
  4202.   settings) which does NOT exist on the desktop, i.e. if the object is there, 
  4203.   it won't be replaced or updated. Only the object's original location is 
  4204.   checked unless the "Search everywhere" option is also checked in the restore 
  4205.   settings (warning! if checked, it will take forever...).  Selected from the 
  4206.   container's context menu, a different restore option may be selected, i.e. 
  4207.   update, replace or restore if missing only, than the default one. 
  4208.  
  4209. o Cancel processing for Restore operations fixed.  If you do a Restore Desktop, 
  4210.   and cancel the processing, the restore will be cancelled, but the processing 
  4211.   window will continue until it exhausts the list of objects to be restored. 
  4212.  
  4213. o Assign OBJECTID will display current OBJECTID if already there. 
  4214.  
  4215. o CLEANUP.CMD added.  This will remove .ICO files not referenced in DeskMan/2's 
  4216.   current .DRC or .CMD files. 
  4217.  
  4218. o The format for ICONRESOURCE (default desktop objects) changed. [NOTE: .DRC 
  4219.   and .CMD files generated with previous DeskMan/2 versions will not work 
  4220.   correctly on OS/2 2.1] 
  4221.  
  4222. o Fixed the registration process for private object classes on restore. 
  4223.  
  4224. o Fixed the object selection for subfolders. 
  4225.  
  4226.  
  4227. ΓòÉΓòÉΓòÉ 19. Program support ΓòÉΓòÉΓòÉ
  4228.  
  4229. Technical support is available to registered users of DeskMan/2, only! 
  4230.  
  4231. If you experience problems using DeskMan/2, try to locate the cause of your 
  4232. trouble. 
  4233. If DeskMan/2 is not performing any of its functions correctly, as described in 
  4234. this manual, you probably have found a problem in the code. 
  4235. If it simply crashes, i.e. the desktop disappears and comes back after WPS 
  4236. restarts it, there may be many reasons for this to happen. The most likely are: 
  4237.  
  4238. o your desktop has a problem with one (or more) of the objects. Try to locate 
  4239.   it using the Debug function and the DeskMan/2 .LOG file. Check your system 
  4240.   partition with CHKDSK.  If you can locate the offending object, try to create 
  4241.   a copy of it and remove the original. 
  4242.  
  4243. o your system may be running short on resources - make sure SWAPPER.DAT has 
  4244.   enough room to grow and close all tasks before performing Save desktop or 
  4245.   complex Restore operations. 
  4246.  
  4247. o if your objects start to act strange, i.e. they start to disappear or 
  4248.   duplicate itself, this may point to a potential problem with OS2.INI or 
  4249.   OS2SYS.INI files or desktop's Extended Attributes. Running CHKDSK may fix it 
  4250.   but usually the only definitely working solution is to reinstall OS/2 2.X 
  4251.   with system partition formatting. 
  4252.  
  4253. o you may have hit a bug in DeskMan/2's code. Try to gather as much detail on 
  4254.   the problem as you can and contact tech support. 
  4255.  
  4256. Please include your name and contact information, your installed customer name 
  4257. (it can be found on any of the Product information panels), a detailed problem 
  4258. description, the generated  .DRC, .CMD and .LOG files and the system 
  4259. information (version, fixes installed, etc.). 
  4260.  
  4261. If you want to acquire a registered version of DeskMan/2 or register the 
  4262. shareware version, please contact Development Technologies, Inc. 
  4263.  
  4264. Enjoy!  Gregory (Greg) Czaja and Development Technologies, Inc. 
  4265.  
  4266.  
  4267. ΓòÉΓòÉΓòÉ 20. To Order DeskMan/2 ΓòÉΓòÉΓòÉ
  4268.  
  4269. To Order DeskMan/2, or to obtain a registration code suitable for use with 
  4270. other than this Beta-release, please send a check for the introductory price of 
  4271. $49.95 (payable in US funds), plus shipping and handling, to Development 
  4272. Technologies, Inc..  Payment may also be made via VISA or MasterCard.  Please 
  4273. include your name (under which the product will be registered), company, 
  4274. address, phone number, product name, and product quantity.  If you choose to 
  4275. pay via credit card, please provide the card number, expiration date, and name 
  4276. as it appears on the card.  For quantity discounts, please contact Development 
  4277. Technologies,Inc..  Credit card payments may be made via electronic mail or by 
  4278. telephone. 
  4279.  
  4280. Note:   If possible, please send in your orders via regular or electronic mail, 
  4281. as demand for this product may exceed our capability to take orders for it over 
  4282. the phone on a timely basis, during this new OS/2 beta release period. 
  4283.  
  4284. Note:   If you wish the product registered under the company name, please so 
  4285. indicate on your order. 
  4286.  
  4287. Shipping and handling within the continental USA will be via Priority Mail, and 
  4288. will cost $3.75.  International shipping will be via Air Mail, and will be 
  4289. charged for on an individual basis. 
  4290.  
  4291. Technical support will be provided primarily via electronic mail, but will also 
  4292. be available via regular mail and via telephone calls to Development 
  4293. Technologies, Inc..  We regret any inconvenience this may cause, but it is the 
  4294. best way of keeping our pricing down and our support level high. 
  4295.  
  4296. You can reach Development Technologies, Inc. 
  4297.  
  4298. by phone: (803) 790-9230 
  4299.       (215) 635-1173 - Available after 4/1/93 (now being activated) 
  4300.  
  4301. by mail: 
  4302.  
  4303. Development Technologies, Inc. 
  4304. 8329 High School Road 
  4305. Elkins Park, PA 19117-2027 
  4306.  
  4307. or by electronic mail: 
  4308.  
  4309. CompuServe:   73220,1030 
  4310. Internet:      73220.1030@compuserve.com 
  4311. America Online: DevTech 
  4312.  
  4313.  
  4314. ΓòÉΓòÉΓòÉ <hidden> Technical Support ΓòÉΓòÉΓòÉ
  4315.  
  4316. Technical support will be provided primarily via electronic mail, but will also 
  4317. be available via regular mail and via telephone calls to Development 
  4318. Technologies, Inc..  We regret any inconvenience this may cause, but it is the 
  4319. best way of keeping our pricing down and our support level high. 
  4320.  
  4321. You can reach Development Technologies, Inc. 
  4322.  
  4323. by phone: (803) 790-9230 
  4324.       (215) 635-1173 - Available after 4/1/93 (now being activated) 
  4325.  
  4326. by mail: 
  4327.  
  4328. Development Technologies, Inc. 
  4329. 8329 High School Road 
  4330. Elkins Park, PA 19117-2027 
  4331.  
  4332. or by electronic mail: 
  4333.  
  4334. CompuServe:   76704,34 
  4335. Internet:      76704.34@compuserve.com 
  4336. America Online: DevTech 
  4337.  
  4338.  
  4339. ΓòÉΓòÉΓòÉ <hidden> More than 2K objects to backup? ΓòÉΓòÉΓòÉ
  4340.  
  4341. If you have more than 2048 objects, you can still have DeskMan/2 create a .CMD 
  4342. file that will recreate your complete desktop! Simply open the DeskMan/2 
  4343. settings, and on the first page, under Save, turn off Generate object 
  4344. description file, and on the next page, still under Save, make sure that the 
  4345. Generate REXX program setting is both turned on and set to 'replace if file 
  4346. exists'.