CREATE_POLLING_POLICY

This procedure creates a backup polling policy.

A backup polling policy specifies a directory where a protected database places incoming backups or archived redo log files. The policy also specifies the frequency with which the Recovery Appliance looks for backups in the polling location.

When the Recovery Appliance discovers a file through polling, the Recovery Appliance examines the file, and then uses its contents to associate it with a protected database that is registered with the Recovery Appliance. If the Recovery Appliance cannot associate the file with any registered protected database, then the Recovery Appliance logs a warning message and ceases to process the file.

Syntax

PROCEDURE create_polling_policy(
   polling_policy_name IN VARCHAR2,
   polling_location IN VARCHAR2,
   polling_frequency IN DSINTERVAL_UNCONSTRAINED DEFAULT NULL,
   delete_input IN BOOLEAN DEFAULT FALSE,
   comments IN VARCHAR2 DEFAULT NULL);

Parameters

Table 22-10 CREATE_POLLING_POLICY Parameters

Parameter Description

polling_policy_name

The user-assigned name of the polling policy.

polling_location

The directory that the Recovery Appliance periodically examines for new backups. Do not specify this directory name in multiple polling policies.

polling_frequency

The frequency with which the Recovery Appliance examines the specified directory for new backups. System load may cause backup polling to occur less frequently.

Specify the window as any valid INTERVAL DAY TO SECOND expression, such as INTERVAL '2' DAY (2 days), INTERVAL '4' HOUR (4 hours), and so on.

delete_input

The setting that controls deletion behavior. If TRUE, then the Recovery Appliance deletes files in the specified directory after copying them to a storage location. If FALSE, then the Recovery Appliance does not delete files that it discovers in the polling location.

comments

Optional user supplied comment describing reason for executing this command.