IBM System Storage DS3000, Programming Manual

Page: 592 / 652

The first line of text is the
show string
command. This command shows text that is bounded by double
quotation marks (“ ”) on a display monitor when the script file runs. In this example, the text
Create
RAID 5 Logical Drive 7 on existing subsystem 1
serves as a title that describes the expected results of
running this script file.
The line beginning with
//Create
is a comment that explains that the purpose of this script file is to
create a new logical drive by using the
create logicalDrive
command on an existing subsystem.
The line beginning //Note: is a comment in the script file that explains that the size of the last logical
drive created that uses all of the available capacity because the capacity parameter is not used.
The command in this example creates a new logical drive in subsystem 1. The logical drive has a RAID
level of 5. The logical drive name (user label) is 7. (Note the double quotation marks around the 7. The
double quotation marks define that the information in the double quotation marks is a label.) The new
logical drive is assigned to the controller in slot A in the controller module. The segment size is set to 16.
The logical drive has a read ahead multiplier value of 256. The capacity of the logical drive is 2 GB.
The command takes this form:
create logicalDrive subsystem= subsystemNumber userLabel= logicalDriveName
[freeCapacityArea= freeCapacityIndexNumber ] [capacity= logicalDriveCapacity
| owner=(a | b) | cacheReadPrefetch=(TRUE | FALSE) | segmentSize= segmentSizeValue ]
[enclosureLossProtect=(TRUE | FALSE)] | [dssPreAllocate = (true | false) ]
| [ securityType= (true | capable | none) ]
The general form of the command shows the optional parameters in a different sequence than the
optional parameters in the example command. You can enter optional parameters in any sequence. You
must enter the required parameters in the sequence shown in the command descriptions.
The line showing “
Setting additional attributes for logical drive 7
” is another example of using
the
show
“ string ” command. The reason for placing this command here is to tell the user that the
create
logicalDrive
command ran successfully and that properties that could not be set by the
create
logicalDrive
command are now set.
The set logicalDrive parameters are shown on separate lines. You do not need to use separate lines for
each parameter. You can enter more than one parameter with the set logicalDrive command by leaving
a space between the parameters, as in this example:
set logicalDrive[“7”] cacheFlushModifier=10 cacheWithoutBatteryEnabled=false
modificationPriority=high;
By using separate lines, you can see more clearly the parameters that you are setting and the values to
which you are setting the parameters. Blocking the parameters in this manner makes it easier to either
edit the file or copy specific parameter settings for use in another script file.
Configuration Script Example 2
This example creates a new logical drive by using the
create logicalDrive
command with user-defined
disk drives in the storage subsystem.
Show “Create RAID3 Logical Drive 2 on existing subsystem 2”;
//This command creates the subsystem and the initial logical drive on that subsystem.
//Note: For subsystems that use all available capacity, the last logical drive on
the subsystem is created using all remaining capacity by omitting the
capacity=logical drive creation parameter
create logicalDrive RAIDLevel=3 userLabel=”2” drives=[0,1 0,6 1,7 1,3 2,3 2,6]
owner=B segmentSize=16 capacity=2GB;
13-2
IBM System Storage DS3000, DS4000, and DS5000: Command Line Interface and Script Commands Programming Guide