IBM System Storage DS3000, Programming Manual

Page: 48 / 652

[\”Engineering\”]
v
For a UNIX operating system and, when used in a script file, the name appears as the following
example:
[“Engineering”]
v
When you enter a World-Wide Identifier (WWID) of an HBA host port, some usages require that you
surround the WWID with double quotation marks. In other uses, you must surround the WWID with
angle brackets (<>). The description of the WWID parameter indicates whether you need to enclose the
WWID in double quotation marks (“ ”) or angle brackets.
Entering numerical names
When the storage management software automatically configures a storage subsystem, the storage
management software assigns names that consist of numerical characters. Names that consist only of
numerical characters are valid names. Numerical character names, however, must be treated differently
than names that start with alphabetic characters.
When you enter a script command that requires a name, the script engine looks for a name that starts
with an alphabetic character. The script engine might not recognize the following names:
v
Names that are only numbers, such as 1 or 2
v Names that start with a number, such as 1Disk or 32logical drive
To enter a name that consists only of numerical characters so that the script engine will recognize the
name, use a combination of back slashes and double quotation marks. Here are a few examples of how
you can enter names that consist only of numerical characters or start with numerical characters:
v [\“1\”]
v [\“1Disk\”]
Firmware Compatibility Levels
Some of the script commands and the command parameters are not supported with every version of the
controller firmware. Minimum controller firmware levels are listed in “DS3000, DS4000, and DS5000
commands with minimum firmware levels” on page 3-3.
Note: For many commands, you can enable additional parameters by upgrading to a higher firmware
level than the minimum.
Hardware Requirements for Firmware Compatibility
Even though a command is supported by a storage subsystem, the feature must be installed to use the
command. For example, the Full Disk Encryption (FDE) commands are supported for all DS5000 models,
but you cannot use the command unless the FDE premium feature is installed in the storage subsystem.
Not all models in the DS3000, DS4000, or DS5000 product lines support the same set of functionality. For
example, the DS3500 series of the DS3000 product line supports Enhanced Remote Mirroring premium
features, but the DS3200, DS3300, and DS3400 models of the DS3000 product line do not. You can only
run the commands for the functions supported by your storage subsystem model.
Formatting rules for script commands
Syntax unique to a specific script command is explained in the Notes section at the end of each script
command description.
3-2
IBM System Storage DS3000, DS4000, and DS5000: Command Line Interface and Script Commands Programming Guide