SPOOL

Syntax

Text description of the illustration spool.gif

Purpose

To write RMAN output to a log file.

If the file does not already exist, then RMAN creates it. If the file does exist, then RMAN overwrites the file, unless APPEND is specified, in which case RMAN appends its output to the end of the file. The SPOOL command does not abort if the specified file cannot be opened for writing. Instead, RMAN turns SPOOL to OFF.

See Also: "cmdLine" for a description of LOG files

Restrictions and Usage Notes

Execute the SQL command at the RMAN prompt or within the braces of a RUN command.

Keywords and Parameters

OFF	Turns off spooling.
TO filename	Specifies the name of the log file to which RMAN directs its output. RMAN creates the file if it does not exist, or overwrites the file if it does exist.
APPEND	Specifies that RMAN should append its output to the end of the existing log file.

Examples

Spooling RMAN Output to a File: Example

This example directs RMAN output to standard output for the backup of datafile 1, then directs output to a log file for the backup of datafile 2, then directs output to a different log file for the whole database backup:

% rman target / nocatalog

BACKUP DATAFILE 1;
SPOOL LOG TO '/oracle/log/df2log.f';
BACKUP DATAFILE 2;
SPOOL LOG OFF:
SPOOL LOG TO '/oracle/log/dblog.f';
BACKUP DATABASE;
SPOOL LOG OFF;