bpcatlist

bpcatlist — list selected parts of NetBackup catalog

SYNOPSIS

<admin_dir_path>bpcatlist [-server server_name] [-client client_name] [-since [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]] [-before [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]] [-date ctime] [-policy policy_name] [-sched sched_name] [-id backup_id] [-catarc catarc_id] [-version] [-online | -offline]

On Windows systems, <admin_dir_path> is <install_path>\NetBackup\bin\admincmd\

DESCRIPTION

bpcatlist is the starting point for all catalog archiving operations. Use bpcatlist to select the specific parts of the NetBackup catalog with which you want to work. All files-file (image .f files), the largest files in a NetBackup catalog, that are selected for bpcatarc, bpcatres, or bpcatrm, are first selected with bpcatlist. The output of bpcatlist is piped to the action you want to perform.

OPTIONS

-server server_name

Indicates the name of the NetBackup server. Default: server_name is the first server name listed in the bp.conf file.

-client client_name

Creates a list of backup images for client_name. Default: client_name is CLIENT_NAME in bp.conf or the current host name.

To select all clients, use -client all.

-since [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]]

Lists backup images since the specified time that is expressed in ctime (for example, Fri Oct 12 00:00:00 2009).

If no year is specified, bpcatlist uses the current year by default.

The following command lists all images after December 31, 2009:

bpcatlist -since 2009

Additional examples are found in the Examples section.

-before [ctime | [-since-days nnn | -since-weeks nnn | -since-months nnn | -before-days nnn | -before-weeks nnn | -before-months nnn]]

Lists backup images before the specified time that is expressed in ctime (for example, Fri Oct 12 00:00:00 2009). If no year is specified, bpcatlist uses the current year by default.

-date ctime

Lists of backup images for the specified date that is expressed in ctime (for example, Fri Oct 12 00:00:00 2009). If no date is specified, bpcatlist uses the current date by default.

Additional examples are found in the Examples section.

-catarc catarc_id

Lists the files-file that were archived with the specified catarc_id. For example:

-catarc 1022754972
-policy policy_name

Lists the backups that the indicated policy_name for the specified client creates.

-sched sched_name

Lists the backups that are created following schedule_name for the specified client.

-id backup_id

Creates a list for the specified backup_id.

-online

Lists only files-file that are online.

-offline

Lists only files-file that are offline.

-version

Displays the bpcatlist version and exit.

EXAMPLES

Displayed dates must be specified in ctime (for example, Fri Sep 13 00:00:00 2007) date format. Displayed dates may be cut and specified without modification.

To list a backup for a specific date and time, specify:

	bpcatlist -date Mon Sep 17 14:16:28 2007

(When no year is specified, the current year is used by default.)

To list all backups between two dates of the current year, specify the following:

   bpcatlist -before Mon Sep 10 00:00:00 2007 -since Fri Oct 
	4 00:00:00 2007

To list the backups that are two to three months old, specify the following:

   bpcatlist -before-months 2 -since-months 3

-since and -before use the following equivalent values:

	-since-days nnn
	-since-weeks nnn
	-since-months nnn
	-before-days nnn
	-before-weeks nnn
	-before-months nnn

For example, the setting -since-days 14 is equivalent to -since-weeks 2.

SEE ALSO

bpcatarc, bpcatres, bpcatrm