Library /sys$common/syshlp/REGCP$HELP.HLB  —  DELETE

1  –  KEY

    Removes a specified key from the OpenVMS Registry database. The
    system does not delete a key if the key has subkeys.  Use the
    DELETE TREE command if you wish to delete a key and all of its
    subkeys.

                              CAUTION

       Deleting a key results in symbolic links not being followed.
       This is because the system deletes the key you specify,
       even if it has symbolic links.

                               NOTE

       The OpenVMS Registry database predefined keys are reserved
       keys and cannot be deleted. These keys are HKEY_USER,
       HKEY_LOCAL_MACHINE, and HKEY_CLASSES_ROOT.

    This command requires the SYSPRV privilege or the REG$UPDATE
    rights identifier.

    Format:

      DELETE KEY  key-path key-name

    key-path

    Specifies the key path.

    key-name

    Specifies the name of the key to delete.

1.1  –  Qualifiers

1.1.1    /WAIT

    /WAIT=seconds (default = 90)
    /NOWAIT

    Specifies the maximum amount of time, in seconds, that you are
    willing to wait for command completion.  If the Registry server
    does not complete the request in the specified interval, REG$CP
    returns REG-F-NORESPONSE. The default interval is 90 seconds.
    /NOWAIT is equivalent to specifying /WAIT=0, but there may still
    be a short wait period.

1.1.2    /WRITEBEHIND

    /WRITEBEHIND
    /NOWRITEBEHIND (default)

    Specifies when the information can be written to disk.
    /WRITEBEHIND specifies that the information can be written to
    disk later. /NOWRITEBEHIND specifies write-through operation
    (that is, the information must be written to disk immediately).

1.2  –  Example

        REG> DELETE KEY HKEY_USERS\NODE GUEST

      Deletes the GUEST key from the OpenVMS Registry database.

2  –  VALUE

    Removes a value from a specified key.

                                 CAUTION

       Deleting a value results in symbolic links not being
       followed. This is because the system deletes the value
       you specify, even if it has symbolic links.

    This command requires the SYSPRV privilege or the REG$UPDATE
    rights identifier.

    Format:

      DELETE VALUE  key-name value-name

    key-name

    Specifies the key name whose value should be removed.

    value-name

    Specifies the value to remove.

2.1  –  Qualifiers

2.1.1    /WAIT

    /WAIT=seconds (default = 90)
    /NOWAIT

    Specifies the maximum amount of time, in seconds, that you are
    willing to wait for command completion.  If the Registry server
    does not complete the request in the specified interval, REG$CP
    returns REG-F-NORESPONSE. The default interval is 90 seconds.
    /NOWAIT is equivalent to specifying /WAIT=0, but there may still
    be a short wait period.

2.1.2    /WRITEBEHIND

    /WRITEBEHIND
    /NOWRITEBEHIND (default)

    Specifies when the information can be written to disk.
    /WRITEBEHIND specifies that the information can be written to
    disk later. /NOWRITEBEHIND specifies write-through operation
    (that is, the information must be written to disk immediately).

2.2  –  Example

        REG> DELETE VALUE HKEY_USERS\GUEST PASSWORD

      Deletes the PASSWORD value from the GUEST key.

3  –  TREE

    Removes the specified key and all of its subkeys from the OpenVMS
    Registry database.

                              CAUTION

       Deleting a key results in symbolic links not being followed.
       This is because the system deletes the key you specify,
       even if it has symbolic links.

                               NOTE

       The OpenVMS Registry database predefined keys are reserved
       keys and cannot be deleted. These keys are HKEY_USER,
       HKEY_LOCAL_MACHINE, and HKEY_CLASSES_ROOT.

    This command requires the SYSPRV privilege or the REG$UPDATE
    rights identifier.

    Format:

      DELETE TREE  key-path key-name

    key-path

    Specifies the key path.

    key-name

    Specifies the name of the top level key of the tree to be deleted.

3.1  –  Qualifiers

3.1.1    /LOG

    /LOG
    /NOLOG (default)

    Displays the names of the subkeys of the top level key as they
    are deleted.

3.1.2    /WAIT

    /WAIT=seconds (default = 90)
    /NOWAIT

    Specifies the maximum amount of time, in seconds, that you are
    willing to wait for command completion.  If the Registry server
    does not complete the request in the specified interval, REG$CP
    returns REG-F-NORESPONSE. The default interval is 90 seconds.
    /NOWAIT is equivalent to specifying /WAIT=0, but there may still
    be a short wait period.

3.1.3    /WRITEBEHIND

    /WRITEBEHIND
    /NOWRITEBEHIND (default)

    Specifies when the information can be written to disk.
    /WRITEBEHIND specifies that the information can be written to
    disk later. /NOWRITEBEHIND specifies write-through operation
    (that is, the information must be written to disk immediately).

3.2  –  Example

        REG> CREATE KEY HKEY_USERS\NODE\GUEST
        REG> CREATE KEY HKEY_USERS\NODE\GUEST\SUBKEY1
        REG> CREATE KEY HKEY_USERS\NODE\GUEST\SUBKEY2
        REG> CREATE KEY HKEY_USERS\NODE\GUEST\SUBKEY1\SUBKEY1_2
        REG> DELETE TREE HKEY_USERS\NODE GUEST

      Deletes the GUEST key and its subkeys SUBKEY1, SUBKEY2, and
      SUBKEY1\SUBKEY1_2 from the OpenVMS Registry database.
Close Help