Chapter Contents

Previous

Next
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


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

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

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.