HP MSA 1040 HP MSA 1040 CLI Reference Guide (762782-001, March 2014) - Page 186

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. The prefix is case sensitive; cannot include a comma, double quote, left angle bracket, or backslash; and can have a maximum of 26 bytes. 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 the retention count for a task, 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" (page 20). dest-prefix prefix Optional. A label to identify the volume copy created by this task. The prefix is case sensitive; cannot include a comma, double quote, left angle bracket, or backslash; and can have a maximum of 26 bytes. 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. 186