home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 36 Tips / 36-Tips.zip / registry.rme < prev    next >
Text File  |  1998-04-29  |  12KB  |  382 lines
  1. <        Warp Registry Editor - REGEDIT2.EXE
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.         
  18.  
  19.         
  20.         
  21.  
  22.  
  23.  
  24.         November 21, 1997
  25.  
  26.         
  27.         
  28.         
  29.         
  30.         OS/2 Fix Distribution
  31.         Personal System Products
  32.         Austin, Tx
  33.         
  34.         
  35.         (c) Copyright International Business Machines Corporation, 1994, 1996.
  36.         All rights Reserved.
  37.  
  38.         November 21, 1997 - Warp Registry Editor
  39.  
  40.  
  41.  
  42.                       November 21, 1997 - Warp Registry Editor
  43.  
  44.         CONTENTS
  45.  
  46.  
  47.           1.0 Command Support - REGEDIT2  . . . . . . . . . . . . . . . . 1
  48.           1.1 Functional Specification  . . . . . . . . . . . . . . . . . 1
  49.           1.2 Features  . . . . . . . . . . . . . . . . . . . . . . . . . 1
  50.             1.2.1 Editor Arrangement  . . . . . . . . . . . . . . . . . . 1
  51.             1.2.2 Data Editing  . . . . . . . . . . . . . . . . . . . . . 1
  52.           1.3 Menus   . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  53.             1.3.1 Import Registry File  . . . . . . . . . . . . . . . . . 2
  54.             1.3.2 Export Registry File  . . . . . . . . . . . . . . . . . 3
  55.             1.3.3 Open Profile  . . . . . . . . . . . . . . . . . . . . . 3
  56.             1.3.4 Close Profile   . . . . . . . . . . . . . . . . . . . . 3
  57.             1.3.5 Print   . . . . . . . . . . . . . . . . . . . . . . . . 3
  58.             1.3.6 Edit New Key  . . . . . . . . . . . . . . . . . . . . . 3
  59.             1.3.7 Edit New String, Binary, DWORD Value  . . . . . . . . . 4
  60.             1.3.8 Delete  . . . . . . . . . . . . . . . . . . . . . . . . 4
  61.             1.3.9 Find  . . . . . . . . . . . . . . . . . . . . . . . . . 4
  62.             1.3.10 Find Next  . . . . . . . . . . . . . . . . . . . . . . 4
  63.             1.3.11 View Status Bar  . . . . . . . . . . . . . . . . . . . 4
  64.             1.3.12 View Split Vertical/Horizontal   . . . . . . . . . . . 5
  65.             1.3.13 Refresh  . . . . . . . . . . . . . . . . . . . . . . . 5
  66.             1.3.14 Help   . . . . . . . . . . . . . . . . . . . . . . . . 5
  67.             1.3.15 Program Information  . . . . . . . . . . . . . . . . . 5
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.         
  97.                                                                Contents  ii
  98.  
  99.                       November 21, 1997 - Warp Registry Editor
  100.  
  101.         1.0 COMMAND SUPPORT - REGEDIT2
  102.  
  103.  
  104.  
  105.         1.1 FUNCTIONAL SPECIFICATION
  106.  
  107.         The Warp Registry Editor (REGEDIT2.EXE) was designed to be
  108.         functionally equivalent to the Registry Editor found in Win95 and
  109.         NT4.0. In addition to supporting the Open32 Registry Keys, the Warp
  110.         Registry Editor also supports the standard OS/2 Profile keys and
  111.         files (*.INI).  This was done in a manner as to appear "seamless"
  112.         to the user providing a single user interface that combines both
  113.         universes on the Warp platform.
  114.  
  115.  
  116.  
  117.         1.2 FEATURES
  118.  
  119.  
  120.  
  121.  
  122.         1.2.1 EDITOR ARRANGEMENT
  123.  
  124.         The registry editor consists of two panes separated by a split bar.
  125.         The pane on the left holds the Registry Keys and Subkeys while the
  126.         pane on the right holds the Key Values and Data.  When a key is
  127.         selected in the left pane, the Keys Values and Data
  128.         areautomatically updated in the right pane.  The left pane is setup
  129.         in the traditional OS/2 Folder Tree View while the right pane uses
  130.         the OS/2 Folder Details view.  The split bar can be manipulated by
  131.         clicking on the bar with the left mouse button and adjusting it
  132.         left or right.  The columns in the right pane automatically size
  133.         themselves to hold the data.  If the data is too large to be
  134.         completely viewed in the editor, it is truncated.  This is
  135.         indicated by an ellipse (...) at the end of the data.  To view more
  136.         data either resize the editor or edit the field.
  137.  
  138.  
  139.  
  140.         1.2.2 DATA EDITING
  141.  
  142.         The editor allows you to edit the values of Keys, Values, and Data.
  143.         Key Names are always edited in place.  The edit feature can be
  144.         activated by selecting the key using the mouse or keyboard arrow
  145.         keys and then pressing Enter on the keyboard, double clicking with
  146.         the left mouse button, or holding the ALT key and clicking with the
  147.         left mouse button.  Value Names are also edited in place.  This
  148.         edit feature can be activated by selecting the value using the
  149.         mouse or keyboard arrow keys and then holding the ALT key and
  150.         clicking with the left mouse button in the Name Column to .....
  151.         The Value Data is edited using dialog boxes or, in the case of
  152.  
  153.         
  154.                                               Command Support - REGEDIT2  1
  155.  
  156.                       November 21, 1997 - Warp Registry Editor
  157.  
  158.         String Data only, in place editing.  The Data edit feature can be
  159.         activated by selecting the Value Data using the mouse or keyboard
  160.         arrow keys and pressing Enter on the keyboard, double clicking with
  161.         the mouse on the Value (in either Name or Data columns), or by
  162.         holding the ALT key and pressing the left mouse button (activates
  163.         in place editing for String Data) in the Data Column.  There are
  164.         separate edit dialogs for String, DWORD, and Binary data.
  165.  
  166.  
  167.  
  168.         1.3 MENUS
  169.  
  170.         The menu items vary with the context of the Key, Value items
  171.         selected and which of the two panes have focus.  In addition, a
  172.         popup menu can be invoked for any item on the panes by clicking the
  173.         right mouse button.
  174.  
  175.  
  176.  
  177.         1.3.1 IMPORT REGISTRY FILE
  178.  
  179.         This feature allows you to import any file using the Win95/NT 4.0
  180.         ASCII Registry Format (*.REG).  This format is not well documented
  181.         (even on the Windows platform) but has the basic form:
  182.  
  183.         
  184.         REGEDIT4       (Format specified at the top of the file)
  185.         
  186.         [KEY]          Example:[HKEY_LOCAL_MACHINE\
  187.                        Software\LOTUS\123\97.0\CONFIGCACHE]
  188.         [BINARYVALUE]  Example:DATE=hex:80,ac,95,5f,d7,02,bc
  189.         [DWORDVALUE]   Example:TOOLCOUNT=dword:00000027
  190.         [STRINGVALUE]  Example:PATH="L123R6.CFG"
  191.         Note:          Separate keys with a newline
  192.         [NEXTKEY]
  193.         [VALUE]
  194.         [VALUE]
  195.  
  196.         This works equally well for OS/2 Profiles where the [KEY] is:
  197.  
  198.         [HINI_SYSTEM_PROFILE\ApplicationName],
  199.         [HINI_USER_PROFILE\ApplicationName], or
  200.         ["X:\SOME\FILE\PATH\PROFILE.INI"\ApplicationName]
  201.  
  202.         The Profile Keys are done exactly the same as for Win Registry
  203.         Values and the Profile Data is the Registry Value data.
  204.  
  205.         The Import Registry File function will create all necessary keys,
  206.         values, and data for both Registry and Profile imports.  In
  207.         addition, this function can create OS/2 Profile files on the fly
  208.         from an ASCII *.REG file.
  209.  
  210.         
  211.                                               Command Support - REGEDIT2  2
  212.  
  213.                       November 21, 1997 - Warp Registry Editor
  214.  
  215.  
  216.  
  217.  
  218.         1.3.2 EXPORT REGISTRY FILE
  219.  
  220.         This feature allows you to export any [KEY] and its subkeys and
  221.         data to a file of your choosing.  You can back up the entire Win
  222.         Registry and/or OS/2 System and User Profiles using this feature
  223.         and then restore them at a later date by importing the file (of
  224.         course take care!).  It is most useful for QE/Testing purposes when
  225.         you need to either wipe out your registry or you are trying to
  226.         support multiple versions of the products in several different
  227.         directories.  By selectively exporting/importing the Registry
  228.         Configurations, you can switch between multiple versions.
  229.  
  230.  
  231.  
  232.         1.3.3 OPEN PROFILE
  233.  
  234.         This feature allow you to open any OS/2 Profile File (*.INI) and
  235.         view/edit its contents.  It is also useful for creating NEW Profile
  236.         files and then adding information to those files using the editor
  237.         features.
  238.  
  239.  
  240.  
  241.         1.3.4 CLOSE PROFILE
  242.  
  243.         This feature allows you to close any OS/2 Profile File that you
  244.         previously opened using Open Profile
  245.  
  246.  
  247.  
  248.         1.3.5 PRINT
  249.  
  250.         This feature allows you to print to your favorite printer the Keys,
  251.         Subkeys, Values, and Data stored in your Win Registry or OS/2
  252.         Profile Files.  The format of the print is similar to the format of
  253.         the Win Registry File.
  254.  
  255.  
  256.  
  257.         1.3.6 EDIT NEW KEY
  258.  
  259.         This feature allows you to add a subkey to an existing Win Registry
  260.         Key, or allows you to add an Application or Application Key to an
  261.         OS/2 Profile.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.         
  268.                                               Command Support - REGEDIT2  3
  269.  
  270.                       November 21, 1997 - Warp Registry Editor
  271.  
  272.         1.3.7 EDIT NEW STRING, BINARY, DWORD VALUE
  273.  
  274.         This feature allows you to add a new Value of the selected data
  275.         type to an existing Registry Key.  In Win95/NT, every Registry Key
  276.         has at least one value called "Default" which is a String Data
  277.         type.  When a user adds a Value to a key, they must identify its
  278.         data type.  The user interface supports one of three data types, a
  279.         String (defined as a NULL terminated ASCII value), a DWORD (defined
  280.         as a 4 byte unsigned long value), and HEX (defined as any sequence
  281.         of binary bytes of arbitrary length).  The OS/2 Profile does not
  282.         support data types so the Editor uses the above definitions to
  283.         determine the type of data stored in a Profile Key and presents it
  284.         as such to the user.  This is done to be consistent with the UI.
  285.  
  286.  
  287.  
  288.         1.3.8 DELETE
  289.  
  290.         This feature allow you to delete a Registry Key and it's subkeys or
  291.         a Registry Key Value.
  292.  
  293.  
  294.  
  295.         1.3.9 FIND
  296.  
  297.         This feature allows you to search through any combination of Keys,
  298.         Values, and Data for a search string you designate.  In the case of
  299.         binary data, all values are converted to byte hex numbers separated
  300.         by commas during the search (similar to the *.REG format).  For
  301.         DWORD's, the value being searched is converted to an unsigned long
  302.         value before the match is attempted.
  303.  
  304.  
  305.  
  306.         1.3.10 FIND NEXT
  307.  
  308.         This feature allows you to continue a search that has stop on a
  309.         previously found value.
  310.  
  311.  
  312.  
  313.         1.3.11 VIEW STATUS BAR
  314.  
  315.         Enables or disables the status bar at the bottom of the editor.
  316.         This status bar shows the current Full Key name being viewed.
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.         
  325.                                               Command Support - REGEDIT2  4
  326.  
  327.                       November 21, 1997 - Warp Registry Editor
  328.  
  329.         1.3.12 VIEW SPLIT VERTICAL/HORIZONTAL
  330.  
  331.         Changes the orientation of the registry editor from Side by Side
  332.         (Keys on left, Values on right) to Top and Bottom (Keys on top,
  333.         Values on bottom).
  334.  
  335.  
  336.  
  337.         1.3.13 REFRESH
  338.  
  339.         Refresh places the editor back to the top of the Key hierarchy and
  340.         dumps all stored data.  This is necessary if values in the Registry
  341.         have been modified by an external source or by the process of
  342.         importing a file.  This insures that Keys, Values, and Data are
  343.         re-read from the registry.
  344.  
  345.  
  346.  
  347.         1.3.14 HELP
  348.  
  349.         A help topics feature is provided.
  350.  
  351.  
  352.  
  353.         1.3.15 PROGRAM INFORMATION
  354.  
  355.         Provides an about dialog information box.
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.         
  382.                                               Command Support - REGEDIT2  5