Usage Guidelines; Adding Comments To A Script File - IBM System Storage DS3000 Programming Manual

storagePartition512 | storagePartitionMax | flashcopy | flashcopy2 | flashcopy4 | flashcopy8 |
flashcopy16 | remoteMirror8 | remoteMirror16 | remoteMirror32 | remoteMirror64 | remoteMirror128
|.

Usage Guidelines

This list provides guidelines for writing script commands on the command line:
v You must end all commands with a semicolon (;).
v You can enter more than one command on a line, but you must separate each command with a
semicolon (;).
v You must separate each base command and its associated primary parameters and secondary
parameters with a space.
v The script engine is not case sensitive. You can enter commands by using uppercase letters, lowercase
letters, or mixed-case letters.
v Add comments to your scripts to make it easier for you and future users to understand the purpose of
the script commands. (For information about how to add comments, see ""Adding Comments to a
Script File.")
Note: While the CLI commands and the script commands are not case sensitive, user labels (such as for
logical drives, hosts, or host ports) are case sensitive. If you try to map to an object that is identified by a
user label, you must enter the user label exactly as it is defined, or the CLI commands and the script
commands will fail.

Adding Comments to a Script File

The script engine looks for certain characters or a command to show comments. You can add comments
to a script file in three ways:
1. Add text after two forward slashes (//) as a comment until an end-of-line character is reached. If the
script engine does not find an end-of-line character in the script after processing a comment, an error
message appears, and the script operation is terminated. This error usually occurs when a comment is
placed at the end of a script and you have forgotten to press the Enter key.
// Deletes the existing configuration.
set storageSubsystem resetConfiguration=true;
2. Add text between / * and * / as a comment. If the script engine does not find both a starting
comment notation and an ending comment notation, an error message appears, and the script
operation is terminated.
/* Deletes the existing configuration */
set storageSubsystem resetConfiguration=true;
3. Use the show statement to embed comments in a script file that you want to appear while the script
file is running. Enclose the text that you want to appear by using double quotation marks (" ").
show "Deletes the existing configuration";
set storageSubsystem resetConfiguration=true;
Chapter 2. About the Script Commands
2-11