IBM System Storage DS3000, Programming Manual

Page: 47 / 652

Chapter 3. Script Commands
Attention: The script commands are capable of damaging a configuration and causing loss of data
access if not used correctly – Command operations are performed as soon as you run the commands.
Some commands can immediately delete configurations or data. Before using the script commands, make
sure that you have backed up all data, and have saved the current configuration so that you can reinstall
it if the changes you make do not work.
IBM recommends using the Storage Manager client GUI to manage your storage subsystems.
– The
command line interface does not have any mechanisms to prevent you from inadvertently making
unwanted changes to the storage subsystem; therefore, IBM recommends using the Storage Manager
client GUI to manage your storage subsystem configurations.
This chapter has five sections to help you use script commands:
v
“Naming conventions” lists the general formatting rules for entering the names of storage subsystem
entities, such as logical drives or disk drives, with the script commands.
v
“Firmware Compatibility Levels” on page 3-2 describes how to interpret the firmware level
information.
v “Formatting rules for script commands” on page 3-2 lists the general formatting rules that apply to the
script command syntax.
v
“DS3000, DS4000, and DS5000 commands with minimum firmware levels” on page 3-3 indicates which
commands you can use for DS3000, DS4000, or DS5000 with their minimum controller firmware
requirements.
v
“Script Commands Listed by Function” on page 3-322 lists the script commands organized into groups
related to the physical features, the logical features, and the operational features of the storage
subsystem.
v
Finally, the script commands are listed alphabetically with detailed information including the command
name, syntax, and parameters.
Naming conventions
v
Names can have a maximum of 30 characters.
v
You can use any combination of alphanumeric characters, hyphens, and underscores for the names of
the following components:
– Storage subsystems
– Host groups
– Hosts
– subsystems
– Logical drives
– HBA host ports
v You must use unique names. If you do not use unique names, the controller firmware returns an error.
v
If the name contains more than one word, hyphens, or underscores, enclose the name in double
quotation marks (“ ”). In some usages, you must also surround the name with square brackets ([ ]).
The description of each parameter indicates whether you need to enclose a parameter in double
quotation marks, square brackets, or both.
v
The name character string cannot contain a new line.
v
On Windows operating systems, you must enclose the name between two back slashes (\) in addition
to other delimiters. For example, the following name is used in a command that runs under a
Windows operating system:
© Copyright IBM Corp. 2008, 2012
3-1