Oracle9i Recovery Manager Reference
Release 1 (9.0.1)

Part Number A90136-02
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback

Go to previous page Go to beginning of chapter Go to next page

RMAN Commands , 32 of 60


LIST

Syntax


Text description of list.gif follows
Text description of the illustration list.gif

listObjectSpec::=


Text description of listobje.gif follows
Text description of the illustration listobje.gif

listBackupOption::=


Text description of listback.gif follows
Text description of the illustration listback.gif

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:

Oracle9i Recovery Manager User's Guide to learn how to make lists and reports, and "cmdLine" 

Restrictions and Usage Notes

Keywords and Parameters

INCARNATION 

Displays information about the incarnations of a database.

The LIST output includes the primary keys of all database incarnation records for the specified database name. 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-15 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. 

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

listObjectSpec 

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

See Also: "recordSpec" 

 

BACKUP 

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

Unless you specify the RECOVERABLE option, 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.

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 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-12 and Table 2-14 for an explanation of the column headings of the LIST COPY output tables 

 

OF listObjList 

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" 

listBackupOption 

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

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

 

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 BACKUP SUMMARY 

Lists a summary of backup sets, then the contents of each backup set (pieces and files), and then proxy copies. 

 

BY FILE 

Lists a datafile, then its backup sets (including recovery action info), and then proxy copies. 

maintQualifier 

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

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 following:

  • Incremental backups that have no valid parent to which the incremental can be applied.

  • Full backups that were taken before the most recent RESETLOGS, and which have been in online read/write status sometime between the time the backup was taken and the RESETLOGS. In other words, a backup taken prior to the RESETLOGS can be used in the current incarnation only if the file was offline clean or read at the time of the backup, and was never made read/write again before the RESETLOGS.

 

untilClause 

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

recordSpec 

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

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: 
        Piece Name: /oracle/dbs/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-00 49784      21-SEP-00
  1    142     49784      21-SEP-00 50331      21-SEP-00

BS Key  Type LV Size       Device Type Elapse Time Completion Time
------- ---- -- ---------- ----------- ----------- ---------------
244     Full    61M        DISK        00:00:18    21-SEP-00      
        BP Key: 245   Status: AVAILABLE   Tag: 
        Piece Name: /oracle/dbs/0ac5unj5_1_1

  Controlfile Included: Ckp SCN: 51554        Ckp time: 21-SEP-00

  List of Datafiles in backup set 244
  File LV Type Ckp SCN    Ckp Time  Name
  ---- -- ---- ---------- --------- ----
  1       Full 51555      21-SEP-00 /oracle/dbs/tbs_01.f
  2       Full 51555      21-SEP-00 /oracle/dbs/tbs_02.f

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

PC Key  File Status      Completion time     Ckp SCN    Ckp time
------- ---- ----------- ------------------- ---------- -------------------
552     1    AVAILABLE   10/07/2000 03:05:21 78022      10/07/2000 03:05:10  
             Datafile name: /oracle/dbs/tbs_01.f 
             Handle: 0jb8l876_1_0        

561     1    AVAILABLE   10/07/2000 03:38:22 78025      10/07/2000 03:38:09  
             Datafile name: /oracle/dbs/tbs_01.f 
             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
------- -- -- - ----------- --------------- ------- ------- ---
164     B     A DISK        14-SEP-00       1       1       
170     B     A DISK        14-SEP-00       1       1 

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/99 19:28:36 1       2       *
     552     P  F  X 78022      10/07/99 03:05:10 1       1
     561     P  0  A 78025      10/07/99 03:38:09 1       1       DF_1_2
2    502     B  0  A 37973      09/28/99 19:28:36 1       2       *
     562     P  0  U 78027      10/07/99 03:38:22 1       1       DF_1_2

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

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

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

CF Ckp SCN Ckp Time  BS Key  S #Pieces #Copies Tag
---------- --------- ------- - ------- ------- ---
51593      14-SEP-00 222     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    141     A 14-SEP-00 /oracle/work/arc_dest/arcr_1_141.arc
154     1    142     A 14-SEP-00 /oracle/work/arc_dest/arcr_1_142.arc

Listing Backups of Specific Datafiles: Example

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

LIST BACKUP OF DATAFILE 11 SUMMARY;

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

Key     TY LV S Device Type Completion Time #Pieces #Copies Tag
------- -- -- - ----------- --------------- ------- ------- ---
180     B  0  A DISK        14-SEP-00       1       2       

Listing Database Incarnations: Example

This example lists all database incarnations:

LIST INCARNATION;

List of Database Incarnations
DB Key  Inc Key DB Name  DB ID            CUR Reset SCN  Reset Time
------- ------- -------- ---------------- --- ---------- ----------
1       2       RDBMS    674879952        YES 1          14-SEP-00

Go to previous page Go to beginning of chapter Go to next page
Oracle
Copyright © 1996-2001, Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Book List
Go To Table Of Contents
Contents
Go To Index
Index

Master Index

Feedback