home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Security / Security.zip / swp401.zip / OBJMANAG.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-06-12  |  12KB  |  223 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Cover ΓòÉΓòÉΓòÉ
  3.  
  4.                          "The Secure Workplace for OS/2"
  5.                                  Object Manager
  6.                                   Version 4.01B
  7.                    Copyright (c) Syntegration Inc. 1993, 1996.
  8.                               All Rights Reserved.
  9.                             3811 Schaefer Avenue, #J
  10.                              Chino, California 91710
  11.                                      U.S.A.
  12.                                 Tel: 909-464-9450
  13.                                 Fax: 909-627-3541
  14.                         E-Mail:73707.3331@COMPUSERVE.COM
  15.  
  16.  
  17. ΓòÉΓòÉΓòÉ 2. License Agreement and Limited Warranty ΓòÉΓòÉΓòÉ
  18.  
  19. This program, including its code and documentation, appearance, structure and 
  20. organization is a product of Syntegration and is protected by copyright and 
  21. other laws. Title to the program or any copy, modification or merged portion of 
  22. the program shall at all times remain with Syntegration. 
  23.  
  24. LICENSE - The following restricted rights are granted: 
  25.  
  26. You may: 
  27.  
  28.  1. Use the Program only on a single computer. The Program may be transferred 
  29.     to and used on another computer as long as the program is de-installed from 
  30.     the original computer, and under no circumstances be used on more than one 
  31.     computer at a time. 
  32.  
  33.  2. If you purchased an Enterprise Edition license for this Program, you may 
  34.     use the Program on as many computers as you have licensed. 
  35.  
  36.  3. Transfer the Program with this license to another person, but only if the 
  37.     other person agrees to accept the terms and conditions of this agreement. 
  38.     If you transfer the Program and License, you must at the same time either 
  39.     transfer all copies of the program and its documentation to the same person 
  40.     or destroy those not transferred. Any transfer terminates your license. 
  41.  
  42.  4. Include the program as part of a system that you resell. If you include the 
  43.     program as part of another system you must include this license agreement, 
  44.     acknowledge our copyright in your system documentation, and comply with the 
  45.     transfer clause. 
  46.  
  47. YOU MAY NOT: 
  48.  
  49.  1. TRANSFER OR RENT THE PROGRAM OR USE, COPY OR  MODIFY THE PROGRAM EXCEPT AS 
  50.     PERMITTED IN THIS AGREEMENT. 
  51.  
  52.  2. DECOMPILE, REVERSE ASSEMBLE OR OTHERWISE REVERSE ENGINEER THE PROGRAM. 
  53.  
  54.  3. REPRODUCE, DISTRIBUTE OR REVISE THE PROGRAM DOCUMENTATION. 
  55.  
  56. LIMITED WARRANTY 
  57.  
  58. EXCEPT AS SPECIFICALLY STATED IN THIS AGREEMENT, THE PROGRAM IS PROVIDED "AS 
  59. IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT 
  60. NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
  61. PARTICULAR PURPOSE. 
  62.  
  63. Syntegration warrants that the disk on which the Program is furnished will be 
  64. free from defects in materials and workmanship under normal use for a period of 
  65. 90 days from the date of delivery to you. 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 3. The Object Manager ΓòÉΓòÉΓòÉ
  69.  
  70. The Object Manager is an Workplace shell class that allows you to query, save, 
  71. delete, and update other workplace shell objects. 
  72.  
  73. When you drop an object onto the object manager, a window displays the object's 
  74. settings. 
  75.  
  76. When you open the object manager it allows you select from a list of available 
  77. objects on your desktop. Once an object is selected its settings are displayed. 
  78.  
  79. From the Object Settings window you can save the object, delete the object, or 
  80. update its settings. 
  81.  
  82. For details on the Object Manager features, select from the list below: 
  83.  
  84. o Object Settings 
  85. o Object Selection 
  86. o Updating an Object 
  87. o Deleting Object(s) 
  88. o Saving Object(s) 
  89. o The default save directory 
  90. o The icon directory 
  91.  
  92.  
  93. ΓòÉΓòÉΓòÉ 3.1. Object Settings ΓòÉΓòÉΓòÉ
  94.  
  95. The Object Settings displays all the information Object Manager can obtain 
  96. about the selected object. 
  97.  
  98. Class 
  99.      The Object's Class is displayed in this field. This item is readonly. You 
  100.      cannot change the value. 
  101.  
  102. Title 
  103.      The object's title. The caret "^" is used as a line delimiter for multiple 
  104.      line titles. You can enter a new title if you wish. 
  105.  
  106. Location 
  107.      The Object's location is the Object ID of the Folder that contains it. If 
  108.      the folder does not have an Object ID, Then the file path of the folder is 
  109.      displayed. In most cases a folder's file path can be substituted for it's 
  110.      object ID. 
  111.  
  112. Object ID 
  113.      This is the Identity assigned to the object. An Object ID is a unique 
  114.      string preceded with a '<' and terminated with a '>'. The Object ID will 
  115.      remain with the object throughout its life unless you change it. You use 
  116.      the Object ID to refer to the Object with REXX programs or Object Make 
  117.      Files (*.OMF). You cannot change the Object ID field if the Object already 
  118.      has an Object ID with the '<' and '>' delimiters. to change such an Object 
  119.      ID, use the Settings entry field. Add an entry like 
  120.      "OBJECTID=NewObjectID;". 
  121.  
  122. Settings 
  123.      The Settings Multi-Line Entry field contains object settings in the 
  124.      "KEYNAME=VALUE;" pairs used to recreate objects. KEYNAMES are separated by 
  125.      semicolons and "VALUES" are separated by commas. If you want a literal 
  126.      comma enter '^,'. For a literal semicolon enter '^;' Refer to your user 
  127.      manual or on-line documentation for a detailed description of the setup 
  128.      keywords available for each Workplace Shell class. 
  129.  
  130. Styles 
  131.      Styles are setup options that lend themself nicely for display and update 
  132.      with checkboxes. Your user manual and on-line documentation describes each 
  133.      style in detail. 
  134.  
  135. The Pushbuttons at the base of the Object Settings window allow you to take the 
  136. following actions on the object: 
  137.  
  138. o Update 
  139. o Delete 
  140. o Save 
  141. o Convert 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 3.1.1. Updating an Object ΓòÉΓòÉΓòÉ
  145.  
  146. When you press the Update pushbutton Object Manager makes any changes that you 
  147. entered into the Object Settings Window. With this function you can modify any 
  148. setting. 
  149.  
  150. Refer to your user manual or on-line documentation for details on the 
  151. "keyname=values;" that you can use. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 3.1.2. Deleting an Object ΓòÉΓòÉΓòÉ
  155.  
  156. When you press the "Delete..." pushbutton Object Manager will destroy the 
  157. object described in the Object Settings Window. It does not matter if the "No 
  158. Delete" styles is set. Object Manager will make the object deleteable and then 
  159. destroy it. 
  160.  
  161. If the Object is a folder, then all the objects inside will also be deleted. 
  162.  
  163. Please be careful when using this function. Once an object is deleted you 
  164. cannot undelete it. However, you may be able to restore the object if it was 
  165. backed up with the save function. 
  166.  
  167. You can use this function to delete duplicate templates that sometimes occur in 
  168. your Templates folder. It's not a wise idea to destroy the whole Templates 
  169. folder unless you know what you are doing. 
  170.  
  171. Object manager will not allow you to delete your desktop. 
  172.  
  173.  
  174. ΓòÉΓòÉΓòÉ 3.1.3. Saving Objects ΓòÉΓòÉΓòÉ
  175.  
  176. When you press the "Save..." pushbutton, Object Manager opens a file save 
  177. dialog that prompts you to enter a file name. After selecting the file name 
  178. Object Manager will save the object recreation information into an Object Make 
  179. File (OMF) format. If you enter an existing file name Object Manager will ask 
  180. if you want to append or overwrite the file. By appending to the file you can 
  181. build a list of objects into one OMF. 
  182.  
  183. Object manager takes special action on Folders and their decendents by also 
  184. saving all objects inside. This includes subfolders and objects in subfolders. 
  185.  
  186. Saving folders is a quick way to backup Workplace shell objects that can be 
  187. restored later or onto another machine. 
  188.  
  189. The Object Editor is the restore counterpart for Object Managers save function. 
  190. Refer to you user manual or on-line document for detailed information the 
  191. Object Editor. 
  192.  
  193.  
  194. ΓòÉΓòÉΓòÉ 3.1.4. Converting Folders ΓòÉΓòÉΓòÉ
  195.  
  196. Object Manager will allow you to convert folders from one type to another. This 
  197. function is only available with The Secure Workplace previous versions. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 3.2. Object Selection ΓòÉΓòÉΓòÉ
  201.  
  202. The Object Manager's default view is the object selector window. This window 
  203. appears when you double click the icon with a mouse. 
  204.  
  205. The Object Selector Window contains a list of the available objects in your 
  206. Workplace. The Tree View works much like any Workplace shell tree. 
  207.  
  208. You can select an object by double clicking on it or by pressing the enter key 
  209. when the object's icon is highlighted. 
  210.  
  211. Once your selection is made Object Manager will bring up the Object Settings 
  212. window. 
  213.  
  214.  
  215. ΓòÉΓòÉΓòÉ 3.3. Save Directories ΓòÉΓòÉΓòÉ
  216.  
  217. The Default Save Directory is used by Object manager as the location for object 
  218. save operations. This will be the default directory in the File Save As Dialog. 
  219.  
  220. The Icon Directory is used to store icon files. Icons that are part of the 
  221. OS2.INI file are not available during a restore operation. By making a copy the 
  222. icon and placing it in the icon directory we can make the icon available to the 
  223. Object Editor at restore time.