NetVault 11.4.5 - CLI Reference Guide

-servername

Specifies the name of the target NetVault Backup Server.

-jobid

Specifies the ID of the job that you want to delete. Only one Job ID can be specified with this option.

-type

Specifies the type of job that you want to delete: backup or restore.

Use this option if you want to delete a specific job type. Do not use this option if you want to delete all job types.

-jobrange

Specifies a range of Job ID numbers corresponding to a series of jobs that you want to delete. Use a hyphen to separate the start and end Job ID numbers.

Example:

-jobrange 30-45

-jobtitle

Specifies the name of the job that you want to delete. You must provide the full name and enclose the name in quotation marks.

Example:

-jobtitle “Full_Backup_1”

The -jobtitle option deletes a single job.

You can use the -jobrange option with the -jobtitle option to delete multiple jobs that use the same job title.

-client

Specifies the name of the NetVault Backup Client that served as target for the jobs. Use this option to delete all jobs for the specified client.

Example

-client “NV_Client_MKTG”

-plugin

Specifies the name of the plug-in used to perform the jobs. Use this option to delete all jobs that were performed using a particular plug-in. The plug-in name must be enclosed in quotation marks.

Example:

-plugin “File System”

-selectionsetname

Specifies the name of the Backup or Restore Selection Set that was used to create the jobs.

-schedulesetname

Specifies the name of the Schedule Set that was used to create the jobs.

-targetsetname

Specifies the name of the Target Set that was used to create the jobs.

-advoptssetname

Specifies the name of the Advanced Options Set that was used to create the jobs.

-force

Deletes matching jobs that are scheduled to run.

If a job that meets the criteria set by other option is in queue (scheduled to run later), any attempt to delete it fails. Use the “-force” option to delete such jobs.

-scheduleonly

Remove jobs from the job queue without deleting them from the NetVault Database. Use this option in lieu of -force.

-version

Displays the build date of the NetVault Backup distribution installed on the machine.

-servername

Specifies the name of the NetVault Backup Server that administers the job.

This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.

-jobid

Specifies the ID of the job that you want to place on hold. Only one Job ID can be specified with this option.

-phaseid

Specifies the phase ID.

Use this option to place a particular phase on hold. If you omit this option, all scheduled phases of the specified job are placed on hold.

-version

Displays the build date of the NetVault Backup distribution installed on the machine.

-servername

Specifies the name of the NetVault Backup Server that administers the job.

This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.

-delimiter

Specifies the character that you want to use as a delimiter. By default, a white-space character is used as a delimiter.

-title

Specifies the name of the job. Use this option to display all jobs with the specified name. You must provide the full name and enclose the name in quotation marks.

Example:

-title “Full_Backup_1

-noheader

Suppresses display of header row.

-runinfo

Includes run status and next run time in the output.

-version

Displays the version number of the CLI tools and the build date of the NetVault Backup distribution installed on the machine.

-jobid

Specifies the ID of the job that you want to modify.

Example

-jobid 56

This option is not required if you specify the -jobname option.

-jobname

Specifies the name of the job that you want to modify. The job name must be enclosed in quotation marks.

If two or more jobs on the NetVault Backup Server have the same name, the command fails. In such cases, you must use the -jobid option.

-type

Specifies the type of job that you want to modify (backup or restore)

-change

Specifies the changes that you want to make to the job definition. You can specify any number of values with this option. You can omit this option if you want to submit a job without any changes.

The <Change description> variable for the -change option is formatted as follows:

<item>[:<field>]=<value>

<item> can take one of the following values: Title, Set, or Options.

<field> calls out a specific field in the item that you want to modify.

<value> is the new setting for the selected field.

Change items:

-submit

Schedules a job. This option may also be used on its own to schedule jobs that have been created but not scheduled.

-parameter

Reads options from a parameter file.

You can use any text editor to create the parameter file. Specify one option with its value per line and omit “-” before the option. Use spaces or tabs to separate the option and values. To include comments, begin the line with a “#” character.

Example

# 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

Specifies the assignment operator that you want to use in change descriptions. The default assignment operator is the “=” character. This option must be specified if the old or new values contain the “=” character.

-delimit

Specifies the character that you want to use as a delimiter in change descriptions. The default delimiter is the “:” character. This option must be specified if old or new values contain the “:” character.

-version

Displays the build date of the NetVault Backup distribution installed on the machine.