PC Online 1998 February/PCO_0298.ISO/filesbbs/os2/xrgm005.arj/XRGM005.ZIP/README.REG

Text File | 1997-12-15 | 11.3 KB | 439 lines

<
























































                                                                    Page  1
        Warp Registry Editor - REGEDIT2.EXE






















        November 13, 1997





        OS/2 Fix Distribution
        Personal System Products
        Austin, Tx


        (c) Copyright International Business Machines Corporation, 1994, 1996.
        All rights Reserved.

        November 13, 1997 - Warp Registry Editor



                      November 13, 1997 - 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  . . . . . . . . . 4
            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   . . . . . . . . . . . 5
            1.3.13 Refresh  . . . . . . . . . . . . . . . . . . . . . . . 5
            1.3.14 Help   . . . . . . . . . . . . . . . . . . . . . . . . 5
            1.3.15 Program Information  . . . . . . . . . . . . . . . . . 5





























                                                               Contents  ii


                      November 13, 1997 - 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


                                              Command Support - REGEDIT2  1


                      November 13, 1997 - Warp Registry Editor

        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 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


                      November 13, 1997 - 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.






                                              Command Support - REGEDIT2  3


                      November 13, 1997 - Warp Registry Editor

        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 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.








                                              Command Support - REGEDIT2  4


                      November 13, 1997 - Warp Registry Editor

        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).



        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