System Programmer Reference › Commands › DISCARD Command

DISCARD Command

Authorization: SYSADMIN

To erase catalogs from the catalog minidisk, use the DISCARD command. DISCARD also removes any references to the erased files from the catalog index files.

When you discard a catalog, the DISCARD command also discards any dependent catalogs that an incremental backup creates. DISCARD erases these dependent catalogs regardless of their own defined auto-discard dates. For example, a catalog with an auto-discard period of 45 days that is based on a catalog with an auto-discard period of 30 days is discarded when the base catalog is discarded.

You cannot enter DISCARD while another catalog job or command (for example, CHECK, CONDENSE, or UPDATE) is executing.

This command has the following format:

DIScard dumpjob

Definitions

dumpjob

Discards a single catalog and any catalogs based on it, where dumpjob is the filename of the catalog's DUMPJOB file. (The filename is the number that this product assigns when the catalog is created.) Enter one to eight digits for dumpjob. To see the DUMPJOB filename, use the CHECK command.

DISCARD Screen Advantages

Using the Discard Catalogs system administrator screen to discard catalogs has the following advantages to using the DISCARD command:

• You do not have to use the CHECK command to see a specific catalog DUMPJOB number.
• CA VM:Backup displays all associated catalogs that will be discarded before the discard process actually occurs.

Note: For more information about this screen, see "Discarding Catalogs" in the Administration Guide.