lssection

Purpose

Use the lssection command to list backup sections matching the criteria selected on the command line. A backup section is the portion of a backup image that occupies one physical volume. Oracle Secure Backup obtains backup section data from the backup sections catalog.

See Also:

"Section Commands" for related commands

Prerequisites

You must have the right to query and display information about devices to use the lssection command.

Syntax

lssection::=

lsse•ction [ --long/-l | --short/-s ] [ --noheader/-H ] [ --incomplete/-i ]
[ --oid/-o oid-list ]... [ { { --vid/-v vid-list } | { --void/-V oid-list } }
[ --file/-f filenumber-list ]... ]

Semantics

--long/-l: Displays section data in long form.
--short/-s: Displays only the object ID of each backup section record selected.
--noheader/-H: Displays data without column headings.
--incomplete/-i: Displays section information even if the related volume data is missing from the backup sections catalog.
--oid oid-list: Selects backup sections with the object identifiers matching those in oid-list. Refer to "oid-list" for a description of the oid-list placeholder.
--vid vid-list: Selects backup sections contained on the volumes whose IDs are supplied in vid-list. A vid-list is one or more vid values separated by commas. Refer to"vid" for a description of the vid placeholder.
--void void-list: Selects backup sections contained on the volumes whose volume object identifiers are supplied in the list. The void-list placeholder represents an oid-list of volume IDs. Refer to "oid-list" for a description of the oid-list placeholder.
--file/-f filenumber-list: Selects only those backup sections having the file numbers specified the list. Refer to "filenumber-list" for a description of the filenumber-list placeholder.

Output

Table 2-17 describes the output of the lssection command.

Table 2-17 lssection Output

Column	Indicates
Backup section OID #	Catalog identifier for the backup section
Containing volume	Volume identifier of the tape media where the backup section resides
Containing volume OID	Catalog identifier for the volume
File	File number; identifies which numbered backup the section occupies on a tape containing multiple backups
Section	For a backup that spans multiple tapes; identifies which tape this is in the sequence
Backup level	Level of backup to be performed; setting is `full`, `1` to `10`, `incremental`, or `offsite`
Client	Name of Oracle Secure Backup client being backed up
Created	Date and time the backup section was created
Attributes	Information about the volume expiration

Example

Example 2-73 displays the object identifiers of all backup sections in the backup sections catalog. The lssection command then displays data for section 108 in the default standard format to determine which volume it is on. The command then displays all backup sections on this volume in long format.

Example 2-73 Listing Backup Sections

ob> lssection --short
   BSOID
     100
     105
     106
     107
     108
ob> lssection --oid 108
   BSOID  Volume           File Sect  Level  Client     Created      Attributes
     108  VOL000002           2 1         0  brhost2    04/19.11:52  never expires
ob> lssection --vid VOL000002 --long
Backup section OID:    105
    Containing volume:      VOL000002
    Containing volume OID:  111
    File:                   1
    Section:                1
    Backup level:           0
    Client:                 brhost2
    Created:                2005/04/19.11:36
    Attributes:             never expires
Backup section OID:    108
    Containing volume:      VOL000002
    Containing volume OID:  111
    File:                   2
    Section:                1
    Backup level:           0
    Client:                 brhost2
    Created:                2005/04/19.11:52
    Attributes:             never expires