Chapter Contents
Previous
Next
The CATALOG Procedure

PROC CATALOG Statement

PROC CATALOG CATALOG=<libref.>catalog <ENTRYTYPE=etype> <FORCE> <KILL>;

To do this Use this option
Restrict processing to one entry type ENTRYTYPE=
Delete all catalog entries KILL
Force certain statements to execute on a catalog opened by another process FORCE

Required Arguments

CATALOG=<libref.>catalog
specifies the SAS catalog to process.
Alias: CAT=, C=
Default: If ENTRYTYPE= is not specified, PROC
CATALOG processes all entries in the catalog.

Options

ENTRYTYPE=etype
restricts processing of the current PROC CATALOG step to one entry type.
Alias: ET=
Default: If you omit ENTRYTYPE=, PROC CATALOG processes all entries in a catalog.
Interaction: The specified entry type applies to any one-level entry names used in a subordinate statement. You cannot override this specification in a subordinate statement.
Interaction: ENTRYTYPE= does not restrict the effects of the KILL option.
Tip: In order to process multiple entry types in a single PROC CATALOG step, use ENTRYTYPE= in a subordinate statement, not in the PROC CATALOG statement.
See also: Specifying an Entry Type .
Featured in: Copying, Deleting, and Moving Catalog Entries from Multiple Catalogs and Displaying Contents, Changing Names, and Changing a Description

FORCE
forces statements to execute on a catalog opened by another process.

Some CATALOG statements require exclusive access to the catalog they operate on if the statement can radically change the contents of a catalog. If exclusive access cannot be obtained, the action fails. The statements and the catalogs that are affected are
KILL affects the specified catalog
COPY affects the OUT= catalog
COPY MOVE affects the IN= and the OUT= catalogs
SAVE affects the specified catalog.
Tip: Use FORCE to execute the statement, even if exclusive access cannot be obtained.

KILL
deletes all entries in a SAS catalog.
Interaction: The KILL option deletes all catalog entries even when ENTRYTYPE= is specified.
Interaction: The SAVE statement has no effect because the KILL option deletes all entries in a SAS catalog before any other statements are processed.
Tip: KILL deletes all entries but does not remove an empty catalog from the SAS data library. You must use another method, such as PROC DATASETS or the DIR window to delete an empty SAS catalog.
CAUTION:
Do not attempt to limit the effects of the KILL option. This option deletes all entries in a SAS catalog before any option or other statement takes effect.   [cautionend]


Chapter Contents
Previous
Next
Top of Page

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