HP StorageWorks SAN Virtualization Services Platform Manager Command Line Interface User Guide (5697-0936, May 2011)

• The timeout in CLI commands defines the maximum time in seconds that the CLI will wait for
the completion of the command.
If the command is completed before the timeout period expires, the CLI will return with a
success status. If the command does not complete within the timeout period, the CLI returns
with a VSM_SYNC_TIMEOUT error.
The recommended timeout value to use is 900 (seconds). For some operations (for example,
create a PiT or snapshot over multiple PiTs, delete PiT, or restore snapshot) you should use
higher values, since the time taken to complete depends on how much data is being handled.
• The -Drive may accept a drive letter in the form of H:, or where applicable, a fully qualified
mount point.
• All capacity or disk sizes are in megabytes (MB), unless otherwise specified, with 1 MB=1024
KB.
• In general, a command with multiple arguments of the same type (for example, set
permissions with multiple host names) may be partially executed. The VSM executes such
commands sequentially, iterating on all these arguments. If an execution error is encountered
for one of these arguments (for example, no such host name), it stops execution at this stage
and returns an error indicating the index of the failed argument (in this case, the index of the
failed host on the list). However, the command has already been successfully executed for all
the previous arguments (hosts, in this example).
General CLI control commands
AllowExecErrors and DisallowExecErrors commands
Syntax
AllowExecErrors
DisallowExecErrors
Description
The AllowExecErrors (allow or ignore execution errors) and DisallowExecErrors (do not
allow or do not ignore execution errors) CLI commands can only be used in script files (that is,
when the -I argument is used).
The AllowExecErrors CLI command is used to ignore errors during the execution of CLI
commands. Its main purpose is to ignore does not exist types of errors, which are returned when
trying to delete an object (virtual disk, PiT, or snapshot) that does not exist. The effect is that the
ignored errors are not reported back to the application that invoked the VSM CLI.
The DisallowExecErrors CLI command is used to reset the state to do not allow or do not
ignore execution errors, which is the default/initial state of CLI execution.
NOTE: The AllowExecErrors command suspends any OnErrorGoTo command that is in
effect until the next DisallowExecErrors command (if any).
GoTo command
Syntax
GoTo Label
Description
The GoTo command can be only used in script files (that is, when the -I argument is used). This
command is used to change the sequence of executed CLI commands.
20 Using the VSM command line interface