Purpose
The run_job command runs a job as soon as all necessary resources are available. The DSC system limit is set at 20 concurrent running jobs, and up to 20 jobs can queue above that limit. The DSC also queues jobs if the defined target media is not available before the job starts.
Syntax
run_job -n|-name JobName -b|backup_type BackupType -p|-preview -r|runtime -f|-file File -w|wait -q|query_status -u|user_authentication User -I|original_job_execution_ID -j|job_phase JobPhaseExample
dsc run_job -n job1 -b cumulative -p -f file1.xml
dsc run_job -n job3 -b cumulative -I 13
Parameters
- n|name Name
- The name of the job on which to perform the action. Must be unique for each job.
- b|backup_type BackupType
- Enter the type of backup: full , delta , or cumulative
- p|preview
- [Optional] Generates an XML file that lists the job plan and settings. When the -r parameter is also used, a job plan is generated that includes only systems and media servers that are online. If the -r parameter is not used, the job plan includes all systems and media servers, even if they are not online.
- r|runtime
- [Optional] Checks to see if any of the media servers or systems are down, then generates a job plan to include only those online media servers or systems. To use the r parameter, you must also select the -p parameter.
- f|file filename
- [Optional] If you are previewing the job, this is the file path and file name of the output file to save the job plan.
- w|wait
- [Optional] Waits until the job has run, then displays a brief status, such as COMPLETED_ERRORS. You can add the -q parameter for a more detailed status.
- q|query_status
- [Optional] Returns full status after the job has run. Status includes the percentage of completion and elapsed time of the job run. To use this parameter, you must also select the -w parameter.
- u|user_authentication User
- Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.
- -I |original_job_execution_ID job ID of the original full backup job
- [Optional] Runs a backup or restore job with the objects that were skipped in the original full backup job. The new job contains only the skipped objects. The job execution ID must be from:
- A job that completed with errors or warnings
- A job with skipped objects
- The job specified with the -n option
Usage Notes
The run_job command cannot be used successfully for a retired job.
As of release 16.00, DSA allows users to run jobs when there are down AMPs in the system.
- Backup jobs will no longer be rejected. Tables that have fallback protection will be backed up as usual. Tables without fallback protection will be skipped.
- Restore jobs will no longer be rejected. Tables without fallback protection will be skipped.
- CBB backup will be rejected, since there is no way to keep track of WLSNs of down AMPs.
XML File Example
This command does not require an XML file as input. You must supply a file name and location to which the XML file results are exported as output.