lsbackup

Purpose

Use the lsbackup command to list the backup requests that you created with the backup command. These requests are awaiting delivery to the scheduler.

The lsbackup command only lists backup requests that have not yet been sent to the scheduler by means of the --go option. For example, if you create a backup request, specify --go, and then execute lsbackup, obtool does not display the request.

See Also:

"Backup Commands" for related commands

Syntax

lsbackup::=

lsb•ackup [ --long/-l | --short/-s ] [ --noheader/-H ] [ backup-item ]...

Semantics

--long /-l: Displays data in long form, that is, describes all of the attributes for each job and labels them. Refer to Example 2-46 for the type of data included. By default this command displays a subset of attributes in tabular form.
--short /-s: Displays data in short form, that is, lists job IDs only.
--noheader/-H: Suppresses column headers when listing data.
backup-item ...: Specifies an identifier assigned by obtool to a backup created with the backup command. The identifier is a small integer number.

Output

Table 2-3 describes the output of the lsbackup command.

Table 2-3 lsbackup Output

Label	Indicates
Dataset	User-specified name of the dataset file used in the backup job
Media family	User-specified name of the media family used in the backup job
Backup level	Level of backup to be performed; setting is `full`, `1` to `10`, `incremental`, or `offsite`
Priority	Priority level of the backup job; set a number greater than `0`; `1` is the highest priority
Privileged op	Setting is `yes` or `no`
Eligible to run	Date and time at which the backup job can begin
Job expires	Date and time the backup job request expires
Restriction	Devices to which the backup job may be restricted

Example

Example 2-46 displays full details about pending backup jobs. The 1: at the beginning of the output is the backup item identifier.

Example 2-46 Listing a Backup in Long Form

ob> lsbackup --long
1:
    Dataset:                brhost2.ds
    Media family:           (null)
    Backup level:           full
    Priority:               10
    Privileged op:          yes
    Eligible to run:        2005/06/14.21:00:00
    Job expires:            2005/06/19.21:00:00
    Restriction:            any device