Data Service Policies Advanced Tab

Previous Next  Print this Topic

Use the Data Service Policy Advanced tab after you have defined a schedule for your policy. The Advanced tab offers more options to define how your jobs operate and process.

Data Service Policies - Advanced tab

Data Service Policy Advanced Tab Elements



Pre- & Post-Processing Command

Use the pre-processing and post-processing commands to execute commands before and after each session.

Type a pre-processing or post-processing command, or both, into the text boxes. Command strings can be pointers to executable files with arguments, pointers to shell scripts, or a command string that the local processor is equipped to accept.

The following are variables in pre-processing and post-processing commands:

%P or %Pn - Policy Name

%H or %Hn - Host Name

%D - Date (yyy:mm:dd)

%Dy - Year

%Dm - Month

%Dd - Day

%T - Time (hh:mm)

%Th - Hour

%Tm - Minute

%Ts - Second

%R or %Rn - Root path name. Valid only at the beginning of a string

%Ne - Number of errors

%Nr - Number of retries

%Nb - Number of bytes written

%Nf - Number for files written

Error Log Filename

An error log file is created anytime an error is encountered during a job. It is useful for troubleshooting problems. The Error Log Filename text box can include literal file names or a combination of file name field variables to generate file names for logs.

Leave the default variables in place, or type in a file name and extension to use, or type in a variable name using file name field variables (see File Name Field Variables section below).
Use the Browse button to define a new location and type in the file name that you want to use, including an extension.

Report Options

When a job runs, one of the following report files is created:

Summary - A header and summary report

Complete - Same as summary and lists all files

Diagnostic - Complete, but adds relevant, diagnostic information

From the drop-down list select a report option. Use the Summary or Complete options on a normal basis and switch to Diagnostics if problems occur.
In the Report Options text box, leave the default variables in place, or type in the file name and extension to use, or type a variable name using file name field variables (see File Name Field Variables section below).
Use the Browse button to locate a file to overwrite an already existing log file.

Enable Transmission Optimization

Select for the client to constantly monitor its processes and  to determine the best network transmission protocol for files being processed. Leave this option selected to get up to a 20% increase in performance. If the Information Repository is slow, run a few timed tests to determine a setting that works best for your Information Repository.

Maintain Client/Vault Connection

Vault connection sharing determines how many files are sent from the source Vault to the destination Vault in a single connection. The higher the number of files or bytes transferred, the longer the connection between the source and destination Vault are maintained. Access to a particular Vault resource (such as one drive of a multi-drive storage device) used by a process on one client is restricted and inaccessible to other clients in the network for the duration of the connection.

To illustrate this, imagine an environment where a single Vault with a single tape drive is used to service several desktop clients. When a client is configured with a connection sharing set to 250 files, and other clients are configured to start jobs at the same time, no client can connect until the first client is finished. Each connection to the server locks out other connections, and other clients must wait before processing files.

1.Type a value into the Maintain Client/Vault Connection for text box.
2.Select the Files radio button or Bytes radio button. By  selecting Files, a connection sharing proceeds based on the number of files transmitted; and if Bytes, based on the number of bytes.


The throttle controls the speed that files are sent to the Vault. Lower numbers reduce the bandwidth. Throttle values range from 10% to 100% of total available bandwidth.

From the Throttle drop-down list, select a percentage to operate the client on its host computer for maximum performance.

Phoenix RSM is designed to operate at maximum performance of its host computer, network environment, and storage resources available. During normal working hours, running a job at peak performance could interfere with other network operations.

Test Run: Output Results but do not actually move files

Use to test a job before doing it live. This is useful  after creating a complex set of process parameters that include filters and other options.

Select Test Run: Output results but do not actually move files. When the process is scheduled to run, the files that match the criteria build, but files are not moved. Results output in a report, defined in the Report Options field.

Include Offline Files

Since all of your stored files are logged, you can include offline files when processing jobs. If the files are located on offline media, the job requires more time as the system has  to wait whenever offline media is required.

Include Deleted Files

Process files marked as deleted in tape media.

Select to set the policy to process files marked as deleted. If this option is de-selected the policy ignores these files.

On media types, like magnetic tape, it is not possible to remove files that have been deleted or purged from the Information Repository. Because it writes sequentially, a file marked for deletion may lie on the media between two viable files. The files eligible for removal are marked as deleted even though they remain on the media.

Erase media when all files are deleted or no longer referenced

Media will be erased when all the files stored on that media have been marked for deletion.

Select this option to erase the media when all files are deleted or no longer referenced.

For media which do not support random file deletion (i.e. tape), this will make the media fully available and usable again.

This option is only enabled when a policy is a purge or migrate policy.

Offline Media

During a data service job, offline media is used only if Include offline files is selected from the Advanced tab. If Include offline files is not selected, attempting to use media that is offline may result in a “No resources available” error if media cannot be found.

File Name Field Variables

The file path can include a literal file name or a combination of variables to generate file names for reports. Use variables to distinguish between reports and to find specific reports.

If a path with a literal file name is typed like C:/Program Files/Logs/Job_Report.log, the system generates the report destination folder Logs (if it does not already exist) and a report named Job_Report.log. If a path with variables for the file name is typed, for example, %R/Logs/%P_from_%H_on_%D_at_%T, the system generates the report destination folder and a report — where policy name, host name, date, and time are populated with the actual details from your Information Repository and job.

The following are the variables to use. When using multiple variables, separate them from each other with an underscore (_).



%P or %Pn

Policy Name

%H or %Hn

Host Name


Date (yyyy:mm:dd)








Time (hh:mm)







%R or %Rn

Root Pathname. Valid only at the beginning of a string