Set Task - HP P2000 G3 Cli Reference Manual

set task

Description Changes parameters for a TakeSnapshot, ReplicateVolume, or VolumeCopy task. For
these types of tasks, you can change parameters other than name, type, or associated volumes. If
you change the parameters for a running task, the changes will take effect the next time the task
runs.
If you want to change parameters for a ResetSnapshot task or the name, type, or associated
volumes for another type of task, create a new task to replace the existing one.
Syntax
set task
[snapshot-prefix prefix]
[retention-count #]
[dest-vdisk vdisk]
[dest-prefix prefix]
[modified-snapshot yes|no]
[replication-mode new-snapshot|last-snapshot]
name
Parameters snapshot-prefix prefix
Optional. A label to identify snapshots created by this task. Snapshot names have the format
prefix_s#, where # starts at 001.
retention-count #
Optional. For a TakeSnapshot task, the number of snapshots created by this task to retain, from 1
to the licensed limit. When a new snapshot exceeds this limit, the oldest snapshot with the same
prefix is deleted. If you reduce a task's retention count, excess snapshots will be removed the next
time the task runs.
For a ReplicateVolume task, the number of replication images created by this task to retain, from
2 to 32. When a new image exceeds this limit, the oldest image with the same prefix is deleted. This
parameter applies to the primary volume only; for the secondary volume, images will accumulate
until either the secondary vdisk's space limit is reached or the maximum number of images is
reached, after which the oldest image will be deleted as new images are created.
dest-vdisk vdisk
Optional. Name or serial number of the destination vdisk for the volume copy. For vdisk syntax, see
Command syntax
dest-prefix prefix
Optional. A label to identify the volume copy created by this task. Copy names have the format
prefix_c#, where # starts at 001.
modified-snapshot yes|no
Optional. For a VolumeCopy task, specifies whether to include or exclude modified write data from
the snapshot in the copy. This parameter applies only when the source volume is a snapshot; it is
ignored if the source volume is a master volume.
• yes: Include modified snapshot data.
• no: Exclude modified snapshot data.
If this parameter is omitted for a snapshot, modified snapshot data is excluded.
replication-mode new-snapshot|last-snapshot
Optional. Specifies whether to replicate a new snapshot of the volume to the remote system, or to
replicate the last (most recent existing) snapshot of the volume to the remote system.
• new-snapshot: Replicate a new snapshot.
• last-snapshot: Replicate the most recent existing snapshot.
If this parameter is omitted, a new snapshot is replicated.
name
Name of the task to change.
184 Alphabetical list of commands
on page 22.