Specifies the case-sensitive name of a channel to use when executing an RMAN command within a RUN command.
The channel must have been allocated by means of ALLOCATE CHANNEL in this RUN command. If you do not set this parameter, then RMAN uses the default channel.
Specifies a SQL statement for execution (see Example 2-143). SELECT statements are not permitted.
You must use duplicate single quotes to insert a single quote into a quoted string when the quoted string uses the same style of quoting. For example, if the string that RMAN passes to SQL contains a filename, then the filename must be enclosed in duplicate single quotes and the entire string following the SQL keyword must be enclosed in double quotes (see Example 2-144).
Note: Because EXECUTE is a SQL*Plus command, you cannot execute a PL/SQL program unit by specifying EXECUTE within the RMAN SQL command. Instead, you must use the BEGIN and END keywords. For example, to execute the PL/SQL procedure rman.rman_purge with the SQL command, issue the following command:
SQL 'BEGIN rman.rman_purge; END;';
Example 2-143 Archiving the Unarchived Online Logs
This example backs up a tablespace and then archives all unarchived online redo logs.
BACKUP TABLESPACE users;
SQL "ALTER SYSTEM ARCHIVE LOG CURRENT";
Example 2-144 Specifying a Filename within a Quoted String
This example specifies a filename by using duplicate single quotes within the context of a double-quoted string.
SQL "ALTER TABLESPACE users ADD DATAFILE ''/disk1/oradata/users02.dbf''
SIZE 100K AUTOEXTEND ON NEXT 10K MAXSIZE 100K";