<        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

