CATALOG Procedure

PROC CATALOG Statement

Copies entries from one SAS catalog to another.

Syntax

Required Argument

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.

Optional Arguments

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.
Interactions: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.

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.
FORCE
forces statements to execute on a catalog that is opened by another resource environment.
Some CATALOG statements require exclusive access to the catalog that they operate on if the statement can radically change the contents of a catalog. If exclusive access cannot be obtained, then the action fails. Here are the statements and the catalogs that are affected by FORCE:
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.
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.
Interactions:The KILL option deletes all catalog entries even when ENTRYTYPE= is specified.

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 library. You must use another method, such as PROC DATASETS or the DIR window to delete an empty SAS catalog.