Use this command to put a currently scheduled report job on hold temporarily. The job can be resumed using the nvjobresume command.
Syntax
nvjobhold [-servername <NVBU Server Name>] -jobid <Job ID> [-phaseid <Phase ID>] [-version]
Options
-servername – Name of the NVBU Server that is to administer the job. If the job is to be administered by a remote NVBU Server, this option must be used to name that specific server. If the local instance of the NVBU Server is to be used to administer the job, this option can be left out of the syntax. The server name is case sensitive.
-jobid – Job ID of the job that is to be put on hold. Only one job can be put on hold with a single use of this command.
-phaseid – Phase ID for the particular phase of a job that is to be put on hold. This is an optional parameter. If you do not specify this parameter, all the scheduled phases for the job specified using the jobid parameter will be put on hold.
-version – Displays the build date of the NVBU distribution.
3.4.6 nvjoblist
Use this command to list all active jobs. The output is displayed in fixed column format.
Syntax
nvjoblist [-servername <NVBU Server Name>] [-delimiter <Delimiter>] [-title <Job Title>] [-noheader] [-runinfo] [-version]
Options
-servername – Name of the NVBU Server that is to administer the job. If the job is to be administered by a remote NVBU Server, this option must be used to name that specific server. If the local instance of the NVBU Server is to be used to administer the job, this option can be left out of the syntax. The server name is case sensitive.
-delimiter – Any character that you want to use as a delimiter character. By default, a white space character is used as a delimiter.
-title – Job Title to list job(s) with a matching title. The Job Title must enclosed in quotes. For example, -title “Full_Backup_1”.
-runinfo – Displays run status and next run time in the output. -version – Displays the build date of the NVBU distribution.
3.4.7 nvjobmodify
Use this option to modify a given job as described by the -change option(s).
Syntax
nvjobmodify -jobid <Job ID> -jobname <Job Title> -type <Job Type> [-change <Change Description>] [-submit] [-parameters <Parameter File>] [-assign <Assignment Character>] [-delimit <Delimiter Character>] [-version]
Options
-jobid – Job ID of the job that is to be modified. For example, “-jobid 56”. This option is not required if the -jobname option is used.
-jobname – Job Title enclosed in quotes. This command will fail if more than one job with the given title is available on the NVBU Server. In such cases, use the -jobid option.
-type – Type of NVBU job to be modified. For example, -type backup or -type restore.
-change – Use this option to specify the changes that are to be made to the given job. Any number of values can be specified with this option. You can omit this option if you want to submit a job without any changes.
The <Change description> for the -change option is formatted as follows: <item>[:<field>]=<value>
<Item> can take one of the following values. <Field>, if applicable, calls out a specific field in the item that is to be modified. <Value>” is the new setting for the selected Item/Field.
Title – To change the Job Title.
Set – To change the Selection Set. <value> specifies the new set name. <field> may take any of the following values:
BS – Backup Selection Set BO – Backup Options Set S – Schedule Set
BT – Backup Target Options Set AB – Backup Advanced Options Set RS – Restore Selections Set
Note: If you specify a trigger name that is already in use by another job, a warning “The Trigger Name is Already in Use. Redefine this Job if this was not Intended.” will appear when you try to save or submit the job. This is for information only and will not stop you from saving or submitting the job.
Options – Modifies Backup Options for a job. The “Tag ID” for the actual backup option to be set is required. This can either be the backup option name as recognized by the CLI or a numeric value assigned to the option by NVBU. Both of these values are grouped under the “[Plugin
Options]” section in the “nvsetmodify.cfg” configuration file. For details, refer to The “nvsetmodify.cfg” File on page 17. Specify either of these values in place of the “<field>” variable. “<Value>” can be set to “True” to enable or “False” to disable the option.
Note: This option must be followed by a colon (“:”) and no spaces before or after the Tag ID. For example, “Options:<Tag ID>=True/False”.
-submit – Schedule or re-schedules the given job. This option may also be used on its own in order to schedule jobs that have been created but not scheduled.
-parameter – Directs nvjobmodify to read options and their values from a given parameter file so that you do not need to input them each time the command is run. You can create this file using any standard text editor. Enter one option (with its value) per line and omit “-” before the option. Use spaces or tabs to separate the option and values. For comments, begin the line with a # character. Such lines will be ignored.
Following is an example of a parameter file named example.txt: # nvjobmodify example file
jobname Backup File System 10-15 type backup
change Set:BS=selectionsetcli
This file can be used with the -parameter option as follows: ./nvjobmodify -parameter example.txt
-assign – Use this option to change the character used for assignment in change descriptions. It must be used if the old or new values contain the default assignment character “=”.
-delimit – Use this option to change character used as a delimiter in change descriptions. It must be used if old or new values contain the default delimiter “:”.
Examples
Modify a job entitled “Backup File System 10-15” to perform Incremental Backup instead of Full Backup using the Plug-in for FileSystem.
nvjobmodify -jobname “Backup File System 10-15” -change Options:ntfsopt_typeincr=true