The bpcatlist command queries the catalog data. Then, bpcatlist lists the portions of the catalog that are based on selected parameters. For example, date, client, policy, schedule name, backup ID, the age of the backup image, or the date range of the backup image. bpcatlist outputs the formatted image summary information of matched images to standard output.
The other catalog archiving commands, bpcatarc, bpcatrm, and bpcatres, all depend on input from bpcatlist by a piped command.
For example, to archive (backup and delete) all of the .f files that were created before January 1, 2010, the following would be entered:
Install_path\VERITAS\NetBackup\bin\admincmd\bpcatlist -client all -before Jan 1 2010 | bpcatarc | bpcatrm
bpcatlist is also used to provide status information.
For each catalog, it lists the following information:
Catalog archive ID (catarcid). After one .f file is successfully backed up, a catalog archive ID is entered into the catarcid field in the image file. This field is zero if the image was never archived.
Archived status (S), indicating if the catalog was not archived (1) or was archived (2)
Compressed status (C), indicating if the catalog is not compressed (0) or compressed (1)
The following is an example of the bpcatlist output, showing all of the backups for client alpha since October 23:
# bpcatlist -client alpha -since Oct 23 Backupid Backup Date ...Catarcid S C Files file alpha_0972380832 Oct 24 10:47:12 2009 ... 973187218 1 0 alpha_0972380832_UBAK.f alpha_0972336776 Oct 23 22:32:56 2009 ... 973187218 1 0 alpha_0972336776_FULL.f alpha_0972327197 Oct 23 19:53:17 2009 ... 973187218 1 0 alpha_0972327197_UBAK.f