The CATALOG Procedure

PROC CATALOG Statement

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

Task		Option
Restrict processing to one entry type		ENTRYTYPE=
Delete all catalog entries		KILL
Force certain statements to execute on a catalog opened by another resource environment		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
	Displaying Contents, Changing Names, and Changing a Description

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.
Featured in:	Using the FORCE Option with the KILL Option

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 library. You must use another method, such as PROC DATASETS or the DIR window to delete an empty SAS catalog.
Featured in:	Using the FORCE Option with the KILL Option

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.

Top of Page