The REGISTRY Procedure

PROC REGISTRY Statement

PROC REGISTRY <option(s)>;

To do this Use this statement

Erase the contents of the SASUSER registry CLEARSASUSER

Compare the contents of a registry to a file COMPARETO

Enable registry debugging DEBUGON

Disable registry debugging DEBUGOFF

Write the contents of a registry to the specified file EXPORT=

Provide additional information in the SAS log about the results of the IMPORT= and the UNINSTALL options FULLSTATUS

Import the specified file to a registry IMPORT=

Write the contents of the entire registry to the SAS log LIST

Write the contents of the SASHELP portion of the registry to the SAS log LISTHELP

Write the contents of the SASUSER portion of the registry to the SAS log LISTUSER

Start exporting or writing the contents of a registry at the specified key STARTAT=

Delete from the specified registry all the keys and values that are in the specified file UNINSTALL

Perform the specified operation on the SASHELP portion of the SAS Registry USESASHELP

To do this	Use this statement
Erase the contents of the SASUSER registry	CLEARSASUSER
Compare the contents of a registry to a file	COMPARETO
Enable registry debugging	DEBUGON
Disable registry debugging	DEBUGOFF
Write the contents of a registry to the specified file	EXPORT=
Provide additional information in the SAS log about the results of the IMPORT= and the UNINSTALL options	FULLSTATUS
Import the specified file to a registry	IMPORT=
Write the contents of the entire registry to the SAS log	LIST
Write the contents of the SASHELP portion of the registry to the SAS log	LISTHELP
Write the contents of the SASUSER portion of the registry to the SAS log	LISTUSER
Start exporting or writing the contents of a registry at the specified key	STARTAT=
Delete from the specified registry all the keys and values that are in the specified file	UNINSTALL
Perform the specified operation on the SASHELP portion of the SAS Registry	USESASHELP

Options

CLEARSASUSER

erases the content of the SASUSER portion of the SAS Registry.

COMPARETO=file-specification

compares the contents of a file to a registry. It returns information about keys and values that it finds in the file that are not in the registry. It reports as differences

keys that are defined in the external file but not in the registry
value names for a given key that are in the external file but not in the registry
differences in the content of like-named values in like-named keys.

COMPARETO= does not report as differences any keys and values that are in the registry but not in the file because the registry could easily be composed of pieces from many different files.

file-specification is one of the following:

'external-file': is the name of an external file that contains the registry information.
fileref: is a fileref that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information on the FILENAME statement, see the section on statements in SAS Language Reference: Dictionary.)

Interaction:	By default, PROC REGISTRY compares *file-specification* to the SASUSER portion of the registry. Use USESASHELP to compare *file-specification* to the SASHELP portion of the registry.
See also:	For information on how to structure a file that contains registry information, see Creating Registry Files .

DEBUGON

enables registry debugging.

DEBUGOFF

disables registry debugging.

EXPORT=file-specification

writes the contents of a registry to the specified file, where

file-specification is one of the following:

'external-file': is the name of an external file that contains the registry information.
fileref: is a fileref that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information on the FILENAME statement, see the section on statements in SAS Language Reference: Dictionary.)

If file-specification already exists, PROC REGISTRY overwrites it. Otherwise, PROC REGISTRY creates the file.

Interaction: By default, EXPORT= writes the SASUSER portion of the registry to the specified file. Use USESASHELP to write the SASHELP portion of the registry.
Interaction: Use the STARTAT= option to export a single key and all of its subkeys.

FULLSTATUS

provides additional information in the SAS log about the results of the IMPORT= and the UNINSTALL options.

IMPORT=file-specification

specifies the file to import into the SAS Registry. PROC REGISTRY does not overwrite the existing registry. Instead, it updates the existing registry with the contents of the specified file.

file-specification is one of the following:

'external-file': is the name of an external file that contains the registry information.
fileref: is a fileref that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information on the FILENAME statement, see the section on statements in SAS Language Reference: Dictionary.)

Interaction:	By default, IMPORT= imports the file to the SASUSER portion of the SAS registry. Use USESASHELP to import the file to the SASHELP portion of the registry. You must have write permission to SASHELP to use USESASHELP.
Interaction:	Use FULLSTATUS to obtain additional information in the SAS log as you import a file.
See also:	For information on how to structure a file that contains registry information, see Creating Registry Files .

LIST

writes the contents of the entire SAS Registry to the SAS log.

Interaction:

Use the STARTAT= option to write a single key and all of its subkeys.

LISTHELP

writes the contents of the SASHELP portion of the registry to the SAS log.

Interaction:

Use the STARTAT= option to write a single key and all of its subkeys.

LISTUSER

writes the contents of the SASUSER portion of the registry to the SAS log.

Interaction:

Use the STARTAT= option to write a single key and all of its subkeys.

STARTAT='key-name'

exports or writes the contents of a single key and all of its subkeys.

Interaction:

USE STARTAT= with the EXPORT=, LIST, LISTHELP, or LISTUSER option.

UNINSTALL=file-specification

deletes from the specified registry all the keys and values that are in the specified file.

file-specification is one of the following:

'external-file': is the name of an external file that contains the keys and values to delete.
fileref: is a fileref that has been assigned to an external file. Use the FILENAME statement to assign a fileref. (For information on the FILENAME statement, see the section on statements in SAS Language Reference: Dictionary.)

Interaction:	By default, UNINSTALL deletes the keys and values from the SASUSER portion of the SAS registry. Use USESASHELP to delete the keys and values from the SASHELP portion of the registry. You must have write permission to SASHELP to use this option.
Interaction:	Use FULLSTATUS to obtain additional information in the SAS log as you uninstall a registry.
See also:	For information on how to structure a file that contains registry information, see Creating Registry Files .

USESASHELP

performs the specified operation on the SASHELP portion of the SAS Registry.

Interaction:

Use USESASHELP with the IMPORT=, EXPORT=, COMPARETO, or UNINSTALL option. To use USESASHELP with IMPORT= or UNINSTALL, you must have write permission to SASHELP.

Chapter Contents
Previous
Next
Top of Page

Interaction:	By default, EXPORT= writes the SASUSER portion of the registry to the specified file. Use USESASHELP to write the SASHELP portion of the registry.
Interaction:	Use the STARTAT= option to export a single key and all of its subkeys.