< Warp Registry Editor - REGEDIT2.EXE July 10, 1998 OS/2 Fix Distribution Personal System Products Austin, Tx (c) Copyright International Business Machines Corporation, 1994, 1996. All rights Reserved. July 10, 1998 - Warp Registry Editor July 10, 1998 - Warp Registry Editor CONTENTS 1.0 Command Support - REGEDIT2 . . . . . . . . . . . . . . . . . . . 1 1.1 Functional Specification . . . . . . . . . . . . . . . . . . . . 1 1.2 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2.1 Editor Arrangement . . . . . . . . . . . . . . . . . . . . . 1 1.2.2 Data Editing . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.3.1 Import Registry File . . . . . . . . . . . . . . . . . . . . 2 1.3.2 Export Registry File . . . . . . . . . . . . . . . . . . . . 3 1.3.3 Open Profile . . . . . . . . . . . . . . . . . . . . . . . . 3 1.3.4 Close Profile . . . . . . . . . . . . . . . . . . . . . . . 3 1.3.5 Print . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.3.6 Edit New Key . . . . . . . . . . . . . . . . . . . . . . . . 3 1.3.7 Edit New String, Binary, DWORD Value . . . . . . . . . . . . 3 1.3.8 Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3.9 Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3.10 Find Next . . . . . . . . . . . . . . . . . . . . . . . . . 4 1.3.11 View Status Bar . . . . . . . . . . . . . . . . . . . . . . 4 1.3.12 View Split Vertical/Horizontal . . . . . . . . . . . . . . 4 1.3.13 Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.3.14 Help . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.3.15 Program Information . . . . . . . . . . . . . . . . . . . . 5 Contents ii July 10, 1998 - Warp Registry Editor 1.0 COMMAND SUPPORT - REGEDIT2 1.1 FUNCTIONAL SPECIFICATION The Warp Registry Editor (REGEDIT2.EXE) was designed to be functionally equivalent to the Registry Editor found in Win95 and NT4.0. In addition to supporting the Open32 Registry Keys, the Warp Registry Editor also supports the standard OS/2 Profile keys and files (*.INI). This was done in a manner as to appear "seamless" to the user providing a single user interface that combines both universes on the Warp platform. 1.2 FEATURES 1.2.1 EDITOR ARRANGEMENT The registry editor consists of two panes separated by a split bar. The pane on the left holds the Registry Keys and Subkeys while the pane on the right holds the Key Values and Data. When a key is selected in the left pane, the Keys Values and Data areautomatically updated in the right pane. The left pane is setup in the traditional OS/2 Folder Tree View while the right pane uses the OS/2 Folder Details view. The split bar can be manipulated by clicking on the bar with the left mouse button and adjusting it left or right. The columns in the right pane automatically size themselves to hold the data. If the data is too large to be completely viewed in the editor, it is truncated. This is indicated by an ellipse (...) at the end of the data. To view more data either resize the editor or edit the field. 1.2.2 DATA EDITING The editor allows you to edit the values of Keys, Values, and Data. Key Names are always edited in place. The edit feature can be activated by selecting the key using the mouse or keyboard arrow keys and then pressing Enter on the keyboard, double clicking with the left mouse button, or holding the ALT key and clicking with the left mouse button. Value Names are also edited in place. This edit feature can be activated by selecting the value using the mouse or keyboard arrow keys and then holding the ALT key and clicking with the left mouse button in the Name Column to ..... The Value Data is edited using dialog boxes or, in the case of String Data only, in place editing. The Data edit feature can be activated by selecting the Value Data using the mouse or keyboard arrow keys and pressing Enter on the keyboard, double clicking with the mouse Command Support - REGEDIT2 1 July 10, 1998 - Warp Registry Editor on the Value (in either Name or Data columns), or by holding the ALT key and pressing the left mouse button (activates in place editing for String Data) in the Data Column. There are separate edit dialogs for String, DWORD, and Binary data. 1.3 MENUS The menu items vary with the context of the Key, Value items selected and which of the two panes have focus. In addition, a popup menu can be invoked for any item on the panes by clicking the right mouse button. 1.3.1 IMPORT REGISTRY FILE This feature allows you to import any file using the Win95/NT 4.0 ASCII Registry Format (*.REG). This format is not well documented (even on the Windows platform) but has the basic form: REGEDIT4 (Format specified at the top of the file) [KEY] Example:[HKEY_LOCAL_MACHINE\ Software\LOTUS\123\97.0\CONFIGCACHE] [BINARYVALUE] Example:DATE=hex:80,ac,95,5f,d7,02,bc [DWORDVALUE] Example:TOOLCOUNT=dword:00000027 [STRINGVALUE] Example:PATH="L123R6.CFG" Note: Separate keys with a newline [NEXTKEY] [VALUE] [VALUE] This works equally well for OS/2 Profiles where the [KEY] is: [HINI_SYSTEM_PROFILE\ApplicationName], [HINI_USER_PROFILE\ApplicationName], or ["X:\SOME\FILE\PATH\PROFILE.INI"\ApplicationName] The Profile Keys are done exactly the same as for Win Registry Values and the Profile Data is the Registry Value data. The Import Registry File function will create all necessary keys, values, and data for both Registry and Profile imports. In addition, this function can create OS/2 Profile files on the fly from an ASCII *.REG file. Command Support - REGEDIT2 2 July 10, 1998 - Warp Registry Editor 1.3.2 EXPORT REGISTRY FILE This feature allows you to export any [KEY] and its subkeys and data to a file of your choosing. You can back up the entire Win Registry and/or OS/2 System and User Profiles using this feature and then restore them at a later date by importing the file (of course take care!). It is most useful for QE/Testing purposes when you need to either wipe out your registry or you are trying to support multiple versions of the products in several different directories. By selectively exporting/importing the Registry Configurations, you can switch between multiple versions. 1.3.3 OPEN PROFILE This feature allow you to open any OS/2 Profile File (*.INI) and view/edit its contents. It is also useful for creating NEW Profile files and then adding information to those files using the editor features. 1.3.4 CLOSE PROFILE This feature allows you to close any OS/2 Profile File that you previously opened using Open Profile 1.3.5 PRINT This feature allows you to print to your favorite printer the Keys, Subkeys, Values, and Data stored in your Win Registry or OS/2 Profile Files. The format of the print is similar to the format of the Win Registry File. 1.3.6 EDIT NEW KEY This feature allows you to add a subkey to an existing Win Registry Key, or allows you to add an Application or Application Key to an OS/2 Profile. 1.3.7 EDIT NEW STRING, BINARY, DWORD VALUE This feature allows you to add a new Value of the selected data type to an existing Registry Key. In Win95/NT, every Registry Key has at least one value called "Default" which is a String Data type. When a user adds a Value to a key, they must identify its data type. The user interface Command Support - REGEDIT2 3 July 10, 1998 - Warp Registry Editor supports one of three data types, a String (defined as a NULL terminated ASCII value), a DWORD (defined as a 4 byte unsigned long value), and HEX (defined as any sequence of binary bytes of arbitrary length). The OS/2 Profile does not support data types so the Editor uses the above definitions to determine the type of data stored in a Profile Key and presents it as such to the user. This is done to be consistent with the UI. 1.3.8 DELETE This feature allow you to delete a Registry Key and it's subkeys or a Registry Key Value. 1.3.9 FIND This feature allows you to search through any combination of Keys, Values, and Data for a search string you designate. In the case of binary data, all values are converted to byte hex numbers separated by commas during the search (similar to the *.REG format). For DWORD's, the value being searched is converted to an unsigned long value before the match is attempted. 1.3.10 FIND NEXT This feature allows you to continue a search that has stop on a previously found value. 1.3.11 VIEW STATUS BAR Enables or disables the status bar at the bottom of the editor. This status bar shows the current Full Key name being viewed. 1.3.12 VIEW SPLIT VERTICAL/HORIZONTAL Changes the orientation of the registry editor from Side by Side (Keys on left, Values on right) to Top and Bottom (Keys on top, Values on bottom). Command Support - REGEDIT2 4 July 10, 1998 - Warp Registry Editor 1.3.13 REFRESH Refresh places the editor back to the top of the Key hierarchy and dumps all stored data. This is necessary if values in the Registry have been modified by an external source or by the process of importing a file. This insures that Keys, Values, and Data are re-read from the registry. 1.3.14 HELP A help topics feature is provided. 1.3.15 PROGRAM INFORMATION Provides an about dialog information box. Command Support - REGEDIT2 5