Users Guide

The following table describes the required and optional command syntax.
Table 29. Update Schedule Command Options
Parameter Abbr. Argument Description
Required Parameter
--name -n schedule-name Specifies the name of the schedule.
Optional Parameters
--collection -c collection-name Specifies the name of a Smart Copy collection. All Smart Copies, even
a single one, are stored in a collection. Do not use with --source.
--comment -C comment-string Provides a comment string to describe the Smart Copy that you are
updating. The comment is set for the PS Series group and is stored in
the backup document.
--delete -x option Specifies any options to be removed from the schedule. For example,
if a comment string is no longer needed, enter --delete comment.
--force -F none Updates the Smart Copy even if one or more mount points cannot be
frozen. When updating a Smart Copy, ASM/LE attempts to freeze all
mount points. If the freeze operation fails, such as if a file system type
does not allow freezing and thawing mount points, this option updates
the Smart Copy and updates the Smart Copies, but they might be
inconsistent.
--freeze-time none n Sets the maximum number of seconds to freeze the file systems when
updating a Smart Copy. If this value is exceeded, the operation times
out and a consistent Smart Copy is not updated. For most
configurations, the default time is sufficient. If you are updating Smart
Copies with a significant number of mount points or a heavy I/O load,
ASM/LE might not be able to freeze all of the mount points and build
the Smart Copy in the default time. Use this option to increase the
time limit.
--group-access-file -g file-location Specifies the location of the group access file that stores the user
names and encrypted passwords.
--keep -k n Specifies the maximum number of Smart Copies to keep for the
scheduled task. By default, this value is 12. Use this option to prevent
too many Smart Copies from accumulating. If more than this number
are created, the oldest are deleted until the keep count is reached. If
snapshots or replicas were created by ASMCLI, the deleted Smart
Copies cause a broken Smart Copy because the backup document
refers to snapshots or replicas no longer in the group.
--new-name -N new-schedule-name New name for the schedule.
--output none error | always Specifies when to display output on the console. Use error to display
output only when an operation fails, such as with a scheduled
operation. Use always (default) to display all output from the
operation.
--retry-count -r n Specifies the number of times to retry a failed operation.
--retry-wait -w n Specifies the number of seconds to wait before retrying a failed
operation.
--source -s mount-point Lists one or more mount points to be copied. Do not use with --
collection.
--type -t volume type clone|
replica|snapshot|
thinclone
Indicates the type of Smart Copy to create. If omitted, defaults to
snapshot. ASMCLI displays an error when applying an incorrect
type, such as specifying thinclone for a volume other than a
template volume.
Auto-Snapshot Manager Command Line Interface 85