SSF01G04

DS command line interface
© Copyright IBM Corporation 2011

Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
Unit objectives
After completing this unit, you should be able to:
• Install the DS command line interface
• Create user IDs that can be used with the GUI and the DS CLI
• Manage user ID passwords
• Install activation keys for licensed features
• Manage storage complexes and units
• Configure and manage storage facility images
• Create and delete RAID arrays, ranks, and extent pools
• Create and delete logical volumes

Topic 1: Overview

DS command line interface
• Few of functions that you can perform with the DS CLI
– Create user IDs that can be used with the GUI and the DS CLI
– Manage user ID passwords
– Install activation keys for licensed features
– Manage Storage Complexes and Units
– Configure and manage Storage Facility Images
– Create and delete RAID arrays, ranks, and extent pools
– Create and delete logical volumes
– Manage host access to volumes (through volume groups)
– Create, modify, delete, or check Copy Services configuration

DSCLI architecture (1 of 2)
• DSCLI operations are directed to the HMC/SMC
– Need compatibility and communication between DSCLI, master
console (HMC/SMC), and storage network interfaces
– HMC/SMC handles some requests locally (such as lsuser, lssi,
lssu)
– HMC/SMC passes some requests to storage (such as lsarray)
• DSCLI issues requests asynchronously

– This presents challenges for scripting
– More than one request per DSCLI command is possible
– May receive success message while work still in progress
– May receive timeout message while work still in progress
– Output of list and show commands may not represent work in
progress
DSCLI architecture (2 of 2)
SMC/HMC
Customer Browser
workstation
GUI server
DSCLI
Network
Network interface
interface client
client
Network
interface
server
Storage
network interface

Topic 2: Preinstallation considerations

Operating systems that support the DS CLI
• The DS CLI can be installed on the following operating systems:
– AIX 5.1, 5.2, 5.3, 6.1
– HP-UX 11.0, 11iv1, 11iv2, and 11iV3
– HP-True64 5.1, 5.1A
– Linux Red Hat 3.0 Advanced Server (AS) and Enterprise Server (ES), Red Hat
Enterprise Linux (RHEL) 4, RHEL 5
– SUSE 8, SUSE 9, SUSE Linux Enterprise Server (SLES) 8, SLES 9, SLES 10
– Novell Netware 5.1, 6.0, 6.5, and OES SP1
– System i i5/OS 5.3
– Sun Solaris 8, 9, and 10
– OpenVMS 7.3-1 (or newer)
– VMware ESX v3.x Console
– Windows 2000, Windows Datacenter, Windows 2003, Windows Vista, Windows
Server 2008, Windows XP, and Windows 7.
Note: The DS CLI cannot be installed on a Windows 64-bit operating

system
Upgrading your system to use DS CLI (1 of 2)
• DS CLI to DS CLI
– DS CLI installation program change to reduce many restrictions
• From the InstallShield Multiplatform installer to the InstallAnywhere installer
– Installations of multiple DS CLIs
• Using the InstallShield Multiplatform installer are not supported
• Using the InstallAnywhere installer are now supported
– With up to one DS CLI using the ISMP installer or on ESS CLI
• Copy Services CLI to DS CLI

– Copy Services CLI (ESS 2105) can be replaced with the DS CLI with changes
– The DS CLI is designed to support the following ESS750/800 features
• A Copy Services domain that is configured as part of the ESS 750 and 800
• All available Copy Services functions on the ESS 2105, including FlashCopy v2, and
PPRC v2
• ESS CLI to DS CLI

– ESS CLI (ESS 2105) cannot be replaced with the DS CLI
• Logical configuration commands for the 2105 are not supported in the DS CLI
– You must use the existing 2105 ESS CLI for this purpose

Upgrading your system to use DS CLI (2 of 2)
• As a result of now supporting multiple DS CLIs, the path is no
longer automatically added to the path statement. It must
manually be added.
• Save all customer profiles before upgrading to avoid loss.

DS CLI operational limitations
• Limitations associated with the use of the DS CLI
– Volumes in the same volume space cannot be of mixed type
• Logical subsystem (LSS), logical control unit (LCU), or address group.
– They are either fixed block (FB) or count key data (CKD)
– Logical Subsystems cannot be created using the DS CLI

• A fixed block LSS is automatically
– Created when the first fixed block volume is assigned to the LSS address space
– Deleted when the last fixed block volume is removed from an LSS address space
– If you are using the Cisco MDS 9216 Multilayer Fabric Switch
• You must not enable its write acceleration feature
– The Remote Mirror and Copy commands might fail if this feature is enabled
– A maximum of 256 volumes for each LSS can be defined
– You must not start more than 100 DS CLI sessions simultaneously
• Starting more than 100 DS CLI sessions simultaneously can result in connection
problems

Topic 3: Installation information

DS CLI: Installation concerns
• You must have installed Java 1.4.1 (1.4.2 is strongly recommended)
– The installation program checks for this requirement during installation
– The DS CLI installation CD contains Java 1.4.2
• Which you can install if your system is not equipped with this version of Java
• For an AIX installation:

– Disable the LIBPATH environment variable before you install the DS CLI
• To avoid the display of the Java Virtual Machine Not Found Error
– Enable the LIBPATH environment variable after the installation
• For a System i model installation:

– You cannot run the DS CLI installer directly on a System i model
• The installation is done remotely from a Windows platform
• Default directories:
• Windows: C:\Program Files\IBM\dscli
• AIX, HP, Linux, Sun Solaris,VMware: /opt/ibm/dscli
• iSeries: /ibm/dscli

DS CLI: Download from http://www.ibm.com
(1 of 3)

(2 of 3)

(3 of 3)

DS CLI: Select the right DSCLI version (DS8300)
2
DS8700 bundle level information
The URL for this information is different than that of the DS8100 or 8300.
http://www-01.ibm.com/support/docview.wss?uid=ssg1S4000853

DS CLI: Select the right DSCLI version

Topic 4: Installation process

DS CLI installation wizard

Accept license agreement

Set DSCLI install directory

Verify the installation

Installation success

DSCLI documentation
Read this documentation

Topic 5: Using the DS CLI application

What is new?
• The new DSCLI replaces the CSCLI and ESSCLI
• Provides new functions to dynamically create and manage

– Storage virtualization, FlashCopy, replication relationships, encryption,
and Easy TIER on the DS8700.
• DSCLI commands can be saved as script

– Which significantly reduces the time to create, edit, and verify their
content
• DSCLI commands use a consistent syntax
• All of the functions available from the GUI are also available
through the DSCLI

Command structure
• DS CLI consists of one to four types of components:
– The command name
• Specifies the task that the CLI is to perform
– Flags
• Modify the command
• They provide additional information that directs the CLI to perform the command task
in a specific way
– Flags parameter
• Provides information that is required to implement the command modification
– That is specified by a flag
– Command parameters
• Provide basic information that is necessary to perform the command task
• When a command parameter is required, it is always the last component of the
command
– It is not preceded by a flag
dscli>
dscli> mkuser
mkuser –pw
–pw SS49demo
SS49demo –group
–group admin
admin DSCLIdemo
DSCLIdemo
Command name Flag Flag parameter Command parameter

DSCLI command considerations
• Case-insensitive
– Except for nicknames
• Multiple operations on single command

– Specify multiple IDs separated by blanks
• Commas for volume group or host connections, keys, user groups
– Specify range
• IDs separated by hyphen
• Multiple ranges
– Separated by blanks
> Volume group or host connection ranges separated by commas

Command name structure
• Configuration tasks
– Creation
• mk<keyword>
– Example: mkuser, mkarray
– Modification
• ch<keyword>
– Example: chuser, charray
– Deletion
• rm<keyword>
– Example: rmuser, rmarray
• Report tasks
– Global report
• ls<keyword>
– Example: lsuser, lsarray
– Specific report
• show<keyword>
– Example: showuser <user_name>, showarray <array_ID>

User assistance
Command Description
Displays a list of all the DS CLI commands that are
help
available for use.
help –s Displays a list of commands with brief descriptions.
Displays a list of commands with their associated

help –l
syntax.
<command_name> -h
<command_name> -help Displays the reference page (man page) for the
<command_name> -? command name.
help <command_name>
help –s
Displays the brief description for the command name.
<command_name>
help –l
Displays the usage statement for the command name.
<command_name>

Three command modes for the DSCLI
• Single-shot mode:
– Use this mode if you want to issue an occasional command
• You must supply login information and the command that you want to process at the
same time
C:\...\dscli>
C:\...\dscli> dscli
dscli –hmc
–hmc 10.6.253.120
10.6.253.120 –user
–user Team7
Team7 –passwd
–passwd pwdTeam7
pwdTeam7 lsuser
lsuser
• Interactive mode:
– Use this mode to process multiple transactions
• When these transactions cannot be incorporated into a script
dscli>
dscli> lsuser
lsuser
• Script command mode:

– Use this mode if you want to use a sequence of DS CLI commands
{stor_lpar16_course}
{stor_lpar16_course} /home/root>
/home/root> rdfile/
rdfile/ SSF0demo.script
SSF0demo.script
lsuser
lsuser
lsarraysite
lsarraysite
{stor_lpar16_course}
{stor_lpar16_course} /home/root>
/home/root>
C:\...\dscli> dscli
C:\...\dscli> dscli –hmc
–hmc 10.6.253.120
10.6.253.120 –user
–user Team7
Team7 –passwd
–passwd pwdTeam7
pwdTeam7 -script
-script SSF0demo.script
SSF0demo.script

Logging into the DS CLI application
C:\Program
C:\Program Files\ibm\dscli>
Files\ibm\dscli> dscli
dscli
Enter
Enter the
the primary
primary management
management console
console IP
IP address:
address: 10.6.253.127
10.6.253.127
Enter
Enter the secondary management console IP address:
the secondary management console IP address:
Enter
Enter your
your username:
username: Team7
Team7
Enter
Enter your
your password:
password:
Date/Time:
Date/Time: April
April 29,
29, 2011
2011 4:38:05
4:38:05 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
dscli>
dscli>

DS CLI profile
• There are several options for using profile files:
– You can modify the default profile
• The default profile, dscli.profile, is installed in the profile directory with
the software
– C:\Program Files\IBM\DSCLI\profile\dscli.profile (Windows platform)
– /opt/ibm/dscli/profile/dscli.profile (UNIX and Linux platforms)
– You can make a personal default profile

• By making a copy of the system default profile as
<user_home>/dscli/profile/dscli.profile
– You can create a profile for the Storage Unit operations

• Save the profile in the user profile directory
– C:\Program Files\IBM\DSCLI\profile\SSF0demo.profile (Windows platform)
– /opt/ibm/dscli/profile/SSF0demo.profile (UNIX and Linux platforms)

Creating a DS CLI profile
• Create a file called MOP_EDUC2 with four lines you can consider
adding
## DS
DS CLI
CLI Profile
Profile
##
## Management
Management Console/Node
Console/Node IP
IP Address(es)
Address(es)
## hmc1
hmc1 and
and hmc2
hmc2 are
are equivalent
equivalent to
to –hmc1
–hmc1 and
and –hmc2
–hmc2 command
command option
option
hmc1:
hmc1: 10.6.253.127
10.6.253.127
#hmc2:
#hmc2: 127.0.0.1
127.0.0.1
##
#Default
#Default target
target Storage
Storage Image
Image ID
ID
## “devid”
“devid” and
and “remotedevid”
“remotedevid” are
are equivalent
equivalent to
to
## -dev
-dev storage_image_id
storage_image_id and
and –remotedev
–remotedev storage_image_id
storage_image_id command
command options
options
devid:
devid: IBM.2107-75BV321
IBM.2107-75BV321
#remotedevid: IBM.2107-AZ12341
#remotedevid: IBM.2107-AZ12341
##
username:
username: team12
team12 Optional
password:
password: educ4storage
educ4storage
##
Topic 6: DS8000 configuration

User accounts
• There are seven groups that the administrator can assign to a user:
– admin
• Allows access to all DS600 storage management console server service methods or all DS8000 Storage
Image resources
– op_volume
• Allows access to service methods and resources that relate to logical volumes, hosts, host ports, LSS,
and volume groups, but excluding security methods
– This user inherits all authority of the monitor user group
– op_storage
• Allows access to physical configuration services methods and resources, including Storage Complex,
storage image, rank, array, and Export Pool objects
– This user inherits all the authority of the op_copy_services and monitor user group
– op_copy_services
• Allows access to all Copy Services service methods and resources, excluding security methods
– This user inherits all the authority of the monitor user group
– Service (DS6000 only)
• Grant monitor authority, plus access to all management console server service methods and resources, such as
performing code loads and retrieving problem logs
– Monitor
• Allows access to list and show commands. It provides access to all read-only, nonsecurity management console
server service methods and resources.
– no access
• Does not access to any service method or Storage Image resources
– By default, this user group is assigned to any user account that is not associated with any other user group

User group capabilities
Capability admin op_storage op_volume op_copy_services monitor service
User account management X

Access audit log X
Power on/off storage image X X
Update storage complex/unit/storage X X
image
Warmstart storage image X X
Manage arrays, ranks, extent pools X X
I/O port configuration X X
Host, LSS, volume configuration X X X
Add/remove volume group X X X
Assign/Unassign volume group to host X X X
connection
Add/remove volumes to volume group X X X
Manage Copy Services X X X
Set copy services timeout values X X X
Update user account password X X X X X X
Query FRUs and enclosures X X X X X X
Query configuration/Copy Services X X X X X X
Query Copy Services X X X X X X
FRU and problem management X X X
Activate code load, create a new PE X X X
package
Manage storage unit IP addresses X
User account password rules
• Initial passwords expire immediately
– This applies to default user ID admin as well as to user account
created
• Password rules
– The password must meet the following criteria.
• Be 6 - 16 characters long
• Must contain 5 or more letters, and it must begin and end with a letter
• Must contain 1 or more numbers
• Cannot contain the user’s user ID
• Is case-sensitive
• By default, after 15 failed logon attempts, user account is

locked out

New user to R5: secadmin
• In R5, an encryption recovery key was introduced. This also
introduced the idea of a dual security control.
• To create a recovery key, both admin and secadmin are
needed.
– Ideally this should be two different users to keep one person from
potentially gaining access to the encrypted data.
• In R5, you will see admin now called storage admin.

New user account creation
• Command syntax
dscli>
dscli> mkuser
mkuser –pw
–pw <password>
<password> -group
-group <group_name>[,<group_name>,...]
<group_name>[,<group_name>,...] [-pol
[-pol <pol_name>]
<pol_name>]
<user_name>
<user_name>
• Creating a new user account

dscli>
dscli> mkuser
mkuser –pw
–pw SSF0demo
SSF0demo –group
–group admin
admin Elvis
Elvis
Date/Time:
Date/Time: April
April 29,
29, 2011
2011 5:18:20
5:18:20 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: --
CMUC00133I
CMUC00133I mkuser:
mkuser: User
User Elvis
Elvis successfully
successfully created.
created.
• Displaying existing user accounts

dscli>
dscli> lsuser
lsuser
Date/Time:
Date/Time: April
April 29,
29, 2011
2011 5:19:16
5:19:16 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: --
Name
Name Group
Group State
State
=======================
=======================
Admin
Admin admin
admin active
active
education
education admin
admin active
active
Elvis
Elvis admin
admin active
active
dscli>
dscli>

User account password
• Command syntax
dscli>
dscli> chuser
chuser [-pw
[-pw <new_password>]
<new_password>] [-lock]
[-lock] [-unlock]
[-unlock] [-group
[-group <group_name>[,...]]
<group_name>[,...]]
[-pol
[-pol <pol_name>]
<pol_name>] <user_name>
<user_name>
dscli>
dscli> chpass
chpass [-expire
[-expire <number>]
<number>] [-fail
[-fail <number>]
<number>] [-pol
[-pol <pol_name>]
<pol_name>]
• Managing user account password

C:\Program
C:\Program Files\ibm\dscli>
Files\ibm\dscli> dscli
dscli
Enter
Enter your
your username:
username: Elvis
Elvis
Enter
Enter your
your password:
password:
CMUC00201E
CMUC00201E :: Authentication
Authentication failure:
failure: Your
Your password
password has
has expired.
expired. Change
Change your
your password
password with
with the
the
chuser
chuser command.
command.
Date/Time:
Date/Time: April
April 29,
29, 2011
2011 5:20:16
5:20:16 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: --
dscli>
dscli>
dscli>
dscli> chuser
chuser -pw
-pw Graceland
Graceland Elvis
Elvis
Date/Time:
Date/Time: April
April 29,
29, 2011
2011 5:22:31
5:22:31 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: --
CMUC00134I
CMUC00134I chuser:
chuser: User
User Elvis
Elvis successfully
successfully modified.
modified.
dscli>
dscli>
dscli>
dscli> chpass
chpass -expire
-expire 80
80 –fail
–fail 00
Date/Time:
Date/Time: April 29, 2011 5:23:51
April 29, 2011 5:23:51 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: --
CMUC00195I
CMUC00195I chpass:
chpass: Security
Security properties
properties successfully
successfully set.
set.
dscli>
dscli>

Topic 7: Managing and activating licenses

Obtain machine serial number and signature
• Use DSCLI to obtain the machine serial number and signature
– Last seven digits of MTS field. Note: For DS8000, this is the storage unit ID, ending in 0
• Go to DSFA Web application (http://www.ibm.com/storage/dsfa)
– Create an xml file or manually write down keys.
dscli> showsi IBM.2107-75Y9111

Date/Time: April 12, 2011 4:38:37 PM CEST IBM DSCLI Version: 6.5.15.72 DS: IBM.2107-75Y9111
Name -
desc -
ID IBM.2107-75Y9111
Storage Unit IBM.2107-75Y9110
Model 941
WWNN 5005076306FFC7D7
Signature d005-caa1-fe3d-5e6f
State Online
ESSNet Enabled
Volume Group V0
os400Serial 7D7
NVS Memory 2.0 GB
Cache Memory 50.2 GB
Processor Memory 61.4 GB
MTS IBM.2421-75Y9110
numegsupported 0
ETAutoMode on
ETMonitor automode
dscli>

Apply activation keys
• To obtain your 16-digit feature activation codes
– Use DSCLI to obtain:
• Machine serial number
– Last 7 digits of MTS field. Note: For DS8000, this is the storage unit ID,
ending in 0
• Machine signature (all 16 digits)
– Go to DSFA Web application
• http://www.ibm.com/storage/dsfa
– Create an xml file or manually write down keys
• Command syntax
dscli>
dscli> applykey
applykey [-keypw
[-keypw <key>[<....>]
<key>[<....>] ]] [-file
[-file <file_name>]
<file_name>] <storage_image_ID>
<storage_image_ID>
• Applying activation keys to a DS8000

dscli>
dscli> applykey
applykey –file
–file MOP_EDUC2.xml
MOP_EDUC2.xml IBM.2107-75BV321
IBM.2107-75BV321
dscli>
dscli>

Generate a key report
• Command syntax
dscli>
dscli> lskey
lskey <storage_image_ID>
<storage_image_ID>
• Displaying the type of LMC activation keys installed of your DS8000

dscli>
dscli> lskey
lskey IBM.2107-75Y9111
IBM.2107-75Y9111
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 4:48:41
4:48:41 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Activation
Activation Key
Key Authorization
Authorization Level
Level (TB)
(TB) Scope
Scope
==========================================================================
==========================================================================
Global
Global mirror
mirror (GM)
(GM) 50.6
50.6 All
All
High
High Performance
Performance FICON
FICON for
for System
System zz (zHPF)
(zHPF) onon CKD
CKD
IBM
IBM FlashCopy
FlashCopy SESE 50.6
50.6 All
All
IBM
IBM HyperPAV
HyperPAV on
on CKD
CKD
IBM
IBM System
System Storage
Storage DS8000
DS8000 Thin
Thin Provisioning
Provisioning onon All
All
IBM
IBM System
System Storage
Storage Easy
Easy Tier
Tier on
on All
All
IBM
IBM database
database protection
protection on
on FB
FB
Metro
Metro mirror
mirror (MM)
(MM) 50.6
50.6 All
All
Metro/Global
Metro/Global mirror
mirror (MGM)
(MGM) 50.6
50.6 All
All
Operating
Operating environment
environment (OEL)
(OEL) 50.6
50.6 All
All
Parallel
Parallel access
access volumes
volumes (PAV)
(PAV) 50.6
50.6 CKD
CKD
Point
Point in
in time
time copy
copy (PTC)
(PTC) 50.6
50.6 All
All
RMZ
RMZ Resync
Resync 50.6
50.6 CKD
CKD
Remote
Remote mirror
mirror for
for z/OS
z/OS (RMZ)
(RMZ) 50.6
50.6 CKD
CKD
dscli>
dscli>

Licensing options

Topic 8: DS8000 storage configuration

DS8000 storage configuration
• Perform the storage configuration through the following
steps:
1. Install license keys
2. Create extent pools
3. Create arrays
4. Create ranks
5. Create volume groups
6. Create logical volumes
7. Set I/O ports

I/O port overview
• I/O ports
– Iwxyz (RICT)
• w= frame
– 0-2 (DS8000)
– 0 (DS6000)
• x= enclosure
– 0-3 (DS8000)
– 0-1 (DS6000)
• y= card
– 0,1,3 or 4 (DS8000)
– 0-1 (DS6000)
• z= port
– 0-3 top to bottom (DS8000 FICON/FCP)
– 0-7 top to bottom (DS8800 FICON/FCP)
– 0-3 left to right (DS6000 FICON/FCP)
– 0-1 top to bottom (DS8000 ESCON)
– I0000-I2343 (DS8000) / I0000-I2347 (DS8800)
– I0000-I0003 and I0100-I0103 (DS6000)
Set I/O ports
• Command syntax
dscli>
dscli> setioport
setioport [-dev
[-dev <storage_image_ID>]
<storage_image_ID>] [-topology
[-topology {fc-al/scsi-fcp/ficon/scsi-fcp/ficon}]
{fc-al/scsi-fcp/ficon/scsi-fcp/ficon}]
{<port_ID>
{<port_ID> [<port_ID>]/-}
[<port_ID>]/-}
• Configuring the I/O ports

dscli>
dscli> setioport
setioport -topology
-topology ficon
ficon I0000
I0000 I0002
I0002
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 4:48:41
4:48:41 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00011I
CMUC00011I setioport:
setioport: I/O
I/O Port
Port I0000
I0000 successfully
successfully configured.
configured.
CMUC00011I
CMUC00011I setioport:
setioport: I/O
I/O Port
Port I0002
I0002 successfully
successfully configured.
configured.
dscli>
dscli>

Display the I/O ports status
• Command syntax
dscli>
dscli> lsioport
lsioport [-dev
<storage_image_ID>] [-s/-l]
[-s/-l] [-type
[-type {fc/escon}]
{fc/escon}]
[-topology
[-topology {fc-al/scsi-fcp/ficon/scsi-fcp/ficon}]
{fc-al/scsi-fcp/ficon/scsi-fcp/ficon}]
[-state
[-state {online/offline/fenced/deconfigured}]
{online/offline/fenced/deconfigured}] [-metric]
[-metric] [<port_ID>
[<port_ID> [<port_ID>]/-]
[<port_ID>]/-]
• Listing the I/O ports

dscli>
dscli> lsioport
lsioport
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 4:48:41
4:48:41 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
ID
ID WWPN
WWPN State
State Type
Type topo
topo portgrp
portgrp
====================================================================
====================================================================
I0000
I0000 5005076307030348
5005076307030348 OnLine
OnLine Fibre
Fibre Channel-SW
Channel-SW FICON
FICON 00
I0001
I0001 5005076307034348
5005076307034348 OnLine
OnLine Fibre
Fibre Channel-SW
Channel-SW SCSI-FCP
SCSI-FCP 00
I0002
I0002 5005076307038348
5005076307038348 OnLine
OnLine Fibre
Fibre Channel-SW
Channel-SW FICON
FICON 00
I0003
I0003 500507630703C348 OnLine Fibre Channel-SW SCSI-FCP 00
500507630703C348 OnLine Fibre Channel-SW SCSI-FCP
.........
.........
dscli>
dscli>

Object ID considerations
• Object IDs are required as command input by DSCLI
• The following objects have IDs which are assigned in order of creation:
– Extent pool
• Prefixed with the letter P
– Array
• Prefixed with the letter A
– Rank
• Prefixed with the letter R
– Hostconnection (definition of one host bus adapter)
• Represented by a number from 0 to FFFE
– Volume group
• Prefixed with the letter V
• Some volume group IDs are reserved
• When an object is deleted

– That ID is freed up and will be used for the next object created
• LCUs, volumes, and port groups have IDs (specified by administrator)

Create an extent pool
• Command syntax
dscli>
dscli> mkextpool
mkextpool [-dev
<storage_image_ID>] -rankgrp
-rankgrp {0/1}
{0/1} -stgtype
-stgtype {fb/ckd}
{fb/ckd}
[-extentlimit
[-extentlimit {enable/disable}]
{enable/disable}] [-limit
[-limit <extent_limit_percentage>]
<extent_limit_percentage>]
[-threshold
[-threshold <extent_threshold_percentage>]
<extent_threshold_percentage>] [-virextentlimit
[-virextentlimit enable/disable]
enable/disable]
[-virlimit
[-virlimit <virtual_extent_limit_percentage>]
<virtual_extent_limit_percentage>]
[-virthreshold
[-virthreshold <virtual_extent_threshold_percentage>]
<virtual_extent_threshold_percentage>] [-encryptgrp
[-encryptgrp <encryption_group_ID>]
<encryption_group_ID>]
<extent_pool_name>
<extent_pool_name>
• Creating an extent pool managed by server 0

dscli>
dscli> mkextpool
mkextpool –rankgrp
–rankgrp 00 –stgtype
–stgtype fb
fb SSF0_Even_Pool
SSF0_Even_Pool
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:38:19
5:38:19 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00000I
CMUC00000I mkextpool:
mkextpool: Extent
Extent pool
pool P2
P2 successfully
successfully created
created
dscli>
dscli>
• Creating an extent pool managed by server 1

dscli>
dscli> mkextpool
mkextpool –rankgrp
–rankgrp 11 –stgtype
–stgtype fb
fb SSF0_Odd_Pool
SSF0_Odd_Pool
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:39:21
5:39:21 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00000I
CMUC00000I mkextpool:
mkextpool: Extent
Extent pool
pool P3
P3 successfully
created
dscli>
dscli>

Generate an extent pool report
• Command syntax
dscli>
dscli> lsextpool
lsextpool [-dev
[-s/-l] [-stgtype
[-stgtype {fb/ckd}]
{fb/ckd}] [-rankgrp
[-rankgrp {0/1}]
{0/1}]
[-encryptgrp
<encryption_group_ID>] [<extpool_ID>
[<extpool_ID> [<extentpool_ID]]
[<extentpool_ID]]
• Displaying a list of the extent pools

dscli>
dscli> lsextpool
lsextpool
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:41:49
5:41:49 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Name
Name ID
ID stgtype rankgrp status availstor (2^30B) %allocated available
stgtype rankgrp status availstor (2^30B) %allocated available reserved
reserved
===========================================================================================
===========================================================================================
Extpool_CKD0
Extpool_CKD0 P0
P0 ckd
ckd 00 below
below 1222
1222 21
21 1387
1387 00
Extpool_CKD1
Extpool_CKD1 P1
P1 ckd
ckd 11 below
below 1222
1222 21
21 1387
1387 00
SSF0_Even_Pool
SSF0_Even_Pool P2P2 fb
fb 00 below
below 1582
1582 00 1582
1582 00
SSF0_Odd_Pool
SSF0_Odd_Pool P3
P3 fb
fb 11 below
below 1582
1582 00 1582
1582 00
dscli>
dscli>
• Displaying detailed properties on an extent pool

dscli>
dscli> showextpool
showextpool P2
P2
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:44:22
5:44:22 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Name
Name SSF0_Even_Pool
SSF0_Even_Pool
ID
ID P2
P2
stgtype
stgtype fb
fb
......
......
dscli>
dscli>
Array sites commands (1 of 2)
• Command syntax
dscli>
dscli> lsarraysite
lsarraysite [-dev
[-s/-l] [-dev
[-dev <dapair_ID>]
<dapair_ID>] [-cap
[-cap <capacity>]
<capacity>]
[-array
[-array <array_ID>]
<array_ID>] [-state
[-state {assigned/unassigned/unavailable/initializing}]
{assigned/unassigned/unavailable/initializing}]
[-encrypt
[-encrypt {supported/unsupported}]
{supported/unsupported}] [<site_ID>
[<site_ID> [<site_ID>]]
[<site_ID>]]
• Displaying a list of array sites

dscli>
dscli> lsarraysite
lsarraysite
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:46:26
5:46:26 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
arsite
arsite DA
DA Pair
Pair dkcap
dkcap (10^9B)
(10^9B) State
State Array
Array
=============================================
=============================================
S1
S1 00 300.0
300.0 Assigned
Assigned A0
A0
S2
S2 00 300.0 Assigned
300.0 Assigned A1
A1
S3
S3 00 300.0
300.0 Unassigned
Unassigned --
S4
S4 00 300.0
300.0 Unassigned
Unassigned --
S5
S5 22 300.0
300.0 Unassigned
Unassigned --
S6
S6 22 300.0
300.0 Unassigned
Unassigned --
S7
S7 22 300.0
300.0 Unassigned
Unassigned --
S8
S8 22 300.0
300.0 Unassigned
Unassigned --
S9
S9 22 300.0
300.0 Unassigned
Unassigned --
S10
S10 22 300.0
300.0 Unassigned --
Unassigned
............
............
dscli>
dscli>

Array sites commands (2 of 2)
• Command syntax
dscli>
dscli> showarraysite
showarraysite [-dev
<storage_image_ID>] <arraysite_ID>
<arraysite_ID>
• Displaying a list of array sites

dscli>
dscli> showarraysite
showarraysite S3
S3
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:48:54
5:48:54 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
arsite
arsite S3
S3
DA
DA Pair
Pair 00
dkcap
dkcap (10^9B)
(10^9B) 300.0
300.0
diskrpm
diskrpm 15000
15000
State
State Unassigned
Unassigned
Array
Array --
Dkinf
Dkinf FC-AL
FC-AL
dkrate
dkrate 2.2
2.2 Gbps
Gbps
DDMSN
DDMSN
K03Ce04206AF40D,K03Ce0420665C0D,K03Ce0420B9080D,K03Ce0420BA240D,K03Ce0CD66A680D,
K03Ce04206AF40D,K03Ce0420665C0D,K03Ce0420B9080D,K03Ce0420BA240D,K03Ce0CD66A680D,
K03Ce0CD6A5040D,K03Ce0E5C5BAC0D,K03Ce0E6B04340D
K03Ce0CD6A5040D,K03Ce0E5C5BAC0D,K03Ce0E6B04340D
Spares
Spares 11
dataDDM
dataDDM 77
diskclass
diskclass ENT
ENT
encrypt
encrypt unsupported
unsupported
dscli>
dscli>

Create or delete an array
• Command syntax
dscli>
dscli> mkarray
mkarray [-dev
<storage_image_ID>] -raidtype
-raidtype {5/6/10}
{5/6/10} -arsite
-arsite <array_site>
<array_site>
{<array_site>}
{<array_site>}
dscli>
dscli> rmarray
rmarray [-dev
<storage_image_ID>] [-quiet]
[-quiet] <array_ID>[,<array_ID>]
<array_ID>[,<array_ID>]
• Creating an array
dscli>
dscli> mkarray
mkarray –raidtype
–raidtype 55 –arsite
–arsite S3
S3
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:51:08
5:51:08 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00004I
CMUC00004I mkarray:
mkarray: Array
Array A2
A2 successfully
created.
dscli>
dscli>
dscli>
dscli> mkarray
mkarray –raidtype
–raidtype 10
10 –arsite
–arsite S4
S4
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:54:02
5:54:02 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00004I
CMUC00004I mkarray:
mkarray: Array
Array A3
A3 successfully
created.
dscli>
dscli>
• Deleting an array
dscli>
dscli> rmarray
rmarray A3
A3
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:55:43
5:55:43 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00005W
CMUC00005W rmarray:
rmarray: Are
Are you
you sure
sure you
you want
want to
to delete
delete array
array a3?
a3? [y/n]:y
[y/n]:y
CMUC00006I
CMUC00006I rmarray:
rmarray: Array
Array A3
A3 successfully
successfully deleted.
deleted.
dscli>
dscli>

Generate an array report (1 of 2)
• Command syntax
dscli>
dscli> lsarray
lsarray [-dev
[-s/-l] [-state
[-state {assigned/unassigned/unavailable}]
{assigned/unassigned/unavailable}]
[-data
[-data {normal/degraded/readonly/failed/repairing/inaccessible}]
{normal/degraded/readonly/failed/repairing/inaccessible}] [-raidtype
[-raidtype {5/6/10}]
{5/6/10}]
[-dapair
[-dapair <dapair_ID>]
<dapair_ID>] [-cap
[-cap <capacity>]
<capacity>] [-rank
[-rank <rank_ID>]
<rank_ID>] [-encrypt
[-encrypt {supported/unsupported}]
{supported/unsupported}]
[<array_ID>
[<array_ID> [<array_ID>]]
[<array_ID>]]
• Displaying a list of arrays

dscli>
dscli> lsarray
lsarray
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 5:59:01
5:59:01 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Array State
Array State Data
Data RAIDtype
RAIDtype arsite Rank DA Pair DDMcap (10^9B)
arsite Rank DA Pair DDMcap (10^9B)
======================================================================
======================================================================
A0
A0 Assigned
Assigned Normal
Normal 55 (6+P+S)
(6+P+S) S1
S1 R0
R0 00 300.0
300.0
A1
A1 Assigned
Assigned Normal
Normal 55 (6+P+S)
(6+P+S) S2
S2 R1
R1 00 300.0
300.0
A2
A2 unassigned
unassigned Normal
Normal 55 (6+P+S)
(6+P+S) S3
S3 -- 00 300.0
300.0
A3
A3 unassigned
unassigned Normal
Normal 55 (6+P+S)
(6+P+S) S4
S4 -- 00 300.0
300.0
A4
A4 unassigned
unassigned Normal
Normal 55 (7+P)
(7+P) S5
S5 -- 00 300.0
300.0
A5
A5 unassigned
unassigned Normal
Normal 55 (7+P)
(7+P) S6
S6 -- 00 300.0
300.0
dscli>
dscli>

Generate an array report (2 of 2)
• Command syntax
dscli>
dscli> showarray
showarray [-dev
<storage_image_ID>] <array_ID>
<array_ID>
• Displaying detailed properties of an array

dscli>
dscli> showarray
showarray A2
A2
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:04:21
6:04:21 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Array
Array A2
A2
SN
SN AY91114DA4695FK
AY91114DA4695FK
State
State Unassigned
Unassigned
datastate
datastate Normal
Normal
RAIDtype
RAIDtype 55 (6+P+S)
(6+P+S)
arsite
arsite S3
S3
Rank
Rank --
DA
DA Pair
Pair 00
DDMcap
DDMcap (10^9B)
(10^9B) 300.0
300.0
DDMRPM
DDMRPM 15000
15000
Interface
Interface Type
Type FCAL
FCAL
interrate
interrate 2.2
2.2 Gbps
Gbps
diskclass
diskclass ENT
ENT
encrypt
encrypt unsupported
unsupported
dscli>
dscli>

Create or delete a rank
• Command syntax
dscli>
dscli> mkrank
mkrank [-dev
<storage_image_ID>] -array
-array <array_ID>
<array_ID> -stgtype
-stgtype {fb/ckd}]
{fb/ckd}]
[-encryptgpr
[-encryptgpr <encryption_group_ID>]
<encryption_group_ID>] [-wait]
[-wait] [-extpool
[-extpool <extentpool_ID>]
<extentpool_ID>]
dscli>
dscli> rmrank
rmrank [-dev
[-quiet] <rank_ID>
<rank_ID> [<rank_ID>]
[<rank_ID>]
• Creating a rank
dscli>
dscli> mkrank
mkrank –array
–array A2
A2 –stgtype
–stgtype fb
fb –extpool
–extpool P2
P2
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:12:50
6:12:50 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00007I mkrank: Rank R2 successfully created.
CMUC00007I mkrank: Rank R2 successfully created.
dscli>
dscli>
dscli>
dscli> mkrank
mkrank -array
-array A3
A3 -stgtype
-stgtype fb
fb -extpool
-extpool P3
P3
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:13:58
6:13:58 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00007I
CMUC00007I mkrank:
mkrank: Rank
Rank R3
R3 successfully
created.
dscli>
dscli>
• Deleting a rank
dscli>
dscli> rmrank
rmrank R2
R2
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:15:35
6:15:35 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00009W rmrank: Are you sure you want to delete rank R2? [y/n]:y
CMUC00009W rmrank: Are you sure you want to delete rank R2? [y/n]:y
CMUC00010I
CMUC00010I rmrank:
rmrank: Rank
Rank R2
R2 successfully
deleted. NOTE:
NOTE: The
The rank
rank might
might still
still be
be visible
visible to
to
queries
queries until
until reformatting
reformatting completes.
completes.
dscli>
dscli>

Generate a rank report (1 of 2)
• Command syntax
dscli>
dscli> lsrank
lsrank [-dev
[-s/-l] [-grp
[-grp {0/1}]
{0/1}]
[-state
[-state
{normal/unassigned/reserved/depopulating/configuring/configerr/deconfiguring/deconfigerr/conf
{normal/unassigned/reserved/depopulating/configuring/configerr/deconfiguring/deconfigerr/conf
igpending/configpendingerr/configooutofsyncerr}]
igpending/configpendingerr/configooutofsyncerr}]
[-data
[-data {normal/degraded/readonly/failed/repairing/inaccessible}]
{normal/degraded/readonly/failed/repairing/inaccessible}] [-type
[-type {5/6/10}]
{5/6/10}]
[-extpool
[-extpool <extent_pool_ID>]
<extent_pool_ID>] [-stgtype
[-stgtype {fb/ckd}]
{fb/ckd}] [-encryptgrp
<encryption_group_ID>]
[<rank_ID>
[<rank_ID> [<rank_ID>]]
[<rank_ID>]]
• Displaying a list of ranks

dscli>
dscli> lsrank
lsrank
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:23:29
6:23:29 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
ID
ID Group
Group State
State datastate
datastate Array
Array RAIDtype
RAIDtype extpoolID
extpoolID stgtype
stgtype
============================================================
============================================================
R0
R0 00 Normal
Normal Normal
Normal A0
A0 55 P0
P0 ckd
ckd
R1
R1 11 Normal
Normal Normal
Normal A1
A1 55 P1
P1 ckd
ckd
R2
R2 00 Normal
Normal Normal
Normal A2
A2 55 P2
P2 fb
fb
R3
R3 11 Normal
Normal Normal
Normal A3
A3 55 P3
P3 fb
fb
R4
R4 00 Normal
Normal Normal
Normal A4
A4 55 P2
P2 fb
fb
R5
R5 11 Normal
Normal Normal
Normal A5
A5 55 P3
P3 fb
fb
dscli>
dscli>

Generate a rank report (2 of 2)
• Command syntax
dscli>
dscli> showrank
showrank [-dev
<storage_image_ID>] [-metrics]
[-metrics] <rank_ID>
<rank_ID>
• Displaying detailed properties of a rank

dscli>
dscli> showrank
showrank R2
R2
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:24:29
6:24:29 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
ID
ID R3
R3
SN
SN --
Group
Group 11
State
State Normal
Normal
datastate
datastate Normal
Normal
Array
Array A3
A3
RAIDtype
RAIDtype 10
10
extpoolID
extpoolID P3
P3
extpoolnam
extpoolnam SSF0_Odd_Pool
SSF0_Odd_Pool
volumes
volumes --
stgtype
stgtype fb
fb
exts
exts 790
790
usedexts
usedexts 00
widearrays
widearrays 00
nararrays
nararrays 11
........
........
dscli>
dscli>

Create or delete a fixed block volume
• Command syntax
dscli>
dscli> mkfbvol
mkfbvol [-dev
<storage_image_ID>] -extpool
-extpool <extentpool_ID>
<extentpool_ID>
[-os400
[-os400 {A01/A81/A02/A82/A04/A84/A05/A85/A06/A86/A07/A87}]
{A01/A81/A02/A82/A04/A84/A05/A85/A06/A86/A07/A87}] [-type
[-type {ess/ds/blocks}]
{ess/ds/blocks}]
[-cap
[-cap <capacity>]
<capacity>] [-name
[-name <volume_name>]
<volume_name>] [-volgrp
[-volgrp <volume_group_ID>]
<volume_group_ID>] [-wait]
[-wait]
[-sam
[-sam {standard/tse}]
{standard/tse}] [-eam
[-eam {rotatevols/rotateexts}]
{rotatevols/rotateexts}] <volume_ID>
<volume_ID> [<volume_ID>]
[<volume_ID>]
dscli>
dscli> rmfbvol
rmfbvol [-dev
[-quiet] [-safe]
[-safe] <volume_ID>
<volume_ID> [<volume_ID>]
[<volume_ID>]
• Creating a fixed block volume

dscli>
dscli> mkfbvol
mkfbvol –extpool
–extpool P2
P2 –cap
–cap 20
20 –name
–name SSF0_P2_#d
SSF0_P2_#d -eam
-eam rotateexts
rotateexts E000-E005
E000-E005
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:40:17
6:40:17 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00025I
CMUC00025I mkfbvol:
mkfbvol: FB
FB volume
volume E000
E000 successfully
created
CMUC00025I
CMUC00025I mkfbvol:
mkfbvol: FB
FB volume
volume E001
E001 successfully
created
..........
..........
dscli>
dscli> mkfbvol
mkfbvol –extpool
–extpool P3
P3 –cap
–cap 20
20 –name
–name SSF0_P3_#d
SSF0_P3_#d -eam
-eam rotateexts
rotateexts E100-E104
E100-E104
Date/Time:
Date/Time: April 12, 2011 6:41:25 PM CEST IBM DSCLI Version: 6.5.15.72
April 12, 2011 6:41:25 PM CEST IBM DSCLI Version: 6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
..........
..........
• Deleting a fixed block volume

dscli>
dscli> rmfbvol
rmfbvol E005
E005
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:42:37
6:42:37 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
CMUC00027W
CMUC00027W rmfbvol:
rmfbvol: Are
Are you
you sure
sure you
you want
want to
to delete
delete FB
FB volume
volume E005?
E005? [y/n]:
[y/n]: yy
CMUC00028I
CMUC00028I rmfbvol:
rmfbvol: FB
FB volume
volume E005
E005 successfully
deleted.
dscli>
dscli>

Generate a fixed block volume report (1 of 2)
• Command syntax
dscli>
dscli> lsfbvol
lsfbvol [-dev
[-s/-l] [-datatype
[-datatype {512/520p/520u}]
{512/520p/520u}]
[-extpool
[-extpool <extpool_ID>]
<extpool_ID>] [-access
[-access {online/fenced}]
{online/fenced}] [-data
[-data {normal/not_normal}]
{normal/not_normal}]
[-config
[-config {normal/not_normal}]
{normal/not_normal}] [-lss
[-lss <lss_ID>]
<lss_ID>] [-volgrp
<volume_group_ID>]
[-sam
[-sam {standard/tse}]
{standard/tse}] [-eam
[-eam {legacy/rotatevols/rotateexts}]
{legacy/rotatevols/rotateexts}] [<volume_ID>
[<volume_ID> [<volume_ID>]]
[<volume_ID>]]
• Displaying a list of fixed block volumes

dscli>
dscli> lsfbvol
lsfbvol
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:43:01
6:43:01 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Name
Name ID
ID accsate
accsate datastate
datastate configstate
configstate deviceMTM
deviceMTM datatype
datatype extpool
extpool cap
cap (2^30B)
(2^30B)
========================================================================================
========================================================================================
SSF0_P2_E000
SSF0_P2_E000 E000
E000 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P2
P2 20.0
20.0
SSF0_P2_E001
SSF0_P2_E001 E001
E001 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P2
P2 20.0
20.0
SSF0_P2_E002
SSF0_P2_E002 E002
E002 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P2
P2 20.0
20.0
SSF0_P2_E003
SSF0_P2_E003 E003
E003 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P2
P2 20.0
20.0
SSF0_P2_E004
SSF0_P2_E004 E004
E004 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P2
P2 20.0
20.0
SSF0_P3_E100
SSF0_P3_E100 E100
E100 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P3
P3 20.0
20.0
SSF0_P3_E101
SSF0_P3_E101 E101
E101 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P3
P3 20.0
20.0
SSF0_P3_E102
SSF0_P3_E102 E102
E102 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P3
P3 20.0
20.0
SSF0_P3_E103
SSF0_P3_E103 E103
E103 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P3
P3 20.0
20.0
SSF0_P3_E104
SSF0_P3_E104 E104
E104 Online
Online Normal
Normal Normal
Normal 2107-931
2107-931 FBFB 512
512 P3
P3 20.0
20.0
dscli>
dscli>

Generate a fixed block volume report (2 of 2)
• Command syntax
dscli>
dscli> showfbvol
showfbvol [-dev
<storage_image_ID>] [-rank]
[-rank] [-metrics]
[-metrics] [-volgrp
<volume_group_ID>]
<volume_ID>
<volume_ID>
• Displaying detailed properties of a fixed block volume

dscli>
dscli> showfbvol
showfbvol E0002
E0002
Date/Time:
Date/Time: April
April 12,
12, 2011
2011 6:44:52
6:44:52 PM
PM CEST
CEST IBM
IBM DSCLI
DSCLI Version:
Version: 6.5.15.72
6.5.15.72 DS:
DS: IBM.2107-75Y9111
IBM.2107-75Y9111
Name
Name SSF0_P2_E002
SSF0_P2_E002
ID
ID E002
E002
accsate
accsate Online
Online
datastate
datastate Normal
Normal
configstate
configstate Normal
Normal
deviceMTM
deviceMTM 2107-931
2107-931
datatype
datatype FB
FB 512
512
addrgrp
addrgrp 11
extpool
extpool P2
P2
exts
exts 20
20
captype
captype DS
DS
cap
cap (2^30B)
(2^30B) 20.0
20.0
......
......
cap
cap (blocks)
(blocks) 41943040
41943040
volgrp
volgrp --
ranks
ranks 22
........
........
dscli>
dscli>
Checkpoint
1. True or False: The DS8000 is a CLI interface that must be installed on
a customer workstation.
2. True or False: The DS8000 CLI can be run online or offline.
3. True or False: The DS8000 CLI can create configuration xml files
which can be downloaded to the DS8000 subsystem and used to
configure the DS8000.
4. True or False: The DS8000 CLI supports Copy Services commands to

allow users to automate their FlashCopy or Metro Mirror copies.
5. True or False: The DS8000 CLI can be used to configure a DS8000 or

a DS6000.

Checkpoint solutions
1. True or False: The DS8000 is a CLI interface that must be installed on a customer
workstation.
The answer is true. The DSCLI is an installable package.
2. True or False: The DS8000 CLI can be run online or offline.

The answer is false. The DSCLI must access the DS8000 S-HMC to perform its functions.
3. True or False: The DS8000 CLI can create configuration xml files which can be
downloaded to the DS8000 subsystem and used to configure the DS8000.
The answer is false. The DSCLI is an installable package for the DS8000. It manages the
hardware real-time and has no offline capability. It does not allow XML files to be imported or
exported.
4. True or False: The DS8000 CLI supports Copy Services commands to allow users
to automate their FlashCopy or Metro Mirror copies.
The answer is true. The DSCLI is the primary Copy Services interface for the DS6000 or
DS8000.
5. True or False: The DS8000 CLI can be used to configure a DS8000 or a DS6000.
The answer is true. The DSCLI can be used to configure either a DS6000 or DS8000.

Unit summary
Having completed this unit, you should be able to:
• Install the DS command line interface
• Create user IDs that can be used with the GUI and the DS CLI
• Manage user ID passwords
• Install activation keys for licensed features
• Manage storage complexes and units
• Configure and manage storage facility images
• Create and delete RAID arrays, ranks, and extent pools
• Create and delete logical volumes

SSF01G04

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SSF01G04

Uploaded by

Copyright:

Available Formats

DS command line interface

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

– Manage user ID passwords

– Install activation keys for licensed features

– Manage Storage Complexes and Units

– Configure and manage Storage Facility Images

– Create and delete RAID arrays, ranks, and extent pools

– Create and delete logical volumes

– Manage host access to volumes (through volume groups)

– Create, modify, delete, or check Copy Services configuration

© Copyright IBM Corporation 2011

• DSCLI issues requests asynchronously

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

Note: The DS CLI cannot be installed on a Windows 64-bit operating

• Copy Services CLI to DS CLI

• ESS CLI to DS CLI

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

– Logical Subsystems cannot be created using the DS CLI

– A maximum of 256 volumes for each LSS can be defined

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

• For an AIX installation:

• For a System i model installation:

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

Read this documentation

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

• Provides new functions to dynamically create and manage

• DSCLI commands can be saved as script

• DSCLI commands use a consistent syntax

© Copyright IBM Corporation 2011

Command name Flag Flag parameter Command parameter

© Copyright IBM Corporation 2011

• Multiple operations on single command

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

help –s Displays a list of commands with brief descriptions.

Displays a list of commands with their associated

© Copyright IBM Corporation 2011

• Script command mode:

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

– You can make a personal default profile

– You can create a profile for the Storage Unit operations

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

© Copyright IBM Corporation 2011

User account management X

• By default, after 15 failed logon attempts, user account is