Advanced Job Options

Send e-mail notification

Toggle on	The notification is sent as specified below the toggle (additional fields will appear – see below).
Toggle off	The notification is sent to the default e-mail address configured in the E-mail Notification Defaults section.

E-mail Notification Fields

Subject

The subject of your message. The subject line usually contains a combination of straight text and variable elements. Variables, which must begin with %, are replaced with actual corresponding values. If you enclose variables in double quotation marks, those variables are treated as literal values. You can embed the following variables:

• %JOBNAME
• %JOBID
• %JOBTYPE
• %RC

Use %RC to include the return code in the message for this run of the job, when applicable.

To

The email address of the primary recipient of your message. Only one “To” address is permitted.

Cc

Carbon Copy. The email address(es) of the secondary recipient(s) of your message. Use a semicolon to delimit multiple email addresses.

Bcc

Blind Carbon Copy. The email address(es) of the secondary recipient(s) not identified to other recipients. Use a semi-colon to delimit multiple email addresses.

Note. Note that the following characters are invalid in all fields: < > ; and '.

Note. DPX emailing must be enabled when you first configure your Enterprise. At that time, you supply general system information, including SMTP Host Name and SMTP Port. See the E-mail Notification Defaults section.

Set alternate destination

By default, DPX will restore the files or volumes specified in the File Browsing step to their original location. You may override this setting by indicating a directory on the same or another node.

Set schedule

Schedule the restore job. The time field is using your browser’s time zone. For example, if you have DPX in London and access the DPX web interface from New York, specify the time in US Eastern Time.

Important.

When specifying a schedule, make sure the Delete restore job upon completion toggle is switched off. Otherwise, the job will be deleted upon its first successful completion.

Source Options

Tape end-of-job usage

Determines the handling of tapes post-job:

Rewind tapes	For a standalone tape device, this option rewinds the tape and leaves it in the drive. For a tape library tape drive, this option rewinds, unloads, and returns the tape to its slot.
Unload tapes	For a standalone tape device, this option rewinds the tape and ejects it from the drive. For a tape library tape drive, this option rewinds, unloads, and returns the tape to its slot. For DiskDirectory, this option causes empty volsers to be used before new volsers.
Leave tapes	In the case of standalone tape drives, the tape remains wound to the point where the job ended and stays in the drive. However, for tape library drives, the tape is always attempted to be returned to its slot after the backup operation is completed. The next job attempts to use the tape in the drive instead of mounting a new tape. In the case of a standalone drive, if the currently mounted tape is unacceptable (for example, if the next backup requires a tape from a different media pool), the operator is prompted to mount another tape. In the case of a tape library, if the tape in the drive is rejected for any reason, it unloads the tape, returns it to its slot, and proceeds to select another tape.
Export tapes	Automates the export of tapes to an I/O port, eliminating manual processes and preparing tapes for their next destination. In environments with physical tape libraries, the availability of an empty I/O port is essential. The system will alert and will return an error code if no port is available, prompting user action. A rescan of ports is recommended to ensure availability.

Max. devices

Limits the number of storage devices valid for use with this job. Use this option if you want to stop DPX from using all the drives in the selected device cluster so that some drives will be available for other purposes.

Tape mount attempts

The maximum number to check a tape in a standalone tape device.

Mount interval (seconds)

The number of seconds to wait between checking the availability of a tape in a standalone tape device.

AWS Glacier expedited retrieval toggle

You can select the archive retrieval option for Amazon S3 Glacier from either “Standard” or “Expedited”. Leave this option disabled for the Standard retrieval archive mode, or enable the Expedited retrieval archive mode.

See also.

For more information about the Amazon S3 Glacier Archive Retrieval options, refer to the following document:

• AWS Documentation: Amazon S3 Glacier Developer Guide: Retrieving S3 Glacier Archives

Script Options

As with backup jobs, you can add script options for this restore job.

Pre-job script

Specifies a script to run before the job starts, with options to handle scenarios where the script fails:

• Run job/run post-job script
• Skip job/run post-job script
• Skip job/skip post-job script

Post-job script

Specifies a script to run after the job completes, with options for handling job failure:

• Run post-job script
• Skip post-job script

See also.

For detailed information about pre- and post-job scripts, including all valid definitions, see Pre-Scripts and Post-Scripts.

Destination Options

Existing File Handling

Tells DPX how to behave if it finds a file at the destination with the same name as the file that it is restoring.

Skip Existing Files and Directories	Does not write over the existing file or directory if it has the same name as the one being restored.
Replace Existing Files	Restores the file to a temporary file, ensures that the restore is successful, and then writes over the existing file with the like-named file being restored.
Replace Existing Files and Directories	For existing directories, restores directory characteristics only, such as date, time, and owner. For existing files, restores file to a temporary file, ensures that the restore is successful, then writes over the existing file with the like-named file being restored.
Delete Existing Files Before Restore	Deletes the existing file before restoring the like-named file. Use this option when disk space limitations prohibit using Replace Files.
Rename Restored Files	Renames the file being restored to a name derived from the existing file. On NTFS and UNIX, DPX appends .R01 to the filename. If filename.R01 exists, DPX uses .R02 and so on. On FAT, a file extension .R01 is used. For example, the file ABCD.TXT is restored as ABCD.R01. If ABCD.R01 exists, ABCD.R02 is used, and so on.

Missing Directories

Controls how DPX behaves if it tries to restore a file to a directory and discovers that the directory does not exist.

Use Full Privileges	Uses the file privileges the file possessed when it was originally backed up.
Use Parent Privileges	Applies the file privileges of the parent directory into which the files are being restored.
Use Root Privileges	Applies the file privileges of the root directory into which the files are being restored.

Destination Path

Configures the restoration path for the files. This setting allows you to choose whether to preserve the original directory structure or to restore all files to a single specified directory.

Absolute Path	Maintains the original directory structure upon restoration. For instance, if you backed up from C:\NewPrjs\Dev\Bin and restore to C:\NewPrjs\Test, the restored path will be C:\NewPrjs\Test\NewPrjs\Dev\Bin.
Relative Path	Strips the parent directories, placing the files directly into the new restoration directory. For example, backing up from C:\NewPrjs\Dev\Bin and restoring to C:\NewPrjs\Test results in the files being restored to C:\NewPrjs\Test\Bin.

NDMP recover mode

Determines the type of recover operation to perform in NDMP restore tasks.

Extract	Only the selected files and/or directories are restored.
Direct	Direct Access Recovery (DAR) is performed. Select this option only if the NDMP server supports DAR.
True Image	Rebuilds an entire file system or subtree if base and incremental backups are restored in order.

Enable NDMP server logging

Controls the routing of NDMP server-generated log messages to the job log file.

Yes	All NDMP server log messages will be routed to the master server’s job log file. Yes is the default.
No	The NDMP server log messages will be logged locally in the NDMP client node log file instead of in the master server’s job log file.

Additional NDMP environment

This option allows you to introduce any additional NDMP environment variables that are necessary for the backup task. Specify your environment variables as an ASCII string with an environment variable name and value pairs using the following syntax:
env1name=value,env2name=value,...
Note that syntax validation is not performed on the specified value at job definition time, but rather at run time. Only valid entries are added to the NDMP operation environment.

Do not specify any of the following NDMP environment variables in your variable string because DPX controls these specifically:

• BASE_DATE
• DEBUG
• DIRECT
• DUMP_DATE
• EXTRACT
• FILES
• FILESYSTEM
• HIST
• LEVEL
• PREFIX
• RECOVER_FILEHIST
• SINCE_TIME
• TYPE
• UPDATE
• VERBOSE

Specifying the variables above may cause unexpected results due to unpredictability of the order in which they are evaluated.

NDMP servers from different vendors may support different NDMP environment variables. Except for a few well-known environment variable names, there is currently no standardized set of such variables. This option allows you to add environmental variables specific to your NDMP server.