Skip Headers

Oracle® Database Recovery Manager Reference
10g Release 1 (10.1)

Part Number B10770-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Feedback

Go to previous page
Previous
Go to current chapter
Up
Go to next page
Next
View PDF

LIST

Syntax

list::=

Text description of list.gif follows


Text description of list



listObjectSpec::=

Text description of listObjectSpec.gif follows


Text description of listObjectSpec



listBackupOption::=

Text description of listBackupOption.gif follows


Text description of listBackupOption

Purpose

To display information about backup sets, proxy copies, and image copies recorded in the repository. The LIST command displays the files against which you can run CROSSCHECK and DELETE commands. Use this command to list:

RMAN records the output to either standard output or the message log, but not to both at the same time. You can control how the output is organized (BY BACKUP or BY FILE) as well as the level of detail in the output (VERBOSE or SUMMARY).

See Also:

Oracle Database Backup and Recovery Basics to learn how to make lists and reports, and "cmdLine"

Restrictions and Usage Notes

Keywords and Parameters

list
Syntax Element Description

EXPIRED

Displays backup sets, proxy copies, and image copies marked in the repository as EXPIRED, that is, "not found."

To ensure that LIST EXPIRED shows up-to-date output, issue a CROSSCHECK command periodically. When you issue a CROSSCHECK command, RMAN searches on disk and tape for the backups and copies recorded in the repository. If it does not find them, then it updates their repository records to status EXPIRED.

RECOVERABLE

Specifies datafile backups or copies whose status in the repository is AVAILABLE and which can be used for restore and recovery in the target database's current incarnation. This list includes all backups and copies except the incremental backups that have no valid parent to which the incremental can be applied.

Specifies an end time, SCN, or log sequence number. See "untilClause".

recordSpec

Specifies the object or objects that you are listing. Refer to "recordSpec".

INCARNATION

Displays information about the incarnations of a database. Whenever you open a database with the RESETLOGS option, then you create a new incarnation of the database. So, if LIST INCARNATION displays n incarnations of a database, then you have reset the online logs for this database n-1 times.

The LIST output includes the primary keys of all database incarnation records for the specified database name (in the column "Inc Key," short for "incarnation key"). Use the key in a RESET DATABASE command to change the incarnation that RMAN considers to be current to a previous incarnation.

See Also: Table 2-19 for an explanation of the column headings of the LIST INCARNATION output table

OF DATABASE 'database_name'

Specifies the name of the database. If you do not specify the OF DATABASE option, then the command lists all databases registered in the recovery catalog.

maintQualifier

Restricts the range of the listing. Refer to "maintQualifier".

 

SCRIPT NAMES

Lists names of RMAN stored scripts in the currently connected recovery catalog, along with any descriptive comments.

Without ALL or GLOBAL options, lists local and global scripts that can be executed on the current target database. You must be connected to a target database and a recovery catalog to use this form of the command.

You must connect to a target database and a recovery catalog to list names for scripts defined for that target database.

ALL

RMAN lists all global and local scripts defined for all databases in the connected recovery catalog.

You must be connected to a recovery catalog to use LIST ALL SCRIPT NAMES, but you do not need to be connected to a target database.

GLOBAL

RMAN lists only global scripts defined in the connected recovery catalog.

You must be connected to a recovery catalog to use LIST GLOBAL SCRIPT NAMES, but you do not need to be connected to a target database.

listObjectSpec
Syntax Element Description

listObjectSpec

Specifies the type of object or objects that you are listing.

See Also: "recordSpec"

BACKUP

Displays information about BACKUP output: backup sets (including detail on backup pieces), proxy copies, and image copies.

BACKUPSET

Displays only information about backup sets, backup pieces, and proxy copies. The output displays a unique key for each. The LIST BACKUPSET command defaults to BY BACKUP.

By default, RMAN lists both usable and unusable backups, even those that cannot be restored, are expired or unavailable, or are incrementals that cannot be restored because their parent full backup or copy no longer exists. To see only backups that can be used for recovery, use the RECOVERABLE option.

See Also: "LIST Output" for an explanation of the column headings of the LIST output tables. Use the KEY column of the output to obtain the primary key usable in the CHANGE and DELETE commands.

COPY

Displays only information about datafile copies, archived redo logs, and image copies of archived redo logs. By default, LIST COPY displays copies of all database files and archived redo logs. Both usable and unusable image copies are included in the output, even those that cannot be restored or are expired or unavailable.

See Also: Table 2-16 and Table 2-18 for an explanation of the column headings of the LIST COPY output tables

Restricts the list of objects operated on to the object type specified in the listObjList clause. If you do not specify an object, then LIST defaults to OF DATABASE CONTROLFILE ARCHIVELOG ALL.

Note: The LIST BACKUP ... LIKE command is not valid. The only valid exception is LIST BACKUP OF ARCHIVELOG LIKE.

See Also: "listObjList"

Displays information about a range of archived redo logs.

listBackupOption
Syntax Element Description

listBackupOption

Specifies how you want the list backup sets.

See Also: "recordSpec"

BY BACKUP

Lists backup sets, then the contents of each backup set (pieces and files), and then proxy copies. This is the default option for LIST BACKUP.

If you specify the SUMMARY option, then this command is equivalent to LIST BACKUP SUMMARY.

VERBOSE

Gives detailed description of contents of each backup set (default).

SUMMARY

Gives a one-line summary for each datafile (when using BY FILE) or backup (when using BY BACKUP).

BY FILE

Lists a datafile, then its backup sets, and then proxy copies.

LIST Output

The information that appears in the output is shown in the following tables:

Examples

Listing Backups: Example

This example lists all backups in default verbose mode:

LIST BACKUP;

List of Backup Sets
===================

BS Key  Device Type Elapse Time Completion Time
------- ----------- ----------- ---------------
236     DISK        00:00:08    21-SEP-00      
        BP Key: 237   Status: AVAILABLE   Tag: TAG20011121T053733
        Piece Name: /oracle/oradata/09c5unih_1_1

  List of Archived Logs in backup set 236
  Thrd Seq     Low SCN    Low Time  Next SCN   Next Time
  ---- ------- ---------- --------- ---------- ---------
  1    141     49173      21-SEP-01 49784      21-SEP-01
  1    142     49784      21-SEP-01 50331      21-SEP-01

BS Key  Type LV Size       Device Type Elapse Time Completion Time
------- ---- -- ---------- ----------- ----------- ---------------
244     Full    61M        DISK        00:00:18    21-SEP-01      
        BP Key: 245   Status: AVAILABLE   Tag: TAG20011121T053816
        Piece Name: /oracle/oradata/0ac5unj5_1_1
  Controlfile Included: Ckp SCN: 51554        Ckp time: 21-SEP-01
  SPFILE Included: Modification time: 21-SEP-01
  List of Datafiles in backup set 244
  File LV Type Ckp SCN    Ckp Time  Name
  ---- -- ---- ---------- --------- ----
  1       Full 51555      21-SEP-01 /oracle/oradata/trgt/system01.dbf
  2       Full 51555      21-SEP-01 /oracle/oradata/trgt/undotbs_01.dbf

List of Proxy Copies
====================

PC Key  File Status      Completion time     Ckp SCN    Ckp time
------- ---- ----------- ------------------- ---------- -------------------
552     1    AVAILABLE   10/07/2001 03:05:21 78022      10/07/2001 03:05:10  
             Datafile name: /oracle/oradata/trgt/system01.dbf 
             Handle: 0jb8l876_1_0        

561     1    AVAILABLE   10/07/2001 03:38:22 78025      10/07/2001 03:38:09  
             Datafile name: /oracle/oradata/trgt/system01.dbf 
             Handle: 0lb8la51_1_0        
             Tag: WKLYBKUP
Listing a Summary of Backups: Example

The following example lists a summarized version of all RMAN backups:

LIST BACKUP SUMMARY;

List of Backups
===============
Key     TY LV S Device Type Completion Time      #Pieces #Copies Tag
------- -- -- - ----------- -------------------- ------- ------- ---
35      B  A  A SBT_TAPE    FEB 08 2002 05:37:37 1       1       TAG20020208T053733
42      B  F  A SBT_TAPE    FEB 08 2002 05:38:21 1       1       TAG20020208T053744
Listing Backups by File: Example

This example groups all backups by file:

LIST BACKUP BY FILE;

List of Datafile Backups
========================

File Key     TY LV S Ckp SCN    Ckp Time          #Pieces #Copies Tag
---- ------- -  -- - ---------- ----------------- ------- ------- ---
1    502     B  0  A 37973      09/28/01 19:28:36 1       3       *
     552     P  F  X 78022      10/07/01 03:05:10 1       1       DF_1
     561     P  0  U 78025      10/07/01 03:38:09 2       1       DF_1
2    502     B  0  A 37973      09/28/01 19:28:36 1       2       *
     562     P  0  U 78027      10/07/01 03:38:22 1       1       DF_2

List of Archived Log Backups
============================

Thrd Seq     Low SCN    Low Time  BS Key  S #Pieces #Copies Tag
---- ------- ---------- --------- ------- - ------- ------- ---
1    141     49463      14-SEP-01 213     A 1       1       TAG20011114T125431

List of Controlfile Backups
===========================

CF Ckp SCN Ckp Time  BS Key  S #Pieces #Copies Tag
---------- --------- ------- - ------- ------- ---
51593      14-SEP-01 222     A 1       1      

List of SPFILE Backups
======================

Modification Time    BS Key  S #Pieces #Copies Tag
-------------------- ------- - ------- ------- ---
OCT 08 2001 05:38:55 251     A 1       1       
Listing Archived Redo Logs: Example

The following example lists archived logs and copies of logs:

LIST COPY OF DATABASE ARCHIVELOG ALL;

List of Archived Log Copies
Key     Thrd Seq     S Low Time  Name
------- ---- ------- - --------- ----
153     1    30      A 14-SEP-01 /oracle/oradata/trgt/arch/archive1_30.dbf
154     1    31      A 14-SEP-01 /oracle/oradata/trgt/arch/archive1_31.dbf
Listing Backups of Specific Datafiles: Example

The following example lists backups of datafile 3 in summary mode:

LIST BACKUP OF DATAFILE 3 SUMMARY;

List of Backups
===============

Key     TY LV S Device Type Completion Time #Pieces #Copies Tag
------- -- -- - ----------- --------------- ------- ------- ---
180     B  0  A DISK        14-SEP-01       1       2       TAG20011114T125431
Listing Database Incarnations: Example

This example lists all database incarnations recorded in the recovery catalog:

LIST INCARNATION;

List of Database Incarnations
DB Key  Inc Key DB Name  DB ID            STATUS  Reset SCN  Reset Time
------- ------- -------- ---------------- ------  ---------- ----------
1       1       RDBMS    774627068        PARENT  1          21-OCT-03
2       2       RDBMS    774627068        CURRENT 173832     21-OCT-03
Listing Stored Scripts: Example

This example shows the output of running LIST ALL SCRIPT NAMES:

RMAN> LIST ALL SCRIPT NAMES;

List of Stored Scripts in Recovery Catalog


    Scripts of Target Database TEST

       Script Name
       Description
       -----------------------------------------------------------------------
       configure_Rman
       Script to configure retention policy and device parameters.

       backup_schema_dfs
       Backups only tablespaces that are being currently used.


    Scripts of Target Database PROD

       Script Name
       Description
       -----------------------------------------------------------------------
       nightly_backup
       Script used to backup PROD database every weekday.


    Global Scripts


       Script Name
       Description
       -----------------------------------------------------------------------
       purge_backups
       General script to enforce retention policy

       validate_archived_logs
       General script to synchronize archived logs on disk with RMAN.