1 DELETE 2 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. 3 Qualifiers /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. /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 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. 3 Qualifiers /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. /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 Example REG> DELETE VALUE HKEY_USERS\GUEST PASSWORD Deletes the PASSWORD value from the GUEST key. 2 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 Qualifiers /LOG /LOG /NOLOG (default) Displays the names of the subkeys of the top level key as they are deleted. /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. /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 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.