IBM System Storage DS3000, Руководство по программированию

Страница: 630 / 652

include blank lines in your script files to separate blocks of commands or make a comment that stands
out. To include a comment, enter two forward slashes
(//)
, which causes the Script Engine to treat the
line as a comment.
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 Volume 7 on existing Volume Group 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 volume by using the create volume command on an existing Array.
The line beginning
//Note
: is a comment in the script file that explains that the size of the last volume
created that uses all of the available capacity because the
capacity
parameter is not used.
The command in this example creates a new volume in Array 1. The volume has RAID Level 5. The
volume 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 volume is assigned
to the controller in slot A in the controller enclosure. The segment size is set to 16. The volume has a read
ahead multiplier value of 256. The capacity of the volume is 2 GB.
The command takes this form:
create volume volumeGroup=volumeGroupNumber
userLabel=volumeName
[freeCapacityArea=freeCapacityIndexNumber]
[capacity=volumeCapacity | owner=(a | b) |
cacheReadPrefetch=(TRUE | FALSE) |
segmentSize=segmentSizeValue]
[enclosureLossProtect=(TRUE | FALSE)]
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 volume 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 volume
command ran successfully and that properties that could not be set by the create volume command are
now set.
The set volume 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 volume command by leaving a space
between the parameters, as in this example:
set volume[“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 volume by using the create volume command with user-defined drives in the
storage subsystem.
Show “Create RAID3 Volume 2 on existing Array 2”;
//This command creates the Array and the initial volume on that group.
//Note: For Arrays that use all available capacity, the last volume
B-2
IBM System Storage DS3000, DS4000, and DS5000: Command Line Interface and Script Commands Programming Guide