Ibm Ds8000 Cli
Ibm Ds8000 Cli
Version 7 Release 0
GC27-4212-00
GC27-4212-00
Note: Before using this information and the product it supports, read the information in Notices.
This edition replaces GC53-1127-07 and all previous versions of SC26-7916. Copyright IBM Corporation 2006, 2012. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Safety and Environmental notices . . . vii
Safety notices . . . . . . . . . . . . . vii Environmental notices . . . . . . . . . . viii DS CLI operational limitations . . . . . . Messages in the CLI and management console server . . . . . . . . . . . . . . . . . 44 . 45
. . . . . . .
. 37 . 38 . 39 . 40 . 41 . 41 . 42
iii
rmreckey . . . . . . . . . . . . . showkeygrp . . . . . . . . . . . . Physical resource information commands . . . lsda . . . . . . . . . . . . . . lsframe . . . . . . . . . . . . . lsstgencl . . . . . . . . . . . . . lshba . . . . . . . . . . . . . . lsddm . . . . . . . . . . . . . . Storage complex configuration commands . . . chsp . . . . . . . . . . . . . . setvpn . . . . . . . . . . . . . . lsvpn . . . . . . . . . . . . . . showsp . . . . . . . . . . . . . Storage unit configuration commands . . . . chsu . . . . . . . . . . . . . . lssu. . . . . . . . . . . . . . . showsu . . . . . . . . . . . . . Storage image configuration commands . . . chsi. . . . . . . . . . . . . . . diagsi . . . . . . . . . . . . . . lsserver . . . . . . . . . . . . . lssi . . . . . . . . . . . . . . . showsi . . . . . . . . . . . . . I/O port and host connection configuration commands . . . . . . . . . . . . . Storage image I/O port commands . . . . Host connection commands . . . . . . Storage configuration commands . . . . . . Array site specific commands . . . . . . Array specific commands . . . . . . . Rank specific commands . . . . . . . Extent pool specific commands . . . . . Address group specific commands . . . . Logical control unit specific commands. . . CKD logical volume specific commands . . Logical subsystem specific commands . . . Fixed block logical volume specific commands Volume group specific commands . . . . Advanced operation commands . . . . . Space-efficient storage commands . . . . I/O Priority Management commands . . . . lsperfgrp . . . . . . . . . . . . . lsperfgrprpt . . . . . . . . . . . . lsperfrescrpt . . . . . . . . . . . . Resource Group commands . . . . . . . chresgrp . . . . . . . . . . . . . lsresgrp . . . . . . . . . . . . . manageresgrp . . . . . . . . . . . mkresgrp . . . . . . . . . . . . . rmresgrp . . . . . . . . . . . . . showresgrp . . . . . . . . . . . . Copy Services commands . . . . . . . . FlashCopy commands . . . . . . . . Remote FlashCopy commands. . . . . . Remote Mirror and Copy path commands . . Remote Mirror and Copy pair commands . . Global Mirror commands . . . . . . . Global Mirror session commands . . . . . Offload file commands . . . . . . . . . offloadauditlog . . . . . . . . . . . offloadfile . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
107 108 109 110 112 113 117 118 122 122 124 125 126 128 128 129 131 133 134 135 136 138 140 143 143 156 176 176 181 189 201 214 216 225 254 258 288 298 301 317 318 319 322 323 324 324 326 329 330 331 332 333 354 373 385 413 430 437 438 441
483
iv
FlashCopy functions . . . . . . . . . . . Creating a FlashCopy relationship . . . . . Creating a persistent FlashCopy relationship Viewing information about FlashCopy relationships. . . . . . . . . . . . . Deleting FlashCopy relationships . . . . . . Creating remote FlashCopy transactions . . . Resynchronizing FlashCopy relationships . . . Reversing a FlashCopy relationship . . . . . Applying the FlashCopy revertible option to existing FlashCopy relationships . . . . . . Starting a background copy of a FlashCopy relationship . . . . . . . . . . . . . Preventing write operations on FlashCopy target volumes . . . . . . . . . . . . . . Creating a FlashCopy target volume on an existing Metro Mirror source volume . . . . Discarding changes to FlashCopy target volumes . . . . . . . . . . . . . . Committing data to FlashCopy target volumes Metro Mirror functions . . . . . . . . . . Displaying the status of established paths . . . Displaying the WWNN of a storage unit . . . Creating remote mirror and copy paths. . . . Correcting a path-related configuration error Removing paths . . . . . . . . . . . Creating a Metro Mirror relationship . . . . Creating a Metro Mirror consistency group . . Resuming a Metro Mirror relationship . . . . Pausing a Metro Mirror relationship . . . . . Creating a Global Copy relationship . . . . . Deleting a Metro Mirror relationship . . . . Modifying logical subsystem timeout values . . Defining a path that has the consistency option enabled . . . . . . . . . . . . . . Monitoring Remote Mirror and Copy paths . . Performing a failback recovery operation . . . Performing a failover recovery operation . . . Viewing information about Metro Mirror relationships. . . . . . . . . . . . . Converting Global Copy volume pairs to synchronous. . . . . . . . . . . . . Determining which I/O ports are available for paths . . . . . . . . . . . . . . . Deleting a single volume Metro Mirror relationship . . . . . . . . . . . . . Copy Services functions across a 2105 and DS8000 or DS6000 model . . . . . . . . Creating a Metro Mirror volume pair between a DS8000 model or a DS6000 model and a 2105 . Global Mirror functions . . . . . . . . . . Adding volumes to a session (Global Mirror) Modifying the tuning parameters of a Global Mirror session . . . . . . . . . . . . Modifying the topology of a Global Mirror session . . . . . . . . . . . . . . Viewing a Global Mirror session . . . . . . Querying Global Mirror processing . . . . . Pausing Global Mirror processing . . . . . Resuming Global Mirror processing . . . . . Starting Global Mirror processing . . . . .
483 483 484 484 485 486 488 488 489 490 491 492 493 494 495 495 495 496 497 498 499 500 501 502 502 503 504 507 508 508 509 510 510 511 512 513 513 516 516 517 518 520 520 521 521 522
Ending Global Mirror processing (script mode) 523 Ending Global Mirror processing (no script) . . 523 Setting up the Global Mirror Environment. . . 524 Removing a Global Mirror environment . . . 529
Chapter 8. Recovery scenarios for planned and unplanned outages using Metro/Global Mirror . . . . . . . . . 557
Setting up a Metro/Global Mirror environment . . Failover and restore operations to the intermediate site during a planned outage . . . . . . . . Failover and restore operations to the intermediate site during an unplanned outage . . . . . . . Failover and restore operations at the remote site during a planned outage . . . . . . . . . Failover and restore operations at the remote site during an unplanned outage . . . . . . . . Using forced failover and failback during a planned Metro/Global Mirror outage . . . . . Using forced failover and failback during an unplanned Metro/Global Mirror outage . . . . Discarding changes or committing changes to consistency groups . . . . . . . . . . . Recovery scenario using incremental resynchronization in a Metro/Global Mirror configuration . . . . . . . . . . . . 557 561 567 571 578 589 599 610
611
Modifying fixed block volume groups . . . . . Deleting data storage configurations. . . . . . Deleting a fixed block data storage configuration . . . . . . . . . . . . Deleting a count key data storage configuration Processing remote FlashCopy (inband) transactions Metro Mirror test scenario: failback operation from local to remote site . . . . . . . . . . . Allowed remote mirror and copy volume pair conversions . . . . . . . . . . . . . . Resource Groups . . . . . . . . . . . . Using Resource Groups . . . . . . . . .
Appendix A. Accessibility . . . . . . 637 Appendix B. Archived CLI Information 639 Notices . . . . . . . . . . . . . . 641
Trademarks . . . . . . . . . . . . . . 642
Electronic emission notices . . . . . . . . . Federal Communications Commission statement Industry Canada compliance statement . . . . European Union Electromagnetic Compatibility Directive . . . . . . . . . . . . . . Japanese Voluntary Control Council for Interference (VCCI) class A statement . . . . Japanese Electronics and Information Technology Industries Association (JEITA) statement. . . . . . . . . . . . . . Korea Communications Commission (KCC) Electromagnetic Interference (EMI) Statement. . Russia Electromagnetic Interference (EMI) Class A Statement . . . . . . . . . . . . . Taiwan Class A compliance statement . . . . Taiwan contact information. . . . . . . . .
Index . . . . . . . . . . . . . . . 647
vi
Safety notices
Observe the safety notices when using this product. These safety notices contain danger and caution notices. These notices are sometimes accompanied by symbols that represent the severity of the safety condition. Most danger or caution notices contain a reference number (Dxxx or Cxxx). Use the reference number to check the translation in the IBM System Storage DS8000 Safety Notices, P/N 98Y1543. The sections that follow define each type of safety notice and give examples.
Danger notice
A danger notice calls attention to a situation that is potentially lethal or extremely hazardous to people. A lightning bolt symbol always accompanies a danger notice to represent a dangerous electrical condition. A sample danger notice follows:
DANGER: An electrical outlet that is not correctly wired could place hazardous voltage on metal parts of the system or the devices that attach to the system. It is the responsibility of the customer to ensure that the outlet is correctly wired and grounded to prevent an electrical shock. (D004)
Caution notice
A caution notice calls attention to a situation that is potentially hazardous to people because of some existing condition, or to a potentially dangerous situation that might develop because of some unsafe practice. A caution notice can be accompanied by one of several symbols:
If the symbol is... It means... A generally hazardous condition not represented by other safety symbols.
This product contains a Class II laser. Do not stare into the beam. (C029) Laser symbols are always accompanied by the classification of the laser as defined by the U. S. Department of Health and Human Services (for example, Class I, Class II, and so forth). A hazardous condition due to mechanical movement in or around the product.
vii
It means... This part or unit is heavy but has a weight smaller than 18 kg (39.7 lb). Use care when lifting, removing, or installing this part or unit. (C008)
Sample caution notices follow: Caution The battery is a lithium ion battery. To avoid possible explosion, do not burn. Exchange only with the IBM-approved part. Recycle or discard the battery as instructed by local regulations. In the United States, IBM has a process for the collection of this battery. For information, call 1-800-426-4333. Have the IBM part number for the battery unit available when you call. (C007) Caution The system contains circuit cards, assemblies, or both that contain lead solder. To avoid the release of lead (Pb) into the environment, do not burn. Discard the circuit card as instructed by local regulations. (C014) Caution When removing the Modular Refrigeration Unit (MRU), immediately remove any oil residue from the MRU support shelf, floor, and any other area to prevent injuries because of slips or falls. Do not use refrigerant lines or connectors to lift, move, or remove the MRU. Use handholds as instructed by service procedures. (C016) Caution Do not connect an IBM control unit directly to a public optical network. The customer must use an additional connectivity device between an IBM control unit optical adapter (that is, fibre, ESCON, FICON) and an external public network . Use a device such as a patch panel, a router, or a switch. You do not need an additional connectivity device for optical fibre connectivity that does not pass through a public network.
Environmental notices
The environmental notices that apply to this product are provided in the Environmental Notices and User Guide, Z125-5823-xx manual. A copy of this manual is located on the publications CD.
viii
Summary of changes
| This document contains terminology, maintenance, and editorial changes for version GC27-4212-00 of the IBM System Storage DS Command-Line Interface User's Guide. Technical changes or additions to the text and illustrations are indicated by a vertical line to the left of the change.
Changed information
| v Documentation of Easy Tier default settings in the DS Storage Manager was updated. | v The default setting for I/O Priority Manager is now Disabled. v The following commands have been updated for this release: mkfbvol command - Added new parameter (-t10dif) to the syntax. | | | | | | | mkuser command - Character limit enforced on username. Additional note added pertaining to enclosing password in quotes. lsflash command - Added new parameter (-dataset) to the syntax. pausegmir command - Added new parameter (-withsecondary) to the syntax. showgmir command - Two new copy states added Paused with Secondary Consistency and Paused because Resume Failed. reverseflash command - Modified the default copy behavior when used with both the -tgtse and -fast parameters. lspprc command - Added new Suspended state reason codes to the report definitions.
Deleted Information
| | | | | | | The following information has been removed for this release: v Removed the Java 1.4.2 packages from the installation CD. These packages were previously included, although never required. You may acquire these packages from older DS CLI installation CDs at: ftp://ftp.software.ibm.com/storage/ds8000/updates/DS8K_Customer_Download_Files/CLI/ The DS CLI installation CD previously contained the following Java packages: \IMAGES\HMC\IBMJava2-JRE-1.4.2-0.0.i386.rpm \IMAGES\HMC\ibm-java2-jre-142.exe \IMAGES\HMC\jre14-20040626.tar.gz v Removed the following deprecated commands and older reference information from this publication. This information is now available in the Archived CLI Information section of the IBM System Storage DS8000 Information Center. DS6000 remote support and notification commands (setplex, showplex, setdialhome, setsmtp, setsnmp, setsim, setcontactinfo, showcontactinfo, and testcallhome) DS6000 PE package commands (offloadss, mkpe, sendss, sendpe, lsss, and lspe) DS6000 problem log commands (closeproblem, and lsproblem) setoutput command The Command equivalents topic. The Output field descriptions topic. The Configuring the DS8000 (using DS CLI) for use with the Tivoli Storage Productivity Center Replication Manager topic. Instructions for installing the DS CLI on an OpenVMS system.
ix
v IBM Tivoli Storage Productivity for Replication Manager. The Tivoli Storage Productivity for Replication Manager facilitates the use and management of Copy Services functions such as the remote mirror and copy functions (Metro Mirror and Global Mirror) and the point-in-time function (FlashCopy). Note: For DS8000, you can have a maximum of 256 clients connected to a single storage unit server at the same time. Clients include all DS Storage Managers, DS command-line interfaces, DS open application interfaces, and IBM Tivoli Storage Productivity Center for Replication sessions. However, you must not simultaneously start more than 100 client sessions including DS CLI sessions. Starting more than 100 sessions simultaneously can result in connection problems. To learn additional information about the DS8000 series: v See the IBM System Storage DS8000 Introduction and Planning Guide. v View the DS8000 Information Center, which is an information database that provides you with the opportunity to quickly familiarize yourself with the major aspects of the DS8000 series and to easily recognize the topics for which you might require more information. Because the information is all in one place rather than across multiple publications, you can access the information that you need more efficiently and effectively. For the latest version of the online Information Center, go to the IBM System Storage DS8000 Information Center. v View the e-Learning modules that are available from the DS Storage Manager Welcome page or the DS8000 Information Center. The e-Learning modules provide animated presentations that describe the installation, configuration, management, and servicing of the DS8000 series.
Linux (Red Hat 3.0 Advanced Server [AS] and Enterprise IMAGES\HMC\Disk1\InstData\Linux\NoVM\ Server [ES]), RHEL 4, RHEL 5 dsclisetup.bin Note: See the additional instructions following this table. SUSE Linux SLES 8, SLES 9, SUSE 8, SUSE 9, SLES10 IMAGES\HMC\Disk1\InstData\Linux\NoVM\ Note: See the additional instructions following this table. dsclisetup.bin Sun Solaris (7, 8, 9) HP Tru64 (5.1, 5.1A) Novell NetWare 6.5 System i i5/OS 5.3 IMAGES\HMC\Disk1\InstData\Solaris\NoVM\ dsclisetup.bin IMAGES\HMC\Disk1\InstData\HPUX\NoVM\ dsclisetup.bin IMAGES\HMC\Disk1\InstData\Windows\NoVM\ dsclisetup.exe IMAGES\HMC\Disk1\InstData\Windows\NoVM\ dsclisetup.exe
Installation file location See the Archived CLI Information section of the IBM System Storage DS8000 Information Center for information on how to install, use, and remove the DS command-line interface in an OpenVMS environment. IMAGES\HMC\Disk1\InstData\Linux\NoVM\ dsclisetup.bin IMAGES\HMC\Disk1\InstData\Windows\NoVM\ dsclisetup.exe
| | | |
VMware ESX v3.0.1 Console Windows 2000, Windows Datacenter, Windows 2003, Windows Vista, Windows Server 2008, Windows XP, and Windows 7.
| |
v You must have installed Java 1.4.1 or later on your system. The installation program checks for this requirement during installation and does not install the DS CLI if you do not have Java 1.4.1 or later. v For an AIX installation: The LIBPATH environment variable can interfere with the installation of the DS CLI and can result in the display of the Java Virtual Machine Not Found Error. To avoid this interference, you must disable the LIBPATH environment variable before you install the DS CLI. After the installation of the DS CLI, you must enable the LIBPATH environment variable so that it can be used with other applications. Run the following commands to sequentially disable the LIBPATH environment variable, install the DS CLI, and restore the LIBPATH environment variable:
export LIBSAVE=$LIBPATH unset LIBPATH AIX/NoVM/dsclisetup.bin LAX_VM /opt/ibm-Java-whatever/java/bin/java export LIBPATH=$LIBSAVE unset LIBSAVE
v For a System i model installation: Note: The installation of DS CLI on a System i model is done remotely from a Windows platform. You cannot run the DS CLI installer directly on a System i model. The System i model and i5/OS must meet the following requirements before the DS CLI can be installed: Prerequisites: - The latest Java group program temporary fixes (PTF) - i5/OS 5722-SS1 option 34 - Digital certificate manager - Licensed product 5722-AC3 option *base - Crypto Access Provider 128 bit - Licensed product i5/OS 5722-DG1option *base - IBM HTTP Server - Licensed product 5722-JV1 options 6 - Java Developer Kit 1.4 - The latest cumulative PTF package that is installed on the i5/OS If you are installing onto a System i model, ensure that the workstation that you are installing from is network-attached to the iSeries server. During the installation of the DS CLI onto a System i model, you must provide the following information: - The name of the iSeries server to which you are installing the DS CLI. - The user name and password that is used to access the designated iSeries server. When you install onto a System i model, a _uninst folder is created on the Windows desktop. Save this folder for uninstallation in the future. v The installation process installs the DS CLI in the following default directories: AIX /opt/ibm/dscli
HPUX /opt/ibm/dscli
Chapter 2. Installing, upgrading, and removing the DS CLI
Linux /opt/ibm/dscli Sun Solaris /opt/ibm/dscli Windows C:\Program Files\IBM\dscli HP Tru64 UNIX /opt/ibm/dscli iSeries /ibm/dscli VMware /opt/ibm/dscli Novell NetWare SYS:\IBM\dscli v Regardless of the operating system and DS series that you use, you must activate your license activation codes (part of the DS Storage Manager post-installation instructions) before you can use the CLI commands that are associated with Copy Services functions.
Create a file system for the CD-ROM by issuing the following command:
crfs -v cdrfs -p ro -d cd0 -m /cdrom
where cd0 represents the CD-ROM drive. Mount the CD-ROM file system by issuing the following command:
mount /cdrom
HPUX Mount the CD-ROM file system using the path name for your environment by issuing the following commands:
ioscan -funC disk | more mount /dev/dsk/c?t?d? /<cdrom>
Note: The device name /dev/dsk/c0t6d0s2 is the default name for Sun Solaris. The device name might be different on your system depending on your hardware configuration. Windows You are not required to mount the CD if you are using this operating system. HP Tru64 UNIX Issue the following command:
mount -t cdfs -o noversion /dev/rznn /mnt
where nn represents the number of CD-ROM drives. Novell NetWare You are not required to mount the CD if you are using this operating system. 4. Navigate to your CD drive and proceed with either the unattended (silent), console, or graphic installation.
Procedure
1. Start the setup file that is appropriate for your operating system. You can find the setup file on the installation CD by navigating to IMAGES\HMC\Disk1\InstData, and then selecting your platform to find the appropriate setup file. For example, in Windows the path would be IMAGES\HMC\Disk1\ InstData\Windows\NoVM\dsclisetup.exe. The Introduction window is displayed. Initially (for all types of installation), the DS CLI installer checks your standard directories for the correct version of Java. If the correct version of Java is not found, you receive one of the following messages: v If you are using Windows, the following message is displayed:
LaunchAnywhere Error: Could not find a valid Java virtual machine to load. You may need to reinstall a supported Java virtual machine.
The manner in which you respond to this message depends on your operating system and your installation environment settings. If the installation fails because the correct version of Java is not found, see Correcting the Java Virtual Machine Not Found Error on page 15. 2. Click Next on the Introduction window to continue or Cancel to exit the installation. When you click Next the License Agreement window is displayed. 3. Select I accept the terms of the License Agreement and click Next to continue. Select I do not accept the terms of the License Agreement and Cancel to exit the installation. In Windows, when you accept the agreement and click Next, the Select Target System window is displayed (See Step 4. Otherwise proceed to step 5 on page 9. 4. (Windows, Novell NetWare, or OS/400 installation) Select the target system (Windows, Novell NetWare, or OS/400) where you want the DS CLI installed, and then click Next to continue or Cancel to exit the installation. a. Select Windows as your target system for all systems except Novell NetWare and OS/400. When you select Windows and click Next, the Choose Install Folder window is displayed. b. When you select Novell NetWare and click Next, the Novell Location window is displayed. Go to Step 6 on page 9 to continue the installation.
c. When you select OS/400 and click Next, the OS/400 System Information window is displayed. Go to Step 7 to continue the installation process. 5. Verify that the directory name that is shown in the Choose Install Folder window is the directory where you want to install the DS CLI. If it is not the correct directory, enter the directory path in the input field. Click Next to continue the installation. Click Cancel to exit the installation. When you click Next to continue the installation, the Pre-Installation Summary window is displayed. Go to Step 8 to continue the installation process. Note: If you are installing onto a System i system, a window that asks for the directory where Java is installed on the i5/OS is displayed when you click Next. Go to Step 7 to continue the installation process. 6. (Novell NetWare installation) When you select Novell NetWare and click Next, the Choose Install Folder window is displayed. Click Next to continue. Complete the information on the Set Novell NetWare Configuration window. You are asked to supply the location where the Windows drive is mapped and where the Java home directory that contains the version of Java you want to use is located. Click Next to continue the installation. Click Cancel if you want to exit the installation. When you click Next to continue the installation, the Pre-Installation Summary window is displayed. Go to Step 8 to continue the installation process. 7. (OS400 installation) On the OS/400 System Information window, confirm that any previous versions of the CLI have been uninstalled and then click Next. On the Enter Sign On Credentials window, enter the iSeries system name, user name, and password. Click Next to continue. The Pre-Installation Summary window is displayed. Go to Step 8 to continue the installation process. 8. (Pre-Installation Summary window) Verify that the displayed information is accurate. This window provides the location where the command-line interface will be installed and specifies how much space it will occupy on your drive. Click Install to continue or Cancel to exit the installation. You can change the installation directory by clicking the Previous button. When you click Install to continue the installation process, the Installation progress window is displayed. 9. (Installation progress window) This window provides the progress bar that reflects the progress of the installation as the files are installed. After the installation is complete, click Next to continue or Cancel to exit the installation. When you click Next to continue the installation process, the Important Information window is displayed. 10. (Important Information window) This window provides you with the opportunity to read the README file. Click Done to complete the installation.
What to do next
Notes: 1. The DS CLI is installed in the following two places in i5/OS: v IFS directory IBM/DS_CLI. This directory contains the profiles, .EXE files, Java .JAR files, readme files, and so on. v The QDSCLI library. This library contains executable code. Note: Beginning in Version 6 Release 1, the QDSCLI library output is stored in the output file that you specified in the DS CLI. Errors will be stored in a file of the same name with .error appended to it. If you have programmed anything using the output, you should update your programs to look in both the specified file and the .error file to get a complete view of the results. 2. Before you can start the DS CLI from the i5/OS, you must add the QDSCLI library to the i5/OS library list.
3. You can check the following directories to verify that the DS CLI has been installed for your operating system: AIX /opt/ibm/dscli
HPUX /opt/ibm/dscli Linux /opt/ibm/dscli Sun Solaris /opt/ibm/dscli Windows C:\Program Files\IBM\dscli HP Tru64 UNIX /opt/ibm/dscli iSeries /ibm/dscli Novell NetWare SYS:\IBM\dscli
Procedure
1. Insert the DS CLI Installation CD into the CD drive. 2. Open a command prompt and navigate to the location of the dsclisetup file on the DS CLI CD. You can find the setup file by navigating to IMAGES\HMC\Disk1\InstData, and then selecting your platform to find the appropriate setup file. For example, in Windows the path would be IMAGES\HMC\Disk1\InstData\Windows\NoVM\dsclisetup.exe.
10
3. Type the following command on the command line: dsclisetup<.exe | .bin> -i console. For example, for Windows, type: dsclisetup.exe -i console or, for Linux, type: dsclisetup.bin -i console. For an installation onto an OS/400 system from a Windows operating system, type: setupwin32console.exe -os400. The Introduction screen is displayed. Notes: a. You can use the -i parameter to specify any user interface mode when installing the DS CLI: -i [swing | console | silent]. The default mode for installing Windows is swing. The default for UNIX and Linux is console mode. You do not have to specify the mode in the command unless you want to use something other than the default mode. b. While in console mode, you can type back to return to the previous screen, or quit to exit the installation.
Preparing CONSOLE Mode Installation... ========================================================== IBM System Storage DS Command Line Interface(created with InstallAnywhere by Macrovision) ------------------------------------------------------------
=========================================================== Introduction -----------InstallAnywhere will guide you through the installation of IBM System Storage DS Command Line Interface. It is strongly recommended that you quit all programs before continuing with this installation. Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type back. You may cancel this installation at any time by typing quit. PRESS <ENTER> TO CONTINUE:
5. Type Y and press Enter to accept the terms of the license agreement. If you are running the installer on Windows, the Select Target System screen is displayed.
11
Select Target System -------------------Please select the appropriate target system: ->1- Windows 2- Novell NetWare ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS ENTER TO ACCEPT THE DEFAULT:
6.
If you are installing on a Windows operating system, type 1. If you are installing on a Novell NetWare operating system, type 2. Press Enter if you want to select the default operating system, or press Enter after you have typed in your selection. The Choose Install Folder screen is displayed.
Choose Install Folder --------------------Where would you like to install? Default Install Folder: C:\Program Files\IBM\dscli ENTER AN ABSOLUTE PATH, OR PRESS ENTER TO ACCEPT THE DEFAULT :
7. Enter the path where you would like to install the DS CLI, or press Enter to accept the default location. The confirmation message below is displayed.
INSTALL FOLDER IS: C:\Program Files\IBM\dscli IS THIS CORRECT? (Y/N):
8. Type Y and press Enter to continue installing the DS CLI in the specified location. Type N and press Enter to change the location. Type Y to confirm that the location is correct, and press Enter. a. If you are installing on Windows, the Pre-Installation Summary window is displayed.
Pre-Installation Summary -----------------------Please Review the Following Before Continuing: Product Name: IBM System Storage DS Command Line Interface Install Folder: C:\Program Files\IBM\dscli Disk Space Information (for Installation Target): Required: 28,988,352 bytes Available: 80,796,971,008 bytes PRESS ENTER TO CONTINUE:
b. If you are installing the CLI on a Novell NetWare system, the Set Novell NetWare Configuration window is displayed. Enter the Novell location where the Windows drive is installed and press Enter. The Set Novell NetWare Configuration screen is displayed. Enter the location of the JAVA directory that you would like to use and press Enter. The Pre-Installation Summary screen is displayed.
12
==================================================== Set Novell NetWare Configuration -------------------------------Please indicate the Novell location: Novell location(volume:directory) (DEFAULT: SYS:):
=============================================================================== Installation Result ------------------Congratulations. IBM System Storage DS Command Line Interface has been successfully installed to: C:\Program Files\IBM\dscli PRESS <ENTER> TO CONTINUE:
10. Press Enter to continue. Important information about the README file is displayed.
Important Information --------------------Please read the information below. IBM(R) System Storage(R) DS Command Line Interface for Microsoft(R) Windows 2000(R), Windows 2003(R) Host Systems README --------------------------------------------------------Contents 1.0 1.1 1.2 2.0 3.0 4.0 5.0 About this README file Who should read this README file Help contacts Where to find more information Contents of Windows CLI package Notices Trademarks and service marks
This README file tells you where to find user information about the IBM System Storage DS Command Line Interface (CLI) Users Guide and lists PRESS <ENTER> TO CONTINUE:
11. Press Enter to continue reading until you reach the end of the important information. When you finish reading the important information, the CLI installation is complete.
13
Procedure
1. Log on to your system as an administrator. 2. Insert the DS CLI installation CD into the CD drive. 3. Open a command prompt and navigate to the location of the dsclisetup file on the DS CLI CD. You can find the setup file by navigating to IMAGES\HMC\Disk1\InstData, and then selecting your platform to find the appropriate setup file. For example, in Windows the path would be IMAGES\HMC\Disk1\InstData\Windows\NoVM\dsclisetup.exe. 4. Type the following command at the command prompt: dsclisetup.exe -i silent. Press the Enter key on your keyboard to start the installation process in unattended (silent) mode. The silent installation process applies all the default options to your installation. If you want to modify the default options, go to the next step. Note: Initially the DS CLI installer checks your standard directories for the correct version of Java. If the correct version of Java is not found, you receive the following message: v If you are using Windows, the following message is displayed:
LaunchAnywhere Error: Could not find a valid Java virtual machine to load. You may need to reinstall a supported Java virtual machine.
If you receive this message, see Correcting the Java Virtual Machine Not Found Error on page 15. 5. Optionally, you can generate a configuration file in a non-silent mode, then use this file in subsequent silent installs. For example:
14
a. Execute the following command to install a sample instance of dscli. dsclisetup.exe -r "c:\install.properties" The resulting file, install.properties, will contain all of the install settings. b. Modify the settings in install.properties if needed. c. You can use this generated configuration file in silent installs with the following command: dsclisetup.exe -i silent -f "c:\install.properties"
After ensuring that Java 1.4.1 or higher is installed, perform one of the following actions to correct the Java Virtual Machine Not Found error: v Run the DS CLI installer again from the console, and provide the path to the JVM using the LAX_VM option. The following examples represent paths to the correct version of Java: For a Windows system, specify the following path:
dsclisetup.exe LAX_VM "C:\Program Files\java-whatever\jre\bin\java.exe"
Note: Because there is a space in the Program Files directory name, you are required to add quotes around the file name. For a UNIX or Linux system, specify the following path:
dsclisetup.bin LAX_VM /opt/ibm-Java-whatever/java/bin/java
Note: If you use this argument, the installer attempts to use whatever JVM that you specify. You must use a supported version. Continue with the installation of the DS CLI. v (For UNIX or Linux) Add the Java virtual machine location to your PATH environment variable by running the following command:
export PATH=$PATH:/opt/ibm-Java-whatever/java/bin
Chapter 2. Installing, upgrading, and removing the DS CLI
15
Then, run the dsclisetup.bin program to install the DS CLI. v (AIX only) Run the following commands to sequentially disable the LIBPATH environment variable, install the DS CLI, and restore the LIBPATH environment variable:
export LIBSAVE=$LIBPATH unset LIBPATH dsclisetup.bin LAX_VM/opt/ibm-Java-whatever/java/bin/java export LIBPATH=$LIBSAVE unset LIBSAVE
16
The Copy Services CLI that came with the ESS 2105 can be replaced with the DS CLI with changes. The DS CLI is designed to support the following features that exist on the IBM TotalStorage Enterprise Storage Server Models 750 and 800: v A Copy Services domain that is configured as part of the IBM TotalStorage Enterprise Storage Server Models 750 and 800 v All available Copy Services functions on the ESS 2105, including FlashCopy Version 2 and PPRC Version 2 licenses However, the DS CLI is not designed to support the Copy Services CLI scripts that you have written for the ESS 2105. You must modify these scripts or write new ones to accommodate the upgrade. Keep the following considerations in mind: v Individual Copy Services tasks in the Copy Services CLI are replaced by individual DS CLI commands. Saving a DS CLI command to a shell script is the equivalent of saving a 2105 Copy Services task. v Grouped Copy Services tasks can be replaced by built-in DS CLI scripts that use the -script parameter. This works even in environments that do not have command-line shells. The grouped tasks can also be replaced by shell scripts in environments that support command-line shells. v Shell scripts that are used to invoke saved 2105 Copy Services tasks must be rewritten to start the equivalent DS CLI commands and scripts. v In a mixed ESS 2105 and DS8000 environment, only the DS CLI can perform Copy Services functions between the ESS and the DS models. Replacing the ESS CLI with the DS CLI The ESS CLI that came with the ESS 2105 cannot be replaced with the DS CLI. Logical configuration commands for the 2105 are not supported in the DS CLI and you must use the existing 2105 ESS CLI for this purpose.
Procedure
1. Run the uninstaller to remove the DS CLI from your system. Note: Refer to the User's Guide that is installed with your current DS CLI for removal instructions.
Chapter 2. Installing, upgrading, and removing the DS CLI
17
a. Navigate to the location where the DS CLI was installed. For example, on Windows the path might be C:\Program Files\IBM\dscli. On UNIX or Linux systems, the location might be /opt/ibm/dscli. b. Open the _uninst directory (On Windows, C:\Program Files\IBM\dscli\_uninst\uninstaller.exe. On UNIX or Linux systems, /opt/ibm/dscli/_uninst/uninstaller. c. You can use the -i parameter to specify any user interface mode when uninstalling the DS CLI: -i [swing | console | silent]. The default mode for uninstalling Windows is swing. The default for UNIX and Linux is console mode. You do not have to specify the mode in the command unless you want to use something other than the default mode. Note: While in console mode, you can type back to return to the previous screen, or quit to exit the installation. d. From the command prompt, specify the -i swing parameter to open the uninstaller in graphical mode. The Uninstall IBM System Storage DS Command Line Interface window is displayed. Click the Uninstall button to complete the uninstallation process, or Cancel to cancel the uninstallation. e. The Uninstall Complete window is displayed after the uninstallation process has completed. Click OK to close the window. 2. Alternately, you can use the Add/Remove Programs facility of the Windows operating system to remove the DS CLI from your system. When you have processed the uninstall steps, restart your system to complete the uninstall. Perform the following steps to remove the DS CLI using the graphical mode. a. Navigate to the Windows Control Panel and open the Add/Remove program facility. b. Scroll the list of currently installed programs and click the listing for IBM System Storage DS Command-Line Interface. c. Click the Change/Remove button and the Welcome window for the Uninstaller is displayed. d. Click Next to continue or click Cancel to exit the removal process. When you click Next, the Confirmation window is displayed that shows the directory from which the DS CLI program is removed. e. Click Remove to continue or Cancel to stop the removal and exit the uninstall process. Click Back to return to the previous window. When you click Remove, the Uninstallation Progress window is displayed. When the uninstall process is finished, the Finish window is displayed, which contains a statement about the success or failure of the uninstall process. Click Finish to close. If the uninstall program does not remove some information from your system, the Restart window is displayed. You must restart so that previously locked files are released and automatically deleted. f. Close the Add/Remove Programs window. g. Restart your system, if required (now or later), to complete the removal process.
18
Procedure
1. Locate the uninstaller file in the /_uninst folder. If you selected the default directory, you can find the _uninst folder using the /opt/ibm/dscli path. The uninstaller file name is uninstaller.exe for Windows, or uninstaller for other platforms. 2. Type the following command at the command prompt: <install directory>/_uninst/uninstaller -i silent 3. Press the Enter key. All the associated CLI files are uninstalled. Note: On Windows, you might need to restart your computer to complete the removal of files that were locked during the uninstallation process.
Procedure
1. Type the following command at a command prompt: <install directory>/_uninst/uninstaller -i console 2. The Uninstall IBM System Storage DS Command Line Interface page is displayed.
Preparing CONSOLE Mode Installation... =================================================================== IBM System Storage DS Command Line Interface (created with InstallAnywhere by Macrovision) ------------------------------------------------------------------=================================================================== Uninstall IBM System Storage DS Command Line Interface -----------------------------------------------------About to uninstall... IBM System Storage DS Command Line Interface This will remove features installed by InstallAnywhere. It will not remove files and folders created after the installation. Hit "Enter" to uninstall. PRESS Enter TO CONTINUE:
3. Press Enter to continue. The DS CLI is now uninstalled from your system. You might have to restart to complete the removal of files that were locked during the uninstallation process.
19
uninstaller. However, because you were using another system to do your installation, the uninstaller that was created was for the system that you installed from and not for the System i model. This uninstaller cannot be used to uninstall the DS CLI. When you want to uninstall the DS CLI, you can use one of the following two methods: v Uninstall directly from your i5/OS System i model by performing the following steps: 1. Delete the library using DLTLIB QDSCLI. 2. Run the command, EDTF 'DSCLI_INSTALL_PARENT', where ''DSCLI_INSTALL_PARENT' is the parent directory of the DS CLI installation. The default parent directory is /ibm. 3. Insert a 9 (recursive delete) beside the DS CLI directory to remove all DS CLI java code. You might use this method if you are not planning to upgrade the DS CLI and you want to totally remove the DS CLI from your System i model. v Uninstall using a remote system. You might use this method when you are upgrading the DS CLI, because after the removal, you can use this remote system to install the upgraded DS CLI.
Procedure
1. Issue the following command from your i5/OS application:
RUNJVA CLASS(run) PARM(-console) CLASSPATH(/QIBM/ProdData/Java400/jt400ntv.jar:/yourdir/_uninst /uninstall.jar)
Substitute your uninstall directory for yourdir. 2. Wait until the uninstall process is complete before you continue with your next process.
Removing the DS CLI from your System i model using the remote method
Complete this task to remove the DS CLI from your System i model using the remote method.
20
Procedure
1. Navigate to the _uninst folder on the Windows desktop. The _uninst folder was created when the DS CLI installer was initially run on the remote Windows machine. 2. Run the uninstaller.exe file to uninstall the DS CLI on the remote System i system. Enter the system name, user name, and password to complete the uninstallation.
21
2105/2107/242x/1750 volumes are displayed. Therefore, CCL devices $1$GGAn are included in the lshostvol output for multiplatform consistency and to match the output of other DS CLI commands. However, the inclusion of CCL devices can be confusing for users who expect that the lshostvol command displays only the disk devices. You can use the OpenVMS logical name IBMDSCLI$SHOW_GG_DEVICES to modify the DS CLI behavior: If this logical name translates to an expression which evaluates as True in OpenVMS conventions (1, Y, YES, T, or TRUE), then the $1$GGAn CCL devices are shown in the command output. Otherwise, the $1$GGAn CCL devices are not shown. The startup procedure IBMDSCLI$STARTUP.COM defines the logical name IBMDSCLI$SHOW_GG_DEVICES as Y. If you want to suppress $1$GGAn CCL devices in the lshostvol command output, you can redefine the logical name after the startup procedure has been processed.
22
to the search list for help libraries in your OpenVMS system by defining appropriate logical names HLP$LIBRARY, HLP$LIBRARY_1, HLP$LIBRARY_2, and so on. IBMDSCLI_Messages.msghlp$data A message help data file with messages for facility IBMDSCLI. You can add this data file to the searchlist for message help files in your OpenVMS system by defining the logical name MSGHLP$LIBRARY accordingly. If you do not want the installation process to modify the OpenVMS system libraries, you can use these OpenVMS default logical names to integrate the DS CLI help information manually.
23
To get the best Java performance on OpenVMS, HP recommends that you set process quotas to match a typical UNIX system. HP also recommends these as minimum quota settings (except where noted). See these recommendations at: http://h18012.www1.hp.com/java/documentation/1.4.2/ovms/docs/user_guide.html To check whether your current process quotas fulfill the recommendations, you can run the following process: IBMDSCLI$JRE:[LIB]Java$Check_Environment.com.
Procedure
| 1. Set your DS CLI default configuration settings. If this is a new DS8000 installation, complete the rest | of this procedure. 2. Initiate the DS CLI to begin using it in either single-shot, script, or interactive command mode. 3. Set up your required user accounts and passwords. 4. Activate your licensed functions. This includes obtaining your feature activation codes and applying the feature activation codes to your storage unit. 5. Enable the remote support and call home functions for your DS6000 model. You must provide customer contact and network information to enable these functions. 6. Use the DS CLI to enable SNMP traps for Copy Services events and storage complex events on your storage unit. 7. Register for the My Support service for your DS6000 model. 8. Optionally, configure encryption on your encryption-capable DS8000 storage unit. 9. Configure new fixed block or CKD storage. Use the DS CLI to create and modify fixed block extent pools, arrays, ranks, volumes, and volume groups. You can also configure host ports and connections.
24
The following options are available for profile files: v You can modify the default profile. The default profile, dscli.profile, is installed in the profile directory with the software. For example, C:\Program Files\IBM\DSCLI\profile\dscli.profile is the directory path for the Windows XP platform and /opt/ibm/dscli/profile/dscli.profile is the directory path for UNIX and Linux platforms. v You can create a personal default profile by making a copy of the system default profile as <user_home>/dscli/profile/dscli.profile. v You can create a profile for the storage unit operations. Save the profile in the user profile directory. For example: <user_home>\dscli\profile\operation_name1 <user_home>\dscli\profile\operation_name2 These profile files can be specified using the DS CLI command parameter -cfg <profile_name>. If the -cfg profile file is not specified, the user's default profile file is used. If a user's profile file does not exist, the system default profile file is used. The home directory <user_home> is defined by the Java system property named "user.home". The location of your home directory is determined by your operating system. The following examples are home directories in different operating systems: Windows XP operating system For a Windows XP operating system, the property value defaults to the environment variable %USERPROFILE%. As a result, your personal profile is C:\Documents and Settings\username\ dscli\profiles\dscli.profile. UNIX or Linux operating system For a UNIX or Linux operating system, the property value defaults to the environment variable $HOME. As a result, your personal profile is ~/dscli/profile/dscli.profile. OpenVMS system For an OpenVMS operating system, the property value defaults to the logical name SYS$LOGIN. As a result, your personal profile is [.dscli.profile]dscli.profile. When you install the DS CLI, the default profile is installed in the profile directory with the software. The file name is dscli.profile; for example. c:\Program Files\IBM\DSCLI\profile\dscli.profile. The following steps provide an example of the process you can use to modify key items in the profile file: 1. Click the DSCLI icon on your desktop. A command prompt window is displayed. 2. Enter edit dscli.profile at the command prompt. The profile configuration file is displayed. 3. Scroll down to the number (#) sign in front of HMC1: and remove the # sign. 4. Enter the correct IP address of your management console. 5. Scroll down to the # sign in front of DEVID and remove the # sign. 6. Enter the serial number of your machine type (include the values for manufacture, machine type, and serial number). 7. Save the file. 8. Enter cd.. at your command prompt. 9. Enter DSCLI at your command prompt and the DS CLI starts. You are asked to provide only your user ID and password and not the address of your management consoles. Table 1 on page 26 provides the list of profile variables that you can use to create the profile.
25
Table 1. Profile variables Variable banner: on|off Description Enables or disables the banner that appears before the command output. This variable is equivalent to the command option -bnr. The command option -bnr overrides this default value. Specifies a delimiter character for the format: delim variable. The default character is a comma. This variable is equivalent to the command option -delim. The command option -delim overrides this default value. Specifies the storage image ID that is the target for the command. This value is equivalent to the command option -dev. The command option -dev overrides this default value. Specifies whether the command is printed before it is executed. Specify one of the following formats: v on: Specifies that the command is printed before it is executed. v off: Specifies that the command is not printed before it is executed. echoprefix Specifies the command prefix to print before a command is executed. v echoprefix: Specifies the prefix to print before a command is executed. If echo is on and echoprefix is specified, then its value is to be printed on the line before the echoed command. v none: Specifies that no prefix is to be printed before an echoed command. format Specifies the output format for list commands. Specify one of the following formats: v default: Specifies default output. v xml: Specifies XML format. v delim: Specifies columnar format. Columns are delimited with the character that you must specify with the delim variable. v stanza: Specifies a vertical table. This variable is equivalent to the command option -fmt. The command option -fmt overrides this default value. fullid header: on|off Specifies that IDs display in fully qualified format, which includes the storage image ID. Enables or disables the headers that display with the columns of data in the list commands. This variable is equivalent to the command option -hdr. The command option -hdr overrides this default value. Specifies the primary Storage Manager IP address. This variable is equivalent to the command option -hmc1. The command option -hmc1 overrides this default value. Specifies the secondary Storage Manager IP address. This variable is equivalent to the command option -hmc2. The command option -hmc2 overrides this default value.
delim
devid
echo
hmc1
hmc2
26
Table 1. Profile variables (continued) Variable locale Description Specifies the language for the output on the local computer. v ar: Arabic v be: Byelorussian v bg: Bulgarian v ca: Catalan v cs: Czech v da: Danish v de: German v el: Greek v en: English v es: Spanish v et: Estonian v fi: Finnish v fr: French v gu: Gujarati v hi: Hindi v hr: Croatian v hu: Hungarian v in: Indonesian v is: Icelandic v it: Italian v iw: Hebrew v ja: Japanese v kk: Kazakh v kn: Kannada v ko: Korean v lt: Lithuanian v lv: Latvian (Lettish) v mk: Macedonian v mr: Marathi v ms: Malay
27
Table 1. Profile variables (continued) Variable locale, continued Description v nl: Dutch v no: Norwegian v pa: Punjabi v pl: Polish v pt: Portuguese v ro: Romanian v ru: Russian v sa: Sanskrit v sh: Serbo-Croatian v sk: Slovak v sl: Slovenian v sq: Albanian v sr: Serbian v sv: Swedish v ta: Tamil v te: Telugu v th: Thai v tr: Turkish v uk: Ukrainian v vi: Vietnamese v zh: Chinese maxNumReports Sets the maximum number of records (lines) for an I/O Performance Manager performance report. Note: The default maximum number of records for a performance report is 256. The value for maxNumReports is recommended to be no larger than 3000. If the target is a DA pair, the recommended value is to be no larger than 1500. Controls the display of output. If paging is enabled, a limited number of lines of output displays when a command is issued. The lines do not scroll. You must set the number of lines per page with the rows variable. This variable is equivalent to command option -p. The command option -p overrides this default value. Sets the timeout value of client/server synchronous communication. The unit of the value is seconds. The default value is 900 seconds. You can set this timeout if the processing of a command ends by timeout due to network or client or server performance issue. Note: The command timeout value can be longer than this value because one command can consist of multiple client/server requests. Sets the timeout value to establish client or server connection. The unit of this value is seconds. The timeout value must be greater than zero. System-default socket timeout value is used if the value is set to zero. The default value is 20 seconds. Notes: 1. If the DS CLI returns a connection error, check for the following conditions: v Is there a secure physical connection between the client and server? v Is the default timeout value too short to establish a connection? 2. Setting a connection timeout value that is too short can cause unexpected connection problems. remotedevid Specifies the remote storage image ID. This variable is equivalent to the command option -remotedev. The command option -remotedev overrides this default value.
paging: on|off
timeout
timeout.connection
28
Table 1. Profile variables (continued) Variable rows Description Specifies the number of rows per page of output if the paging variable is enabled. This variable is equivalent to command option -r. The command option -r overrides this default value. Enables or disables verbose output. This variable is equivalent to the command option -v. The command option -v overrides this default value.
verbose: on|off
Example
# # DS CLI Profile # # # Management Console/Node IP Address(es) # hmc1 and hmc2 are equivalent to -hmc1 and -hmc2 command options. #hmc1: 127.0.0.1 #hmc2: 127.0.0.1 # # Default target Storage Image ID # "devid" and "remotedevid" are equivalent to # "-dev storage_image_ID" and "-remotedev storage_image_ID" command options, # respectively. #devid: IBM.2107-AZ12341 #remotedevid: IBM.2107-AZ12341 # # locale # Default locale is based on user environment. #locale: en # Timeout value of client/server synchronous communication in second. # DSCLI command timeout value may be longer than client/server communication # timeout value since multiple requests may be made by one DSCLI command # The number of the requests made to server depends on DSCLI commands. # The default timeout value is 900 seconds. #timeout: 900 # Socket connection timeout value in seconds. # The timeout value must be greater than zero. # System default socket timeout value is used if timeout value is set to zero. # The default connection timeout value is 20 seconds. #timeout.connection: 20 # Output settings # # ID format of objects: # on: fully qualified format # off: short format fullid: off # Paging and Rows per page. # paging enables/disables paging the output per line numbers specified by "rows". # "paging" is equivalent to "-p on|off" option. # on : Stop scrolling per output lines defined by "rows". # off : No paging. (default) # "rows" is equivalent to "-r #" option. paging: off #rows: 24 # Output format type for ls commands, which can take one of the following values: # default: Default output
Chapter 2. Installing, upgrading, and removing the DS CLI
29
# xml : XML format # delim : delimit columns using a character specified by "delim" # stanza : Horizontal table format # "format" is equivalent to option "-fmt default|xml|delim|stanza". #format: default # delimiter character for ls commands. #delim: | # Display banner message. "banner" is equivalent to option "-bnr on|off". # on : Banner messages are displayed. (default) # off : No Banner messages are displayed. banner: on # # Display table header for ls commands. "header" is equivalent # to option "-hdr on|off". # on : Table headers are displayed. (default) # off : No table headers are displayed. header: on # # Display verbose information. "verbose" is equivalent to option "-v on|off". # on : Display verbose information. # off : No verbose information. verbose: off # Echo each dscli command. # on : Echo commands to standard out prior to execution. Passwords within command line arguments will be hidden. # off : No command echo. (default) #echo:on # If echo is on and echoprefix is specified, its value will be printed on the line before the echoed command. #echoprefix:dscli> # The max number of records for performance report. # The default max number of records for performance report is 256. The value for it is suggested to be # not larger than 3000. If the target is dapair, the value is suggested to be not larger than 1500. #maxNumReports: 256 # End of Profile
30
secadmin (Security Administrator) All users that you assign to the security administrator user role may initiate recovery key operations, and add other users to this role. Users in this role may not be assigned to any other user role, and users in any other user role may not be assigned to this role. op_volume (Logical Operator) The logical operator user role allows access to service methods and resources that relate to logical volumes, hosts, host ports, logical subsystems, logical volumes, and volume groups, excluding security methods. In addition, this user role inherits all authority of the monitor user role. op_storage (Physical Operator) The physical operator user role allows access to physical configuration service methods and resources, including storage complex, storage image, array, rank, and extent pool objects. This user role inherits all the authority of the Copy Services operator and logical operator user roles, excluding security methods. op_copy_services (Copy Services Operator) The Copy Services operator user role allows access to all Copy Services service methods and resources, excluding security methods. In addition, this user role inherits all authority of the monitor user role. service (Service Operator) The service operator user role includes monitor authority, plus access to all management console-server service methods and resources, such as performing code loads and retrieving problem logs. monitor (Monitor) The monitor user role allows access to list and show commands. It provides access to all read-only, nonsecurity management console-server service methods and resources. no_access (No Access) The no_access user role does not allow access to any service methods or storage image resources. By default, this user role is assigned to any user account in the security repository that is not associated with any other user role.
Table 2. User role capabilities Service Operator Copy (DS6000 Services Operator Monitor only)
Capability Security user account management Recovery key management User account management Access audit log Update storage complex Power on/off storage image
Administrator
Security Administrator X
Physical Operator
Logical Operator
No Access
X X
31
Table 2. User role capabilities (continued) Service Operator Copy (DS6000 Services Operator Monitor only)
Capability Update storage unit Update storage image Warmstart storage image Manage arrays, ranks, extent pools I/O port configuration Configuration recovery services (unfence volumes, discard pinned tracks, repair ranks,...) Host configuration Logical subsystem configuration Volume configuration Add or remove volume group Assign or unassign volume group to host connection Add or remove volumes to volume group
Administrator X
Security Administrator
Physical Operator X
Logical Operator
No Access
32
Table 2. User role capabilities (continued) Service Operator Copy (DS6000 Services Operator Monitor only)
Capability Manage Copy Services (FlashCopy, PPRC, Global Mirror) Set Copy Services timeout values Update user account password Query FRUs and enclosures Query configuration Query Copy Services FRU management Problem management
Administrator
Security Administrator
Physical Operator
Logical Operator
No Access
X X X X
X X X X
X X
X X
X X
X X X X
Validate communication paths Activate code load Create a new PE package Manage storage unit IP addresses
X X
X X
X X
In addition to assigning users to one or more user roles, you also must assign a default password to each user. When you notify users of their role assignment and default password, indicate that the default password is only good for the initial log on. Users must change the password at the time of their initial log on. Also, remind all users to record their password in a safe place, because there is no way that the administrator or the application can retrieve a password. Note: You must change the default password for an account, including the administrator account, to be able to use any CLI command other than the one to change the password. See the chuser command for more information.
33
Procedure
1. Log in to the DS CLI in interactive command mode. 2. Issue the following command from the dscli command prompt to assign a user to an account with a default password: dscli> mkuser -pw AB9cdefg -group service,op_copy_services pol my_policy1 testuser 3. Press Enter and observe the processing result. A successful process returns the following display:
User Name testuser with my_policy1 successfully created.
34
not attached to the 1750 record, you must assign it to the 1750 record in the DSFA application. In this situation, you must have the OCC (which you can find on the License Function Authorization document).
Procedure
1. Log in to the DS CLI in interactive command mode. 2. Issue the DS CLI applykey command at the dscli command prompt as follows. (This example presumes that your XML file is named "keys.xml" and it resides on a CD or USB flash drive): dscli> applykey -file a:\keys.xml -dev IBM.2107-75FA120 3. Press Enter. When the process has completed, the following message is displayed:
Licensed Machine Code key xxxx, key xxxx successfully applied.
4. Verify that the keys have been activated for your storage unit by issuing the DS CLI lskey command as follows: lskey -dev IBM.2107-75FA120 5. Press Enter and the following type of report is displayed:
Activation key Operating environment (OEL) Remote mirror and copy (RMC) Metro mirror (MM) Global mirror (GM) Metro/global mirror (MGM) Remote mirror for z/OS (RMZ) Point in time copy (PTC) Parallel access volumes (PAV) IBM HyperPAV IBM FlashCopy SE Authorization level (TB) 45 25 25 25 25 25 25 100 On 105 Scope All All All All All CKD All CKD CKD All
35
36
HPUX /opt/ibm/dscli Linux /opt/ibm/dscli Sun Solaris /opt/ibm/dscli Windows C:\Program Files\IBM\dscli HP Tru64 UNIX /opt/ibm/dscli iSeries /ibm/dscli Novell NetWare SYS:\IBM\dscli
37
Note: If you are using a 2105 machine type as part of your network and are going to use the Copy Services functions, you must specify the IP address of the domain control server where you have installed the DS CLI. User Name Specify the name of the user account. The default user names for the first logins are admin and secadmin. Password Specify the user password. The default password for the administrator account is admin and the default password for the security administrator account is secadmin. However, these passwords are only good for the first login. Note: Because the passwords for the administrator and security administrator accounts expire after you log in for the first time, you must change the password before you can perform any other DS CLI command function. Use the chuser command to change your password. Each time you log in to the DS CLI, either in the directory where you installed the DS CLI or using the full path name for the DS CLI, you can specify this information using either of the following three methods: v You may log in to the DS CLI without specifying any of this information on the command line and the application will prompt you to enter the information interactively. For example: /opt/ibm/dscli/dscli. v You may log in to the DS CLI by specifying this information on the command line. For example: dscli -hmc1 mtc032h.storage.tucson.ibm.com -user admin -passwd topn0t. v You may log in to the DS CLI by specifying this information on the command line, except for the password, by using the -pwfile parameter instead of the -passwd parameter. For example: dscli -hmc1 9.1.12.123 -user admin -pwfile /home/ming/dscli/security.dat, where "ming" is the user ID used to log into the operating system. The security.dat file was created by using the DS CLI command managepwfile. See the DS CLI command managepwfile for more details. Notes: 1. Entering a DS CLI command at the dscli command prompt requires that you continue entering all the parameters and values until the command is complete. This can result in an automatic line wrap if your command has many parameters and values. 2. You cannot force a line break or wrap by pressing the Enter key and then typing the rest of the command on a second line. The DS CLI interprets the use of the Enter key as an end to the function and begins to process whatever is contained on the line, ignoring the second line. 3. The DS CLI command examples that are provided in this guide are often shown with line wraps that would not occur during your input. These examples are displayed for clarity and other formatting considerations.
Procedure
1. Use the following command format to start a DS CLI session (Windows operating system):
dscli -hmc1 9.1.23.456 -user admin -passwd my_password lssi -s -fullid -hdr off
38
Here is an example of this same command in i5/OS without the report delimiters:
DSCLI SCRIPT(*NONE) HMC1(9.1.23.456) USER(admin) PASSWORD(my_password) DSCLI(lssi)
This command demonstrates the use of the lssi command with the -s parameter. Use this command to view the storage image IDs for your storage complex. The storage image ID consists of the manufacturer name (IBM), the machine type (2107 or 1750), and the serial number. Notes: a. The command example uses the -fullid DS CLI command parameter. The -fullid command parameter generates fully qualified IDs, which include the storage image ID, for every ID that is displayed in the command output. b. The command example also uses the -hdr off command parameter, which turns off the header that is associated with the report generated from the lssi command. c. Almost every DS CLI command requires the use of the storage image ID. You can set it as an environment variable by setting devid in the profile file, or by setting devid using the setenv command. If you choose not to set it, the dscli will set a default devid on systems where the management console is aware of only one storage image. If you provide the -dev (storage_image_ID) parameter in commands, the value that you type takes priority over the devid environment variable. If you specify a full ID that contains the storage image ID, the storage image ID that you specify takes priority over the value from the -dev (storage_image_ID) parameter and over the devid environment variable. 2. Wait for the command to process. The following type of report is generated to list the storage image IDs that are associated with the storage complex. v IBM.2107-75FA111 v IBM.2107-75FA112 v IBM.2107-75FA120
Procedure
1. Enter the script name at the command prompt using the following format:
Chapter 3. Running the DS CLI
39
Note: If you are using i5/OS and have already logged on to the DS CLI, you invoke the script mode using the following format:
DSCLI SCRIPT(/myscript) USER(admin) OUTPUT(/outfile)
2. Wait for the script to process and provide a report regarding the success or failure of the process.
Example
The following example shows a script that is used to establish remote mirror and copy relationships for volume pairs for the DS8000 series:
mkpprc mkpprc mkpprc mkpprc mkpprc mkpprc mkpprc -dev -dev -dev -dev -dev -dev -dev IBM.2107-1303561 IBM.2107-1303561 IBM.2107-1303561 IBM.2107-1303561 IBM.2107-1303561 IBM.2107-1303561 IBM.2107-1303561 -remotedev -remotedev -remotedev -remotedev -remotedev -remotedev -remotedev IBM.2107-7504491 IBM.2107-7504491 IBM.2107-7504491 IBM.2107-7504491 IBM.2107-7504491 IBM.2107-7504491 IBM.2107-7504491 -type -type -type -type -type -type -type mmir 1000-103F:2300-233F gcp 1100-113F:2340-237F mmir 1800-187F:2800-287F gcp 1200-127F:2500-257F mmir 1040-1054:2700-2714 gcp 1055-107F:2400-242A mmir 1140-117F:2600-263F
Procedure
1. Log on to the DS CLI at the directory where it is installed. 2. Provide the information that is requested by the information prompts. The information prompts might not appear if you have provided this information in your profile file. The command prompt switches to a dscli command prompt. 3. Begin using the DS CLI commands and parameters. You are not required to begin each command with dscli because this prefix is provided by the dscli command prompt. Tip: Issue the setoutput command to control how the reports that are generated by the ls commands are displayed on your computer. The setoutput command allows you to set or display command output format options. For example, you can specify that the reports be displayed in one of the following formats: delim Displays output in a table format and sets the column delimiter to a single character. xml Displays output in XML format.
40
stanza Displays output in stanza (vertical table) format. See the setoutput command for more details.
Example
To use the DS CLI history function that is associated with the interactive command mode, perform the following steps: 1. Issue an exclamation mark (!) to display CLI commands that you have used in the current session. For example: dscli> ! results in a list of commands such as the following example:
[4] [3] [2] [1] lsarraysite -dev IBM.2107-1300771 lsarray -dev IBM.2107-1300771 lsextpool -dev IBM.2107-1300771 lsextpool -dev IBM.2107-1300771
2. Issue dscli> !1 to retry the last command. Or, issue dscli> !3 to retry command [3].
Obtaining the serial (storage image ID) number using the DS CLI
Almost every DS CLI command requires the use of the storage image ID. If you add your target storage image ID into your profile file under the devid designation, you are not required to provide the storage image ID when you issue each command.
Procedure
1. Log in to the DS CLI in interactive command mode. 2. Enter the following command format at the dscli command prompt to obtain the storage image IDs: dscli> lssi -s 3. Wait for the command to process. The following type of report is generated, which lists the storage image IDs that are associated with the storage complex. v IBM.2107-75FA111 v IBM.2107-75FA112 v IBM.2107-75FA120
41
Table 3. Parameters for the help command (continued) Command help -l help -match <string> Description Displays a list of commands with their associated syntax. Displays a list of commands that contain the specified string. This parameter cannot be used with any other parameters. Displays the reference page (man page) for the command name.
command_name -h command_name -help command_name -? help command_name help -s command_name help -l command_name
Displays the brief description for the command name. Displays the usage statement for the command name.
Notes: v You cannot use the -s and -l parameters with the following help command parameters: -h, -help, and -?. v Much of the information that is associated with the help command is displayed in list format. You can include the page (-p on) and row (-r number) controls; for example, dscli> help -p on -r 20. This command pauses your page listing after 20 entries and prompts you to press any key to continue.
Example
dscli> help -match flash
42
DS CLI exit codes provide more general reasons (than the error messages provide) why a CLI command transaction has failed. The following table lists the exit codes and their meanings. Note: The operating system might generate other exit codes not listed in Table 4 if the DS CLI is stopped by another process. For example, code 143 for the Windows operating system.
Table 4. DS CLI exit codes Code 0 2 Category Success Syntax error Description Specifies that the command is successfully processed. Specifies that there is an error in the way that the command is presented (misaligned or wrong parameters) for processing. Specifies that there is a connectivity or protocol error. Specifies that an error occurs during a function call to the application server. Specifies that an error occurs during the authentication process. Specifies that an error occurs due to a MetaProvider client application specific process. Specifies that the CLI.CFG file is not found or accessible. Specifies that the javaInstall variable was not provided in CLI.cfg. Specifies that the javaClasspath variable was not provided in CLI.cfg. Specifies that the format of the configuration file is not correct.
3 4
5 6
63 64 65 66
Perform the following steps to view, interpret, and use the DS CLI exit codes.
Procedure
1. (Script mode) Retrieve the most recent exit code. For a Windows operating system, use %ERRORLEVEL% to retrieve the most recent exit code. For a UNIX or Linux operating system, use $? to retrieve the most recent exit code. The following examples demonstrate the retrieval commands. The first part of the example shows the command that failed and the second part of the example shows the code to obtain the DS CLI exit code. Windows operating system
C:\Program Files\ess\cli>dscli test CMMCI9013E Command: test was not found. Tip: Enter help for a list of available commands. C:\Program Files\ess\cli>echo %ERRORLEVEL% 2
43
echo $? 2
2. Use the previous table to interpret the value that is associated with the code and correct the command according to the exit code description.
Results
Processing that determines your next course of action Based on the interpretation of the exit code value and the following processing description that is associated with a failed DS CLI transaction, you can determine your next course of action. Single-shot mode The following processing is associated with a single-shot mode transaction: v All operations of the DS CLI transaction that can be processed are processed even though an error has occurred with one or more of the processed parameters that are associated with the transaction. v A report on all successful completions is generated. v A report on all failures is generated. Script mode The following processing is associated with a script mode transaction: 1. A DS CLI failure exit code is issued. 2. The script mode is automatically exited with no additional processing.
44
You cannot use commands that upload or download files, for example: - offloadauditlog - offloadfile - applykey cannot be used with the -file parameter - setauthpol cannot be used with the -action value of settruststore
45
46
47
Syntax diagrams
Main path line
Begins on the left with double arrowheads (>>) and ends on the right with two arrowheads facing each other (><). If a diagram is longer than one line, each line to be continued ends with a single arrowhead (>) and the next line begins with a single arrowhead. Read the diagrams from left-to-right, top-to-bottom, following the main path line. Keyword
dscli
Represents the name of a command, parameter, or argument. A keyword is not in italics. Spell a keyword exactly as it is shown in the syntax diagram. Required keywords
mkuser -pw password -group group_name [ . . . ] -pol User Name " - " pol_name
-scope
user_resource_scope
Indicates the parameters or arguments you must specify for the command. Required keywords appear on the main path line. Mutually exclusive required keywords are stacked vertically. Optional keywords
-h
-help
-?
Indicates the parameters or arguments you can choose to specify for the command. Optional keywords appear below the main path line. Mutually exclusive optional keywords are stacked vertically. Variable
variable
Represents the value you need to supply for a parameter or argument, such as a file name, user name, or password. Variables are in italics.
Special characters
- (minus) or / (slash) sign Parameters are prefixed with a - (minus) sign. Parameters define the action of a command or modify the operation of a command. You can use multiple parameters, followed by variables, when you issue a command.
48
[ ] square brackets Optional values are enclosed in square brackets. { } braces Required or expected values are enclosed in braces. | vertical bar A vertical bar indicates that you have a choice between two or more options or arguments. For example, [ a | b ] indicates that you can choose a, b, or nothing. Similarly, { a | b } indicates that you must choose either a or b. ... ellipsis An ellipsis signifies the values that can be repeated on the command line or multiple values or arguments. dash A dash indicates that, as an alternative to entering the parameter, a value or values are supplied from stdin. stdin varies depending on your settings and is available when you are using single-shot or script mode. This option is not available when using interactive mode.
-r number
stanza
delim
default Sets the output to a space-separated plain text table. Note: You can use this option only with list (for example, lsuser, lskey, lsserver) commands -delim char Sets the output to delimited output and the delimiter to the single character char. You must enclose char in single or double quotation marks if the character is a shell metacharacter (such as * or \t). If char is not specified, the CLI program returns a syntax error. A blank space, even when it is enclosed within quotation marks, is not a valid character as a delimiter. Note: You can use this option only with list (for example, lsuser, lskey, lsserver) commands
49
Description Turns the header on or off. The default is on. You can specify -hdr on or -hdr off to turn the header on or off; but if you specify only -hdr, you get an error. Turns the banner on or off. The default is on. You can specify -bnr on or -bnr off to turn the banner on or off; but if you specify only-bnr, you get an error. Turns verbose mode on or off. The default is off. You can specify -v on or -v off to turn verbose mode on or off; but if you specify only-v, you get an error. Provides fully qualified IDs, which include the storage image ID, for every ID that is displayed in the command output. The default value is off. You can specify -fullid on or -fullid off; but if you specify only-fullid, you get an error. Note: You can only use this command flag with list (for example, lsioport, lskey) and show (for example, showsu, showlss) commands. Displays a detailed description of the specified command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored. Displays the short output for the command, which is usually a single column of the resource IDs of the objects specified by the command. For detailed information, see the -s parameter for that command. Notes: 1. You can only use this flag with the help (setoutput) command and the ls type (for example, lsuser, lsserver) commands, except for lskey. 2. You cannot use the -s and -l parameters together.
-bnr on | off
-v on | off
-fullid on | off
-help | -h | -?
-s
-l
Displays the long output for the command, which is the default output plus additional columns of data to the right of the default columns. For detailed information for a specific command, see the -l parameter for that command. Notes: 1. You can only use this flag with the help (setoutput) command and the ls type (for example, lsuser, lsserver) commands, except for lskey. 2. You cannot use the -s and -l parameters together.
Framework commands
This section contains the user interface framework commands for the DS command-line interface. The following framework commands are available: dscli echo Starts the DS CLI. Use this command to perform storage management tasks from the command-line. Allows you to specify whether the dscli will echo each specified command, or to display a user-specified string. If echo is turned on, each command will be printed before it is executed. The echo can also be turned on or off using the dscli profile file or the setenv command. Ends an interactive command-line interface session. Displays a list of commands available in a command-line interface and optionally displays the syntax or brief description of each command. If you specify this command with no parameters, this command displays only a list of available commands.
CLI User's Guide
exit help
50
helpmsg Used to obtain details about information, warning, and error messages. quit Ends an interactive command-line interface session.
setenv Allows you to set DS CLI environment variables that are located in the DS CLI profile. showenv Displays the DS CLI environment variables. ver Displays the versions of the command-line interface, storage management console (HMC or SMC), and licensed machine code. It does not display the version number of the graphical user interface (GUI).
dscli
The dscli command starts the DS CLI. Use this command to run DS CLI commands in the interactive, single-shot, or script mode.
dscli -h -help -? -ver -overview -cfg profile -hmc1 hmc1 -hmc2 hmc2
-user
user_name
command -script
file_name
Parameters
-help | -h | -? (Optional) Displays a help screen about how to use the DS CLI program. -ver (Optional) Displays the DS CLI version. -overview (Optional) Provides overview information about the DS CLI. -cfg profile Specifies a profile file. This parameter is not required if you are using default profiles. The default profile file name is dscli.profile, and it is provided as part of the DS CLI package under the profile directory. See Creating a default CLI profile on page 24 for more information. -hmc1 hmc1 (Optional) Specifies the primary management console IP address or the DNS name. Note: You can connect the DS CLI to the HMC using an IPV6 IP address if your Java virtual machine level supports IPV6. This parameter is not required if you have established this information as a profile variable. -hmc2 hmc2 (Optional) Specifies the secondary management console IP address or the DNS name. This parameter is not required if you have established this information as a profile variable. -user user_name (Optional) Specifies your user name for issuing DS CLI commands on the command-line. -passwd password (Optional and not recommended) Specifies the password you want to use to authenticate when you
Chapter 4. CLI commands
51
start the CLI session.This parameter is not required or recommended. If you use this method to designate your password, the password is displayed on the screen. Another option is to specify a password file (see the next parameter) that is used when you start the DS CLI. -pwfile passwordfile (Optional) Specifies a password file containing your password as an alternative to the passwd parameter. Note: You cannot specify both the -pwfile and the -passwd parameter when you start the DS CLI, otherwise an error message is given. command (Optional) Specifies the single command that you want to run. Note: You cannot specify both the command and -script file_name parameters. Use -script for script mode, command for single-shot mode, and use neither for interactive mode. -script file_name (Optional) Initiates the script mode so that multiple dscli program commands can be issued consecutively using a saved file. Format options that are specified using the framework setoutput command apply to all commands in the file. Output from successful commands routes to stdout, and output from failed commands routes to stderr. If an error occurs during the processing of one of the commands in the file, the script exits at the point of failure and returns to the system prompt.
echo
The echo command allows you to specify whether the dscli will echo each specified command, or to display a user-specified string. If echo is turned on, each command will be printed before it is executed. The echo can also be turned on or off using the dscli profile file or the setenv command.
echo on off message
Parameters
on | off | message (Optional) Specifies whether the echo is turned on or off, or if a message is displayed. If it is turned on, each command will be displayed before it is executed. If it is turned off, the dscli will not display anything before executing a command. You can also choose to echo a string of your choice. For example, if you enter echo something else, the string "something else" will be displayed. Issuing the echo command without any parameters will display whether echo is on or off. Note: If the echoprefix variable is set, its value will be printed on the same line preceding the commands that are echoed.
Example
Issuing the echo command:
dscli> echo on
52
exit
The exit command ends an interactive command-line interface session.
exit
help
The help command displays a list of commands available in a command-line interface and optionally displays the syntax or brief description of each command. If you specify this command with no parameters, this command displays only a list of available commands.
help -? -h -help -l -s -p off on -r number command_name
-match
string
Parameters
-? | -h | -help Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored. -l Displays a list of available commands with the syntax diagrams for each. If you specify a command name with this parameter, this command displays the syntax for only the specified command. -s Displays a list of available commands with a brief description of each. If you specify a command name with this parameter, this command displays a brief description for only the specified command. -p off | on Specifies whether to display one page of text at a time or all text at once. off Displays all text at one time. This value is the default. on Displays one page of text at a time. Pressing any key displays the next page. -r number Specifies the number of rows per page to display when the -p parameter is on. The default is 24 rows. You can specify a value from 1 to 100. command_name Displays help information for the specified command, including the syntax diagram, parameter descriptions, return codes and errors, descriptions, examples, and miscellaneous remarks. -match string Displays a list of commands that contain the specified string. This parameter cannot be used with any other parameters.
Example
Invoke help
#dscli> help -s exit
53
helpmsg
The helpmsg command is used to obtain details about information, warning, and error messages.
helpmsg message_ID
Parameters
Notes: 1. The message information revealed by this command is a snapshot of what is available in your current code version. 2. This command does not work for GUI messages. 3. For the most up-to-date information, see the list of individual messages in the IBM System Storage DS8000 Information Center. message_ID (Required) Specifies the message number that you are querying. You must enter the entire message number (for example, CMUC00246I, CMUC00244W, CMUC00247E). You do not have to enter all caps. Substitute keys are not allowed and cause an error if used.
Example
Invoking the helpmsg command
dscli> helpmsg cmuc00247e
quit
The quit command ends an interactive command-line interface session.
quit -? -h -help
54
Parameters
-? | -h | -help Displays a detailed description of this command, including syntax, parameter descriptions, and examples. If you specify a help option, all other command options are ignored.
setenv
The setenv command allows you to override the default values of the DS CLI environment variables. The default values are found in the DS CLI profile, and the new values are valid for the current interactive session only and not permanently saved back into the DS CLI profile.
setenv -paging on off -rows # -format default xml delim stanza -delim char
-header
on off
-verbose
on off
-banner
on off
-devid
storage_image_ID
-remotedevid
storage_image_ID
-echo
on off
-echoprefix
echo_prefix none
-locale
user_locale
-timeout
timeout_in_sec
-fullid
on off
-maxnumreports
max_reports
Parameters
-paging on | off (Optional) Specifies whether to display one page of text at a time or all of the text at once. off Displays all of the text at one time. This value is the default. on Displays one page of text at a time. Pressing any key displays the next page. -rows # (Optional) Specifies the number of rows per page to display when -paging is set to on. The default is 24 rows. You can specify a value from 1 to 100. -format default | xml | delim | stanza (Optional) Specifies the format of the output. You can specify one of the following values: default Specifies that the output is to be displayed in a tabular format using a space as the delimiter between the columns. This value is the default. delim Specifies that the output format is to be set to a table and sets the column delimiter to a single character that is specified by the -delim char parameter. xml Specifies that the output is to be displayed in XML format.
Chapter 4. CLI commands
55
stanza Specifies that the output is to be displayed in a stanza (vertical table) format. -delim char (Optional) Specifies the delimiter character (such as a comma) used in the report. -header on | off (Optional) Specifies whether to display the table header. on Displays the table header. This value is the default. off Does not display the table header. -verbose on | off (Optional) Specifies whether to enable verbose mode. off Disables verbose mode. The value that you specify takes the place of the value that you specified in the profile. on Enables verbose mode. -banner on | off (Optional) Specifies whether the banner (command header) message is enabled. off Turns off the header mode so that the command header does not display. on Turns on the header mode so that the command header is displayed. -devid storage_image_ID (Optional) Specifies the default devid. -remotedevid storage_image_ID (Optional) Specifies the default remote devid. -echo on | off (Optional) Specifies whether the echo is turned on or off. If it is turned on, each command will be printed before it is executed. -echoprefix echo_prefix | none (Optional) Specifies a prefix to display before each echoed command. -echoprefix none indicates that no prefix should be displayed. -locale user_locale (Optional) Specifies the output language on the local computer. The default locale is based on the user environment settings. Example: en -timeout timeout_in_sec (Optional) Specifies the timeout value of client/server synchronous communication. The timeout value is displayed in seconds. -fullid on | off (Optional) Specifies that IDs are displayed in the fully qualified format, which includes the storage image ID. The default value is off. -maxnumreports max_reports (Optional) Specifies the maximum number of records for the performance report. The default value is 256.
56
Example
You can issue the setenv command for a DS8000 model. Invoking the setenv command
dscli> setenv -echo on
showenv
The showenv command displays the DS CLI environment variables.
showenv
Example
You can issue the showenv command for a DS8000 model. Invoking the showenv command
dscli> showenv
57
devid Specifies the default devid. remotedevid Specifies the default remote devid. echo Specifies whether the echo is turned on or off. If it is turned on, each command will be printed before it is executed.
echoprefix Specifies that a prefix is displayed before each echoed command. A dash "-" is shown and no prefix is displayed if echoprefix is not specified. locale Specifies the output language on the local computer. timeout Specifies the timeout value of client/server synchronous communication. The timeout value is displayed in seconds. fullid Specifies that IDs are displayed in the fully qualified format, which includes the storage image ID. maxnumreports Specifies the maximum number of records for the performance report.
ver
The ver command displays the versions of the command-line interface, storage management console (HMC or SMC), and licensed machine code. It does not display the version number of the Graphical User Interface (GUI).
ver -s -l -cli -stgmgr -lmc
Parameters
-s (Optional) Specifies that the system displays the version of the command-line interface program. You cannot use the -s and -l parameters together. -l (Optional) Specifies that the system displays the following version information: v The version of the DS command-line interface v The version of the DS Storage Manager (SMC or HMC) v The version of the licensed machine code You cannot use the -s and -l parameters together. -cli (Optional) Displays the version of the DS Command-line interface program. Version numbers are in the format version.release.modification.fixlevel. -stgmgr (Optional) Displays the HMC code version number. This value is not the version number of the Graphical User Interface (GUI). -lmc (Optional) Displays the version of the DS licensed machine code.
58
Example
Invoking the ver command
dscli> ver l
59
4. Either the storage administrator or security administrator tests the new policy. 5. The storage administrator activates the new policy. The following user account and security commands are available: chauthpol Changes the general attributes of an authentication policy, such as the policy name and the activation state. General attributes are attributes that apply to every policy type. chpass Changes the password expiration time, number of login attempts, minimum password age, minimum password length, and password history for a storage complex. chuser Modifies and locks or unlocks a user account. Users who do not have administrator authority, use this command to change an expired password and create a password that is not known to the administrator who created their account. cpauthpol Copies an existing authentication policy to a new policy. You can only copy a policy within the same storage complex. Copying between different storage complexes is not supported. lsauthpol Displays a list of all the authentication policies on the storage complex. lsuser Generates a report that lists the user names and access authority levels of the storage image user account. managepwfile Creates a password file for an existing ESS or DS user account. This command processes the password requirements for 2105, 2107/242x, and 1750 systems. mkauthpol Allows you to create an empty authentication policy. Use the setauthpol command to set specific policy attributes. mkuser Creates a DS CLI or a DS Storage Manager Basic authentication policy user account. rmauthpol Allows you to remove an authentication policy. rmuser Removes a storage image user account. CLI users with administrative authority use this command to delete a user account file. setauthpol Modifies policy attributes that apply to a specific type of authentication policy, changing the contents of the policy. setrmpw Changes the IBM Tivoli Storage Productivity Center Replication Manager password. Only a person who has administrator authority can invoke this command (DS8000 only). showauthpol Displays detailed properties of a specified authentication policy. showpass Generates a report that lists the number of days until the password expires, number of failed login attempts, password age, minimum password length, and password history that are associated with a password. showuser Generates a report that displays the details for an individual storage image user account. testauthpol Allows you to test a specified authentication policy. who Displays authentication information for the users who are currently logged in (DS8000 only).
CLI User's Guide
60
whoami Displays authentication information for the current user (DS8000 only).
chauthpol
The chauthpol command changes the general attributes of an authentication policy, such as the policy name and the activation state. General attributes are attributes that apply to every policy type. To change specific attributes that only apply to some policy types, use the setauthpol command. This command is not supported on DS6000 models.
chauthpol -name new_pol_name pol_name -pw password -quiet -activate | -username user_name
Parameters
-name new_pol_name (Optional) Specifies the new name for the authentication policy. This parameter cannot be used with the -activate parameter. -activate (Optional) Activates the specified authentication policy. This parameter requires the -username and -pw parameters, and optionally the -quiet parameter. This parameter cannot be used with the -name parameter. To use this parameter, you must be logged in with the currently active authentication policy with storage administrator authority, and the name specified by the -username parameter must have storage administrator authority in the specified authentication policy to be activated. -username user_name (Optional) Specifies a valid user name in the policy being activated. Note: You must have administrator privileges in the current policy to modify the user name in the new policy. This parameter is required when the -activate parameter is specified. -pw password (Optional) Specifies the password of the user name that is specified in the -username parameter. Note: You must have administrator privileges in the current policy to modify the password in the new policy. This parameter is required when the -activate parameter is specified. -quiet (Optional) Turns off the modification confirmation prompt for this command. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example 1
Invoking the chauthpol command to change the attributes of an authentication policy.
dscli> chauthpol quiet name my_policy1 my_policy_01
61
Example 2
Invoking the chauthpol command to change the attributes of an authentication policy.
dscli> chauthpol quiet activate username admin pw test2ibm my_policy2
chpass
The chpass command changes the password expiration time, minimum password age, minimum password length, password history, and the number of login attempts for a basic user account.
chpass -expire number -fail number -age number -length number
-history
number
-reset
-pol
pol_name
Parameters
-expire number (Optional) Specifies the number of days a user account password is valid before it expires and needs to be changed by the user. The default number of days is 90. If you do not want the password to expire, enter a value of zero. After the password expires, the user is not allowed to log in unless the password is changed. Note: Though the expiration range is 0 - 9999, a nonzero must also be greater than or equal to the minimum age value. So, to avoid a possible password problem, do not allow the password to expire before you change the value. For example, assuming an age value of 7 (meaning you cannot change the password more than once a week), but the expiration is set to 5 days, there would be two days in which you could not use the account. -fail number (Optional) Specifies the number of login attempts allowed on any given user account. The number of login attempts can be zero to twenty-five. The default number of login attempts is 5. If you do not want a limit on the number of login attempts, enter zero. After the number of login attempts is exceeded, the user account is locked. -age number (Optional) Specifies the number of days that a user must wait before changing a password. A zero disables the age requirement of the password, and the default age is 1. Note: The range is 0 - expiration value, inclusive. The real check is that the age value should not exceed the password expiration value, for the reason explained under the -expire parameter. -length number (Optional) Specifies the minimum length (from 6 to 16 characters) for passwords. The default is 8. -history number (Optional) Specifies the number of unique passwords (from 1 to 16) that a user must go through before reusing a password. The default is 8. -reset (Optional) Resets all of the password rule values to their default values.
62
Note: The -reset parameter can only be specified by itself and not with any other parameters. -pol pol_name (Optional - DS8000 only) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy.
Example
Invoking the chpass command
dscli> chpass pol my_policy1 -expire 20 -fail 0 -age 0 -length 8 -history 10
chuser
The chuser command modifies and locks or unlocks a DS CLI or a DS Storage Manager basic user account. All users can use this command to change their own password, but users with administrator authority can also use this command to update any user's account password, to modify user group authority, or to lock or unlock a user account. Users with security administrator authority can only modify the attributes of a user ID in the security administrator group role, while users with administrator authority can modify the attributes of a user ID in any user role except security administrator. Note: When a person with administrator authority designates the password, the password is set to expire upon its initial use. The user of the password must use the chuser command to establish a new password before access to the rest of the DS CLI can be granted.
chuser -pw new_password -lock -unlock -group User_Name " - " group_name [ . . . ]
-pol
pol_name
-scope
user_resource_scope
Parameters
-pw new_password (Optional) Specifies that the new designated password is to be assigned to the user. Notes: 1. When a person with administrator authority uses this parameter in association with the -unlock parameter, the new password is temporary and expires upon the initial use. 2. When a person without administrator authority uses this parameter, the new password becomes the valid password and replaces the prior password. new_password Indicates the new password. The new password must meet the following criteria: v Must be at least the minimum length as set by an administrator and no longer than 16 characters. v Must contain at least two types of characters from the three groups: alphabetic, numeric, and symbols. Allowable characters are: a-z, A-Z, 0-9, and the symbols !@#$%&*().
Chapter 4. CLI commands
63
v Cannot contain the user ID of the user. | | | | | | | | | | | | | Note: If symbols are contained in your password, you might be required to enclose the password in quotation marks to prevent any special interpretations or expansions by the operating system shell program. Note: Even with a valid password, a user cannot interactively login when all of the following conditions are present: v The version of DS CLI used is pre-R6.1 v Entering the password without either the -passwd or -pwfile parameters v The DS CLI is operating in the Windows (all versions), Netware, or OpenVMS environments v The password contains anything other than alphabetic or numeric characters (that is, symbols) But if any of these conditions is not present, then the user should not encounter any problems in logging in with a valid password. -lock (Optional) Specifies that a user account is to be locked. A person with administrator authority can use this parameter to lock a user account. The locking action occurs when the user authenticates the account. If a user is already active (authenticated) and is using the DS CLI, the lock does not occur until logout. -unlock (Optional) Specifies that a user account is to be unlocked. A person with administrator authority can use this parameter to unlock a user account when the user can no longer log in to the DS CLI. A person might not be able to log in to the DS CLI for the following reasons: v The user forgot the password and in an attempt to log in went beyond the set number of allowable attempts. Going beyond the set limit locks the user account. Note: When unlocking a user account for this scenario, the administrator must also assign a new password to the user using the -pw parameter. The new password is temporary and immediately expires after its initial use. The administrator must notify the user of this new password. v Someone with administrator authority has locked the user account. -group group_name [. . . ] (Optional) Specifies a user's access authority group or groups. A user can be assigned to many of the following user groups: v v v v v v v admin (Administrator) op_storage (Physical Operator) op_volume (Logical Operator) op_copy_services (Copy Services Operator) secadmin (Security Administrator) service (Service Operator) monitor (Monitor)
v no_access (No Access) -pol pol_name (Optional - DS8000 only) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy.
64
-scope user_resource_scope (Optional) Specifies the user resource scope, which must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). Example: Product_A User_Name | (Required) Specifies the name of the user account. Notes: 1. The administrator inserts the name of the user account that is affected by the changes (that is, group name, lock, or unlocking). 2. Users who are changing their passwords can insert their user names. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the chuser command
dscli> chuser -pw xy0abcde testuser
cpauthpol
The cpauthpol command copies an existing authentication policy to a new policy. You can only copy a policy within the same storage complex. Copying between different storage complexes is not supported. This command is not supported on DS6000 models.
cpauthpol -name new_pol_name pol_name | -
Parameters
-name new_pol_name (Required) Specifies the new name for the (copied) authentication policy. pol_name | (Required) Specifies the name of the existing authentication policy that is being copied. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the cpauthpol command to copy an existing authentication policy to a new policy.
dscli> cpauthpol name my_policy4 my_policy2
lsauthpol
The lsauthpol command displays a list of all the authentication policies on the storage complex. This command is not supported on DS6000 models.
Chapter 4. CLI commands
65
Parameters
-s | -l | | (Optional) Displays the default output and location. You cannot use the -s and the -l parameters together. -type pol_type (Optional) Specifies the type of authentication policy that you want to list. For example, SAS. SAS Basic The storage authentication service (SAS) authentication type uses the authentication service provided by the IBM System Storage Productivity Center. The Basic authentication type uses the DS8000 Basic authentication service. (Optional) Displays only the policy name. You cannot use the -s and the -l parameters together.
pol_name . . . | (Optional) Specifies the name of the authentication policy that you want to list. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the lsauthpol command to display a list of all the authentication policies on the storage complex.
dscli> lsauthpol -l
66
lsuser
The lsuser command returns a list of basic user account names and access authority levels.
lsuser -s -l -pol pol_name -scope user_resource_scope User_Name " - " [. . .]
Parameters
-s (Optional) Displays only the user names. You cannot use the -l and the -s parameters together. -l | (Optional) Displays the default output. You cannot use the -l and the -s parameters together. -pol pol_name (Optional - DS8000 only) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy. -scope user_resource_scope (Optional) Displays only the user accounts that have the specified user resource scope. If you do not specify the scope, users with any user resource scope might be displayed. User_Name [. . .] | " - " (Optional) Displays the user accounts with the specified user names. Separate multiple user names with a blank space between each name.
Example
Note: For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. Invoking the lsuser command
dscli> lsuser -l pol my_policy1
67
v v v v
op_copy_services (Copy Services Operator) service (Service Operator) monitor (Monitor) no_access (No Access)
State Specifies the status of the user account for the designated user group, either active or locked. | Scope+ Specifies the user resource scope. A dash (-) is displayed if the storage unit does not support resource groups. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
managepwfile
The managepwfile command creates a password file for an existing ESS or DS user account. This command processes the password requirements for the 2105, 2107, and 1750 systems.
managepwfile -action add remove change
-pwfile
file_name
-mc1
hmc1
-mc2
hmc2
-name
username
-pw
password
Parameters
-action (Required) Specifies that a process that is designated by the sub-parameter be enacted on the password file. add remove Specifies that the password file entry be removed for the designated user. change Specifies that the password file entry be changed for the designated user. -pwfile file_name (Optional) Specifies the name that you want to use for the password file. You can specify the password file as an absolute path or a relative path. The relative path is obtained from the current working directory. -mc1 hmc1 (Optional) Specifies the DNS name or the IP address. hmc1 designates the Model 2107 primary HMC, Model 1750 primary SMC, Model 2105 primary Copy Services server DNS or IP address. Note: If you do not specify this parameter, the DS CLI will use the value that was specified for -hmc1 in the current CLI session connection, or the default value, if specified, for HMC1 in your profile file. This value, as entered and converted to lower case, along with the value of the -name parameter is used as a key in the password file. If the values for -mc1 and -mc2 are equivalent, then only one key is generated. Specifies that an entry for the user and the specified primary HMC be created in the password file. If the password file does not exist, it will be created.
68
-mc2 hmc2 (Optional) Specifies the DNS name or the IP address of the secondary HMC. Note: If you do not specify this parameter, the DS CLI will use the value that was specified for -hmc2 in the current CLI session connection, or the default value, if specified, for HMC2 in your profile file. This value, as entered and converted to lower case, along with the value of the -name parameter is used as a key in the password file. If the values for -mc1 and -mc2 are equivalent, then only one key is generated. -name username (Optional) Specifies the name that you use to access the DS CLI. This information, along with the -mc1 and -mc2 parameter information, is used as keys in the password file. -pw password (Optional) Specifies a user-assigned password. The password is case-sensitive. Notes: 1. A password file is created with a user's default protection mask. The user can update the protection mask to allow access only to the owner of the file. Also, you must write down the directory name where the password file is contained in case you need to use it later. 2. The password file has a default value of <user_home>/dscli/security.dat. The home directory <user_home> is defined by the Java system property named "user.home" The location of your password file is determined by your operating system. The following examples are home directories in different operating systems: Windows XP operating system For a Windows XP operating system, the property value defaults to the environment variable %USERPROFILE%. As a result, your personal profile is C:\Documents and Settings\<username>\dscli\security.dat. UNIX or Linux operating system For an UNIX or Linux operating system, the property value defaults to the environment variable $HOME. As a result, your personal profile is ~/dscli/security.dat. i5/OS For the i5/OS, your personal profile is /home/<username>/dscli/security.dat. OpenVMS system For an OpenVMS operating system, the property value defaults to the logical name SYS$LOGIN. As a result, your personal profile is [.dscli.profile]security.dat. Note: The values of the Java system properties can be redefined by JRE options. If you are having problems, check to see whether you have an environment setting like the following on your local system:
_JAVA_OPTIONS=-Duser.home=...
3. In some circumstances, this command might return more than one error/informational message.
Example
Invoking the managepwfile command
dscli> managepwfile -action add -mc1 myess.ibm.com -name testuser pw AB9cdefg -mc2 myess2.ibm.com
69
Record myess.ibm.com/testuser successfully added to password file c:\Documents and Settings\testuser\dscli\security.dat Record myess2.ibm.com/testuser successfully added to password file c:\Documents and Settings\testuser\dscli\security.dat
mkauthpol
The mkauthpol command allows you to create an empty authentication policy. This command is not supported on DS6000 models. After you create an authentication policy, use the manageauthpol command to configure it, and the chauthpol command to enable it.
mkauthpol -type sas pol_name -
Parameters
-type sas (Required) Specifies the authentication policy type. Currently, SAS (Storage Authentication Service) is the only valid value for this parameter and it is required. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the mkauthpol command to an empty authentication policy.
dscli> mkauthpol -type sas my_policyname
mkuser
The mkuser command creates a DS CLI or a DS Storage Manager Basic authentication policy user account with a password and user group authority. Only users with security administrator authority can create user IDs in the security administrator role and cannot create an ID in any other group role. A user with administrator authority can create user IDs in any group role except security administrator.
mkuser -pw password -group group_name [ . . . ] -pol User_Name "-" pol_name
-scope
user_resource_scope
Parameters
-pw password (Required) Specifies the password that is assigned to the user that allows their use of the DS CLI command-line function. This password is temporary and expires after the initial use. The user must assign themselves a new password using the chuser command before they can use any other commands in the DS CLI.
70
password The password that is assigned by the administrator to a user. The password must meet the following criteria: v Must be at least the minimum length as set by an administrator and no longer than 16 characters. v Must contain at least two types of characters from the three groups: alphabetic, numeric, and symbols. v Allowable characters are: a-z, A-Z, 0-9, and the symbols !@#$%&*(). v Cannot contain the user ID of the user. | | | | | | | | | | | | | Note: If symbols are contained in your password, you might be required to enclose the password in quotation marks to prevent any special interpretations or expansions by the operating system shell program. Note: Even with a valid password, a user cannot interactively login when all of the following conditions are present: v The version of DS CLI used is pre-R6.1 v Entering the password without either the -passwd or -pwfile parameters v The DS CLI is operating in the Windows (all versions), Netware, or OpenVMS environments v The password contains anything other than alphabetic or numeric characters (that is, symbols) But if any of these conditions is not present, then the user should not encounter any problems in logging in with a valid password. -group group_name [...] (Required) Specifies the user's access authority group. v admin (Administrator) v op_storage (Physical Operator) v op_volume (Logical Operator) v v v v op_copy_services (Copy Services Operator) secadmin (Security Administrator) service (Service Operator) monitor (Monitor)
v no_access (No Access) -pol pol_name (Optional) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy. This parameter is not supported on DS6000 models. -scope user_resource_scope (Optional) Specifies the user resource scope, which must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). The default scope is * for users in both the administrator and the security administrator groups, and PUBLIC for users in all other authority groups. Example: Product_A
71
Note: The user resource scope is matched to one or more resource group IDs that are assigned to resource groups. If the resource group ID of a resource group matches the user resource scope, the user is authorized to issue Copy Services requests to a logical volume, LSS, or LCU that is assigned to the resource group. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access that LSS or LCU. User_Name | (Required) The user name of the new user that you are creating. | | | An account name must be between 1 and 64 characters in length and can include the alphanumeric characters (a-z, A-Z, 0-9), the period(.), the hyphen (-), the underscore (_), and letters from any other languages. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the mkuser command
dscli> mkuser -pw AB9cdefg -group service,op_copy_services pol my_policy1 testuser
rmauthpol
The rmauthpol command allows you to remove an authentication policy. This command is not supported on DS6000 models.
rmauthpol -quiet pol_name . . .
Parameters
-quiet (Optional) Turns off the removal confirmation prompt for this command. pol_name . . . | (Required) Specifies the name of the authentication policy that you want to remove. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmauthpol command to remove an authentication policy.
dscli> rmauthpol my_policy3
rmuser
The rmuser command removes a basic user account.
72
Only users with administrator authority can use this command to delete a user ID. Users with security administrator authority can only delete a user ID in the security administrator group role, while users with administrator authority can delete a user ID in any group role except security administrator .
rmuser -quiet -pol pol_name User_Name " - "
Parameters
-quiet (Optional) Turns off the removal confirmation prompt for this command. -pol pol_name (Optional - DS8000 only) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy. User_Name | (Required) Specifies the user name of the user account to be removed. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmuser command
dscli> rmuser pol my_policy1 testuser
setauthpol
The setauthpol command modifies policy attributes that apply to a specific type of authentication policy, changing the contents of the policy. This command is not supported on DS6000 models. To change attributes that are independent of the policy type, use the chauthpol command. Only users with security administrator authority can map a user ID or group to the security administrator group role. Users with security administrator authority cannot map a user ID or group to any other group role. A user with administrator authority can map a user ID, or group, to any group role except security administrator. Depending on the policy type and the action that is selected, all of the other parameters can vary in meaning. For this reason, the syntax diagrams and the parameter descriptions are separated by policy types and actions. If a parameter is not found under a specific policy type, then it does not apply to that policy type. Using setauthpol, you can map external users and groups to one or more authority groups and to a user resource scope. Notes: v You must have administrator authority and a user resource scope of '*' in the current policy to use this command.
73
v If an external user belongs to several external groups that map to more than one user resource scope, other than DEFAULT, then the user cannot logon unless there is also a mapping between the external user and one specific user resource scope. v The previous parameters -groupmap and -usermap, used with the addmap, rmmap, and setmap actions, are now deprecated but are still valid for use in commands. The new parameters -extgroup, -extuser, and -dsgroup replace the deprecated parameters, and cannot be used in the same command line with them.
setauthpol -action setauthserver addmap rmmap rmallmap setmap setsasuser settruststore
Each of the following sections shows the options for one of the listed -action parameters: -action setauthserver
setauthpol -action setauthserver -loc loc1 [,loc2...] pol_name -
-action addmap
setauthpol -action addmap -extgroup extgrp[,extgrp...]
-extuser
extuser[,extuser...]
-dsgroup pol_name -
dsgrp[,dsgrp...]
-scope
user_resource_scope
-action rmmap
setauthpol -action rmmap -extgroup extgrp[,extgrp...]
-extuser
extuser[,extuser...]
-dsgroup pol_name -
dsgrp[,dsgrp...]
-scope
user_resource_scope
-action rmallmap
setauthpol -action rmallmap -extgroup extgrp[,extgrp...]
74
-extuser
extuser[,extuser...]
-dsgroup pol_name -
dsgrp[,dsgrp...]
-scope
user_resource_scope
-action setmap
setauthpol -action setmap -extgroup extgrp[,extgrp...]
-extuser
extuser[,extuser...]
-dsgroup pol_name
dsgrp[,dsgrp...]
-scope
user_resource_scope
-action setsasuser
setauthpol -action setsasuser -username name -pw password pol_name -
-action settruststore
setauthpol -action settruststore -pw password -loc loc1 pol_name -
Action parameters
-action setauthserver (Required) Specifies the authentication server used in the policy. -action addmap (Required) Allows you to add to the mappings of external users or groups in the DS8000 authority group roles. Note: Either the -extgroup or -extuser (or both) parameters can be used in conjunction with either the -dsgroup or -scope (or both) parameters to add a mapping between the specified mapping pairs. -action rmmap (Required) Allows you to remove either all or specific mappings of external users or groups from the DS8000 authority group roles. Note: Either the -extgroup or -extuser (or both) parameters can be used in conjunction with either the -dsgroup or -scope (or both) parameters to remove the mapping between the specified mapping pairs. Any existing mappings that are not part of the specified parameters are not removed. -action rmallmap (Required) Allows you to remove multiple mappings of DS8000 authority group roles and/or user resource scope to external users or groups. -action setmap (Required) Allows you to map external users or groups to DS8000 authority group roles. If previous
Chapter 4. CLI commands
75
mappings are defined, the setmap action replaces them. Use the addmap action to add new mappings without replacing previous versions. All unspecified roles are unchanged. Note: Either the -extgroup or -extuser (or both) parameters can be used in conjunction with either the -dsgroup or -scope (or both) parameters to set the mapping between the specified mapping pairs. Any existing mappings for the specified keyword pairs are replaced by the specified mapping. -action setsasuser (Required) Specifies the storage authentication service (SAS) user. -action settruststore (Required) Specifies the location of the truststore file. You must specify the password to check the integrity of the keystore data, and to set the truststore. The table below includes all of the valid combinations of actions and parameters and their effects on the DS8000:
Table 5. setauthpol action and parameter combinations Action addmap rmmap rmallmap Parameter Group 1 -extgroup extgrp[,extgrp] -extuser extuser[,extuser] -extgroup extgrp[,extgrp] -extuser extuser[,extuser] -extgroup extgrp[,extgrp] -extuser extuser[,extuser] -dsgroup dsgrp[,dsgrp] -scope urs Parameter Group 2 -dsgroup dsgrp[,dsgrp] -dsgroup dsgrp[,dsgrp] -scope urs Effects Add mapping to existing maps Remove mapping from existing maps Remove specified values from all existing maps
setauthserver -loc url1[,url2] setmap setsasuser settruststore -extgroup extgrp[,extgrp] -extuser extuser[,extuser] -username name -loc filepath -dsgroup dsgrp[,dsgrp] -scope urs -pw password -pw password
Set location of authentication server Specify mapping to replace existing maps Set SAS user name and password Set location and password of trust store file
Parameter Definitions url1, url2 An IPv4, IPv6, or DNS-named IP address. filepath The full path name to the trust store file on the local system. urs The User Resource Scope.
76
pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action setmap: -extgroup extgrp[,extgrp...] (Optional) This action maps DS8000 authentication group roles (-dsgroup) and/or a user resource scope (-scope) to a specified list of external authentication group names (extgrp). Multiple group names are separated with commas without spaces. All unspecified external groups are unchanged. Example: ESS_ds1,ESS_ds2 -extuser extuser[,extuser...] (Optional) This action maps DS8000 authentication group roles (-dsgroup) and/or a user resource scope (-scope) to the specified list of external authentication user names (-extuser). Multiple user names are separated with commas without spaces. All unspecified external users are unchanged. Example: fred,sally -dsgroup dsgrp[,dsgrp...] (Optional) This action lists DS8000 authentication group roles (dsgrp) that consist of one or more of the following role names: "admin", "secadmin", "op_storage", "op_volume", "op_copy_services", "service", "monitor", and "no_access". Multiple role names are separated with commas without spaces. Example: op_volume,op_copy_services -scope user_resource_scope (Optional) Specifies the user resource scope, which must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). The default scope is * for users in the administrator and security administrator authority groups, and PUBLIC for users in all other authority groups. Example: Product_A Note: The user resource scope is matched to one or more resource group IDs that are assigned to resource groups. If the resource group ID of a resource group matches the user resource scope, the user is authorized to issue Copy Services requests to a logical volume, LSS, or LCU that is assigned to the resource group. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access that LSS or LCU. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action addmap: -extgroup extgrp[,extgrp...] (Optional) This action maps DS8000 authentication group roles (-dsgroup) and user resource scope (-scope) to a specified list of external authentication group names (extgrp). Multiple group names are separated with commas without spaces. All unspecified external groups are unchanged. Example: ESS_ds1,ESS_ds2
77
-extuser extuser[,extuser...] (Optional) This action maps DS8000 authentication group roles (-dsgroup) and user resource scope (-scope) to the specified list of external user (-extuser). Multiple user names are separated with commas without spaces. All unspecified external users are unchanged. Note: Use of this parameter is not recommended for maintenance reasons. Example: fred,sally -dsgroup dsgrp[,dsgrp...] (Optional) This action lists DS8000 authentication group roles (dsgrp) that consist of one or more of the following role names: "admin", "secadmin", "op_storage", "op_volume", "op_copy_services", "service", "monitor", and "no_access". Multiple role names are separated with commas without spaces. Example: op_volume,op_copy_services -scope user_resource_scope (Optional) Specifies the user resource scope, which must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). The default scope is * for users in the administrator authority group, and PUBLIC for users in all other authority groups. Example: Product_A Note: The user resource scope is matched to one or more resource group IDs that are assigned to resource groups. If the resource group ID of a resource group matches the user resource scope, the user is authorized to issue Copy Services requests to a logical volume, LSS, or LCU that is assigned to the resource group. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access that LSS or LCU. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action rmmap: -extgroup extgrp[,extgrp...] (Optional) This action unmaps DS8000 authentication group roles (-dsgroup) and user resource scope (-scope) to a specified list of external authentication group names (extgrp). Multiple group names are separated with commas without spaces. All unspecified external groups are unchanged. Example: ESS_ds1,ESS_ds2 -extuser extuser[,extuser...] (Optional) This action unmaps DS8000 authentication group roles (-dsgroup) and user resource scope (-scope) to the specified list of external users (-extuser). Multiple user names are separated with commas without spaces. All unspecified external users are unchanged. Note: Use of this parameter is not recommended for maintenance reasons. Example: fred,sally -dsgroup dsgrp[,dsgrp...] (Optional) This action lists DS8000 authentication group roles (dsgrp) that consist of one or more of
78
the following role names: "admin", "secadmin", "op_storage", "op_volume", "op_copy_services", "service", "monitor", and "no_access". Multiple role names are separated with commas without spaces. Example: op_volume,op_copy_services -scope user_resource_scope (Optional) Specifies the user resource scope, which must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). The default scope is * for users in the administrator authority group, and PUBLIC for users in all other authority groups. Example: Product_A Notes: 1. The user resource scope is matched to one or more resource group IDs that are assigned to resource groups. If the resource group ID of a resource group matches the user resource scope, the user is authorized to issue Copy Services requests to a logical volume, LSS, or LCU that is assigned to the resource group. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access that LSS or LCU. 2. When a scope mapping is removed from a -extuser or -extgroup, the default scope will still apply. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action rmallmap: -extgroup extgrp[,extgrp...] (Optional) Specifies that all maps with the external groups specified by this parameter are removed. Multiple group names are separated with commas without spaces. All unspecified external groups are unchanged. Example: ESS_ds1,ESS_ds2 -extuser extuser[,extuser...] (Optional) Specifies that all maps with the external users specified by this parameter are removed. Multiple user names are separated with commas without spaces. All unspecified external users are unchanged. Note: Use of this parameter is not recommended for maintenance reasons. Example: fred,sally -dsgroup dsgrp[,dsgrp...] (Optional) Specifies that all maps with the DS8000 groups specified by this parameter are removed. DS8000 authentication group roles (dsgrp) consist of one or more of the following role names: "admin", "secadmin", "op_storage", "op_volume", "op_copy_services", "service", "monitor", and "no_access". Multiple role names are separated with commas without spaces. Example: op_volume,op_copy_services
79
-scope user_resource_scope (Optional) Specifies that all maps with the scope specified by this parameter are removed. The user resource scope must meet the following criteria: v Must be 1 to 32 characters long v The characters are limited to upper and lower case alphabetic, numeric, and the special characters, dash ( - ), underscore ( _ ), and period ( . ). You can also define the scope as a single asterisk ( * ). The default scope is * for users in the administrator authority group, and PUBLIC for users in all other authority groups. Example: Product_A Notes: 1. The user resource scope is matched to one or more resource group IDs that are assigned to resource groups. If the resource group ID of a resource group matches the user resource scope, the user is authorized to issue Copy Services requests to a logical volume, LSS, or LCU that is assigned to the resource group. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access that LSS or LCU. 2. When a scope mapping is removed from a -extuser or -extgroup, the default scope will still apply. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action settruststore: -pw password (Optional) Specifies the truststore password. -loc loc1 (Optional) Specifies the local truststore file location. Only one truststore location can be specified. Example: c:\mystore\trust.dat pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Parameters for -action setsasuser: -username name (Optional) Specifies the user name that is used internally by SAS (Storage Authentication Service). Only one user name can be specified. -pw password (Optional) Specifies the user name password used internally by SAS. pol_name | (Required) Specifies the name of the authentication policy. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
80
Example
The difference between the previous and new syntax for specifying users and groups v Previous syntax
dscli> setauthpol action addmap groupmap admin:Admins/monitor:Admins,Users
v New syntax
dscli> setauthpol action addmap extgroup Admins dsgroup admin dscli> setauthpol action addmap extgroup Admins,Users dsgroup monitor
Remove all mappings between the external group 'Dept54' and all internal DS0000 groups and/or scope
dscli> setauthpol action rmallmap extgroup Dept54
setrmpw
The setrmpw command (DS8000 only) changes the IBM Tivoli Storage Productivity Center Replication Manager password. Only a person who has administrator authority can invoke this command.
setrmpw -dev storage_image_ID -server 0 1 both -rmpw RM_password
Parameters
-dev storage_image_ID (Required) Specifies the storage image ID, which consists of the values for manufacturer, machine type, and serial number. The storage image ID is required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. -server 0 | 1| both (Optional) Specifies the server where the password is changed. The default is both. -rmpw RM_password (Required) Specifies the new Replication Manager password. The password must meet the following criteria: v The password must contain a minimum of 5 alphabetic characters and 1 numeric character. v The password must begin and end with an alphabetic character. v The alphabetic characters must be entered in uppercase and the password is case sensitive. v The password cannot contain the user name of the account that it is for. v Allowable characters are: a-z, A-Z, 0-9, and the symbols !@#$%&*().
Example
Note: If you do not specify the -rmpw parameter on your command line, you are asked twice to supply the Replication Manager password after you have entered the setrmpw command. Invoking the setrmpw command
Chapter 4. CLI commands
81
showauthpol
The showauthpol command displays detailed properties of a specified authentication policy. This command is not supported on DS6000 models.
showauthpol -map -revmap pol_name | -
Parameters
-map (Optional) Displays tables with mappings of Basic authorization group roles and user resource scopes to external groups and users in the specified policy. No table is displayed if there are no mapping relationships in the specified policy. Note: The -map and -revmap parameters cannot be used together. -revmap (Optional) Displays tables with mappings of external groups and users to Basic authorization group roles and user resource scopes in the specified policy. No table is displayed if there are no mapping relationships in the specified policy. Note: The -map and -revmap parameters cannot be used together. pol_name | (Required) Specifies the name of the authentication policy that you would like to view. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. | Example 1 | Invoking the showauthpol command to view the detailed properties of a specified authentication | policy. | dscli> showauthpol my_policy2 | The resulting output | | | | | | | | |
name type state location truststore sasuser my_policy2 SAS inactive 9.11.xxx.xxx my_policy2_trustStore.jks Table 6. .
82
Example 2
Invoking the showauthpol command to view the detailed properties of a specified authentication policy using the -map parameter.
dscli> showauthpol -map my_policy2
Example 3
Invoking the showauthpol command to view the detailed properties of a specified authentication policy using the -revmap parameter.
dscli> showauthpol -revmap my_policy2
83
9.11.xxx.xxx my_policy2_trustStore.jks -
84
Length Specifies the minimum length of a password. History Specifies the number of unique passwords that a user must go through before reusing a password. For a SAS type policy, the following properties are displayed: Name Specifies the name of the authentication policy. Type Specifies the authentication policy type. State Specifies the state of the authentication policy (active or inactive). Location Specifies the URL for the authentication server. Multiple locations are separated by commas. truststore Specifies the truststore file name. sasuser Specifies the user name used internally by SAS (Storage Authentication Service). The -map and -revmap are mutually exclusive, but both display the mapping from external users and groups to DS8000 user role groups and user resource scopes. The-map parameter displays this information from the DS8000 point of view and is useful for answering questions like, Which external users and groups map to the DS8000 role group administrator? The -revmap parameter displays the same information, but from the external point of view and is useful answering questions like, Which DS8000 user role groups and user resource scope map to the external group Human_Resources? The following additional properties are displayed when the -map parameter is specified: Role Group Maps DS_group Displays the name of the DS8000 authority group. The user authority group can consist of one or more of one of the following roles: admin, secadmin, op_storage, op_volume, op_copy_services, service, monitor, or no_access. Ext_group Displays the external groups that are mapped to each selected DS8000 authority group. Multiple external group names are separated by commas. Role User Maps DS_group Displays the name of the DS8000 authority group. The user authority group can consist of one or more of the following roles: admin, op_storage, op_volume, op_copy_services, service, monitor, or no_access. Ext_user Displays the external users that are mapped to each selected DS8000 authority group. Multiple external user names are separated by commas. Scope Group Maps Scope Displays the user resource scope.
85
Ext_group Displays the external group names that are mapped to each user resource scope. Multiple external group names are separated by commas. Scope User Maps Scope Displays the user resource scope. Ext_user Displays the external users that are mapped to each user resource scope. Multiple external user names are separated by commas. The following additional properties are displayed when the -revmap parameter is specified: Role Group Maps Ext_group Display one or more external group names. DS_group Display the DS8000 authority group names that are mapped to each external group name. Multiple external group names are separated by commas. Role User Maps Ext_user Displays one or more external users. DS_group Displays the DS8000 authority group names that are mapped to each external group name. Multiple external group names are separated by commas. Scope Group Maps Ext_group Specifies the name of the DS8000 authority group. The user authority group can consist of one or more of the following roles: admin, op_storage, op_volume, op_copy_services, service, monitor, or no_access. Scope Displays the user resource scope that is mapped to each external group name. Scope User Maps Ext_group Specifies the name of the DS8000 authority group. The user authority group can consist of one or more of the following roles: admin, op_storage, op_volume, op_copy_services, service, monitor, or no_access. Scope Displays the user resource scope that is mapped to each external group name.
showpass
The showpass command lists the properties of passwords.
showpass -pol pol_name
86
Parameters
-pol pol_name (Optional) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy.
Example
Invoking the showpass command
dscli> showpass pol my_policy1
showuser
The showuser command displays details for basic user accounts. A CLI user with administrative authority uses this command to display the properties (group assignment, user account status and number of failed logins) that are associated with a current user account.
showuser -pol pol_name User_Name " - "
Parameters
-pol pol_name (Optional - DS8000 only) Specifies the name of the basic authentication policy. This parameter is optional if you have authenticated with a 'basic' authentication policy type, but it is required if you are authenticated with another type of authentication policy. User_Name | (Required) Specifies the name of the user account .
87
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format for clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output reports that are associated with the showuser command. Invoking the showuser command
dscli> showuser pol my_policy1 testuser
DaysToExpire
Scope
testauthpol
The testauthpol command allows you to test the specified authentication policy. This command is not supported on DS6000 models.
testauthpol -username user_name -pw password pol_name | -
-scope
resource_scope
-group
dsgroup1[,dsgroup2,...]
88
Parameters
-username user_name (Required) Specifies the user name for the authentication policy that is being tested. For example, if the current policy is Policy1 and you want to test Policy2, then you must be logged in with an administrator user account in Policy1, and provide a valid user name and password for Policy2. -pw password (Required) Specifies the password for the user name in the policy being tested. pol_name | (Required) Specifies the authentication policy that you want to test. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. -scope resource_scope (Optional) Specifies the expected scope that the user is associated with. The test will succeed if the user is associated with the scope. The scope mappings can be set and changed using the setauthpol command. -group dsgroup1[,dsgroup2,...] (Optional) Specifies the expected groups that the user belongs to. The test will succeed if the user is part of each of the specified groups. The group mappings can be set and changed using the setauthpol command.
Example
Invoking the testauthpol command to test a specified authentication policy.
dscli> testauthpol username admin pw test2ibm my_policy2
who
The who command displays authentication information for the users who are currently logged in.
who -s -l -group group_name -pol pol_name -type client_type
-address
client_address
user_name "-"
Parameters
-s (Optional) Displays the user names for the users who are currently logged on. The -l and -s parameters cannot be used together. -l (Optional) Displays details about the users who are currently logged on, including user name and authority groups that the user belongs to. The -l and -s parameters cannot be used together. -group group_name (Optional) Displays the list of users who are currently logged in and who are part of the specified access authority group. If the user has multiple group roles, the user will be displayed if any of those roles match the specified group.
Chapter 4. CLI commands
89
group_name [...] The following list provides the list choices that can be assigned to a user. The group_name can be one of the following roles: v v v v v v v v admin (Administrator) op_storage (Physical Operator) op_volume (Logical Operator) op_copy_services (Copy Services Operator) secadmin (Security Administrator) service (Service Operator) monitor (Monitor) no_access (No Access)
-pol pol_name (Optional) Displays the list of users who are currently logged in under the specified client type. -type client_type (Optional) Displays the list of users who are currently logged in and who have the specified client type. One of the following client types are displayed: DSCIM DS open application programming interface DSCLI DS Command Line Interface DSGUI DS Storage Manager Interface TPC TPC-R IBM TotalStorage Productivity Center for Replication Unknown Unknown might be displayed for older versions of any of the client types listed above. -address client_address (Optional) Displays the users who are currently logged in with the specified client address. user_name | (Optional) Displays only the users names for the specified user account. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. IBM TotalStorage Productivity Center for Disk
Example
Invoking the who command to view authentication information for the users who are currently logged in.
dscli> who
90
whoami
The whoami command displays authentication information for the current user. This command is not supported on DS6000 models.
whoami -s -l
Parameters
-s (Optional) Provides the user name of the current user. The -l and -s parameters cannot be used together. -l (Optional) Provides details about the current user, including user name and authority groups that the user belongs to. The -l and -s parameters cannot be used together.
Example
Invoking the whoami command to view authentication information for the current user.
dscli> whoami
91
chaccess
The chaccess command allows you to change one or more access settings of a hardware management console (HMC). Only users with administrator authority can access this command.
chaccess -cmdline enable disable -wui enable disable -modem enable disable
-hmc
1 2 all
Parameters
-cmdline enable | disable (Optional) Specifies whether you want to enable or disable the command line shell access to the HMC via the Internet or a VPN connection. This command affects service access only and does not change access to the machine via the DS Command Line Interface. -wui enable | disable (Optional) Specifies whether you want to enable or disable the Web User Interface (WUI) access on the HMC via the Internet or a VPN connection. This command affects service access only and does not change access to the machine via the DS Storage Manager. -modem enable | disable (Optional) Specifies whether you want to enable or disable the modem dial-in and VPN initiation to the HMC. -hmc 1 | 2 | all (Optional) Specifies to which HMC you want the access settings to apply. hmc 1 specifies the primary HMC, and hmc 2 specifies the secondary HMC. The default value (all) specifies the primary HMC on a single HMC system, and both the primary and secondary HMCs on a dual HMC system.
Example
Invoking the chaccess command
dscli> chaccess cmdline enable wui enable -hmc 1
92
lsaccess
The lsaccess command displays the access settings of a hardware management console (HMC).
lsaccess -hmc 1 2 all
Parameters
-hmc 1 | 2 | all (Optional) Specifies for which HMC you want the access settings to be displayed. hmc 1 specifies the primary HMC, and hmc 2 specifies the secondary HMC. The default value (all) specifies the primary HMC on a single HMC system, and both the primary and secondary HMCs on a dual HMC system.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsaccess command using the -hmc parameter.
Invoking the lsaccess command to display a list of the HMC access settings.dscli> lsaccess -hmc all
93
applykey
The applykey command applies the licensed machine code (LMC) activation keys for a storage server. You can enter the LMC keys manually, or you can import the keys from an XML file, which you must | download. For additional information about downloading the XML file and activating the LMC keys, see | Activating your machine and feature licenses using the DS CLI on page 34.
applykey -key key [...] -file file_name storage_image_ID " - "
Parameters
-key key [...] (Optional) Specifies the LMC key. To specify multiple keys, enter a comma between each key. Do not include a blank space between each key. This parameter is required if the -file parameter is not specified. -file file_name (Optional) Specifies the file name of the LMC activation key file. This parameter is required if the -key parameter is not specified. storage_image_ID | (Required) Specifies the storage image ID where the LMC activation key file is imported. The ID includes manufacturer, machine type, and serial number. If you use the dash (-), the specified value is read from standard input.
Example
Invoking the applykey command (importing the key)
dscli> applykey -file keys.xml IBM.2107-75FA120
Example
Invoking the applykey command (manually entering the key)
dscli> applykey -key DA67-7D5C-4B98-2E1B-C7FA-8F85-BD8A-31AD IBM.2107-75FA120
lskey
The lskey command displays the type of LMC activation keys that are installed and are available for use by the storage unit.
94
The lskey command only displays the keys that are installed. Refer to the IBM System Storage DS8000 Introduction and Planning Guide for more information on how to choose which keys are needed and how to acquire them.
lskey storage_image_ID " "
Parameters
storage_image_ID | (Required) Specifies the storage image ID for which to view a list of activated features. The ID includes manufacturer, type, and serial number. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format for clarity. The actual reports do not display as tables. The following table shows example activation keys. Some activation keys are not listed in the example. The lskey command displays only the keys that are installed. | Invoking the lskey command to display a list of the installed LMC activation keys.
dscli> lskey IBM.2107-75FA120
Metro Mirror (MM), (not available for 25 DS6000 models) Remote mirror and copy (RMC) Remote mirror for z/OS (RMZ) DS8000 I/O Priority Manager Operating Environment (OEL) IBM System Storage Easy Tier IBM FlashCopy SE (not available for DS6000 models) 25 25.1 25 45 On 25
High Performance FICON for System On z (zHPF) (not available for DS6000 models) RMZ Resync (not available for DS6000 models) 25
CKD
95
96
rmkeygrp Removes an entry for the key server encryption key group on a specified storage image. rmkeymgr Removes a key server entry on the storage complex. rmreckey Allows you to remove an encryption recovery key. showkeygrp Displays detailed information for a specified key server encryption key group entry on the storage image.
chkeymgr
The chkeymgr command updates the attributes of the key server entry on the storage complex. This command is not supported on DS6000 models.
chkeymgr -state active inactive key_server_ID " - "
Parameters
-state active | inactive (Optional) Updates the state of the key server. key_server_ID | (Required) Specifies the key server ID. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> chkeymgr -state inactive 1 The resulting output
The key server 1 configuration has been changed.
lskeygrp
The lskeygrp command displays a list of the key server encryption key group entries on the specified storage image. This command is not supported on DS6000 models.
lskeygrp -dev storage_image_ID -s -l -state accessible inaccessible unconfigured rekeying
97
-reckeystate
configured newkeyveripend newkeyauthpend rekeyveripend rekeyauthpend recovauthpend deconfauthpend disabled enableauthpend disableauthpend
Encryption_Group_ID . . . "-"
Parameters
-dev storage_image_ID (Optional) Displays key group entries for the specified storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional). Displays only the attributes that are identified as short output. You cannot use the -s and the -l parameters together. -l (Optional). Displays the default output and additional attributes that are identified as long output. You cannot use the -l and the -s parameters together. -state accessible | inaccessible | rekeying (Optional) Specifies the state of the encryption group. -reckeystate accessible | newkeyveripend | newkeyauthpend | rekeyveripend | rekeyauthpend | recovauthpend | deconfauthpend | disabled | enableauthpend | disableauthpend (Optional) Specifies encryption groups with the specified recovery key state. Encryption_Group_ID. . . |" - " (Optional) Specifies the ID for the encryption group that you want to view. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
| Invoking the lskeygrp command to display a list of the key server encryption key groups. dscli> lskeygrp -dev IBM.2107-75FA120 -l 1 The resulting output
ID 1 state accessible reckeystate configured reckeydate 03/31/2009 datakeydate 03/31/2009 label MyCompany label2 MyCompany2
98
state Specifies one of the following states of the encryption group: accessible The encryption group is accessible if it has been configured and the storage image has obtained the encryption key from the key server for the encryption group. inaccessible The encryption group is inaccessible if the storage image was unable to obtain the encryption key from the key server. unconfigured The encryption group is unconfigured if it has not been configured. rekeying The encryption group is accessible and rekeying if it has been configured and the storage image has obtained the encryption key from the key server for the encryption group and is currently in the middle of rekeying. reckeystate Specifies one of the following states of the recovery key: configured A new recovery key has been requested, verified, and authorized. unconfigured A recovery key has not been created. newkeyveripend A new recovery key has been requested but not verified. newkeyauthpend A new recovery key has been requested and verified, but not authorized. rekeyveripend A new recovery key action has been requested but not verified. rekeyauthpend A new recovery key action has been requested and verified, but not authorized. recovauthpend A recover action has been requested, but not authorized. deconfauthpend A deconfigure action has been requested, but not authorized. disabled A recovery key has been disabled, and the encryption group will be used without a recovery key. enableauthpend An enable action has been requested, but not authorized. disableauthpend A disable action has been requested, but not authorized. reckeydate The date of the last recovery key creation. datakeydate The date of the last data key creation. If the encryption group is unconfigured, then any displayed date is to be considered erroneous data.
99
label Specifies the label for the key server encryption key group. Due to the possible length of the label value, this column will always be the second to last column even as new columns are added to the output in the future. Example: MyCompany label2 Specifies the second label for the key server encryption key group. Due to the possible length of the label2 value, this column will always be the last column even as new columns are added to the output in the future. Example: MyCompany2
lskeymgr
The lskeymgr command displays a list of the key server entries that are on the storage complex. This command is not supported on DS6000 models.
lskeymgr -s -l -port port_ID -state active inactive
-status
-addr
IP_address
. . .
Parameters
| -s (Optional) Displays the key server IDs. | -l (Optional) Displays the default output. -port port_ID (Optional) Displays the key servers that use the port ID that you specify. The key server port ID is four or five decimal characters. For example, 8100 is a valid port ID. -state active | inactive (Optional) Displays the key servers that are in the state that you specify. -status normal | hmc1_degraded | hmc2_degraded | (Optional) Displays the status of the key server path. failed
-addr IP_address (Optional) Displays the key server that uses the IP address you specify. The IP address can be an IPv4 address, an IPv6 address, or a DNS name. key_server_ID . . . | (Optional) Displays the key servers that use the ID or IDs you specify. To include multiple IDs, separate each ID with a blank space. For example, 1 2 3 4. If you use the ( - ) dash option, this value can be read from standard input.
Example
| Invoking the lskeymgr command to display a list of the key servers. dscli> lskeymgr 1 2 The resulting output
ID state status addr port 1 active normal my_address1 3801 2 active normal my_address2 3801
100
managekeygrp
The managekeygrp command allows you to manage an encryption key group. This command is not supported on DS6000 models.
managekeygrp -dev storage_image_ID -action rekey -key data
-label
encryption_group_ID -
Parameters
-dev storage_image_ID (Optional) Displays the properties for the specified storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -action rekey (Required) Use this parameter to rewrap the encryption group key specified by the -key parameter. -key data (Optional) Use this parameter to specify that the encryption key group data key will be rewrapped with the rekey action. The key can be rewrapped with either new or existing key labels. This parameter is required when using the rekey action. -label key_label (Optional) Use this parameter to specify the label for the encryption key group data key. This parameter is required when using the -label2 parameter. You can enter a maximum of 64 ASCII characters for the label. -label2 second_key_label (Optional) Use this parameter to specify the second label for the encryption key group data key. You can enter a maximum of 64 ASCII characters for the label.
101
encryption_group_ID | " - " (Required) Specifies the ID for the encryption group. The encryption group ID is a decimal number that ranges from 1 to N, where N is the maximum number of encryption groups supported by the DS8000. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> managekeygrp dev IBM.2107-75FA120 -action rekey -key data -label companyABC -label2 companyXYZ 1 The resulting output
CMUCFFFFFI managekeygrp: The rekey action has been performed for key server encryption group 1.
managereckey
The managereckey command allows you to manage an existing encryption recovery key. This command is not supported on DS6000 models.
managereckey -dev storage_image_ID -action verify rekey recover cancel validate authorize enable disable
-key
the_key
encryption_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -action verify | rekey | recover | cancel | validate | authorize | enable | disable (Required) Specifies the action to perform on the encryption recovery key. Verify The verify option is for users with security administrator authority, and is the second step in creating an Encryption Recovery Key or re-creating an existing Encryption Recovery Key. Verify that you have received the new Recovery Key from the first step (mkreckey, or managereckey with the -rekey option), by specifying that new key with the -key parameter. The next step requires the storage administrator to authorize the pending operation. Rekey The rekey option is for users with security administrator authority, and is the first step to reconfigure an existing Encryption Recovery Key. The existing Encryption Recovery Key is not required to start the rekey operation. The next step requires the security administrator to verify the new recovery key.
102
Recover The recover option is for users with security administrator authority, and is the first step to utilizing the Encryption Recovery Key to recover access to the encrypted data on the DS8000. The user specifies the Encryption Recovery Key with the -key parameter. The next step requires the storage administrator to authorize the recover operation. Cancel The cancel option is for users with either security administrator or storage administrator authority to cancel any verification or authorization pending steps. The existing Encryption Recovery Key is not required and no further steps are required. Validate The validate option is for users with security administrator authority, and is used to ensure that the existing Encryption Recovery Key is identical to the recovery key that is in the user's possession. The user specifies the Encryption Recovery Key in their possession with the -key parameter, but no further steps are required. Authorize The authorize option is for users with storage administrator authority, and is the final step of most recovery key operations. Once authorized, the pending recovery key operation is completed and any resulting changes to the DS8000 are started. The existing Encryption Recovery Key is not required and no further steps are required. Enable The enable option is for users with security administrator authority, and is the first step to enable the Encryption Recovery Key for the given encryption group. The Recovery Key only needs to be enabled if it has been previously disabled. The existing Encryption Recovery Key is not required. The next step requires the storage administrator to authorize the pending operation. Disable The disable option is for users with security administrator authority, and is the first step to disable the Encryption Recovery Key for the given encryption group. The existing Encryption Recovery Key is not required. The next step requires the storage administrator to authorize the pending operation. After that, the group will operate without an Encryption Recovery Key, and will not be recoverable with a Recovery Key. -key the_key (Optional) Specifies the encryption recovery key. The encryption recovery key is a string of 64 hexadecimal characters. For example, 01F3-45A7-8D12-B586-0123-4C67-891E-3586-01A3-45E7-8D123586-0123-45C7-8912-3B86. encryption_group_ID | (Required) Specifies the encryption group ID for the encryption recovery key that you want to manage. The encryption group ID is a decimal number that ranges from 1 to N, where N is the maximum number of encryption groups supported by the DS8000. Use the showsi command to determine this maximum number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> managereckey -dev IBM.2107-75FA120 -action verify -key 0123-4567-8912-3586-0123-45678912-3586-0123-4567-8912-3586-0123-4567-8912-3586 1 The resulting output
The Recovery Key for encryption group 1 has been verified, authorization pending.
103
mkkeygrp
The mkkeygrp command creates an entry for the key server encryption key group on the storage image. This command is not supported on DS6000 models.
mkkeygrp -dev storage_image_ID -label key_label -label2 second_key_label
Encryption_Group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -label key_label (Required) Specifies the label for the encryption key group data key. You can enter a maximum of 64 ASCII characters for the label. -label2 second_key_label (Optional) Specifies the second label for the encryption key group data key. You can enter a maximum of 64 ASCII characters for the label. Encryption_Group_ID | (Required) Specifies the ID for the encryption group. The encryption group ID is a decimal number that ranges from 1 to N, where N is the maximum number of encryption groups supported by the DS8000. Use the showsi command to determine this maximum number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> mkkeygrp -dev IBM.2107-75FA120 -label MyCompany -label2 MyCompany2 1 The resulting output
The key server encryption key group 1 has been created.
mkkeymgr
The mkkeymgr command creates an entry for the key server on the storage complex. This command is not supported on DS6000 models.
mkkeymgr -port port_ID -state active inactive -addr IP_address
key_server_ID "-"
104
Parameters
-port port_ID (Optional) Specifies the key server port ID. The key server port ID is four or five decimal characters. For example, 8100 is a valid port ID. -state active | inactive (Optional) Specifies the state of the key server. -addr IP_address (Required) Specifies the IP address for the key server. The IP address can be an IPv4 address, an IPv6 address, or a DNS name. key_server_ID | (Required) Specifies the key server ID. The key server ID is a decimal number that ranges from 1 to N, where N is the maximum number of key servers that the DS8000 can support. Use the showsp command to determine this maximum number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> mkkeymgr -addr 9.11.56.78 4 The resulting output
The key server 4 has been created successfully.
mkreckey
The mkreckey command is for users with security administrator authority. It is the first step in creating a new Encryption Recovery Key when no key currently exists. If a key does exist, the security administrator must use the managereckey -action rekey command to rekey an existing key. The command returns the new key which the security administrator should copy to a safe place. The next step requires a security administrator to verify the new recovery key with the managereckey command. This command is not supported on DS6000 models.
mkreckey -dev storage_image_ID encryption_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. encryption_group_ID | (Required) Specifies the encryption group ID for the new encryption recovery key that you want to create. The encryption group ID is a decimal number that ranges from 1 to N, where N is the maximum number of encryption groups supported by the DS8000. Use the showsi command to determine this maximum number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
105
Example
An invocation example dscli> mkreckey -dev IBM.2107-75FA120 1 The resulting output
The Recovery Key 0123-4567-8912-3586-0123-4567-8912-3586-01 23-4567-8912-3586-0123-4567-8912-3586 for encryption group 1 has been created, verification pending.
rmkeygrp
The rmkeygrp command removes an entry for the key server encryption key group on a specified storage image. This command is not supported on DS6000 models.
rmkeygrp -dev storage_image_ID -quiet " - " encryption_group_ID . . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the removal confirmation prompt for this command. encryption_group_ID (Required) Specifies the ID for the encryption group. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> rmkeygrp -dev IBM.2107-75FA120 1 The resulting output
Are you sure you want to delete the key server encryption group 1? y/n y The key server encryption group 1 has been deleted.
rmkeymgr
The rmkeymgr command removes a key server entry on the storage complex. This command is not supported on DS6000 models.
rmkeymgr -quiet key_server_ID " - " . . .
106
Parameters
-quiet (Optional) Turns off the removal confirmation prompt for this command. key_server_ID . . . | (Required) Deletes the key servers with the specified key server ID. You must separate multiple IDs or ID ranges with a space between each value. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> rmkeymgr 1 The resulting output
Are you sure you want to delete key server entry 1? y/n y The key server 1 has been deleted.
rmreckey
The rmreckey command allows you to remove an encryption recovery key. This command is not supported on DS6000 models.
rmreckey -dev storage_image_ID encryption_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. encryption_group_ID | (Required) Specifies the encryption group ID for the encryption recovery key that you want to deconfigure. The encryption group ID is a decimal number that ranges from 1 to N, where N is the maximum number of encryption groups supported by the DS8000. Use the showsi command to determine this maximum number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
An invocation example dscli> rmreckey -dev IBM.2107-75FA120 -1300861 1 The resulting output
The Recovery Key for encryption group 1 will be de-configured after authorization.
107
showkeygrp
The showkeygrp command displays detailed information for a specified key server encryption key group entry on the storage image. This command is not supported on DS6000 models.
showkeygrp -dev storage_image_ID Encryption_Group_ID "-"
Parameters
-dev storage_image_ID (Optional) Displays the properties for the specified storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. Encryption_Group_ID (Required) Specifies the ID for the encryption group.
Example
An invocation example dscli> showkeygrp -dev IBM.2107-75FA120 1 The resulting output
ID numranks numpools state reckeystate reckeydate datakeydate label label2 1 1 1 accessible unconfigured 05/15/2009 16:37:46 CST 03/31/2009 16:57:13 CST MyCompany MyCompany2
108
inaccessible The encryption group is inaccessible if the storage image was unable to obtain the encryption key from the key server. unconfigured The encryption group is unconfigured if it has not been configured. rekeying The encryption group is accessible and rekeying if it has been configured and the storage image has obtained the encryption key from the key server for the encryption group and is currently in the middle of rekeying. reckeystate configured A new recovery key has been requested, verified, and authorized. unconfigured A recovery key has not been created. newkeyveripend A new recovery key has been requested but not verified. newkeyauthpend A new recovery key has been requested and verified, but not authorized. rekeyveripend A new recovery key action has been requested but not verified. rekeyauthpend A new recovery key action has been requested and verified, but not authorized. recovauthpend A recover action has been requested, but not authorized. deconfauthpend A deconfigure action has been requested, but not authorized. disabled A recovery key has been disabled, and the encryption group will be used without a recovery key. enableauthpend An enable action has been requested, but not authorized. disableauthpend A disable action has been requested, but not authorized. reckeydate The date and time of the last recovery key creation. datakeydate The date and time of the last data key creation. If the encryption group is unconfigured, then any displayed date is to be considered erroneous data. label Specifies the label for the key server encryption key group. Example: MyCompany
label2 Specifies the second label for the key server encryption key group. Example: MyCompany2
109
Displays a report that lists the device adapters (DA) for each storage image and the status of each device adapter in the list. This command is not supported on DS6000 models. Displays a report that lists the disk drive modules and status information for each disk drive module in the list. Generates a report that displays a list of the frame enclosures for a storage image. This command is not supported on DS6000 models.
lshba
Displays a report that lists the storage image host adapters and status information for each host adapter in the list. This command is not supported on DS6000 models.
lsstgencl Generates a report that displays a list of the storage enclosures and status information for each enclosure in the list.
lsda
The lsda command displays a list of device adapters (DA) for each storage image. You can use this command to look at the status of each device adapter in the list. This command is not supported on DS6000 models.
lsda -s -l -encl enclosure_ID -server server_ID -dapair dapair_ID
Parameters
-s (Optional) Displays only device adapter IDs. You cannot use the -l and the -s parameters together. -l | | (Optional) Displays the default output, plus the I/O enclosure and device adapter locations, feature codes, and interface IDs. You cannot use the -l and the -s parameters together. -encl enclosure_ID (Optional) Displays the device adapters that are associated with the specified processor complex or I/O enclosure. -server server_ID (Optional) Displays only device adapters that are associated with the specified server. -dapair dapair_ID (Optional) Displays only device adapters that are associated with the specified device adapter pair. -state online | offline | failed | loopx (Optional) Displays only device drivers in the specified state. storage_image_ID . . . | (Required) Displays device adapters for the specified storage images. A storage image ID includes a value for the manufacturer, machine type, and serial number. You must separate multiple IDs with spaces. Note: You cannot specify ID ranges.
110
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsda command. Invoking the lsda command
dscli> lsda -l IBM.2107-75FA120
Server 00 01 00 01
111
v v v v v v v v v v v
Offline Loop 3 Offline Loop 4 Offline Loop 1/2 Offline Loop 3/4 Taking down Loop 1 Taking down Loop Taking down Loop Taking down Loop Taking down Loop Taking down Loop Bring up all loops 2 3 4 1/2 3/4
| Loc+ Specifies the I/O enclosure and the device adapter location. The I/O enclosure location format is Uttt.mmm.ppsssss. The device adapter location format is Pn-Cn where Pn indicates the Planner number (1) and Cn indicates the card number (1 - 6). FC+ Specifies the feature code that is used to order the specified device adapter. Server Specifies the server or device adapter group to which the device adapter is assigned. DA pair Specifies the storage unit ID that is followed by the device adapter pair ID that is associated with the specified device adapter. The device adapter pair identifier is a two-digit decimal number, with no leading zeros. Device adapter pairs are located in I/O enclosure pairs. Device adapter pair ID implies I/O enclosure location. An even numbered device adapter pair ID indicates the first device adapter pair in an I/O enclosure pair. An odd numbered device adapter pair ID indicates the second device adapter pair in an IO enclosure pair. | Interfs+ Specifies the four interface IDs that are associated with the FC-AL ports. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
lsframe
The lsframe command displays a list of frame enclosures for a storage image. This command is not supported on DS6000 models.
lsframe -s -l storage_image_ID . . . " - "
Parameters
-s Displays the rack enclosure ID. You cannot use the -l and the -s parameters together.
112
| |
-l Displays default output plus the frame ID and location of the frame enclosure. You cannot use the -l and the -s parameters together. storage_image_ID . . . | Displays frame enclosure information for the specified storage image IDs. A storage image ID includes manufacturer, type, and serial number. You must separate multiple IDs with spaces. Note: ID ranges cannot be specified. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsframe command. Invoking the lsframe command
dscli> lsframe -l IBM.2107-75FA120
lsstgencl
The lsstgencl command displays a list of storage enclosures and status information for each enclosure in the list.
113
. . .
Parameters
-s (Optional) Displays the storage enclosure ID. You cannot use the -l and the -s parameters together. | -l (Optional) Displays default output, plus the frame number, ID, location, feature code, number of | storage slots, and state of the storage enclosure. You cannot use the -l and the -s parameters | together. -state normal| not_normal (Optional) Displays all the storage enclosures that are associated with the specified storage unit that contain a condition of normal or a condition that falls under the category of not normal. storage_image_ID . . . | (Required) Displays storage enclosure information for the specified storage image IDs. A storage image ID consists of manufacturer, machine type, and serial number. You must separate multiple IDs with a space between each ID. Note: You cannot specify an ID range. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsstgencl command using the -l parameter. Invoking the lsstgencl command
dscli> lsstgencl -l IBM.2107-75FA120
R1
S12
3221
S01
114
ID IBM.1750EX1.68FA120 /S01
Frame -
Enclnum S02
FC -
Interfaces 0082, 0083, 0182, 0183 (Not interface values. See the field definitions)
Storslot 16 16 16 16
Stordev 16 16 16 16
115
Interadd Specifies the FC-AL interface base address assigned to this storage enclosure for DDM access. Storslot+ Specifies the number of slots for storage devices in this storage enclosure. Stordev Specifies the number of storage devices that are installed in this storage enclosure. Cap (GB) Specifies the capacity of DDMs in the storage enclosure. Note: This field can contain multiple capacity values separated by a comma when the DDMs with different capacity are installed in the storage enclosure. RPM Specifies the rpm of the DDMs in the storage enclosure. Note: This field can contain multiple RPM values separated by a comma when the DDMs with different capacity are installed in the storage enclosure. State+ Specifies the condition of the storage enclosure. The condition of the enclosure is either normal or one of the conditions that falls under the category not_normal. The following values can be displayed: normal Indicates that the storage enclosure is not in any failure or transient condition. offline (DS8000 only) Indicates that the storage enclosure is not capable of processing any functions. failed Indicates that the storage enclosure is broken and ready to be removed without impacting the system. Note: For a DS6000 model, this condition changes to inter failed if the storage enclosure is found to be in good condition again. new (DS6000 only) This condition only displays when a storage enclosure is first discovered. removed (DS6000 only) Indicates that the storage enclosure was removed from the system. inappropriate (DS6000 only) Indicates that the hardware resource cannot be integrated in the system. inter failed (DS6000 only) Indicates that the hardware resource is faulty but still working. PFSed (Prepared for Service) (DS6000 only) Indicates that the storage enclosure is ready to be removed without impacting the system. attention (DS6000 only) Indicates that there is a problem with the storage enclosure; however, it is not known whether it is faulty or not. This condition reverts to normal if the problem is closed. resuming (DS8000 only) Indicates that the storage enclosure is in the process of coming online. quiescing (DS8000 only) Indicates that the storage enclosure is in the process of going offline.
116
| | | |
Key: * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
lshba
The lshba command displays a list of storage image host adapters and status information for each host adapter in the list. This command is not supported on DS6000 models.
lshba -s -l -encl enclosure_ID -state online offline failed
Parameters
| | | -s (Optional) Displays only the host adapter IDs. You cannot use the -l and the -s parameters together. -l (Optional) Displays the default output plus the host adapter feature code and interface IDs. You cannot use the -l and the -s parameters together. -encl enclosure_ID (Optional) Specifies that the system displays host adapters that are associated with a common processor complex or I/O enclosure ID. -state online | offline | failed (Optional) Specifies that the system displays host adapters that are in a specified state. storage_image_ID . . . | (Optional) Specifies that the system displays host adapter information for the designated storage image IDs. A storage image ID includes a value for the manufacturer, machine type, and serial number. Notes: 1. Multiple IDs must be separated with spaces. 2. ID ranges cannot be specified. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lshba command. Invoking the lshba command
dscli> lshba -l IBM.2107-75FA120
117
lsddm
The lsddm command displays a list of disk drive modules (DDMs) and status information for each DDM in the list.
lsddm -s -l -enclosure enclosure_ID -dapair dapair_ID
-arsite
arraysite_ID
-usage
-state
normal not_normal
ent nl ssd
118
Parameters
| -s (Optional) Displays only the DDM IDs. You cannot use the -s and -l parameters together. -l (Optional) Displays the default output. You cannot use the -s and -l parameters together. -enclosure enclosure_ID (Optional) Specifies that the system displays DDMs that are associated with a common storage enclosure ID. This parameter accepts a fully qualified enclosure ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a hexadecimal number within the range (00 - 3F). -dapair dapair_ID (Optional) Specifies that the system displays DDMs that are associated with a common device adapter (DA) pair ID. This parameter accepts a fully qualified DA pair ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a two-digit decimal number with no leading zeros. -arsite arraysite_ID (Optional) Specifies that the system displays DDMs that are associated with a common array site ID. This parameter accepts a fully qualified array site ID, which includes either the storage image ID or a shortened version without the storage image ID. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter S. -usage unassigned | unconfigured | spare | not_spare | array_member (Optional) Specifies that the system displays DDMs that are associated with a specified usage. -state normal | not_normal (Optional) Specifies that the system displays DDMs that are associated with a specified state. -dualloop 1 | 2 (Optional) Specifies that the system displays DDMs that are associated with the designated dual loop. -encrypt supported | unsupported (Optional) Specifies that the system displays only the DDMs that have the specified encryption capability. -diskclass ent | nl | ssd (Optional) Displays the DDMs that are associated with the specified disk class. storage_image_ID . . . | (Required) Specifies that the system displays DDM information for the designated storage image IDs. A storage image ID includes a value for the manufacturer, machine type, and serial number. You can specify multiple IDs and they must be separated with a space between each ID. Note: You cannot specify ID ranges. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.
119
The following tables represent the headers that are displayed on the output report that is associated with the lsddm command using the -l parameter. Invoking the lsddm command
dscli> lsddm -l IBM.2107-75FA120
S0BE146
U2107.921. 75FA120
3603
11
145
dkrate (Gb/sec) 2 2
Position 1 2
120
v 10000 v 15000 dkinf Specifies the DDM interface type. One of the following values are displayed: v FC-AL v SAS (Serial Attached SCSI) Dkrate (Gb/sec) Specifies the DDM interface rate. dkuse Specifies the DDM usage in an array site. One of the following values are displayed: v unassigned v unconfigured v spare required v spare not required v array member arsite Specifies the array site ID. Position Specifies the DDM position in an array site configuration of DDMs. State Specifies the current DDM state. One of the following values are displayed: Normal The storage device is operational and functional in its current disk usage. New Indicates the initial state when a DDM is inserted or first discovered. Installing A new storage device has been identified. Verifying The storage device is made accessible to the device adapter, its characteristics are determined, cabling is checked, and diagnostics are run. Formatting A verified storage device requires low-level formatting and the formatting operation is in progress. Initializing The storage device is being initialized with all zero sectors. Certifying The storage device is read-accessed to determine that all sectors can be read. Rebuilding The storage device is being rebuilt with data from the array that it is associated with. Migration Target DDM migration is migrating another array member storage device to this spare storage device. Migration Source DDM migration is migrating this array member storage device to another spare storage device. Failed The storage device has failed and an immediate repair action is required.
Chapter 4. CLI commands
121
Failed - Deferred Service The storage device has failed and a repair action is not immediately required. Removed The storage device is removed from the system and removal has been processed by the system. Inappropriate The storage device is incompatible with the system; for example, a storage device that has the wrong capacity or rpm. The DDM is not failed, because it can be valid for other systems and locations. Inter failed Indicates that the DDM is faulty but still working. PFSed Indicates that the DDM is prepared for service, and ready to be removed without impacting the system. Diskclass Specifies the disk class as either high speed Fibre Channel disk drives or near-line disk drives. One of the following values can be displayed: v ENT = Specifies enterprise and represents high speed Fibre Channel disk drives v NL = Specifies near-line and represents ATA (FATA) disk drives v SATA = Specifies high capacity SATA disk drives. Encrypt Specifies the encryption support capability. One of the following values can be displayed: supported The disk drive modules in this rank are capable of encryption. unsupported The disk drive modules in this rank are not capable of encryption. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
setvpn Used when remote access is required by IBM Support personnel and there is no local on-site access to the machine. showsp Generates a report that displays detailed properties of a storage complex.
chsp
The chsp command modifies a storage complex for items such as notification of the Simple Network Management Protocol (SNMP) traps and email problem notification lists in a storage complex. This command is not supported on DS6000 models.
122
Notes: v The Storage Manager server domain is a single storage complex. The storage complex object can only be created or deleted by service personnel. v The SNMP settings only apply to some types of snmp notifications (Example: Copy Services).
chsp -snmp on off -snmpaddr new_ip_list -emailnotify on off
-emailaddr
new_email_list
-emailrelay
on off
-emailrelayaddr
new_relay_ip_list
-emailrelayhost
new_relay_host_name
-desc
new_sp_description
-name
new_sp_name
Parameters
-snmp on | off (Optional) Specifies whether the Simple Network Management Protocol (SNMP) trap notification function sends notifications when a problem occurs on a storage complex. SNMP traps that are generated by the storage complex are sent to the IP address that is specified by the -snmpaddr parameter. -snmpaddr new_ip_list (Optional) Specifies a new SNMP trap destination list. This list consists of one or two IP addresses that receive SNMP traps that are generated by the storage complex if SNMP is enabled. Note: Multiple IP addresses must be separated with a comma with no space before or after each comma. -emailnotify on | off (Optional) This parameter is not currently supported. -emailaddr new_email_list (Optional) This parameter is not currently supported. -emailrelay on | off (Optional) This parameter is not currently supported. -emailrelayaddr new_relay_ip_list (Optional) This parameter is not currently supported. -emailrelayhost new_relay_host_name (Optional) This parameter is not currently supported. -desc new_sp_description (Optional) Specifies your description of the storage complex. This description is limited to 256 byte or 128 double-byte characters. -name new_sp_name (Optional) Specifies the name that you designate for the storage complex. This name is limited to 32 byte or 16 double-byte characters.
123
Example
Invoking the chsp command
dscli> chsp -desc "my storage complex"
setvpn
The setvpn command starts or ends an outbound virtual private network connection (VPN). This command is not supported on DS6000 models. During the installation of the DS8000 product, the hardware management console (HMC) sends a certificate (signed public key) to IBM for server authentication and for SSL encryption of applications using VPN (Internet and modem) connections. You can use the setvpn command to start or stop the session and to create a secure connection. In addition, the IBM VPN server does additional authentication to allow traffic to certain IBM servers only, for the call home feature and remote service. Notes: 1. Only IBM support personnel with special access rights can use the VPN connection. 2. The setvpn command is used when remote access is required by IBM Support personnel and there is no local on-site access to the machine. 3. It can take from 2 to 10 minutes for the secure connection to be established and recognized by the RS3/RS4 server. 4. The secure connection ends automatically when the terminal emulation session ends. However, you also have the ability to end the session earlier by issuing the setvpn -action disconnect command. 5. The -vpnaddr parameter requires that you specify a value for either smc1 or smc2. If you do not specify the -vpnaddr parameter, the storage management console (SMC) for the current connection is used. The SMC address is taken from the profile file or the SMC address that you specify on the DS CLI command line.
setvpn -vpnaddr smc1 smc2 -action connect disconnect
Parameters
-vpnaddr smc1 | smc2 (Optional) Specifies the VPN server machine. In addition, you can specify where you want the outbound VPN to start from by designating the following values: smc1 Identifies the management console (SMC) where you want the outbound VPN to start from. The console that you have specified in your profile for hmc1 starts your DS CLI session, unless you specify a console that is not designated in your profile. In this case, the console that you specify to start your session is the one where the connection is made. Identifies the management console where you want the outbound VPN to start from. The console that you have specified in your profile for hmc2 starts your DS CLI session, unless you specify a console that is not designated in your profile. In this case, the console that you specify to start your session is the one where the connection is made.
smc2
124
-action connect | disconnect (Required) Specifies that the secure VPN connection be started or disconnected.
Example
Invoking the setvpn command
dscli> setvpn vpnaddr smc1 action connect
lsvpn
The lsvpn command displays a report that lists the outbound VPN information such as management consoles and connection status. This command is not supported on DS6000 models.
lsvpn -s -l -vpnaddr smc1 smc2 -vpnstatus connected disconnected
Parameters
-s | | -l | | (Optional) Displays the management console (SMC) and connection status. You cannot use the -l and -s parameters together. -vpnaddr smc1 | smc2 (Optional) Specifies the VPN server machine. In addition, you can specify where the outbound VPN was started from by designating the following values: smc1 Identifies the management console (SMC) where the outbound VPN was started from. The console that you have specified in your profile for hmc1 starts your DS CLI session, unless you specify a console that is not designated in your profile. In this case, the console that you specified to start your session is the one that is listed in the report as being where the connection was made. Identifies the management console where the outbound VPN was started from if you did not start it from the management console identified by smc1. The console that you have specified in your profile for hmc2 starts your DS CLI session, unless you specified a console that is not designated in your profile. In this case, the console that you specified to start your session is the one that is listed in the report as being where the connection was made. (Optional) Displays the management console (SMC) and connection status. You cannot use the -l and -s parameters together.
smc2
Note: The default value is to display the address for smc1 and smc2. If you do not specify the -vpnaddr parameter, the generated report displays both the smc1 and smc2 addresses as they are recorded in your profile. -vpnstatus connected | disconnected (Optional) Specifies that you receive a report that displays only the SMC for the connection status specified. Note: The default value is to display the connection status for all SMCs. The generated report displays all connected and disconnected SMCs.
125
Example
For this command and all other DS CLI list commands, the results are shown in table format for clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsvpn command. Invoking the lsvpn command
dscli> lsvpn -l
showsp
The showsp command displays a properties report for a storage complex. This command is not supported on DS6000 models. The report included the properties values for the names, descriptions, and customer account names of the storage complex.
showsp
Parameters
There are no parameters for this command. Notes: 1. The snmp settings only apply to some types of snmp notifications (Example: Copy Services). 2. The email parameters are not currently supported.
Example
The following table represents the headers that are displayed on the output report that is associated with the showsp command. Invoking the showsp command
dscli> showsp
126
eMailnotify Enabled
eMailrelay Disabled
eMailrelayaddr 9.xxx.14.45
eMailrelayhost relay_host
numks supported 1
127
showsu Generates reports that allow you to view details about your storage units.
chsu
The chsu command modifies a storage unit. You can also use this command to power-on and power-off a DS8000 storage unit.
chsu -pwrmode manual auto zseries -pwron -pwroff -quiet
-desc
new_su_description
-name
new_su_name
Parameters
-pwrmode manual | auto | zseries (Optional) (DS8000 only) Sets a requested remote power control mode on the storage unit. manual Specifies that the storage facility power-on and power-off sequences are performed based on the manual power on and off controls. auto A storage facility power-on sequence is performed when external power first becomes available to the first rack of a storage facility (for example, when standby power is first activated to the remote power control cards). zseries Specifies that the power control mode is set to zSeries remote power control. Note: Changing the power mode can take several minutes. Initiating a power-on or power-off request in manual mode can take up to 25 minutes. During a power-on or power-off request, access requests to the storage unit might be queued. This queuing can result in a loss of response on other functions that access the storage unit when accessed by the CLI. -pwron (Optional) (DS8000 only) Turns on power to the storage unit. For DS8000, this parameter is valid if the control mode is set to manual and the switch is set to remote.
128
-pwroff (Optional) Turns off power to the storage unit. For DS8000, this parameter is valid if the control mode is set to manual and the switch is set to remote. -quiet (Optional) Turns off the modification confirmation prompt for this command. -desc new_su_description (Optional) Allows you to specify a description for the storage unit. The description is limited to 256 byte or 128 double-byte characters. -name new_su_name (Optional) Allows you to specify a user-defined name for the storage unit. This name is limited to 32 bytes or 16 double-byte characters. storage_unit_ID | (Required) Accepts the fully qualified storage unit ID. The storage unit ID consists of manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the chsu command
dscli> chsu -pwrmode manual IBM.2107-75FA120
lssu
The lssu command displays a list of storage units in a storage complex. You can use this command to look at the status and other properties of each storage unit in the list.
lssu -s -l -power on off storage_unit_ID . . . " - "
Parameters
| | | -s (Optional) Displays only the storage unit ID. You cannot use the -l and the -s parameters together. -l (Optional) Displays default output plus the power mode and storage unit description. You cannot use the -l and the -s parameters together. -power on | off (Optional) Displays only the storage units in the specified power state. storage_unit_ID . . . | (Optional) Displays storage units with the specified storage unit IDs. A storage unit ID includes manufacturer, machine type, and serial number. You must separate multiple IDs with a space between each ID. Note: You cannot specify ID ranges. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
129
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lssu command using the -l parameter. Invoking the lssu command
dscli> lssu -l
SU 2
921
On
Local
Production Backup
SU 3
921
On
Local
130
Pw Mode Indicates the power control mode in effect for the listed storage unit. One of the following values is displayed: Local Indicates that the SMC local/remote switch is set to the local power control mode. Remote SMC Manual Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to manual power control. Remote SMC Auto Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to auto-power control. Remote zSeries Power Control Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to zSeries remote power control. Desc Specifies the description that you assigned the storage unit. This value is displayed as a " - " if no description has been assigned.
showsu
The showsu command displays detailed properties of an individual storage unit.
showsu storage_unit_ID " - "
Parameters
storage_unit_ID (Required) Specifies the storage unit ID. A storage unit ID consists of manufacturer, machine type, and serial number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the showsu command. Invoking the showsu command
dscli> showsu IBM.210775FA120
131
Pw State On
Pw Mode Local
Processor Memory 1 GB
MTS IBM.2424-75FA120
132
Power Exception Indicates that storage unit power is on, but online operation is not possible due to a power fault in one of the storage unit frames. Pw Mode Indicates the power control mode in effect for the listed storage unit. One of the following values is displayed: Local Indicates that the SMC local/remote switch is set to the local power control mode. Remote SMC Manual Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to manual power control. Remote SMC Auto Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to auto-power control. Remote zSeries Power Control Indicates that the SMC local/remote switch is set to remote and that the power control mode is set to zSeries remote power control. Reqpm Indicates the power control mode to apply when the local/remote switch is set to remote power control mode. One of the following values is displayed: v Remote SMC Manual v Remote SMC Auto v Remote zSeries Power Control Note: The default value is remote SMC Manual mode. | Processor Memory Specifies the amount in decimal gigabytes (GB) of processor memory configured on the storage unit. MTS (DS8000 models) Specifies the order type of the storage unit. The order type and the machine type of the storage unit is the same on all storage units ordered before release 2.4. After release 2.4, the order type varies according to the warranty periods associated with the storage unit. (DS6000 models) No value is specified for a DS6000 model.
diagsi An administrative utility command that a user with administrator or service operator authority can use for non-routine diagnostic actions. lsserver Displays all the servers in a storage complex or a list of specified servers. The displayed list also provides the status information for each server including the LIC version number, operating system version number, and bundle version.
133
lssi
Displays a list of storage images in a storage complex. These commands requires that you use the storage image WWNN, which is displayed for each storage image when you use the lssi command.
showsi Displays the detailed properties of a storage image. In addition, the storage image WWNN is displayed for the specified storage image. The storage image WWNN is needed when you use the lsavailpprcport and mkpprcpath commands.
chsi
The chsi command modifies a storage image. You can use it to set characteristics such as online or offline state, name, and description.
chsi -essnetcs y n -volgrp volume_group_ID -desc new_si_description
-name
new_si_name
-os400sn
iSeries_Serial_Number
-etautomode
-etmonitor
-iopmmode
Parameters
-essnetcs y | n (Optional) Enables or disables the storage complex ESSNet user interface to invoke Copy Services operations for the storage image. y (yes) is the default. -volgrp volume_group_ID (Optional) Specifies the ESSNet Copy Services type volume group that contains the logical volumes that are eligible for control by Copy Services operations, when the -essnetcs y parameter is used. All logical volumes are eligible for control by Copy Services operations if the -essnetcs y parameter and the volume group ID are not specified. The -volgrp parameter accepts a fully qualified volume group ID including the storage image ID or a shortened version. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter V. -desc new_si_description (Optional) Specifies the description that you assign to the storage image. The description is limited to 256 bytes or 128 double-byte characters. -name new_si_name (Optional) Specifies the name that you assign to the storage image. The storage image name is limited to 32-byte or 16 double-byte characters. -os400sn iSeries_Serial_Number Specifies the new iSeries serial number. The serial number consists of 3 hexadecimal characters. It uniquely identifies LUNs within a customer storage complex. It is appended to the unit serial number that is returned by a SCSI inquiry command that is directed to each LUN. Notes:
134
1. You must restart your computer after you process this DS CLI command to assign a new serial number. 2. The iSeries serial number is only required when you have multiple DS**** machines with the last 3-digits of the machine serial number that overlap. -etautomode all | tiered | none (Optional) Specifies whether the IBM System Storage Easy Tier LIC feature is active and controlling the automated portion of this feature. If the value is set to all, the Easy Tier automatic mode is active on all pools, and the manual mode is also active. If the value is set to tiered, the automatic | mode is active on pools with multiple tiers, and the manual mode is also active. If the value is set to none, the manual mode is active, but the automatic mode is inactive. -etmonitor all | automode | none (Optional) Specifies whether volumes are monitored for potential benefits by IBM System Storage Easy Tier. If the value is set to "all", then all of the volumes on the DS8000 are monitored regardless of the Easy Tier LIC feature. If the value is set to automode and Easy Tier is active, then only those volumes that are managed by the Automatic Mode of Easy Tier are monitored. If the value is set to automode and Easy Tier is inactive, then no volumes are monitored. If the value is set to none, then no volumes are monitored. -iopmmode disable | monitor | monitorsnmp | manage | managesnmp (Optional) Specifies the I/O priority management mode, which could be one of the following values: disable Specifies that the I/O priority manager function is disabled. monitor Specifies that resources associated with performance groups that specify I/O management are monitored, but not managed. monitorsnmp Specifies the same condition as monitor, but with added SNMP trap support. manage Specifies that resources associated with performance groups that specify I/O management are managed. managesnmp Specifies the same condition as manage, but with added SNMP trap support. Note: The default I/O priority management mode is managed mode. storage_image_ID | (Required) Specifies the storage image ID, which consists of the values for manufacturer, machine type, and serial number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Examples
Invoking the chsi command
dscli> chsi -essnetcs n IBM.210775FA120
diagsi
The diagsi command is an administrative utility command that a user with administrator or service operator authority can use for nonroutine diagnostic actions.
Chapter 4. CLI commands
135
diagsi -quiet
-action
warmstart saveuilogs
storage_image_ID "-"
Parameters
Note: Only users with administrator or service authority are authorized to use this command. -action warmstart | saveuilogs (Required) Specifies the administrative action to be performed. warmstart The -action warmstart parameter initiates a warmstart on the storage image, which causes the storage image to collect microcode data that is useful in diagnosing problems. This action is restricted to the following usage rules: v This action must only be used under the direction of IBM Service. v You must be in interactive mode to issue this action. You cannot issue this action while in single shot mode or from a script. v Five minutes must pass before you can reissue the -action warmstart parameter. v If you issue the -action warmstart parameter more than 10 times during a 24-hour period, the warmstart will not collect the microcode diagnostic data. saveuilogs The -action saveuilogs parameter offloads DS CLI logs to the IBM System Storage Management Console and saves DS Network Interface, DS CLI, DS Storage Manager, and CIM logs. All of the user interface log files can then be retrieved with a PE package. -quiet (Optional) Turns off the diagnostic control confirmation prompt for this command. storage_image_ID | (Required) Specifies the fully qualified storage image ID. The storage image ID consists of manufacturer, machine type, and serial number. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode.
Example
Invoking the diagsi command
dscli> diagsi -action saveuilogs IBM.210768FA121
lsserver
The lsserver command displays all servers in a storage complex or a list of specified servers and it also displays the status information for each server in the list.
lsserver -s -l Server_ID . . . " - "
136
Parameters
-s (Optional) Displays only the server ID. You cannot use the -l and the -s parameters together. -l (Optional) Displays the default output and the state of the servers. You cannot use the -l and the -s parameters together. Server_ID . . . | (Optional) Displays the server information for the specified server IDs. This parameter accepts a fully qualified server ID, which includes the storage image ID or a shortened version without the storage image ID. The shortened version is a two-digit decimal number with no leading zeros. For DS8000, v Example: IBM.2107-13AAV3A/0 v Example: IBM.2107-13AAV3A/1 To specify a range of server IDs, separate the server IDs with a hyphen. You must separate multiple server IDs or ranges of server IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsserver command using the -l parameter. Invoking the lsserver command
dscli> lsserver -l
Online
5.3.0.832
137
Power Control SFI Specifies the storage server power control SFI. State+ Specifies the current state of the designated server. LIC Version Specifies the LIC version for the designated storage server. OS Version Specifies the operating system version for the designated server. For a DS8000, this field always reports a dash. Bundle Version Specifies the bundle version for the designated storage server. For a DS8000, this field always reports a dash. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
lssi
The lssi command displays a list of storage images in a storage complex. You can use this command to look at the status of each storage image in the list. The storage image worldwide node name (WWNN) is displayed when this command is used. You must use the storage image WWNN with the lsavailpprcport and mkpprcpath commands.
lssi -s -l -state online offline fenced -su_id storage_unit_ID
Parameters
-s (Optional) Displays only the storage image IDs. You cannot use the -l and the -s parameters together. -l (Optional) Displays the default output, ESSNet, volume group, and storage image description. You cannot use the -l and the -s parameters together. -state online | offline | fenced (Optional) Displays only the storage images in the specified state. -su_id storage_unit_ID . . . (Optional) Displays the storage images that are associated with the specified storage unit. A storage unit ID consists of manufacturer, machine type, and serial number. storage_image_ID . . . | (Optional) Accepts fully qualified storage image IDs. A storage image ID consists of manufacturer, machine type, and serial number. You must separate multiple IDs with a space between each ID.
138
Note: You cannot specify ID ranges. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lssi command using the -l parameter. There is a difference in the input values when you use the su_ID and storage_image_ID parameters. Invoking the lssi command
dscli> lssi -l
State Online
ESSNet Enabled
Volume Group -
139
Quiesce Exception Indicates that the storage unit is in the quiesce exception state. Forced Quiescing Indicates that the storage unit is in the process of performing a force offline operation. Fenced Indicates that the storage unit has failed and is offline. Discovery (DS6000 only) Indicates that the storage unit is determining which physical configurations are available and updates itself when it discovers new hardware. ESSNet+ Specifies that the storage-complex ESSNet user interface can invoke Copy Services operations to this storage image. Enabled or Disabled are the values that are displayed in this field. Volume Group+ Specifies the ESSNet Copy Services Volume Group ID or displays a " - " in this field. If ESSNet Copy Services operations are enabled, the value that is displayed in this field specifies the ESSNet Copy Services type volume group. This volume group contains the logical volumes that can be controlled by Copy Services operations that are initiated through the ESSNet. If ESSNet Copy Services operations are enabled and the ESSNet Copy Services Volume Group ID is not specified (represented by the " - " value in this field), all logical volumes are eligible to be controlled by Copy Services operations that are initiated through the ESSNet. Desc+ Specifies the value that you have assigned as a description for the storage unit. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
showsi
The showsi command displays detailed properties of a storage image. The storage image worldwide node name (WWNN) is displayed when this command is used. You must use the storage image WWNN with the lsavailpprcport and mkpprcpath commands.
showsi storage_image_ID " - "
Parameters
storage_image_ID | (Required) Specifies the storage image ID. A storage image ID consists of a manufacturer, machine type, and serial number. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.
140
The following tables represents the headers that are displayed on the output report that is associated with the showsi command. Invoking the showsi command
dscli> showsi IBM.210775FA120
State Online
ESSNet Enabled
Volume Group -
Os400 Serial -
NVS Memory 8 GB
numeg supported 1
ETAutoMode tiered
ETMonitor all
IOPMmode Monitored
141
Quiesce Exception Indicates that the storage unit is in the quiesce exception state. Forced Quiescing Indicates that the storage unit is in the process of performing a force offline operation. Fenced Indicates that the storage unit has failed and is offline. Discovery Indicates that the storage unit is determining which physical configurations are available and updates itself when it discovers new hardware (DS6000 only). accessible The encryption group is accessible if it has been configured and the storage image has obtained the encryption key from the key server for the encryption group. inaccessible The encryption group is inaccessible, the storage image was unable to obtain the encryption key from the key server. unconfigured The encryption group is unconfigured if it has not been configured. ESSNet Specifies that the storage-complex ESSNet user interface can invoke Copy Services operations to this storage image. Enabled or Disabled are the values that are displayed in this field. Volume Group Specifies the ESSNet Copy Services Volume Group ID or displays a " - " in this field. If ESSNet Copy Services operations are enabled, the value that is displayed in this field specifies the ESSNet Copy Services type volume group. This volume group contains the logical volumes that can be controlled by Copy Services operations that are initiated through the ESSNet. If ESSNet Copy Services operations are enabled and the ESSNet Copy Services Volume Group ID is not specified (represented by the " - " value in this field), all logical volumes are eligible to be controlled by Copy Services operations that are initiated through the ESSNet. OS400Serial (DS6000 only) Specifies " - " for a DS8000 model and the iSeries serial number for a DS6000 model. The serial number consists of 3 hexadecimal characters. It is used to uniquely identify LUNs within a customer's storage complex. It is appended to the unitSerialNumber that is returned by a SCSI inquiry command directed to each LUN. | | | | | | | | | NVS Memory Specifies the amount in decimal gigabytes (GB) of nonvolatile storage (NVS) memory configured on the storage unit. Example: 4.0 GB Cache Memory Specifies the amount in decimal gigabytes (GB) of cache memory configured on the storage unit. This memory equals the processor memory less the memory required for the operating system (varies with microcode level), NVS, and the tables that are required to manage the cache memory. Processor Memory Specifies the amount in decimal gigabytes (GB) of processor memory configured on the storage unit. This memory equals the installed memory less the reserved memory requirements, including firmware memory, and varies with the DS8000 model, the DS8000 configuration, and the microcode level. MTS Specifies the order type of the storage unit. The order type and the machine type of the storage unit
142
is the same on all storage units that are ordered before release 2.4. After release 2.4, the order type varies according the warranty periods that are associated with the storage unit. Note: This value is not reported for a DS6000 model. A " - " value is displayed. numegsupported Specifies the number of encryption groups that are supported. ETAutoMode Specifies whether the IBM System Storage Easy Tier LIC feature is active and controlling the automated portion of this feature. If the value is set to all, the Easy Tier automatic mode is active on all pools, and the manual mode is also active. If the value is set to tiered, the automatic mode is active only on pools with multiple tiers, and the manual mode is also active. If the value is set to none, the manual mode is active, but the automatic mode is inactive. ETMonitor Specifies whether volumes are monitored for potential benefits by IBM System Storage Easy Tier. If the value is set to "all", then all of the volumes on the DS8000 are monitored regardless of the Easy Tier LIC feature. If the value is set to "AutoMode" and Easy Tier is active, then only those volumes that are managed by the Automatic Mode of Easy Tier are monitored. If the value is set to "AutoMode" and Easy Tier is inactive, then no volumes are monitored. If the value is set to "none", then no volumes are monitored. If the value is set to "-" (dash), then the storage system does not support the Easy Tier feature. IOPMmode Specifies the I/O priority management mode, which could be one of the following values: Disabled Specifies that the I/O priority manager function is disabled. Monitored Specifies that resources associated with performance groups that specify I/O management are monitored, but not managed. MonitoredSNMP Specifies the same condition as Monitored, but with added SNMP trap support. Managed Specifies that resources associated with performance groups that specify I/O management are managed. ManagedSNMP Specifies the same condition as Managed, but with added SNMP trap support. Note: The default I/O priority management mode is managed mode.
143
setioport Configures one or more I/O ports for open systems or System z host system connections. showioport Displays the properties of a specified I/O port. It optionally displays the performance metrics for the I/O port.
lsioport
The lsioport command displays a list of all the I/O ports that are installed on the specified storage image and optionally provides performance metrics for each I/O port that is listed.
lsioport -dev storage_image_ID -s -l -type fc escon
-topology
-state
-metrics
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -s (Optional) Displays fully qualified port IDs. You cannot use the -l and -s parameters together. -l (Optional) Displays default output plus the I/O port interface speed. -type fc | escon (Optional) Displays I/O ports of the specified port type. Escon can be specified as the port type for DS8000 models only. -topology fc-al | scsi-fcp | ficon (Optional) Displays Fibre Channel I/O ports with the specified topology. -state online | offline | fenced | deconfigured (Optional) Displays I/O ports of the specified state. -metrics (Optional) Displays port ID and performance metrics for each port that is specified. Note: All performance counts are an accumulation since the most recent counter wrap or counter reset operation. I/O port performance counters are reset with a storage unit power-on sequence.
144
port_ID . . . | (Optional) Displays I/O ports that match the specified IDs. This parameter accepts a fully qualified port ID, which includes the storage image ID, or a shortened version without the storage image ID when the -dev parameter is specified. A port ID is prefixed with the letter "I" and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3). To specify a range of port IDs, separate the port IDs with a hyphen. You must separate multiple port IDs or ranges of port IDs by a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the lsioport command. Invoking the lsioport command
dscli> lsioport dev IBM.2107-75FA120 -l
145
Offline Indicates that the storage unit is not capable of processing any functions. Resuming Indicates that the storage unit is in the process of coming online. Quiescing Indicates that the storage unit is in the process of going offline. Fenced Indicates that the storage unit has failed and is offline. Deconfigured Indicates that the I/O port is in the process of being deleted. Type Specifies the port type. The following values can be displayed: v Fibre Channel-SW - (SW stands for short wave) v Fibre Channel-LW - (LW stands for long wave, 10 KM) v Fibre Channel-LW 4 KM - (LW stands for long wave, 4 KM) (DS8000 only) v ESCON (DS8000 only) Topo Specifies the I/O port topology. The following values can be displayed: v FC-AL v SCSI-FCP v FICON v " - " This value is displayed when the port type is not Fibre Channel. Portgrp Specifies the identifier that associates a subset of the I/O ports that are operating in anonymous access mode. Default value is 0 when these subsets are not specified. Speed Specifies the I/O port interface speed. The following values can be displayed: v ESCON ports = 200 Mb/s (DS8000 only) v FCP ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s v FICON ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s v Unknown
146
ID Specifies the fully qualified port ID. Date Specifies the current time stamp for the I/O port performance counters. For example, 08/11/05 02:23:49 is the format that is used to report this value. byteread Specifies the number of bytes that are read in 128 KB increments. bytewrit Specifies the number of bytes that are written in 128 KB increments. Reads Specifies a value that is based on extended count-key-data (ECKD) data received operations. Writes Specifies a value that is based on ECKD data transferred operations. Timeread Specifies a value that is based on the ECKD data that is received (read-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds. Timewrite Specifies a value that is based on the ECKD data that is transferred (write-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds. SCSI-FCP ports: Each of the following headers and value types are displayed: ID Specifies the fully qualified port ID. Date Specifies the current time stamp for the I/O port performance counters. For example, 08/11/05 02:23:49 is the format used to report this value. Bytewrit Specifies a value for the remote mirror and copy data transferred operations in increments of 128 KB. Byteread Specifies a value for the remote mirror and copy data received operations in increments of 128 KB. Writes Specifies a value for the remote mirror and copy data transferred operations. Reads Specifies a value for the remote mirror and copy data received operations. Timewrite Specifies a value that is based on the remote mirror and copy data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Timeread Specifies a value for the remote mirror and copy data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Byteread Specifies a value that is based on the SCSI data received operations. The displayed value is based on increments of 128 KB. Reads Specifies a value that is based on the SCSI data transferred operations. Writes Specifies a value that is based on the SCSI data transferred operations.
147
Timeread Specifies a value that is based on the SCSI data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Timewrite Specifies a value that is based on the SCSI data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds.
148
BitErrRate Specifies the number of the bit error (invalid transmission word) bursts for the previous 5 minute counting window. This number is reset every 5 minutes.
setioport
The setioport command configures one or more I/O ports for open systems or System z host system connections. This command cannot be used for ESCON ports.
setioport -dev storage_image_ID -topology fc-al scsi-fcp ficon
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -topology fc-al | scsi-fcp | ficon (Optional) Sets the topology for an I/O port, either Fibre Channel Arbitrated Loop, SCSI-FCP, or FICON. fibre channel arbitrated loop (code fc-al) The fc-al topology setting enables the SCSI ULP with a FC-AL topology. The FC-AL topology does not support PPRC path I/O operations. SCSI-FCP The SCSI-FCP topology setting enables the SCSI ULP with a point-to-point or switched fabric topology. PPRC path I/O operations are enabled for this setting. ficon The ficon topology setting enables the FICON ULP with a point-to-point or switched fabric topology. PPRC path I/O operations are not supported for FICON ULP. port_ID . . . | (Required) Specifies the I/O port ID. Accepts a fully qualified port ID, which includes the storage image ID, or a shortened version without the storage image ID when the -dev parameter is specified. A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 0, 1, 3, or 4. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3).
Chapter 4. CLI commands
149
To specify a range of port IDs, separate the port IDs with a hyphen. You must separate multiple port IDs or ranges of port IDs by a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the setioport command This example configures four I/O ports for FICON topology.
dscli> setioport -dev IBM.210775FA120 -topology ficon I0111 I0121 I0211 I0221
showioport
The showioport command displays properties of an I/O port. It optionally displays the performance metrics for a specific I/O port.
showioport -dev storage_image_ID -metrics port_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -metrics (Optional) Specifies that the port ID and the performance metrics for the specified I/O port be displayed. Note: All performance counts are an accumulation since the most recent counter wrap or counter reset operation. I/O port performance counters are reset with a storage unit power-on sequence. port_ID | (Required) Displays the property level details for the specified port IDs. This parameter accepts a fully qualified unique port ID, that is represented in the following format: manufacturer.machine type-serial number/portID. For example, for DS8000, IBM.210775FA120/I0110 A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3).
150
For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3). If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. |
Example 1
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showioport command.
| Invoking the showioport command to show port properties | dscli> showioport -dev IBM.1400-1B1 I0000 The resulting output | | | | | | | | | |
ID IBM.1400 -1B1/ I0000 WWPN 50050076 3080005AE State Online Loc U1400. 1B1. 1300025-P1-C1-T0 Type Fibre Channel-SW
Speed 8 Gb/s
Topo SCSI-FCP
Portgrp 0
unkSCSIlog -
physloc R1-I1-C1-T0
151
Loc Specifies the storage enclosure location by identifying the storage unit frame that contains the storage enclosure. The location format is Utttt.mmm.ppsssss. Type Specifies the port type. The following values can be displayed: v Fibre Channel-SW - (SW stands for short wave) v Fibre Channel-LW - (LW stands for long wave, 10 KM) v Fibre Channel-LW 4 KM - (LW stands for long wave, 4 KM) (DS8000 only) v ESCON (DS8000 only) Speed Specifies the I/O port interface speed. The following values can be displayed: | | v ESCON ports = 200 Mb/s (DS8000 only) v FCP ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s v FICON ports = 1 Gb/s, 2 Gb/s, 4 Gb/s, 8 Gb/s v Unknown Topo Specifies the port topology. If the port type is not Fibre Channel, then the displayed value is " - ". One of the following values is displayed: v FC-AL v SCSI-FCP v FICON v SCSI-FCP/FICON v " - " (if not Fibre Channel) Portgrp Specifies an identifier that associates a subset of the I/O port objects that are operating in anonymous access mode. unkSCSIlog Specifies a list of unknown SCSI N-port WWPN identifiers that have attempted to login into this I/O port. physloc Specifies the physical location of the I/O port. The I/O port location code is a combination of the rack, I/O enclosure, card, and port that provides the physical link. The value of the location uses the following format: R(1-2)-I(1-8)-C(1-6)-P(1-4). v R is the rack location v I is the I/O enclosure v C is the card v P is the port of the adapter This information is not supported for the DS6000. Note: R1-I3-C2-P1 is an example of this format. | Example 2 | For this command and all other DS CLI show commands, the results are shown in table format to | provide clarity. The actual reports do not display as tables. | The following tables represent the headers that are displayed on the output reports that are associated | with the showioport command, with the -metrics parameter.
152
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Writes (FICON/ESCON) 0
timeread (FICON/ESCON) 0
timewrite (FICON/ESCON) 0
bytewrit (PPRC) 0
byteread (PPRC) 0
Writes (PPRC) 0
Reads (PPRC) 0
timewrite (PPRC) 0
timeread (PPRC) 0
LinkFailErr (FC) 8
LossSyncErr (FC) 45
LossSigErr (FC) 0
PrimSeqErr (FC) 0
CRCErr (FC) 0
LRSent (FC) 0
LRRec (FC) 0
IllegalFrame (FC) 0
OutOrdData (FC) 0
OutOrdACK (FC) 0
DupFrame (FC) 0
InvRelOffset (FC) 0
SeqTimeout (FC) 0
BitErrRate (FC) 0
RcvBufZero (FC) 0
SndBufZero (FC) 0
RetQFullBusy (FC) 0
ExchOverrun (FC) 0
ExchCntHigh (FC) 0
ExchRemAbort (FC) 0
CurrentSpeed (FC) 0
%UtilizeCPU (FC) 0
153
Reads (FICON/ESCON) Specifies a value that is based on the extended count-key-data (ECKD) architecture data received operations. Writes (FICON/ESCON) Specifies a value that is based on the ECKD architecture data transferred operations. Timeread (FICON/ESCON) Specifies a value that is based on the ECKD data received (read-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds. Timewrite (FICON/ESCON) Specifies a value that is based on the ECKD data transferred (write-accumulated time) on a channel. The displayed value is based on increments of 16 milliseconds. Bytewrit (PPRC) Specifies a value for the remote mirror and copy data transferred operation in increments of 128 KB. Byteread (PPRC) Specifies a value for the remote mirror and copy data received operations in increments of 128 KB. Writes (PPRC) Specifies a value for the remote mirror and copy data transferred operations. Reads (PPRC) Specifies a value for the remote mirror and copy data received operations. Timewrite (PPRC) Specifies a value based on the remote mirror and copy data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Timeread (PPRC)e Specifies a value for the remote mirror and copy data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Byteread (SCSI) Specifies a value that is based on the SCSI data received operations. The displayed value is based on increments of 128 KB. Bytewrit (SCSI) Specifies a value that is based on the SCSI data transferred operations. The displayed value is based on increments of 128 KB. Reads (SCSI) Specifies a value that is based on the SCSI data received operations. Writes (SCSI) Specifies a value that is based on the SCSI data transferred operations. Timeread (SCSI) Specifies a value that is based on the SCSI data received (read-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. Timewrite (SCSI) Specifies a value that is based on the SCSI data transferred (write-accumulated) time on a channel. The displayed value is based on increments of 16 milliseconds. LinkFailErr (FC) Specifies the total number of miscellaneous Fibre Channel link errors. LossSyncErr (FC) Specifies the number of loss of synchronization errors. These errors occur when there is a confirmed and a persistent synchronization loss on the Fibre Channel link.
154
LossSigErr (FC) Specifies the number of times that a loss of signal was detected on the Fibre Channel link when a signal was previously detected. PrimSeqErr (FC) Specifies the number of primitive sequence protocol error counts where an unexpected primitive sequence was received. InvTxWordErr (FC) Specifies the number of times a bit error was detected. Examples of bit errors are a code violation, an invalid special code alignment, or a disparity error. CRCErr (FC) Specifies the number of times the CRC of a received frame is in error. LRSent (FC) Specifies the number of times the port has changed from an active (AC) state to a Link Recovery (LR1) state. LRRec (FC) This count is the number of times the port has changed from an active (AC) state to a Link Recovery (LR2) state. IllegalFrame (FC) Specifies the number of frames that violated the Fibre Channel protocol. One example of a violation is an invalid frame header, which occurs when the first frame of a data sequence is missing and a subsequent data frame is detected as illegal. OutOrdData (FC) Specifies the number of times that an out-of-order frame is detected. The frame is either missing from a data sequence or it is received beyond the sequence reassembly threshold of the port. OutOrdACK (FC) Specifies the number of times that an out-of-order ACK (ACKnowledgment field of the TCP protocol) frame is detected. The frame is either missing from a data sequence or it is received beyond the sequence reassembly threshold of the port. DupFrame (FC) Specifies the number of times a frame was received that has been detected as previously processed. InvRelOffset (FC) Specifies the number of times that a frame was received with bad relative offset in the frame header. SeqTimeout (FC) Specifies the number of times the port has detected a timeout condition after receiving a sequence initiative for a Fibre Channel exchange. BitErrRate (FC) Specifies the number of bit error (transmission words that are not valid) bursts for the previous 5 minute counting window. This number is reset every 5 minutes. | | | | | | | | | RcvBufZero (FC) Specifies the number of one second intervals that the receive buffer credit was zero. SndBufZero (FC) Specifies the number of one second intervals that the send buffer credit was zero. RetQFullBusy (FC) Specifies the number of times that the FCP port returned queue full or busy status. ExchOverrun (FC) Specifies the number of Fibre Channel exchanges that were lost due to overdriving the host adapter port.
155
| ExchCntHigh (FC) | Specifies the number of times that the Fibre Channel exchange count crossed the High Threshold. | ExchRemAbort (FC) | Specifies the number of times that a port received an abort. | CurrentSpeed (FC) | Specifies the current operating link speed. | %UtilizeCPU (FC) | Specifies the percentage of the CPU that is being utilized. The percentage is followed by a space and | either Average or Dedicated. Average means that the Host Adapter CPUs are being used as a | shared resource for the Host Adapter ports. Dedicated means that the Host Adapter CPUs are a | dedicated resource for each Host Adapter port.
chhostconnect
The chhostconnect command modifies a SCSI host port configuration.
chhostconnect -dev storage_image_ID -lbs 512 520
156
-addrdiscovery
reportlun lunpolling
-profile
port_profile_name
-hosttype
host_type
-portgrp
port_grp_number
-volgrp
volume_group_ID none
-ioport
-desc
description
-name
new_host_name
Parameters
Notes: 1. The chhostconnect command can be disruptive to host system I/O operations if the affected host port is logged in to the target storage unit. You must ensure that the host port is offline to the host system before you process the chhostconnect command. 2. Using the -hosttype parameter when you issue this command allows you to save input and processing time. The -hosttype parameter supplies the same information as if you had used the following three parameters: v -profile v -addrdiscovery v -lbs 3. If you are using the HP-UX operating system, see the volume restriction that is described under the -addrdiscovery parameter. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified host connection ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. For DS8000, example of a fully qualified storage image ID: IBM.2107-75FA120 -lbs 512 | 520 (Optional) Specifies the logical block size that is used by the host system. The block size must be compatible with the volume group type and the volume type configurations that apply to the host port connection. The 520 logical block size is typically used by the IBM System i models (OS/400). Notes: 1. You cannot use the -lbs parameter and -hosttype parameter together, but you can use each one separately. 2. If you do not use the -hosttype parameter, use the lsportprof command to determine the block size that you need to specify for the -lbs parameter. -addrdiscovery reportlun | lunpolling (Optional) Specifies the method for identifying logical unit number (LUN) addresses. v The reportlun method specifies that the host system can access up to 64 000 LUNs. v The lunpolling method specifies that the host system can access up to 256 LUNs.
Chapter 4. CLI commands
157
Notes: 1. You cannot use the -addrdiscovery parameter and -hosttype parameter together, but you can use each one separately. 2. For HP-UX operating systems, the number of volumes in the volume group must not exceed seven volumes. This restriction only applies when the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256. -profile port_profile_name (Optional) Specifies the name of the host connection behavior profile. If the name includes a blank space, enclose the name with double quotation marks. For example, -profile IBM pSeries Sun. Notes: 1. You cannot use the -profile parameter and the -hosttype parameter together, but you can use each one separately. 2. If you do not use the -hosttype parameter, use the lsportprof command to obtain a list of available profiles. -hosttype host_type (Optional) Specifies information about the following three parameters: v -profile v -addrdiscovery v -lbs Notes: 1. You cannot use the -hosttype parameter with the -profile, addrdiscovery, or -lbs parameters. 2. Use the lshosttype command to obtain a list of known host types. -portgrp port_grp_number (Optional) Specifies a user-assigned number that associates two or more host ports with access to a common volume group. Port group zero is reserved for ports that have not been associated with a port group. -volgrp volume_group_ID | none (Optional) Specifies an available volume group or no volume group if the none subparameter is used. This command accepts a fully qualified volume group ID including the storage image ID or a shortened version if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter V. A host connection can use only one volume group per storage image. (A single WWPN can access only one volume group per storage image.) Host operations cannot be initiated until a volume group ID is assigned. If none is specified, the volume group ID assignment is removed from a SCSI host port object. -ioport port_ID port_ID_list |all|none (Optional) Specifies all, none, or, one or more I/O port IDs that allow host connection access to volumes. This command accepts a fully qualified port ID including the storage image ID or a shortened version if the -dev parameter is specified. port_ID port_ID_list Specifies that you can designate up to 128 ports for an open systems host attachment assignment. You can list one or more port IDs separated by commas with no spaces. If you enter a list of I/O port IDs, access from the specified host connection to the specified volume group is allowed using only the designated list of port IDs. all Specifies that you want to add all I/O port IDs. This setting allows the specified host connection access to the designated volume group through all the associated I/O port IDs.
158
none
Specifies that you do not want to add any I/O ports. If you do not specify I/O ports, the storage unit is configured to allow host connection access to the specified volume group using any I/O port that is configured for FC-AL or SCSI-FCP topology.
Examples of -dev parameter use If you specify the -dev parameter, you can use the shortened version of the -ioport parameter as follows: v For DS8000,
dscli> chhostconnect -dev IBM.2107-75FA120 -ioport I0222 1
where 1 represents the required parameter, host_connection_ID. If you do not specify the -dev parameter and you specify the -ioport parameter, you must use the fully qualified version of the port ID with the -ioport parameter specified as follows: v For DS8000:
dscli> chhostconnect -ioport IBM.2107-75FA120/I0222 IBM.2107-75FA120/1
where IBM.1750-68FA120/1 or IBM.2107-75FA120/1 represents the required parameter, host_connection_ID A port ID is prefixed with the letter I and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3). To specify a range of port IDs, separate the port IDs with a hyphen. Separate multiple port IDs or ranges of port IDs with a comma between each ID or range of IDs. Note: Changing the I/O port values can result in a disruption of current logins by the host systems. -desc description (Optional) Specifies the description that you defined for the SCSI host port. The description is limited to 256-byte or 128 double-byte characters. -name new_host_name (Optional) Specifies the user-assigned host system or port name. The name is limited to 32-byte or 16 double-byte characters. host_connection_ID | (Required) Specifies the host connection ID, which is a unique identifier that uses any number from 0 - FFFE within the scope of a storage image. This parameter accepts a fully qualified ID or a shortened version if the -dev parameter is specified. If you do not specify the -dev parameter and you specify the host_connection_ID parameter, you must use the fully qualified version of the host connection ID as follows: v For DS8000:
dscli> chhostconnect -desc newdescription IBM.2107-75FA120/1
v For DS6000:
dscli> chhostconnect -desc newdescription IBM.1750-68FA120/1
159
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Attention: Use caution when you work with connection IDs to ensure that you have specified the correct connection that you want to change. For example, if you intend to change connection ID 0005 and type 000, the system changes connection ID 0. Or, if you want to change connection ID 0020 and type 002, the system changes connection ID 2. The system does not recognize the leading zeros, and 000 is interpreted as connection ID 0 and 002 is interpreted as connection ID 2.
Example
Invoking the chhostconnect command
dscli> chhostconnect -dev IBM.210775FA120 -name host_1_port_2 1
lshostconnect
The lshostconnect command displays a list of host connections for a storage image and the status information for each host connection in the list. You can also use this command to obtain a list of worldwide port numbers (WWPNs) from a system-detected-unknown host port. You can use these WWPNs to create a host connection using the mkhostconnect command.
lshostconnect -dev storage_image_ID -s -l -portgrp port_grp_number
-volgrp
volume_group_ID
-unknown
-login
-wwpn
wwpn
Parameters
-dev storage_image_ID (Optional) Displays the host connections for the specified storage image. A storage image ID consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified host connection ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. For DS8000, example of a fully qualified storage image ID: IBM.2107-75FA120 -s (Optional) Specifies the host connection IDs. You cannot use the -l and the -s parameters together. -l (Optional) Specifies the default output and your description for each host connection in the list. You cannot use the -l and the -s parameters together.
160
-portgrp port_grp_number (Optional) Specifies the host connections that have an associated group number. Note: You cannot use the -portgrp parameter with the -unknown or -login parameters. -volgrp volume_group_ID (Optional) Specifies that only the host connections with the specified volume group ID are to be displayed. The volume group ID is a four-digit decimal number with no leading zeros, prefixed with the letter V. Note: You cannot use the -volgrp parameter with the -unknown or -login parameters. -unknown (Optional) Specifies that a list of logged in host ports (WWPNs), that are not recognized as being associated with the designated storage unit, be displayed. Note: The list of logged in host posts includes all of the host ports that the storage unit detects, and it does not take into account changes that the storage unit could not detect. For example, the storage unit cannot detect that a cable has been disconnected from the port of the host device or that a fabric zoning change has occurred. In these cases, the host might not be able to communicate with the storage device anymore; however, the storage device might not detect this condition and still views the host as logged in. This parameter generates a list report that contains the following three information fields: v WWNN v WWPN v ESSIOport Note: You cannot use the -unknown parameter with the -portgrp, -volgrp, -login or host_connection_ID parameters. -login (Optional) Specifies that a list is to be displayed of host port (WWPNs) that are logged in and sorted by the ESS I/O port IDs for known connections. The report displays one line of information per connection. However, no information is displayed for a FICON connection. Notes: 1. Known logins are logins for which you have created for host connection, as well as Remote Mirror and Copy paths and anonymous connections. 2. You cannot use the -login parameter with the -unknown, -portgrp, -volgrp, or host_connection_ID parameters. -wwpn wwpn (Optional) Specifies that only the host connect objects for the specified WWPN is displayed. host_connection_ID . . . | (Optional) Specifies that host connection information for the specified host connection IDs be displayed. This parameter accepts a fully qualified ID (includes manufacture. machine type, serial number/hostconnectID) or a shortened version if the -dev parameter is specified. Note: You cannot use the host_connection_ID parameter with the -login or -unknown parameters. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified host connection ID: IBM.2107-75FA120/2 Example of a shortened version host connection ID: 0002
161
Example
Note: You can receive different reports when you use the lshostconnect command, one for the -unknown parameter, one for the -login parameter, one for the -l parameter, and one for the -s parameter. The reports that are associated with the -unknown, -login, and -l parameters are provided in this description. For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the lshostconnect command. Invoking the lshostconnect command without the -unknown parameter
dscli> lshostconnect -dev IBM.210775FA120 -l
The resulting output The following table displays four ports, which is possible when you query a DS8000 model. If you query a DS6000 model, only two ports are displayed.
Name My host port 1 My host port 2 My host port 3 My host port 4 ID IBM.210775FA120/1 IBM.210775FA120/2 IBM.210775FA120/3 IBM.210775FA120/4 WWPN 3007ACF3 0A2399E0 3007ACF3 0A2399E1 3007ACF3 0A2399E2 3007ACF3 0A2399E3 HostType Unknown Unknown Unknown Unknown LBS 512 512 512 512 Addrdis covery reportLUN reportLUN reportLUN reportLUN
Profile IBM pSeries - AIX IBM pSeries - AIX IBM pSeries pLinux IBM pSeries - pLinux
portgrp 0
volgrpID V100
atchtopo -
Speed Unknown
Desc SCSI1
V100
Unknown
SCSI2
V100
I0111,I0121 I0211,I0221 -
Unknown
SCSI3
V100
Unknown
SCSI4
162
ESSIOport I0111, I0121, I0211, I0221 I0121 I0111, I0121, I0211, I0221 I0111
Report field definitions when the -unknown or -login parameter is not used
Name Host connection/SCSI port nickname. The name is limited to 32-byte or 16 double-byte characters. ID A fully qualified host connection ID: manufacturer.type-serial number/hostconnectID The host connection ID component is a unique identifier (0 - FFFE) within the scope of a storage unit. WWPN Specifies the worldwide port name (WWPN) for this host system port. HostType Specifies the name of the host type. Unknown is displayed when the information is not available and indicates that the host type was not specified when the host connection was created or modified. LBS Specifies the logical block size that is used by the designated host system and host system port. The logical block setting must be compatible with the volume group type that is configured for volume access. The 520 block size is typically used for IBM System i host system attachments. Addrdiscovery Specifies the LUN address discovery method used by the designated host system and host system port. The LUN Discovery method must be compatible with the volume group type that is configured for volume access. The Poll LUNs method enables access to a maximum of 256 LUNs. The Report LUNs method enables access to a maximum of 64 000 LUNs.
163
Profile Specifies the name of the host connection behavior profile. Portgrp Specifies the host port group ID. This ID ties together a group of SCSI host port objects that are accessing a common volume group. If the port group value is set to zero, the host port is not associated with any port group. VolgrpID Specifies the volume group ID. This ID is a unique identifier within the DS8000 for the SCSI volume group that the specified SCSI host port is assigned to. Specifies the volume group ID. This ID is a unique identifier within the DS6000 for the SCSI volume group that the specified SCSI host port is assigned to. Atchtopo The atchtopo is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the atchtopo attribute always displays as a " - " value. To obtain the I/O port topology, use the lsioport or showioport commands. ESSIOport Specifies the array of port IDs that the designated host port is logged in to. A port ID is prefixed with the letter "I" and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3). Speed Speed is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the speed attribute always displays a value of "Unknown". To query the speed of an I/O port use the lsioport or showioport commands. Desc Specifies the description that you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters.
164
v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v P is the port number (0 - 3).
lshostvol
The lshostvol command displays the mapping of host device names or volume names to machine type 2105, 2107, and 1750 volume IDs. (This command is not supported on the i5/OS.)
lshostvol
Parameters
There are no parameters for this command. Notes: 1. The lshostvol command displays only volumes that are accessed using a direct Fibre Channel path when you use the command on an OpenVMS host system that is a member of an OpenVMS cluster. The command output does not display information about the following OpenVMS cluster devices: v Volumes to which the host system only has MSCP paths.
Chapter 4. CLI commands
165
v Volumes to which the host system uses only MSCP paths at this time even though it has both MSCP and direct paths. 2. If you do not have installed the IBM Multipath Subsystem Device Driver (SDD), the virtual path (vPath) name is not displayed. 3. On a Red Hat Enterprise Linux system, attached devices might be detected by the HBA driver, but they are not registered with the operating system. Normally, the operating system is set up to automatically detect all LUNS. However, if this does not occur automatically, you must issue the following for every volume (LUN):
echo scsi add-single-device host# channel# lun# >/proc/scsi/scsi
If SDD is installed on your system, you can run the scsiscan script to detect all the LUNs. 4. If the user that is running the DS CLI on the host does not have permissions to view the host volumes, the lshostvol command will return no host volumes found.
Example
The information that is displayed on the report that is generated from the lshostvol command is different depending on whether you have SDD installed. The following example tables indicate the differences. For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the lshostvol command. Invoking the lshostvol command
dscli> lshostvol
166
lsportprof
The lsportprof command displays a list of port profiles that are supported on a storage unit and their recommended address discovery and logical block size values. You can use this command to view known values for the block size (lbs) and address discovery (addrdiscovery) parameters in the mkhostconnect command. Note: Use this command to get the recommended values for the mkhostconnect command.
lsportprof storage_image_ID " - "
Parameters
storage_image_ID | (Required) Displays a list of port profiles for the specified storage image IDs. A storage image ID consists of manufacturer, type, and serial number. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example: IBM.2107-75FA120
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsportprof command. Invoking the lsportprof command
dscli> lsportprof IBM.2107-75FA120
167
AddrDiscovery Specifies the address discovery method. One of the following values is displayed: LUN Polling Specifies that host system LUN access is limited to a maximum of 256 LUNs. Report LUN Specifies that host system LUN access is limited to a maximum of 64000 LUNs LBS Specifies the logical block size. One of the following values is displayed: v 512 - This value is displayed for all hosts except OS400. v 520 - This value is displayed for an OS400 host.
managehostconnect
The managehostconnect command modifies the volume group assignment for a SCSI host port.
managehostconnect -dev port_grp_number " - " storage_image_ID -volgrp volume_group_ID none
Parameters
Notes: 1. The managehostconnect command can be disruptive to host system I/O operations if the affected host port is logged onto the target storage unit. Ensure that the host port is offline to the host system before you process the managehostconnect command. 2. This command is used more effectively after you have issued the lshostconnect or showhostconnect commands and have analyzed the reports that are generated by these commands. The information that is reported by these commands can help you ensure that you specify the correct port group number when you issue the managehostconnect command. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -volgrp volume_group_ID | none (Required) Specifies that the SCSI host port connections that are associated with the specified port group number will be modified to access this volume group ID. A volume group ID is a four-digit decimal number with no leading zeroes, prefixed with the letter V. If none is specified, the volume group ID assignment is removed from all SCSI host port objects that are associated with a common port group number. Example: -volgrp none port_grp_number | (Required) Specifies the SCSI host port group number that associates two or more host ports as having access to a common volume group. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
168
Example
Invoking the managehostconnect command
dscli> managehostconnect -dev IBM.2107-75FA120 -volgrp 11 1
mkhostconnect
The mkhostconnect command configures open systems hosts port attachments to Fibre Channel ports that are configured for FC-AL or SCSI-FCP topology.
mkhostconnect -dev storage_image_ID -wwpn wwpn -lbs 512 520
-addrdiscovery
reportlun lunpolling
-profile
port_profile_name
-hosttype
host_type
-portgrp
port_grp_number
volume_group_ID
-ioport
-desc
description
Parameters
Open systems hosts port attachments to Fibre Channel ports are configured for identified access mode and SCSI protocol. Notes: 1. Ensure that you use the -hosttype parameter when you issue this command, because doing so saves input and processing time. The -hosttype parameter supplies the same information as if you had used the following three parameters: v -profile v -addrdiscovery v -lbs 2. If you are using the HP-UX operating system, see the volume restriction that is described under the -addrdiscovery parameter. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified WWPN, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -wwpn wwpn (Required) Specifies the worldwide port name (WWPN). The WWPN is a 16-character hexadecimal ID. The names are host attachment specific; for example, 12341234000A000F.
169
Note: You should not create more than one hostconnect per WWPN, except for SUN hosts. Creating more than one hostconnect per WWPN (each with a different volume group) is only supported for SUN. -lbs 512 | 520 (Optional) Specifies the logical block size that is used by the specified host system, in bytes. The block size must be compatible with the volume group type and the volume type configurations that apply to the specified host port connection. The 520-byte size is typically used by IBM System i models (OS/400). Notes: 1. Do not use the -lbs parameter if you specify the -hosttype parameter. 2. If you do not use the -hosttype parameter, use the lsportprof command to determine the block size that you need to specify. -addrdiscovery reportlun | lunpolling (Optional) Specifies the method for discovering logical unit number (LUN) addresses. v The reportlun method specifies that the host system can access up to 64 000 LUNs. Note: Use the reportlun method only with volume groups that are designated as mask type. (This designation is assigned when you use the mkvolgrp command to create the volume group.) However, you can use the reportlun method for a map type, but there are additional considerations if you are using an HP-UX operating system. For HP-UX operating systems, the number of volumes in the volume group must not exceed seven volumes. This restriction only applies when the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256. v The lunpolling method specifies that the host system can access up to 256 LUNs. For Sun, Linux, and Windows operating systems, the lunpolling method is typically selected. Notes: 1. Use the lunpolling method only with volume groups that are designated as map type. (This designation is assigned when you use the mkvolgrp command to create the volume group.) 2. Do not use the -addrdiscovery parameter if you specify the -hosttype parameter. -profile port_profile_name (Optional. If you specify the -hosttype parameter, this parameter is not used.) Specifies the name of the host connection behavior profile. If the name includes a blank space, enclose the name with double quotation marks. For example, -profile IBM pSeries AIX. Notes: 1. Do not use the -profile parameter if you specify the -hosttype parameter. 2. If you do not use the -hosttype parameter, use the lsportprof command to obtain a list of available profiles. -hosttype host_type (Optional) Specifies information about the following three parameters: v -profile v -addrdiscovery v -lbs Notes: 1. When the -hosttype parameter is specified, do not use the -profile, -addrdiscovery, or -lbs parameters.
170
2. Use the lshosttype command to obtain a list of known host types. -portgrp port_grp_number (Optional) Specifies the identifier that associates two or more host ports with access to a common volume group. Port group zero is reserved for ports that have not been associated with a port group. -volgrp volume_group_ID (Optional) Specifies an available volume group. This parameter accepts a fully qualified volume group ID including the storage image ID or a shortened version. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter V. A host connection uses only one volume group per storage image; that is, a single WWPN can access only one volume group per storage image. Note: If you do not specify a volume group when a host connection is created, the value for volume group is displayed as a " - " when you issue a lshostconnect or showhostconnect command. -ioport port_ID port_ID_list |all|none (Optional) Specifies all, none, one, or more I/O port IDs that allow host connection access to volumes. I/O ports cannot share the same WWPN. Ensure that there are no conflicts with the I/O ports of existing SCSI host connections. port_ID port_ID_list Specifies that you can designate up to 128 ports for an open systems host attachment assignment. You can list one or more port IDs separated by commas with no spaces. If you enter a list of I/O port IDs, access from the specified host connection to the specified volume group is allowed using only the designated list of port IDs. all none Specifies that you want to add all I/O port IDs. This allows the specified host connection access to the designated volume group through all the associated I/O port IDs. Specifies that you do not want to add any I/O ports. If you do not specify I/O ports, the storage unit is configured to allow host connection access to the specified volume group using any I/O port that is configured for FC-AL or SCSI-FCP topology.
A port ID is four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v "P" is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3. v "P" is the port number (0 - 3). This number is prefixed with the letter I. To specify a range of port IDs, separate the port IDs with a hyphen. You must separate multiple port IDs or ranges of port IDs with a comma between each ID or range of IDs. -desc description (Optional) Specifies the description that you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters. host_name | (Required) Specifies your host system or port name, limited to 16 characters. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Chapter 4. CLI commands
171
Example
Invoking the mkhostconnect command
dscli> mkhostconnect -dev IBM.2107-75FA120 wwname 12341234000A000F profile IBM pSeries AIX host_1_port_1
rmhostconnect
The rmhostconnect command removes a SCSI host port connection from a storage image.
rmhostconnect -dev storage_image_ID -quiet host_connection_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all host connections, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the removal confirmation prompt. host_connection_ID | (Required) Specifies the host connect ID, which is a unique identifier that uses any number from 0 FFFE within the scope of a storage image. This parameter accepts a fully qualified ID (includes manufacturer.machine type-serial number/hostconnectID) or a shortened version if the -dev parameter is specified. For DS8000, example of a fully qualified host connection ID: IBM.2107-75FA120/1 For DS6000, example of a fully qualified host connection ID: IBM.1750-68FA120/2 If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Attention: Use caution when you work with connection IDs to ensure that you have specified the connection that you want to delete. For example, if you intend to delete connection ID 0005 and type 000, the system deletes connection ID 0. Or, if you want to delete connection ID 0020 and type 002, the system deletes connection ID 2. The system does not consider the leading zeros, and 000 is interpreted as connection ID 0 and 002 is interpreted as connection ID 2.
Example
Invoking the rmhostconnect command
dscli> rmhostconnect -dev IBM.2107-75FA120 1
172
showhostconnect
The showhostconnect command displays detailed properties of a storage image host connection.
showhostconnect -dev storage_image_ID host_connection_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the host connection, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. host_connection_ID | (Required) Specifies a fully qualified host connection ID, which includes the manufacturer, machine type, and serial number if the -dev parameter is not used. The host connection ID is a unique identifier (0 - FFFE) within the scope of a storage image. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the showhostconnect command. Invoking the showhostconnect command
dscli> showhostconnect -dev IBM.210775FA120 1
Portgrp 0
VolgrpID 100
Atchtopo -
Speed Unknown
Desc SCSI1
173
The value that is represented by the host_connection_ID parameter is a unique identifier (0 - FFFE) within the scope of a storage unit. WWPN Specifies the worldwide port name (WWPN) for the designated host system port. HostType Specifies the name of the host type. "Unknown" is displayed when the information is not available. This indicates that the host type was not specified when the host connection was created or modified. LBS Specifies the logical block size that is used by this host system and the host system port. The logical block setting must be compatible with the volume group type that is configured for volume access. The 520 block size is typically used for IBM System i host system attachments. Addrdiscovery Specifies the LUN address discovery method that is used by this host system and the host system port. The LUN Discovery method must be compatible with the volume group type that is configured for volume access. The Poll LUNs method enables access to a maximum of 256 LUNs. The Report LUNs method enables access to a maximum of 64 000 LUNs. Profile Specifies the name of the host connection behavior profile. Portgrp Specifies the host port group ID. The ID ties together a group of SCSI host port objects that are accessing a common volume group. If the port group value is set to zero, the host port is not associated with any port group. VolgrpID Specifies the volume group ID. This ID is a unique identifier within the DS8000 for the SCSI volume group that the specified SCSI host port is assigned to. Specifies the volume group ID. This ID is a unique identifier within the DS6000 for the SCSI volume group that the specified SCSI host port is assigned to. Atchtopo The atchtopo is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the atchtopo attribute always displays as a " - " value. To obtain the I/O port topology, use the lsioport or showioport commands. ESSIOport Specifies the array of port IDs that the designated host port is logged into. A port ID is prefixed with the letter "I" and consists of four hexadecimal characters in the format EEAP, where: For DS8000: v EE is an I/O port enclosure number in the range of 00 - 17. v A is the adapter number and is specified as 1, 2, 4, or 5. v P is the port number (0 - 3). For DS6000: v EE is an I/O port enclosure number in the range of 00 - 01. v A is the adapter number and is specified as 0, 1, 2, or 3.
174
v P is the port number (0 - 3). Speed Speed is an attribute of the I/O port and, under certain conditions, might display a value that is inconsistent with the value reported by the lsioport command. Because this inconsistency cannot be corrected in all cases, the speed attribute always displays a value of "Unknown". To query the speed of an I/O port use the lsioport or showioport commands. Desc Specifies the description you defined for the SCSI host port. The description is limited to 256 byte or 128 double-byte characters.
lshosttype
The lshosttype command displays a list of known hosts, their associated port profiles, address discovery, and logical block size values. Use this command to get the available host types for the mkhostconnect command.
lshosttype -s -l -type volumeGroup_type
Parameters
-s (Optional) Displays the host types only. You cannot use the -l and -s parameters together. -l (Optional) Displays the default output for the specified host type. You cannot use the -l and -s parameters together. -type volumeGroup_type (Required) Displays only those host types that are associated with the specified volume group type. volumeGroup_type Only one type can be queried at a time. The following list provides the choices that can be specified. v ficonall v v v v v scsiall scsimask scsimap256 os400all os400mask
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lshosttype command. Invoking the lshosttype command
dscli> lshosttype -l -type scsiall
175
AddrDiscovery reportlun
LBS 512
Description IBM pSeries, RS/6000 and RS/6000 SP Servers (AIX) IBM zSeries Servers (Linux)
zLinux
lunpolling
512
lsarraysite
The lsarraysite command displays a list of array sites and status information for each array site in the list.
176
-cap
capacity
-array
array_ID
-state
-encrypt
supported unsupported
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified site ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Displays the array ID. You cannot use the -l and the -s parameters together. -l | | (Optional) Displays the default output plus the disk drive module rpm (revolutions per minute), disk class, and encryption support capability. You cannot use the -l and the -s parameters together. -dapair dapair_ID (Optional) Displays array sites that are associated with a common device adapter pair ID. A device adapter pair ID is a two-digit decimal number with no leading zeros. | | -cap capacity (Optional) Displays in decimal gigabytes (GB) the array sites that have the specified capacity of the disk drive module. -array array_ID (Optional) Displays the array site that is associated with the specified array ID. An array ID is a four-digit decimal number with no leading zeros, prefixed with the letter A. -state assigned | unassigned | unavailable | initializing (Optional) Displays array sites that are in the specified state. One of the following values is displayed: assigned Specifies that the designated array site is defined as an array. unassigned Specifies that the array site is available to be defined as an array. unavailable Specifies that the designated array site is unassigned and at least one disk is not in the normal state. Also, the array site is not in the initializing state. initializing Specifies that the array site is unassigned and all disks are either in the normal or initializing state. Also, at least one disk is in the initializing state.
177
-encrypt supported|unsupported (Optional) Displays only the array that has the specified encryption capability. site_ID . . . | (Optional) Displays array sites that have the specified IDs. An array site identifier is a four-digit decimal number with no leading zeros, prefixed with the letter S. To specify a range of array site IDs, separate the array site IDs with a hyphen. You must separate multiple array site IDs or ranges of array site IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsarraysite command using the -l parameter. Invoking the lsarraysite command
dscli> lsarraysite -l
178
State Specifies the array site state. One of the following values can be displayed in this field: Assigned Specifies that the designated array site is defined as an array. Unassigned Specifies that the array site is available to be defined as an array. Unavailable Specifies that the designated array site is unassigned and at least one disk is not in the normal state. Also, the array site is not in the initializing state. Initializing Specifies that the array site is unassigned and all disks are either in the normal or initializing state. Also, at least one disk is in the initializing state. Array Specifies the array ID that this assigned array site is assigned to. The ID is prefixed by the letter A. Diskclass+ Specifies the disk class as either high speed Fibre Channel disk drives or near-line disk drives. One of the following values can be displayed: ENT Specifies enterprise and represents high-speed Fibre Channel disk drives. NL Specifies near-line and represents ATA (FATA) disk drives SATA Specifies high capacity SATA disk drives. encrypt+ Specifies the encryption support capability. One of the following values can be displayed: supported The disk drive modules in this arraysite are capable of encryption. unsupported The disk drive modules in this arraysite are not capable of encryption. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
showarraysite
The showarraysite command displays detailed properties of a specific storage image array site.
showarraysite -dev storage_image_ID site_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified site ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
179
site_ID | (Required) Specifies that information be displayed for the designated array site ID. This parameter also accepts a fully qualified site ID, which consists of the storage image ID or a shortened version without the storage image ID, if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed by the letter S. The array site ID does not imply a physical location. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the showarraysite command. Invoking the showarraysite command
dscli> showarraysite -dev IBM.210775FA120 S11
Dkinf FCAL
Dkrate (GB/sec) 2
Spares 0
dataDDM 8
Diskclass SATA
Encrypt unsupported
180
Dkcap (10^9B) Specifies the minimum disk capacity of the disks in the designated array site. Diskrpm Specifies the minimum disk rpm of the disks in the designated array site. State Specifies the array site state. The values that can be displayed in this field are as follows: assigned Specifies that the designated array site is defined as an array. unassigned Specifies that the array site is available to be defined as an array. Array Specifies the array ID that the designated array site is assigned to. The ID is prefixed by the letter A. Dkinf Specifies the DDM interface type for the disks in this array site. One of the following values are displayed: v FC-AL (Fibre Channel arbitrated loop) v SAS (Serial Attached SCSI) Dkrate Specifies the minimum disk interface rate of the disks in the designated array site. DDMSN Specifies the list of DDM serial numbers (SN) that are associated with the designated array site. Each DDM SN is a 16-character string. Each serial number is separated by a comma. Spares Specifies the number of spare DDMs that are allocated from the array site. DataDDM Specifies the number of data DDMs. This value is based on the number of DDMs minus the number of spares. Diskclass Specifies the disk class as either high speed Fibre Channel disk drives or near-line disk drives. One of the following values are displayed: ENT NL Specifies enterprise and designates a high-speed Fibre Channel disk drive. Specifies near-line and represents ATA (FATA) disk drives.
SATA Specifies high capacity SATA disk drives. encrypt Specifies the encryption support capability. One of the following values are displayed: supported The disk drive modules in this array site are capable of encryption. unsupported The disk drive modules in this array site are not capable of encryption.
181
mkarray Creates one array per command. rmarray Removes the specified array or arrays from the storage unit. showarray Generates a report that displays the detailed properties of a specific array.
lsarray
The lsarray command displays a list of arrays in a storage image and status information for each array in the list.
lsarray -dev storage_image_ID -s -l -state assigned unassigned unavailable
-data
-raidtype
5 6 10
-dapair
dapair_ID
-cap
capacity
-rank
rank_ID
-encrypt
supported unsupported
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified array ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -s | -l | | (Optional) Displays default output plus the disk class and encryption capability of the arrays. You cannot use the -l and the -s parameters together. -state assigned | unassigned | unavailable (Optional) Specifies that information about those arrays in the designated state are to be displayed on the generated report. -data normal | degraded | readonly | failed | repairing | inaccessible (Optional) Specifies that information about those arrays in the designated data state are to be displayed on the generated report. -raidtype 5 | 6 | 10 (Optional - DS8000 only) Displays only those arrays with the specified RAID type, 5, 6, or 10. (Optional) Displays only the array ID. You cannot use the -l and the -s parameters together.
182
-dapair dapair_ID (Optional) Displays only the array that is specified by the device adapter pair ID. A device adapter pair ID is a two-digit decimal number with no leading zeros. | | -cap capacity (Optional) Displays in decimal gigabytes (GB) only the array with the specified DDM capacity. You can specify up to three digits after the decimal point, for example -cap 144.7. -rank rank_ID (Optional) Displays only the array that is assigned to the specified rank ID. A rank ID is a four-digit decimal number with no leading zeros, prefixed with the letter R. -encrypt supported | unsupported (Optional) Displays only the array sites that have the specified encryption capability. array_ID . . . | (Optional) Displays array information for the specified arrays. An array ID is a four-digit decimal number with no leading zeros, prefixed with the letter A. To specify a range of array IDs, separate the array IDs with a hyphen. For example: A10-A12 (equates to A10 A11 A12) You must separate multiple array IDs or ranges of array IDs with a blank space between each ID or range of IDs. For example: A11 A12 A14-A16. Your command in this case could look like: For DS8000,
dscli> lsarray IBM.210775FA120 -l A11 A12 A14-A16
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsarray command using the -l parameter. Invoking the lsarray command
dscli> lsarray -dev IBM.210775FA120 -l
DA Pair 10 11 20 21
DDMcap (10^9B) Diskclass 145 145 300 300 ENT ENT NL SATA
183
184
RaidType Indicates the type of RAID array (5, 6, or 10) and the array configuration (for example, 6+P). Note: The RAID type 6 is displayed in DS8000 models only. arsite Indicates the array sites that are associated with the array. Rank Specifies the rank the array is assigned to. The value is displayed as a combination of a Storage Image ID and a rank number. The rank number is the prefix R, followed by a four-digit decimal number, with no leading zeros (for example, R26). DA pair Identifies the DA pair ID. DA pairs are located in I/O enclosure pairs. DA pair ID indicates the I/O enclosure location. Note: An even-numbered DA pair ID indicates the first DA pair in an I/O enclosure pair. An odd-numbered DA pair ID indicates the second DA pair in an I/O enclosure pair. | | DDMcap (10^9B) Indicates the minimum disk capacity in decimal gigabytes (GB) of the storage devices (DDMs) in the specified array. Diskclass+ Specifies the disk class as either high speed Fibre Channel disk drives or near-line disk drives. One of the following values is displayed: ENT NL Specifies enterprise and represents high speed Fibre Channel disk drives Specifies near-line and represents ATA (FATA) disk drives
SATA Specifies high capacity SATA disk drives. encrypt Specifies the encryption support capability. One of the following values is displayed: supported The disk drive modules in this array are encryption capable. unsupported The disk drive modules in this array are not encryption capable. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
mkarray
The mkarray command creates one array per command. You can specify two array sites if you are working with a DS6000 machine type, but you can specify only one array site for a DS8000 machine type.
mkarray -dev storage_image_ID -raidtype 5 6 10 -arsite array_site
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified array site, do not set
Chapter 4. CLI commands
185
the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -raidtype 5 | 6 | 10 (Required) Specifies a RAID type for the array. Note: The -raidtype 6 parameter can be specified for DS8000 models only. -arsite array_site (Required for a DS8000 machine type) Specifies the array site for the array. An array site number is a four-digit decimal number with no leading zeros, prefixed with the letter S. Example of fully qualified array site: IBM.210775FA120/S11 (Required for a DS6000 machine type) Specify one or two array sites for IBM 1750 RAID types 5 and 10. If there are two array sites, both must be associated with a common DA pair ID. An array site number is a four-digit decimal number with no leading zeros, prefixed with the letter S. Separate the two array sites by a comma with no blank space in between. Example: S10,S11.
Example
Invoking the mkarray command
dscli> mkarray -dev IBM.210775FA120 -raidtype 10 -arsite S08
rmarray
The rmarray command deletes arrays.
rmarray -dev storage_image_ID -quiet " - " array_ID . . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all array IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the array removal confirmation prompt for this command. array_ID . . . | (Required) Specifies the array IDs that are to be deleted. Accepts a fully qualified array ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four digit decimal number with no leading zeros, prefixed by the letter "A". To specify a range of array IDs, separate the array IDs with a hyphen. You must separate multiple array IDs or ranges of array IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input.
186
Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmarray command
dscli> rmarray -dev IBM.210775FA120 A44
showarray
The showarray command displays detailed properties of a specific array.
showarray -dev storage_image_ID array_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified array ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. array_ID | (Required) Specifies the array ID that you want to view. This parameter accepts a fully qualified array ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed by the letter A. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the showarray command. Invoking the showarray command
dscli> showarray -dev IBM.210775FA120 A44
187
DDMRPM 15000
Interrate (GB/secs) 2
Diskclass SATA
Encrypt unsupported
188
v The repair array function has not completed. Inaccessible The array is in the Inaccessible data state if the storage unit cannot access a set of storage devices that are sufficient to access all the data on the array. RaidType Specifies the type of RAID array (5, 6, or 10) and the array configuration (for example, 6+P). Note: The RAID type 6 is displayed in DS8000 models only. Arsite Specifies the array sites that are associated with the array. Rank Specifies the rank that the array is assigned to. The value is displayed as a combination of a storage image ID and a rank number. The rank number is the prefix R, followed by a four-digit decimal number, with no leading zeros (for example, R26). Note: If the array is unassigned, the field is " " DA pair Specifies the DA pair ID. DA pairs are located in I/O enclosure pairs. The DA pair ID indicates the location of the I/O enclosure. Note: DA adapters are installed in slot 3 an enclosure and slot 6 in the peer enclosure. The DA pair ID identifies the enclosure that contains the DA adapter in slot 3. For example, a DA adapter is installed in slot of 3 of enclosure 2. Its peer is installed in slot 6 of enclosure 3. In this case, the DA Pair ID is 2. DDMcap (10^9B) Specifies the minimum disk capacity (10^9B) of the storage devices (DDMs) in the designated array. DDMRPM Specifies the minimum disk rpm of the DDMs in the designated array. Interface Type Specifies the disk interface type of the DDMs in the designated array Interrate Specifies the minimum disk interface rate of the disks in the designated array. Diskclass Specifies the disk class as either high speed Fibre Channel disk drives or near-line disk drives. One of the following values can be displayed: ENT NL Specifies enterprise and represents high speed Fibre Channel disk drives Specifies near-line and represents ATA (FATA) disk drives
SATA Specifies high capacity SATA disk drives. encrypt Specifies the encryption support capability. One of the following values can be displayed: supported The disk drive modules in this array are capable of encryption. unsupported The disk drive modules in this array are not capable of encryption.
189
The following rank specific commands are available: chrank Assigns an unassigned rank to an extent pool or removes an assigned rank from a extent pool. This command can also be used to change an assigned rank to an unassigned rank. lsrank Generates a report that displays a list of defined ranks in a storage unit and the status information for each rank in the list. mkrank Creates one fixed block or count key data (CKD) rank from one array. rmrank Deletes the specified ranks from a storage unit. showrank Generates two types of reports. One report displays the detailed properties of a specified rank. The other report displays the performance metrics of a specified rank.
chrank
The chrank command assigns an unassigned rank to an extent pool, or removes an assigned rank from a extent pool. This command can also be used to change an assigned rank to an unassigned rank.
chrank -dev storage_image_ID -reserve rank_ID -extpool extentpool_ID -quiet " - " . . . -release -unassign
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -reserve (Optional) Changes the rank configuration state to Reserved if the rank is assigned to an extent pool, or changes the state to Unassigned Reserved if the rank is not assigned to an extent pool. If the rank is in the depopulating state, changing the configuration state to Reserved with the -reserve parameter will also stop the rank depopulation. Note: Versions of the DS CLI prior to Release 6.1 will fail if they use the -reserve parameter on Release 6.1 or later DS8000 machines when the rank is in the unassigned state. These DS CLI versions cannot handle the Unassigned Reserved state. -release (Optional) Changes the rank configuration state from Unassigned Reserved to Unassigned, or from Reserved, Normal or Depopulation Error to Normal. -unassign (Optional) Changes the rank configuration state to Unassigned by removing the rank from the extent pool. If there are any extents on this rank that are used to provision a volume, the unassign will normally fail. If the Easy Tier LIC feature is active, then the rank configuration state is set to Depopulating while the extents are migrated to other ranks in the same extent pool. If the depopulation is successful, the rank configuration state is set to Unassigned. If it is not successful, the state is set to Depopulation Error. Notes:
190
1. If the rank enters the Depopulating configuration state, the time required to depopulate the rank depends on the number of allocated extents; it might take a long time before the rank enters the Unassigned state. When this situation occurs, a confirmation prompt will be given, but may be suppressed with the -quiet parameter. 2. Versions of the DS CLI prior to Release 6.1 will fail if they use the -unassign parameter on Release 6.1 or later DS8000 machines with allocated extents. These previous versions of the DS CLI must manually delete or migrate any volumes using these ranks before using the -unassign parameter. 3. The -extpool and -unassign parameters cannot be used together. -extpool extentpool_ID (Optional) Assigns the rank to an extent pool. Accepts either a fully qualified extent pool ID including storage image ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Note: The -extpool and -unassign parameters cannot be used together. -quiet (Optional) Turns off the rank modification confirmation prompt for this command. rank_ID . . . | (Required) Specifies one or more ranks to be modified. Accepts either a fully qualified rank ID, or a rank number if the -dev parameter is used. A rank number is a four-digit decimal number with no leading zeroes, prefixed by the letter R. To specify a range of rank IDs, separate the rank IDs with a hyphen. You must separate multiple rank IDs or ranges of rank IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the chrank command
dscli> chrank -dev IBM.2107-75FA120 -extpool P101 -quiet R2
lsrank
The lsrank command displays a list of defined ranks in a storage image and status information for each rank.
lsrank -dev storage_image_ID -s -l -grp 0 1
191
-state
normal unassigned reserved depopulating configuring unassignedreserved depopulationerr configerr deconfiguring deconfigerr configpending configpendingerr configoutofsyncerr
-data
-type
5 6 10
-extpool
extentpool_ID
-stgtype
fb ckd
-encryptgrp
encryption_group_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -s (Optional) Displays only the rank ID. You cannot use the -l and the -s parameters together. -l | | (Optional) Displays the default output plus the extent pool name, number of extents, extents that are used, and encryption group for each rank. You cannot use the -l and the -s parameters together. -grp 0 | 1 (Optional) Displays only the ranks that belong to the specified rank group. A rank in the unassigned state is not associated with a rank group. -state normal | unassigned | reserved | depopulating | configuring | unassignedreserved | depopulationerr | configerr | deconfiguring | deconfigerr | configpending | configpendingerr | configoutofsyncerr (Optional) Displays only ranks in the specified state. -data normal | degraded | readonly | failed | repairing | inaccessible (Optional) Displays only ranks in the specified data state. -type 5 | 6 | 10 (Optional) Displays only ranks of the specified RAID type. Note: The -raidtype 6 parameter can be specified for DS8000 models only.
192
-extpool extentpool_ID (Optional) Displays only ranks in the specified extent pool. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed with the letter P. -stgtype fb | ckd (Optional) Displays only ranks that are configured for the specified storage type. -encryptgrp encryption_group_ID (Optional) Displays the encryption group that this rank uses. rank_ID . . . | (Optional) Displays rank information for specified rank IDs. An ID range is defined by two IDs that are separated by a hyphen. You must separate multiple rank IDs or ranges of rank IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsrank command using the -l parameter. Invoking the lsrank command
dscli> lsrank -dev IBM.2107-75FA120 -l
ExtpoolID P1 P1 P1 P1
Stgtype fb fb fb fb
Encryptgrp 1 1 1 1
193
State Specifies the current configuration state of this rank ID. One of the following values is displayed: Normal Specifies that rank is assigned to an extent pool ID and none of the other state conditions apply. Unassigned Specifies that the rank is not assigned to a extent pool ID. Reserved Specifies that the rank extents are not eligible for volume assignment. Depopulating Specifies that the extents on a rank are not eligible for allocation and the existing allocations are to be moved to another rank in the extent pool using dynamic extent relocation. Configuring Specifies that the rank is in the process of being initially configured. Unassigned Reserved Specifies that a rank is not assigned to any extent pools, and it is also reserved. A rank with this state will change to Reserved state after it is assigned to an extent pool or changed to the Unassigned state after it is released. | | | | Depopulation Error Specifies that the depopulation of a rank has failed and efforts to depopulate the rank have stopped. A rank with this state will change to Reserved state if it is reserved, or change to Normal state if it is released. Configuration Error Specifies that a rank configuration process failed to complete successfully. This state reflects an internal error condition and not an error in the user's request to create the rank. To correct this state, you must delete the designated rank configuration. Deconfiguring Specifies that the rank is in the process of being deleted. Deconfiguration Error Specifies that a rank removal process has failed to complete successfully. This state reflects an internal error condition and not an error in the request to remove the rank. To correct this state, you must reissue the rmrank command for the designated rank configuration. Datastate Note: A rank is not considered for new extent allocations if it is not in the normal or degraded data state (even if the configuration state is normal). Datastate specifies the current state of the data extents contained by the designated rank ID. One of the following values is displayed: Normal A rank is in the normal data state during one of the following configuration states: unassigned, configuring, or configuration error. Degraded A rank is in the degraded data state if one or more arrays in the rank are in the degraded data state and none are in the read only, failed, repairing, or inaccessible data states. Read only A rank is in the read only data state if one or more arrays in the rank are in the read only data state and none are in the failed, repairing, or inaccessible data states. Failed The rank is in the failed data state if one or more arrays in the rank are in the failed data state.
194
Repairing A rank is in the repairing data state if one or more arrays in the rank are in the repairing data state and none are in the failed data state. Inaccessible A rank is in the inaccessible data state if one or more arrays in the rank are in the inaccessible data state and none are in the failed or repairing data states. Array Specifies the array ID that is assigned to the designated rank. RAIDtype Specifies the RAID type of the array associated with this rank. The value displayed is either 5, 6, or 10. Note: The RAID type 6 is displayed in DS8000 models only. ExtpoolID Specifies the extent pool to which the rank is assigned. Extpoolnam Specifies the name that is assigned to the extent pool to which the rank is assigned. Stgtype Specifies the storage type of the extent pool to which the rank is assigned. The value displayed is either fb (fixed block) or ckd (count key data) Exts Specifies the number of extents that are contained in the designated rank. The value displayed is a number in the range of 1 - 4000. Usedexts Specifies the number of extents that are allocated to volumes from the designated rank. The value displayed is a number in the range of 1 - 4000. encryptgrp Specifies the encryption group number. A dash ( - ) means that either encryption is supported but not used, or encryption is not supported.
mkrank
The mkrank command creates one fixed block or count key data (CKD) rank from one array.
mkrank -dev storage_image_ID -array array_ID -stgtype fb ckd
-encryptgrp
encryption_group_ID
-wait
-extpool
extentpool_ID
Parameters
Note: Ensure that you specify either the -wait or the -extpool parameter when using the mkrank command. Using either of these parameters allows you to be notified if the rank configuration has failed for any reason. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number. The storage image ID is required if you do not specify fully qualified IDs for the extent pool, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
Chapter 4. CLI commands
195
-array array_ID (Required) Specifies the ID of the array from which the rank is to be created. An array ID is a four digit decimal number with no leading zeroes, prefixed with the letter A. -stgtype fb | ckd (Required) Specifies the type of extent for which the rank will be configured, either fixed block or count key data. -encryptgrp encryption_group_ID (Optional - DS8000 only) Specifies the encryption group that this rank should use. The default is zero, which means that no encryption group is assigned to the rank. -wait (Optional) Delays the command response until the rank configuration process completes. -extpool extentpool_ID (Optional) Specifies the extent pool that contains the created rank extents. If an extent pool is specified, then the rank will be assigned to the extent pool. Otherwise, the rank state is unassigned. If specified, the extent pool must exist and must be compatible with the specified -stgtype parameter option. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Note: You must use the chrank command if you choose to specify the extent pool ID at a later time.
Example
Invoking the mkrank command
dscli> mkrank -dev IBM.2107-75FA120 -array A44 -stgtype fb -wait -encryptgrp 1
rmrank
The rmrank command deletes ranks from a storage image. This command is rejected if any volume extents in the rank are being used. In addition, this command formats the drives (DDMs). Until the formatting is done, the associated array cannot be removed.
rmrank -dev storage_image_ID -quiet " - " rank_ID . . .
Parameters
Note: The processing time that is associated with this command can be lengthy and might inhibit your use of the array on which this command is being processed. When the rmrank command is issued, the following processing occurs: v The rank is unassigned from the array. v The rank is removed. When this is successful a message is displayed. This piece of the process does not take long; however, the processing that is associated with this command is not complete even though you have received a message that the rank was removed. v The array is formatted. This processing can take some time. During this processing the array cannot be removed or assigned to another rank. Also, until this process is fully completed, the array is listed as assigned to the rank from which it is has been removed.
196
v You can check the progress of the rmrank command by logging onto another session of DS CLI. Issue the lsarray command against the storage image (for DS8000) or storage unit (for DS6000) where the rank or ranks are being deleted. When you no longer see the array that is assigned to the rank from which you removed it, the remove rank process is complete. The following list defines the parameters that are associated with the rmrank command: -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all ranks, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the rank removal confirmation prompt for this command. rank_ID . . . | (Required) Specifies an array of one or more ranks to be deleted. This parameter accepts a fully qualified rank ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter R. To specify a range of rank IDs, separate the rank IDs with a hyphen. You must separate multiple rank IDs or ranges of rank IDs with a space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmrank command
dscli> rmrank -dev IBM.2107-75FA120 R23
showrank
The showrank command displays detailed properties or performance metrics of a rank.
showrank -dev storage_image_ID -metrics rank_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified rank ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -metrics (Optional) Displays the rank ID and performance statistics for the specified rank.
197
Note: All performance statistics are an accumulation since the most recent counter wrap or counter reset. Rank performance counters are reset on a power up sequence or by a server failover and failback sequence. rank_ID (Required) Specifies the properties for the specified rank. This parameter accepts a fully qualified rank ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed by the letter R. | Example 1 For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showrank command. Invoking the showrank command to show rank properties
dscli> showrank -dev IBM.2107-75FA120 R34
Stgtype FB
Exts 1,000
Usedexts 500
Widearrays 1
Nararrays 0
Trksize 128
Strpsize 4
Strpesize 4
Extsize 16,384
Encryptgrp -
migrating(in) 0
migrating(out) 10
Group Specifies the rank group that the rank is assigned to. One of the following values is displayed: 0, 1, " - ". Note: " - " is displayed if the rank has not been assigned to an extent pool. State Specifies the configuration state that is associated with the rank at the time that the report is generated. The following values can be displayed for the rank:
198
Normal Specifies that a rank is assigned to an extent pool ID and none of the other state conditions apply. Unassigned Specifies that a rank is not assigned to an extent pool ID. Reserved Specifies that rank extents are not eligible for volume allocation. Depopulating Specifies that the extents on a rank are not eligible for allocation and the existing allocations are to be moved to another rank in the extent pool using dynamic extent relocation. Configuring Specifies that a rank is in the process of being initially configured. This state indicates that the associated rank transaction has not completed. Unassigned Reserved Specifies that a rank is not assigned to any extent pools, and it is also reserved. A rank with this state will change to Reserved state after it is assigned to an extent pool or changed to the Unassigned state after it is released. Depopulation Error Specifies that the depopulation of a rank has failed and efforts to depopulate the rank have stopped. A rank with this state will change to Reserved state if it is reserved, or change to Normal state if it is released. Configuration Error Specifies that a rank configuration process did not complete successfully. This state indicates that there is an internal error condition and it is not an indication that there was a user input error. Deconfiguring Specifies that a rank is in the process of being deleted. Deconfiguration Error Specifies that a rank removal process did not complete successfully. This state indicates that there is an internal error condition and it is not an indication that there was a user input error. This configuration state is corrected by reissuing the rmrank command. Datastate Specifies the current state of the data extents that are contained by this rank ID. The following values can be displayed for the rank: Normal Specifies that none of the other data states apply. Degraded Specifies that one or more arrays in the rank are in the degraded state. Read Only Specifies that one or more arrays in the rank are in the Read Only state. Failed Specifies that one or more arrays in the rank are in the Failed state. Repairing Specifies that one or more arrays in the rank are in the Repairing state. Inaccessible Specifies that one or more arrays in the rank are in the Inaccessible state. Array Specifies the array ID that is assigned to the designated rank.
Chapter 4. CLI commands
199
RAIDtype Specifies the RAID type (5, 6, or 10) of the array that is associated with the designated rank. Note: The RAID type 6 is displayed in DS8000 models only. ExtpoolID Specifies the extent pool to which the designated rank is assigned. Extpoolnam Specifies the extent pool to which the designated rank is assigned. Volumes Specifies the volume IDs that have an extent pool value that is allocated on the designated rank. Stgtype Specifies the storage type of the extent pool the designated rank is assigned to. Valid values are fixed block and count key data (CKD). Exts Specifies the number of extents that are contained in the designated rank. 1 - 4000 are valid values.
Usedexts Specifies the number of extents that are allocated to volumes from the designated rank. Widearrays Specifies the number of wide arrays that are contained by the designated rank. 0 or 1 are valid values. Nararrays Specifies the number of narrow arrays that are contained by the designated rank. Trksize Specifies the track size. Notes: 1. The track size is displayed as a 1 if it is associated with a CKD storage type. 2. The track size is displayed as 128 if it is associated with a fixed block storage type. Strpsize Specifies the number of logical tracks in a strip on the designated rank. Strpesize Specifies the number of logical tracks in a stripe on the designated rank. Extsize Specifies the number of logical tracks in a extent on the designated rank. Notes: 1. A CKD 1 GB extent contains 16 696 tracks. 2. A fixed block 1 GB extent contains 16 384 tracks. encryptgrp Specifies the encryption group number. A dash ( - ) means that either encryption is supported but not used, or encryption is not supported. migrating(in) Specifies the number of extents migrating into the rank. In other words, this value is the number of migrating extents in the rank that have specified this rank as the target of the migration.
200
migrating(out) Specifies the number of extents migrating out of the rank. In other words, this value is the number of migrating extents in the rank that have specified this rank as the source of the migration. |
Example 2
Invoking the showrank command to show performance metrics
dscli> showrank -dev IBM.2107-75FA120 -metrics R34
Writes 10000
Timeread 10000
Timewrite 10000
dataencrypted yes
Byteread Specifies the number of rank bytes that are read in 128 KB increments. Bytewrit Specifies the number of rank bytes that are written in 128 KB increments. Reads Specifies the rank read operations. Writes Specifies the rank write operations. Timeread Specifies the rank read response time in 16 millisecond increments. Timewrite Specifies the rank write response time in 16 millisecond increments. dataencrypted Specifies whether the data stored on the physical media is encrypted.
201
mkextpool Creates a fixed block or count key data (CKD) storage type extent pool. rmextpool Deletes one or more specified extent pools from a storage unit. showextpool Generates two types of reports. One of the reports displays the detailed properties of a specified extent pool. The other report displays the performance metrics for the specified extent pool.
chextpool
The chextpool command modifies attributes that are associated with an extent pool and allows you to merge two extent pools.
chextpool -dev storage_image_ID -name new_extent_pool_name
-extentlimit
enable disable
-limit
extent_limit_percentage
-threshold
extent_threshold_percentage
-virextentlimit
enable disable
-virlimit
virtual_extent_limit_percentage
-virthreshold
virtual_extent_threshold_percentage
-merge
from_extentpool_ID
-quiet
Parameters
Note: The -virextentlimit, -virlimit, and -virthreshold parameters are used only on DS8000 models. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the extent pool, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -name new_extent_pool_name (Optional) Specifies a new name for the extent pool. -extentlimit enable | disable (Optional) Specifies that the extent limit function is to be enabled or disabled. -limit extent_limit_percentage (Optional) Specifies the maximum value of the percentage of allocated real extents that are allowed in this extent pool. -threshold extent_threshold_percentage (Optional) Specifies threshold as a percentage of the available real extents that is compared to the actual percentage of available real extents. The system issues a warning when this percentage is exceeded.
202
Note: A warning is issued when this percentage is exceeded by capacity allocation to Extent Space Efficient (ESE) volumes. -virextentlimit enable | disable (Optional - DS8000 only) Specifies that the virtual extent limit function is enabled or disabled. -virlimit virtual_extent_limit_percentage (Optional - DS8000 only) Specifies the maximum value of the percentage of allocated virtual extents that are allowed in this extent pool. -virthreshold virtual_extent_threshold_percentage (Optional - DS8000 only) Specifies the minimum threshold percentage of the virtual extents available. When the percentage of the currently available virtual extents is less than this minimum percentage, notifications are sent and the virtual extent status is reported as exceeded. -merge from_extentpool_ID (Optional) Specifies an existing extent pool to be merged into the extent pool specified by the extentpool_ID parameter. When the merge is complete, the ranks assigned to from_extentpool_ID are reassigned to extentpool_ID, and the extent pool specified by from_extentpool_ID are removed. This parameter cannot be used with any other parameters except the -quiet and -dev parameters. -quiet (Optional) Turns off the confirmation prompt for the merge parameter. extentpool_ID | (Required) Specifies the ID of the extent pool to be changed. This parameter accepts either a fully qualified extent pool ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter P. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the chextpool command
dscli> chextpool -name host_4_extpool IBM.2107-75FA120/P21
lsextpool
The lsextpool command displays a list of extent pools in a storage unit and status information on each extent pool in the list.
lsextpool -dev storage_image_ID -s -l -stgtype fb ckd -rankgrp 0 1
203
-encryptgrp
encryption_group_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Displays only extent pool IDs. You cannot use the -l and the -s parameters together. -l | | (Optional) Displays default output plus the number of ranks and tiers, encryption group ID, and management status of the extent pools. You cannot use the -l and the -s parameters together. -stgtype fb | ckd (Optional) Displays only extent pools with the specified storage type. -rankgrp 0 | 1 (Optional) Displays only extent pools in the specified rank group. -encryptgrp encryption_group_ID (Optional) Displays only extent pool of the specified encryption group. extentpool_ID . . . | (Optional) Displays only the extent pools with the specified IDs. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed by the letter P. To specify a range of extent pool IDs, separate the extent pool IDs with a hyphen. You must separate multiple extent pool IDs or ranges of extent pool IDs with a space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsextpool command using the -l parameter. Invoking the lsextpool command
dscli> lsextpool -dev IBM.2107-75FA120 -l
204
Name ckd_c0 _ext _pool00 ckd_c1 _ext _pool01 fb_c0 _ext _pool02 fb_c1 _ext _pool03
Stgtype ckd
Rankgrp 0
Status below
ckd
below
600
fb
below
715
fb
below
715
%allocated 21 21 8 8
Reserved 0 0 0 0
Numvols 64 64 64 64
Numranks 1 1 1 1
encrypt grp 1 1 -
numtiers 1
etmanaged no
205
Availstor (2^30B) Specifies the available storage for the designated extent pool, in gibibytes (GiB). %allocated Specifies the percentage of real extents allocated. Available Specifies the maximum number of real extents available for allocation in the designated extent pool. Reserved Specifies the real extents reserved in the designated extent pool. Numvols Identifies the number of logical volumes that have been configured from the designated extent pool. Numranks+ Identifies the number of ranks that have been configured in the designated extent pool. Encryptgrp+ The encryption group number that the extent pool is related to. A dash ( - ) means that either encryption is supported but not used, or encryption is not supported. Numtiers+ Specifies the number of tiers in this extent pool. Etmanaged+ Specifies whether or not the extent pool is managed.
| Key: | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
| mkextpool The mkextpool command creates a fixed block or count key data (CKD) storage type extent pool.
mkextpool -dev storage_image_ID -rankgrp 0 1 -stgtype fb ckd
-extentlimit
enable disable
-limit
extent_limit_percentage
-threshold
extent_threshold_percentage
-virextentlimit
enable disable
-virlimit
virtual_extent_limit_percentage
-virthreshold extent_pool_name
virtual_extent_threshold_percentage "-"
-encryptgrp
encryption_group_ID
Parameters
Notes: 1. The -virextentlimit, -virlimit, and -virthreshold parameters are used only on DS8000 models.
206
2. An extent pool object is assigned to either rank group 0 or 1, which allows the extent pool to be managed by storage unit server 0 or 1 respectively. 3. Create extent pool objects before creating array and rank objects. 4. Create extent pools of a given type for both rank groups 0 and 1 so that volumes that are assigned to a volume group can be spread across both rank groups 0 and 1. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -rankgrp 0 | 1 (Required) Assigns the extent pool to either rank group 0 or 1. Rank group 0 is managed by server 0, and rank group 1 is managed by server 1. Note: If an extent pool does not exist, you can issue the chrank command after an extent pool is created to assign the rank to the extent pool. In addition, you can create extent pools of a given type for both rank groups 0 and 1 so that volumes that are assigned to a volume group might be spread across both rank groups 0 and 1. -stgtype fb | ckd (Required) Specifies the volume storage type that is contained by this extent pool. -extentlimit enable | disable (Optional) Specifies that the extent limit function is enabled or disabled. The default is disable. -limit extent_limit_percentage (Optional) Specifies the maximum value of the percentage of allocated real extents that are allowed in this extent pool. This value defaults to 100 if not specified. -threshold extent_threshold_percentage (Optional) Specifies the minimum threshold percentage of the real extents available. When the percentage of the currently available real extents is less than this minimum percentage, notifications are sent and the real extent status is reported as exceeded. -virextentlimit enable | disable (Optional - DS8000 only) Specifies that the virtual extent limit function be enabled or disabled. The default is disable. -virlimit virtual_extent_limit_percentage (Optional - DS8000 only) Specifies the maximum value of the percentage of allocated virtual extents that are allowed in this extent pool. -virthreshold virtual_extent_threshold_percentage (Optional - DS8000 only) Specifies the minimum threshold percentage of the virtual extents available. When the percentage of the currently available virtual extents is less than this minimum percentage, notifications are sent and the virtual extent status is reported as exceeded. -encryptgrp encryption_group_ID (Optional - DS8000 only) Specifies the encryption group that this extent pool should use. The default is zero, which means that no encryption group is assigned to the extent pool. extent_pool_name | (Required) Specifies your extent pool name, which is limited to 16 characters. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
207
Example
Invoking the mkextpool command
dscli> mkextpool -dev IBM.2107-75FA120 -rankgrp 0 -stgtype fb my_extpool
rmextpool
The rmextpool command deletes extent pools from a storage image.
rmextpool -dev storage_image_ID -quiet " - " extentpool_ID . . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all extent pools, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the extent pool removal confirmation prompt for this command. extentpool_ID . . . | (Required) Specifies the IDs of one or more extent pools to be deleted. A fully qualified extent pool ID is accepted, which consists of the storage image ID, or a shortened version without the storage image ID if the-dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeroes, prefixed with the letter P. Note: All rank assignments must be removed before extent pool can be deleted. To specify a range of extent pool IDs, separate the extent pool IDs with a hyphen. You must separate multiple extent pool IDs or ranges of extent pool IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmextpool command
dscli> rmextpool IBM.2107-75FA120/P101
208
Are you sure you want to delete extent pool IBM.2107.75FA120/P101? [y/n]: Y Extent pool IBM.2107-75FA120/P101 successfully deleted.
showextpool
The showextpool command displays detailed properties or performance metrics of an extent pool.
showextpool -dev storage_image_ID -metrics extentpool_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -metrics (Optional) Displays the extent pool ID and performance metrics for the specified extent pool. Note: All performance metrics are an accumulation starting from the most recent counter wrap or counter reset. The extent pool performance counters are reset on the following occurrences: v The storage unit is powered-up. v A server has failed and the failover and failback sequence is performed. extentpool_ID | (Required) Specifies the extent pool to be displayed. This parameter accepts a fully qualified extent pool ID, which consists of the storage image ID or an extent pool number without the storage image ID, if the -dev parameter is specified. The extent pool number is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Even numbered extent pools are associated with rank group 0. Odd numbered extent pools are associated with rank group 1. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode. |
Example 1
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showextpool command. Invoking the showextpool command to show extent pool properties
dscli> showextpool -dev IBM.2107-75FA120 P21
209
num ranks 4
numvols 3
status exceeded
%allocated 20
%available 80
configured 1000
allowed 600
available 800
allocated 200
reserved 0
%limit 80
%threshold 30
virextstatus below
%virallocated 10
%viravailable 90
virconfigured 1000
virallowed 800
viravailable 720
virallocated 80
virreserved 0
%virextlimit 70
%virextthreshold 35
encrypt grp 1
%allocated (ese) 0
%allocated (rep) 0
%allocated (std) 0
%allocated (over) 0
%virallocated (ese) 3
%virallocated (tse) 3
%virallocated (init) 0
%migrating(in) 0
%migrating(out) 10
numtiers 1
etmanaged no
210
rankgrp Specifies the rank group in which the designated extent pool is configured. numranks Specifies the number of ranks configured in the designated extent pool. numvols Identifies the number of logical volumes that have been configured from the designated extent pool. status Specifies the extent status. One of the following values is displayed: exceeded Specifies that the percent of real extents available is less than the real extent threshold below Specifies that the percent of real extents available is greater than the real extent threshold. full Specifies that the %Extents available is zero. %allocated Specifies the percentage of real extents allocated. A value of 1 - 100 is displayed. %available Specifies the percentage of real extents that are available. A value of 1 - 100 is displayed. configured Specifies the number of real extents that are contained in the extent pool. allowed Specifies the number of real extents that are below the applicable extent limit. available The number of real extents of a given type that are available for allocation to a logical volume. allocated Specifies the number of real extents of a given type in the extent pool that are allocated to logical volumes or auxiliary volumes. reserved Specifies the number of unallocated real extents in the extent pool that are on ranks of the same extent type in the reserved state. In addition, this value is the number of unallocated extents above the applicable extent limit on ranks of the same extent type that are not in the reserved state. %limit Specifies the maximum percentage of allocated real extents that are allowed in this extent pool. %threshold Specifies the minimum threshold percentage of the real extents available. When the percentage of the currently available real extents is less than this minimum percentage, notifications are sent and the extent status is reported as exceeded. Note: A warning is issued when this percentage is exceeded by capacity allocation to Extent Space Efficient (ESE) volumes. Virextstatus (DS8000) Specifies the virtual extent status. One of the following values is displayed: exceeded Indicates that the virtual extents available percentage is less than the virtual extent threshold. below Indicates that the virtual extents available (viravailable) as a percentage of the total extents (virallowed) is greater than the virtual extent threshold (virextthreshold).
Chapter 4. CLI commands
211
full Indicates that the available virtual extents is zero. (DS6000) No value displayed. %virallocated (DS8000) Specifies the percentage of virtual extents that are allocated compared to the total virtual extents that are allowed. Valid values are 0 - 100. (DS6000) No value displayed. %viravailable (DS8000) Specifies the percentage of virtual extents that are available compared to the total virtual extents that are allowed. Valid values are 0 - 100. (DS6000) No value displayed. Virconfigured (DS8000) Specifies the number of virtual extents that are configured in the extent pool. Virallowed (DS8000) Specifies the number of virtual extents that are below the applicable virtual extent limit. (DS6000) No value displayed. Viravailable (DS8000) Specifies the number of virtual extents that are available for allocation to space-efficient volumes. (DS6000) No value displayed. Virallocated (DS8000) Specifies the number of virtual extents in the extent pool that are allocated to space-efficient volumes. (DS6000) No value displayed. Virreserved (DS8000) Specifies the number of unallocated virtual extents in the extent pool that are on ranks of the same extent type that are in the reserved state. In addition, this value specifies the number of unallocated extents above the applicable extent limit on ranks of the same extent type that are not in the reserved state. (DS6000) No value displayed. %virextlimit (DS8000) Specifies the maximum value of the percentage of allocated virtual extents that can be allowed in this extent pool. Note: If the virtual extent limit is not enabled, a " - " value is displayed. (DS6000) No value displayed. %virextthreshold (DS8000) Specifies the minimum threshold percentage of the virtual extents available. When the percentage of the currently available virtual extents is less than this minimum percentage and the virtual extent status is reported as exceeded. Note: If the virtual extent limit is not enabled, a " - " value is displayed. (DS6000) No value displayed. encryptgrp The encryption group number that the extent pool is related to. A dash ( - ) means that either encryption is supported but not used, or encryption is not supported.
212
%allocated(ese) Specifies the percentage of allocated real extents on ESE (Extent Space Efficient) volumes compared to the real capacity of the Extent Pool. %allocated(rep) Specifies the percentage of allocated real extents on space efficient repository compared to the real capacity of the Extent Pool. %allocated(std) Specifies the percentage of allocated real extents on standard volumes compared to the real capacity of the Extent Pool. %allocated(over) Specifies the percentage of allocated real extents used for overhead, such as to support space efficient storage, compared to the real capacity of the Extent Pool. %virallocated(ese) Specifies the percentage of allocated virtual extents on ESE (Extent Space Efficient) volumes compared to the virtual capacity of the Extent Pool. %virallocated(tse) Specifies the percentage of allocated virtual extents on TSE (Track Space Efficient) volumes compared to the virtual capacity of the Extent Pool. %virallocated(init) Specifies the percentage of allocated virtual extents being initialized compared to the virtual capacity of the Extent Pool. %migrating(in) The percentage of extents migrating into the extent pool compared to the real capacity of the extent pool. (This value is the percentage of migrating extents in the extent pool that have specified this extent pool as the target of the migration.) %migrating(out) The percentage of extents migrating out of the extent pool compared to the real capacity of the extent pool. (This value is the percentage of migrating extents in the extent pool that have specified this extent pool as the source of the migration.) numtiers Specifies the number of tiers in this extent pool. etmanaged Specifies whether or not the extent pool is managed. |
Example 2
Invoking the showextpool command to show performance metrics
dscli> showextpool -metrics IBM.2107-75FA120/P101
213
virextcap 10000
virext 100000
dataencrypted yes
lsaddressgrp
The lsaddressgrp command displays a list of address groups for a storage image and the status information for each address group in the list.
214
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. Displays only the objects for the storage unit specified. The storage image ID is required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 For DS6000, example: IBM.1750-68FA120 -s (Optional). Displays the address group IDs only. You cannot use the -l and the -s parameters together. -l (Optional). Displays the default output. You cannot use the -l and the -s parameters together. -stgtype fb | ckd (Optional). Displays only the address groups that are associated with the specified storage type.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsaddressgrp command using the -l parameter. Invoking the lsaddressgrp command
dscli> lsaddressgrp -dev IBM.2107-75FA120 -l
fb
0100
4096
16
164096
ckd
0200
4096
16
164096
ckd
0300
4096
16
164096
215
Stgtype Specifies the type of logical devices that are configured for the specified address group: fb - fixed block and ckd - count key data. Basevolnum Specifies the lowest logical volume number in the address group. Vols Specifies the number of logical volume numbers that are associated with the address group. LSSs Specifies the number of logical subsystems (LSSs) that are configured on the address group. Confgvols Specifies the number of logical volumes that are configured on the address group. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
chlcu
The chlcu command modifies a logical control unit.
chlcu -dev storage_image_ID -ss new_ss_ID -lcutype 3990-3 3990-tpf 3990-6 bs2000
-critmode
enable disable
-pprcconsistgrp
enable disable
-extlongbusy
timeout
-ccsess LCU_ID
timeout
-xrcsess
timeout
-resgrp
resource_group_ID
. . . " - "
216
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LCU subsystem ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -ss new_ss_ID (Optional). Specifies your new LCU subsystem ID value (valid range is hexadecimal 0x0001 0xFFFF). If this parameter is specified, multiple LCUs are not allowed. The new SSID that you specify replaces the existing SSID value in the initial target LCU ID. Example: F010 -lcutype 3990-3 | 3990-tpf | 3990-6 | bs2000 (Optional). Changes the target LCUs to the new LCU type: 3990-3 TYPE_3990_MODEL_3 3990-tpf TYPE_3990_MODEL_3_for_TPF 3990-6 TYPE_3990_MODEL_6 BS2000 TYPE_BS_2000 -critmode enable | disable (Restricted). Specifies that the critical heavy mode setting in the target LCUs be enabled or disabled. Critical heavy mode controls the behavior of the remote mirror and copy (formerly PPRC) pairs that have a primary logical volume on this LCU and are in an LCU consistency group. See the mkpprc command for additional information. You must have administrator privileges to specify this option. -pprcconsistgrp enable | disable (Optional). Specifies that the remote mirror and copy consistency group state setting be enabled or disabled. Any volume that becomes suspended that is associated with the subsystem LSS passes into an extended Long Busy state unless a created consistency group has been received. Otherwise, the volume does not become long busy. -extlongbusy timeout (Optional). Specifies the time in seconds that an LCU consistency group volume stays long busy after reporting an error that causes a remote mirror and copy (formerly PPRC) suspension if a consistency group has not been created. -ccsess timeout (Optional). Specifies the concurrent copy session timeout in seconds setting. This value indicates how long (in seconds) any LCU volume in a concurrent copy session stays long busy before the concurrent copy session is suspended. Example: 500 -xrcsess timeout (Optional - DS8000 only). Specifies the XRC session timeout value in seconds. This value indicates the time in seconds that any LCU volume in an XRC session stays long busy before the XRC session is suspended. The valid timeout range is 1 - 9999 seconds. Example: 500
217
-resgrp resource_group_ID (Optional) Specifies the resource group that the LCUs are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. LCU_ID . . . | (Required). Specifies one or more LCUs that are to be modified by this command. A LCU ID is two hexadecimal characters 00 - FE for DS8000 and 00 - 1F for DS6000. You must separate multiple IDs and multiple ID ranges with a space. This parameter accepts a fully qualified LCU ID (which includes the manufacture.machinetype-serial number/ID) or a shortened version if the -dev parameter is specified. To specify a range of LCU IDs, separate the IDs with a hyphen (-). If you have specified a new subsystem ID value with the -ss parameter, only one LCU ID can be specified. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example: 00-03 08
Example
Invoking the chlcu command
dscli> chlcu -dev IBM.2107-75FA120 -critmode enable 00-0F
lslcu
The lslcu command displays a list of logical control units (LCUs) for a storage image and status information for each logical control unit in the list.
lslcu -dev storage_image_ID -s -l -addrgrp address_group
-resgrp
resource_group_ID
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. Displays only the objects for the storage unit that is specified. The storage image ID is required if you do not specify a fully qualified LCU ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -s | (Optional). Displays LCU IDs only. You cannot use the -l and the -s parameters together.
218
-l | | (Optional). Use this parameter to display the default output plus resource groups. You cannot use the -l and the -s parameters together. -addrgrp address_group (Optional). Specifies an address group. Only the LCUs that belong to the specified address group are displayed. An address group is a single character in the range of 0 - 9 or A - F. -resgrp resource_group_ID (Optional) Displays only the LCUs that are assigned to the specified resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. LCU_ID . . . | (Optional). Specifies the ID associated with an LCU. A LCU ID is two hexadecimal characters 00 - FE for DS8000 and 00 - 1F for DS6000. To specify a range of LCU IDs, separate the LCU IDs with a hyphen (-). You must separate multiple LCU IDs or ranges of LCU IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example: 00-03 08
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lslcu command using the -l parameter. Invoking the lslcu command
dscli> lslcu -dev IBM.2107-75FA120 -l
Group 0
subsys 8010
resgrp RG0
256
8011
3990-6
RG0
256
8012
3990-6
RG0
256
8013
3990-6
RG0
219
This is a unique identifier that is assigned to this logical control unit object. The ID includes the storage image ID and the 2-digit LCU ID. Group Specifies the server that is managing the logical control unit group. The server is identified as either 0 or 1. Addrgrp Specifies the address group object of which the logical control unit is a member. Confgvols Specifies the number of volumes, or logical devices assigned to the LCU ID. This number includes base CKD volumes and alias CKD volumes. Subsys Specifies the value you assigned, or the default SSID value. Conbasetype Specifies the LCU type. The allowable values include the following LCU types: v 3390-3 v 3390-tpf v 3390-6 (this value is the default if no value is assigned) v bs2000 resgrp+ Specifies the resource group ID that the LCU is assigned to. The resource group ID begins with the letters RG and ends with a decimal number. | Key: | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
| mklcu The mklcu command creates a logical control unit (LCU) in a storage image.
mklcu -dev storage_image_ID -qty quantity -id lcu_ID -ss ss_ID
-lcutype
-critmode
-pprcconsistgrp
-extlongbusy
timeout
-ccsess
timeout
-xrcsess
timeout
-resgrp
resource_group_ID
Parameters
Notes: 1. A logical control unit is configured to represent a grouping of logical CKD volumes. 2. Multiple sequential LCU IDs can be created with a single request, but all logical control units must be of the same type and specify the same options.
220
3. The DS8000 has a 64 KB 256 volume address space that is partitioned into 255 logical subsystem (LSS) units, where each LSS contains 256 logical volume numbers. The 255 LSS units are assigned to one of 16 address groups, where each address group contains 16 LSSs, or 4 KB volume addresses. 4. The DS6000 has a 16 384 volume address space that is partitioned into 64 logical subsystem (LSS) units, where each LSS contains 256 logical volume numbers . The 64 LSS units are assigned to one of 4 address groups, where each address group contains 16 LSSs, or 4096 volume addresses. All of the LSSs in one address group must be of the same type (CKD or fixed block). 5. LCUs are typically created in groups of 16, beginning at LSS address X'x0'. -dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LCU ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -qty quantity (Required). Specifies the number of LCU IDs to be created. You can specify a quantity value from 1 255 for the DS8000 model. You can specify a quantity value from 1 - 64 for the DS6000 model. This command is rejected if any of the LCU IDs which are based on the initial LCU ID and the quantity, are currently defined or are outside the range of supported LCU IDs. The valid LCU ID range for DS8000 is 00 - FE and for DS6000 it is 00 - 1F. Example: 16 -id lcu_ID (Required). Specifies the LCU ID to be created, or the first LCU ID in a sequence of LCU IDs to be created. A LCU ID is two hexadecimal characters 00 - FE for DS8000 and 00 - 1F for DS6000. Example: 00 -ss ss_ID (Required). Specifies the subsystem ID that you have assigned. A subsystem ID is four hexadecimal characters 0x0001 - 0xFFFF. If multiple LCU IDs are being created, then the SSID value increments for each additional LCU ID that is created. If 16 LCUs are created, starting with SSID 0x10, then the SSID values are 0x0010 0x001F. Example: 0010 -lcutype 3990-3 | 3990-tpf | 3990-6 | bs2000 (Optional). Specifies that one of the following types of LCU be created: 3990-3 type 3990 model 3 3990-tpf type 3990 model 3 for tpf 3990-6 type 3990 model 6 bs2000 type bs 2000 -critmode (Restricted). Specifies that critical heavy mode be enabled. Critical Heavy mode controls the behavior of the remote copy and mirror pairs that have a primary logical volume on this LCU. The default value is disable.
221
You must have administrator privileges to specify this option. See the mkpprc command for additional notes about the use of this parameter. Note: If an attempt is made to create the LCU and enable the critical heavy mode but the user does not have the authority to enable the -critmode parameter, two messages are displayed when the command is processed: v One message states that the LCU has been successfully created. v A second message states "Your user ID does not have the authority to perform this operation". So, the LCU is created but the critical heavy mode is not enabled. -pprcconsistgrp (Optional). Specifies a remote mirror and copy consistency group state setting. Any volume that becomes suspended that is associated with the subsystem LSS passes into an extended Long Busy state unless the consistency group that was created previously has been received. Otherwise, the volume does not become long busy. -extlongbusy timeout (Optional). Specifies the time in seconds that an LCU consistency group volume stays long busy after reporting an error that causes a remote mirror and copy suspension if a consistency group has not been created. The default value is 120 seconds. -ccsess timeout (Optional). Specifies the concurrent copy session timeout parameter as the time in seconds that any LCU volume in a concurrent copy session stays long busy before suspending a concurrent copy session. The valid timeout range is 1 - 9999 seconds. The default value is 300 seconds. Example: 500 -xrcsess timeout (Optional - DS8000 only). Specifies the XRC session timeout parameter as the time in seconds that any LCU volume in an XRC session stays long busy before suspending the XRC session. The valid timeout range is 1 - 9999 seconds. The default value is 300 seconds. Example: 500 -resgrp resource_group_ID (Optional) Specifies the resource group that the LCUs are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. The default is RG0.
Example
Invoking the mklcu command
dscli> mklcu -dev IBM.2107-75FA120 -qty 16 -id 80 -ss 2300
rmlcu
The rmlcu command deletes existing logical control units.
rmlcu -dev storage_image_ID -quiet " - " LCU_ID . . .
222
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all logical control units, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -quiet (Optional) Turns off the LCU removal confirmation prompt for this command. LCU_ID . . . | (Required) An array of one or more LCUs to be removed. This parameter accepts a fully qualified LCU ID or a shortened version, if the -dev parameter is specified. A LCU ID is two hexadecimal characters in the range 00 - FE for the DS8000 and 00 - 1F for the DS6000. To specify a range of LCU IDs, separate the LCU IDs with a hyphen (-). You must separate multiple LCU IDs or ranges of LCU IDs with a blank space between each ID or range of IDs. Example: 00-03 08 If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmlcu command
dscli> rmlcu -dev IBM.2107-75FA120 00-0F
showlcu
The showlcu command displays the detailed properties of an individual logical control unit (LCU).
showlcu -dev storage_image_ID LCU_ID " - "
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the logical control unit, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120
Chapter 4. CLI commands
223
LCU_ID | (Required). Displays the properties for the specified logical control unit. The LCU ID is a 2-digit hexadecimal number in the range of 00 - FE for the DS8000 and 00 - 1F for the DS6000. Accepts a fully qualified LCU ID, which consists of the storage image ID or a shortened version without the storage image ID, if the -dev parameter is specified. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS6000, example: IBM.1750-68FA120/10
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the showlcu command. Invoking the showlcu command
dscli> showlcu -dev IBM.2107-75FA120 10
ID IBM.210775FA120 /10
Group 0
Subsys 0010
Pprcconsistgrp Disabled
Crithvmode Disabled
resgrp RG0
Group Specifies the server that manages the logical control unit group. The displayed values are 0 or 1. Addrgrp Specifies the address group object that the logical control unit is a member of. Confgvols Specifies the number of volumes or the logical devices that are assigned to this LCU ID. This number includes base count key data (ckd) volumes and alias ckd volumes. Subsys Specifies the subsystem ID that you assigned to this logical control unit. The range of values that you selected from is 0001 - FFFF. Conbasetype Specifies the LCU type that you designated for the logical control unit. If you did not designate a type, the default value of 3990-6 is assigned and displayed.
224
Pprcconsistgrp Specifies the assigned PPRC consistency group state setting. If you do not designate enabled, the default value of disabled is assigned. Xtndlbztimout Specifies the assigned extended long busy timeout value. If you do not designate a value, the default value of 120 seconds is assigned and displayed. Ccsesstimout Specifies the assigned concurrent copy session timeout value. If you do not designate a value, the default value of 300 seconds is assigned and displayed. Xrcsesstimout (DS8000 only) Specifies the assigned XRC session timeout value. If you do not designate a value, the default value of 300 seconds is assigned and displayed. Crithvmode Specifies whether the critical heavy mode for Remote Mirror and Copy operations is in effect. If you do not designate a value, the default value of Disabled is assigned and displayed. resgrp Specifies the resource group ID that the LCU is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
chckdvol
The chckdvol command modifies the attributes that are associated with a count key data (CKD) base volume.
225
-cap
new_capacity
-captype
cyl mod1
-datatype
-quiet
-perfgrp volume_ID
performance_group_ID
-resgrp
resource_group_ID
. . . " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -name new_volume_name (Optional) User specified nickname for this CKD base volume. This nickname should not exceed 16 characters. It can contain one of the following wild cards: v (#d) - insert volume_ID (decimal format) v (#h) - insert volume_ID (hexadecimal format) -datatype 3380|3390|3390-A (Optional) Specifies the volume data type. For Extended Addressing Volumes (EAV), which have a capacity greater than 65520 cylinders, the data type 3390-A must be specified. You can also specify the data type 3390-A for volumes smaller than 65520 cylinders. Notes: 1. You can specify the data type 3390A for DS8000 models only. 2. You must ensure that the volume data type is compatible with the host systems that access this volume. 3. You cannot use the -datatype parameter and the -cap parameter in the same command. -cap new_capacity (Optional) (DS8000 only) Specifies the quantity of CKD cylinders that you want to allocate to the specified volume. You can also use the -captype parameter to change the unit type of the capacity to mod1 units. 3380 volumes cannot be expanded. For 3390A volumes (DS8000 only), the -cap parameter value can be in the range of 1 to 65,520 (increments of 1) or 65,667 1,182,006 (increments of 1113). For 3390 volumes, the -cap parameter value can be in the range of 1 to 65,520 (849KB to 55.68 GiB). Notes: 1. Check your operating system documentation to ensure that volume expansion is supported before proceeding with the expansion.
226
2. If you expand a 3390 volume to an Extended Addressing Volume (EAV), the data type is changed to 3390-A. 3. Attempting to reduce the size returns an error and causes the transaction to fail. 4. You cannot use the -datatype parameter and the -cap parameter in the same command. -captype cyl | mod1 (Optional) Specifies the unit type of the capacity given by using the -cap parameter. The default is cyl. A mod1 unit is equivalent to 1113 cylinders, and 1263.28 cylinders is equivalent to 1 GiB. You must specify the -cap parameter to specify the -captype. -quiet (Optional) Turns off the CKD volume modification confirmation prompt for this command. -perfgrp performance_group_ID (Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG, and valid performance groups numbers are 0, and 16-31. The default is PG0. -resgrp resource_group_ID (Optional) Specifies the resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. volume_ID . . . | (Required) An array of one or more CKD base volume IDs or volume ID ranges to modify. A volume ID range is defined by two volume IDs that are separated by a dash. Multiple volume IDs or volume ID ranges must be separated with a blank space between each ID. Example: 0100-010F 0180-018F 0120 The volume ID format is four hexadecimal characters LLVV that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.
Example
Invoking the chckdvol command
dscli> chckdvol -dev IBM.2107-75FA120 -perfgrp PG18 0100
initckdvol
The initckdvol command initializes a logical volume and releases extents from a space-efficient logical volume.
227
For space efficient logical volumes, this command is used to release space. For TSE volumes, it releases tracks in the repository, reducing the repository allocated space. For ESE volumes, it releases extents in the extent pool being used, reducing the allocated extents. For example, if a space-efficient logical volume has data that is stored on it that is no longer needed, use the initfbvol command to free the extents/tracks that were assigned to this logical volume. This allows the extents/tracks to be reused by other space-efficient logical volumes. This command is not supported on DS6000 models.
initckdvol -dev volume_ID . . . " - " storage_image_ID -action releasespace -quiet
For example, if a space-efficient logical volume is used as a FlashCopy target volume and the data that is stored on these tracks are no longer needed, use the initckdvol command to free the extents that were assigned to this logical volume. This allows the extents to be reused by other space-efficient logical volumes. This command is not supported on DS6000 models.
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -action releasespace (Optional) Specifies that you want the system to release the repository space held by the designated space-efficient volume back to the repository. (The repository is the physical extents that provision the virtual extents for virtual space volumes.) The -action releasespace command cannot be used on a standard volume. -quiet (Optional) Turns off the confirmation prompt for the -action parameter. volume_ID . . .|(Required) The volume ID format is four hexadecimal characters LLVV, that represent the following values: LL VV Specifies the logical control unit number, 00 - FE. Specifies the volume number, 00 - FF.
You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. To specify a range of volume IDs, separate the volume IDs with a dash. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive command mode.
228
Example
Invoking the initckdvol command
dscli> initckdvol -dev IBM.2107-75FA120 action releasespace 0101
lsckdvol
The lsckdvol command displays a list of count key data (CKD) base and alias volumes in a storage image and status information for each volume in the list.
lsckdvol -dev storage_image_ID -s -l -datatype 3380 3390 3390-A
-extpool
extentpool_ID
-access
online fenced
-data
normal not_normal
-config
normal not_normal
-lcu
lcu_ID
-voltype
base alias
-sam
-eam
-perfgrp
performance_group_ID
-resgrp
resource_group_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s | | -l | | (Optional) Displays the default output plus additional attributes that are identified as long output in the Report field definitions list. You cannot use the -s and the -l parameters together. (Optional) Displays only volume IDs associated with the storage image ID. You cannot use the -s and the -l parameters together.
229
-datatype 3380 | 3390 | 3390-A (Optional) Specifies that you want the system to display only volumes that meet the designated volume data type. Note: The data type 3390A can be displayed for DS8000 models only. -extpool extentpool_ID (Optional) Specifies that you want the system to display only volumes that are associated with the designated extent pool. -access online | fenced (Optional) Specifies that you want the system to display only volumes with the specified access state. -data normal | not_normal (Optional) Specifies that you want the system to display only the volumes that meet the criteria of the designated data state. -config normal | not_normal (Optional) Specifies that you want the system to display only the volumes that meet the criteria of the designated configuration state. -lcu lcu_ID (Optional) Specifies that you want the system to display only volumes with IDs that contain the specified logical control unit ID. Each logical control unit can contain up to 256 volumes. The LCU ID is a 2-digit hexadecimal number in the range of 00 - FE for the DS8000 and 00 - 1F for the DS6000. Note: Including the -lcu parameter can significantly reduce response time because the entire storage unit does not have to be queried. -voltype base | alias Specifies the type of CKD volumes that you want the system to display. -sam standard | tse | ese (Optional - DS8000 only) Specifies that you want the system to display only volumes that meet the criteria of the storage allocation method as follows: standard Volumes that are fully allocated with real extents. tse ese Track space-efficient logical volumes that contain a set of virtual extents that are associated with the space-efficient storage in the same extent pool. Extent space efficient logical volumes that are provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool.
-eam legacy | rotatevols | rotateexts | managed (Optional - DS8000 only) Specifies that you want the system to display only volumes that meet the criteria of the extent allocation method as follows: legacy Specifies that the volume was created before the use of the current algorithm. Legacy is always the reported value for a DS6000 model. rotateexts Specifies that volumes were created using storage-pool striping. rotatevols Specifies that each successive logical volume that is created is allocated on the next available rank in the extent pool. managed Specifies that the volume is in an extent pool managed by Easy Tier.
230
-perfgrp performance_group_ID (Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG, and valid performance groups numbers are 0, and 16-31. The default is PG0. -resgrp resource_group_ID (Optional) Displays only the volumes that are assigned to the specified resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. volume_ID . . . | (Optional) Displays volumes with the specified IDs. The volume ID format is four hexadecimal characters LLVV that represent the following values: LL (for DS8000) Specifies the logical control unit number, 00 - FE LL (for DS6000) Specifies the logical control unit number, 00 - 1F VV (for both the DS8000 and DS6000) Specifies the volume number, 00 - FF To specify a range of volume IDs, separate the volume IDs with a dash (-). You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. Example: 0100-010F 0180-018F 0120 If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format for clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsckdvol command using the -l parameter. Note: If a column heading applies to the DS8000 only, a " - " value is displayed when the report is generated for a DS6000 model. The following example is based on the output results for a volume with 3340 cylinders. Invoking the lsckdvol command
dscli> lsckdvol -dev IBM.2107-1300861 -l 1410
231
orgbvols -
extpool P2
sam standard
eam legacy
perfgrp PG18
resgrp RG0
Conditions - one of the following occurred: v Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown. v Data was lost that indicated extents on the logical volume were active FlashCopy targets.
232
The access state is fenced. Rank failed Specifies that one or more extents that are associated with the logical volume are on a rank that is in the failed data state. The access state is Fenced. Rank repairing Specifies that one or more extents that are associated with the logical volume are on ranks that are in the repairing data state. The access state is Fenced. Rank repaired Specifies that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. The access state is Fenced. Global inaccessible Specifies that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data that is associated with the logical volume might be inaccurate. The access state is Fenced. Global lost Specifies that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data that is associated with the logical volume might be inaccurate. The access state is fenced. NVS data inaccessible Specifies that active NVS data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. The access state is Fenced. " - " Specifies that the logical volume is designated as a CKD alias. Configstate One of the following configuration states are displayed: Normal Indicates that there are no logical volume configuration operations in progress, and the volume is not being deconfigured, merged, or migrated. Configuring Indicates that the logical volume is in the process of being configured for the first time. Reconfiguring Indicates that the logical volume is in the process of allocating or deallocating extents due to a modification of the requested capacity attribute after initial creation. Deconfiguring Indicates that the logical volume is in the process of being deleted. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal error condition and not an error in the request to create the volume. If you have a volume in this state, use the rmfbvol command to delete each volume listed with the configuration state of "configuration error". Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool. Migrating Indicates that the volume is in the process of migrating, or waiting to be migrated. Migration Cancelled Indicates that the volume was in the process of migrating and then the migcancel' action of the manageckdvol command was issued, leaving some of the extents waiting to be migrated in the
Chapter 4. CLI commands
233
source pool while other extents have already migrated to the target pool. Migration has stopped, and cannot be resumed. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Migration Paused Indicates that the volume was in the process of migrating and then the migpause' action of the manageckdvol command was issued. Migration has stopped, but can be resumed. Migration Error Indicates that the volume migration process failed to complete successfully. This state reflects an internal error condition and not an error in the request of the user to migrate a volume. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Deconfiguration error Indicates that a request to delete a volume did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmfbvol command for the designated volume. Transposition Error Indicates that the volume is in an extent pool that was unsuccessfully merged. This state reflects an internal error condition. Corrective action: Use the chextpool command with the -merge parameter again to redrive the merge extent pool and to correct this state. deviceMTM One of the following is displayed: v 3380-2 v 3380-3 v 3390-3 v 3390-9 v 3390-A Device MTM is determined by the CKD base volume data type and volume capacity (in cylinders). Note: The deviceMTM 3390A can be displayed for DS8000 models only. Volser Specifies the base CKD volume serial number written by the user at track address 0x0000, record 3. Datatype Identifies the volume data type setting. Voltype Specifies that the logical volume is one of the following types: v CKD base v CKD alias Orgbvols (original base vol) One of the following is specified: v Identifies the original base CKD volume ID to which this CKD alias volume is assigned. v " - " is displayed for a CKD base volume type. Note: For a CKD Alias type volume, the base and alias volume IDs are of a common LCU ID. Extpool Identifies the extent pool ID. Volume extents are allocated from this extent pool ID.
234
Note: Volumes that belong to an encrypted extent pool are encrypted. You can see the encryption group of an extent pool by using the lsextpool -l, or showextpool commands. SAM Specifies the storage allocation method. The following values are displayed: standard Designates that the system fully allocated the volume with real extents at volume creation time. An inquiry on a DS6000 model always reports this value. tse Designates that a track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. Physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. ese Designates that an extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. Cap (cyl) Specifies the quantity of volume CKD cylinders that are available for host system access. | | Cap (2^30B) Specifies the size of volume that is available for host system access in gibibytes (GiB). Cap (10^9B) Specifies the size of volume that is available for host system access in decimal gigabytes (GB). Reqcap (cyl) Specifies the requested quantity of volume CKD cylinders (for example, 3339). Note: A value of 0 is displayed for the DS6000. EAM Specifies the extent allocation method that will be used if the volume is migrated or expanded. legacy Specifies that the volume was created before the use of the current algorithm. Legacy is always the reported value for a DS6000 model. rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. managed Specifies that the extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage. " - " A dash (-) value is displayed if the extent allocation method does not apply , for example if the volume is a track space efficient (TSE) volume. perfgrp Specifies the performance group ID that the volume is assigned to. The performance group ID begins with the letters PG and ends with a decimal number.
Chapter 4. CLI commands
235
resgrp Specifies the resource group ID that the volume is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
manageckdvol
The manageckdvol command initiates a change on count key data (CKD) volumes by executing a process. This command is not supported on DS6000 models.
manageckdvol -dev storage_image_ID -action migstart migcancel migpause migresume Volume_ID -eam rotatevols rotateexts -extpool extent_pool_ID " - " . . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -action migstart|migcancel|migpause|migresume (Required) Specifies that one of the following actions is to be performed: migstart Initiates volume migration on the specified volumes that are in the "normal" or "cancelled" state. Volumes are placed into the migrating state. Volumes that are in the cancelled state must have the original source or the destination extent pool as the value of the extpool parameter. migcancel Cancels volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migration are put in the "normal" state, and volumes that are in the middle of migration are put in the "cancelled" state. migpause Pauses volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migration or that are in the middle of migration are put in the "paused" state. migresume Resumes volume migration on the specified volumes that are in the "paused" state. -eam (Optional) Specifies the extent allocation method as follows: rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on.
236
Note: You can only specify the -eam if -action migstart is also specified. -extpool extent_pool_ID (Optional) Changes the extent pool ID of the volume so that the volume can migrate to the new extent pool. Accepts either a fully qualified extent pool ID including storage image ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Note: When the command returns, the volume migration might still be occurring. It can be available for I/O and copy services during migration. Its configstate can indicate that it is migrating. volume_ID . . . | (Required) Specifies an array of one or more CKD base volume IDs or volume ID ranges to modify. A volume ID range is defined by two volume IDs that are separated by a dash. Multiple volume IDs or volume ID ranges must be separated with a blank space between each ID. Example: 0100-010F 0180-018F 0120 The volume ID format is four hexadecimal characters LLVV that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.
Example
Invoking the manageckdvol command
dscli> manageckdvol -dev IBM.2107-75FA120 -action migstart extpool P2 0100
mkaliasvol
The mkaliasvol command creates System z CKD alias volumes (referred to as parallel access volumes or PAVs) in a storage image.
mkaliasvol -dev storage_image_ID -base volume_ID (volume_ID_range) volume_ID " - "
-order
increment decrement
-qty
quantity
-wait
Parameters
Note: Volumes are automatically assigned to the FICON/ESCON ALL volume group ID 10.
237
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -base volume_ID (volume_ID_range) (Required) Specifies an existing base CKD volume ID or a volume ID range. Note: You cannot use multiple volume IDs separated by commas and multiple ID ranges in combination. This combination is rejected. Use the -base parameter to create one or more CKD alias volumes that are assigned to the specified base CKD volume ID. The LCU ID component for all volume IDs must be identical. The alias volume IDs are assigned consecutively in the order specified by the -order parameter. The following examples show the processing affects of the -order parameter:
dscli> mkaliasvol -base 0000 -order increment -qty 2 0080 creates two alias volumes 0080 and 0081 for base volume 0000. dscli> mkaliasvol -base 0000-003F -order increment -qty 2 0080 creates two alias volumes for each base volume as follows: 0080,0081 for base volume 0000 0082,0083 for base volume 0001 ... 00FE,00FF for base volume 003F
-order increment | decrement (Optional) Specifies the order in which alias volume IDs are assigned. For example:
dscli> mkaliasvol -base 0000-003F -order decrement -qty 2 00FF creates two alias volumes for each base volume as follows: 00FF,00FE for base volume 0000 00FD,00FC for base volume 0001 ... 0081,0080 for base volume 003F
Note: If the -order parameter is not specified the default value is decrement. -qty quantity (Optional) Specifies the number of alias volumes that are assigned to each specified CKD base volume. If you do not specify the -qty parameter, then one alias volume is created for each base volume specified. If you specify the -qty parameter, you have to indicate the number of alias volumes that you want to assign to each specified CKD base volume. Note: The total number of base volumes plus the number of alias volumes must be less than or equal to 256. -wait (Optional) Delays the command response until the volume configuration processes complete. volume_ID (Required) Identifies the starting alias volume ID in a sequence of volume IDs to be created The volume ID format is four hexadecimal characters LLVV that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE
238
LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the mkaliasvol command
dscli> mkaliasvol dev IBM.2107-75FA120 base 0100-010F -order decrement -qty 2 01FF
mkckdvol
The mkckdvol command creates System z count key data (CKD) base or CKD alias volumes in a storage image.
mkckdvol -dev storage_image_ID -extpool extentpool_ID -base volume_ID
-3380
-datatype
-cap
capacity
-captype
cyl mod1
-name
volume_name
-wait
-sam
-eam
rotatevols rotateexts
-perfgrp volume_ID
performance_group_ID
-resgrp
resource_group_ID
. . . " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -extpool extentpool_ID (Optional) Creates the base or alias volumes from data extents that are contained in this extent pool. The extent pool storage type defines the volume storage type. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed with the letter P.
Chapter 4. CLI commands
239
Note: This parameter is ignored if the -base parameter is specified. -base volume_ID (Optional) Specifies an existing base CKD volume ID. The volume ID format is four hexadecimal characters LLVV, that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF Use the -base parameter to create one or more CKD alias volumes that are assigned to the specified base CKD volume ID. The LCU ID component for all volume IDs must be identical. Note: Ensure that you use the mkaliasvol command rather than mkckdvol command to create alias volumes. -3380 (Optional) This parameter is equivalent to the -datatype 3380 parameter and it is recommended that you use the -datatype parameter if you need to specify the data type. -datatype 3380|3390|3390-A (Optional) Specifies the volume data type. For Extended Addressing Volumes (EAV), which have a capacity greater than 65520 cylinders, the data type 3390-A must be specified. You can also specify the data type 3390-A for volumes smaller than 65520 cylinders. If neither the -datatype nor the -3380 parameters are specified, then the default data type is 3390-A for capacities greater than 65520 cylinders, and 3390 for smaller capacities. Notes: 1. You can specify the data type 3390A for DS8000 models only. 2. You must ensure that the volume data type is compatible with the host systems that access this volume. 3. The -datatype parameter is ignored when the -base parameter is specified. 4. You cannot use the -datatype parameter and the -3380 parameter in the same command. -cap capacity (Optional) Specifies the quantity of CKD cylinders that are allocated to this volume. The capacity can also be specified in mod1 units using the -captype parameter. For 3380 volumes, the -cap parameter value can be 2226 (1.59 GiB) or 3339 (2.37 GiB). For 3390 volumes, the -cap parameter value can be in the range of 1 to 65,520 (849KB to 55.68 GiB). For 3390A volumes (DS8000 only), the -cap parameter value can be in the range of 1 to 65,520 (increments of 1) or 65,667 1,182,006 (increments of 1113). Note: This parameter is ignored if the -base parameter is specified, and this parameter is required if the -base parameter is not specified. -captype cyl | mod1 (Optional) Specifies the unit type of the capacity given by using the -cap parameter. The default is cyl. A mod1 unit is equivalent to 1113 cylinders, and 1263.28 cylinders is equivalent to 1 GiB.
240
-name volume_name (Optional) Specifies your nickname for the CKD base volumes that are created by this command. Your volume name cannot exceed 16 characters. It can contain one of the following wild cards: v (#d) insert volume ID (decimal) v (#h) insert volume ID (hexadecimal) Note: The -name parameter is ignored when the -base parameter is specified. -wait (Optional) Specifies that the command response be delayed until the volume configuration processes complete. -sam standard | tse | ese (Optional - DS8000 only) Specifies the storage allocation method as follows: standard Designates that the system fully allocate the volume with real extents at volume creation time. This value is the default. tse Designates that a track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. Note: To use this subparameter, you must have previously created space-efficient storage (using the mksestg command) for the extentpool. ese Designates that an extent space efficient (ESE) logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. ESE volumes are used for IBM System Storage DS8000 Thin Provisioning. Note: To use this subparameter, you must have previously created space-efficient storage (using the mksestg command) for the extentpool. -eam rotatevols | rotateexts (Optional - DS8000 only) Specifies the extent allocation method as follows: rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. -perfgrp performance_group_ID (Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0. -resgrp resource_group_ID (Optional) Specifies the resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. The default is RG0. volume_ID . . . | (Required) Specifies an array of one or more CKD base or alias volume IDs or volume ID ranges to be created. The volume IDs must share a common logical control unit ID. Note: Volumes are automatically assigned to the FICON/ESCON ALL volume group ID 10.
Chapter 4. CLI commands
241
The volume ID format is four hexadecimal characters LLVV, that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF A volume ID range is defined by two volume IDs that are separated by a dash. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. Note: Multiple volumes can be created with a single request, but all volumes must have the same capacity, extent pool, and data type. Example: 0100-010F 0180-018F 0120 If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.
Example
Invoking the mkckdvol command
dscli> mkckdvol -dev IBM.2107-75FA120 -extpool P1 -name my_volume_#d -cap 3339 -perfgrp PG17 -sam ese 0100 0101 0102 0103
rmckdvol
The rmckdvol command deletes count key data (CKD) base or alias volumes from a storage image.
rmckdvol -dev storage_image_ID -quiet -force " - " volume_ID . . .
Parameters
A specific use of this command is made when you are confronted with a volume or volumes that are in a configuration state of "configuration error." To correct this configuration state, issue the rmckdvol command for each affected volume. You can specify a volume range according to the command specifications when it is appropriate. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all logical volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the volume removal confirmation prompt for this command.
242
-force (Optional) Attempts to delete the volumes without checking to see whether or not the volumes are in use. If multiple volumes are specified and some are in use and some are not, the ones not in use will be deleted. volume_ID . . . | (Required) An array of one or more CKD base or CKD alias volume IDs or volume ID ranges to be removed. Accepts a fully qualified volume ID, which includes the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. The shortened volume ID format is four hexadecimal characters LLVV, that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF that is contained by a logical control unit (logical subsystem). Note: A CKD base volume cannot be removed if an alias volume is associated with it. A volume ID range is defined by two volume IDs that are separated by a dash. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. For DS8000, example: 0100-010F 0180-FEFF 0120 If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmckdvol command
dscli> rmckdvol -dev IBM.2107-75FA120 0000 0001
showckdvol
The showckdvol command displays detailed properties of an individual count key data volume. This command can also be used to display the performance metrics for an individual volume ID.
showckdvol -dev storage_image_ID -rank volume_ID " - "
-metrics
-volgrp
volume_group_ID
Parameters
Note: All performance counts are an accumulation from the most recent counter wrap or counter reset. A reset of the volume performance counters occurs in association with the following events: v The storage unit is turned on.
Chapter 4. CLI commands
243
v There has been a server failure, and the server failover or failback sequence has been initiated. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -rank (Optional) Specifies that a rank extents table is to be displayed. This table displays the set of ranks that the logical volume has extents configured on and the number of extents for that logical volume. Note: This parameter cannot be used with the -metrics or -volgrp parameters. -metrics (Optional) Displays the volume ID and performance metrics for the specified volume. Notes: 1. All performance counts are an accumulation since the most recent counter wrap or counter reset. Volume performance counters are reset on a power-up sequence. Volume performance counters are reset by a server failover and failback sequence. 2. Do not use this parameter with the -rank or -volgrp parameters. -volgrp volume_group_ID (Required if you do not specify the volume_ID parameter.) Specifies that the CKD volumes that are associated with the designated volume group ID is to be displayed. There is only one volume group for CKD volumes and it contains all volumes. Notes: v The -volgrp parameter can only be used when you are doing a query for performance metrics. v Do not use the -volgrp parameter with the volume_ID parameter. v Do not use the -volgrp parameter with the -rank or -metrics parameters. volume_ID (Optional) Specifies that you want the system to display detail information about the designated volume. The volume ID format is four hexadecimal characters LLVV that represent the following values: LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for both the DS8000 and DS6000 model) Specifies the volume number, 00 - FF If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode. | Example 1 For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.
244
The following tables represent the headers that are displayed on the output reports that are associated with the showckdvol command using the -rank parameter. When the rank parameter is specified, a rank extents table is also displayed. It appears at the end of the regular report. Invoking the showckdvol to show volume properties Note: The following example is based on the use of the showckdvol command for a 3390 volume with 3339 cylinders. When the rank parameter is specified, a rank extents table is displayed at the end of the regular report.
dscli> showckdvol -dev IBM.2107-1300861 -rank 1410
orgbvols
addrgrp 1
extpool P2
exts 3
Ranks 2
sam TSE
repcapalloc 1.7
eam -
realextents 1
virtualextents 0
migrating 0
migratingfrom -
perfgrp PG0
resgrp RG0
| ============================Rank extents===========================
Rank R0 R2 Extents 1 2
245
Conditions: One of the following occurred: v Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown. v Data was lost that indicated extents on the logical volume were active FlashCopy targets. The access state is Fenced. Rank failed Specifies that one or more extents that are associated with the logical volume are on a rank that is in the failed data state. The access state is Fenced.
246
Rank repairing Specifies that one or more extents that are associated with the logical volume are on ranks that are in the repairing data state. The access state is Fenced. Rank repaired Specifies that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. The access state is Fenced. Global inaccessible Specifies that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data that is associated with the logical volume might be inaccurate. The access state is Fenced. Global lost data Specifies that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data that is associated with the logical volume might be inaccurate. The access state is Fenced. NVS data inaccessible Specifies that active NVS data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. The access state is fenced. Specifies that the logical volume is designated as a CKD alias. Configstate One of the following designations can be displayed: Normal Indicates that there are no logical volume configuration operations in progress, and the volume is not being deconfigured, merged, or migrated. Configuring Indicates that the logical volume is in the process of being configured for the first time. Reconfiguring Indicates that the logical volume is in the process of allocating or deallocating extents due to a modification of the requested capacity attribute after initial creation. Deconfiguring Indicates that the logical volume is in the process of being deleted. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal error condition and not an error in the request to create the volume. If you have a volume in this state, use the rmfbvol command to delete each volume listed with the configuration state of "configuration error". Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool. Migrating Indicates that the volume is in the process of migrating, or waiting to be migrated. Migration Cancelled Indicates that the volume was in the process of migrating and then the migcancel' action of the manageckdvol command was issued, leaving some of the extents waiting to be migrated in the source pool while other extents have already migrated to the target pool. Migration has stopped, and cannot be resumed. If you have a volume in this state, try to migrate it again to the original source or target extent pool.
247
Migration Paused Indicates that the volume was in the process of migrating and then the migpause' action of the manageckdvol command was issued. Migration has stopped, but can be resumed. Migration Error Indicates that the volume migration process failed to complete successfully. This state reflects an internal error condition and not an error in the user's request to migrate a volume. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Deconfiguration error Indicates that a request to delete a volume did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmfbvol command for the designated volume. Transposition Error Indicates that the volume is in an extent pool that was unsuccessfully merged. This state reflects an internal error condition. Corrective action: Use the chextpool command with the -merge parameter again to redrive the merge extent pool and to correct this state. deviceMTM One of the following can be displayed: v 3380-2 v 3380-3 v 3390-3 v 3390-9 Volser Specifies the volume serial number. A volume serial number is 6 bytes of data, displayed as six characters. Datatype Specifies the volume data type setting (3380 or 3390). Voltype Specifies that the logical volume is one of the following types: v CKD base v CKD alias Orgbvols (original base vol) One of the following can be specified: v Identifies the original base CKD volume ID to which this CKD alias volume is assigned. Note: For a CKD Alias type volume, the base and alias volume IDs share a common LCU ID. v " - " is displayed for a CKD base volume type. Addrgrp Specifies the address group that contains this volume object. An address group ID is one hexadecimal character (0 - F). Extpool Specifies the extent pool ID. Note: Volumes that belong to an encrypted extent pool are encrypted. You can see the encryption group of an extent pool by using the lsextpool -l, or showextpool commands. Exts Specifies the number of real and virtual extents used by the designated volume ID.
248
Cap (cyl) Specifies the quantity of volume cylinders that are available for host system access. | | Cap (2^30B) Specifies the size of volume that is available for host system access in gibibytes (GiB). Cap (10^9B) Specifies the size of volume that is available for host system access in decimal gigabyte (GB) units. Ranks Specifies the number of ranks the volume resides on. SAM Specifies the storage allocation method. The following values are displayed: | | | | | | | | | | | | | | | | | standard Designates that the system fully allocated the volume with real extents at volume creation time. An inquiry on a DS6000 model always reports this value. tse Designates that a track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. Physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. ese Designates that an extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. Repcapalloc Specifies the allocated physical repository capacity of the track space-efficient storage. This value is calculated on the available repository capacity as a result of writes to the track space-efficient volume. This value is displayed in the format of X.Y, where X is in whole gibibytes (1 GiB = 2^30 B) and Y represents tenths of a GiB, which is limited to a single digit (0 - 9). Note: 1. A " - " value is displayed in this column if the value displayed in the SAM column is Standard or ESE. 2. A " - " value is displayed for the DS6000. EAM Specifies the extent allocation method that is used if the volume is migrated or expanded. One of the following values is displayed: | | | | | | | | | | | | | legacy Specifies that the volume was created before the use of the current algorithm. Legacy is always the reported value for a DS6000 model. rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. managed Specifies that the extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage.
Chapter 4. CLI commands
249
| | |
" " A " - " value is displayed if the extent allocation method does not apply, for example, track space-efficient logical volumes. Reqcap (cyl) Specifies the requested quantity of volume CKD cylinders (for example, 3339). Note: A value of 0 is displayed for the DS6000. cap (Mod1) Specifies the quantity of Mod1 units (Mod1 = 1113 cylinders). realextents Specifies the number of real extents used by the logical volume. virtualextents Specifies the number of virtual extents used by the logical volume. migrating The number of extents for this volume that are currently being migrated. migratingfrom A list of one or more extent pool IDs where the extents are migrating from. If there are no migrating extents, a dash "-" is displayed. Unknown is displayed if information about the extent pool IDs is not available. perfgrp Specifies the performance group ID that the volume is assigned to. The performance group ID begins with the letters PG and ends with a decimal number. resgrp Specifies the resource group ID that the volume is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
250
seqwritehits 10000
cachfwrreqs 10000
cachfwrhits 10000
cachfwreqs 10000
cachfwhits 10000
inbcachload 10000
bypasscach 10000
DASDtrans 10000
cachetrans 10000
NVSspadel 10000
seqwriteops 10000
qwriteprots 10000
CKDirtrkac 10000
cachspdelay 10000
timelowifact 10000
phread 10000
phwrite 10000
phwrite 10000
phbyteread 10000
phbytewrit 10000
recmoreads 10000
contamwrts 10000
PPRCtrks 10000
NVSspallo 10000
timephread 10000
timephwrite 10000
byteread 10000
bytewrit 10000
timeread 10000
timewrite 10000
zHPFRead -
zHPFWrite -
zHPFPrefetchReq 0
zHPFPrefetchHit 0
GMCollisionsSidefileCount 0
GMCollisionsSendSyncCount 0
251
normwritereq Specifies Write Normal I/O Requests normwritehits Specifies DASD Fast Write I/O Request Hits seqreadreqs Specifies Search/Read Sequential I/O Requests seqreadhits Specifies Search/Read Sequential I/O Request Hits seqwritereq Specifies Write Sequential I/O Requests seqwritehits Specifies DASD Fast Write Sequential I/O Request Hits cachfwrreqs Specifies Search/Read Cache Fast Write I/O Requests cachfwrhits Specifies Search/Read Cache Fast Write I/O Request Hits cachfwreqs Specifies Cache Fast Write I/O Requests cachfwhits Specifies Cache Fast Write I/O Requests Hits inbcachload Specifies Inhibit Cache Loading I/O Requests that operate with DASD bypasscach Specifies Bypass Cache I/O Requests seqDASDtrans Specifies Sequential DASD to Cache Transfer Operations DASDtrans Specifies DASD to Cache Transfer Operation Count cachetrans Specifies Cache to DASD Transfer Operation Count NVSspadel Specifies DASD Fast Write Operations Delayed Due to nonvolatile storage Space Constraints normwriteops Specifies Normal DASD Fast Write' Write Operation Counts seqwriteops Specifies Sequential Access DASD Fast Write' Write Operation Counts reccachemis Specifies Number of record cache Read Misses qwriteprots Specifies Quick Write Promotes CKDirtrkac Specifies Irregular Track Accesses CKDirtrkhits Specifies Irregular Track Accesses Hits
252
cachspdelay Specifies Operations Delayed Due To Cache Space Constraints timelowifact Specifies Milliseconds of lower interface I/O activity for the indicated device. phread Specifies Physical Storage Read Operations phwrite Specifies Physical Storage Write Operations phbyteread Specifies Physical Storage Bytes Read in 128 KB increments. phbytewrit Specifies Physical Storage Bytes Written in 128 KB increments. recmoreads Specifies Record Mode Read Operations sfiletrkreads Specifies the Number of tracks read from the Concurrent Copy or XRC Sidefile. contamwrts Specifies the Number of Contaminating writes for a Concurrent Copy or XRC volume PPRCtrks Specifies the Number of tracks or portion of tracks that were transferred to the secondary device of a PPRC pair. NVSspallo Specifies the NVS Space Allocations timephread Specifies the physical storage read response time in 16 ms increments. timephwrite Specifies the physical storage write response time in 16 ms increments. byteread Specifies the number of bytes that are read in 128 KB increments bytewrit Specifies the number of bytes that are written in 128 KB increments. timeread Specifies the accumulated response time for all read operations. timewrite Specifies the accumulated response time for all write operations. zHPFRead Specifies the High Performance FICON (HPF) Read I/O Requests for volume performance statistics. zHPFWrite Specifies the HPF Write I/O Requests for volume performance statistics. zHPFPrefetchReq Specifies the number of HPF Pre-fetch I/O requests. zHPFPrefetchHit Specifies the number of HPF Pre-fetch I/O request hits. GMCollisionsSidefileCount Specifies the number of Global Mirror Collisions sidefile.
Chapter 4. CLI commands
253
GMCollisionsSendSyncCount Specifies the number of Global Mirror Collisions Send Synchronous Count.
chlss
The chlss command modifies a logical subsystem.
chlss -dev storage_image_ID -ss ss_ID -pprcconsistgrp enable disable
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all logical subsystems, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -ss ss_ID (Optional). Specifies the subsystem ID of the logical subsystem. The subsystem ID that you specify replaces the existing subsystem ID in the initial target LSS ID. The ID is in the format 0001 - FFFF. Example: 013F -pprcconsistgrp enable | disable (Optional) Enables a volume that is associated with a logical subsystem to become suspended and enter an extended long busy state if it has not received a notification that a consistency group has been created. Otherwise, the volumes associated with the LSS do not go to a long-busy state. -extlongbusy timeout (Optional) Specifies the time in seconds that an LSS consistency group volume stays long busy after reporting an error that causes a remote mirror and copy suspension if a consistency group has not been created. The default value for new LSSs is 60 seconds (1 minute). -resgrp resource_group_ID (Optional) Specifies the resource group that the LSSs are assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
254
LSS_ID . . . | (Required) Specifies one or more LSSs to be modified by this command. An LSS ID is two hexadecimal characters 00 - FE for the DS8000 and it is 00 - 1F for the DS6000. To specify a range of LSS IDs, separate the IDs with a hyphen. You must separate multiple LSS IDs or ranges of LSS IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example: 00-03 08
Example
Invoking the chlss command
dscli> chlss -dev IBM.2017-75FA120 -extlongbusy 120 06 0F
lslss
The lslss command displays a list of logical subsystems (LSSs) for a storage image and status information for each logical subsystem in the list.
lslss -dev storage_image_ID -s -l -addrgrp address_group
-resgrp
resource_group_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Displays LSS IDs. You cannot use the -l and the -s parameters together. -l | | (Optional) Displays the default output plus the SSID and resource group ID. You cannot use the -l and the -s parameters together. -addrgrp address_group (Optional) Displays only LSSs that belong to the specified address group. An address group is a single hexadecimal character (0 - F). -resgrp resource_group_ID (Optional) Displays only the LSSs that are assigned to the specified resource group ID. The resource group ID begins with the letters RG and ends with a decimal number.
255
LSS_ID . . . | (Optional) Specifies the logical subsystem IDs. An LSS ID is two hexadecimal characters 00 - FE for the DS8000 and 00 - 1F for the DS6000. To specify a range of logical subsystem IDs, separate the logical subsystem IDs with a hyphen. You must separate multiple logical subsystem IDs or ranges of logical subsystem IDs with a blank space between each ID or range of IDs. Example: 00-03 08 If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lslss command using the -l parameter. Invoking the lslss command
dscli> lslss -dev IBM.1750-75FA120 -l
fb
256
FF11
RG0
fb
256
FF12
RG0
256
Subsys+ Specifies the user assigned, or default SSID value. resgrp+ Specifies the resource group ID that the LSS is assigned to. The resource group ID begins with the letters RG and ends with a decimal number. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
showlss
The showlss command displays detailed properties of a logical subsystem (LSS).
showlss -dev storage_image_ID LSS_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. LSS_ID | (Required) Displays the properties for the specified logical subsystem. This parameter accepts a fully qualified LSS ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is two hexadecimal digits in the range 00 - FE for the DS8000 and 00 - 1F for the DS6000. The following is an example of a fully qualified LSS ID: IBM.2107-75FA120/10 The following is an example of a shortened version of the LSS ID when the -dev parameter is specified:
dscli> showlss -dev IBM.2107-75FA120 10
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the showlss command. Invoking the showlss command to show default information
dscli> showlss IBM.2107-75FA120/10
257
ID IBM.210775FA120 /10
Group 0
Addrgrp 1
Stgtype fb
Confgvols 256
Subsys FF10
Pprcconsistgrp Disabled
Xtndlbztimout 60 secs
resgrp RG0
Group Specifies the server that manages the logical subsystem. The displayed values are 0 or 1. Addrgrp Specifies the address group object that the logical subsystem is a member of. Stgtype Specifies the type of storage volumes contained by this logical subsystem. The value displayed is fb (fixed block) or ckd (count key data) Confgvols Specifies the number of volumes that are assigned to this logical subsystem. Subsys Specifies the user assigned, or default SSID value. Pprcconsistgrp Specifies the assigned PPRC consistency group state setting. If you do not designate enabled, the default value of disabled is assigned. Xtndlbztimout Specifies the assigned extended long busy timeout value. LSSs are created with an extended long busy timeout value of 60 seconds. resgrp Specifies the resource group ID that the LSS is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
258
mkfbvol Creates open systems fixed block volumes in a storage unit. rmfbvol Deletes one or more specified fixed block volumes from a storage unit. showfbvol Generates two types of reports. The first report displays the detailed properties for a specified fixed block volume. The second report displays the performance metrics for a specified fixed block volume.
chfbvol
The chfbvol command is used to change the name or capacity of a fixed block volume.
chfbvol -dev storage_image_ID -os400 protected unprotected A01 A81 A02 A82 A04 A84 A05 A85 A06 A86 A07 A87
-name
new_volume_name
-type
ess ds blocks
-cap
new_capacity
-quiet
-perfgrp volume_ID
performance_group_ID
-resgrp
resource_group_ID
. . . " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -os400 protected | unprotected | A01 | A81 | A02 | A82 | A04 | A84 | A05 | A85 | A06 | A86 | A07 | A87 (Optional - DS8000 only) Specifies options for the OS 400 volume data types and indicates the type of modifications that can be performed. Check your operating system documentation to ensure that volume expansion is supported before you proceed with the expansion: Volume data type is os400 protected (FB 520P) You can change the volume data type to os400 unprotected (FB 520U)
Chapter 4. CLI commands
259
Volume data type is os400 unprotected (FB 520U) You can change the volume data type to os400 protected (FB 520P) Volume data type is 512 You cannot change the volume data type.
Current Volume A01 protected A81 unprotected A02 protected A82 unprotected A05 protected A85 unprotected A04 protected A84 unprotected A06 protected A86 unprotected A07 protected A87 unprotected Volume Size 8.59 GB 8.59 GB 17.55 GB 17.55 GB 35.17 GB 35.17 GB 70.56 GB 70.56 GB 141.12 GB 141.12 GB 282.35 GB 282.35 GB Change to Volume A81 unprotected A01 protected A82 unprotected A02 protected A85 unprotected A05 protected A84 unprotected A04 protected A86 unprotected A06 protected A87 unprotected A07 protected Volume Size 8.59 GB 8.59 GB 17.55 GB 17.55 GB 35.17 GB 35.17 GB 70.56 GB 70.56 GB 141.12 GB 141.12 GB 282.35 GB 282.35 GB
Notes: 1. If the volume is unassigned to any System i model or nonconfigured volume, you can use this parameter to change the designated protection value. 2. If the volume is assigned and is a part of the i5/OS configuration, you cannot use this parameter to change the protection value. The only way to change the protection value on a volume that is part of the i5/OS configuration is to perform the following steps with extreme caution: a. Remove the volume from the i5/OS application. This step must be done first. b. Remove the volume from the DS system c. Create a volume and assign the correct protection value. 3. You cannot use the -os400 parameter with the -cap or the -type parameters. -name new_volume_name (Optional) Specifies the nickname for this volume. A nickname cannot exceed 16 characters. -type ess | ds | blocks (Optional - DS8000 only) Specifies the unit type of capacity that is specified by the -cap parameter. ess ds Specifies that the unit is 10^9 bytes. Specifies that the unit is 2^30 bytes.
blocks Specifies that the unit is 512 blocks. Notes: 1. If the -type parameter is not specified, the LUN is created as type ds. 2. The -type parameter is ignored when the -os400 parameter is specified. -cap new_capacity (Optional - DS8000 only) Specifies the storage size that you want to allocate to the specified volume. Check your operating system documentation to ensure that volume expansion is supported before you proceed with the expansion.
260
Notes: 1. If you attempt to reduce the volume size, the command fails. 2. You cannot use the -cap parameter with the -os400 parameter. If the -type parameter is omitted or the -type ds parameter is specified: v 1 gibibyte (GiB) = 1,073,741,824 (2^30 bytes) v Supported storage sizes range from 1 to 2048. If the -type ess parameter is specified: v capacity = X.Y or X where X is whole decimal gigabytes, with 1 GB = 1,000,000,000 (10^9 bytes). where Y represents a fraction of 1 GB. Y is limited to a single digit (0-9) to the right of the decimal. v Supported storage sizes range from 0.1 - 982.2 (0.1 increment). If the -type blocks parameter is specified, new_capacity is the number of 512 blocks. Supported storage sizes are from 1 to 4294967296 (2048 x 2^30 bytes). -quiet (Optional - DS8000 only) Turns off the confirmation prompt for this command. -perfgrp performance_group_ID (Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0. -resgrp resource_group_ID (Optional) Specifies the resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. volume_ID . . . | (Required) Specifies one or more volume IDs to be modified. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ where: X XY XY ZZ Specifies the address group, 0 - 1. This parameter is not available for DS6000 models. Specifies the logical subsystem number, 00 - FE. This parameter is only available for DS6000 models. Specifies the logical subsystem number, 00 - 1E. Specifies the volume number, 00 - FF.
You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. To specify a range of volume IDs, separate the volume IDs with a hyphen. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. Example: 0100-010F 0180-018F 0120 If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive command mode.
Example
Invoking the chfbvol command
dscli> chfbvol -dev IBM.2107-75FA120 -os400 protected 0100 0101
261
initfbvol
The initfbvol command initializes a logical volume and releases extents from a space-efficient logical volume. For space efficient logical volumes, this command is used to release space. For TSE volumes, it releases tracks in the repository, reducing the repository allocated space. For ESE volumes, it releases extents in the extent pool being used, reducing the allocated extents. For example, if a space-efficient logical volume has data that is stored on it that is no longer needed, use the initfbvol command to free the extents/tracks that were assigned to this logical volume. This allows the extents/tracks to be reused by other space-efficient logical volumes. This command is not supported on DS6000 models.
initfbvol -dev volume_ID . . . " - " storage_image_ID -action releasespace -quiet
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -action releasespace (Optional) Specifies that you want the system to release the repository space held by the designated space-efficient volume back to the repository. (The repository is the physical extents that provision the virtual extents for virtual space volumes.) The -action releasespace command cannot be used on a standard volume. -quiet (Optional) Turns off the modification confirmation prompt for the -action parameter. volume_ID -| . . . (Required) Specifies the volume ID that you want the system to release the repository space from. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of LLVV, where: LL VV Specifies the logical control unit number, 00 - FE. Specifies the volume number, 00 - FF.
You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. To specify a range of volume IDs, separate the volume IDs with a dash. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs.
262
If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive command mode.
Example
Invoking the initfbvol command
dscli> initfbvol -dev IBM.2107-75FA120 action releasespace 0101
lsfbvol
The lsfbvol command displays a list of fixed block volumes in a storage image and status information for each volume in the list. |
lsfbvol -dev storage_image_ID -s -l -datatype 512 512t 520p 520u
-extpool
extentpool_ID
-access
online fenced
-data
normal not_normal
-config
normal not_normal
-lss
LSS_ID
-volgrp
volume_group_ID
-sam
-eam
-perfgrp
performance_group_ID
-resgrp
resource_group_ID
Parameters
Note: For a storage unit that is heavily configured, it is recommended that you specify the -lss or the -volgrp parameter as part of your command. -dev storage_image_ID (Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Displays only the volume IDs. You cannot use the -l and the -s parameters together.
Chapter 4. CLI commands
263
-l | | (Optional) Displays default output plus additional attributes that are identified as long output in the Report field definitions list. You cannot use the -l and the -s parameters together.
| -datatype 512 | 512t | 520p | 520u (Optional) Displays volumes of the specified volume data type. Standard 2107/1750 volume (512), T10-DIF algorithm protection (512t), System i protected (520p), System i unprotected (520u). | -extpool extentpool_ID (Optional) Displays volumes that are sourced from the specified extent pool. An extent pool ID is a four-digit decimal number with no leading zeroes, prefixed with the letter P. -access online | fenced (Optional) Displays volumes with the specified access state. -data normal | not_normal (Optional) Displays volumes with the specified data state. -config normal | not_normal (Optional) Displays volumes with the specified configuration. -lss LSS_ID (Optional) Displays volumes with IDs that contain the specified logical subsystem ID. Each logical subsystem can contain up to 256 volumes. A logical subsystem ID is two hexadecimal characters 00 FE for the DS8000 and 00 - 1F for the DS6000. -volgrp volume_group_ID (Optional) Displays volumes that are assigned to the specified volume group ID. A volume group ID is a four-digit decimal number, with no leading zeros, prefixed by the letter V. For example, V123. -sam standard | tse | ese (Optional - DS8000 only) Specifies the storage allocation method as follows: standard Specifies that you want the system to fully allocate the volume with real extents when it creates the volumes. tse Specifies that you want the system to create track space-efficient volumes. After creation, these space-efficient volumes contain a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. Specifies that an extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool.
ese
-eam legacy | rotatevols | rotateexts | managed (Optional - DS8000 only) Specifies that you want the system to display only volumes that meet the criteria of the designated extent allocation method as follows: legacy Specifies that the volumes that were created before the current algorithms were implemented. rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on.
264
managed Specifies that the extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage. -perfgrp performance_group_ID (Optional) Displays only the volumes that belong to the specified performance group. The performance group ID begins with the letters PG. -resgrp resource_group_ID (Optional) Displays only the volumes that are assigned to the specified resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. volume_ID . . . | (Optional) Displays volumes with the specified IDs. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1, for DS6000 and 0F for DS8000. To specify a range of volume IDs, separate the volume IDs with a hyphen. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example: 0100-010F 0180-018F 0120
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsfbvol command using the -l parameter. Invoking the lsfbvol command
dscli> lsfbvol -dev IBM.2107-75FA120 -l -volgrp V2
0102
Online
Normal
Normal
2107-A07
FB 520P
265
ID 0103
accstate Online
datastate Normal
Volgrp V2 V2 -
266
v v v v v
Rank failed Rank repairing Rank repaired Global inaccessible Global lost data
Conditions - one of the following occurred: v Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown. v Data has been lost that indicates that extents on the logical volume were active FlashCopy targets. The access state is fenced. Rank failed Indicates that one or more extents that are associated with the logical volume are on a rank that is in the Failed data state. The access state is Fenced. This data state transitions to the Rank repairing state if the rank transitions to the Rank repairing state through use of the repair array function. Rank Repairing Indicates that one or more extents that are associated with the logical volume are on ranks in the repairing data state. The access state is fenced. Rank Repaired Indicates that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. The access state is fenced. Global inaccessible Specifies that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data associated with the logical volume might be inaccurate. The access state is fenced. Global lost data Specifies that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data associated with the logical volume might be inaccurate. The access state is fenced. NVS data inaccessible Specifies that active NVS data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. The access state is fenced. Configstate One of the following configuration states are displayed: Normal Indicates that there are no logical volume configuration operations in progress, and the volume is not being deconfigured, merged, or migrated. Configuring Indicates that the logical volume is in the process of being configured for the first time. Reconfiguring Indicates that the logical volume is in the process of allocating or deallocating extents due to a modification of the requested capacity attribute after initial creation. Deconfiguring Indicates that the logical volume is in the process of being deleted. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal
Chapter 4. CLI commands
267
error condition and not an error in the request to create the volume. If you have a volume in this state, use the rmfbvol command to delete each volume listed with the configuration state of "configuration error". Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool. Migrating Indicates that the volume is in the process of migrating, or waiting to be migrated. Migration Cancelled Indicates that the volume was in the process of migrating and then the migcancel' action of the manageckdvol command was issued, leaving some of the extents waiting to be migrated in the source pool while other extents have already migrated to the target pool. Migration has stopped, and cannot be resumed. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Migration Paused Indicates that the volume was in the process of migrating and then the migpause' action of the manageckdvol command was issued. Migration has stopped, but can be resumed. Migration Error Indicates that the volume migration process failed to complete successfully. This state reflects an internal error condition and not an error in the request of the user to migrate a volume. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Deconfiguration error Indicates that a request to delete a volume did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmfbvol command for the designated volume. Transposition Error Indicates that the volume is in an extent pool that was unsuccessfully merged. This state reflects an internal error condition. Corrective action: Use the chextpool command with the -merge parameter again to redrive the merge extent pool and to correct this state. deviceMTM Indicates the volume device type and model. The volume MTM (machine type, model) is determined by the fixed block volume data type and the volume capacity (in GB). The machine type is either 2107 or 1750; however, the MTM can be any one of the following depending on your system: 2107-900 Indicates a standard 2107 volume. 1750-500 Indicates a standard 1750 volume. xxxx-A0x Indicates that the xxxx is a 2107 or 1750. The A0 indicates a System i protected volume (for example, 2107-A01 or 1750-A07). xxxx-A8x Indicates that the xxxx is 2107 or 1750. The A8 indicates a System i unprotected volume (for example, 2107-A81 or 1750-A87). Datatype Indicates the volume data type setting. One of the following values will be displayed: v FB 512
268
v FB 512T v FB 520P v FB 520U Extpool Identifies the extent pool ID. Volume extents are allocated from this extent pool ID. Note: Volumes that belong to an encrypted extent pool are encrypted. You can see the encryption group of an extent pool by using the lsextpool -l, or showextpool commands. SAM Specifies the storage allocation method. The following values are displayed: standard Indicates that the system fully allocated the volume with real extents at volume creation time. An inquiry on a DS6000 model always reports a value of standard. tse Indicates that a track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. Physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. ese Indicates that an extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. Captype Indicates the capacity unit type that is used at volume creation. One of the following values is displayed: ESS
| | |
The capacity unit is decimal gigabytes (GB). DS The capacity unit is gibibytes (GiB). DS/ESS The capacity unit is gibibytes (GiB) or decimal gigabytes (GB). Blocks The capacity unit is 512B. iSeries The capacity unit was not specified at volume creation. This fixed block volume was created only for iSeries.
| | | | |
Cap (2^30B) Specifies the size of the volume that is available for host system access in gibibytes (GiB). Note: " " is displayed if the capacity unit type of the volume is ESS (captype=ESS) Cap (10^9B) Specifies the size of the volume that is available for host system access in decimal gigabyte (GB) units. Note: " " is displayed if the capacity unit type of the volume is DS (captype=DS) Cap (blocks) Indicates the quantity of volume logical blocks that are available for host system access.
269
Volgrp Specifies the volume groups (excluding default volume groups) that a volume belongs to. Multiple volume groups that are associated with the volume are separated by a comma. A " " is displayed if there are no volume groups that are associated with the volume. Unknown is displayed if information about the volume groups is not available. EAM Specifies the extent allocation method that will be used if the volume is migrated or expanded. legacy Specifies that the volume was created before the use of the current algorithm. Legacy is always the reported value for a DS6000 model. rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. managed Specifies that the extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage. " " A dash " - " value is displayed if the extent allocation method does not apply , for example if the volume is a track space efficient (TSE) volume. Reqcap (blocks) Specifies the requested quantity of volume logical blocks (for example, 3339). Note: A value of 0 is displayed for the DS6000. perfgrp Specifies the performance group ID that the volume is assigned to. The performance group ID begins with the letters PG and ends with a decimal number. resgrp Specifies the resource group ID that the volume is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
managefbvol
The managefbvol command initiates a change on fixed block (FB) volumes by executing a process. This command is not supported on DS6000 models.
managefbvol -dev storage_image_ID -action migstart migcancel migpause migresume Volume_ID -eam rotatevols rotateexts -extpool extent_pool_ID " - " . . .
270
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -action migstart|migcancel|migpause|migresume (Required) Specifies that one of the following actions are to be performed: migstart Initiates volume migration on the specified volumes that are in the "normal" or "cancelled" state. Volumes are placed into the migrating state. Volumes that are in the cancelled state must have the original source or the destination extent pool as the value of the extpool parameter. migcancel Cancels volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migration are put in the "normal" state, and volumes that are in the middle of migration are put in the "cancelled" state. migpause Pauses volume migration on the specified volumes that are in the migrating state. Volumes that have not yet started migration or that are in the middle of migration are put in the "paused" state. migresume Resumes volume migration on the specified volumes that are in the "paused" state. -eam (Optional) Specifies the extent allocation method as follows: rotateexts Designates that extents that are allocated to a logical volume are successively rotated through the ranks within an extent pool. rotatevols Designates that each successive logical volume that is created is allocated on the next available rank in the extent pool. This parameter is the default value. Note: You can specify the -eam parameter only if -action migstart is also specified. -extpool extent_pool_ID (Optional) Changes the extent pool ID of the volume so the volume migrates to the new extent pool. Accepts either a fully qualified extent pool ID including storage image ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter P. Note: When the command returns, the volume migration might still be occurring. It is available for I/O and copy services during migration. Its configstate indicates that it is migrating. volume_ID . . . | (Required) Specifies an array of one or more CKD base volume IDs or volume ID ranges to modify. A volume ID range is defined by two volume IDs that are separated by a dash. Multiple volume IDs or volume ID ranges must be separated with a blank space between each ID. Example: 0100-010F 0180-018F 0120 The volume ID format is four hexadecimal characters LLVV that represent the following values:
271
LL (for a DS8000 model) Specifies the logical control unit number, 00 - FE LL (for a DS6000 model) Specifies the logical control unit number, 00 - 1F VV (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF You must fully qualify the volume ID with manufacturer, machine type, and serial number if you do not use the -dev parameter. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) if you are in the DS CLI interactive mode.
Example
Invoking the managefbvol command
dscli> managefbvol -dev IBM.2107-75FA120 -action migstart extpool P2 0100
mkfbvol
The mkfbvol command creates open systems fixed block (FB) volumes in a storage image.
mkfbvol -dev storage_image_ID -extpool extentpool_ID -os400 A01 A81 A02 A82 A04 A84 A05 A85 A06 A86 A07 A87
-type
ess ds blocks
-cap
capacity
-name
volume_name
-volgrp
volume_group_ID
-wait
-sam
-eam
rotatevols rotateexts
-perfgrp volume_ID
performance_group_ID
-resgrp
resource_group_ID
-t10dif
. . . " - "
272
Parameters
Notes: 1. You can create multiple volumes with one command; however, all volumes must have the same capacity, extent pool, and data type. 2. If host attachment volume groups have not yet been created, create temporary volume groups and assign new fixed block volumes to the temporary volume groups according to the volume type and capacity characteristics. 3. To use the -sam tse parameter you must have previously created space-efficient storage (using the mksestg command) for the extent pool. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes a value for the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -extpool extentpool_ID (Required) Creates the base or alias volumes from data extents that are contained in this extent pool. The extent pool storage type defines the volume storage type. An extent pool ID is a four-digit decimal number with no leading zeros, prefixed with the letter P. -os400 A01 | A81 | A02 | A82 | A04 | A84 | A05 | A85 | A06 | A86 | A07 | A87 (Optional) The OS 400 volume options. If this parameter is not specified, the default standard 2107/1750 volume is created. This parameter is required if capacity is not specified. The storage sizes and the data types for this volume: v A01 - 8.6 GB, protected v A81 - 8.6 GB, unprotected v A02 - 17.5 GB, protected v A82 - 17.5 GB, unprotected v A04 - 70.5 GB, protected v A84 - 70.5 GB, unprotected v v v v A05 A85 A06 A86 35.1 GB, protected 35.1 GB, unprotected 141.12 GB, protected 141.12 GB, unprotected
v A07 - 282.25 GB, protected v A87 - 282.25 GB, unprotected | Decimal gigabyte (GB) is 10^9 bytes. Note: You must ensure that the volume data type is compatible with the host systems that can access this volume. -type ess | ds | blocks (Optional) Specifies the unit type of capacity that is specified by the -cap parameter. | | ess ds Specifies that the unit is decimal gigabytes (GB) 10^9 bytes. Specifies that the unit is gibibytes (GiB) 2^30 bytes.
273
Notes: 1. If the -type parameter is not specified, the lun is created as type ds. 2. The -type parameter is ignored when the -os400 parameter is specified. -cap capacity (Optional) Specifies the storage size that is allocated to this volume object. Note: This parameter is required if the -os400 parameter is not specified. | If the -type parameter is omitted or the -type ds parameter is specified: v 1 gibibyte (GiB) = 1,073,741,824 (2^30 bytes) v Supported storage sizes range from 1 to 2048. If the -type ess parameter is specified: v capacity = X.Y or X where X is whole decimal gigabytes, with 1 GB = 1,000,000,000 (10^9 bytes). where Y represents a fraction of 1 decimal gigabyte (GB). Y is limited to a single digit (0-9) to the right of the decimal. v Supported storage sizes range from 0.1 - 982.2 (0.1 increment). If the -type blocks parameter is specified, capacity is the number of 512 blocks. Supported storage sizes are from 1 to 4294967296 (2048 x 2^30 bytes). -name volume_name (Optional) Your nickname for this volume. The nickname can be 16 characters long, and it can contain one of the following wildcard characters: v #d decimal volume ID v #h hexadecimal volume ID -volgrp volume_group_ID (Optional) Specifies to which volume group the volumes are assigned. A volume group ID is a four-digit decimal number with no leading zeros, prefixed with the letter V. -wait (Optional) Delays the command response until the volume configuration processes complete. Note: If you specify this parameter, you must wait until your original command processes completely before you can issue a new command. -sam standard | tse | ese (Optional - DS8000 only) Specifies the storage allocation method as follows: standard Designates that you want the system to fully allocate the volume with real extents when it creates the volumes. This value is the default. tse Designates that you want the system to create track space-efficient volumes. After creation, these space-efficient volumes contain a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. Note: To use this subparameter, you must have previously created space-efficient storage (using the mksestg command) for the extentpool. ese Designates that an extent space efficient (ESE) logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool.
274
Physical space for an extent space efficient logical volume is dynamically allocated and de-allocated from the extent pool. ESE volumes are used for IBM System Storage DS8000 Thin Provisioning. Note: To use this subparameter, you must have previously created space-efficient storage (using the mksestg command) for the extentpool. -eam rotateexts | rotatevols (Optional - DS8000 only) Specifies the extent allocation method as follows: rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. -perfgrp performance_group_ID (Optional) Specifies the performance group ID that the volumes are assigned to. The performance group ID begins with the letters PG. The default is PG0. -resgrp resource_group_ID (Optional) Specifies the resource group that the volumes are assigned to. The resource group ID begins with the letters RG and ends with a decimal number. The default is RG0. Note: If you create any fixed block LSSs using this command, the LSSs are assigned to the same resource group as the logical volumes. -t10dif (Optional - DS8000 only) Specifies that the DS8000 is using the CRC-16-T10-DIF algorithm to store data. Note: The -t10dif and -os400 parameters cannot be used together. volume_ID . . . | (Required) An array of one or more fixed block volume IDs to be created. The volumes must share a common logical subsystem ID. The volume ID format is four hexadecimal characters XYZZ, that represent the following values: X (for DS8000 and DS6000) Specifies the address group, 0 -1 for DS6000 and 0F for DS8000. XY (DS6000 only) Specifies the logical subsystem number, 00 - 1E. XY (DS8000 only) Specifies the logical subsystem number, 00 - FE. ZZ (for DS8000 and DS6000) Specifies the volume number, 00 - FF. To specify a range of volume IDs, separate the volume IDs with a dash (-). You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. Example: 0100-010F 0180-018F 0120 If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
275
Example
Invoking the mkfbvol command
dscli> mkfbvol -dev IBM.2107-75FA120 -extpool P1 -name my_vol_#d -type ess -cap 8.6 -sam ese 0100 0101 0102 0103
rmfbvol
The rmfbvol command deletes fixed block volumes from a storage image.
rmfbvol -dev storage_image_ID -quiet -safe -force Volume_ID . . . " - "
Parameters
Note: You can use this command when there are volumes that are in the configuration error state. To correct this configuration state, issue the rmfbvol command for each affected volume. You can specify a volume range according to the command specifications when it is appropriate. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID for all logical volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -quiet (Optional) Turns off the volume removal confirmation prompt for this command. -safe (Optional) The -safe parameter specifies that the system perform a check to see whether the specified volumes are assigned to any non-default volume groups. If any volumes are still assigned to a user-defined volume group, the rmfbvol command fails without deleting any volumes. During this occurrence, messages are provided which list the volumes that are still assigned to a user-defined volume group. Notes: v If there is any reason that the system cannot perform the check, the rmfbvol command fails and no volumes are deleted. v The -safe and -force parameters cannot be specified at the same time. -force (Optional) The -force parameter attempts to delete the volumes without checking to see whether the volumes are in use. If multiple volumes are specified and some are in use and some are not, the ones not in use can be deleted. Note: The -safe and -force parameters cannot be specified at the same time. Volume_ID . . . | (Required) Specifies an array of one or more fixed block volume IDs to be removed. This parameter
276
also accepts a fully qualified volume ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. Example of -dev parameter use If you specify the -dev parameter, you can use the shortened version of the Volume_ID parameter as follows: For DS8000:
dscli> rmfbvol -dev IBM.2107-75FA120 0100-010F 0180-018F 0120
For DS6000:
dscli> rmfbvol -dev IBM.1750-13ABR4A 0005-00FF
If you do not specify the -dev parameter and you specify the Volume_ID variable, you must use the fully qualified version of the volume ID as follows: For DS8000:
dscli> rmfbvol IBM.2107-75FA120/0100-010F 0180-018F 0120
For DS6000:
dscli> rmfbvol IBM.1750-13ABR4A/0005-00FF
The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 -1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. To specify a range of volume IDs, separate the volume IDs with a hyphen. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmfbvol command
dscli> rmfbvol -dev IBM.2107-75FA120 0100 0101
The following is an example of the output that results when you specify that you want a range of volume IDs to be removed. Invoking the rmfbvol command
dscli> rmfbvol -dev IBM.2107-75FA120 0005-0024
Chapter 4. CLI commands
277
CMUC00027W [y/n]:y CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I CMUC00028I . . .
rmfbvol: Are you sure you want to delete FB volume 0005-0024? rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: rmfbvol: FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB volume volume volume volume volume volume volume volume volume volume volume volume volume volume volume volume 0005 0006 0007 0008 0009 000A 000B 000C 000D 000E 000F 0010 0011 0012 0013 0014 successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully successfully deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted. deleted.
showfbvol
The showfbvol command displays detailed properties for an individual volume. This command can also be used to display the performance metrics of a fixed block volume.
showfbvol -dev storage_image_ID volume_ID " - " -rank -metrics
-volgrp
volume_group_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -rank (Optional) Specifies that a rank extents table is to be displayed. This table displays the set of ranks that the logical volume has extents configured on and the number of extents for that logical volume. Note: This parameter cannot be used with the -metrics or -volgrp parameters. -metrics (Optional) Displays volume ID and performance metrics for the specified volume. Notes: 1. All performance counts are an accumulation since the most recent counter wrap or counter reset. Volume performance counters are reset on a power-up sequence. Volume performance counters are reset by a server failover and failback sequence. 2. Do not use this parameter with the -rank parameters. -volgrp volume_group_ID (Required if you do not specify the volume_ID parameter.) Specifies that the fixed block volumes that are associated with the designated volume group ID are to be displayed. Notes:
278
1. You can only use the -volgrp parameter when you are doing a query for performance metrics. 2. Do not use the -volgrp parameter with the volume_ID parameter. 3. Do not use the -volgrp parameter with the -rank parameters. volume_ID | (Required if you do not specify the -volgrp parameter.) Displays information for the specified volume. This parameter accepts a fully qualified volume ID, which consists of the storage_image_ID or a shortened version without the storage image ID, if you specify the -dev parameter. The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode. Note: Do not use the volume_ID parameter with the -volgrp parameter. |
Example 1
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showfbvol command using the -rank parameter. When the rank parameter is specified, a rank extents table is also displayed. It appears at the end of the regular report. Invoking the showfbvol to show volume properties
| Note: The example output is based on using the showfbvol command for a 1.0 gibibyte (GiB)volume. When the rank parameter is specified, a rank extents table is displayed at the end of the regular report.
dscli> showfbvol -dev IBM.2107-1300861 -rank 6000
extpool P0
exts 1622
captype DS
cap (10^9B) -
volgrp -
ranks 2
dbexts 0
279
sam Standard
repcapalloc -
eam rotateexts
realextents 1
virtualextents 0
migrating 0
migratingfrom -
perfgrp PG0
resgrp RG0
| ============================Rank extents===========================
Rank R0 R2 Extents 1 2
280
v Global inaccessible v Global lost data Conditions - one of the following conditions has occurred: v Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown. v Data was lost that indicated extents on the logical volume were active FlashCopy targets. The access state is Fenced. Rank failed Indicates that one or more extents that are associated with the logical volume are on a rank that is in the Failed data state. The access state is Fenced. This data state changes to Rank repairing if the rank changes to the Rank repairing state through use of the repair array function. Rank Repairing Indicates that one or more extents that are associated with the logical volume are on ranks in the repairing data state. The access state is Fenced. Rank Repaired Indicates that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. The access state is Fenced. Global inaccessible Specifies that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data that is associated with the logical volume might be inaccurate. The access state is Fenced. Global lost Specifies that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data that is associated with the logical volume might be inaccurate. The access state is Fenced. NVS data inaccessible Specifies that active nonvolatile storage (NVS) data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. The access state is Fenced. Configstate One of the following configuration states are displayed: Normal Indicates that there are no logical volume configuration operations in progress, and the volume is not being deconfigured, merged, or migrated. Configuring Indicates that the logical volume is in the process of being configured for the first time. Reconfiguring Indicates that the logical volume is in the process of allocating or deallocating extents due to a modification of the requested capacity attribute after initial creation. Deconfiguring Indicates that the logical volume is in the process of being deleted. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal error condition and not an error in the request to create the volume. If you have a volume in this state, use the rmfbvol command to delete each volume listed with the configuration state of "configuration error".
281
Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool. Migrating Indicates that the volume is in the process of migrating, or waiting to be migrated. Migration Cancelled Indicates that the volume was in the process of migrating and then the migcancel' action of the manageckdvol command was issued, leaving some of the extents waiting to be migrated in the source pool while other extents have already migrated to the target pool. Migration has stopped, and cannot be resumed. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Migration Paused Indicates that the volume was in the process of migrating and then the migpause' action of the manageckdvol command was issued. Migration has stopped, but can be resumed. Migration Error Indicates that the volume migration process failed to complete successfully. This state reflects an internal error condition and not an error in the user's request to migrate a volume. If you have a volume in this state, try to migrate it again to the original source or target extent pool. Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Deconfiguration error Indicates that a request to delete a volume did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmfbvol command for the designated volume. Transposition Error Indicates that the volume is in an extent pool that was unsuccessfully merged. This state reflects an internal error condition. Corrective action: Use the chextpool command with the -merge parameter again to redrive the merge extent pool and to correct this state. deviceMTM Indicates the volume device type and the machine type. The volume MTM is determined by the fixed block volume data type and the volume capacity (in GB). The machine type is either 2107 or 1750; however, the MTM can be any one of the following depending on your system: 2107-900 Indicates a standard 2107 volume. 1750-500 Indicates a standard 1750 volume. xxxx-A0x The xxxx is 2107 or 1750; the A0 indicates a System i protected volume (for example, 2107-A01 or 1750-A07). xxxx-A8x The xxxx is 2107 or 1750; the A8 indicates a System i unprotected volume (for example, 2107-A81 or 1750-A87). Datatype Indicates the volume data type setting. One of the following values is displayed: v FB 512 v FB 512T v FB 520P v FB 520U
282
Addrgrp Specifies the address group that contains the designated volume object. An address group ID is one hexadecimal character ( 0 - F ). Extpool Specifies the extent pool ID. Volume extents are allocated from this extent pool ID. Note: Volumes that belong to an encrypted extent pool are encrypted. You can see the encryption group of an extent pool by using the lsextpool -l, or showextpool commands. Exts Specifies the number of real and virtual extents used by the designated volume ID. Captype Indicates capacity unit type used at volume creation. One of the following values is displayed: ESS | | | The capacity unit is decimal gigabytes (GB). DS The capacity unit is gibibytes (GiB). DS/ESS The capacity unit is gibibytes (GiB) or decimal gigabytes (GB). Blocks The capacity unit 512 B. iSeries The capacity unit was not specified at volume creation. This fixed block volume was created for iSeries. | | | | Cap (2^30B) Specifies the size of the volume that is available for host system access in gibibytes (GiB). Note: " " is displayed if the capacity unit type of the volume is ESS (captype=ESS) Cap (10^9B) Specifies the size of volume that is available for host system access in decimal gigabytes (GB). Note: " " is displayed if the capacity unit type of the volume is DS (captype=DS) Cap blocks Indicates the quantity of volume logical blocks that are available for host system access. Volgrp Specifies the volume groups (excluding default volume groups) that a volume belongs to. Multiple volume groups that are associated with the volume are separated by a comma. A " " is displayed if there are no volume groups that are associated with the volume. Unknown is displayed if information about the volume groups is not available. Ranks Specifies the number of ranks that the volume resides on. SAM Specifies the storage allocation method. The following values are displayed: | | | | | standard Designates that the system fully allocated the volume with real extents at volume creation time. An inquiry on a DS6000 model always reports this value. tse Designates that a track space-efficient logical volume contains a set of virtual extents that are
Chapter 4. CLI commands
283
| | | | | | | | ese
associated with the space-efficient storage in the same extent pool. Physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage. Designates that an extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and deallocated from the extent pool. Note: IBM Database protection feature supports standard volumes only.
Repcapalloc Specifies the allocated physical repository capacity of the track space-efficient storage. This value is calculated on the available repository capacity as a result of writes to the track space-efficient volume. | This value is displayed in the format of X.Y, where X is in whole gibibytes (GiB) and Y represents | tenths of a GiB, which is limited to a single digit (0 - 9) . Note: 1. A " " value is displayed in this column if the value displayed in the SAM column is not TSE. 2. A " " value is displayed for the DS6000. EAM Specifies the extent allocation method that is to be used if the volume is migrated or expanded. One of the following values is displayed: | | | | | | | | | | | | | | | | legacy Designates that the volume was created before the use of the current algorithm. Legacy is always the reported value for a DS6000 model. rotateexts Specifies that the extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default. rotatevols Specifies that the extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume will be allocated from one rank, while the extents for the next volume will be allocated from the next successive rank, and so on. managed Specifies that the extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage. " " A " - " value is displayed if the extent allocation method does not apply, for example, track space-efficient logical volumes. Reqcap (blocks) Specifies the requested quantity of volume logical block (for example, 3339). Note: A value of 0 is displayed for the DS6000. realextents Specifies the number of real extents used by the logical volume. virtualextents Specifies the number of virtual extents used by the logical volume. migrating The number of extents for this volume that are currently being migrated.
284
migratingfrom A list of one or more extent pool IDs where the extents are migrating from. If there are no migrating extents, a dash "-" is displayed. Unknown is displayed if information about the extent pool IDs is not available. perfgrp Specifies the performance group ID that the volume is assigned to. The performance group ID begins with the letters PG and ends with a decimal number. resgrp Specifies the resource group ID that the volume is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.
Example 2
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showfbvol command using the -metrics parameter. Invoking the showfbvol to show performance metrics
dscli> showfbvol -metrics IBM.2107-75FA120/0101
seqwritehits 10000
cachfwrreqs 10000
cachfwrhits 10000
cachfwreqs 10000
cachfwhits 10000
inbcachload 10000
bypasscach 10000
DASDtrans 10000
cachetrans 10000
NVSspadel 10000
seqwriteops 10000
qwriteprots 10000
CKDirtrkac 0
285
cachspdelay 10000
timelowifact 10000
phread 10000
phwrite 10000
phwrite 10000
phbyteread 10000
phbytewrit 10000
recmoreads 10000
contamwrts 0
PPRCtrks 10000
NVSspallo 10000
timephread 10000
timephwrite 10000
byteread 10000
bytewrit 10000
timeread 10000
timewrite 10000
zHPFRead -
zHPFWrite -
zHPFPrefetchReq 0
zHPFPrefetchHit 0
GMCollisionsSidefileCount 0
GMCollisionsSendSyncCount 0
286
inbcachload Specifies Inhibit Cache Loading I/O Requests that operate with DASD. bypasscach Specifies Bypass Cache I/O Requests. seqDASDtrans Specifies Sequential DASD to Cache Transfer Operations. DASDtrans Specifies DASD to Cache Transfer Operation Count. cachetrans Specifies Cache to DASD Transfer Operation Count. NVSspadel Specifies DASD Fast Write Operations Delayed Due to nonvolatile storage Space Constraints. normwriteops Specifies Normal DASD Fast Write' Write Operation Counts. seqwriteops Specifies Sequential Access DASD Fast Write' Write Operation Counts. reccachemis Specifies Number of record cache Read Misses. qwriteprots Specifies Quick Write Promotes. CKDirtrkac Specifies Irregular Track Accesses. A 0 (zero) value is displayed for a fixed block volume. CKDirtrkhits Specifies Irregular Track Accesses instances. A 0 (zero) value is displayed for a fixed block volume. cachspdelay Specifies Operations Delayed Due To Cache Space Constraints. timelowifact Specifies Milliseconds of lower interface I/O activity for the indicated device. phread Specifies Physical Storage Read Operations. phwrite Specifies Physical Storage Write Operations. phbyteread Specifies Physical Storage Bytes Read in 128 KB increments. phbytewrit Specifies Physical Storage Bytes Written in 128 KB increments. recmoreads Specifies Record Mode Read Operations. sfiletrkreads Specifies the Number of tracks read from the Concurrent Copy or XRC Sidefile. A 0 (zero) value is displayed for a fixed block volume. contamwrts Specifies the Number of Contaminating writes for a Concurrent Copy or XRC volume. A 0 (zero) value is displayed for a fixed block volume.
287
PPRCtrks Specifies the Number of tracks or portion of tracks that were transferred to the secondary device of a PPRC pair. NVSspallo Specifies the NVS Space Allocations. timephread Specifies the Physical Storage Read Response Time in 16 ms increments. timephwrite Specifies the Physical Storage Write Response Time in 16 ms increments. byteread Specifies the number of Bytes read in 128 KB increments. bytewrit Specifies the number of Bytes written in 128 KB increments. timeread Specifies the accumulated response time for all read operations. timewrite Specifies the accumulated response time for all write operations. zHPFRead Specifies the HPF Read I/O Requests for volume performance statistics. zHPFWrite Specifies the HPF Write I/O Requests for volume performance statistics. zHPFPrefetchReq Specifies the number of HPF Pre-fetch I/O requests. zHPFPrefetchHit Specifies the number of HPF Pre-fetch I/O request hits. GMCollisionsSidefileCount Specifies the number of Global Mirror Collisions sidefile. GMCollisionsSendSyncCount Specifies the number of Global Mirror Collisions Send Synchronous Count.
288
chvolgrp
The chvolgrp command modifies a volume group name and volume members.
chvolgrp -dev storage_image_ID -name new_Volume_Group_name
-action
-volume
volume_ID
. . .
-lun
lun_ID
Parameters
Note: If you are using an HP-UX operating systems, the number of volumes in the volume group must not exceed 7 volumes. This restriction only applies when the hostconnect attribute for the -addrdiscovery parameter is set to reportlun and the associated volume group is of type mapscsi256. -dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -name new_Volume_Group_name (Optional). Specifies a new name for the volume group. The name is limited to 16 characters. The name must be unique across volume groups that are contained by a storage unit. -action add | remove | replace (Optional, unless the -volume parameter is specified). Specify one of the following values with this parameter: add remove Specifies that the volumes be removed from the volume group. replace Specifies that the existing volumes be replaced by the specified volumes. Note: The chvolgrp command fails if you have specified the -volume parameter and not included the -action parameter. -volume volume_ID . . . (Optional unless you are specifying the -action or the -lun parameter, then the -volume parameter is required.) Specifies an array of one or more volume IDs or volume ID ranges to be included in the volume group when the -action parameter is specified. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE.
Chapter 4. CLI commands
289
XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. To specify a range of volume IDs, separate the volume IDs with a dash (-). You must separate multiple volume IDs or ranges of volume IDs with a comma between each ID or range of IDs. Notes: 1. For SCSI MAP 256, the array or ranges cannot exceed 256 volume ID entries. Otherwise, up to 64 384 entries are allowed. 2. The chvolgrp command fails if you specify the -volume parameter and do not specify the -action parameter. Example: 0100-010F,0180-018F,0120 -lun lun_ID (Optional - SCSI MAP 256 only). Specifies the LUN ID in hexadecimal value (00 - FF), which is mapped to the specified volume ID when the -action add or -action replace parameter is specified. If multiple volume IDs are specified by the -volume parameter, the LUN ID is consecutively assigned in incremental order. If the specified LUN ID is not valid, the command is rejected. Note: This parameter is only valid when the target volume group type is SCSI MAP 256. Otherwise, this command fails. If the -action add parameter is specified and the specified LUN ID is already mapped to the other volume in the specified volume group, the command fails. If the -action add parameter is specified without the -lun parameter, an unused LUN ID is assigned to the volume ID. In this case, the unused LUN ID is selected from a smaller number. The following example shows how this works:
A volume group of "SCSI Map 256" type has Volume 0000 and 0001. Their LUNs are the members of the following volume group: (showvolgrp displays the current mapping.) 0000 : 10 0001 : 11 Because the range of LUN IDs is 00-FF, the unused LUN IDs are 00,01,...,0F,12,13,...,FF. If you add volume 0002 and 0003 to this volume group without the -lun parameter, the mapping results in the following because 00 and 01 are "smaller" unused LUN IDs: 0002 : 00 0003 : 01 0000 : 10 0001 : 11
If the -action replace parameter is specified without specifying the -lun parameter, lun_ID=00 is assumed. Volume_Group_ID | (Required). Specifies the ID of the volume group being changed. The volume group ID is made up of the storage image ID followed by the volume group ID. This parameter also accepts a fully qualified volume group ID including the storage image ID or a shortened version. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter V. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
290
Example
Invoking the chvolgrp command
dscli> chvolgrp -action add -volume 0000-000F IBM.2107-75FA120/V2341
lsvolgrp
The lsvolgrp command displays a list of volume groups in a storage image and status information for each volume group in the list.
lsvolgrp -dev storage_image_ID -s -l -type ficonall scsiall scsimask scsimap256 os400all os400mask
-volume
volume_ID
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which includes manufacturer, machine type, and serial number. Displays only the objects for the storage unit that is specified. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -s (Optional). Displays volume group IDs only. You cannot use the -l and the -s parameters together. -l | (Optional). Displays the default output. You cannot use the -l and the -s parameters together. -type | ficonall | scsiall | scsimask | scsimap256 | os400all | os400mask (Optional). Displays only volume groups that are configured as the specified volume group type. -volume volume_ID (Optional). Displays volume groups that contain the specified volume ID. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF.
Chapter 4. CLI commands
291
Volume_Group_ID . . . | (Optional). Displays volume groups with the specified IDs. A volume group ID is a four-digit decimal number with no leading zeroes, prefixed with the letter V. This parameter accepts a fully qualified volume group ID or a shortened version, if the -dev parameter is specified. To specify a range of volume group IDs, separate the volume group IDs with a hyphen. You must separate multiple volume group IDs or ranges of volume group IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsvolgrp command using the -l parameter. Invoking the lsvolgrp command
dscli> lsvolgrp -dev IBM.2107-75FA120 -l
292
mkvolgrp
The mkvolgrp command creates a volume group in a storage image.
mkvolgrp -dev storage_image_ID -hosttype host_type -type scsimask scsimap256 os400mask
-volume
volume_ID
. . .
-lun
lun_ID
Parameters
Notes: 1. Ensure that you use the -hosttype parameter when you issue this command. 2. When you create DS6000 volume groups for (RedHat) Linux using the mkvolgrp command, the -type parameter must be set to scsimap256. 3. When you create DS6000 volume groups for AIX5L, the -type parameter must be set to scsimap. If you are using an HP-UX operating system, the number of volumes in the volume group must not exceed 7 volumes. This restriction only applies when the hostconnect attribute for the -addrdiscovery parameter is set to reportlun and the associated volume group is of type scsimap256. -dev storage_image_ID (Optional). Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -hosttype host_type (Optional) Use this parameter as an alternative method for specifying the type of Volume Group. Note: You cannot use this parameter with the -type parameter. -type | scsimask | scsimap256 | os400mask (Optional). Specifies the type of the volume group. scsimask (default) Creates a SCSI mask volume group. This option is available if the host adapter supports four-byte LUN addresses. scsimap256 Creates a SCSI-MAP 256 volume group. os400mask Creates an OS400 mask volume group. The IBM IBM i host system typically uses fixed block volumes of 520-byte logical block size. This option is available only if the host adapter supports four-byte LUN addresses. Note: This volume group is also referred to as SCSI520-MASK. When an error message is displayed for the OS400 MASK, SCSI520-MASK is referenced instead. Note: You cannot use this parameter with the -type parameter.
293
-volume volume_ID | . . . (Optional). Specifies the array of volume IDs to include in the volume group. For the -type scsimap256 parameter, the array cannot exceed 256 volume ID entries. Otherwise, up to 64 384 entries are allowed. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. To specify a range of volume IDs, separate the volume IDs with a dash (). You must separate multiple volume IDs or ranges of volume IDs with a comma between each ID or range of IDs. Example: 0100-010F,0180-018F,0120 -lun lun_ID (Optional) Specifies the LUN ID in hexadecimal value (00 - FF) which is mapped to the specified volume ID for a SCSI-MAP256 type volume group. If multiple volume IDs are specified by the -volume parameter, LUN IDs are assigned consecutively in incremental order. Note: This parameter is only valid for a SCSI-MAP 256 type volume group. If this parameter is specified for any other type of volume group, the command fails. Volume_Group_Name | (Required). Specifies the volume group name, not to exceed 16 characters. Ensure that the name is unique within the scope of the storage image. Accepts a fully qualified volume group name or a shortened version, if the -dev parameter is specified. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the mkvolgrp command
dscli> mkvolgrp -dev IBM.2107-75FA120 -volume 0000-000F host_xyz_volumes
rmvolgrp
The rmvolgrp command deletes existing volume groups from a storage image.
rmvolgrp -dev storage_image_ID -quiet " - " Volume_Group_ID . . .
294
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -quiet (Optional) Turns off the volume group removal confirmation prompt for this command. Volume_Group_ID . . . | (Required). Specifies an array of one or more volume groups IDs to be deleted. All volume groups specified must belong to the same storage unit. This parameter also accepts a fully qualified volume group ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeroes, prefixed with the letter V. To specify a range of volume group IDs, separate the volume group IDs with a dash (-). You must separate multiple volume group IDs or ranges of volume group IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of -dev parameter use If you specify the -dev parameter, you can use the shortened version of the Volume_Group_ID parameter as follows: For DS8000,
dscli> rmvolgrp -dev IBM.2107-75FA120 V11
If you do not specify the -dev parameter and you specify the Volume_Group_ID parameter, you must use the fully qualified version of the volume group ID as follows: For DS8000,
dscli> rmvolgrp IBM.2107-75FA120/V11
Example
Invoking the rmvolgrp command
dscli> rmvolgrp IBM.2107-75FA1243/V123
showvolgrp
The showvolgrp command displays detailed properties of a volume group.
showvolgrp -dev storage_image_ID -lunmap Volume_Group_ID " - "
295
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -lunmap (Optional). Specifies that a LUN mapping table be displayed that shows the volume ID and LUN ID relationship. This parameter is valid for all scsi and os400 type volume groups. Volume_Group_ID | (Required). Specifies that the properties be displayed for the specified volume group. This parameter accepts a fully qualified volume group ID, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter V. Examples of -dev parameter use If you specify the -dev parameter, you can use the shortened version of the Volume_Group_ID parameter as follows: For DS8000:
dscli> showvolgrp -dev IBM.2107-75FA120 V11
where V11 represents value for the volume group ID. If you do not specify the -dev parameter, and you specify the Volume_Group_ID parameter, you must specify the fully qualified version of the Volume_Group_ID parameter as follows: For DS8000:
dscli> showvolgrp IBM.2107-75FA120/V11
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. | Example 1 For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output reports that are associated with the showvolgrp command. Note: The volume group type determines the format of the LUN ID that is reported. The following examples demonstrate these differences. Invoking the showvolgrp command where the volume group type is SCSI MAP 256
dscli> showvolgrp -lunmap IBM.2107-1300861/V2
296
ID V2
============================LUN Mapping=========================== vol 1000 1001 1002 1003 1004 1005 1006 1007 lun 00 01 02 03 04 05 06 07
Example 2
Invoking the showvolgrp command where the volume group type is SCSI Mask
dscli> showvolgrp -lunmap IBM.2107-1300861/V18
============================LUN Mapping=========================== vol 1000 1001 1002 1003 1004 1005 1006 1007 lun 40104000 40104001 40104002 40104003 40104004 40104005 40104006 40104007
297
Type Specifies the configured volume group type. Any one of the following volume group types can be queried: FICON/ESCON All | SCSI all | SCSI Mask | SCSI MAP 256 | os400 all | os400 Mask | ESSNet Copy Services Note: os400 all and os400 Mask are sometimes referred to as SCSI520 all and SCSI520 Mask. Vols Identifies the complement of accessible volume numbers within the designated volume group. vol (part of LUN mapping table) Specifies the volume ID. lun (part of LUN mapping table) Specifies the LUN ID that is mapped to the designated volume ID. As noted in the examples, the LUN IDs can be different based on volume group type.
clearvol
The clearvol command clears Copy Services relationships for a base logical volume.
clearvol -dev storage_image_ID -pprcsource -pprctarget -fcsource
-fctarget
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -pprcsource (Optional). This parameter is used with a base logical volume. It removes any remote mirror and copy relationships on the logical volume where the specified logical volume operates as a remote mirror and copy source. -pprctarget (Optional). This parameter is used with a base logical volume. It removes any remote mirror and copy relationships on the logical volume where the specified logical volume operates as a remote mirror and copy target.
298
-fcsource (Optional). This parameter is used with a base logical volume. It removes any FlashCopy relationships on the logical volume where the specified logical volume operates as a FlashCopy source. -fctarget (Optional). This parameter is used with a base logical volume. It removes any FlashCopy relationships on the logical volume where the specified logical volume operates as a FlashCopy target. Volume_ID | (Required). Specifies the volume ID where Copy Services relationships are to be cleared. This parameter accepts a fully qualified volume ID, which includes the storage image ID or a shortened version, if the -dev parameter is specified. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example: IBM.2107-75FA120/0001
Example
Invoking the clearvol command
dscli> clearvol -dev IBM.2107-75FA120 0001
lsvolinit
The lsvolinit command displays volumes that are being initialized using flash init. CKD volumes are not displayed. This command is not supported on DS6000 models.
lsvolinit -dev storage_image_ID -s -l volume_ID . . . " - "
Parameters
Note: If trackstoinit reaches zero, the initialization is complete and the volume is no longer listed with this command -dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. Displays only the objects for the storage unit that is specified. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your
299
profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s | -l | (Optional). Displays the default output. You cannot use the -l and the -s parameters together. volume_ID . . . | (Required). Specifies the IDs of the volumes that you want to query. You must separate multiple volume IDs or ranges of volume IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. (Optional). Displays only the volume ID. You cannot use the -s and the -l parameters together.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsvolinit command using the -l parameter. Invoking the lsvolinit command
dscli> lsvolinit -dev IBM.2107-75FA120 -l 0100-0101
300
Note: If the state is anything other than Valid, then all other columns, except ID, are reported as " - ". TracksToInit Specifies the number of tracks that are not yet initialized. The maximum value that can be displayed is dependent on the volume size. | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
chsestg
The chsestg command changes the space-efficient storage attributes for an extent pool. This command is not supported on DS6000 models.
chsestg -dev storage_image_ID -repcapthreshold repository_threshold_percentage
-captype
-repcap
capacity
-reppercent
percentage
-vircap
capacity
-quiet
-wait
extentpool_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
301
-repcapthreshold repository_threshold_percentage (Optional) Specifies the minimum threshold percentage of the physical repository capacity available. When the percentage of the currently available repository capacity is less than this minimum percentage, notifications are sent and the repository capacity status is reported as exceeded. Notes: 1. There are three thresholds for the repository that generate notifications when their thresholds amounts are attained. Two of the three thresholds are set by the system and cannot be changed. They are set to 0% (full) and 15% (85% full). The third threshold is the user-defined threshold that is set here, and the repository capacity status is based on this threshold. When any of the three thresholds have attained a threshold amount, a notification will be sent for that particular threshold. No further notifications will be sent until the repository capacity changes. If the repository capacity changes and remains above the threshold, another notification might be sent, but no more than one notification every five minutes. You must free capacity in the repository to stop the notifications. If the user-defined threshold is equal to one of the other two fixed thresholds, only one notification is sent, at most once every five minutes, for the two equivalent thresholds. 2. To verify that your storage complex is set up to send notifications, use the showsp command. If it is not set up, use the chsp command to set up notifications. -captype gb | blocks | cyl | mod1 (Optional) Specifies the type of capacity unit that is specified by the -repcap parameter. gb is the default for fixed block storage and mod1 is the default for CKD. Select one of the following capacity unit types: | gb (binary gigabyte) Specifies the capacity unit type as gibibytes (GiB). (1 GiB = 2^30 Bytes = 1,073,741,824 Bytes) blocks Specifies the capacity unit type as blocks. This capacity unit type can only be selected for fixed block storage. (1 GiB = 2,097,152 blocks) cyl modl Specifies the capacity unit type as cylinders. This capacity unit type can only be selected for count key data (CKD) storage. (1 GiB = 1263.28 cylinders) Specifies the capacity unit type in mod1 units. This capacity unit type can only be selected for count key data (CKD) storage. (1 modl = 1113 cylinders)
-repcap capacity (Optional) Specifies the amount of physical capacity that you want to provision for the virtual capacity of the track space-efficient logical volumes. All capacities must be designated as whole numbers. The capacity units are specified by the -captype parameter. Specifying 0 removes an already existing physical repository. Note: Extent space efficient volumes do not need repository capacity; their physical space comes directly from the extent pool. The minimum, non-zero value that you can designate for each unit type is as follows: v gb = 16 GiB v blocks = 33, 554, 432 blocks, which is equivalent to 16 GiB. v cyl = 16740 cylinders. v mod1 = 16 mod1 units. Notes: 1. The -repcap or -reppercent parameters can be used to create or remove a repository. Changing the size of an existing repository is not supported. 2. Extent space efficient volumes do not need repository capacity; their physical space comes directly from the extent pool.
302
-reppercent percentage (Optional) Specifies the amount of physical capacity that you want to provision for the virtual capacity of the track space efficient logical volumes, specified as a percentage of the total virtual capacity. You can specify a percentage from 0 to 100. Specifying 0 removes an already existing physical repository. Note: The -repcap or -reppercent parameters can be used to create or remove a repository. Changing the size of an existing repository is not supported. -vircap capacity (Optional) Specifies the amount of virtual capacity that can be allocated to space-efficient logical volumes. All capacities must be designated as whole numbers. The capacity units are specified by the -captype parameter. Notes: 1. Some releases of the DS8000 require that the ratio of virtual capacity to repository capacity is to be at least 2:1. 2. Only one of the following parameters can be specified: -repcapthreshold, repcap, -reppercent, and -vircap. -quiet (Optional) Turns off the modification confirmation prompt for this command. -wait (Optional) Specifies that the command will be delayed until after the space efficient storage is created, configured, and in a Normal state. If an error condition is detected while waiting, the command returns and reports an error. The -wait parameter can only be specified if either -vircap, -repcap, or -reppercent is also specified. extentpool_ID | (Required) Specifies the ID of the space-efficient storage extent pool that you want to change. This parameter accepts either a fully qualified extent pool ID or a shortened version if the -dev parameter is used. The shortened version is a four-digit decimal number with no leading zeros, prefixed with the letter P. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the chsestg command to modify space-efficient storage in an extent pool.
dscli> chsestg -dev IBM.2107-75FA120 repcapthreshold 75 P2
lssestg
The lssestg command displays a list of the track space-efficient storage in the storage unit. This command is not supported on DS6000 models.
lssestg -dev storage_image_ID -s -l -percent extentpool_ID . . . " - "
303
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -s (Optional) Displays only the extent pool IDs of the extent pools that contain space-efficient storage. You cannot use the -s and the -l parameters together. -l (Optional) Displays the default output plus the virtual and physical repository capacity allocated for track space-efficient storage. You cannot use the -s and the -l parameters together. | | | | | -percent (Optional) Specifies that the repcapalloc and vircapalloc values be displayed in percentages rather than in gibibyte (GiB) or Mod1 units. Note: In some versions of the DS CLI, the displayed percentages for the repcapalloc and vircapalloc values used one decimal place. However, because internal percentage calculations only use whole numbers, the decimal place has been removed. extentpool_ID | . . . | (Optional) Specifies the IDs of one or more extent pools that you want the system to display the space-efficient storage details for. A fully qualified extent pool ID is accepted, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeros, prefixed with the letter P. To specify a range of extent pool IDs, separate the extent pool IDs with a hyphen. You must separate multiple extent pool IDs or ranges of extent pool IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lssestg command using the -l parameter. Invoking the lssestg command to display track space-efficient storage in a storage unit.
dscli> lssestg -dev IBM.2107-75FA120 -l
304
305
Rank Repaired Indicates that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. Global inaccessible Indicates that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data associated with the logical volume might be inaccurate. Global lost data Indicates that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data associated with the logical volume might be inaccurate. NVS data inaccessible Indicates that active NVS data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. Extent fault Indicates that none of the other states apply and a logical volume needs virtual space converted to real space, but the space was not available. So the subsequent writes fail until the space becomes available. Configstate One of the following configuration states are displayed: Normal Indicates that there are no track space-efficient storage configuration operations in progress. Configuration pending Indicates that there is an initial configuration for track space-efficient storage is in the queue. Configuration pending error Indicates that the request for initial configuration for track space-efficient storage to be in the queue did not complete successfully. Configuring Indicates that track space-efficient storage is in the process of being configured for the first time. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal error condition and not an error in the request to create the track space-efficient storage. Corrective action: Use thermsestg command to delete each track in the space-efficient storage that is listed with the configuration state of "configuration error". Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Migration error Indicates that the dynamic volume relocation operation was ended during processing. Configuration out-of-synch Indicates that there are internal inconsistencies for the configuration state of the space-efficient storage. Deconfiguring Indicates that the track space-efficient storage is in the process of being deleted. Deconfiguration error Indicates that a request to delete track space-efficient storage did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmsestg command for the track in the space-efficient storage that is listed with the configuration state of "deconfiguration error".
306
Degraded - Configuration Error Indicates that some of the storage configuration process failed to complete successfully. Some is normal and it can continue to be used. Degraded - Configuration Out of Synch Indicates that there are internal inconsistencies for the configuration state of some of the storage. Some is normal and it can continue to be used. Degraded - Configuration Pending Indicates that the configuration operation for some of the storage is queued. Some is normal and it can continue to be used. Degraded - Configuring Indicates that some of the storage is in the process of configuring. Some is normal and it can continue to be used. Degraded - Deconfiguration Error Indicates that some of the deconfiguration process did not complete successfully. Some is normal and it can continue to be used. Degraded Deconfiguring Indicates that some of the storage is in the process of being deleted. Some is normal and it can continue to be used. Degraded - Migration Error Indicates that some of the space efficient storage is in the process of being migrated and some is normal and it can continue to be used. Degraded - Pending Indicates that some of the configuration operation is queued. Some is normal and it can continue to be used. Degraded - Reconfiguration Error Indicates that some of the space efficient storage is in the process of being reconfigured and some is normal and can continue to be used. Unknown Indicates that the configuration state of the space-efficient storage cannot be determined due to an internal error. Partial - No Physical Space Indicates that there is no physical space defined. Defining physical space is not required and the state might be normal, with only virtual space defined. Partial - No Virtual Space Indicates that the physical space is defined, but the virtual space is not. Reconfiguring Indicates that the space efficient storage is in the process of being reconfigured. Degraded -Reconfiguring Indicates that some of the space efficient storage is in the process of being reconfigured and some is normal and that it can continue to be used. Migrating Indicates that space efficient storage is in the process of being migrated. Degraded - Migrating Indicates that some of the space efficient storage is in the process of being migrated and some is normal and that it can continue to be used. Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool.
Chapter 4. CLI commands
307
Degraded - Merging Indicates that some of the space efficient storage is in the process of being merged and some is normal and that it can continue to be used. Transposition Error Indicates that an internal error condition has occurred. This error can happen when a merge extent pool operation fails. To correct this state, use the chextpool command with the -merge parameter to redrive the original merge pool operation. Degraded - Transposition Error Indicates that an internal error condition has occurred on some of the space efficient storage and some is normal and that it can continue to be used. Repcapstatus Indicates the status of the repository capacity. One of the following three values is displayed: A dash (-) is displayed if the status is undefined or not applicable. For example, a dash is displayed if the repository does not exist.
below The repository capacity available (repcap - repcapalloc), as a percentage of total repository capacity (repcap) is greater than the repository capacity threshold. exceeded The repository capacity available is less than the repository capacity threshold. full The repository capacity available is zero. | | | | | | | | | | | | | | | | | | | | | | Repcap(GiB/Mod1) Indicates the total physical repository capacity in the format of X.Y where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 9). For CKD volumes, the Mod1 capacity (1 Mod1 = 1113 cylinders) is displayed, where X is a whole Mod1, and Y represents tenths of a Mod1. Vircap Indicates the total virtual capacity in the format of X.Y where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, the Mod1 capacity (1 Mod1 = 1113 cylinders) is displayed, where X is a whole Mod1, and Y represents tenths of a Mod1. Repcapalloc Indicates the allocated physical repository capacity of the track space-efficient storage used from the available repository capacity as a result of writes to the space-efficient volume. Displayed in the format of X.Y where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, the Mod1 capacity (1113 cylinders) is displayed, where X is a whole Mod1, and Y represents tenths of a Mod1. If the -percent parameter is specified, the percent of total allocated physical repository is displayed in the format of a whole number with % (for example, 12%). Vircapalloc Indicates the allocated virtual capacity of the track space-efficient storage, that is to say, the amount of virtual capacity already defined as space-efficient volumes. Displayed in the format of X.Y where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, the Mod1 capacity (1113 cylinders) is displayed, where X is a whole Mod1, and Y represents tenths of a Mod1. If the -percent parameter is specified, the percent of total virtual capacity that is defined as space-efficient volumes is displayed in the format of a whole number with % (for example, 12%).
308
mksestg
The mksestg command creates space-efficient storage in an existing extent pool. This command is not supported on DS6000 models.
mksestg -dev storage_image_ID -captype gb blocks cyl mod1 -vircap capacity
-repcapthreshold
repository_threshold_percentage
-wait
extentpool_ID -
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -captype gb | blocks | cyl | mod1 (Optional) Specifies the unit type of the virtual and repository capacities. The following values are specified for each of these unit types: v gb is used to specify gibibytes (GiB). 1 GiB = 1 073 741 824 bytes. This type is the default for fixed block storage when the parameter -captype is not specified. v blocks is used only with fixed block storage. 2 097 152 blocks is equivalent to 1 GiB. v cyl is used only with CKD storage. 1263.28 cylinders is equivalent to 1 GiB. v mod1 is used only with CKD storage, and it is the default for CKD extent pools. 1113 cylinders is equivalent to 1 Mod1. -vircap capacity (Optional) Specifies the amount of virtual capacity that can be allocated to space-efficient logical volumes. All capacities must be designated as whole numbers. The capacity units are specified by the -captype parameter. Note: Some DS8000 models require the ratio of virtual capacity to repository capacity to be at least 2:1. -repcapthreshold repository_threshold_percentage (Optional) Specifies the minimum threshold percentage of the physical repository capacity that is currently available. When the percentage of the currently available repository capacity is less than this minimum percentage, notifications are sent and the repository capacity status is reported as exceeded. The default value is zero. Notes: 1. There are three thresholds for the repository that generate notifications when their thresholds amounts are attained. Two of the three thresholds are set by the system and cannot be changed. They are set to 0% (full) and 15% (85% full). The third threshold is the user-defined threshold that is set here, and the repository capacity status is based on this threshold. When any of the three thresholds have attained a threshold amount, a
Chapter 4. CLI commands
| |
309
notification will be sent for that particular threshold. No further notifications will be sent until the repository capacity changes. If the repository capacity changes and remains above the threshold, another notification might be sent, but no more than one notification every five minutes. You must free capacity in the repository to stop the notifications. If the user-defined threshold is equal to one of the other two fixed thresholds, only one notification is sent, at most once every five minutes, for the two equivalent thresholds. 2. To verify that your storage complex is set up to send notifications, use the showsp command. If it is not set up, use the chsp command to set up notifications. -repcap capacity Specifies the amount of real capacity that is needed to allocate virtual capacity for track space-efficient logical volumes. All capacities must be designated as whole numbers. The capacity units are specified by the -captype parameter. The minimum, non-zero value that you can designate for each unit type is as follows: v v v v gb = 16 GiB blocks = 33 554 432 blocks, which is equivalent to 16 GiB. cyl = 16740 cylinders. mod1 = 16 mod1 units.
You cannot specify the -repcap and -reppercent parameters at the same time. Note: Extent space efficient volumes do not need repository capacity; their physical space comes directly from the extent pool. -reppercent percentage Specifies the amount of physical capacity as a percentage of the virtual capacity (the virtual capacity is defined by the -vircap parameter in this command). This value is specified as a percentage of virtual capacity in the range of 0 - 100%. You cannot specify the -reppercent and -repcap parameters together. Note: Some DS8000 models require the ratio of virtual capacity to repository capacity to be at least 2:1. On systems with this requirement, the effective maximum percentage is 50%. In many cases, a value of 20% of the virtual capacity is a good value, however, under 20% of virtual capacity might degrade performance significantly. -wait (Optional) Specifies that the command will be delayed until after the space efficient storage is created, configured, and in a Normal state. If an error condition is detected while waiting, the command returns and reports an error. extentpool_ID | (Required) Specifies the extent pool that is used to provision the extents used by this space efficient storage. For example, P111. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the mksestg command to create space-efficient storage in an extent pool.
dscli> mksestg -dev IBM.2107-75FA120 -captype gb -vircap 32 -repcap 16 P101
rmsestg
The rmsestg command deletes the space-efficient storage in an extent pool. This command is not supported on DS6000 models.
310
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the space-efficient storage removal confirmation prompt for this command. extentpool_ID | . . . | (Required) Specifies the IDs of one or more extent pools that you want to delete the space-efficient storage from. A fully qualified extent pool ID is accepted, which consists of the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeroes, prefixed with the letter P. To specify a range of extent pool IDs, separate the extent pool IDs with a hyphen. You must separate multiple extent pool IDs or ranges of extent pool IDs with a blank space between each ID or range of IDs. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmsestg command to create space-efficient storage in an extent pool.
dscli> rmsestg -dev IBM.2107-75FA120 P2
showsestg
The showsestg command displays a detailed properties report of the space-efficient storage of an individual extent pool. This command is not supported on DS6000 models.
showsestg -dev storage_image_ID extentpool_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
311
extentpool_ID | (Required) Specifies the ID of the extent pool that you want to query for the space-efficient storage values. A fully qualified extent pool ID is accepted, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeros, prefixed with the letter P. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. Invoking the showsestg command to show space-efficient storage in an extent pool.
dscli> showsestg -dev IBM.2107-75FA120 P1
%repcapthreshold 0
repcap(GiB) 16.8
repcap(blocks) -
repcap(cyl) 21 200
%repcapalloc 5
vircap(blocks) -
vircap(cyl) 42 400
%vircapalloc 13
312
Read only Indicates that the logical volume is read only because one or more extents on the logical volume are on a rank in the read only data state. Inaccessible Indicates that one or more extents that are associated with the logical volume are on a rank that is in the inaccessible data state. Indeterminate data loss Indicates that the following data states do not apply and that one of the following conditions has occurred: Data states that do not apply: v Rank failed v Rank repairing v Rank repaired v Global inaccessible v Global lost data Conditions: one of the following has occurred: v Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown. v Data has been lost that indicates that extents on the logical volume were active FlashCopy targets. Rank failed Indicates that one or more extents that are associated with the logical volume are on a rank that is in the Failed data state. This data state transitions to the Rank repairing state if the rank transitions to the Rank repairing state through use of the repair array function. Rank Repairing Indicates that one or more extents that are associated with the logical volume are on ranks in the repairing data state. Rank Repaired Indicates that one or more extents that are associated with the logical volume are on ranks that were in the repairing state, but are not in the repairing state now. Global inaccessible Indicates that the global metadata that is associated with the logical volume configuration is inaccessible. Some of the data that is associated with the logical volume might be inaccurate. Global lost data Indicates that global metadata that is associated with the logical volume configuration has been lost. As a result, some of the data that is associated with the logical volume might be inaccurate. NVS data inaccessible Indicates that active NVS data is inaccessible for one or more logical volumes of an LSS group. The logical volumes in the LSS group cannot be made accessible. Extent fault Indicates that none of the other states apply and a logical volume needs virtual space converted to real space, but the space was not available. So the subsequent writes fail until the space becomes available. Configstate One of the following configuration states are displayed: Normal Indicates that there are no track space-efficient storage configuration operations in progress.
Chapter 4. CLI commands
313
Configuration pending Indicates that there is an initial configuration for track space-efficient storage is in the queue. Configuration pending error Indicates that the request for initial configuration for track space-efficient storage to be in the queue did not complete successfully. Configuring Indicates that track space-efficient storage is in the process of being configured for the first time. Configuration error Indicates that the initial configuration did not complete successfully. This state reflects an internal error condition and not an error in the request to create the track space-efficient storage. Corrective action: Use the rmsestg command to delete each track in the space-efficient storage that is listed with the configuration state of "configuration error". Reconfiguration error Indicates that the reconfiguration request did not complete successfully. Migration error Indicates that the dynamic volume relocation operation was ended during processing. Configuration out-of-synch Indicates that there are internal inconsistencies for the configuration state of the space-efficient storage. Deconfiguring Indicates that the track space-efficient storage is in the process of being deleted. Deconfiguration error Indicates that a request to delete track space-efficient storage did not complete successfully. This state reflects an internal error condition and not an error in the request to remove the volume. To correct this state, you must reissue the rmsestg command for the track in the space-efficient storage that is listed with the configuration state of "deconfiguration error". Degraded - Configuration Error Indicates that part of the storage configuration process failed to complete successfully. Degraded - Configuration Out of Synch Indicates that there are internal inconsistencies for the configuration state of some of the storage. Some is normal and it can continue to be used. Degraded - Configuration Pending Indicates that part of the configuration operation is queued. Some is normal and it can continue to be used. Degraded - Configuring Indicates that some of the storage is in the process of configuring. Some is normal and it can continue to be used. Degraded - Deconfiguration Error Indicates that part of the deconfiguration process did not complete successfully. Some is normal and it can continue to be used. Degraded Deconfiguring Indicates that some of the storage is in the process of being deleted. Some is normal and it can continue to be used. Degraded - Migration Error Indicates that some of the space efficient storage is in the process of being migrated and some is normal and it can continue to be used.
314
Degraded - Pending Indicates that the configuration operation is queued. Degraded - Reconfiguration Error Indicates that some of the space efficient storage is in the process of being reconfigured and some is normal and can continue to be used. Unknown Indicates that the configuration state of the space-efficient storage cannot be determined due to an internal error. Partial - No Physical Space Indicates that there is no physical space defined. Defining physical space is not required and the state might be normal, with only virtual space defined. Partial - No Virtual Space Indicates that the physical space is defined, but the virtual space is not. Reconfiguring Indicates that the space efficient storage is in the process of being reconfigured. Degraded Reconfiguring Indicates that some of the space efficient storage is in the process of being reconfigured and some is normal and that it can continue to be used. Migrating Indicates that space efficient storage is in the process of being migrated. Degraded - Migrating Indicates that some of the space efficient storage is in the process of being migrated and some is normal and that it can continue to be used. Merging Indicates that the volume is in the process of merging. For example, merging from one extent pool to a different extent pool. Degraded - Merging Indicates that some of the space efficient storage is in the process of being merged and some is normal and that it can continue to be used. Transposition Error Indicates that an internal error condition has occurred. This error can happen when a merge extent pool operation fails. To correct this state, use the chextpool command with the -merge parameter to rerun the original merge pool operation. Degraded - Transposition Error Indicates that an internal error condition has occurred on some of the space efficient storage and some is normal and that it can continue to be used. Repcapstatus Indicates the status of the repository capacity. One of the following three values is displayed: A dash (-) is displayed if the status is undefined or not applicable. For example, a dash is displayed if the repository does not exist.
below The repository capacity available (repcap - repcapalloc), as a percentage of total repository capacity (repcap) is greater than the repository capacity threshold. exceeded The repository capacity available is less than the repository capacity threshold. full Indicates that the repository capacity available is zero.
Chapter 4. CLI commands
315
%repcapthreshold Specifies the minimum threshold percentage of the physical repository capacity available. When the percentage of the currently available repository capacity is less than this minimum percentage, notifications are sent and the repository capacity status is reported as exceeded. The default value is zero. Notes: 1. There are three thresholds for the repository that generate notifications when their thresholds amounts are attained. Two of the three thresholds are set by the system and cannot be changed. They are set to 0% (full) and 15% (85% full). The third threshold is the user-defined threshold that is set here, and the repository capacity status is based on this threshold. When any of the three thresholds have attained a threshold amount, a notification will be sent for that particular threshold. No further notifications will be sent until the repository capacity changes. If the repository capacity changes and remains above the threshold, another notification might be sent, but no more than one notification every five minutes. You must free capacity in the repository to stop the notifications. If the user-defined threshold is equal to one of the other two fixed thresholds, only one notification is sent, at most once every five minutes, for the two equivalent thresholds. 2. To verify that your storage complex is set up to send notifications, use the showsp command. If it is not set up, use the chsp command to set up notifications. | | Repcap (GiB) Indicates the total physical repository capacity in the format of X.Y, where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). Repcap (Mod1) Indicates the total physical repository capacity for CKD in the format of X.Y, where X is in whole Mod1 units (1113 cylinders) and Y represents tenths of a Mod1 unit, and is limited to a single digit (0 - 9). A value is displayed if the storage is for CKD, otherwise, a " - " value is displayed if the storage is for fixed block. Repcap (blocks) Indicates the total physical repository capacity in blocks. A value is displayed if the storage is for fixed block, otherwise, a " - " value is displayed if the storage is for CKD. Repcap (cyl) Indicates the total physical repository capacity in cylinders. A value is displayed if the storage is for CKD, otherwise, a " - " value is displayed if the storage is for fixed block. | | | | | | Repcapalloc (GiB/Mod1) Indicates the allocated physical repository capacity of the track space-efficient storage from the available repository capacity as a result of writes to the track space-efficient volumes. This value is displayed in the format of X.Y, where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, X is in whole Mod1 units (1113 cylinders) and Y represents tenths of a Mod1 unit, and is limited to a single digit (0 - 9). %repcapalloc Indicates the allocated virtual capacity of the track space-efficient storage; that is, the amount of virtual capacity that is already defined as a percentage. Note: In some versions of the DS CLI, the displayed percentage for the repcapalloc value used one decimal place. However, because internal percentage calculations only use whole numbers, the decimal place has been removed. | | Vircap (GiB) Indicates the total virtual capacity in the format of X.Y, where X is in whole gibibytes (1 GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9).
316
Vircap (Mod1) Indicates the total virtual capacity in the format of X.Y, where X is in whole Mod1 units (1113 cylinders) and Y represents tenths of a Mod1 unit, and is limited to a single digit (0 - 9). A value is displayed if the storage is for CKD, otherwise, a " - " value is displayed if the storage is for fixed block. Vircap (blocks) Indicates the total virtual capacity in blocks. A value is displayed if the storage is for fixed block, otherwise, a " - " value is displayed if the storage is for CKD. Vircap (cyl) Indicates the total virtual capacity in cylinders. A value is displayed if the storage is for CKD, otherwise, a " - " value is displayed if the storage is for fixed block. | | | | | Vircapalloc (GiB/Mod1) Indicates the allocated virtual capacity of the track space-efficient storage; that is, the amount of virtual capacity that is already defined as space-efficient volumes. Displayed in the format of X.Y, where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, X is in whole Mod1 units (1113 cylinders) and Y represents tenths of a Mod1 unit, and is limited to a single digit (0 - 9). %vircapalloc Indicates the space-efficient storage allocated virtual capacity as a percentage. Note: In some versions of the DS CLI, the displayed percentage for the vircapalloc value used one decimal place. However, because internal percentage calculations only use whole numbers, the decimal place has been removed. Overhead (GiB/Mod1) Indicates the amount of physical space incurred to implement space-efficient storage. | | | | | | reqrepcap(GiB/Mod1) Indicates the total physical repository capacity that was requested in the format of X.Y, where, for fixed block volumes, X is in whole gibibytes (GiB) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9). For CKD volumes, X is in whole Mod1 units (1113 cylinders) and Y represents tenths of a Mod1 unit, and is limited to a single digit (0 - 9). reqvircap (GiB/Mod1) Indicates the total virtual repository capacity requested in the format of X.Y, where X is in whole gibibytes (GiBs) and Y represents tenths of a GiB, and is limited to a single digit (0 - 9).
317
This section contains commands that are used to manage quality of service for DS8000 models only. The following I/O Priority Management commands are available: lsperfgrp Displays a list of performance groups and information for each performance group in the list. lsperfgrprpt Displays a list of performance group statistics. lsperfrescrpt Displays a list of performance resources and information for each performance resource in the list.
lsperfgrp
The lsperfgrp command displays a list of performance groups and information for each performance group in the list.
lsperfgrp -dev storage_image_ID -s -l -pol policy_ID
performance_group_ID . . . -
Parameters
-dev storage_image_ID (Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s | | -l | (Optional) Displays the default output. You cannot use the -s and the -l parameters together. -pol policy_ID (Optional) Displays only the performance groups with the specified policy ID. (Optional) Displays only the performance group ID. You cannot use the -s and the -l parameters together.
318
performance_group_ID . . . | (Optional) Displays only the performance groups with the performance group IDs specified. Multiple IDs or ID ranges must be separated with a white space between each value. If you use the dash (-), the specified value is read from standard input.
Example
Invoking the lsperfgrp command
dscli> lsperfgrp
lsperfgrprpt
The lsperfgrprpt command displays a list of performance reports for the given set of performance groups, or all if none are specified.
lsperfgrprpt -dev storage_image_ID -s -l -dapair dapair_ID -rank rank_ID
-start
time
-stop
time
-interval
time
performance_group_ID -
Parameters
-dev storage_image_ID (Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Use this parameter to display only the performance group IDs. You cannot use the -s and the -l parameters together.
319
-l (Optional) Use this parameter to display the default output and additional attributes that are identified as long output. You cannot use the -s and the -l parameters together. -dapair dapair_ID (Optional) Displays only the performance groups with the specified DA pair ID. You cannot use the -dapair and the -rank parameters together. -rank rank_ID (Optional) Displays only the performance groups with the specified rank ID. You cannot use the -dapair and the -rank parameters together. -start time (Optional) Specifies the start time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes; for example: 1d,2h,3m. The default is 1h, which means one hour before the current time. -stop time (Optional) Specifies the stop time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes. The default is 0m, which means the current time. -interval time (Optional) Specifies the interval of time between report samples. The time format is specified in days, hours, minutes. The default is 5m, which means a five-minutes interval between samples. performance_group_ID | (Optional) Displays only the performance groups with the performance group IDs specified. Multiple IDs or ID ranges must be separated with a white space between each value. If you use the dash (-), the specified value is read from standard input. Note: Each line of the display is defined as a "report" for that resource at that time. This command has a maximum limit of 256 reports, but is configurable in the dscli.profile. If the limit is exceeded, the command displays an error message and the limit number of reports. The truncated reports are not always at the end of the displayed reports, but might appear as missing reports within the range of the displayed reports.
Example
Invoking the lsperfgrprpt command
dscli> lsperfgrprpt
aveQ 123
tgtQ 123
%hlpT 100
%dlyT 100
%impT 100
mnIO 123456
mxIO 123456
%idle 100
mnMB 1.234
mxMB 1.234
mnresp 123.450
mxresp 123.450
%Hutl 100
%VHutl 100
%loQ 100
%hiQ 100
%hlp# 100
%rep 100
%dly# 100
%ceil 1234
320
avMB Specifies the average (mean) megabytes per second transferred. avresp Specifies the average (mean) response time in tenths of a second for track IO operations during this interval. pri avQ tgtQ %hlpT Specifies the percent of intervals in which IOs were helped. %dlyT Specifies the percent of time in which IOs were delayed. %impt Specifies the percentage of impact on those I/Os delayed. mnIO Specifies the minimum track IO operation per second. mxIO Specifies the maximum track IO operation per second. %idle Specifies the percentage idle. mnMB Specifies the minimum megabytes per second transferred. mxMB Specifies the maximum megabytes per second transferred. mnresp Specifies the minimum response time for track IO operations during this interval. mxresp Specifies the maximum response time for track IO operations during this interval. %Hutl Specifies the percentage of time in which the specified resource had utilization high enough to warrant workload control. %VHutl Specifies the percentage of time in which the specified resource had very high utilization. %loQ Specifies the interval percentage with low QoS. %hiQ Specifies the time percentage with high QoS. %hlp# Specifies the percent of IOs which were helped. %req Specifies the percentage of time in which IO help was requested. Specifies the performance group priority. Specifies the average (mean) I/O-weighted QoS index during this interval. Specifies the QoS target value for the performance group.
%dly# Specifies the percentage of IOs delayed by throttling. %ceil Specifies the ceiling for performance group on acceptable impact.
321
lsperfrescrpt
The lsperfrescrpt command displays a list of performance reports for a given resource or set of resources of a given type.
lsperfrescrpt -dev storage_image_ID -s -l -start time -stop time
-interval
time
Parameters
-dev storage_image_ID (Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Use this parameter to display only the performance group IDs. You cannot use the -s and the -l parameters together. -l (Optional) Use this parameter to display the default output and additional attributes that are identified as long output. You cannot use the -s and the -l parameters together. -start time (Optional) Specifies the start time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes; for example: 1d,2h,3m. The default is 1h, which means one hour before the current time. -stop time (Optional) Specifies the stop time of the report in the past, relative to the current time. The time format is specified in days, hours, minutes. The default is 0m, which means the current time. -interval time (Optional) Specifies the interval of time between report samples. The time format is specified in days, hours, minutes. The default is 5m, which means a five-minutes interval between samples. dapair_id | rank_id | (Optional) The specified resource for which performance reports should be displayed. A device adapter pair ID (dapair_id) is a decimal number prefixed by the letters DP. A rank number (rank_id) is a decimal number prefixed by the letter R. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. If specifying a resource, only one resource may be specified. Note: Each line of the display is defined as a "report" for that resource at that time. This command has a maximum limit of 256 reports, but is configurable in the dscli.profile. If the limit is exceeded, the command displays an error message and the limit number of reports. The truncated reports are not always at the end of the displayed reports, but might appear as missing reports within the range of the displayed reports.
322
Example
Invoking the lsperfrescrpt command
dscli> lsperfrescrpt DP2
avMB Specifies the average (mean) megabytes per second transferred. avresp Specifies the average (mean) response time in tenths of a second for track IO operations during this interval. %Hutl Specifies the percentage of time in which the specified resource had utilization high enough to warrant workload control. %hlpT Specifies the percent of intervals in which IOs were helped. %dlyT Specifies the percent of time in which IOs were delayed. %impt Specifies the percentage of impact on those I/Os delayed.
323
chresgrp
The chresgrp command is used to change a resource group object on a storage image. Note: Resource Group 0 (zero) is predefined and cannot be created, deleted, or modified. By default, all resources belong to this group unless otherwise specified.
chresgrp -dev storage_image_ID -label resource_group_label
-name
resource_group_name
resource_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified resource group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -label resource_group_label (Optional) Specifies the resource group label. The resource group label is 1 to 32 characters and is limited to upper and lower case alphabetic and numeric characters, and the special characters (-), (_), and (.). Label names must be unique. -name resource_group_name (Optional) Specifies the user-assigned nickname for this resource group object. The maximum length is 64 single-byte or 32 double-byte characters. resource_group_ID | (Required) The resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. If you use the dash (-), the specified value is read from standard input.
Example
Invoking the chresgrp command
dscli> chresgrp dev IBM.2107-75FA120 name A_Group RG1
lsresgrp
The lsresgrp command displays a list of resource group objects on the storage image.
lsresgrp -dev storage_image_ID -s -l -label resource_group_label
-name
resource_group_name
resource_group_ID "-"
324
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s | | -l | (Optional) Displays default output. You cannot use the -l and the -s parameters together. -label resource_group_label (Required) Displays the specified resource group label. The resource group label is 1 to 32 characters and is limited to upper and lower case alphabetic and numeric characters, and the special characters (-), (_), and (.). -name resource_group_name (Optional) Displays the specified user assigned nickname for this resource group object. The maximum length is 64 single-byte or 32 double-byte characters. resource_group_ID | (Optional) The resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. If the resource group ID is not specified, one will be assigned. If you use the dash (-), the specified value is read from standard input. (Optional) Displays only the resource group IDs. You cannot use the -l and the -s parameters together.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsresgrp command using the -l parameter. Note: Invoking the lsresgrp command
dscli> lsresgrp
325
state Specifies the current configuration state of this resource group. One of the following values is displayed: Normal Specifies that the resource group is not being configured. Configuring Specifies that the resource group is being configured. Configuration Error Specifies that the resource group configuration process failed to complete successfully. Deconfiguring Specifies that a resource group is in the process of being deleted. Deconfiguration Error Specifies that the resource group deletion process failed to complete successfully. Label Specifies the resource group label. The resource group label is 1 to 32 characters and is limited to upper and lower case alphabetic and numeric characters, and the special characters (-), (_), and (.). | Key: | | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
manageresgrp
The manageresgrp command allows you to manage the contents of any resource group object on a storage image, except resource group 0 (RG0). RG0 is predefined and cannot be created, deleted, or modified. By default, all resources belong to RG0 unless otherwise specified.
manageresgrp -dev storage_image_ID -action set add remove -ctrl copyglobal passglobal gmsession gmmaster
-scope
resource_scope
-sessions
resource_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -action set | add | remove (Required) Specifies the action to apply to the specified resource control. set Explicitly sets the value of a particular control to the specified value. For example, on the
326
copyglobal control, it indicates that the Resource Scope specified by the -scope parameter replaces the existing value for the copyglobal control. add Adds the specified values to the existing values for a particular control. For example, on the gmmaster control, it indicates that the session IDs specified by the-sessions parameter are added to the existing list of session IDs that are allowed to be Global Mirror Master sessions for this resource. Removes the specified values from the existing values for a particular control. For example, on the gmmaster control, it indicates that the session IDs specified by the -sessions parameter are removed from the existing list of session IDs that are allowed to be Global Mirror Master sessions for this resource. -ctrl copyglobal | passglobal | gmmaster | gmsession (Required) Specifies the resource group control that is the object of the specified action. These controls can be physical (for example, a volume), logical (for example, a Global Mirror relationship), or they can be behavioral (for example, the allowed Copy Services behavior between two resources). copyglobal Specifies the Copy Services Global Resource Scope (CS GRS). This resource scope applies to the Establish PPRC Pair (mkpprc) and Establish FlashCopy Pair (mkflash) operations that are issued from any source (a network user ID or a host system). The primary/source logical volume of the volume pair verifies that the secondary/target logical volume is within the scope of the CS GRS in its associated resource group and the secondary/target logical volume of the volume pair verifies that the primary/source logical volume is within the scope of the CS GRS in its associated resources group. If either check fails, the requested operation is rejected. passglobal Specifies the Pass-Through Global Resource Scope (PGRS). Some host-issued commands can be issued to a given logical volume but operate on a different logical volume or logical subsystem that is specified in the command parameters. In this case, the logical volume that receives the command is called the pass-through device and the logical volume or the logical subsystem that the command operates on is called the destination device (logical volume or logical subsystem). This resource scope applies to any Copy Services commands from any source (network user ID or a host system) that result in a pass-through operation. In this case, the resource group label of the destination device must be within the scope of the pass-through logical volume PGRS. Pass-through occurs for the following situations: 1. A Copy Services request is issued to a CKD logical volume that operates on either a fixed block logical volume or logical subsystem. In cases where the Copy Services request establishes a pair or a path, it is the primary/source logical volume or logical subsystem that the must be within the scope of the pass-through logical volume. 2. A Copy Service request is issued to a CKD logical volume that is a PPRC primary of a PPRC pair, the request specifies that the request is issued to the PPRC secondary of the PPRC pair, and the request operates on either a fixed block logical volume or logical subsystem. In cases where the Copy Services request establishes a pair or a path, it is the primary/source logical volume or logical subsystem that the must be within the scope of the pass-through logical volume. gmmaster Specifies the Global Mirror Masters Allowed control, which specifies one or more session numbers whose associated global mirror master is allowed to be managed through an LSS or LCU associated with this resource group. Each global mirror session has one and only one master and it may be run on any storage image that has an LSS associated with the session. The Global Mirror Masters Allowed control allows the user to select which storage image the GM master for a given session is allowed to run on by allowing the GM master in a resource groups on one or more storage images and disallowing it in the resource groups on one or
Chapter 4. CLI commands
remove
327
more other storage images. In order for a GM master to managed through an LSS or LCU associated with this resource group, both the Global Mirror Master Allowed and the Global Mirror Sessions Allowed controls must both allow the session number associated with the GM master. gmsession Specifies the Global Mirror Sessions Allowed control, which specifies one or more session numbers that are allowed to be managed through an LSS or LCU associated with this resource group. Each LSS or LCU has one at most one assigned session number. The logical volumes associated with the LCU or LSS are either associated with the session number of the LCU or LSS, or with no session number. The Global Mirror Sessions Allowed control allows the user to partition the available GM session numbers between the set of resource groups that are each associated with a given tenant in a multi-tenancy environment. | | | | | -scope resource_scope (Optional) Specifies the resource scope, which must meet the following criteria: v Must be 1 to 32 characters long. v The characters are limited to upper and lower-case alphabetic, numeric, and the special characters dash ( - ), underscore ( _ ), and period ( . ). Required when the -ctrl specifies copyglobal or passglobal. -sessions session_ID[,session_ID] | all | none (Optional) (Required when the -ctrl parameter specifies gmmasterl or gmsession.) Specifies one or more Global Mirror session IDs for the specified control. A Session ID is a hexadecimal number in the 01 - FF range. To specify a range of session IDs, separate the session IDs with a hyphen ( - ). You must separate multiple session IDs or ranges of session IDs with a comma between each ID or range of IDs. If you specify -sessions all, session IDs 01-FF are used. If you specify -sessions none, no sessions are used. resource_group_ID | (Optional) The resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. If the resource group ID is not specified, one will be assigned. If you use the dash (-), the specified value is read from standard input. The table below includes all of the valid combinations of manageresgrp command and parameter combinations and their effects on the DS8000. Commands with the same control and action can be combined.
manageresgrp command -ctrl copyglobal -action set -scope <RS> -ctrl gmmaster -action add -sessions <list> Effects All Copy Services tasks that establish, or re-establish, a relationship are subject to the specified resource scope <RS> Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror Master sessions for this resource. The specified list is added to any existing list for Global Mirror Master sessions. Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror Master sessions for this resource. The specified list is removed from any existing list for Global Mirror Master sessions. Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror Master sessions for this resource. The specified list replaces any existing list for Global Mirror Master sessions. Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror sessions for this resource. The specified list is added to any existing list for Global Mirror sessions.
328
Effects Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror sessions for this resource. The specified list is removed from any existing list for Global Mirror sessions. Specifies <list> of Global Mirror sessions that are allowed to be a Global Mirror sessions for this resource. The specified list replaces any existing list for Global Mirror sessions. All Copy Services tasks that establish, or re-establish, a relationship through a pass through device are subject to the specified resource scope <RS>
Notes: 1. When a Copy Services command is rejected as a result of a resource group policy attribute, the indicated error code or error message specifies which resource involved in the operation has caused the operation to be rejected. As such, the policy that cause the rejection would be in the resource group that is associated with that resource. For example, an Establish PPRC Pair (mkpprc) operation causes a PPRC to be established between a primary volume A and a secondary volume B. If the request is rejected with an error that indicates that the primary volume has rejected the operation because of a target resource scope error, then it is the resource group of volume A that contains the CS_GRS parameter that caused the operation to be rejected. 2. The combination of the CS_GRS and P_GRS controls allow the user to limit the set of resources that can be accessed by Copy Services operations issued to a given logical volume. A host (by volume group or other host dependent mechanism) or user ID (by URS) is limited to a specific set of connection logical volumes. The CS_GRS limits what target/secondaries the connection volume is allowed to have. The P_GRS limits what destination volumes can be accessed from either the connection volume or its associated secondary, when the command is issued to the secondary through the primary. For example a FICON host can only issue commands to volumes defined in the HCD of the host. If it issues a command to logical volume A that requests volumes A and B to establish a PPRC pair, the CS GRS in the RGs of volumes A and B are checked to see whether the relationship is allowed. If the relationship is established and the host then issues a command to the PPRC secondary that request that fixed block volumes C and D establish a flash copy pair, the PGRS of volume B is checked to see whether it allows volume B to passthrough to volume C, and then subsequently the CS_GRS in the RGs of volumes C and D are checked to see whether the relationship is allowed.
Example
Invoking the manageresgrp command
dscli> manageresgrp dev IBM.2107-75FA120 action set ctrl copyglobal scope Product_A RG1
mkresgrp
The mkresgrp command creates a resource group object on a storage image.
mkresgrp -dev storage_image_ID -label resource_group_label
329
-name
resource_group_name
resource_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -label resource_group_label (Required) Specifies the resource group label. The resource group label is 1 to 32 characters and is limited to upper and lower case alphabetic and numeric characters, and the special characters (-), (_), and (.). Resource group labels must be unique within the domain of the specified device. -name resource_group_name (Optional) Specifies the user assigned nickname for this resource group object. The maximum length is 64 single-byte or 32 double-byte characters. resource_group_ID | (Optional) The resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. If the resource group ID is not specified, one will be assigned. If you use the dash (-), the specified value is read from standard input.
Example
Invoking the mkresgrp command
dscli> mkresgrp dev IBM.2107-75FA120 label Product_A name A_Group RG1
rmresgrp
The rmresgrp command removes a resource group object on a storage image. Notes: 1. Resource Group 0 (zero) is predefined and cannot be created, deleted, or modified. By default, all resources belong to this group unless otherwise specified. 2. You cannot delete a resource group if there are resources still assigned to that resource group. For example, if a volume or LCU has a resource group ID of RG4, then you cannot delete RG4 until you remove those volumes or LCUs from the resource group.
rmresgrp -dev storage_image_ID -quiet resource_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. For example, IBM.2107-75FA120. The storage image ID is required if you do not specify a fully qualified encryption group ID, do not set the devid variable in your profile or through the
330
setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -quiet (Optional) Turns off the resource group removal confirmation prompt. resource_group_ID | (Required) An array of one or more resource group IDs or resource group ID ranges to be removed. A resource group ID range is defined by two resource group IDs that are separated by a hyphen. Multiple resource group IDs or resource group ID ranges must be separated with a blank space between each ID. The resource group ID begins with the letters RG and ends with a decimal number. If you use the dash (-), the specified value is read from standard input.
Example
Invoking the rmresgrp command
dscli> rmresgrp -quiet dev IBM.2107-75FA120 RG1
showresgrp
The showresgrp command displays detailed properties of a resource group.
showresgrp -dev storage_image_ID resource_group_ID "-"
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. resource_group_ID | (Optional) The resource group ID. The resource group ID begins with the letters RG and ends with a decimal number. If the resource group ID is not specified, one will be assigned. If you use the dash (-), the specified value is read from standard input.
Example
For this command and all other DS CLI show commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. Invoking the showresgrp command
dscli> showresgrp RG1
331
Attribute Name State Label CS_Global _RS Passthru_ Global_RS GM_sessions _allowed GM_masters _allowed
CS_Global_RS Specifies all of the Copy Services requests that establish or re-establish a relationship, and are subject to this resource scope including FlashCopy and PPRC relationships. Passthru_Global_RS Specifies all of the Copy Services requests that are issued though a pass-through logical volume are treated as a relationship between the pass-through logical volume and source logical volume and are subject to this resource scope. GM_Sessions_Allowed Specifies an array of Global Mirror session IDs that are allowed to be used for the volumes in this resource. GM_Masters_Allowed Specifies an array of Global Mirror session IDs that are allowed to be used as a master session for volumes in this resource.
332
FlashCopy commands
This section contains commands that are used to configure FlashCopy relationships and to display FlashCopy information. The following FlashCopy commands are available: commitflash Completes a partially formed Global Mirror consistency group. It is used as part of the recovery from a disaster. resyncflash Creates a point-in-time copy of an existing FlashCopy pair that was established with the -record and -persist parameters. The resyncflash command only copies the parts of the volume that have changed since the last point in time copy. lsflash Generates a report that displays a list of FlashCopy relationships and the status information for each FlashCopy relationship in the list. mkflash Initiates a point-in-time copy from source volumes to target volumes. reverseflash Reverses the FlashCopy relationship. revertflash Restores the former Global Mirror consistency group from one that is currently forming. It is used as part of the recovery from a disaster. rmflash Removes a relationship between FlashCopy volume pairs. unfreezeflash Resets a FlashCopy consistency group that was previously established with the -freeze parameter when the mkflash or resyncflash commands were issued. setflashrevertible Modifies a FlashCopy volume pair that is part of a Global Mirror relationship to revertible. The revertible feature allows data to be committed to the target to form a new consistency group, or restored back to the last consistency group.
commitflash
The commitflash command is used as part of the recovery from a disaster scenario to complete a partially formed Global Mirror consistency group.
commitflash -dev source_volume_ID . . . " - " storage_image_ID -seqnum flash_sequence_num
Parameters
The following transactions must be completed before you can issue the commitflash command: 1. Issue the mkflash command with the -record and -persist parameters specified to establish the FlashCopy volume pair relationship. 2. Issue the setflashrevertible command on the FlashCopy volume pair.
333
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all source volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -seqnum flash_sequence_number (Optional) When a FlashCopy sequence number is specified, the commit operation is performed only on those relationships that are associated with the specified number. This parameter is not supported for machine type 2105. Example: 0010 source_volume_ID . . . | (Required) Specifies the source volumes for which FlashCopy relationships are to be committed. The chosen FlashCopy pair is the one established or modified with the -record parameter. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if either the -dev parameter is specified or you specify a value for the devid variable in your profile file. You must separate multiple source volume IDs with spaces. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified volume ID: IBM.2107-75FA120/0001 Example of a shortened version: 0001 Example of multiple IDs: 0001 0003 0008
Example
Invoking the commitflash command
dscli> commitflash -dev IBM.2107-75FA120 0100
resyncflash
The resyncflash command is a point-in-time copy of an existing FlashCopy pair that was established with the -record and -persist parameters. The resyncflash command only copies the parts of the volume that have changed since the last point-in-time copy.
334
-freeze
-record
-persist
-tgtse
-cp -nocp
-seqnum
flash_sequence_num
-pmir
no required preferred
Parameters
When a FlashCopy pair is established with the -record and -persist parameters, the pair initially synchronizes and a record of all host write operations to the source is maintained in the source volumes. When the resyncflash command is issued on the FlashCopy pair, the new data that is written to the source is copied to the target. The parameters you specify in this command replace the parameters you previously specified for the existing relationship. To keep the -record and -persist parameters, you must specify these parameters in the resyncflash command. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -tgtpprc (Optional) Allows the FlashCopy target volume to be a remote mirror and copy source volume. -tgtoffline (Optional) Rejects the resyncflash command if the target volume is online for host system access. This parameter applies only to count key data (CKD) volumes. -tgtinhibit (Optional) Prevents host system write operations to the target volume while the FlashCopy relationship exists. -freeze (Optional) Starts the queue full condition for the source volume. During the queue full condition, the source volume reports a status of long busy. All writes to the source volume are queued by the host and are written after the queue full condition is reset. The queue full condition is reset by an extended long busy timeout condition. The timeout condition affects all FlashCopy source volumes that are contained within a respective logical subsystem and that are established or modified with this parameter. Note: Use the chlss and the chlcu commands to modify the extended long busy timeout setting. -record (Optional) Records the tracks that have changed on both volumes within a FlashCopy pair. Select this parameter when you establish an initial FlashCopy volume pair that you want to use with the resyncflash command. The -persist parameter is automatically selected when this parameter is selected.
335
-persist (Optional) Retains the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmflash command. This parameter is automatically selected when the -record parameter is selected. Select this parameter along with the -record parameter if you want to use this volume pair with the resyncflash, reverseflash or setflashrevertible commands. -tgtse (Optional - DS8000 only) Specifies that the target volume that you are designating for a FlashCopy relationship might be a space-efficient logical volume. An error message is generated if the target volume that you are using to create the FlashCopy relationship is a space-efficient volume and you do not specify this parameter. -nocp (Optional) Inhibits a background copy. Data is copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmflash command or until all tracks on the source volume are modified. When the -tgtse parameter is specified and neither the -cp nor the -nocp parameters are specified, the no background copy behavior is the default. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -cp (Optional) Starts a background copy. When the -tgtse parameter is not specified and neither the -cp nor the -nocp parameters are specified, the background copy behavior is the default. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -seqnum flash_sequence_num (Optional) This parameter is not supported for machine type 2105. Associates the FlashCopy relationships that are established with the specified sequence number. You can use this sequence number as an identifier for a relationship or group of relationships. An example sequence number is 00010. -pmir no | required | preferred (DS8000 only) Specifies the IBM Remote Pair Copy option that you want to use. The IBM Remote Pair Copy option, sometimes called preserve mirror, preserves synchronous Metro Mirror pairs when the FlashCopy source and target volumes are both Metro Mirror primary volumes and both Metro Mirror secondary volumes on the same storage unit. The FlashCopy operation is performed on both the local site and the remote site. no FlashCopy operations are not performed on the remote site. If the target volume is a Metro Mirror primary volume, the remote copy might temporarily change to the duplex pending state. no is the default if the -pmir parameter is not specified.
required FlashCopy operations do not change the state of the Metro Mirror primary volume pair to duplex pending. Both the source Metro Mirror volume pair and the target Metro Mirror volume pair must be in the full duplex state. preferred Uses the IBM Remote Pair Copy option for FlashCopy operations when possible. The IBM Remote Pair Copy option cannot be used if the configuration is not correct or the state of the volume is not supported with this function. source_volume_ID:target_volume_ID . . . | (Required) Increments a FlashCopy relationship for the source and target volume pairs with the specified IDs . This parameter accepts fully qualified volume IDs, which includes storage image IDs,
336
or a shortened version without storage image IDs if the -dev parameter is specified or you specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, an example of a fully qualified FlashCopy pair ID is IBM.2107-75FA120/0001:IBM.210775FA120/0004 An example of a shortened version is 0001:0004 An example of multiple pairs is 0001:0004 0003:00FF 0008:000C
Example
An invocation example
dscli> resyncflash dev IBM.2107-75FA120 -freeze 0100:0200
lsflash
The lsflash command displays a list of FlashCopy relationships and status information for each FlashCopy relationship in the list. |
lsflash -dev storage_image_ID -s -l -activecp -dataset -record
-persist
-revertible
-cp
-tgtse
-state
-seqnum
flash_sequence_num
-retry
count[,interval]
337
. . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -s (Optional) Displays FlashCopy pair IDs. You cannot use the -s and the -l parameters together. -l (Optional) Displays the default output plus additional attributes that are identified as long output. You cannot use the -s and the -l parameters together. -activecp (Optional) Displays the FlashCopy relationships where their background copy process is active. Note: The background copy process might be inactive for a while before it starts. | -dataset | (Optional) Displays the volumes that are participating in the Dataset FlashCopy relationships. -record (Optional) Displays the FlashCopy relationships that were established with the -record parameter. -persist (Optional) Displays the FlashCopy relationships that were established with the -persist parameter. -revertible (Optional) Displays the FlashCopy relationships that were established with the -revertible parameter. -cp (Optional) Displays the FlashCopy relationships that were established with the -cp parameter. -tgtse (Optional - DS8000 only) Displays the FlashCopy relationships that have a space-efficient target. -state valid | invalid | validation-required |volume-inaccessible | tgt-failed | not-valid (Optional) Displays the FlashCopy relationships that are identified by the specific state. Note: When you specify not-valid, all FlashCopy relationships that do not meet the requirements for the valid state are displayed. -seqnum flash_sequence_number (Optional) Displays the FlashCopy relationships that are associated with the specified sequence number. The default is 0000. Note: This parameter is not supported for machine type 2105. -retry count[,interval] (Optional) Specifies how you want the system to handle a validation-required state. The system currently handles a validation-required state as follows:
338
v If there are one or more FlashCopy relationships, an immediate retry is initiated. In most cases, the reasons for the validation-required state are cleared by the time that the retry is processed and normal processing continues. v If the validation-required state still exists after the first retry, the system initiates five wait and retry cycles with a delay of 5 seconds between each cycle. At any time during these cycles, if the reasons for the validation-required state are cleared, normal processing continues. You can change how the system handles a validation-required state as follows: v Set the number of retries (count) to 0. When you set the number of retries to 0, it prevents the system from attempting any retries. v Set the number of retries to 1. The system performs an immediate retry if there are one or more FlashCopy relationships in the validation-required state. The 5-second delay is not initiated. v Set the number of retries to N, with N greater than 1. The system performs an immediate retry if there are one or more FlashCopy relationships in the validation-required state, followed by at least one wait and retry loop. The default for N is 6. You can change the length of the 5-second default wait delay using the optional interval value. source_volume_ID:target_volume_ID | volume_ID . . . | (Required) Displays the FlashCopy relationships for the source and target volume pairs with the specified IDs, or displays the FlashCopy relationships for a single volume ID if the volume ID is specified. This parameter accepts fully qualified volume IDs, which includes the storage image IDs, or a shortened version without storage image IDs, if the -dev parameter is specified or you can specify a value for the devid variable in your profile file. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. You must separate multiple IDs with spaces. You can specify FlashCopy pair IDs and a range of FlashCopy pair IDs, or you can specify volume IDs and a range of volume IDs. You cannot specify a combination of FlashCopy pair IDs and volumes IDs. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsflash command using the -l parameter.
Chapter 4. CLI commands
339
SourceWriteEnabled Enabled
TargetWriteEnabled Disabled
BackgroundCopy Disabled
OutOfSyncTracks 0
DateCreated 10/01 /2007 02:20:00 10/01 /2007 02:20:00 10/01 /2007 02:20:00 10/01 /2007 02:20:00
DateSynced 10/01 /2007 02:23:47 10/01 /2007 02:23:47 10/01 /2007 02:23:47 10/01 /2007 02:23:47
State Valid
isTgtSE TSE
Pmir No
Enabled
Disabled
Disabled
Valid
TSE
No
Enabled
Disabled
Disabled
Valid
ESE
No
Enabled
Disabled
Disabled
Valid
ESE
No
340
Persistent Specifies whether this FlashCopy relationship was established with the persistent option. Revertible Specifies whether this FlashCopy relationship was established with the revertible option. SourceWriteEnabled Specifies whether this FlashCopy relationship was established with the allow source writes option. No value is displayed in the DS6000 models. TargetWriteEnabled Specifies whether this FlashCopy relationship was established with the allow target writes option. No value is displayed in the DS6000 models. BackgroundCopy Specifies whether this FlashCopy relationship was established with the run background copy option. No value is displayed in the DS6000 models. OutOfSyncTracks Specifies the number of tracks that are not synchronized for this FlashCopy relationship. The maximum value that can be displayed is dependent on the source volume size. A dash (-) is displayed when the track counter is not available. No value is displayed in the DS6000 models. DateCreated Specifies the date and the time that the FlashCopy relationship was established. No value is displayed in the DS6000 models. DateSynced Specifies the date and time that FlashCopy relationship was synchronized, or specifies " - " if the relationship is not synchronized. No value is displayed in the DS6000 models. State Specifies the state of the FlashCopy relationships. One of the following values is displayed for each FlashCopy relationship: Note: When a query indicates any state other than valid, the only information that is displayed on the report is the FlashCopy pair ID and the state condition. The rest of the information columns are displayed with a " - " value. Valid Indicates that the FlashCopy relationship is in a normal state, and that it has been queried successfully.
Validation Required Indicates that the FlashCopy relationship cannot be queried. The reason that the query is blocked is only temporary. If you issue a new query within several seconds, the problem no longer exists. Tgt Failed Indicates that the FlashCopy relationship is in an error state. The point-in-time copy is lost, and the FlashCopy relationship must be withdrawn. You must issue the rmflash command to remove the FlashCopy relationship. Volume Inaccessible Indicates that the volume cannot be accessed and that the query has failed. When this state is displayed, it generally means that the volume is in a fenced condition. Invalid Indicates that a general internal error occurred when the query was processed. | | | Dataset Indicates that the source volume is participating as a source or a target in a dataset, or extent level, FlashCopy relationship.
341
| | isTgtSE
Note: For dataset FlashCopy relationships, a dash (-) will be listed for all of the fields except the ID and the State. Indicates whether this FlashCopy relationship has a space-efficient target. No TSE ESE Indicates that the target is not space-efficient. Indicates that the target is a track space-efficient volume. Indicates that the target is an extent space-efficient (ESE) volume. ESE volumes are used for IBM System Storage DS8000 Thin Provisioning.
Unknown Indicates that the space allocation method of the target is not known. Pmir (DS8000 only) The IBM Remote Pair Copy option preserves synchronous Metro Mirror pairs when the FlashCopy source volume and target volume are Metro Mirror primary volumes and the Metro Mirror secondary volumes are on the same storage unit. The FlashCopy operation is performed on both the local site and the remote site. No Indicates that the IBM Remote Pair Copy option was not specified.
Preferred Indicates that the IBM Remote Pair Copy option was specified. If the target is a Metro Mirror primary, then the FlashCopy function can preserve the Full Duplex mode of the target Metro Mirror relationship, if it is possible. If the IBM Remote Pair Copy function is not possible, you can use processing defined for the IBM Remote Pair Copy option of "No". Required Indicates that the IBM Remote Pair Copy option was specified. If the target is a Metro Mirror primary, then the FlashCopy function is required to preserve the Full Duplex mode of the target Metro Mirror relationship. Processing can fail if the IBM Remote Pair Copy function is not possible. Remote Indicates a remote FlashCopy relationship that was initiated by another FlashCopy established at the Metro Mirror primary site with an IBM Remote Pair Copy option of preferred' or required'. Unknown The IBM Remote Pair Copy relationship type cannot be determined. The source and target were created with IBM Remote Pair Copy, but they are no longer both Metro Mirror primaries or both Metro Mirror secondaries.
mkflash
The mkflash command starts a point-in-time copy from source volumes to target volumes.
mkflash -dev storage_image_ID -tgtpprc -tgtoffline -tgtinhibit
-freeze
-record
-persist
-tgtse
-cp -nocp
-wait
-seqnum
flash_sequence_num
-pmir
no required preferred
342
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For example, DS8000 models use IBM.2107-75FA120 -tgtpprc (Optional) Allows the FlashCopy target volume to be a remote mirror and copy source volume. -tgtoffline (Optional) Rejects the mkflash command if the target volume is online for host system access. This parameter applies only to count key data (CKD) volumes. -tgtinhibit (Optional) Prevents host system write operations to the target volume while the FlashCopy relationship exists. -freeze (Optional) Starts the queue full condition for the source volume. During the queue full condition, the source volume reports a status of long busy. All writes to the source volume are queued by the host and are written after the queue full condition is reset. The queue full condition is reset by an extended long busy timeout condition. The timeout condition affects all FlashCopy source volumes that are contained within a respective logical subsystem and that are established or modified with this parameter. Note: Use the chlss and the chlcu commands to modify the extended long busy timeout setting. -record (Optional) Records the tracks that have changed on both volumes within a FlashCopy pair. Select this parameter when you establish an initial FlashCopy volume pair that you want to use with the resyncflash command. The -persist parameter is automatically selected when this parameter is selected. -persist (Optional) Retains the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmflash command. This parameter is automatically selected when the -record parameter is selected. Select this parameter along with the -record parameter if you want to use this volume pair with the resyncflash, reverseflash or setflashrevertible commands. -tgtse (Optional - DS8000 only) Specifies that the target volume that you are designating for a FlashCopy relationship might be a space-efficient logical volume. An error message is generated if the target volume that you are using to create the FlashCopy relationship is a space-efficient volume and you do not specify this parameter. -nocp (Optional) Inhibits a background copy. Data is copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmflash command or until all tracks on the source volume are modified.
Chapter 4. CLI commands
343
When the -tgtse parameter is specified and neither the -cp nor the -nocp parameters are specified, the no background copy behavior is the default. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -cp (Optional) Starts a background copy. When the -tgtse parameter is not specified and neither the -cp nor the -nocp parameters are specified, the background copy behavior is the default. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -wait (Optional - DS8000 only) Delays the command response until the background copy process is complete. Notes: 1. You cannot use the -wait parameter with either the -persist or the -nocp parameters. 2. You cannot use the -wait parameter when -tgtse is specified and neither the -cp nor the -nocp parameters are specified. No background copy behavior is the default. -seqnum flash_sequence_num (Optional) This parameter is not supported for machine type 2105. Associates the FlashCopy relationships that are established with the specified sequence number. You can use this sequence number as an identifier for a relationship or group of relationships. An example sequence number is 00010. -pmir no | required | preferred (DS8000 only) Specifies the IBM Remote Pair Copy option that you want to use. The IBM Remote Pair Copy option, sometimes called preserve mirror, preserves synchronous Metro Mirror pairs when the FlashCopy source volume and target volume are Metro Mirror primary volumes and the Metro Mirror secondary volumes are on the same storage unit. The FlashCopy operation is performed on both the local site and the remote site. no FlashCopy operations are not performed on the remote site. If the target volume is a Metro Mirror primary volume, the remote copy might temporarily change to the duplex pending state. The default is no if the -pmir parameter is not specified.
required FlashCopy operations do not change the state of the Metro Mirror primary volume pair to duplex pending. Both the source Metro Mirror volume pair and the target Metro Mirror volume pair must be in the full duplex state. preferred Uses the IBM Remote Pair Copy option for FlashCopy operations when possible. The IBM Remote Pair Copy option cannot be used if the configuration is not correct or the state of the volume is not supported with this function. source_volume_ID:target_volume_ID . . . | (Required) Establishes a FlashCopy relationship for the source and target volume pairs with the specified IDs. This parameter accepts fully qualified volume IDs, which consist of storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You can also specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.
344
Note: You might receive an error message that indicates the number of relationships has been exceeded or that an initial volume format is in progress. This means that the FlashCopy relationship cannot be established because the maximum number of relationships have already been established. Or, the volume was recently created and is still being initialized to support FlashCopy processing. You can issue the mkflash command to establish the FlashCopy relationship after the initial volume format process is complete. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0 - F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, an example of a fully qualified FlashCopy pair ID is IBM.2107-75FA120/0001:IBM.210775FA120/0004 An example of a shortened version is 0001:0004 An example of multiple pairs is 0001:0004 0003:00FF 0008:000C
Example
An invocation example
dscli> mkflash -dev IBM.2107-75FA120 -freeze 0100:0200
reverseflash
The reverseflash command reverses the FlashCopy relationship.
reverseflash -dev storage_image_ID -record -persist -fast
-tgtpprc
-tgtoffline
-tgtinhibit
-tgtse
-cp -nocp
-seqnum
flash_sequence_num
-pmir
no required preferred
345
Parameters
You can reverse the direction of a FlashCopy relationship, where the volume that was previously defined as the target becomes the source for the volume that was previously defined as the source. The data that has changed is copied to the volume that was previously defined as the source. For example, you create a FlashCopy relationship between source volume A and target volume B. Data loss occurs on source volume A. To keep applications running, you can reverse the FlashCopy relationship so that volume B is copied to volume A. After the reversal takes place, ensure that you designate this new relationship when you issue any future commands. Failure to designate this reversed relationship can produce unexpected results. For example, you use the reverseflash command to reverse the relationship of source volume 1600 and target volume 1800. The source volume then becomes 1800 and the target volume becomes 1600. All queries and future processing on this relationship must show volume 1800 as the source and volume 1600 as the target. The following list defines the parameters that are associated with the reverseflash command: -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For example, DS8000 models use IBM.2107-75FA120 -record (Optional) Records the tracks that have changed on both volumes within a FlashCopy pair. Select this parameter when you establish an initial FlashCopy volume pair that you want to use with the resyncflash command. The -persist parameter is automatically selected when this parameter is selected. -persist (Optional) Retains the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmflash command. This parameter is automatically selected when the -record parameter is selected. Select this parameter along with the -record parameter if you want to use this volume pair with the resyncflash, reverseflash or setflashrevertible commands. -fast (Optional) Specify this parameter when you want to issue the reverseflash command before the background copy completes. Note: To use the fast reverse function, the relationship must be set to Target write inhibit. The fast reverse processing function is intended for use as part of Global Mirror recovery process. At the end of this operation, the original FlashCopy target volume is not usable. Normally, after this command completes the background copy, the new FlashCopy target volume is used as the FlashCopy source volume to restore the original FlashCopy target volume. -tgtpprc (Optional) Allows the FlashCopy target volume to be a Remote Mirror and Copy source volume. -tgtoffline (Optional) Rejects the reverseflash command if the target volume is online for host system access. This parameter applies only to count key data (CKD) volumes. -tgtinhibit (Optional) Prevents host system write operations to the target while the FlashCopy relationship exists.
346
-tgtse (Optional - DS8000 only) Specifies that the target volume that you are designating for a FlashCopy relationship might be a space-efficient logical volume. An error message is generated if the target volume that you are using to create the FlashCopy relationship is a space-efficient volume and you do not specify this parameter. -nocp (Optional) Inhibits a background copy. Data is copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmflash command or until all tracks on the source volume are modified. If neither the -cp nor the -nocp parameter are specified, then the default background copy behavior is determined by the -tgtse and -fast parameters. If the -tgtse parameter is specified, and the -fast parameter is not specified, then the default behavior is to not perform a background copy. Otherwise, the default behavior is to perform a background copy. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -cp (Optional) Starts a background copy. Data is copied from the source volume to the target volume as a background task and does not require any source volume modifications to trigger the copy. If neither the -cp nor the -nocp parameter are specified, then the default background copy behavior is determined by the -tgtse and -fast parameters. If the -tgtse parameter is specified, and the -fast parameter is not specified, then the default behavior is to not perform a background copy. Otherwise, the default behavior is to perform a background copy. Note: You cannot use the -nocp parameter with the -cp parameter in the same command. -seqnum flash_sequence_num (Optional) This parameter is not supported for machine type 2105. Associates the FlashCopy relationships that are established with the specified sequence number. You can use this sequence number as an identifier for a relationship or group of relationships. An example sequence number is 00010. -pmir no | required | preferred (DS8000 only) Specifies the IBM Remote Pair Copy option that you want to use. The IBM Remote Pair Copy option, sometimes called preserve mirror, preserves synchronous Metro Mirror pairs when the FlashCopy source volume and target volume are Metro Mirror primary volumes and the Metro Mirror secondary volumes are on the same storage unit. The FlashCopy operation is performed on both the local site and the remote site. no FlashCopy operations are not performed on the remote site. If the target volume is a Metro Mirror primary volume, the remote copy might temporarily change to the duplex pending state. The default is no if the -pmir parameter is not specified.
required FlashCopy operations do not change the state of the Metro Mirror primary volume pair to duplex pending. Both the source Metro Mirror volume pair and the target Metro Mirror volume pair must be in the full duplex state. preferred Uses the IBM Remote Pair Copy option for FlashCopy operations when possible. The IBM Remote Pair Copy option cannot be used if the configuration is not correct or the state of the volume is not supported with this function. source_volume_ID:target_volume_ID . . . | (Required) Establishes a FlashCopy relationship for the source and target volume pairs with the specified IDs. This parameter accepts fully qualified volume IDs, which consist of storage image IDs
347
or a shortened version without storage image IDs, if the -dev parameter is specified. You can also specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0 - F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, an example of a fully qualified FlashCopy pair ID is IBM.2107-75FA120/0001:IBM.210775FA120/0004 An example of a shortened version is 0001:0004 An example of multiple pairs is 0001:0004 0003:00FF 0008:000C
Example
An invocation example
dscli> reverseflash -dev IBM.2107-75FA120 0100:0200
revertflash
The revertflash command is used as part of the recovery from a disaster scenario to rollback a Global Mirror consistency group that is in the process of forming. The former Global Mirror consistency group is restored.
revertflash -dev SourceVolume_ID . . . " - " storage_image_ID -seqnum flash_sequence_num
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source
348
volume, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. DS8000 example: IBM.2107-75FA120 DS6000 example: IBM.1750-685FA120 -seqnum flash_sequence_num (Optional) Specifies the FlashCopy sequence number. When this number is specified, the revertflash operation is performed only on those relations associated with the specified number. This parameter is not supported for machine type 2105. Example: 0010 SourceVolumeID . . . | (Required) Specifies the source volume ID for which the FlashCopy relationship is to be reverted. The chosen FlashCopy pair is the one established or modified with the -record parameter. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified or you specify a value for the devid variable in your profile file. You must separate multiple source volume IDs with spaces. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0 - F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a fully qualified volume ID: IBM.2107-75FA120/0001 Example of a shortened version: 0001 Example of multiple IDs: 0001 0003 0008
Example
Invoking the revertflash command
dscli> revertflash -dev IBM.2107-75FA120 0100
rmflash
The rmflash command removes a relationship between FlashCopy volume pairs.
rmflash -dev storage_image_ID -quiet -tgtonly -tgtreleasespace
349
-cp
-cprm
-resettgtinhibit
-wait
-seqnum
flash_sequence_number
Parameters
Notes: 1. Invoking this command with the -cp parameter on a FlashCopy relationship that was previously marked with the -persist parameter does not remove the relationship. Instead, the source data is copied to the target. 2. Invoking this command with the -resettgtinhibit parameter does not withdraw the relationship, but resets the -tgtinhibit parameter if it was previously set. 3. All settings apply to all specified FlashCopy pairs. 4. Do not use the -wait parameter on persistent relations. 5. The -seqnum parameter is not supported for a 2105 machine type. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. DS8000 example: IBM.2107-75FA120 DS6000 example: IBM.1750-68FA120 -quiet (Optional) Turns off the FlashCopy pair removal confirmation prompt. -tgtonly (Optional) Specifies the target volume of the FlashCopy pair to remove the relationship. In addition, the Copy Indicator for the target volume is reset. Note: If you use the -tgtonly parameter on CKD volumes, any data set level relationships created by a S/390 host are removed from the specified target volume. -tgtreleasespace (Optional - DS8000 only) Specifies that you want the system to release the space that has been allocated to a space-efficient logical target volume. -cp (Optional) Specifies that the FlashCopy relationship is to be changed from No Copy to Copy and that the remaining source volume tracks be copied to the target volume. The relationship is removed when all the data is copied unless the relationship is persistent. When this parameter is specified, the copy takes place for all volume pairs where the source volume ID is identical to the source volume that is specified in the command. -cprm (Optional) Specifies a change to a FlashCopy relationship from No Copy to Copy, and copies the remaining source volume tracks to the target volume. The relationship is removed after all of the data is copied. If the FlashCopy relationship is a remote relationship established automatically by another establish FlashCopy with the preserve mirror option set to "preferred" or "required", then the rmflash command fails if you do not use the -cprm option.
350
For non-persistent relationships, a Background Copy is initiated for all of the existing relationships within the specified source and target volumes. The relationships are terminated after the background copy is completed. For persistent relationships, all of the existing relationships within the specified source and target volumes change to non-persistent relationships, and then a Background Copy is initiated. The relationships are terminated after the background copy is completed. -resettgtinhibit (Optional) Specifies that the parameter that does not allow host system write operations to the target ID while the FlashCopy relationship exists is to be reset, in case it was previously set. Note: Specifying this parameter in itself does not cause the FlashCopy relationship to be withdrawn. -wait (Optional) Specifies that the command response is to be delayed until the background copy process completes. Notes: 1. Only pairs of source and target volume IDs are allowed when you use the -wait parameter.
2. The -cp parameter must be used with the -wait parameter. 3. Do not use the -wait parameter on relationships that are marked -persist, an error results from this usage. -seqnum flash_sequence_num (Optional) Specifies the FlashCopy sequence number. When this number is specified, the rmflash operation is performed only on those relationships associated with the specified number. Example: 0010 Note: This parameter is not supported for a 2105 machine type. SourceVolumeID:TargetVolumeID . . . | (Required) Specifies the source and target volume pairs for which the FlashCopy relationships are removed. This parameter accepts a fully qualified volume ID, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified or you specify a value for the devid variable in your profile file. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. When the -tgtonly parameter is specified, you must enter volume IDs. Volume pair IDs are not valid with the -tgtonly parameter. The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. However, you cannot use this feature if you are using the DS CLI interactive command mode.
Chapter 4. CLI commands
351
Example of a fully qualified FlashCopy pair ID (for DS8000): IBM.2107-75FA120/0001:IBM.210775FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
Invoking the rmflash command
dscli> rmflash -dev IBM.2107-75FA120 -tgtreleasespace 0100:0200
unfreezeflash
The unfreezeflash command resets a FlashCopy consistency group that was previously established with the -freeze parameter when the mkflash or resyncflash commands were issued.
unfreezeflash -dev storage_image_ID " - " source_LSS_ID . . .
Parameters
-dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. source_LSS_ID . . . | (Required) Specifies that the FlashCopy consistency group be reset for the designated source LSS IDs. The parameter also accepts fully qualified LSS IDs, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified or you specify a value for the devid variable in your profile file. The fully qualified LSS ID format is storage_image_ID/XX. The DS8000 value for the XX is 00 - FE and the DS6000 value is 00 - 1F. If you use the dash (-), the specified value is read from standard input. Note: You cannot use the dash (-) while you are in the DS CLI interactive command mode. DS8000 example of a fully qualified LSS ID: IBM.2107-75FA120/00 DS6000 example of a fully qualified LSS ID: IBM.1750-68FA120/00 Example of a shortened version: 00 Example of multiple IDs: 10 20 30
Example
Invoking the unfreezeflash command
dscli> unfreezeflash -dev IBM.2107-75FA120 01
352
setflashrevertible
The setflashrevertible command modifies a FlashCopy volume pair that is part of a FlashCopy relationship to revertible. The revertible feature allows data to be committed to the target to form a new consistency group or to revert to the last consistency group. This command must be run before the FlashCopy pair can be committed or reverted.
setflashrevertible -dev storage_image_ID -tgtoffline -tgtse
Parameters
Note: The -nocp, -record, -persist, and -tgtinhibit (target inhibit) parameters are included automatically when this command processes. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for all source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 For DS6000, example: IBM.1750-68FA120 -tgtoffline (Optional) Causes an establish FlashCopy volume pair command to be rejected if the target volume is online for host system access. This parameter applies only to CKD volumes. -tgtse (Optional - DS8000 only) Specifies that the target volume that is part of the FlashCopy relationship that you are modifying to be designated as revertible might be a space-efficient logical volume. An error message is generated if the target volume is a space-efficient volume and you do not specify this parameter. -seqnum flash_sequence_num (Optional) Associates the FlashCopy relationships that are changed with the specified sequence number. Only the relationships that are successfully modified by the command are assigned the specified sequence number, leaving the ones that fail with the previous number (if previously specified). This parameter is not supported for machine type 2105. Example: 0010 source_volume_ID:target_volume_ID . . . | (Required) Modifies FlashCopy relationships for the source and target volume pairs with the IDs specified. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a
353
shortened version without storage image IDs, if the -dev parameter is specified. Or, you can specify a value for the devid variable that resides in your profile file. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.2107-75FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
Invoking the setflashrevertible command
dscli> setflashrevertible -dev IBM.2107-75FA120 -tgtse 0100:0200
354
lsremoteflash Generates a report that displays a list of FlashCopy relationships and the status information for each FlashCopy relationship in the list. mkremoteflash Initiates a remote point-in-time copy from source volumes to target volumes through a remote mirror and copy relationship. revertremoteflash Restores data on the source volume to its most recent consistency formation. rmremoteflash Removes a relationship between remote FlashCopy volume pairs. setremoteflashrevertible Modifies the specified remote FlashCopy volume pair that is part of a Global Mirror relationship to a revertible state. This command must be run before the FlashCopy pair can be committed or reverted.
commitremoteflash
The commitremoteflash command sends data to a target volume to form a consistency between the remote source and target FlashCopy pair.
commitremoteflash -dev storage_image_ID SourceVolumeID -seqnum flash_sequence_num -srcss SS_ID " - " . . . -conduit LSS_ID
Parameters
Notes: 1. Establish the pair by issuing either the mkflash or mkremoteflash command with the -record and -persist parameters. 2. Issue either the setflashrevertible or setremoteflashrevertible command against the pair. Only after you have taken these two steps can you issue the commitremoteflash command. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a means for communicating with the remote storage image. The source volume IDs that are specified in the SourceVolumeID parameter must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume. When this parameter is used, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX. The DS8000 value for the XX is 00 - FE and the DS6000 value is 00 1F.
355
-seqnum flash_sequence_number (Optional) Specifies that the commit operation is performed only on those source volumes that are associated with the specified sequence number. This parameter is not supported for machine type 2105. Example: 0010 -srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. When this parameter is used, all source volumes must be within the same logical subsystem. This parameter is required only for IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: FF10 SourceVolumeID . . . | (Required) Commits remote FlashCopy relationships for the source volumes with the specified IDs. The chosen pair is the one with the enabled -record parameter. You must separate multiple source volume IDs with spaces. This parameter accepts fully qualified volume IDs, which includes the storage image ID, or a shortened version without the storage image ID if either the -dev parameter is specified, or you can specify a value for the devid variable in your profile file. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified volume ID: IBM.2107-75FA120/0001 Example of a shortened version: 0001 Example of IDs: 0001 0003 0008
Example
Invoking the commitremoteflash command
dscli> commitremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100
resyncremoteflash
The resyncremoteflash command (formerly called the incremoteflash command and associated with the incremental FlashCopy process) increments an existing remote FlashCopy pair that has been established with the -record and -persist parameters.
356
-conduit
LSS_ID -record
-persist
-freeze
-tgtpprc
-tgtoffline
-tgtinhibit
-tgtse
-cp -nocp
-seqnum
flash_sequence_num
-srcss
SS_ID
Parameters
Note: When a pair is established with the -record and -persist parameters, the pair initially synchronizes and then a record of all data that is written from the host to the source is maintained in the source volumes. When the resyncremoteflash command is issued on the pair, the new data that is written to the source is copied to the target. The specified parameters in this command replace the parameters in the existing relationship. To keep the initial -record and -persist parameter values, the -record and -persist parameters must be specified using the resyncremoteflash command. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a means for communicating with the remote storage image. The source volume IDs that are specified in the SourceVolumeID:TargetVolumeID parameter, must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume. When you use this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE, for the DS8000, and 00 - 1F, for the DS6000. For DS8000, example: IBM.2107-75FA120/00 -record (Optional) Specifies that the changed tracks on both volumes within a FlashCopy pair are to be recorded. Select this parameter if you intend to use the resyncremoteflash command again with this pair. The -persist parameter is automatically set in the code when the -record parameter is specified. -persist (Optional) Specifies that the FlashCopy relationship is to be retained after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmremoteflash command. This parameter is automatically set in the code when the -record parameter is specified. Specify this parameter along with the -record parameter if you intend to use this volume pair with the resyncremoteflash, reverseremoteflash, or setremoteflashrevertible commands.
Chapter 4. CLI commands
357
-freeze (Optional) Specifies the Freeze Consistency Group condition. This option causes the source volume to be busy (Queue Full status on Open Systems) to all host I/O operations until a FlashCopy Consistency Group Created command is received. All writes to the source volume are queued by the host and are written after the Consistency Group Created command is complete. During the busy condition, the source volume reports Queue Full for fixed block volumes and busy status for CKD volumes. The busy condition can also be reset by an extended long busy timeout (default 120 seconds). The timeout condition affects all FlashCopy source volumes that are contained within a respective logical subsystem and that are established or modified with the -freeze parameter. Note: This parameter is used with other processing steps for purposes such as backups, testing, or recovery solutions. The use of this parameter ensures that volumes on the target LSSs are consistent with the source LSSs volumes. -tgtpprc (Optional) Allows the FlashCopy target volume to be a remote mirror and copy source volume. -tgtoffline (Optional) Causes the resyncremoteflash command to be rejected if the target volume is online for host system access. Note: This parameter applies only to count key data volumes. -tgtinhibit (Optional) Prevents host system write operations to the target while the FlashCopy relationship exists. -tgtse (Optional - DS8000 only) Specifies that the target volume might be a space-efficient logical volume. An error message is generated if the target volume is a space-efficient volume and you do not specify this parameter. -nocp (Optional - DS8000 only) Inhibits background copy. Data is copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmflash command, or until all tracks on the source volume are modified. When -tgtse is specified and the -cp and -nocp parameters are not specified, the no background copy behavior is the default. You cannot use the -nocp parameter with the -cp parameter in the same command. -cp (Optional - DS8000 only) Specifies that a background copy is to be initiated. When -tgtse is not specified and the -cp and -nocp parameters are not specified, the background copy behavior is the default. You cannot use the -cp parameter with the -nocp parameter in the same command. -seqnum flash_sequence_num (Optional) Associates the FlashCopy relationships that are established with the specified sequence number. You can use this sequence number as an identifier for a relationship or group of relationships. Only the relationships that are modified successfully by the resyncremoteflash command are assigned the specified sequence number, leaving the ones that fail with the previous one (if they were previously specified). This parameter is not supported for machine type 2105. Example: 0010
358
-srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The subsystem ID is a four-digit hexadecimal number in the range (0001 - FFFF). When this parameter is used, all source volumes must be designated within the same logical subsystem. This parameter is required for IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: FF10 SourceVolumeID:TargetVolumeID . . . | (Required) Specifies that a remote FlashCopy relationship for the source and target volume pairs be incremented with the designated IDs. This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified, A FlashCopy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.210775FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
Invoking the resyncremoteflash command
dscli> resyncremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100:0200
lsremoteflash
The lsremoteflash command displays a list of remote FlashCopy relationships and status information for each FlashCopy relationship in the list. Remote FlashCopy relationships exist on a remote site, and can be queried (issue lsremoteflash command) from your local site.
359
-conduit
LSS_ID -s -l -activecp
-record
-persist
-revertible
-cp
-tgtse
-state
-seqnum
flash_sequence_num
Parameters
Note: All settings apply to all FlashCopy pairs that are specified. -dev storage_image_ID (Optional) Specifies the remote site storage image ID, which consists of manufacturer, machine type, and serial number. The remote site storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing Remote Mirror and Copy relationship that is used as a means for communicating with the remote storage image. The source volume IDs that are specified in the SourceVolumeID:TargetVolumeID parameter must serve as secondary volumes in a Remote Mirror and Copy relationship in which one of the conduit LSS volumes serves as a primary volume. This parameter accepts a fully qualified LSS ID, which includes the storage image ID. The fully qualified LSS ID format is storage_image_ID/XX, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. -s | -l | | (Optional) Displays the default output plus out-of-sync tracks and date that the FlashCopy relationship was created. You cannot use the -l and the -s parameters together. (Optional) Displays only FlashCopy pair IDs. You cannot use the -l and the -s parameters together.
360
-activecp (Optional) Specifies that FlashCopy relationships with an active background copy process are to be displayed. -record (Optional) Specifies that the FlashCopy relationships that were established with the -record parameter are to be displayed. -persist (Optional) Specifies that the FlashCopy relationships that were established with the -persist parameter are to be displayed. -revertible (Optional) Specifies that the FlashCopy relationships that were established with the -revertible parameter are to be displayed. -cp (Optional) Specifies that the FlashCopy relationships that were established with the run background copy (-cp) parameter are to be displayed. -tgtse (Optional) Displays the FlashCopy relationships that have a space-efficient target. This parameter is not supported on DS6000 models. -state valid | invalid | validation-required |volume-inaccessible | tgt-failed | path-unavailable | not-valid (Optional) Displays the FlashCopy relationships that are identified by the specific state. Note: When you specify not-valid, all FlashCopy relationships that do not meet the requirements for the valid state are displayed. -seqnum flash_sequence_number (Optional) Specifies that the FlashCopy relationships that are associated with the specified sequence number are to be displayed. This parameter is not supported for machine type 2105. -srcss Source_LSS_SSID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF. This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. When you specify SS_IDs, the source volumes are restricted to one LSS. Example: FF10 SourceVolumeID:TargetVolumeID . . . | (Required) Specifies that the FlashCopy relationships for the remote site source and target volume pairs with the specified IDs be displayed. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. You must separate multiple IDs with spaces. You can specify FlashCopy pair IDs and a range of FlashCopy pair IDs, or you can specify volume IDs and a range of volume IDs. You cannot specify a combination of FlashCopy pair IDs and volumes IDs. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where:
Chapter 4. CLI commands
361
XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a fully qualified volume ID pair: IBM.2107-75FA120/0001:IBM.2107-68FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsremoteflash command using the -l parameter. Invoking the lsremoteflash command
dscli> lsremoteflash -l -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 IBM.2107-75FA120/0100:IBM.2107-75FA120/0200
SourceWriteEnabled Enabled
TargetWriteEnabled Disabled
BackgroundCopy Disabled
CopyIndicator Yes
OutOfSyncTracks 0
State Valid
isTgtSE TSE
Pmir No
362
ActiveCopy Specifies (enabled or disabled) whether the background copy is active on the specified FlashCopy pair. Recording Specifies (enabled or disabled) whether the designated FlashCopy pair is established with recording activated. Persistent Specifies (enabled or disabled) whether the designated FlashCopy pair is established with persistent activated. Revertible Specifies (enabled or disabled) whether the designated FlashCopy pair is established with the revertible option activated. SourceWriteEnabled Specifies (enabled or disabled) whether this FlashCopy relationship was established with the Allow Source Writes option. No value is displayed for the DS6000. TargetWriteEnabled Specifies (enabled or disabled) whether this FlashCopy relationship was established with the Allow Target Writes option. No value is displayed for the DS6000. BackgroundCopy Specifies (enabled or disabled) whether this FlashCopy relationship was established with the Run Background Copy option. No value is displayed for the DS6000. OutofSyncTracks+ Specifies the number of tracks that are not synchronized for this FlashCopy relationship. No value is displayed for the DS6000. A dash (-) is displayed when the track counter is not available. DateCreated+ Specifies the date and the time that the FlashCopy relationship was established. No value is displayed for the DS6000. DateSynced Specifies the date and the time that this FlashCopy relationship was synchronized, or " - " if the relationship is not synchronized. No value is displayed for the DS6000. State Specifies the state of the FlashCopy relationships. One of the following values is displayed for each FlashCopy relationship: Note: When a query indicates any state other than valid, the only information that is displayed on the report is the FlashCopy pair ID and the state condition. The rest of the information columns are displayed with a " - " value. Valid Indicates that the FlashCopy relationship is in a normal state, and that it has been queried successfully. Validation Required Indicates that the FlashCopy relationship cannot be queried. The reason that the query is blocked is only temporary. If you issue a new query within several seconds, the problem no longer exists. Tgt Failed Indicates that the FlashCopy relationship is in an error state. The point-in-time copy is lost, and the FlashCopy relationship must be withdrawn. You must issue the rmflash command to remove the FlashCopy relationship.
363
Volume Inaccessible Indicates that the volume cannot be accessed and that the query has failed. When this state is displayed, it generally means that the volume is in a fenced condition. Invalid Indicates that a general internal error has occurred when the query is processed. Path Unavailable The specified inband path does not exist. The user must verify that the Remote Mirror and Copy path exists. Note: No value is displayed for the DS6000. isTgtSE Indicates whether this FlashCopy relationship has a space-efficient target. No Indicates that the target is not space-efficient. TSE Indicates that the target is a track space-efficient volume. ESE Indicates that the target is an extent space-efficient (ESE) volume. ESE volumes are used for IBM System Storage DS8000 Thin Provisioning. Unknown Indicates that the space allocation method of the target is not known. Pmir (DS8000 only) The IBM Remote Pair Copy option preserves synchronous Metro Mirror pairs when the FlashCopy source volume and target volume are Metro Mirror primary volumes and the Metro Mirror secondary volumes are on the same storage unit. The FlashCopy operation is performed on both the local site and the remote site. No Indicates that the IBM Remote Pair Copy option was not specified. Preferred Indicates that the IBM Remote Pair Copy option was specified. If the target is a Metro Mirror primary, then the FlashCopy function must preserve the Full Duplex mode of the target Metro Mirror relationship, if it is possible. If the IBM Remote Pair Copy function is not possible, you can use processing defined for the IBM Remote Pair Copy option of "No". Required Indicates that the IBM Remote Pair Copy option was specified. If the target is a Metro Mirror primary, then the FlashCopy function is required to preserve the Full Duplex mode of the target Metro Mirror relationship. Processing fails if the IBM Remote Pair Copy function is not possible. Remote Indicates that this remote FlashCopy relationship was initiated by another FlashCopy established at the Metro Mirror primary site with an IBM Remote Pair Copy option of preferred' or required'. Unknown The IBM Remote Pair Copy relationship type cannot be determined. The source and target were created with IBM Remote Pair Copy, but they are no longer both Metro Mirror primaries or both Metro Mirror secondaries. | Key: | | * + Displayed when the -s parameter is specified. Displayed only when the -l parameter is specified.
364
mkremoteflash
The mkremoteflash command initiates a remote point-in-time copy from source volumes to target volumes through a Remote Mirror and Copy relationship.
mkremoteflash -dev storage_image_ID -conduit LSS_ID -tgtpprc
-tgtoffline
-tgtinhibit
-freeze
-record
-persist
-tgtse
-cp -nocp
-seqnum
flash_sequence_num
-srcss
SS_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a conduit for communicating with the remote storage image. The source volume IDs that are specified in the SourceVolumeID:TargetVolumeID parameter, must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume. When you use this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX. The DS8000 value for the XX is 00 - FE and the DS6000 value is 00 1F. For DS8000, example: IBM.2107-75FA120/00 -tgtpprc (Optional) Allows the FlashCopy target volume to be a remote mirror and copy source volume. -tgtoffline (Optional) Causes the mkremoteflash command to be rejected if the target volume is online for host system access. This parameter applies only to CKD volumes. -tgtinhibit (Optional) Prevents host system write operations to the target while the FlashCopy relationship exists. -freeze (Optional) Specifies the Freeze Consistency Group condition. The use of this parameter triggers the queue full condition for the source volume. All writes to the source volume are queued by the host and are written after the queue full condition is reset. During the queue full condition, the source volume reports long busy status. The queue full condition is reset by an extended long busy timeout condition. The timeout condition affects all FlashCopy source volumes that are contained within a respective logical subsystem and that are established or modified with the -freeze parameter.
Chapter 4. CLI commands
365
Note: This parameter is used with other processing steps for purposes such as backups, testing, or recovery solutions. The use of this parameter ensures that volumes on the target LSSs are consistent with the source LSSs volumes. -record (Optional) Specifies that the changed tracks on both volumes within a FlashCopy pair be recorded. Select this parameter if you intend to use the resyncremoteflash command again with this pair. The -persist parameter is automatically selected when the -record parameter is specified. -persist (Optional) Specifies that you want to retain the FlashCopy relationship after the background copy completes. The FlashCopy relationship between the source and the target volumes remains indefinitely until you issue a rmremoteflash command. This parameter is automatically selected when the -record parameter is specified. Specify this parameter along with the -record parameter if you intend to use this volume pair with the resyncremoteflash, reverseremoteflash, or setremoteflashrevertible commands. -tgtse (Optional - DS8000 only) Specifies that the target volume might be a space-efficient logical volume. An error message is generated if the target volume that you have specified is a space-efficient volume and you do not specify the -tgtse parameter. -nocp (Optional) Inhibits background copy. Data will be copied from the source volume to the target volume only if a track on the source volume is modified. The FlashCopy volume pair relationship remains indefinitely until it is broken by a rmremoteflash command, or until all tracks on the source volume are modified. When -tgtse is specified and the -nocp parameter is not specified, the no background copy behavior is the default. You cannot use the -nocp parameter with the -cp parameter in the same command. -cp (Optional - DS8000 only) Specifies that a background copy be initiated. When (-tgtse is not specified) and neither the -cp nor the -nocp parameters are specified, the background copy behavior is the default. You cannot use the -cp parameter with the -nocp parameter in the same command. -seqnum flash_sequence_num (Optional) Associates the FlashCopy relationships that are established with the specified sequence number. This sequence number can be used as an identifier for a relationship or group of relationships. Example: 0010 This parameter is not supported for machine type 2105. -srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF. This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. When you specify SS_IDs, the source volumes are restricted to one LSS. Example: FF10 SourceVolumeID:TargetVolumeID . . . | (Required) Specifies that a remote FlashCopy relationship for the source and target volume pairs be incremented with the designated IDs. This parameter accepts fully qualified volume IDs, which includes the storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified.
366
A FlashCopy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For the DS8000, example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.210775FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
Invoking the mkremoteflash command
dscli> mkremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100:0200
revertremoteflash
The revertremoteflash command is used to restore data on the source volume to its most recent consistency formation. All new write operations to the source since the most recent consistency formation are overwritten with the previous consistency.
revertremoteflash -dev storage_image_ID SourceVolumeID -seqnum flash_sequence_num -srcss SS_ID " - " . . . -conduit LSS_ID
Parameters
You must take the following actions before you can use the revertremoteflash command: Notes: 1. Issue the mkflash or mkremoteflash command with the -persist and -record parameters to establish the FlashCopy pair.
Chapter 4. CLI commands
367
2. Issue the setflashrevertible or setremoteflashrevertible command against the FlashCopy pair. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy (formerly PPRC) relationship that is used as a means for communicating with the remote storage image. The source volume IDs that are specified in SourceVolumeID:TargetVolumeID must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume. When you use this parameter, you must specify a full qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX. The DS8000 value for the XX is 00 - FE and the DS6000 value is 00 1F. For DS8000, example: IBM.2107-75FA120/00 -seqnum flash_sequence_num (Optional) When a FlashCopy sequence number is specified, the revertremoteflash operation is performed only on those relationships that are associated with the specified number. Example: 0010 This parameter is not supported for machine type 2105. -srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF. This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. 3. When you specify SS_IDs, the source volumes are restricted to one logical subsystem. Example: FF10 SourceVolumeID . . . | (Required) Specifies the remote FlashCopy relationship for the source volume with the specified ID that is to be reverted. The chosen FlashCopy pair is the one that is established or modified with the -record parameter. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple source volume IDs with spaces. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1.
368
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a shortened version: 0001 Example of multiple IDs: 0001 0003 0008
Example
Invoking the revertremoteflash command
dscli> revertremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100
rmremoteflash
The rmremoteflash command removes a relationship between remote FlashCopy volume pairs.
rmremoteflash -dev storage_image_ID -conduit LSS_ID -quiet
-tgtreleasespace
-cp
-seqnum
flash_sequence_number
-srcss
SS_ID
Parameters
Notes: 1. Invoking this command and using the -cp parameter on a FlashCopy relationship that was previously marked with the -persist parameter does not remove the relationship. Instead, the source volume is copied to the target volume. 2. Invoking this command resets the -tgtinhibit parameter option if it was previously set. 3. All settings apply to all specified FlashCopy pairs. 4. The -seqnum parameter is not supported for model 2105. 5. When SS_IDs are specified, the source volumes are restricted to 1 LSS. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy (formerly PPRC) relationship that is to be used as a means for communicating with the remote storage image. The source volume IDs that are specified in SourceVolumeID:TargetVolumeID must serve as secondary volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes serves as a primary volume. This parameter allows the use of a fully qualified LSS ID, which includes the storage image ID. The fully qualified LSS ID format is storage_image_ID/XX. The DS8000 value for the XX is 00 - FE and the DS6000 value is 00 - 1F.
Chapter 4. CLI commands
369
-quiet (Optional) Turns off the FlashCopy pair removal confirmation prompt for this command. -tgtreleasespace (Optional - DS8000 only) Specifies that you want the system to release the space that has been allocated to the space-efficient target logical volumes back to the repository. This release must occur at the same time that the FlashCopy pair is removed if the only access to the space-efficient volumes is through the conduit LSS ID. -cp (Optional) Specifies that the FlashCopy relationship be changed from the No Copy to the Copy mode. Additionally the remaining source volume tracks are copied to the target volume. The relationship is removed when all the data is copied unless the relationship is persistent. When the -cp parameter is specified, the copy is processed for all volume pairs where the source volume ID is identical to the source volume that is specified in the command. -seqnum flash_sequence_num (Optional) When a FlashCopy sequence number is specified, the rmremoteflash operation is performed only on those relations that are associated with the specified number. Example: 0010 This parameter is not supported for machine type 2105. -srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF. This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. 4. When you specify SS_IDs, the source volumes are restricted to one logical subsystem. Example: FF10 SourceVolumeID:TargetVolumeID . . . | (Required) Specifies the remote FlashCopy relationships for the source and target volume pairs with the specified IDs that are to be removed. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.2107-68FA120/0004
370
Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
Example
Invoking the rmremoteflash command
dscli> rmremoteflash -dev IBM.2107-75FA120 -conduit IBM.2107-75FA150/10 0100:0200
setremoteflashrevertible
The setremoteflashrevertible command modifies a remote FlashCopy volume pair that is part of a FlashCopy relationship to revertible. When a pair is revertible, the data can be committed to the target to form a new consistency group, or it can be reverted back to the last consistency group. This command must be run before the FlashCopy pair can be committed or reverted.
setremoteflashrevertible -dev storage_image_ID -conduit LSS_ID -tgtoffline
-tgtse
-seqnum
flash_sequence_num
-srcss
SS_ID
Parameters
Note: The -nocp, -record, -persist, and -tgtinhibit (target inhibit) parameters that were specified when the FlashCopy pair was made (mkremoteflash command) are included automatically when the setremoteflashrevertible command processes. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -conduit LSS_ID (Required) Specifies the source logical subsystem (LSS) of an existing remote mirror and copy relationship that is to be used as a passage for communicating with the remote storage image. The source volume IDs that are specified in SourceVolumeID:TargetVolumeID must serve as secondary volumes in a remote mirror and copy relationship in which one of the passage LSS volumes serves as a primary volume. When you use this parameter, you must specify a fully qualified LSS ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is 00 - 1F.
Chapter 4. CLI commands
371
-tgtoffline (Optional) Causes an establish FlashCopy volume pair command to be rejected if the target volume ID is online for host system access. This parameter applies only to CKD volumes. -tgtse (Optional - DS8000 only) Specifies that the target volume that is part of the FlashCopy relationship that you are modifying to be designated as revertible might be a space-efficient logical volume. An error message is generated if the target volume is a space-efficient volume and you do not specify this parameter. -seqnum flash_sequence_num (Optional) Associates the remote FlashCopy relationships that are changed with the specified sequence number. Only the relationships that are successfully modified by the command get the specified sequence number, leaving the ones that failed with the previous number (if previously specified). Example: 0010 This parameter is not supported for machine type 2105. -srcss SS_ID (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF. This value is required for the IBM System Storage Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: FF10 SourceVolumeID:TargetVolumeID . . . | (Required) Specifies that the remote FlashCopy relationships for the designated source and target volume pairs be modified. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple FlashCopy pair IDs with spaces. A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a fully qualified FlashCopy pair ID: IBM.2107-75FA120/0001:IBM.2107-75FA120/0004 Example of a shortened version: 0001:0004 Example of multiple pairs: 0001:0004 0003:00FF 0008:000C
372
Example
Invoking the setremoteflashrevertible command
dscli> setremoteflashrevertible -dev IBM.2107-75FA120 0100:
lsavailpprcport
The lsavailpprcport command displays a list of ESCON or Fibre Channel I/O ports that can be defined as remote mirror and copy (formerly PPRC) paths. The DS8000 models and DS6000 models support only Fibre Channel ports. The Enterprise Storage Server (2105 machine type) supports ESCON ports. Secondary ports listed for PPRC are only available when configured as FCP. Secondary FICON ports, while displayed in the list, are not supported, and the DS CLI command mkpprcpath issued to a secondary FICON port will fail. Note: If you are creating paths between an older release of the DS8000 (Release 5.1 or earlier), which supports only 4-port host adaptors, and a newer release of the DS8000 (Release 6.0 or later), which supports 8-port host adaptors, the paths should connect only to the lower four ports on the newer storage unit.
lsavailpprcport -dev storage_image_ID -remotewwnn wwnn -s -l
-remotedev
storage_image_ID
373
Parameters
-dev storage_image_ID (Optional). Specifies the source volume storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -remotewwnn wwnn (Required). Specifies the worldwide node name (WWNN). The format is a 16-hexadecimal ID. Note: You want to use the WWNN that is associated with the remote storage image. Run the lssi or showsi command to obtain this number. If you use the WWNN that is associated with the primary storage unit, this command fails. WWNN example: 12341234000A000F -s (Optional). Displays the local port ID. You cannot use the -l and the -s parameters together. -l (Optional). Displays all fields. You cannot use the -l and the -s parameters together. -remotedev storage_image_ID (Required or Optional). Specifies the remote storage unit that contains the I/O ports that are queried by the Source_LSS_ID:Target_LSS_ID parameter. The remotedev ID consists of the value for the manufacturer, machine type, and serial number. Required - This parameter is required when querying ESCON I/O ports unless a fully qualified target logical subsystem ID is specified. Optional - This parameter is optional if you are querying fibre channel I/O ports. Note: If specified the format of this entry might be checked for correctness even though the value is not used. For DS8000, example: IBM.2107-75FA120 Source_LSS_ID:Target_LSS_ID | (Required) Queries I/O ports that are available for a remote mirror and copy path relationship for the source and target LSSs. This parameter accepts fully qualified LSS IDs, which includes the storage image ID or shortened version without the storage image ID, if the -dev parameter is specified. A remote mirror and copy path LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a remote mirror and copy path relationship. The two LSS IDs must be separated with a colon and no spaces. The first LSS ID is the source LSS. The second LSS ID is the target LSS. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE for a DS8000 model and 00 - 1F for a DS6000 model. If you do not use the -dev and -remotedev parameters, the fully qualified source_LSS_ID:target_LSS_ID value must be placed after the -remotewwnn value in your command line. Your command line can look like the following example:
dscli> lsavailpprcport l remotewwnn 12341234000A000F IBM.2107-75FA120/01:IBM.2107-75FA150/01
If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example pair: 00:00 Example of multiple pairs: 00:00 01:01 02:02
374
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lsavailpprcport command using the -l parameter. Invoking the lsavailpprcport command
dscli> lsavailpprcport l dev IBM.2107-75FA120 remotewwnn 12341234000A000F 01:01
The resulting output ESCON port information displays for the 2105 machine type.
Local port I0100 I0150 I0200 I0250 Attached port I0200 I0620 N/A N/A Type FCP ESCON ESCON Switch ESCON Switch Switch ID N/A N/A IBM.111.2222. 75113AB IBM.111.2222. 75113AB Switch port N/A N/A I10 I20
Switch ID Specifies the Switch ID for ESCON Switch connections. Note: For FCP and direct ESCON, the displayed value in this field is N/A (not applicable).
375
Switch port Specifies the Port ID on the Switch device that is connected to the attached ESS. The Switch port ID component is two hexadecimal characters in the format 0xPP, where PP is a port number (00 - ff). The number is prefixed with the letter I. Note: For FCP and direct ESCON, the value of this field is N/A (not applicable).
lspprcpath
The lspprcpath command displays a list of existing remote mirror and copy path definitions.
lspprcpath -dev storage_image_ID -s -l Source_LSS_ID . . . " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which consists of values for the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source LSS, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -s (Optional) Displays the default output of the report but does not include the Failed Reason column. You cannot use the -l and the -s parameters together. -l (Optional) Displays the default output and the Failed Reason and PPRC CG descriptions. You cannot use the -l and the -s parameters together. Source_LSS_ID . . . | (Required) Specifies that the Remote Mirror and Copy paths that are defined for the specified source LSS IDs be displayed. This parameter accepts ranges and individual LSS IDs. You might specify fully qualified LSS IDs, including the storage image ID, or a shortened version if the -dev parameter is specified. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 FE for the DS8000. The DS6000 value is in the range 00 - 1F. You must separate multiple LSS IDs with spaces. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example: 00 Example of multiple source LSS IDs: 00 01 02
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report when the -l parameter is used with the lspprcpath command. Invoking the lspprcpath command
dscli> lspprcpath -dev IBM.2107-75FA120 -l 10
376
Success
0011
Degraded
0012
Invalid
0013
Port IBM.2107 -75FA120 /I0100 IBM.2107 -75FA120 /I0100 IBM.2107 -75FA120 /I0100 IBM.2107 -75FA120 /I0100
Attached Port IBM.2107 -75FA150 /I0100 IBM.2107 -75FA150 /I0100 IBM.2107 -75FA150 /I0100 IBM.2107 -75FA150 /I0100
PPRC CG Disabled
Enabled
Disabled
3007ACF3012399E0
Enabled
| Tgt | State
377
SS Port
Specifies the subsystem identifier (SSID) of the target LSS. Specifies the fully qualified unique Port ID for the source storage unit. The port ID component is four hexadecimal characters in the format EEAP, where EE is a port enclosure number (00 - 3F), A is the adapter number (0 - F), and P is the port number (0 - F). The number is prefixed with the letter I.
Attached Port Specifies the fully qualified unique Port ID for the attached secondary storage unit. The port ID component is four hexadecimal characters in the format 0xEEAP, where EE is a port enclosure number (00 - 3F), A is the adapter number (0 - F), and P is the port number (0 - F). The number is prefixed with the letter I. Tgt WWNN Specifies the worldwide node name of the remote storage image. Failed Reason Specifies the reason for the path state. You must issue the lspprcpath command with the -l parameter to see the values displayed in this field. If the State field has a value of Invalid or Success, a " - " value is displayed in this field. When the State field displays a value of Failed, one of the following values is displayed: Configuration Error A path has failed for one of the following reasons: v The specification of the SA ID does not match the installed ESCON adapter cards in the primary controller. v For ESCON paths, the secondary control unit destination address is zero and an ESCON Director (switch) was found in the path. v For ESCON paths, the secondary control unit destination address is nonzero and an ESCON Director does not exist in the path. That is, the path is a direct connection. Delete the original entry and resubmit the mkpprcpath command. Down An FCP path has failed because of a communication or hardware failure. Primary Login Exceeded The maximum number of log ins for each source FCP path has been exceeded. Retry Exceeded The maximum number of times that the storage unit tried to reestablish FCP paths has been exceeded. Secondary Login Exceeded The maximum number of log ins for each FCP path to the secondary LSS has been exceeded. The FCP target is unavailable. Secondary Unavailable An FCP path to the secondary LSS is unavailable. Primary No Resources No resources are available at the source site for the logical paths to be established. Retry Specifies the number of attempts to reestablish path connection.
Secondary Mismatch Specifies that there is a mismatch that involves the secondary control unit sequence number or the LSS. Secondary No Resources Specifies that resources are not available at the secondary LSS to establish logical paths.
378
Secondary LSS Mismatch Specifies that there is a mismatch of the secondary control unit LSS ID or a failure of the I/O that collects secondary information for validation. Timeout Specifies that a timeout has occurred. No reason is available. Not Properly Configured Specifies that the primary Fibre Channel adapter is not configured properly, or it is not loaded with the correct version of microcode. Secondary Not PPRC Capable Specifies that the Fibre Channel path from secondary adapter is not capable of processing a remote mirror and copy path. This can occur from one of the following reasons: v The secondary adapter is not configured properly, or it is not loaded with the correct version of microcode. v The secondary adapter is already a target of 32 different storage units. ESCON Channel Direction Specifies that the primary control unit port or link cannot be converted to channel mode because a logical path is already established on the port or link. The establish path operations are not automatically retried within the control unit. ESCON Initialization Failed Specifies that initialization for the ESCON protocol has failed. ESCON Link Offline Specifies that the ESCON link is offline. This is caused by the lack of light detection coming from a host, peer, or switch. Path Degraded Due to High Failure Rate Indicates that a Fibre Channel path is established; however, because of the high failure rate, the path is degraded. Path Removed Due to High Failure Rate Indicates that the Fibre Channel path link has been removed because the path has experienced a high failure rate. System Reserved Path Indicates that the system has reserved resources for a remote mirror and copy path, for example, after a failoverpprc or a freezepprc command is used. The resources can be used later, such as for the failbackpprc command. In most cases, no action is required. If it is known that a system reserved path is not required, it can be removed with the rmpprcpath command only after there are no remote mirror and copy pairs remaining between the LSSs. PPRC CG Displays the status of the PPRC consistency group. You must issue the lspprcpath command with the -l parameter to see the values displayed in this field. One of the following values can be displayed: Enabled Indicates that the remote mirror and copy consistency group is enabled. Disabled Indicates that the remote mirror and copy consistency group is disabled.
mkesconpprcpath
The mkesconpprcpath command creates a remote mirror and copy (formerly PPRC) path between source and target logical subsystems over an ESCON connection.
379
The command allows you to specify ESCON direct and ESCON switch connections. Use this command only with IBM System Storage Enterprise Storage Servers (2105, Model 800 and Model 750).
mkesconpprcpath -dev storage_image_ID Source_LSS_ID -srcss ss_ID -remotedev storage_image_ID -tgtlss Target_LSS_ID
-tgtss
ss_ID
-consistgrp
-force
Parameters
Notes: 1. The mkesconpprcpath command is applicable only for the IBM System Storage Enterprise Storage Server (2105, Model 800 and Model 750). DS8000 models and DS6000 models support only Fibre Channel connections. 2. When you specify a switch port ID as the target port, specify the outgoing port that is connected to the remote ESS and not to the incoming port that is connected to the local ESS. -dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. Example: IBM.2105-FA120 -remotedev storage_image_ID (Optional). Specifies the remote storage image ID, which consists of manufacturer, machine type, and serial number. This parameter is required if you do not fully qualify the target LSS ID. Example: IBM.2105-FA150 -srclss Source_LSS_ID (Required). Specifies the source logical subsystem (LSS) ID. Accepts a fully qualified LSS ID, which includes the storage image ID or a shortened version without the storage image ID, if the -dev parameter is used. The fully qualified LSS ID format is storage_image_ID/xx, where 'xx' is a hexadecimal number in the range '00 - FE'. -srcss ss_ID (Optional). Specifies the subsystem ID of the primary logical subsystem in the format '0x0001 0xFFFF'. This value is required for the IBM Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: 0010 -tgtlss Target_LSS_ID (Required). Specifies the target logical subsystem (LSS) ID. Accepts a fully qualified LSS ID, which includes the storage image ID, or a shortened version without the storage image ID, if the -remotedev parameter is used. The fully qualified LSS ID format is storage_image_ID/xx, where 'xx' is a hexadecimal number in the range '00 - FE'.
380
-remotewwnn WWNN (Optional). Specifies the worldwide node name. The format is a 16-hexadecimal ID. Note: If you use this parameter, the format is checked even though there might be times that the value is not used. Example: 12341234000A000F -tgtss ss_ID (Optional). Specifies the subsystem ID of the secondary logical subsystem in the format '0x0001 0xFFFF'. This value is required for the IBM Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: 0010 -consistgrp (Optional). Creates a consistency group for the remote mirror and copy volume pairs that are associated with the PPRC paths that are established by this command. A remote mirror and copy consistency group is a set of remote mirror and copy volume pairs that have the same source and target LSS. Normally, when an error occurs in a member of a remote mirror and copy volume pair, the volume is put in a suspended state. However, if the volume is participating in a consistency group, it is placed in a long busy state. -force (Optional). Creates a new remote mirror and copy path even if the specified remote mirror and copy path already exists. Source_Port_ID:Target_Port_ID . . . | (Required). Establishes a remote mirror and copy path between the source and target ports for the specified source and target logical subsystems. The source port must be an ESCON I/O port that is configured for point-to-point or switch topology. The source port is enabled automatically for remote mirror and copy primary I/O operations. The target port must be a switch I/O port that is configured for point-to-point or switch topology. The target port is enabled automatically for remote mirror and copy primary I/O operations. Note: Do not specify a target port ID when you specify an ESCON direct connection. Instead, specify only the source port ID. This parameter accepts only non-fully qualified port IDs, which does not include the storage image ID. A remote mirror and copy path port pair ID consists of two port IDs. The first is designated as the source port and the second as the target port for the remote mirror and copy path. You must separate the two port IDs with a colon and no spaces. A direct ESCON I/O port ID is four hexadecimal characters in the format EEAP, where EE is a port enclosure number '00 - 3F', A is the adapter number '0 - F', and P is the port number '0 - F'. This number is prefixed with the letter I. A switch ESCON I/O port ID is two hexadecimal characters in the range '00 - FF'. This number is prefixed with the letter I. This parameter accepts up to eight remote mirror and copy path port pair IDs. You must separate multiple port pair IDs with spaces. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example pair: I1A10:I20 Example of a source ESCON port and target switch port pair: I1A10:I20 Example of multiple pairs: I1A10:I20 I1A11:I21 I1A12 (the last object identifies an ESCON connection)
381
mkpprcpath
The mkpprcpath command establishes or replaces a remote mirror and copy (formerly PPRC) path between source and target logical subsystems (LSSs) over a Fibre Channel connection. This is the only supported connectivity for machine types 2107 and 1750. Paths can be established between the following machine types: 2105:2105, 2107:2107, 2107:1750, 2107:2105, 1750:1750, 1750:2105. Note: Secondary ports listed for PPRC, after issuing the lsavailpprcport command, are only available when configured as FCP. Secondary FICON ports, while displayed in the list, are not supported, and the DS CLI command mkpprcpath issued to a secondary FICON port will fail.
mkpprcpath -dev -remotewwnn WWNN storage_image_ID -srclss source_LSS_ID -srcss SS_ID -remotedev storage_image_ID -tgtlss target_LSS_ID
Parameters
-dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -remotedev storage_image_ID (Optional) Specifies the ID of the secondary storage image, which includes manufacturer, machine type, and serial number. If specified, the format of this entry might be checked for correctness although the value is not used. For DS8000, example: IBM.2107-75FA150 -remotewwnn WWNN (Required) Specifies the worldwide node name of the secondary storage image. The format is a 16-hexadecimal ID. Note: Ensure that you use the worldwide node name that is associated with the secondary storage unit. Run the lssi or showsi command to obtain this number. Example: 12341234000A000F -srclss source_LSS_ID (Required) Specifies the source logical subsystem ID. Use a fully qualified LSS ID, which includes the storage image ID, or use a shortened version without the storage image ID, if the -dev parameter is
382
used. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. Example of a shortened version: 00 -srcss SS_ID (Optional) Specifies the subsystem ID of the primary logical subsystem in the format 0x0001 - 0xFFFF. This value is required for the IBM TotalStorage Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: 0010 -tgtlss target_LSS_ID (Required) Specifies the logical subsystem ID associated with the secondary storage unit as the target. Use a fully qualified LSS ID, which includes the storage image ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. Example of a shortened version: 01 -tgtss SS_ID (Optional) Specifies the subsystem ID of the secondary logical subsystem in the format 0x0001 0xFFFF. This value is required for the IBM TotalStorage Enterprise Storage Server versions 2.4.0 and 2.4.1. Example: 0010 -consistgrp (Optional) Creates a consistency group for the remote mirror and copy volume pairs. A remote mirror and copy consistency group is a set of remote mirror and copy volume pairs that have the same source and target LSS. Normally, when an error occurs in a member of a remote mirror and copy volume pair, the storage unit places the volume in a suspended state. However, if the volume participates in a consistency group, it is placed in a long busy state. source_port_ID:target_port_ID . . . | (Required) Establishes a remote mirror and copy path between the source and target ports for the specified source and target logical subsystems. The source and target ports must be Fibre Channel I/O ports that are configured for point-to-point or switched fabric topology. They are enabled automatically for remote mirror and copy secondary I/O operations. They are not enabled for FICON I/O operations. Use fully qualified port IDs, which includes the storage image ID, or use a shortened version without the storage image ID if the -dev parameter is specified. A remote mirror and copy path port pair ID consists of two port IDs. Designate the first as the source port and the second as the target port for the remote mirror and copy path. You must separate the two port IDs with a colon and no spaces. A port ID is four hexadecimal characters in the format EEAP, where EE is a port enclosure number (00 3F), A is the adapter number (0 - F), and P is the port number (0 - F). This number is prefixed with the letter I. This parameter accepts up to eight remote mirror and copy path port pair IDs. You must separate multiple port pair IDs with spaces. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of the shortened version: I1A10:I2A20 Example of multiple pairs: I1A10:I2A20 I1A11:I2A21 I1A12:I2A22
383
Example
Invoking the mkpprcpath command
dscli> mkpprcpath -dev IBM.2107-75FA120 -srclss 01 -tgtlss 01 remotewwnn 12341234000A000F I0100:I0100
rmpprcpath
The rmpprcpath command deletes a Remote Mirror and Copy path.
rmpprcpath -dev storage_image_ID -remotedev storage_image_ID
-remotewwnn
WWNN
-type
fcp escon
-quiet
-force
Parameters
-dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -remotedev storage_image_ID (Optional) Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified target LSS ID or if the -dev parameter is used. -remotewwnn WWNN (Optional) Specifies the secondary worldwide node name. Note: The following considerations can help you decide whether to use this parameter: v If you do not specify this parameter, DS CLI processing requires a query for this information from the remote device. In some cases, due to the path-specific state, the query might fail to locate the remote WWNN. If the remote WWNN cannot be located, the rmpprcpath command fails. Process the lspprcpath command to obtain the remote WWNN information and then process the rmpprcpath command with the remote WWNN information included. v Use the lspprcpath command to obtain the remote WWNN information. -type fcp | escon (Optional) The type of the connection over which the path was created. fcp escon Fibre-channel protocol (DS8000 only) Enterprise Systems Connection (IBM S/390 and System z)
-quiet (Optional) Turns off the Remote Mirror and Copy path removal confirmation prompt for this command.
384
-force (Optional) Specifies that you want to remove Remote Mirror and Copy paths even if Remote Mirror and Copy volume pairs exist. Otherwise, specified paths that are associated with existing Remote Mirror and Copy volume pairs are not be removed. source_LSS_ID:target_LSS_ID . . . | (Required) Specifies the Remote Mirror and Copy path relationships for the source and target LSSs that are to be removed. The LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a Remote Mirror and Copy path relationship. The two LSS IDs must be separated with a colon and no spaces. The first LSS ID is the source LSS. The second LSS ID is the target LSS. This parameter accepts fully qualified LSS IDs, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified pair: IBM.2107-75FA120/00:IBM.2107-75FA150/00 Example of a shortened version: 00:00 Example of multiple pairs: 00:00 01:01 02:02
Example
Invoking the rmpprcpath command
dscli> rmpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -remotewwnn 12341234000A000F 01:01
385
lspprc Generates a report that displays a list of remote mirror and copy volume relationships for a storage image and the status information for each remote mirror and copy volume relationship in the list. mkpprc Establishes a remote mirror and copy relationship for a volume pair. freezepprc Creates a new remote mirror and copy consistency group. It places the source logical subsystem (LSS) in the long busy state so that no I/O can be directed to it. It also removes remote mirror and copy paths between the source LSS and target LSS and sets the queue-full condition for the primary volume. pausepprc Pauses an existing remote mirror and copy volume pair relationship or pauses a single volume ID. resumepprc Resumes a remote mirror and copy relationship for a volume pair. rmpprc Removes one or more specified remote mirror and copy volume pair relationships, or it removes a single volume ID (which might be useful when a disaster occurs and you want to specify only the available volume and not both the primary and secondary volumes). unfreezepprc Resumes I/O activity on a storage unit where the freezepprc command has been issued. The unfreezepprc command resets the queue full condition for the primary volume.
failbackpprc
The failbackpprc command copies the required data from the source volume to the target volume to resume mirroring. This command is used in the disaster recovery processes that are associated with sites using Metro Mirror, Global Mirror, or Metro/Global Mirror processing.
failbackpprc -dev -type mmir gcp storage_image_ID -remotedev storage_image_ID
-cascade
-tgtse
-suspend
-tgtonline
-resetreserve
-force
-tgtread
-disableautoresync
Parameters
Notes: 1. You can issue the failbackpprc command against any remote mirror and copy volume that is in a primary suspended state. The failback processing copies the required data from the source volume to the target volume to resume mirroring. 2. A metro mirror (synchronous) pair must be suspended before it can be reestablished as a Global Copy (extended distance) pair and vice versa. 3. When you specify subsystem IDs (SSIDs), the source and target volumes are restricted to 1 LSS for the source and 1 LSS for the target.
386
-dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source volume ID (which includes the storage image ID, for the source volume IDs that are defined by the Source_Volume_ID:Target_Volume_ID parameter), do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. Note: The use of the failbackpprc command requires a role reversal for this parameter. The value for this parameter must be the original primary site which has been repaired and is ready to once again become your primary production site. For example: v Original primary site (Site A) has a value of IBM.2107-75FA120 with volumes 0100, 0101, 0102, 0103. v Original secondary site (Site B) has a value of IBM.2107-75FA150 with volumes 0200, 0201, 0202, 0203. v The following failbackpprc command is correct: dscli> failbackpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0200 0101:0201 0102:0202 0103:0203 -remotedev storage_image_ID (Optional) Specifies the target storage image ID, which includes manufacturer, type, and serial number. The -remotedev parameter identifies the remote storage unit that contains the target volume IDs that are defined by the SourceVolumeID:TargetVolumeID parameter. The -remotedev parameter is required if you do not specify a fully qualified target volume ID or if you use the -dev parameter. Note: The use of the failbackpprc command requires a role reversal for this parameter. The value for this parameter must be the original secondary site. For example: v Original primary site (Site A) has a value of IBM.2107-75FA120 with volumes 0100, 0101, 0102, 0103. v Original secondary site (Site B) has a value of IBM.2107-75FA150 with volumes 0200, 0201, 0202, 0203. v The following failbackpprc command is correct: dscli> failbackpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0200 0101:0201 0102:0202 0103:0203 -type mmir | gcp (Required) Modify one or more existing remote mirror and copy volume relationships as either Metro Mirror (Synchronous) or Global Copy (Extended Distance) relationships. mmir Metro Mirror maintains the remote mirror and copy relationship in a consistent manner by returning the I/O write completion status to the application when the updates are committed to the target. This process becomes slower as the physical distance between source and target increases. Global Copy maintains the remote mirror and copy relationship in a nonsynchronous manner. I/O write completion status is returned to the application when the updates are committed to the source. Updates to the target volume are performed at a later time. The original order of updates is not strictly maintained.
gcp
-cascade (Optional) Specifies that the remote mirror and copy target volume can also be a remote mirror and copy source volume of a different remote mirror and copy volume relationship.
387
-tgtse (Optional) Specifies that the PPRC secondary volume is a space efficient volume. -suspend (Optional) Specifies that the remote mirror and copy relationship is to be suspended when the task completes. Notes: 1. This parameter is not valid for a Global Copy (Extended Distance) remote mirror and copy volume relationship. 2. This parameter is not valid for a Metro Mirror (Synchronous) remote mirror and copy volume relationship that is established with the No Copy option activated. -tgtonline (Optional) Specifies that a remote mirror and copy volume relationship is to be established, including when the target volume is online to host systems. Note: This parameter applies only to S/390 or System z volumes. It does not apply to Open Systems volumes. -resetreserve (Optional) Specifies that a remote mirror and copy relationship is to be established when the volume on the secondary logical subsystem is reserved by another host. If this parameter is not specified and the volume on the secondary logical subsystem is reserved, the command fails. Note: This parameter applies only to fixed block volumes. -force (Optional - DS8000 only) Specifies whether validation of the volumes involved in the establish request occurs or is bypassed. This parameter allows you to create a FlashCopy pair between two volumes who had no previous relationship and ONLY copy changed tracks. Notes: 1. This parameter can only be used as part of a Metro/Global Mirror (3-site) disaster recovery process. 2. Only use this parameter if you are fully aware of the affect this parameter has on your transactions. A couple of scenarios are provided in this guide that describe a set of circumstances that allow you to safely use this parameter. If your circumstances do not match the scenarios, you are cautioned not to use this parameter unless advised to do so by IBM Technical Support. -tgtread (Optional) Specifies that host servers be allowed to read from the remote mirror and copy target volume. For a host server to read the volume, the remote mirror and copy pair must be in a full-duplex state. Note: This parameter applies only to Open System volumes. -disableautoresync (Optional - DS8000 only) Allows you to disable the mechanism that automatically resumes a suspended Global Copy relationship. The default is not disabled. The -disableautoresync parameter is available only in Version 5 Release 3 or later. SourceVolumeID:TargetVolumeID . . . | (Required) Specifies the remote mirror and copy volume pair IDs for the source and target volume pairs that are to undergo failback processing. The original values (before the disaster) return with the source volume IDs equal to the A volumes and the target volume IDs equal to the B volumes.
388
This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces. A remote mirror and copy volume pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0 - F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified pair: IBM.2107-75FA120/0100:IBM.2107-75FA150/0100 Example of multiple pairs: 0101:0101 0102:0102 0103:0103
Example
Invoking the failbackpprc command
dscli> failbackpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100 0101:0101 0102:0102 0103:0103
failoverpprc
The failoverpprc command is used only with disaster recovery processing. This command is used in the disaster recovery processes associated with sites using Metro Mirror, Global Mirror, or Metro/Global Mirror processing. The failoverpprc command succeeds even if the paths are down and the volume at the production site is unavailable or nonexistent.
failoverpprc -dev -type mmir gcp storage_image_ID -remotedev storage_image_ID
-tgtonline
-cascade
-force
-disableautoresync
389
Parameters
The failoverpprc command is used in the Global Mirror and Metro Mirror disaster recovery processes with the following results: v In a Global Mirror failover recovery process, the failoverpprc command initiates failover processing of B volumes to A volumes. This process causes the B volumes to become the primary volumes and the A volumes to become the secondary volumes. The effect is that the Global Copy state of the B volumes changes from secondary to primary and suspended. v In a Global Mirror failback recovery process (production is returned to the local site), the failoverpprc command initiates failover processing from A volumes to B volumes. This process causes the A volumes to become the primary volumes and the B volumes to become the secondary volumes. v In a Metro Mirror disaster recovery process, failover processing to the Global Copy secondary volume causes the secondary volumes to become primary volumes and immediately suspends these volumes. When you run a Global Copy failover, the B volumes are the primary volumes and the A volumes are the secondary volumes. This action changes only the Global Copy state of the secondary volumes from Target Copy Pending to Suspended. The failoverpprc command changes a secondary device into a primary suspended device while leaving the primary device in its current state. This command succeeds even if the paths are down and the volume at the production site is unavailable or nonexistent. Note: When you specify the subsystem identifier (SSID), the source and target volumes are restricted to one LSS for the source and one LSS for the target. -dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. Note: The use of the failoverpprc command requires a role reversal for this parameter. The value for this parameter must be the original secondary site. For example: v Original primary site (Site A) has a value of IBM.2107-75FA120 with volumes 0100, 0101, 0102, 0103. v Original secondary site (Site B) has a value of IBM.2107-75FA150 with volumes 0200, 0201, 0202, 0203. v The following failoverpprc command is correct: dscli> failoverpprc -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 0200:0100 0201:0101 0202:0102 0203:0103 -remotedev storage_image_ID (Optional) Specifies the target storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified target volume ID or if you use the -dev parameter. Note: The use of the failoverpprc command requires a role reversal for this parameter. The value for this parameter must be the original primary site. For example:
390
v Original primary site (Site A) has a value of IBM.2107-75FA120 with volumes 0100, 0101, 0102, 0103. v Original secondary site (Site B) has a value of IBM.2107-75FA150 with volumes 0200, 0201, 0202,0203. v The following failoverpprc command is correct: dscli> failoverpprc -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 0200:0100 0201:0101 0202:0102 -type mmir | gcp (Required) Modifies one or more existing remote mirror and copy volume relationships as either Metro Mirror or Global Copy relationships. mmir Metro Mirror maintains the remote mirror and copy relationship in a consistent synchronous manner when the updates are committed to the target. This process becomes slower as the physical distance between source and target increases. Global Copy maintains the remote mirror and copy relationship in a nonsynchronous manner when the updates are committed to the source. Updates to the target volume are performed at a later time. The original order of updates is not strictly maintained.
gcp
-tgtonline (Optional) Establishes a remote mirror and copy volume relationship, including when the target volume is online to host systems. This parameter applies to S/390 or System z volumes. It does not apply to Open Systems volumes. -cascade (Optional) Specifies that the PPRC target volume can also be a PPRC source volume of a different PPRC volume relationship. -force (Optional - DS8000 only) Specifies whether validation of the volumes that are involved in the establish request occurs or is bypassed. This parameter allows you to create a FlashCopy pair between two volumes that had no previous relationship and only copy changed tracks. Notes: 1. This parameter can only be used as part of a Metro/Global Mirror (3-site) disaster recovery process. 2. Use the -force parameter if you are fully aware of the affect that this parameter has on your transactions. A couple of tasks are provided in this guide that describe a set of circumstances that allow you to safely use this parameter. If your circumstances do not match the scenarios, you are cautioned not to use this parameter unless advised to do so by IBM Technical Support. -disableautoresync (Optional - DS8000 only) Allows you to disable the mechanism that automatically resumes a suspended Global Copy relationship. The default is not disabled. The -disableautoresync parameter is available only in Version 5 Release 3 or later. SourceVolumeID:TargetVolumeID . . . | (Required) Specifies the remote mirror and copy volume pair IDs of the source and target volumes that must have their relationships changed so that the target volumes (B volumes) become the source volumes and the original source volumes (A volumes) become the target volumes. This results in the following conditions: v The source volumes (B volumes) show as a suspended host. v The target volumes (A volumes) show as a suspended target and they are accessible for mounting.
391
This parameter also accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces. A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1 for DS6000 and 0 - F for DS8000. XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified pair: IBM.2107-75FA150/0100:IBM.2107-75FA120/0100 Example of a shortened version: 0100:0100 Example of multiple pairs: 0101:0101 0102:0102 0103:0103
Example
Invoking the failoverpprc command
dscli> failoverpprc -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 0200:0100 0201:0101 0202:0102
The resulting output A confirmation message is presented for each remote mirror and copy pair that is successfully suspended.
lspprc
The lspprc command displays a list of remote mirror and copy (formerly PPRC) volume relationships for a storage image, and status information for each remote mirror and copy volume relationship in the list.
lspprc -dev storage_image_ID -remotedev storage_image_ID
-state
-s -l
392
. . .
Parameters
-dev storage_image_ID (Optional). Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. -remotedev storage_image_ID (Optional; however, required as noted). Specifies the target volume storage image ID, which consists of manufacturer, machine type, and serial number. Note: The -remotedev parameter is required when volume pairs are specified and the -dev parameter is specified, as well. -state copy-pending | full-duplex | suspended | target-copy-pending | target-full-duplex | target-suspended | invalid-state | validation-required | volume-inaccessible (Optional) Identifies the state of the remote mirror and copy relationship that you want to view. copy-pending Specifies that you want to view remote mirror and copy relationships that have copy processing that is pending. A Global Copy relationship is always copy-pending. full-duplex Specifies that you want to view remote mirror and copy relationships that are full duplex. suspended Specifies that you want to view remote mirror and copy relationships that are suspended. The Reason attribute might indicate why the relationship is suspended. target-copy-pending Specifies that you want to view remote mirror and copy relationships where the target volume has copy processing that is pending. In this state, the source volume is unknown or cannot be queried. target-full-duplex Specifies that you want to view remote mirror and copy relationships where the target volume is full duplex. In this state, the source volume is unknown or cannot be queried. target-suspended Specifies that you want to view remote mirror and copy relationships where the target volume is suspended. In this state, the source volume is unknown or cannot be queried. The Reason attribute might indicate why the relationship is suspended. invalid-state Specifies that you want to view remote mirror and copy relationships with an Invalid State. The Invalid State means that a general internal error has occurred when the query was processed. The report that is generated with this query only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of Invalid State. All the other information columns are displayed with a " - " value. validation-required Specifies that further validation is required. Running the lspprc command again might display a different state output. However, if you request a query with just the validation-required designation, the report only displays the source and target volume IDs of a
Chapter 4. CLI commands
393
remote mirror and copy volume relationship that have a designation of validation-required. All the other information columns are displayed with a " - " value. volume-inaccessible Specifies that you want to view remote mirror and copy relationships where the volume cannot be viewed, this means that the volume is fenced. The report that is generated with this query only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of volume-inaccessible. All the other information columns are displayed with a " - " value. -s (Optional). Displays the remote mirror and copy volume pair IDs. You cannot use the -s and the -l parameters together. -l (Optional). Displays the default output plus additional attributes that are identified as long output. You cannot use the -s and the -l parameters together. SourceVolumeID:TargetVolumeID | Volume_ID . . . | (Required) Displays the remote mirror and copy relationships for the source and target volume pairs, or for volumes with the specified IDs. This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces. A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no spaces. The first volume ID is the source volume. The second volume ID is the target volume. You can enter remote mirror and copy pair IDs, a range of remote mirror and copy pair IDs, single volume IDs, or a range of volume IDs. You cannot enter a combination of remote mirror and copy pair IDs and volume IDs. The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a shortened version pair: 0100:0100 Example of multiple pair IDs: 0100:0100 0200:0200 0300:0300 Example of a range of pair IDs: 0100-010F:0100-010F Example of a source or target volume ID: 0100 Example of a range of source or target volume IDs: 0100-010F Note: A query of target volume IDs is directed to the storage image that is identified by the -dev parameter or embedded in the fully qualified single volume IDs.
394
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lspprc command using the -l parameter. Invoking the lspprc command
dscli>lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100 0101:0101
State FullDuplex
Reason -
FullDuplex
Metro Mirror
Enabled
Disabled
Date Suspended -
Source LSS 01 02
DisableAutoResync -
395
Suspended Indicates that the relationship is suspended. The Reason attribute might indicate why the relationship is suspended. Target Copy Pending Indicates that the source volume is unknown or cannot be queried and the target state is copy pending. Target Full Duplex Indicates that the source volume is unknown or cannot be queried and the target state is full duplex. Target Suspended Indicates that the source volume is unknown or cannot be queried and the target state is suspended. Invalid State Indicates that a general internal error occurred when the query was processed. Note: The report that is generated with the Invalid State designation only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of Invalid State. All the other information columns are displayed with a " " value. Validation Required Indicates that the status of the volume cannot be determined at this time. Further validation is required. Sometimes, running the same lspprc command again later has different state output. Note: The report that is generated with the validation-required designation only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of validation-required. All the other information columns are displayed with a " - " value. Volume Inaccessible Indicates that the volume could not be queried. This information means that the volume is fenced. Note: The report that is generated with the Volume Inaccessible designation only displays the source and target volume IDs of a remote mirror and copy volume relationship and the state designation of Volume Inaccessible. All the other information columns are displayed with a " - " value. Reason Indicates why the remote mirror and copy volume relationship is suspended. The following values can be displayed: Indicates that the volume is suspended but the reason for the suspension is not defined within the system
Not in PPRC Relationship Indicates that the designated volume is not part of a remote mirror and copy pair. Host Source Indicates that the remote mirror and copy processing on the volume was suspended by the primary host. The host command might have specified an immediate suspension or that the volume is to be suspended when it entered a full duplex state. Host Target Indicates that remote mirror and copy processing was suspended on the secondary volume. Updates to primary volumes and out-of-sync tracks are still being processed.
396
Update Target Indicates that remote mirror and copy processing was suspended on a secondary volume by the primary control unit update secondary device status command. Internal Conditions Both Indicates that remote mirror and copy processing was suspended on a volume by either the primary control unit or the secondary control unit because of internal conditions. Simplex Target Specifies that remote mirror and copy processing was suspended on a volume when the secondary control unit sent a state change Indicates to the primary control unit indicating a transition to a simplex state. Internal Conditions Target Indicates that remote mirror and copy processing was suspended on a secondary volume when the primary control unit was notified that the secondary volume became suspended due to internal conditions. Power Indicates that remote mirror and copy processing was suspended on a volume when the primary or secondary control unit was shut down or restarted. Notes: 1. The paths to the secondary controller might not be available if the power to the primary controller was shut down. If only the secondary control unit was shut down, it might be possible for the paths to be restored depending on the path status. Use the following process to determine whether your remote mirror and copy processing can be restored on the affected volumes: a. Issue the lspprc command and use the generated report to determine the path status. b. Issue the mkpprc command if the paths are still in tact. This process resynchronizes the volume pairs. c. Continue with your processing. 2. If the previous process cannot be performed, you must remove the pair relationships on the affected volumes and start your remote mirror and copy processing from the beginning on the affected volumes. Freeze Indicates that remote mirror and copy processing was suspended on a volume pair because the host issued a Freeze PPRC Group order. Volume Not Configured Indicates that remote mirror and copy processing was suspended on a volume because the volume is not part of a copy pair relationship. Remote Copy Pending Indicates that the volume transitioned to the pending state as a result of establishing a FlashCopy relationship. Before the attempt was made to establish the FlashCopy relationship, the volume was in Full Duplex mode. Release Space Failure Indicates that the pair is suspended due to the failure to release unused space-efficient storage on the Remote Mirror and Copy secondary volume. | | Type With Secondary Consistency Indicates that the Remote Mirror and Copy secondary volumes form a consistent data set. Indicates that the remote copy and mirror volume relationship is a Metro Mirror (synchronous) relationship, a Global Copy (extended distance) relationship, or the relationship type is unknown.
397
Out Of Sync Tracks Indicates the number of tracks that are not synchronized for this FlashCopy relationship. The maximum value is dependent on the source volume size. Notes: 1. If you issue the lspprc command to view the out-of-sync value for a volume pair (for example, 0000:0001) on a 2105, there is no observable decrease in the value from when you issue the query to the end of the process. 2. If you issue the lspprc command to view the out-of-sync value for a single volume (for example, 0000) on a 2105, there is an observable decrease in the value but only at 10 second intervals. If you issue the lspprc command and reissue it again before the 10 seconds has expired, there is no observable change in the value. 3. If you issue the lspprc command to view the out-of-sync value for a volume pair or a single volume on a DS8000 or a DS6000, there is an observable decrease in the value but only at 10 second intervals. Tgt Read Indicates that Read I/O operations to the target volume are allowed. Src Cascade Indicates that the source volume of this relationship is enabled to also be a target volume of a different relationship. Tgt Cascade Indicates that the target volume of this relationship is enabled so that it is also a source volume for a different relationship. No value is displayed for a DS6000 model. Date Suspended Indicates the date when this relationship was last suspended. The value can be displayed as a " ". No value is displayed for a DS6000 model. SourceLSS Indicates the consistency group LSS ID that is associated with the source volume of this PPRC volume relationship. No value is displayed for a DS6000 model. Timeout (secs) Indicates the consistency group Long Busy Timeout setting for the LSS ID that is associated with the source volume of this PPRC volume relationship. This value can be modified using the chlss (FB) or the chlcu (CKD) command. No value is displayed for a DS6000 model. Critical Mode Indicates whether the remote copy and mirror primary volume represents a critical volume. No value is displayed for a DS6000 model. First Pass Status Indicates whether the first pass of Global Copy is complete. When you query the primary volume of a Global Copy pair, True is displayed when the first pass is complete, False is displayed when the first pass is not yet complete, and Invalid is displayed if the pair is not Global Copy or if the secondary was queried. Incremental Resync Indicates if incremental resynchronization is running. No value is displayed for a DS6000 model. Tgt Write Indicates whether input is allowed to the remote mirror and copy secondary volume. No value is displayed for a DS6000 model. GMIR CG The value for this field is fixed to display N/A (not available). Use the lssession command to monitor the status of Global Mirror relationships.
398
PPRC CG Indicates if the remote mirror and copy consistency group is enabled, disabled or not available. Notes: 1. This value is displayed when you designate the use of the -l parameter, and when the primary volume is being queried. If the secondary volume is being queried, the value displayed for this field is N/A (not available). 2. This value is not reported for model 2105. If a model 2105 is being queried, the value displayed for this field is N/A (not available). isTgtSE Indicates whether this remote mirror and copy relationship has a space-efficient secondary. Unknown Indicates that the space allocation method of the target is not known. DisableAutoResync Indicates whether the mechanism that automatically resumes a suspended Global Copy relationship is active. No value is displayed for a DS6000 model.
mkpprc
The mkpprc command establishes a remote mirror and copy (formerly PPRC) relationship for a volume pair.
mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir gcp
-mode
full nocp
-cascade
-tgtonline
-tgtread
-critmode
-suspend
-resetreserve
-incrementalresync
-tgtse
Parameters
Notes: 1. When you specify subsystem IDs, the source and target volumes are restricted to one LSS for the source and one LSS for the target. 2. If you are using the Cisco MDS 9216 Multilayer Fabric Switch, you must not enable the write acceleration feature. The mkpprc command might fail if the write acceleration feature is enabled. -dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
Chapter 4. CLI commands
399
For DS8000, example: IBM.2107-75FA120 -remotedev storage_image_ID (Optional) Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified target volume ID, or if the -dev parameter is selected. For DS6000, example: IBM.1750-75FA120 -type mmir | gcp (Required) Establishes one or more remote mirror and copy volume relationships as either Metro Mirror (synchronous) or Global Copy (extended distance) relationships. mmir Metro Mirror maintains the remote mirror and copy relationship in a consistent (synchronous) manner by returning I/O write completion status to the application when the updates are committed to the target. This process becomes slower as the physical distance between source and target increases. Global Copy maintains the remote mirror and copy relationship in a nonsynchronous manner. I/O write completion status is returned to the application when the updates are committed to the source. Updates to the target volume are performed at a later time. The original order of updates is not strictly maintained.
gcp
-mode full | nocp (Optional) Specifies the following initial data copy mode for the remote mirror and copy volume relationships: full nocp Full mode copies the entire source volume to the target volume. This value is the default when you do not specify the no copy mode. No Copy mode does not copy data from source to target volumes. This option presumes that the volumes are already synchronized.
-cascade (Optional) Enables a remote mirror and copy target volume to be a remote mirror and copy source volume for a different remote mirror and copy volume relationship. The default value for this parameter is disabled. -tgtonline (Optional) Establishes a remote mirror and copy volume relationship, including when the target volume is online to host systems. This parameter applies to S/390 or System z volumes and does not apply to Open Systems volumes. The default value for this parameter is disabled. -tgtread (Optional) Allows host servers to read from the remote mirror and copy target volume. For a host server to read the volume, the remote mirror and copy pair must be in a full-duplex state. This parameter applies to open systems volumes and does not apply to IBM S/390 or System z volumes. The default value for this parameter is disabled. -critmode (Optional) Protects the source volume from receiving new data. If the last path fails between the pairs and results in the inability to send information to the target, the source is protected. Current updates and subsequent attempts to update the source fail with a unit check on S/390. The default value for this parameter is disabled. Note: This parameter applies only to S/390 or System z volumes. Critical mode operates in one of three ways depending on the setting of the LCU critical mode and the setting of the -critmode parameter in this command. The following table presents an overview of how the critical volume mode works.
400
Description v Suspends the primary volume. v Allows write operations to the primary volume.
Critical Volume
Disabled
Enabled
v Suspends the primary volume when the last path to the secondary volume has failed. v Inhibits write operations to the primary volume.
Critical Heavy
Enabled
Enabled
v Suspends the primary volume when the secondary volume cannot be updated for any reason. v Inhibits write operations to the primary volume.
Notes: 1. Use the -critmode parameter only for log devices, not for devices that the system requires. In extreme cases, the host system might require you to load the initial program to recover a device that is write inhibited. Whenever possible, use the freezepprc command as an alternative to using the -critmode parameter. 2. The -critmode parameter cannot be used with Global Copy or remote copy and mirror cascading volumes. 3. To reset a volume that is write inhibited because of critical mode, you can issue the mkpprc, pausepprc, or rmpprc command to this volume. 4. Use automation software as part of any solution that includes critical mode. Automation software is not a part of the software that is provided with the storage unit; you must supply it. However, IBM has offerings to assist with this automation. For more information, contact your IBM storage representative. -suspend (Optional - DS8000 only) Suspends the remote mirror and copy relationship when the task completes. This parameter is not valid for a Global Copy (extended distance) remote mirror and copy volume relationship. This parameter is not valid for a Metro Mirror (synchronous) remote mirror and copy volume relationship that is established with the No Copy option. The default value for this parameter is disabled. -resetreserve (Optional - open system volumes only) Allows the establishment of a remote mirror and copy relationship when the volume on the secondary logical subsystem is reserved by another host. This parameter can only be used with open system volumes. If this option is not specified and the volume on the secondary logical subsystem is reserved, the command fails. -incrementalresync enable | enablenoinit | disable | recover | override (Required for three-site Metro/Global Mirror recovery - DS8000 only) Specifies the resynchronization method used in a three-site Metro/Global Mirror disaster recovery configuration. A three-site Metro/Global Mirror configuration usually involves: Site A (local site), which contains the production volumes (or the A volumes); Site B (intermediate site), which contains the B volumes and a local, synchronous copy; and Site C (remote site), which contains the C volumes and an asynchronous copy that is located remotely from sites A and B.
401
You can specify the following options when you first establish volume pairs using the mkpprc command or on established volume pairs using this command. enable Specifies that change recording features be created on each of the primary Metro Mirror volumes to enable the microcode to monitor and track data in a Metro/Global Mirror configuration. This is data that has been written to the primary volumes but has not been secured on the remote site volumes. enablenoinit Specifies that the change recording features are not created or started on the primary Metro Mirror volumes in a Metro/Global Mirror configuration. Only use this option in specific recovery scenarios. disable Specifies that the current incremental resynchronization function be stopped on the primary volumes of the Metro Mirror volume pairs. recover Specifies that a new Global Mirror volume pair be established using an existing primary Metro Mirror (A) volume at the local site and a secondary Global Copy (C) volume at the remote site. When this command processes, only changes to the local Metro Mirror volumes are copied to the volumes at the remote site. Note: When you specify this option, the system verifies that the failed secondary volumes for the volumes in a Metro Mirror relationship are the primary volumes for the volumes in a Global Copy relationship and that the specified volumes have the intermediate volumes in common. That is, the primary specified volumes are the A volumes and the secondary specified volumes are the C volumes in a Metro/Global Mirror configuration. override Specifies that a new Global Mirror volume pair be established using an existing primary Metro Mirror (A) volume at the local site and a secondary Global Copy (C) volume at the remote site. When this command processes, only changes to the local Metro Mirror volumes are copied to the volumes at the remote site. Note: When you specify this option, there is no validation to ensure the secondary relationship in this configuration before processing the mkpprc command. Therefore, you must ensure that the primary specified volumes are the A volumes and the secondary specified volumes are the C volumes in a Metro/Global Mirror configuration. -tgtse (Optional - DS8000 only) Specifies that the secondary volume might be a space-efficient logical volume. -disableautoresync (Optional - DS8000 only) Allows you to disable the mechanism that automatically resumes a suspended Global Copy relationship. The default is not disabled. The -disableautoresync parameter is available only in Version 5 Release 3 or later. -wait (Optional) Delays the command response until the remote copy and mirror volumes are in one of the final states: simplex, full duplex, suspended, secondary full duplex, secondary suspended or secondary simplex (until the pair is not in the Copy Pending state). The default value for this parameter is disabled. Notes: 1. This parameter cannot be used with the -type gcp or -mode nocp parameters.
402
2. When you use the -wait parameter, you must wait until the original command completely processes before you can issue a new command. 3. If you are running in single-shot mode, you can periodically issue the lspprc command to check the remote mirror and copy volume pair state, and then continue with new commands when the correct state is reached. SourceVolumeID:TargetVolumeID . . . | (Required) Specifies the remote mirror and copy volume relationship for the source and target volume pairs with the specified IDs. This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces. A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair IDs with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. For DS8000, example of a fully qualified pair: IBM.2107-75FA120/0100:IBM.2107-75FA150/0100 Example of a shortened version: 0100:0100 Example of multiple pairs: 0101:0101 0102:0102 0103:0103
Using the grouping method in your command You can also group the volumes. However, the order of the volumes is critical when you group them, and they must be contiguous. The following shows how to code for grouping:
mkpprc -dev IBM.1750-13AB79A -remotedev IBM.1750-13AB76A type mmir -mode full -tgtread 1000-1004:1205-1209 1100-1104:1300-1304
Chapter 4. CLI commands
403
Example
Invoking the mkpprc command
dscli>mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100 -type mmir 2100-2107:2100-2107
dscli> mkpprc -dev IBM.2107--75FA120 -remotedev IBM.2107--75FA150 -type gcp -incrementalresync enablenoinit -mode nocp 2100-2107:2100-2107
freezepprc
The freezepprc command creates a new remote mirror and copy consistency group. It places the source logical subsystem (LSS) in the long busy state so that no I/Os can be directed to it. It also removes remote mirror and copy paths between the source LSS and target LSS and sets the queue full condition for the primary volume. This causes the host to queue writes to the primary volume until the queue full condition is reset. During the queue full condition, the primary volume reports long busy status.
freezepprc -dev storage_image_ID -remotedev storage_image_ID
Parameters
Note: When specifying SSIDs, the command is limited to one LSS pair. -dev storage_image_ID (Optional). Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120
404
-remotedev storage_image_ID (Optional). Specifies the target storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified target LSS ID or if the -dev parameter is used. For DS6000, example: IBM.1750-68FA150 Source_LSS_ID:Target_LSS_ID . . . | (Required). Specifies that a consistency group for the source and target LSSs with the IDs specified be placed in a long busy state. Accepts fully qualified LSS IDs, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. A remote mirror and copy path LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a remote mirror and copy path relationship. The two LSS IDs must be separated with a colon and no spaces. The first LSS ID is the source LSS. The second LSS ID is the target LSS. The fully qualified LSS ID format is storage_image_ID/xx, where xx is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a pair: 00:00 Example of multiple pairs: 00:00 01:01 02:02
Example
Invoking the freezepprc command
dscli>freezepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 01:01
pausepprc
The pausepprc command pauses an existing Remote Mirror and Copy volume pair relationship or pauses a single volume ID. To use this command with a single volume, you must specify either the -at src parameter option or the -at tgt parameter option. If neither of these options are specified in the command, single volumes are not valid.
pausepprc -dev storage_image_ID -remotedev storage_image_ID
Parameters
Note: When you specify SSIDs, the command is limited to one LSS pair. -dev storage_image_ID (Optional). Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source volume
405
ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. Example of a fully qualified storage image ID: IBM.2107-75FA120. -remotedev storage_image_ID (Optional most times). Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. Note: The -remotedev parameter is required when volume pairs are specified and the -dev parameter is specified, as well. -at src | tgt (Optional). Specifies that you want to initiate a suspend action from either the source volume or the target volume. src Initiates a suspend action from the source volume. After the task successfully runs, the source and target volumes are in the suspend state. The -at src parameter option can also be used with single volumes. When you specify a single volume using this option, the volume is treated as a source and the target is treated as a null. tgt Initiates a suspend action from the target volume. After the command successfully runs, the target volume is in the suspend state, but there is no guarantee that the source volume is suspended as well. For a suspend action that is issued to the target, the source can remain in the active state. The -at tgt parameter option can also be used with single volumes. When you specify a single volume using this parameter option, the volume is treated as a target and the source is treated as a null. Notes: 1. If you specify the -at tgt or -at src parameter and the -unconditional parameter, the value for the -remotedev parameter is ignored. 2. If you specify the -at tgt parameter and do not specify the -unconditional parameter, the values for the -dev and SourceVolumeID parameters are ignored. 3. If you specify the -at src parameter and do not specify the -unconditional parameter, the values for the -remotedev and TargetVolumeID parameters are ignored. -unconditional (Optional). Specifies that a source or target volume has been selected individually, and not as a pair. The -unconditional parameter is valid only if the -at parameter is selected. Do not use volume pair IDs. Notes: 1. The source volume ID must be specified when you specify the -at src parameter. 2. The target volume ID must be specified when you specify the -at tgt parameter. SourceVolumeID:TargetVolumeID . . . | (Required). Specifies that a Remote Mirror and Copy volume relationship for the source and target volume pairs with the specified IDs are to be paused. Note: Provide a single volume ID instead of a volume pair if you use the -unconditional parameter. Specifying pairs results in a format error. This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces.
406
A Remote Mirror and Copy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a Remote Mirror and Copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Note: Requests directed to target volumes are sent to the Storage Image identified by the -dev parameter or is embedded in the fully qualified single volume IDs. For DS8000, example of a fully qualified pair: IBM.2107-75FA120/0100:IBM.2107-75FA150/0100 Example of a shortened version: 0100:0100 Example of multiple pairs: 0101:0101 0102:0102 0103:0103
Example
Invoking the pausepprc command
dscli> pausepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
resumepprc
The resumepprc command resumes a remote mirror and copy (formerly PPRC) relationship for a volume pair.
resumepprc -dev storage_image_ID -remotedev storage_image_ID -type mmir gcp
-cascade
-tgtonline
-tgtread
-critmode
-suspend
-resetreserve
Parameters
Notes:
407
1. When you specify subsystem IDs, the source and target volumes are restricted to one LSS for the source and one LSS for the target. 2. When you use the -wait parameter, periodically issue the lspprc command. This command allows you to verify which of the states that the pair has reached during processing. 3. You cannot issue other commands while the -wait parameter is processing. The entire transaction must complete before you can proceed with commands other than status commands like list commands or show commands. -dev storage_image_ID (Optional) Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified source volume ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -remotedev storage_image_ID (Optional) Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified target volume ID or if you specify the -dev parameter. -type mmir | gcp (Required) Modifies one or more remote mirror and copy volume relationships to be either Metro Mirror (synchronous) or Global Copy (extended distance) relationships. mmir Metro Mirror processing maintains the remote mirror and copy relationship in a consistent (synchronous) manner when the updates are committed to the target. This process becomes slower as the physical distance between source and target increases. Global Copy processing maintains the remote mirror and copy relationship in a nonsynchronous manner when the updates are committed to the source. Updates to the target volume are performed at a later point in time. The original order of updates is not strictly maintained.
gcp
-cascade (Optional) Enables a remote mirror and copy target volume to be a remote mirror and copy source volume for a different remote mirror and copy volume relationship. -tgtonline (Optional) Establishes a remote mirror and copy volume relationship, including when the target volume is online to host systems. This parameter applies to S/390 or System z volumes. It does not apply to Open Systems volumes. -tgtread (Optional) Allows host servers to read from the remote mirror and copy target volume. For a host server to read the volume, the remote mirror and copy pair must be in a full-duplex state. This parameter applies to open systems volumes and does not apply to S/390 or System z volumes. The default value for this parameter is disabled. -critmode (Optional) Protects the source volume from receiving new data. If the last path fails between the pairs, which results in the inability to send information to the target, the source is protected. Current updates and subsequent attempts to update the source fail, with a unit check on S/390. -suspend (Optional) Specifies that the remote mirror and copy relationship be suspended when the task completes. This parameter is not valid for a Global Copy (extended distance) remote mirror and copy volume relationship. This parameter is not valid for a Metro Mirror (synchronous) remote mirror and copy volume relationship that is established with the No Copy option. -resetreserve (Optional) Establishes the remote mirror and copy relationship when the volume on the secondary
408
logical subsystem is reserved by another host. If this parameter is not specified and the volume on the secondary logical subsystem is reserved, the command fails. This parameter can only be used with fixed block volumes. -tgtse (Optional - DS8000 only) Specifies that the secondary volume might be a space-efficient logical volume. -disableautoresync (Optional - DS8000 only) Allows you to disable the mechanism that automatically resumes a suspended Global Copy relationship. The default is not disabled. The -disableautoresync parameter is available only in Version 5 Release 3 or later. -wait (Optional). Specifies that the command response be delayed until the remote copy and mirror volumes are in one of the final states: simplex, full duplex, suspended, secondary full duplex, secondary suspended or secondary simplex (until the pair is not in the Copy Pending state). This parameter cannot be used with the -type gcp or -mode nocp parameters. SourceVolumeID:TargetVolumeID . . . | (Required) Specifies that a remote mirror and copy volume relationship for the source and target volume pairs with the specified IDs be resumed. This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple remote mirror and copy pair IDs with spaces. A remote mirror and copy pair ID consists of two volume IDs: one designated as the source and the other as the target volume for a remote mirror and copy relationship. You must separate the two volume IDs of a remote mirror and copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the resumepprc command
dscli>resumepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
409
rmpprc
The rmpprc command removes a Remote Mirror and Copy volume pair relationship or removes a single volume ID. You can remove a single volume ID when a disaster occurs, which allows you to specify only the available volume and not both the primary and secondary volumes. You must specify either the -at src parameter option or the -at tgt parameter option when you process a single volume. If neither of these options are specified in the rmpprc command, a single volume cannot be processed. The -unconditional parameter must also be specified when you process a single volume; otherwise, an error occurs and the command process fails.
rmpprc -dev storage_image_ID -remotedev storage_image_ID -at src tgt
Parameters
Notes: 1. When you specify subsystem IDs, the source and target volumes are restricted to one LSS for the source and one LSS for the target. 2. If there is a communication problem between the primary server and the secondary server (two-site configuration) when the rmpprc command is issued, the following actions occur: v Error message CMUN03012E is issued. This error message indicates that there was a communication problem between the primary and secondary server and that the transaction has failed. However, a partial removal of the pair relationship has occurred. v The pair relationship is ended on either the primary volumes or the secondary volumes and the volumes that had the relationship removed enter a simplex state. If a volume is in a simplex state, the volume is not in a Copy Services relationship. If this circumstance has occurred, reissue the rmpprc command using the -at src or the -at tgt parameter and the -unconditional parameter for each volume that does not have its pair relationship removed. The following represents the format of the rmpprc command when you must remove a partial pair relationship: v If the source volume has not been removed from the pair relationship, enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -at src -unconditional SourceVolumeID
v If the target volume has not been removed from the pair relationship, enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -at tgt -unconditional TargetVolumeID
The value of the storage image ID must be the secondary server. The management console must be able to communicate with the secondary server for this command to process successfully. 3. If a disaster occurs involving a three-site configuration, the rmpprc command with the -at tgt and -unconditional parameters are used in the recovery process. -dev storage_image_ID (Optional). Specifies the source storage image ID, which includes manufacturer, machine type, and
410
serial number. The storage image ID is required if you do not specify a fully qualified ID for all source volumes, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -remotedev storage_image_ID (Optional most times). Specifies the target storage image ID, which includes manufacturer, machine type, and serial number. Note: The -remotedev parameter is required when volume pairs are specified and the -dev parameter is specified, as well. For DS6000, example: IBM.1750-68FA150 -at src | tgt (Optional). Specifies that you want to initiate a break action from either a source volume or a target volume. src tgt Select the -at src parameter option to initiate a break action from the source volume. After the task successfully runs, the source and target volumes are in the simplex state. Select the -at tgt parameter option to initiate a break action from the target volume. After the command successfully runs, the target volume is in the simplex state, but there is no guarantee that the source volume state will change. For a break action issued to the target, the source can remain in the suspend state. The -at tgt parameter option can also be used with single volumes but you must also specify the -unconditional parameter. When you specify a single volume using this parameter, the volume is treated as a target and the source is treated as a null. Notes: 1. If you specify the -at tgt or -at src parameter and the -unconditional parameter, the value for the -remotedev parameter is ignored. 2. If you specify the -at tgt parameter and do not specify the -unconditional parameter, the values for the -dev and SourceVolumeID parameters are ignored. 3. If you specify the -at src parameter and do not specify the -unconditional parameter, the values for the -remotedev and TargetVolumeID parameters are ignored. -unconditional (Optional). Specifies that a source or target volume has been selected individually, and not as a pair. The -unconditional parameter is valid only if the -at parameter is selected. Do not use volume pair IDs. Notes: 1. The source volume ID must be specified when you specify the -at src parameter. 2. The target volume ID must be specified when you specify the -at tgt parameter. -quiet (Optional). Turns off the Remote Mirror and Copy relationship removal confirmation prompt for this command. SourceVolumeID:TargetVolumeID . . . | (Required). Specifies the Remote Mirror and Copy volume relationship for the source and target volume pairs that is to be removed. Note: Provide a single volume ID instead of a volume pair if you use the -unconditional parameter. Specifying pairs results in a format error.
Chapter 4. CLI commands
411
This parameter accepts fully qualified volume IDs, which includes storage image IDs or a shortened version without storage image IDs, if the -dev parameter is specified. You must separate multiple Remote Mirror and Copy pair IDs with spaces. A Remote Mirror and Copy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a Remote Mirror and Copy relationship. You must separate the two volume IDs of a Remote Mirror and Copy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
Invoking the rmpprc command
dscli>rmpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
unfreezepprc
The unfreezepprc command resumes I/O activity on a storage unit where the freezepprc command has been issued. The unfreezepprc command resets the queue full condition for the primary volume. All queued writes to the source volume are written.
unfreezepprc -dev storage_image_ID -remotedev storage_image_ID
Parameters
Notes: 1. This command affects all remote copy and mirror primary volumes that are contained by the LSS(s) that are defined by the Source_LSS_ID:Target_LSS_ID source volume. 2. When specifying subsystem IDs, the command is limited to one LSS pair.
412
3. Resuming I/O activity on a storage unit where the freezepprc command has been issued is sometimes referred to as the thaw operation. -dev storage_image_ID (Optional). Specifies the source storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -remotedev storage_image_ID (Optional). Specifies the target storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified target LSS ID or if the -dev parameter is used. For DS6000, example: IBM.1750-68FA120 Source_LSS_ID:Target_LSS_ID . . . | (Required). Specifies that a consistency group for the source and target LSSs with the IDs specified be removed from the long busy state. This parameter accepts fully qualified LSS IDs, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. A remote mirror and copy path LSS pair ID consists of two LSS IDs, one designated as the source LSS and the other as the target LSS for a remote mirror and copy path relationship. The two LSS IDs must be separated with a colon and no spaces. Multiple remote mirror and copy path LSS pair IDs must be separated with a space between each value. The first LSS ID is the source LSS. The second LSS ID is the target LSS. The fully qualified LSS ID format is storage_image_ID/xx, where xx is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example pair: 00:00 Example of multiple pairs: 00:00 01:01 02:02
Example
Invoking the unfreezepprc command
dscli>unfreezepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 01:01
413
pausegmir Pauses Global Mirror processing for the specified session. There are 2 primary reasons to pause Global Mirror processing: v To repair a part of the Global Mirror infrastructure, such as: Global Copy volume pairs or FlashCopy pairs v To make modifications to the Global Mirror tuning parameters resumegmir Resumes Global Mirror processing for a specified session. If you have issued a pausegmir command to pause Global Mirror processing, issue the resumegmir command to continue Global Mirror processing. rmgmir Ends Global Mirror processing for the specified session. showgmir Generates two reports. The first report displays the detailed properties about the current Global Mirror operations that are associated with a specified logical subsystem ID. The second report displays the performance metrics for the current Global Mirror operations that are associated with a specified logical subsystem ID. lsgmir Displays a list of Global Mirror for the storage image of the specified logical subsystem (LSS). showgmircg Generates a report that displays the consistency group status for the specified Global Mirror session. showgmiroos Generates a report that displays the number of unsynchronized (out of sync) tracks for the specified Global Mirror session.
mkgmir
The mkgmir command starts Global Mirror for a specified session.
mkgmir -dev storage_image_ID -lss LSS_ID -cginterval -session -coordinate milliseconds -drain seconds seconds
session_ID
Parameters
Note: If you are using the Cisco MDS 9216 Multilayer Fabric Switch, you must not enable the write acceleration feature. The mkgmir command might fail if the write acceleration feature is enabled. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -lss LSS_ID (Required) Specifies the master logical subsystem (LSS) that receives the mkgmir command. This
414
parameter accepts a fully qualified master LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the-dev parameter is specified. -cginterval seconds (Optional) Specifies the consistency group interval time, in seconds. This number specifies how long to wait between the formation of consistency groups. If this number is not specified or is set to zero, consistency groups are formed continuously. The consistency group interval setting is required for a start action. If not specified, the default interval is zero. The consistency group interval setting can be modified for a resume action; otherwise, the interval that is specified for the start action is maintained. The maximum value is 65 535 seconds. -coordinate milliseconds (Optional) Specifies the maximum coordination interval, in milliseconds. This value indicates the maximum time that Global Mirror processing queues Primary/Host/IO to start forming a consistency group. The coordination interval setting is required for a start action. If this value is not specified, the default interval is 50 milliseconds. The coordination interval setting can be modified for a resume action: otherwise, the interval that is specified for the start action is maintained. The maximum value is 65 535 milliseconds. -drain seconds (Optional) Specifies the maximum consistency group drain time in seconds and the maximum amount of time that the consistent set of data is allowed to drain to the remote site before failing the current consistency group. The drain time setting is required for a start action. If the drain time is not specified, the default drain time is 30 seconds. The drain time setting can be modified for a resume action; otherwise, the time that is specified for the start action is maintained. -session session_ID (Required) Specifies that Global Mirror for the specified session be started or resumed. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. Example: 01 Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | (Optional) Specifies one or more Global Mirror associations. A Global Mirror association consists of two fully qualified LSS IDs. The first is designated as the master resource and the second is the subordinate resource between which a PPRC path has been established. An LSS ID is a two character value hexadecimal value in the following ranges: v 00 - FE, for a DS8000 model v 00 - 1F, for a DS6000 model You must separate the fully qualified LSS IDs of a Global Mirror association with a colon and no spaces. The master resource must be identical for all relationships. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode.
Example
Invoking the mkgmir command
dscli>mkgmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
415
pausegmir
The pausegmir command pauses Global Mirror for the specified session. |
pausegmir -dev -session session_ID storage_image_ID -withsecondary -lss ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 | -withsecondary (Optional) Specifies that once the Global Mirror session is paused, the secondary volumes will form a | consistent copy of the data set. | -lss ID (Required) Specifies the master logical subsystem (LSS) that receives the pausegmir command. Accepts a fully qualified master LSS ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 -session session_ID (Required) Specifies the session ID for which the Global Mirror process is to be paused. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. Example: 01 Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | (Optional). Specifies one or more Global Mirror path associations. A Global Mirror (Asynchronous PPRC) path association consists of two fully qualified LSS IDs, one designated as the master resource and the other as the subordinate resource between which a remote copy and mirror path has been established. A LSS ID is two hexadecimal characters in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. You must separate the fully qualified LSS IDs of a Global Mirror path association with a colon and no spaces. The master resource must be identical for all relationships. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. DS8000 example of one Global Mirror association with a single subordinate in the configuration: IBM.2107-75FA120/00:IBM.2107-75FA150/00 DS8000 example of multiple Global Mirror associations with two subordinates in the configuration: IBM.2107-75FA120/00:IBM.2107-75FA150/00 IBM.2107-75FA120/00:IBM.2107-75FA150/01 DS6000 example of one Global Mirror association with a single subordinate in the configuration: IBM.1750-68FA120/00:IBM.1750-68FA150/00
416
DS6000 example of multiple Global Mirror associations with two subordinates in the configuration: IBM.1750-68FA120/00:IBM.1750-68FA150/00 IBM.1750-68FA120/00:IBM.1750-68FA150/01
Example
Invoking the pausegmir command
dscli> pausegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
resumegmir
The resumegmir command resumes Global Mirror processing for a specified session.
resumegmir -dev storage_image_ID -session -cginterval seconds -coordinate milliseconds -drain seconds session_ID -lss LSS_ID
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -lss LSS_ID (Required). Specifies the master logical subsystem (LSS) that is to receive the resumegmir command. Accepts a fully qualified LSS ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is two hexadecimal digits in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. For DS8000, example of a fully qualified LSS ID: IBM.2107-75FA120/10 Tuning parameters consist of the following three values: -cginterval seconds, -coordinate milliseconds, -drain seconds Tuning parameters have default values applied to them from the microcode. However, you can choose to change those values. You must designate a value for each of the parameters even if you are changing only one value. For example, if you decide to change only the value on the -cginterval parameter from 0 to 1, your command must include the default values for the other two parameters. The following example is the same for a DS6000 with the exception of the storage image ID being different:
dscli>resumegmir IBM.2107-75FA120/10 -cginterval 1 -coordinate 50 -drain 30 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
417
-cginterval seconds: Specifies the consistency group interval time, in seconds. This number specifies how long to wait between the formation of consistency groups. If this number is not specified or is set to zero, consistency groups are formed continuously. The default value is 0. The maximum value is 65 535 seconds. -coordinate milliseconds: Specifies the maximum coordination interval, in milliseconds. This value indicates the maximum time that Global Mirror processing queues Primary/Host/IO to start forming a consistency group. The default value is 50 milliseconds. The maximum value is 65 535 milliseconds. -drain seconds: Specifies the maximum consistency group drain time in seconds and the maximum amount of time that the consistent set of data is allowed to drain to the remote site before failing the current consistency group. The default drain time is 30 seconds. -session session_ID (Required) Specifies the Global Mirror session that is to be started. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. Example: 01 Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | " - " (Optional). Specifies one or more Global Mirror path associations. A Global Mirror path association consists of two fully qualified LSS IDs. The first is designated as the master resource and the second is the subordinate resource between which a PPRC path has been established. A LSS ID is two hexadecimal characters in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. You must separate the fully qualified LSS IDs of a Global Mirror association with a colon and no spaces. The master resource must be identical for all relationships. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. DS8000 example of one Global Mirror association with a single subordinate in the configuration: IBM.2107-75FA120/00: IBM.2107-75FA150/00 DS8000 example of multiple Global Mirror associations with two subordinates in the configuration: IBM.2107-75FA120/00: IBM.2107-75FA150/00 IBM.2107-75FA120/00: IBM.2107-75FA150/01 DS6000 example of one Global Mirror association with a single subordinate in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 DS6000 example of multiple Global Mirror associations with two subordinates in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 IBM.1750-68FA120/00: IBM.1750-68FA150/01
Example
Invoking the resumegmir command
dscli>resumegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
rmgmir
The rmgmir command ends Global Mirror processing for the specified session.
rmgmir -dev storage_image_ID -quiet -force -subordinate -lss ID
418
-session
session_ID
Parameters
Note: Although this command might interrupt the formation of a consistency group, every attempt is made to preserve the previous consistent copy of the data on the FlashCopy target volumes. If, due to failures, this command cannot complete without compromising the consistent copy, the command stops processing and an error code is issued. If this occurs, reissue this command (rmgmir) with the -force parameter to force the command to stop the Global Mirror process. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -quiet (Optional) Turns off the end Global Mirror session confirmation prompt for this command. -force (Optional) Forces the Global Mirror process to stop regardless of the state of the Global Mirror associations. -subordinate (Optional) Indicates that the -lss parameter specifies a subordinate LSS ID. -lss ID (Required) Specifies the logical subsystem (LSS) that is participating in the Global Mirror session. Accepts a fully qualified LSS ID, which includes the storage image ID or a shortened version without the storage image ID, if the -dev parameter is specified. For DS8000, example of a fully qualified LSS ID: IBM.2107-75FA120/10 -session session_ID (Required) Specifies the session ID for which the Global Mirror path association will be removed. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. Example: 01 Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID . . . | (Optional) Specifies one or more Global Mirror path associations. A Global Mirror path association consists of two fully qualified LSS IDs. The first is designated as the master resource and the second is the subordinate resource between which there is a remote mirror and copy path. A LSS ID is two hexadecimal characters in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. You must separate the fully qualified LSS IDs of a Global Mirror association with a colon and no spaces. The master resource must be identical for all relationships. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. DS8000 example of one Global Mirror association with a single subordinate in the configuration: IBM.2107-75FA120/00: IBM.2107-75FA150/00
419
DS8000 example of multiple Global Mirror path associations with two subordinates in the configuration: IBM.2107-75FA120/00: IBM.2107-75FA150/00 IBM.2107-75FA120/00: IBM.2107-75FA150/01 DS6000 example of one Global Mirror path association with a single subordinate in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 DS6000 example of multiple Global Mirror path associations with two subordinates in the configuration: IBM.1750-68FA120/00: IBM.1750-68FA150/00 IBM.1750-68FA120/00: IBM.1750-68FA150/01
Example
Invoking the rmgmir command
dscli>rmgmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
showgmir
The showgmir command displays properties and performance metrics for a Global Mirror logical subsystem ID. You can issue this command on either the master storage unit or on any of the subordinate storage units. The report that is generated by this command varies significantly depending on which storage unit that you issue the command and the parameters that you specify.
showgmir -dev storage_image_ID -metrics -session session_ID LSS_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -metrics (Optional) Specifies that the logical subsystem ID and its performance statistics be displayed. -session session_ID (Optional) Specifies a session ID number. The number must be greater than 0 (01 - FF hexadecimal range). If you do not specify this parameter, all sessions will be displayed. LSS_ID | (Required) Specifies the logical subsystem (LSS) that receives the showgmir command. This parameter accepts a fully qualified LSS ID, which includes the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. The LSS ID is two hexadecimal digits in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. Note: The type of report that you receive is determined by the value that you specify for the LSS ID as follows:
420
v When you issue the showgmir command from the master storage unit and you specify an LSS ID that is the same type (both even numbers or both odd numbers) as the master, you receive the following results: Without the -metrics parameter: A properties report that includes the master information With the -metrics parameter: A properties and performance values report. v When you issue the showgmir command from the master storage unit and you specify an LSS ID that is not the same type (one even number and one odd number) as the master, you receive the following results: Without the -metrics parameter: A properties report that displays only the fully qualified LSS_ID value and all the other input fields display a " - " value. With the -metrics parameter: A properties and performance report that displays only the fully qualified LSS_ID value and all the other input fields display a " - " value. v When you issue the showgmir command from the subordinate storage unit and you specify an LSS ID that is the same type (both even numbers or both odd numbers) as the master, you receive the following results: Without the -metrics parameter: A detailed properties report that displays only the master information (fully-qualified LSS ID, master session ID, and master storage unit ID). All the other fields display as a " - " value. With the -metrics parameter: A detailed properties and performance values report that displays only the master information (fully qualified LSS ID, master session ID, and master storage unit ID). All the other fields display as a " - " value. v When you issue the showgmir command from the subordinate storage unit and you specify an LSS ID that is not the same type (one even number and one odd number) as the master, you receive the following results: Without the -metrics parameter: A properties report that displays only the fully qualified LSS_ID value. All the other input fields on the report display a " - " value. With the -metrics parameter: A properties and performance report that displays only the fully qualified LSS_ID value. All the other input fields on the report display a " - " value.
421
Master Count 1
Subordinate Count 1
Master Count Specifies the number of Global Mirror (asynchronous remote mirror and copy) masters. This value could be zero if none exist. When the value is zero, the master information fields of the report display a " - " value Master Session ID Identifies the session ID that you assigned, 01 - FF hexadecimal range. Copy State Identifies the Global Mirror (asynchronous remote mirror and copy) copy state. One of the following values is displayed: Running Indicates that the Global Mirror copy process is running. Paused Indicates that the Global Mirror session will be paused, that is, stopped from forming consistency groups, after the current consistency group has been formed. However, the secondary volumes in the Global Mirror session should not be considered to form a consistent data set. Another separate process is required to form a consistent data set on the secondary volumes. You can pause a session and later resume the session. Pause In Progress Indicates that the Global Mirror copy process is in the process of pausing. | | | | | Paused with Secondary Consistency Indicates that the Global Mirror session will be paused, that is, stopped from forming of consistency groups, after the current consistency group has been formed. However, all of the secondary volumes in the Global Mirror session already form a consistent data set. You can pause a session and later resume the session.
422
| | |
Paused because Resume Failed Indicates that an attempt to resume a Global Mirror session that is in the Paused state failed. The Global Mirror session is still in the Paused state. Fatal Indicates that the Global Mirror copy process is failed. Unowned Indicates that the session is not owned by the cluster that you specified using the LSS ID. Recovering Indicates that the Master is in the process of recovering the session. Fatal Reason Specifies a reason code for the failure. One of the following values is displayed: Time out Revert FLC Failed Timeout Revert FLC Failed Not Fatal Invalid Session ID Inaccessible or Failed Consistency Check Not Completed Consistency Check Failed Communication Failure CG Corrupted Busy Condition Preventing CG Interval Time (seconds) Specifies the consistency group interval time between attempts to form a consistency group, up to 65 535 seconds. Coord. Time (milliseconds) Specifies the maximum extended distance coordination interval. The default time is 50 milliseconds. Max CG Drain Time (seconds) Specifies the consistency group drain time. The consistency group drain time is the maximum time that the consistent set of data is allowed to drain to the remote site before failing the current consistency group. The maximum allowed time is 65 535 seconds. Current Time Indicates the time stamp for when this report was generated. The date is displayed in the MM/DD/YYYY format. The time is displayed in the HH:MM:SS format on a 24-hour clock. Note: If the clock is automatically adjusted at applicable times between standard and daylight saving time, daylight saving time is set to 1. If the clock is not automatically adjusted for daylight saving time, set to 0. For example, the report would display 12/04/2006 08:00:00 MST 0 if the clock is not automatically adjusted for daylight saving time. CG Time Specifies the recorded time stamp when the last successful consistency group was formed. Successful CG Percentage Specifies the percentage of successful attempts to form a consistency group, from 0% to 100%.
423
FlashCopy Sequence Number Specifies the FlashCopy sequence number that is associated with the current consistency group. Note: This value does not apply to a 2105; a " - " value is displayed in this column when a machine type 2105 is queried. Master ID Specifies the Global Mirror master storage image ID. Subordinate Count Specifies the count of subordinate associations (with an allowed value of 1 to 16). The master-subordinate association fields repeat according to this count. Master/Subordinate Assoc Specifies the Global Mirror path associations. A Global Mirror path association consists of two fully qualified LSS IDs. One ID is designated as the master resource and the other ID is designated as the subordinate resource; a remote mirror and copy path has been established between the two resources.
Successful CG Percentage 40
424
Total Failed CG Count Specifies the total number of consistency groups that did not complete in the user-specified drain time. Total Successful CG Count Identifies the total number of consistency groups that completed before the user-specified drain time. Successful CG Percentage Identifies the percentage of attempts that were successful in forming a consistency group. Failed CG after Last Success Specifies the total number of failed consistency groups after the last successful completion. Last Successful CG Form Time Identifies the last successful consistency group completion time. Coord. Time (milliseconds) Specifies the value in milliseconds that indicates the maximum amount of time that Global Mirror queues the primary host I/O to start forming a consistency group. The default is 50 milliseconds. CG Interval Time (seconds) Specifies the value in seconds that indicates how long to wait between formation of consistency groups. Max CG Drain Time (seconds) Specifies the value in seconds that indicates the maximum amount of time that Global Mirror allows for the consistent set of data to drain to the remote site. First Failure Control Unit Identifies the Control Unit MTS that has caused the first failure of the consistency group formation. First Failure LSS Identifies the LSS number that has caused the first failure of the consistency group formation. First Failure Status Indicates the first failure status of the consistency group formation. The First Failure Reason and First Failure Master State fields display data only when this field contains Error. First Failure Reason Specifies the error reason of the first failure of the consistency group formation attempt. First Failure Master State Identifies the master state for the first Global Mirror failure.
425
Last Failure Control Unit Identifies the Control Unit MTS that has caused the last failure of the consistency group formation. Last Failure LSS Identifies the LSS number that has caused the last failure of the consistency group formation. Last Failure Status Indicates the last failure status of the consistency group formation. The Last Failure Reason and Last Failure Master State fields display data only when this field contains Error. Last Failure Reason Specifies the error reason of the last failure of the consistency group formation attempt. Last Failure Master State Identifies the master state for the last Global Mirror failure. Previous Failure Control Unit Identifies the Control Unit MTS that has caused the previous failure of the consistency group formation. Previous Failure LSS Identifies the LSS number that has caused the previous failure of the consistency group formation. Previous Failure Status Indicates the previous failure status of the consistency group formation. The Previous Failure Reason and Previous Failure Master State fields display data only when this field contains Error. Previous Failure Reason Specifies the error reason of the previous failure of the consistency group formation attempt. Previous Failure Master State Specifies the master state for the previous Global Mirror failure.
lsgmir
The lsgmir command displays a list of Global Mirror for the storage image of the specified logical subsystem (LSS).
lsgmir -s -l -dev storage_image_ID -session session_ID LSS_ID " - "
Parameters
-s (Optional) Specifies that you want the system to display only the session ID for the LSS. You cannot use the -s and the -l parameters together. -l (Optional) Specifies that you want the system to display all the information that is associated with the session. You cannot use the -l and the -s parameters together. -dev storage_image_ID (Optional) Specifies the storage image ID, which consists of a value for manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified extent pool ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command.
426
-session session_ID (Optional) Specifies a session ID number. The number must be greater than 0 (01 - FF hexadecimal range). If you do not specify this parameter, all sessions will be displayed. LSS_ID | (Optional) Specifies the logical subsystem (LSS) ID for the Global Mirror session. A fully qualified LSS ID is accepted, which consists of the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The shortened version is a four-decimal digit number with no leading zeros, prefixed with the letter P. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following table represents the headers that are displayed on the output report that is associated with the lsgmir command using the -l parameter. Invoking the lsgmir command to display a list of Global Mirror for the storage image of the specified logical subsystem.
dscli> lsgmir -dev IBM.2107-75FA120
IBM.2107-75FA120 10
427
| | | | | |
consistency groups, after the current consistency group has been formed. However, all of the secondary volumes in the Global Mirror session already form a consistent data set. You can pause a session and later resume the session. Paused because Resume Failed Indicates that an attempt to resume a Global Mirror session that is in the Paused state failed. The Global Mirror session is still in the Paused state. Fatal Indicates that the Global Mirror copy process is failed. Unowned Indicates that the session is not owned by the cluster that you specified using the LSS ID. Recovering Indicates that the Master is in the process of recovering the session. %Success Indicates the percentage of successful attempts to form a consistency group. CGtime Indicates the time stamp of the last successful consistency group.
showgmircg
The showgmircg command displays consistency group status for the specified Global Mirror session.
showgmircg -dev storage_image_ID " - " -lss LSS_ID session_ID . . .
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -lss LSS_ID (Required) Specifies the master logical subsystem (LSS) that receives the showgmircg command. LSS ID consists of two hexadecimal characters in the range of 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. This parameter accepts a fully qualified master LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 session_ID . . . | (Required) Specifies one session to display. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. Example: 01
428
Example
Invoking the showgmircg command
dscli>showgmircg dev IBM.2107-75FA120 -lss 10 01
showgmiroos
The showgmiroos command displays the number of unsynchronized (out of sync) tracks for the specified Global Mirror session.
showgmiroos -dev storage_image_ID session_ID " - " -scope si lss -lss LSS_ID
Parameters
Note: You might want to use this command to assist you in the following circumstances: v To see how data is transferring. The showgmiroos command lets you see how far behind the remote site is from the local site in the transfer of data. The displayed value represents how many tracks must be transferred to catch up (be synchronized). v You are not able to form consistency groups because you have exceeded the maximum drain time. The number of tracks that are not synchronized might be an indicator that you must adjust some values to allow for complete processing. -dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -scope si | lss (Required) Specifies the scope of the data to be returned: storage image (si) or logical subsystem (lss). -lss LSS_ID (Required) Specifies the master logical subsystem (LSS) that receives the showgmiroos command. Accepts a fully qualified master LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. The LSS ID is two hexadecimal digits in the range 00 - FE for the DS8000 model. The DS6000 model value is in the range 00 - 1F.
429
For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 session_ID (Required) Specifies the session to display. A session ID is a Global Mirror session number that you assign in the 01 - FF hexadecimal range. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode.
Example
Invoking the showgmiroos command
dscli>showgmiroos dev IBM.2107-75FA120 -scope si -lss 10 01
chsession
The chsession command allows you to modify a Global Mirror session.
chsession -dev -volume volume_ID . . . storage_image_ID Session_ID " - " -lss ID -action add remove
430
Parameters
-dev storage_image_ID (Optional) Specifies the ID of the storage image containing the logical subsystem. The storage image ID includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -lss ID (Required) The logical subsystem (LSS) ID for the Global Mirror session. The format of the LSS ID is a hexadecimal number in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. This parameter accepts a fully qualified LSS ID, which includes either the storage image ID or a shortened version without the storage image ID if the -dev parameter is specified. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 -action add | remove (Required). add remove Specifies that volumes be removed from the session. -volume volume_ID . . . (Required) Specifies an array of one or more volume IDs or volume ID ranges to be added or removed for the Global Mirror session. All volumes must share a common logical subsystem. To specify a range of volume IDs, you must separate the volume IDs with a hyphen. To specify a combination of one or more volume IDs and a range of volume IDs, separate the volume IDs and ranges with commas. Do not qualify the volume ID with the storage image ID. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. Example of a volume ID: 0010 Example of a range of volume IDs: 0010-001F Example of multiple volume IDs and ranges: 0100-010F,0180-018F,0120 Session_ID | (Required) Specifies the Global Mirror session that is modified for this session ID. A session ID is a hexadecimal number in the range 01 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a session ID: 01 Specifies that volumes be added to the session.
431
Example
Invoking the chsession command
dscli>chsession -dev IBM.2107-75FA120 -lss 10 -action add -volume 1000-1010 01
mksession
The mksession command opens a Global Mirror session.
mksession -dev storage_image_ID -lss ID -volume volume_ID . . . Session_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the logical subsystem, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -lss ID (Required) Creates a Global Mirror session for this logical subsystem. Accepts a fully qualified LSS ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. The LSS ID is a hexadecimal number in the range of 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 -volume volume_ID . . . (Optional) Specifies an array of one or more volume IDs or a range of volume IDs to be included in the Global Mirror session. All volumes must share a common logical subsystem. To specify a range of volume IDs, you must separate the volume IDs with a hyphen. To specify a combination of one or more volume IDs and a range of volume IDs, separate the volume IDs and ranges with commas. Do not qualify the volume ID with the storage image ID. The volume ID is a 32 bit number that can be represented as 4 hexadecimal digits in the form of XYZZ, where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1.
432
Example of a volume ID: 0010 Example of a range of volume IDs: 0010-001F Example of multiple volume IDs and ranges: 0100-010F,0180-018F,0120 Session_ID | (Required) Specifies the session ID for which Global Mirror processing is allowed. A session ID is a hexadecimal number in the range 01 - FF. If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode. Example of a session ID: 01
Example
Invoking the mksession command
dscli>mksession -dev IBM.2107-75FA120 -lss 10 volume 1000-100F 01
lssession
The lssession command displays a list of Global Mirror sessions for a logical subsystem (LSS) and information regarding the volumes of each session in the list.
lssession -dev storage_image_ID -s -l LSS_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -s (Optional) Displays the session IDs. You cannot use the -l and the -s parameters together. -l (Optional) Displays the default output. You cannot use the -l and the -s parameters together. LSS_ID | (Required) Specifies the logical subsystem (LSS) ID for the Global Mirror session. The format of the LSS ID is a hexadecimal value in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. This parameter accepts a fully qualified LSS ID, which includes the storage image ID, or a shortened version without the storage image ID if the -dev parameter is specified. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10
433
Example
For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables. The following tables represent the headers that are displayed on the output report that is associated with the lssession command using the -l parameter. When you use the -s parameter with the lssession command only 3 ID items are displayed in the resulting report: LSSID, SessionID, and VolumeID. A separate example is shown for this scenario. Invoking the lssession command using the -l parameter
dscli>lssession dev IBM.2107-75FA120 -l 01
01
Normal
Active
01
Normal
Active
02
Normal
Active
02
Normal
02
Normal
PrimaryStatus Primary Full Duplex Primary Full Duplex Primary Full Duplex
FirstPassComplete True
AllowCascading Disabled
True
Disabled
True
Disabled
434
FirstPassComplete True
AllowCascading Disabled
True
Disabled Disabled
False
435
Remove Pending Indicates that the volume is active for the current session. However, it is removed in the next cycle. Active Indicates that the volume is an active member of the session. PrimaryStatus Specifies the primary remote copy and mirror status of the volume. One of the following values is displayed: Primary Simplex Indicates that the volume is not part of a remote mirror and copy relationship. Primary Copy Pending Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is in a Copy Pending state, which means that the source and target volume are out-of-sync. In this situation, data still needs to be copied from the source to the target volume. Primary Full Duplex Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is in a Full Duplex state, which means that the copy operation has completed and the volume pair is synchronized, and that any updates to the primary volume are transferred synchronously to the secondary volume. Primary Suspended Indicates that the volume is primary in a remote mirror and copy relationship and the relationship is suspended, which means that the primary is no longer transferring data to the secondary, and any changed data that is at the primary is tracked in an out-of-sync bitmap. "-" Indicates that there are no active volumes for the session.
SecondaryStatus Specifies the secondary remote copy and mirror status of the volume. One of the following values is displayed: Secondary Simplex Indicates that the volume is not part of a remote mirror and copy relationship. Secondary Copy Pending Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is in a Copy Pending state, which means that the source and target volume are out-of-sync. In this situation, data still needs to be copied from the source to the target volume. Secondary Full Duplex Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is in a Full Duplex state, which means that the copy operation has completed and the volume pair is synchronized, and that any updates to the secondary volume are transferred synchronously from the primary volume. Secondary Suspended Indicates that the volume is secondary in a remote mirror and copy relationship and the relationship is suspended, which means that the primary is no longer transferring data to the secondary, and any changed data that is at the primary is tracked in an Out of Sync bitmap. "-" Indicates that there are no active volumes for the session.
FirstPassComplete Specifies whether the first cycle of the volume in the global mirror relationship has ended. The value displayed is either True or False.
436
AllowCascading Specifies whether the volume can be a secondary in a remote mirror and copy relationship. The value displayed is either Enabled or Disabled.
rmsession
The rmsession command closes an existing Global Mirror session.
rmsession -dev storage_image_ID -lss ID -quiet Session_ID " - "
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. For DS8000, example: IBM.2107-75FA120 -lss ID (Required) Specifies the logical subsystem (LSS) ID for the Global Mirror session that is being closed. The format of the LSS ID is a hexadecimal value in the range 00 - FE for the DS8000. The DS6000 value is in the range 00 - 1F. This parameter accepts a fully qualified LSS ID, which includes the storage image ID, or shortened version without the storage image ID if the -dev parameter is specified. For DS6000, example of a fully qualified LSS ID: IBM.1750-68FA120/10 -quiet (Optional) Turns off the end Global Mirror session confirmation prompt for this command. Session_ID | (Required) Specifies the session ID on which Global Mirror processing is to be closed. A session ID is a hexadecimal number in the range 01 - FF. If you use the dash (-), the specified value is read from standard input. However, you cannot use the dash (-) if you are using the DS CLI interactive mode. Example of a session ID: 01
Example
Invoking the rmsession command
dscli>rmsession -dev IBM.2107-75FA120 -lss 10 01
437
offloadauditlog Generates an activity report for a console that includes basic information, such as, a list of who logged in, when they logged in, and what they did during their session. offloadfile Offloads the specified set of data files.
offloadauditlog
The offloadauditlog command provides an activity report for a console (identified as smc1 or smc2). The report includes basic information, such as, a list of who logged in, when they logged in, and what they did during their session. In addition, a log of service actions (phone connection started, phone connection ended management console session started, management console session ended) is appended to the end of the audit log.
offloadauditlog -logaddr smc1 smc2 audit_log_file -quiet
Parameters
Notes: 1. Only users with administrator authority are authorized to use this command. 2. A separate log entry is added each time a resource is created, deleted, modified. Entries are added to the audit file only after the operation has completed. 3. You must periodically extract the log using the offloadauditlog command and save the log file in a directory of your choice. The log file is automatically reduced (old entries removed first) by the subsystem so that it does not consume more than 50 megabytes of disk storage. When the log is 60% full, an entry ("Audit_Log_At_60%") is placed in the audit log. Another entry is added when the log is 75% ("Audit_Log_At_75%") full. At 100%, the log is reduced to 50% full. 4. When viewing the service actions section of the report, there might be cases where a management console session started entry might not have a corresponding management console session ended entry. 5. As noted in the example of the report, the service action report begins after the line of text that states:
"-----BEGIN SERVICE AUDIT LOG-----"
-logaddr smc1|smc2 (Required) Specifies that the audit log be offloaded for the designated storage management console. The designated storage management console must be configured and available to offload the audit log successfully. -quiet (Optional) Turns off the confirmation prompt for replacing an existing audit log. audit_log_file (Required) Specifies the file name to which the audit log entries are extracted. Note: If you specify a file name that contains prior log entries, these entries are overwritten with the current data.
438
Example
Note: The following example displays only a portion of an actual Service action report appended to the end of the Audit log report. Invoking the offloadauditlog command
dscli>dscli> offloadauditlog logaddr smc1 auditlog-200509.txt
Representative report The following is an example of the report information that is extracted when you use the offloadauditlog command (the wrapping is done simply for clarity and is not representative of your actual report):
U,2005/10/04 15:08:46:834 MST,admin,1,,W,1002,User_Login_Fail,,1, "IP = N996304B.tucson.ibm.com/9.11.178.201" U,2005/10/04 15:29:37:432 MST,admin,1,,W,1001,User_Login_Expire,,0, "IP = N996304B.tucson.ibm.com/9.11.178.201" U,2005/10/04 15:32:56:979 MST,admin,1,,N,1000,User_Login,,0, "IP = N996304B.tucson.ibm.com/9.11.178.201" U,2005/10/04 15:34:21:020 MST,admin,1,,N,1000,User_Login,,0, "IP = N996304B.tucson.ibm.com/9.11.178.201" U,2005/10/05 16:54:32:171 MST,admin,1,,N,1103, User_Password_Change,,be741104,"userName = admin" S,2005/10/06 00:01:10:239 MST,,1,,W,1200,Audit_Log_At_60%,,,"" U,2005/10/06 00:23:09:817 MST,admin,1,IBM.2107-AZ12341,N,2050, Array_Create,A0,0,"A0" U,2005/10/06 00:23:10:518 MST,admin,1,IBM.2107-AZ12341,N,2060, Rank_Create,R0,-1,"R0" U,2005/10/06 00:23:12:110 MST,admin,1,IBM.2107-AZ12341,N,2070, XPool_Create,P0,0,"P0" U,2005/10/06 00:23:12:761 MST,admin,1,,N,2073,XPool_Assign_Rank,,,"" U,2005/10/06 00:23:16:947 MST,admin,1,IBM.2107-AZ12341,N,2090, Volume_Create,1000,0,"1000" U,2005/10/06 00:23:17:187 MST,admin,1,IBM.2107-AZ12341,N,2090, Volume_Create,1001,,"1001" S,2005/10/06 00:23:24:508 MST,,1,,W,1201,Audit_Log_At_75%,,,"" U,2005/10/06 12:47:16:345 MST,admin,1,IBM.2107-AZ12341,N,2092, Volume_Delete,2005,0,"2005" U,2005/10/06 12:47:16:656 MST,admin,1,IBM.2107-AZ12341,N,2092, Volume_Delete,2006,-1,"2006" -----BEGIN SERVICE AUDIT LOG----U,2007/08/21 12:05:24:000 MST,CE,1,IBM.2107-75R0830,N,8020, Web_SM_session_start,Web_SM_session_started,,, U,2007/08/21 12:05:27:000 MST,CE,1,IBM.2107-75R0830,N,8022, Web_SM_session_ended,,,, U,2007/08/24 11:59:36:000 MST,CE,1,IBM.2107-75R0830,N,8020, Web_SM_session_start,Web_SM_session_started,,, U,2007/08/24 12:02:31:000 MST,CE,1,IBM.2107-75R0830,N,8022, Web_SM_session_ended,,,, U,2007/08/30 11:36:21:000 MST,CE,1,IBM.2107-75R0830,N,8020, Web_SM_session_start,Web_SM_session_started,,, U,2007/08/30 11:38:37:000 MST,CE,1,IBM.2107-75R0830,N,8022, Web_SM_session_ended,,,, U,2007/09/04 16:19:36:000 MST,,1,IBM.2107-75R0830,N,8022, Web_SM_session_ended,,,,
439
U C
Represents the date, time, and time zone of the log entry. Represents the user account that is making the request. Represents the management console that processed the user request. Represents the storage image ID that consists of the following values: manufacture, type, and serial number. Represents the following message types: N = notification, W = warning, and C = critical. Represents the unique identifier that is associated with the activity that is represented by the log entry. A text description that corresponds to the Entry ID. Represents a unique identifier that identifies the object. Represents the final result code. Represents unformatted text that includes input parameters in the format: attr1 = value1, attr2 = value2 with a comma (,) separator between parameters and double quotation marks around the entire field.
NWC
1 char
Entry ID
4 char
440
offloadfile
The offloadfile command offloads the specified set of data files. This command is not supported on DS6000 models.
offloadfile -dev storage_image_ID -auditlog -sdocert -etdata -hmc 1 2 all -quiet
directory
Parameters
-dev storage_image_ID (Optional) Specifies the storage image ID, which includes manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified LSS ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter will temporarily override any defined value for devid for the current command. -auditlog | -sdocert | -etdata (Optional) Only one of the following parameter options can be chosen when issuing the command: -auditlog Offloads one file containing the audit log for the management console server. -sdocert Offloads the SDO certificate for each storage facility. -etdata Offloads two files containing the IBM System Storage Easy Tier summary data. -hmc 1 | 2 | all (Optional) Specifies the HMC on which you want to offload files from. -hmc 1 specifies the primary HMC, and -hmc 2 specifies the secondary HMC. The default value all specifies the primary HMC on a single HMC system, and specifies both the primary and secondary HMCs on a dual HMC system. -quiet (Optional) Turns off the confirmation prompt for replacing an existing file. directory (Required) Specifies the local directory path that is used as the destination for offloading files.
Example
Invoking the offloadfile command
dscli>offloadfile -dev IBM.2107-75FA120 -etdata C:\temp
441
442
Note: All the examples provided in the described tasks are based on the premise of using the interactive mode of DS CLI. If you were processing many transactions, you would likely use the script mode to process your transactions.
Creating extent pools for fixed block volumes using the DS CLI
Complete this task to create fixed block volume extent pools. This is the first step in configuring new fixed block storage. You can use the DS CLI commands to create extent pools for fixed block volumes.
443
Each extent pool is defined with the rank group of 0 or 1 and a storage type of fb. You must define one extent pool for each rank group and storage type combination. This means that you must make a minimum of two extent pools for a storage unit that contains fixed block storage: one fixed block extent pool per rank group. Extent pools that are defined for rank group 0 or 1 are assigned an even- or odd-numbered extent pool ID, respectively. Even-numbered extent pools are managed by storage server ID 0. Odd-numbered extent pools are managed by storage server ID 1. Each rank is assigned to one extent pool; therefore, storage server workload is affected by the rank assignments to even- and odd-numbered extent pool IDs. It is better to evenly distribute rank and extent pool allocations to keep the storage server workloads balanced. You can create more than the minimum number of extent pools. For example, you can define unique extent pools for each RAID type (5, 6 or 10) that is configured in a storage image. Or, you can define and name extent pools according to the host system attachments that access the volumes that are created from extent pool extents. You can have the same number of extent pools as ranks. i5/OS considerations i5/OS supports only specific volume sizes and these might not be an exact number of extents. i5/OS | volumes are defined in decimal gigabytes (GB). You can use the following table when you are creating the logical volumes for use with i5/OS. You will notice that in almost every case, the i5/OS device size does not match a whole number of extents, so some space can be wasted for you specific configuration.
i5/OS Device size (decimal gigabytes) 8.5 17.5 35.1 70.5 141.1 282.2 Unusable space (binary gigabytes) 0.00 0.66 0.25 0.28 0.56 0.13
Number of LBAs 16 777 216 34 275 328 68 681 728 137 822 208 275 644 416 551 288 832
Note: Only Ax2, Ax4 and Ax5 models are supported as external LSU LUNs.
444
Procedure
1. Issue the mkextpool command to create the fixed block extent pool for rank group 0. Enter the mkextpool command at the dscli command prompt with the following parameters and variables:
dscli>mkextpool -dev storage_image_ID -rankgroup [0 | 1] -stgtype fb extent_pool_name
Example
dscli>mkextpool -dev IBM.2107-75FA120 -rankgrp 0 -stgtype fb P0
where P0 represents the extent pool name that you assign. This name can be 16 double-byte characters. 2. Press Enter. A successful process displays the following message:
Extent pool P0 successfully created.
Note: The unique name that you assigned to the extent pool does not display in the process message. However, when you issue the lsextpool command, the extent pool name is displayed. 3. Repeat Step 1 for each extent pool that you want to create. Try to evenly distribute rank and extent pool allocations to keep the storage server workloads balanced. 4. Verify the extent pool assignments by issuing the lsextpool command when you are done creating the extent pools. Use the -l parameter to display a full report for the extent pools that are assigned to the storage unit. Enter the lsextpool command at the dscli command prompt with the following parameters and variables:
dscli>lsextpool -dev storage_image_ID -l
Example
dscli>lsextpool dev IBM.2107-75FA120 -l
445
Perform the following steps to create an array from unassigned array sites: Note: You can issue the commands that are described in the steps either for a DS8000 model or for a DS6000 model, but for the DS6000 model the storage image ID is different.
Procedure
1. Issue the lsarraysite command to view a list of array site IDs for all installed array sites. Review those arrays that are designated with the state of unassigned. Enter the lsarraysite command at the dscli command prompt with the following parameters and variables:
dscli>lsarraysite -dev storage_image_ID -state unassigned
Note: If this is your first time creating fixed block volumes, all the arrays are displayed with a state of unassigned. 2. Press Enter. A report of unassigned array sites is displayed. Use the list to identify unassigned array site capacity, rpm, and device adapter (DA) pair attributes. Record the RAID type for each array site. 3. Issue the mkarray command to create an array from either one or two array sites (DS6000) or one array site (DS8000) with the status "unassigned". Enter the mkarray command at the dscli command prompt with the following parameters and variables:
dscli>mkarray -dev storage_image_ID -raidtype [5 | 6 | 10] -arsite array_site
Consider the following when you create the arrays: For DS8000, v Specify one array site with identical capacity, rpm, interface, and DA pair attributes. v The new array inherits the capacity, rpm, interface, and DA pair characteristics of its parent array site. v The state of the array remains unassigned until it is assigned to a rank. For DS6000, v Specify one or two array sites with identical capacity, rpm, interface, and DA pair attributes. v The new array inherits the capacity, rpm, interface, and DA pair characteristics of its parent array sites. v The state of the array remains unassigned until it is assigned to a rank. 4. Repeat Step 3 until all unassigned array sites have been assigned to an array. 5. Verify that the array-to-array site assignment is recognized and complete by issuing either the lsarray or lsarraysite command with the -l parameter.
446
Procedure
1. Ensure you have a list of the unassigned arrays for which ranks must be assigned. Issue the lsarray command to obtain this list if you do not already have it. Enter the lsarray command at the dscli command prompt with the following parameters and variables:
dscli>lsarray -dev IBM.2107-75FA120 -state unassigned
2. Issue the mkrank command to assign a rank to rank group 0 or 1 according to the rank group number of the assigned extent pool ID. Enter the mkrank command at the dscli command prompt with the following parameters and variables:
mkrank -dev IBM.2107-75FA120 -array A44 -stgtype fb -extpool P1
Notes: a. You can specify either the -wait or the -extpool parameter when you use the mkrank command. Either of these parameters allows you to be notified if the rank configuration has failed for any reason. b. If you use the -wait parameter, you cannot issue other commands until the entire transaction has processed. 3. Press Enter to display a report of rank assignments for your entire storage unit. Because the process of creating the rank involves formatting drives, it could take some time before the process finishes. If you want to check on the process, you can issue the lsrank command from a different DS CLI session. A successful process displays the following type of message:
Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Device: IBM.2107-75FA120 Rank IBM.2107-75FA120/R44 successfully created.
4. Repeat Step 2 until all unassigned arrays are assigned a rank and an extent pool. 5. Issue the lsrank command to verify that ranks and extent pools have been assigned. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli>lsrank -dev IBM.2107-75FA120 -l
6. Press Enter to display a report of the rank assignments for your entire storage unit.
447
Procedure
1. View your list of fixed block extent pool IDs and determine which extent pool IDs that you want to use as the source for the fixed block logical volumes. You obtained this list when you first created your extent pools. If this list is not available, issue the lsextpool command to obtain the list of extent pool IDs. Enter the lsextpool command at the dscli command prompt with the following parameters and variables:
dscli> lsextpool -dev IBM.2107-13AAD7A -stgtype fb -l
Extent pool attributes determine the size and quantity of volumes that can be created. The extent pool ID (even/odd) indicates the storage server (0|1), which dictates that the LSS ID component of the volume ID must be an even or an odd number. 2. Issue the lsaddressgrp command to find unassigned and available address groups. Enter the lsaddressgrp command at the dscli command prompt with the following parameters and variables: dscli> lsaddressgrp -dev IBM.2107-75FA120 -l An address group refers to a group of LSSs. Up to 16 LSSs can be grouped into one address group. All LSSs in an address group must be of the same format (CKD or fixed block). Note: If you are creating fixed block volumes for the first time, all the address groups are displayed with a state of "unassigned". 3. Analyze the address group list to determine which LSSs can be used to make fixed block volumes. Consider the following conditions when doing your analysis: v If the address group list is empty, then all address groups are available to be defined (0 - 3). v If an undefined address group is used to create new fixed block volumes, select the lowest numbered address group. v If you are adding new fixed block volumes to an existing fixed block address group, use the lslss command to identify LSSs that are already defined in the target address group. 4. Issue the mkfbvol command to create fixed block volumes for the specified LSS. Enter the mkfbvol command at the dscli command prompt with the following parameters and variables:
dscli> mkfbvol -dev IBM.2107-75FA120 -extpool P1 -name finance#d -cap 8.6 0100-010F
Consider the following conditions regarding the command example in this step: v All volumes can have the same type and capacity attributes. v The -extpool parameter identifies a fixed block extent pool containing available data extents. v The -name parameter allows you to assign an easy-to-use label or nickname to the volume. The volume name parameter can include a wildcard (#d or #h) that inserts a decimal or hexadecimal volume ID value into the volume name. Note: The decimal designation does not apply to the volume ID number or the number of volumes that were created by the command. It only applies to the unique name that you have assigned. Also, when you process this command, the volume name that you have assigned does not appear in the confirmation message. To view the volume name that you have assigned, issue the lsfbvol or showfbvol command. v The -cap (capacity) parameter is 8.6 GiB. The default is in gibibytes (GiB) where 1 GiB = 1 073 741 824 (2^30 bytes) v The example provides a range of numbers (0100 - 010F) for the number of volumes to be created. Because volumes are created using the hexadecimal numbering system, the range in the example creates 16 volumes. The actual number of volumes that can be created is 255 per LSS based on the following criteria:
| |
448
The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E. ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. For DS8000, you can define up to 255 LSSs in a storage unit. LSSs are either CKD or fixed block. Even numbered LSSs have an association with storage unit server 0. Odd numbered LSSs have an association with storage unit server 1. DS6000 has a 16 384 volume address space that is partitioned into 64 logical subsystem (LSS) units, where each LSS contains 256 logical volume numbers. The 64 LSS units are assigned to one of 4 address groups, where each address group contains 16 LSSs, or 4096 volume addresses. All of the LSSs in one address group must be of the same type (CKD or fixed block). 5. Repeat step 4 for all of the required logical volumes for each LSS. 6. Issue the lsfbvol command to display a report you can use to confirm the status of your fixed block volumes. Enter the lsfbvol command at the dscli command prompt with the following parameters and variables:
dscli> lsfbvol -dev IBM.2107-75FA120 -l -volgrp V2,V20
Note: The report can display that there was a configuration error that is associated with one or more of your mkfbvol transactions.
449
v LSS numbers FF (DS8000) and 1F (DS6000) is reserved for internal use and must not be used as a volume ID. v You must define each volume as protected or unprotected. This action is simply a notification to i5/OS; it does not mean that the volume is protected or unprotected. In reality, all LUNs are protected, either by RAID 5, RAID 6 or RAID 10. Defining a volume as unprotected means that it is available for i5/OS to mirror that volume to another internal or external volume of equal capacity. Unless you intend to use i5/OS (host based) mirroring, define your logical volumes as protected. Under some circumstances, you might want to mirror the i5/OS internal Load Source Unit (LSU) to a LUN in the DS6000 or the DS8000. In this case, define only one LUN volume as unprotected; otherwise, i5/OS attempts to mirror all unprotected volumes. v In general, it is best to use one LSS for volumes from one rank. Perform the following steps to create fixed block LUN volumes:
Procedure
1. View your list of fixed block extent pool IDs and determine which extent pool IDs that you want to use as the source for the fixed block logical volumes. You obtained this list when you first created your extent pools. If this list is not available, issue the lsextpool command to obtain the list of extent pool IDs. Enter the lsextpool command at the dscli command prompt with the following parameters and variables:
dscli>lsextpool -dev IBM.2107-75FA120 -stgtype fb -l
Extent pool attributes determine the size and quantity of volumes that can be created. The extent pool ID (even | odd) indicates the storage server (0 | 1), which dictates that the LSS ID component of the volume ID must be an even or an odd number. 2. Issue the mkfbvol command to create fixed block LUN volumes for the specified LSS. Enter the mkfbvol command at the dscli command prompt with the following parameters and variables:
dscli>mkfbvol -dev IBM.2107-75FA120 -extpool p0 -os400 A05 -name i5_unprot_#h 1001-1002
Consider the following conditions regarding the command example in this step: v The -extpool parameter identifies a fixed block extent pool containing available data extents. v The -os400 parameter allows you to designate the size and protection of a LUN volume by specifying the volume model. The example shows LUN volumes of protected model type A05 with a size of 35.1 decimal gigabytes (GB). v The -name parameter allows you to assign an easy-to-use label or nickname to the volume. The volume name parameter can include a wildcard (#d or #h) that inserts a decimal or hexadecimal volume ID value into the volume name. Note: The hexadecimal designation does not apply to the volume ID number or the number of volumes that were created by the command. It only applies to the unique name that you have assigned. Also, when you process this command, the volume name that you have assigned does not appear in the confirmation message. To view the volume name that you have assigned, issue the lsfbvol or showfbvol command. v The example provides a range of numbers (0101 - 0102) for the number of volumes to be created. The actual number of volumes that can be created is 255 per LSS based on the following criteria: The volume ID is a 32 bit number that can be represented as four hexadecimal digits in the form of XYZZ where: XY (for a DS8000 model) Specifies the logical subsystem number, 00 - FE. XY (for a DS6000 model) Specifies the logical subsystem number, 00 - 1E.
450
ZZ (for DS6000 and DS8000 models) Specifies the volume number, 00 - FF. X (for DS6000 and DS8000 models) Specifies the address group, 0 - 1. You can define up to 255 (for DS8000) or 31 (for DS6000) LSSs in a storage unit. Even numbered LSSs have an association with storage unit server 0. Odd numbered LSSs have an association with storage unit server 1. LSS numbers FF (DS8000) and 1F (DS6000) is reserved. 3. Repeat step 2 for all of the required logical volumes for each LSS. 4. Issue the lsfbvol command to display a report you can use to confirm the status of your LUN volumes. Enter the lsfbvol command at the dscli command prompt with the following parameters and variables:
dscli>lsfbvol -dev IBM.2107-75FA120 -l
Procedure
1. Add the -v (verbose) command parameters to your mkfbvol command, and reissue the command for the transactions that show the configuration error designation. Note: You can also turn on the verbose mode in your profile file, and reissue the command. If you designate the verbose mode, the display of extra output includes the error code that is generated when the create rank transaction fails. 2. Issue the rmfbvol command to delete the designated volume configurations if you do not want to obtain additional information about what caused the configuration error. Note: In the majority of instances, this is the only method for correcting a configuration error.
451
Procedure
1. Issue the mkvolgrp command to create a fixed block volume group. Enter the mkvolgrp command at the dscli command prompt with the following parameters and variables: Note: Repeat this step for each volume group that you want to create.
dscli> mkvolgrp -dev IBM.2107-75FA120 -hosttype pSeries -volume 0001-0010,0120 my_nickname
Notes: a. You can use the -hosttype parameter with the mkvolgrp command. This parameter is an easier way of specifying the type of volume group. If you do not use the -hosttype parameter, it is assumed that the volume group type is scsimask. b. You cannot use the -type parameter and the -hosttype parameter together. c. If your volume group is not scsimask type and you do not want to use the -hosttype parameter, use the -type parameter. scsimask as the default value of the -type parameter; you can also specify scsimap256 or os400mask as your volume group type. Because you need to know the criteria that is associated with these volume group types, see the mkvolgrp command for more information. d. Volume IDs must meet the following criteria: v ID ranges must be separated by a comma (displayed as 0001-0010,0120 in the example). v For scsimap256, the array or ranges cannot exceed 256 volume ID entries. Otherwise, up to 64 384 entries are allowed. v Use the -type 0s400mask parameter if the volume group is limited to fixed block volume OS400-protected or OS400-unprotected types. Otherwise, the volume group is limited to the fixed block volume type DS8000 or DS6000 machine type. v The volume group name (my_nickname in the example command) must be unique within the scope of the specified storage image. 2. Issue the lsvolgrp command to create a list of assigned volume group IDs. Enter the lsvolgrp command at the dscli command prompt with the following parameters and variables:
dscli> lsvolgrp -dev IBM.2107-75FA120 -l
Notes: a. The lsvolgrp command with the -l parameter displays a report with the following 3 values: v Name (the unique name that you assigned to the volume group) v Volume group ID v Type (the configured volume group type)
452
b. You can narrow the scope of the report by requesting a specific type of volume. See the lsvolgrp command for information about the -type parameter.
Procedure
1. Issue the mkvolgrp command to create a volume group. Enter the mkvolgrp command at the dscli command prompt with the following parameters and variables: Note: Repeat this step for each volume group that you want to create. The following two examples provide the commands that you can use to create volume groups depending on whether you use the external load source. The first example creates a volume group that contains one unprotected volume if you do use an external load source. (If you are using an external load source, you can initially only have one volume in the volume group.) The second example creates a volume group that contains all volumes if you do not use an external load source. Example 1 (using an external load source)
dscli>mkvolgrp -dev IBM.2107-13ABVDA -hosttype iSeries -volume 1000 blue
Notes: a. The confirmation message for the end process shows that the created volume group is automatically assigned an ID that is different from the name of the volume group that you specify in the command. You will see the name that you assigned associated with the
453
volume group when you use the lsvolgrp and showvolgrp commands. However, if you want to work specifically with the volume group, you must reference the volume group ID. b. This volume group is also referred to as SCSI520-MASK. When an error message is displayed for the OS400 MASK, SCSI520-MASK is referenced instead. c. If you do not use an external load source, it is a good practice to create a volume group that contains all the volumes that will be assigned to the i5 Fibre Channel adapter. d. Some System i models only support 32 device addresses per volume group. 2. Issue the lsvolgrp command to create a list of assigned volume group IDs. Enter the lsvolgrp command at the dscli command prompt with the following parameters and variables:
dscli>lsvolgrp -dev IBM.2107-13ABVDA -l
Notes: a. The lsvolgrp command with the -l parameter displays a report with the following three values: v Name (the unique name that you assigned to the volume group) v Volume group ID (the identification number of the volume group) v Type (the configured volume group type) b. You can narrow the scope of the report by requesting a specific type of volume. See the lsvolgrp command for information about the -type parameter. 3. Verify your host type information by issuing the lshosttype command using the following command format at the dscli command prompt:
dscli>lshosttype -type os400mask
Note: You can obtain the same results if you use the -type os400all parameter.
454
ficon (coded as ficon in the setioport command) Enables the FICON ULP with a point-to-point or switched fabric topology. PPRC path I/O operations are not supported for FICON ULP.
Procedure
1. View a list of Fibre Channel port IDs by typing the following command format at the dscli command prompt:
dscli> lsioport -dev IBM.210775FA120 -l -type fc
A detailed report is displayed that lists the Fibre Channel I/O ports. 2. Analyze the report and determine which I/O port IDs that you want to access the fixed block volumes. Configure a minimum of four I/O ports for SCSI host I/O operations. Select ports with physical locations on different host bus adapter (HA) cards. If possible, locate the HA cards in different I/O enclosures. 3. Set the I/O ports that you have identified to enable the FC-AL (Fibre Channel arbitrated loop), SCSI-FCP, or FICON topology. The following example shows how to enable the FC-AL topology by typing the following command format at the dscli command prompt: Note: I/O ports are automatically set to the offline state and returned to the online state after configuration changes are applied.
dscli> setioport -dev IBM.210775FA120 -topology fc-al 0012 0013 0112 0113
4. Press Enter. A successful process returns a confirmation message indicating that the port IDs have been successfully configured.
455
A SCSI host port contains attributes that identify the following information: v SCSI host system type v Port profile v Port WWPN v Volume group ID that the port accesses v v v v An array of storage unit or storage image I/O port IDs that the host port logs into for volume access An attribute to indicate that all I/O ports can be used for volume access Host port description Port nickname
There are two ways that you can approach this task: v Use the -hosttype parameter with the mkhostconnect command. Using the -hosttype parameter is the best solution for most users. v Use the mkhostconnect command with the -lbs, -addrdiscovery, and -profile parameters. Notes: 1. Specifying the -hosttype parameter automatically sets the -lbs, -addrdiscovery, and -profile values. 2. If you do not use the -hosttype parameter, you must issue the lsportprof command to ensure that you obtain the correct values to use with the -lbs, -addrdiscovery, and -profile parameters. 3. You cannot use the -hosttype parameter with these other parameters. The following task is described from the assumption that you have used the -hosttype parameter. To configure the SCSI host ports, perform the following steps:
Procedure
1. Obtain your host type information by issuing the lshosttype command. Enter the lshosttype command at the dscli command prompt with the following parameters and variables:
dscli>lshosttype l -type volumeGroup_type
AddrDiscovery reportlun
LBS 512
Description IBM pSeries, RS/6000 and RS/6000 SP Servers (AIX) IBM zSeries Servers (Linux) IBM iSeries Servers (System i)
512 520
Note: Volume group type is one of the following designations (use a separate command for each choice): v ficonall v scsiall v scsimask v scsimap256
456
v os400all v os400mask The same results are displayed when you specify os400all or os400mask or when you specify scsiall and scsimask or scsimap256. 2. Create SCSI host ports by issuing the mkhostconnect command. Enter the mkhostconnect command at the dscli command prompt with the following parameters and variables:
dscli>mkhostconnect -dev storage_image_ID -wwpn wwpn -hosttype host_type -volgrp volume_group_ID -ioport port_ID host_name
Notes: a. The -wwpn parameter specifies the 16-character worldwide name that is assigned to the host system Fibre Channel adapter port. This WWPN value is validated each time that the host system port logs into an I/O port. b. The -hosttype parameter specifies Fibre Channel communications layer characteristics that might be unique according to the host system manufacturer, operating system, or version of the system. Typical specifications are iSeries, pSeries, an so on. c. The -volgrp parameter specifies the volume group ID that this host port can access. Host port objects might be created prior to creating volume groups, in which case you must use the chhostconnect command to add volume group ID assignments at a later time. d. The -ioport all specifies SCSI host port (WWPN) access into all IO ports that are configured for the FC-AL or SCSI-FCP topology. e. host_name specifies the SCSI host system nickname that you have assigned. 3. Repeat Step 2 for each SCSI host system port that will access LUN volumes. 4. Verify that all SCSI host ports have been configured and that they are recognized by the storage unit according to your specifications by issuing the lshostconnect command with the -l parameter.
457
automatically assigned to storage unit I/O ESCON ports, and to I/O Fibre Channel ports (for DS8000), and to I/O Fibre Channel ports (for DS6000) that are configured for FICON I/O operations. For DS8000, the ESCON I/O ports are constrained to access Address Group 0 volume IDs (0000-0FFF). v Configuring Fibre Channel I/O ports
Procedure
1. Issue the lsextpool command to display a list of the existing CKD extent pools. The following is an example of the command that you can type in the dscli command prompt:
lsextpool -dev IBM.2107-75FA120 -stgtype ckd
where IBM.2107-75FA120 is the name of the storage image ID. 2. Analyze the extent pool listing for the following information: v Does the minimum set of extent pools exist? There must be one extent pool for rank group 0 and one extent pool for rank group 1. Note: If extent pools are being created for the first time, the minimum number of extent pools does not exist. v Does each extent pool have a rank group that is assigned to it and are they balanced?
458
Note: If extent pools are being created for the first time, there are no rank assignments. v Are additional extent pools required? 3. Issue the mkextpool command to create the extent pools. The following are examples of the commands that you can type in the dscli command prompt: Remember: You must create a minimum of two extent pools. There must be one extent pool for rank group 0 and one extent pool for rank group 1.
mkextpool -dev IBM.2107-75FA120 rankgrp 0 -stgtype ckd extent_pool_name mkextpool -dev IBM.2107-75FA120 rankgrp 1 -stgtype ckd extent_pool_name
where extent_pool_name is the name that you want to assign to the extent pool. This parameter is a required. The name cannot be longer than 16 characters. Create additional extent pools for each of the following conditions: v Each RAID type (5, 6 or 10) v Each disk drive module (DDM) size v Each CKD volume type (3380, 3390) v Each logical control unit (LCU) address group 4. Press Enter. Note: The unique name that you assigned to the extent pool does not display in the process message. However, when you issue the lsextpool command, the extent pool name is displayed. The following is an example of the message that is displayed for a successful process:
Extent pool P1 successfully created.
5. Repeat step 2 on page 458 for each extent pool that you want to create. Remember: To keep the storage server workloads balanced, evenly distribute rank and extent pool allocations. 6. After you have created the extent pools, issue the lsextpool command to verify the extent pool assignments. Use the -l parameter to display a full report for the extent pools that are assigned to the storage unit. The following is an example of the command that you can type in the dscli command prompt:
lsextpool dev IBM.2107-75FA120 -l
7. Optionally, print the list of extent pools so that you can refer to this list when you create CKD volumes.
459
enclosure pair. All array sites of a storage enclosure pair have identical capacity, rpm, and interface characteristics, and an interface to a common DA pair.
Procedure
1. Issue the lsarraysite command to find the unassigned array sites. Enter the lsarraysite command at the dscli command prompt with the following parameters and variables:
dscli> lsarraysite -dev storage_image_ID -state unassigned
Note: If this is your first time creating volumes, you will see all the arrays with a state of "unassigned". 2. Press Enter. A report of unassigned array sites is displayed. Use the list to identify unassigned array site capacity, rpm, and device adapter (DA) pair attributes. Record the RAID type for each array site. 3. Issue the mkarray command to create an array from each site with the status "unassigned". Enter the mkarray command at the dscli command prompt with the following parameters and variables:
dscli> mkarray -dev storage_image_ID -raidtype [5 | 6 | 10] -arsite array_site
Repeat this command until all unassigned array sites have been assigned to an array. Notes: a. You can specify one or two array sites for DS6000. If there are two array sites, both sites must be associated with a common DA pair ID. Two array sites must be separated by commas with no blank space in between. Example: S10,S11. b. The new array site inherits the capacity, rpm, interface, and DA pair characteristics of its parent array site or sites depending on the machine type. The state of the array is unassigned until it is assigned to a rank.
460
Procedure
1. Issue the lsarray command to ensure you have a list of the unassigned arrays for which ranks must be assigned. Enter the lsarray command at the dscli command prompt with the following parameters and variables:
dscli> lsarray -dev IBM.2107-75FA120 -state unassigned
2. Issue the mkrank command to assign a rank to rank group 0 or 1 according to the rank group number of the assigned extent pool ID. Enter the mkrank command at the dscli command prompt with the following parameters and variables:
dscli> mkrank -dev IBM.2107-75FA120 -array A44 -stgtype ckd -extpool P1
Notes: a. You can specify either the -wait or the -extpool parameter when you use the mkrank command. Either of these parameters allows you to be notified if the rank configuration has failed for any reason. b. When you use the -wait parameter, you cannot issue any other commands until the entire transaction has processed. 3. Press Enter to create the ranks. The process of making the rank involves formatting drives. It can take a little time before the process finishes. To check on the process, issue the lsrank command from a different DS CLI session. A successful process generates the following type of message:
Rank IBM.2107-75FA120/R44 successfully created.
4. Repeat Step 2 and step 3 until all unassigned arrays are assigned a rank and an extent pool. 5. Issue the lsrank command to verify that ranks and extent pools have been assigned. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli> lsrank -dev IBM.2107-75FA120 -l
6. Press Enter. A report of the rank assignments for your entire storage unit is displayed.
461
Use the lsaddressgrp, mklcu, and lslcu commands to create the LCU type logical subsystems. You must be logged into the DS CLI and connected to the storage unit that will be used for open systems host system storage. To create LCUs, perform the following steps:
Procedure
1. Find unassigned and available address groups by issuing the lsaddressgrp command. To use the lsaddressgrp command, type the following at the dscli command prompt:
dscli> lsaddressgrp -dev IBM.2107-75FA120
This command displays a report on the status of the address groups within your storage unit. 2. Analyze the report to identify all of the address groups that are available to be defined. Use the following criteria: v If the list is empty, all of the address groups are available to be defined. v A defined address group with the storage type fb (fixed block) is not available to be defined. v A defined address group with the storage type ckd and with fewer than 16 LSSs is available for LCU definition. v If you are using an undefined address group to make new LCUs, select the lowest numbered address group that is not defined. v If you are defining a new LCU in an existing CKD address group, use the lslcu command to identify LCUs that are already defined in the target address group. 3. Make the LCU logical subsystem objects by issuing the mklcu command. Type the command using the following format at the dscli command prompt:
dscli> mklcu dev IBM.2107-75FA120 -qty 16 -id 00 -ss 0010 -lcutype 3390-3
In this example, the values specify the following information: qty Specifies the number of LCU IDs to be created. id Specifies the LCU ID to be created, or the first LCU ID in a sequence of LCU IDs to be created. ss Specifies the subsystem ID that you have assigned. If multiple LCU IDs are being created, then the SSID value increments for each additional LCU ID that is created. If 16 LCUs are created, starting with SSID 0x10, then the SSID values are 0x0010 0x001F. lcutype Specifies the type of LCU to be created. You can specify the following types: v 3390-3 v 3990-tp v 3990-6 v bs2000 4. Press Enter. A successful process displays a confirmation message listing each LCU ID number that has been successfully created. 5. Verify that the LCUs are recognized in the storage unit by issuing the lslcu command at the dscli command prompt as follows:
dscli> lslcu -dev IBM.2107-75FA120 -l
Using the -l parameter displays a more detailed report for each LCU that is associated with your storage unit.
462
Procedure
1. View your list of CKD extent pool IDs and determine which extent pool IDs that you want to use as the source for the CKD volumes to be created. You obtained this list when you first created your extent pools. If this list is not available, you can issue the lsextpool command to obtain the list of extent pool IDs. Extent pool attributes determine the size and quantity of volumes that can be created. The extent pool ID (even/odd) indicates the storage server (0|1), which dictates that the logical control unit (LCU) ID component of the volume ID must be an even or an odd number. 2. Issue the mkckdvol command to make 128 base volumes for each LCU. Enter the mkckdvol command at the dscli command prompt with the following parameters and variables:
dscli> mkckdvol dev IBM.2107-75FA120 -extpool p1 cap 3339 name finance#d 0000-007F
The following considerations affect the command example in this step: v The -extpool parameter identifies a CKD extent pool that contains available data extents. v The -cap parameter specifies the quantity of CKD cylinders that are allocated to this volume. v The -name parameter allows you to assign an easy-to-use label or nickname to the volume. The volume name parameter can include a wildcard (#d or #h) that inserts a decimal or hexadecimal volume ID value into the volume name. Note: The decimal designation does not apply to the volume ID number or the number of volumes that were created by the command. It only applies to the unique name that you have assigned to the volume. When you process the mkckdvol command, the volume name that you have assigned does not appear in the confirmation message. To view the volume name that you have assigned, issue the lsckdvol or showckdvol command. v Volume ID 0000 - 007F specifies 128 volumes, starting at CKD address group (0), LCU ID (00), and volume number (00). You must specify volume IDs that have not been previously defined as CKD or fixed block volumes. 3. Press Enter to create the volumes. A confirmation message is displayed that lists the successful creation of each volume. 4. Repeat Steps 2 and 3 until all required logical volumes for all LCUs have been created. 5. Issue the mkaliasvol command to make 128 alias volumes for each LCU. Enter the mkaliasvol command at the dscli command prompt with the following parameters and variables:
dscli> mkaliasvol dev IBM.2107-75FA120 base 0000-004F -order decrement -qty 2 00FF
Consider the following conditions with regard to the command example in this step: v The -base 0000 - 004F parameter specifies that alias volumes are assigned to existing base volume IDs 0000 - 004F. Base and alias volumes must be associated with a common LCU ID. v The -order parameter specifies the order in which alias volume IDs are assigned. v The -qty parameter specifies the number of alias volumes that are assigned to each base volume.
Chapter 5. Configuring and managing logical storage
463
v The volume ID (00FF) parameter specifies that the alias volumes are assigned, starting at a CKD address group (0), LCU ID (00) and volume number (FF). You are responsible for specifying the volume ID values that have not been previously defined as CKD or fixed block volume types. As a result, alias volumes 00FF and 00FE are created for base volume 0000, 00FD and 00FC for 0001, and so on. 6. Repeat Step 5 until you have defined all required logical volumes for all the LCUs. 7. Press Enter to create the alias volumes. A confirmation message is displayed that lists the successful creation of each volume. 8. Issue the lsckdvol command to display a report that you can use to confirm the status of your CKD volumes. Enter the lsckdvol command at the dscli command prompt with the following parameters and variables:
dscli> lsckdvol -dev IBM.2107-1300861 -l 1410
Note: It is possible that the report will display that there was a configuration error that is associated with one or more of your mkckdvol transactions. In the majority of instances, the only way to correct this error is to issue the rmckdvol command.
Procedure
1. Add the -v (verbose) command parameter to your mkckdvol command and reissue the mkckdvol command for the transactions that show there is a configuration error. Note: You can also turn on the verbose mode in your profile file and reissue the command. If you designate the verbose mode, the display of extra output includes the error code that is generated when the create CKD volume transaction fails. 2. Issue the rmckdvol command to delete the designated volume configurations if you do not want to obtain additional information about what caused the configuration error. Note: In the majority of instances, this is the only method for correcting a configuration error.
464
Procedure
1. View a list of Fibre Channel port IDs by typing the following command format at the dscli command prompt:
dscli> lsioport -dev IBM.210775FA120 -l -type fc
A detailed report is displayed that lists the Fibre Channel I/O ports. 2. Analyze the report and determine which I/O port IDs that you want to access the fixed block volumes. Configure a minimum of four I/O ports for SCSI host I/O operations. Select ports with physical locations on different host bus adapter (HA) cards. If possible, locate the HA cards in different I/O enclosures. 3. Set the I/O ports that you have identified to enable the FC-AL (Fibre Channel arbitrated loop), SCSI-FCP, or FICON topology. The following example shows how to enable the FC-AL topology by typing the following command format at the dscli command prompt: Note: I/O ports are automatically set to the offline state and returned to the online state after configuration changes are applied.
Chapter 5. Configuring and managing logical storage
465
dscli> setioport -dev IBM.210775FA120 -topology fc-al 0012 0013 0112 0113
4. Press Enter. A successful process returns a confirmation message indicating that the port IDs have been successfully configured.
466
Procedure
1. From the i5/OS main menu, enter DSCLI at the prompt to start DS CLI on i5/OS and press Enter.
MAIN OS/400 Main Menu System: IBMSYSTEM Select one of the following: 1. User tasks 2. Office tasks 3. General system tasks 4. Files, libraries, and folders 5. Programming 6. Communications 7. Define or change the system 8. Problem handling 9. Display a menu 10. Information Assistant options 11. iSeries Access tasks 90. Sign off Selection or command ===> dscli F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=Information Assistant F23=Set initial menu
2. The DSCLI displays the following screen where you can specify a DS CLI script for DS CLI commands and a DS CLI profile. In this example, a default profile is specified. The profile is not configured so the value of *DEFAULT is used. If you are not using a script, specify *None and press Enter. After you press Enter, more fields appear in the screen as shown in step 3.
Run DSCLI Functions (DSCLI) Type choices, press Enter. Script: *NONE or name Profile . . . . . *NONE___ *DEFAULT
. . . . . . . . . . . .
F5=Refresh
F12=Cancel
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bottom F3=Exit F4=Prompt F24=More keys F5=Refresh F12=Cancel F13=How to use this display
Consider the following fields and values: v If you are using a DS CLI script for DS CLI commands, enter the name in the Script field. Otherwise, specify *None. v If you use default profile, leave the value *DEFAULT in the field Profile. If you use another file as a profile, specify the name and path of this file in the field Profile.
Chapter 5. Configuring and managing logical storage
467
v Enter the hardware management console (also known as the management console) user in the User field. Typically, it is Admin. v Enter the password of the user (typically the administrator's password). v Enter *INT (for interactive session) in the DSCLI CMD field. The screen shown in step 4 displays. 4. Specify the DS CLI commands to invoke storage configuration or Copy Services functions.
dscli> ===> F3=Exit F6=Print F21=CL command entry
F9=Retrieve
Procedure
1. Issue the lsextpool command to generate a report that identifies the status of your extent pools by storage type (fixed block or count key data). Enter the lsextpool command at the dscli command prompt with the following parameters and variables:
dscli> lsextpool -dev storage_image_ID -l -stgtype (fb | ckd)
Note: The -stgtype parameter must be designated as either fb (fixed block) or ckd (count key data). The storage type allows you to limit the list of extent pools for issues such as which ones to rename or to change the limit or threshold percentages. 2. Issue the chextpool command to change the name that is assigned to the extent pool or to change the percentages that are allocated for extent and threshold limits. Enter the chextpool command at the dscli command prompt with the following parameters and variables:
dscli> chextpool -dev storage_image_ID -name new_extent_pool_name -extentlimit [on | off] -limit extent_limit_percentage -threshold extent_threshold_percentage -extentpool_ID
Notes: a. The new extent pool name can include up to sixteen characters. b. The -extentpool_ID parameter is required but does not need to be specified as a separate entry. You can add it to the storage_image_ID parameter. For example: IBM.2107-75FA120/ P21, with P21 being the extent pool ID. Extent pool IDs are specified as 4-digit values with no leading zeros, and they are preceded by the letter P. c. The unique name that you assigned to the extent pool does not display in the output message of the chextpool command. However, when you issue the lsextpool command, the extent pool name is displayed. 3. Issue the lsextpool command to verify that your changes have been processed.
468
Procedure
Issue the lsextpool command to display the extent pool list and status information. Enter the lsextpool command at the dscli command line prompt with the following parameters and variables:
dscli> lsextpool -dev storage_image_ID -l
Notes: 1. Use the -l parameter if you want to see the list and status for all the extent pools (fixed block and CKD) in your storage unit. A full report is displayed. 2. Use the -s parameter if you want to see only a list of the extent pools in your storage unit. No additional information is provided.
Procedure
1. (For detailed properties information) Issue the showextpool command. Enter the showextpool command at the dscli command-line prompt with the following parameters and variables:
dscli> showextpool -dev storage_image_ID extentpool_ID
2. (For performance metrics information) Issue the showextpool command. Enter the showextpool at the dscli command-line prompt with the following parameters and variables:
dscli> showextpool -dev storage_image_ID -metrics extentpool_ID
Notes:
469
a. All performance metrics are an accumulation since the most recent counter wrap or counter reset. b. The extent pool performance counters are reset on the following occurrences: v When the storage unit is turned on. v When a server has failed, and the failover and failback sequence is performed.
Procedure
1. Issue the lsextpool command to display a list of extent pools. Ensure that you designate the storage type within your command parameters. Enter the lsextpool command at the dscli command prompt with the following parameters and variables:
dscli> lsextpool -dev storage_image_ID -l -stgtype [fb | ckd]
2. Analyze the list and determine which extent pools can be deleted. 3. Issue the rmextpool command to delete the designated extent pools. Enter the rmextpool command at the dscli command prompt with the following parameters and variables:
dscli> rmextpool -dev storage_image_ID extentpool_ID
Note: If you are deleting several extent pools, you can add the -quiet parameter to your command. This parameter turns off the confirmation message that is generated for each deletion transaction. 4. Issue the lsextpool command after the deletion processing has completed to verify that the extent pools have been deleted.
470
Procedure
1. Issue the lsddm command to obtain a list and status of the DDMs currently associated with the storage unit. Enter the lsddm command at the dscli command prompt with the following parameters and variables:
dscli> lsddm -l storage_image_ID
2. Issue the showarraysite command after you have created an array using the DDMs. Enter the showarraysite command at the dscli command prompt with the following parameters and variables:
dscli> showarraysite storage_image_ID -fullid site_ID
Notes: a. The storage image ID is optional. You do not have to specify it but, if you choose not to use it, you must provide a fully qualified site_ID which includes the manufacture, model type, and serial number information. b. The site-ID parameter is a four-digit number preceded by the letter "S" with no leading zeros. c. The showarraysite command provides the following DDM information that is associated with the DDM after the array has been created: v DDM serial number v Spares - Identifies, if any, the number of spare DDMs that are allocated from the array site. v Data DDM - Specifies the number of data DDMs. This value is based on the number of DDMs minus the number of spares.
471
Procedure
1. Issue the lsarraysite command to generate a list of all the array sites and their status. Enter the lsarraysite command at the dscli command prompt with the following parameters and variables:
dscli> lsarraysite -dev storage_image_ID -l
The state column of the report might be of interest as it specifies the following state of the array site and conditions that require attention: For DS8000: v Assigned The array is assigned to a rank. v Unassigned The array is not assigned to a rank and all of the storage devices that are indicated by the disk serial numbers are in the Normal state. v Unavailable The array is not assigned to a rank and one or more of the disk drive modules are not in the Normal state. For DS6000: v Assigned The array site has been defined as an array. v Unassigned The array site is available to be defined as an array. v Unavailable Specifies that the designated array site is unassigned and at least one disk is not in the normal state. Also, the array site is not in the initializing state. v Initializing Specifies that the array site is unassigned and all disks are either in the normal or initializing state. Also, at least one disk is in the initializing state. 2. Issue the lsarray command to generate a list of all the arrays and their status. Enter the lsarray command at the dscli command prompt with the following parameters and variables:
dscli> lsarray -dev storage_image_ID -l
Note: You might want to analyze the state and data column information for the arrays. Some of the reported conditions require further action. See the lsarray command for additional information.
472
Note: For your DS6000 machine type, you might have created your array from one or two array sites. An array inherits the characteristics of its parent array sites and is given a RAID type attribute (5 or 10). Perform the following steps to view the status of the array site or sites and the array that is associated with the storage unit.
Procedure
1. Issue the showarraysite command to generate a report that displays the array site or sites and their status. Enter the showarraysite command at the dscli command prompt with the following parameters and variables:
dscli> showarraysite -dev storage_image_ID site_ID
Notes: a. The site ID is a four-digit number that is preceded by the letter S with no leading zeros. b. The site ID does not specify a physical location. It is, however, an identifier for the array site ID. c. If you have created the array, the array site state shows a value of assigned. 2. Issue the showarray command to generate the properties report for the specified array. Enter the showarray command at the dscli command prompt with the following parameters and variables:
dscli> showarray -dev storage_image_ID array_ID
473
Procedure
1. Issue the lsarray command to obtain a list of array IDs to be removed. Enter the lsarray command at the dscli command prompt with the following parameters and variables:
dscli> lsarray -dev storage_image_ID -state unassigned
Notes: a. You might have to issue the lsarray command several times before you observe that the arrays are in a state that allows them to be removed or reassigned. b. Specify the -stateunassigned parameter to narrow your list to just the array IDs that are not assigned to a rank ID. c. If you issue the lsarray command without using the -stateunassigned parameter, you might see a list of arrays that have a state of unavailable. This is a good indication that the ranks have not been removed and that the arrays are still formatting. You must wait until the ranks have been removed and the arrays have been formatted before you can proceed. d. Proceed to the next step (remove arrays) only after all the arrays that you want to remove or reassign are displayed with a state of unassigned. 2. Issue the rmarray command to delete the unassigned arrays so that the array sites can be redefined as new arrays. Enter the rmarray command at the dscli command prompt with the following parameters and variables:
dscli> rmarray -dev storage_image_ID array_ID
Notes: a. You can remove one or many arrays as long as you designate the range of arrays using a hyphen and separate each range of arrays or a single array with a space before the next array designation. For example, A44-A48 A51 designates a range of arrays and a single array. b. If you are removing several arrays, you might want to designate the -quiet parameter in your command. This parameter turns off the deletion confirmation message that is generated after each array is deleted.
Procedure
1. Issue the lsrank command to generate a report that lists the status of the ranks that are associated with the storage unit. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli> lsrank -dev storage_unit_ID -l -state unassigned
474
Notes: a. The report that is generated by this example provides a list of all unassigned ranks; however, the storage type is mixed between fixed block and CKD. b. You can narrow your report information to a specific storage type by adding the -stgtype [fb | ckd] parameter to your command. 2. Issue the chrank command to add (reassign) a rank or ranks to an extent pool. Enter the chrank command at the dscli command prompt with the following parameters and variables:
dscli> chrank -dev storage_image_ID -extpool extentpool_ID rank_ID
Notes: a. The rank ID is a four-digit number with the prefix R and with no leading zeros. You can specify a range of rank IDs by using a hyphen between the beginning and ending values of the range. For example: R102-R105 b. You can specify multiple rank IDs or rank ID ranges, but you must leave a space between each designation. For example: R102 R105 R107-R109
Modifying a rank
Complete this task to modify a rank using the DS CLI.
Procedure
1. Issue the lsrank command to generate a report that lists the status of the ranks that are associated with the storage unit. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli> lsrank -dev storage_unit_ID -l
Notes: a. The report that is generated by this example provides a list of all ranks; however, the storage type is mixed between fixed block and CKD. b. You can narrow your report information to a specific storage type by adding the -stgtype [fb | ckd] parameter to your command. 2. Use the report to determine the rank or ranks you want to modify. The report contains details about the ranks that you must use to issue the chrank command for modifications. 3. Issue the chrank command to implement one of the following types of modifications: a. To designate a rank as reserved, enter the chrank command at the dscli command prompt with the following parameters and variables:
dscli> chrank -dev storage_image_ID -reserve rank_ID
Changing the rank configuration state to "reserved" designates that the extents that are associated with the rank are not eligible for allocation to a logical volume. However, the existing allocations remain in effect until the configuration state is changed to normal (the characteristics that the rank inherited from its parent array when it was originally assigned remain intact).
Chapter 5. Configuring and managing logical storage
475
Notes: 1) You can specify a range of rank IDs or multiple rank IDs as long as you match the command usage criteria. 2) You cannot change the configuration state of a reserved rank to "unassigned" without first releasing it. b. To release a rank from its reserved configuration state, enter the chrank command at the dscli command prompt with the following parameters and variables:
dscli> chrank -dev storage_image_ID -release rank_ID
When a rank is released from the configuration state of "reserved", it is designated with a configuration state of "normal". c. To remove a rank from its current extent pool and array assignment but not delete it, enter the chrank command at the dscli command prompt with the following parameters and variables:
dscli> chrank -dev storage_image_ID -unassign rank_ID
Notes: 1) A rank must have a configuration state of normal before it can be changed to a configuration state of unassigned. 2) A rank that is unassigned can be assigned to an array and extent pool of another storage configuration as long as the storage type is compatible: all fixed block or all CKD.
Procedure
Issue the lsrank command to generate a list of all the ranks and their status. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli> lsrank -dev storage_image_ID -l
The state and datastate column information for the ranks contains reported conditions that can require further action. See the lsrank command for an explanation of the action designations.
476
Procedure
Issue the showrank command to generate the properties report for the specified rank. Enter the showrank command at the dscli command prompt with the following parameters and variables:
dscli> showrank -dev storage_image_ID rank_ID
Notes: 1. Because the showrank command requires the use of a specific rank ID, you can issue the lsrank command first to obtain the specific rank IDs. 2. The state and datastate column information for the ranks contains reported conditions that can require further action. See the showrank command for an explanation of the action designations.
Procedure
1. Obtain additional information about the transaction by implementing one of the following methods: v Add the -v (verbose) command parameter to your mkrank command and reissue the command for the transactions that show the configuration error designation. Note: You can also turn on the verbose mode in your profile file and reissue the command. Designating the verbose mode allows the display of extra output that includes the error code that is generated when the create rank transaction fails. v Add the -extpool parameter to your mkrank command and reissue the command for the transactions that show the configuration error. You might consider using this parameter if you have not yet assigned your ranks to the extent pools. If the transaction fails, a message states the reason for a failure.
Chapter 5. Configuring and managing logical storage
477
2. Issue the rmrank command to delete the designated rank configurations if you do not want to obtain additional information about what caused the configuration error. Note: In the majority of instances, this is the only method for correcting a configuration error.
Procedure
1. Issue the lsrank command to obtain a list of the ranks that are associated with the storage configuration that is being deleted. Enter the lsrank command at the dscli command prompt with the following parameters and variables:
dscli> lsrank -dev storage_image_ID -l -stgtype [fb | ckd]
2. Look at the list and ensure that the ranks are in a state that allows them to be deleted. All the ranks need to have a data and configuration state of normal. 3. Issue the rmrank command to delete the ranks from the storage configuration. Enter the rmrank command at the dscli command prompt with the following parameters and variables:
dscli> rmrank -dev storage_image_ID rank_ID
Notes: a. If you have multiple ranks that are being deleted, you might want to include the -quiet parameter in your command. This parameter suppresses the confirmation message that is issued for each rank that is deleted. b. Deleting a rank or many ranks is a lengthy process because the array and extent pool assignments are unassigned and the disk drives are formatted. When a rank is unassigned from the array and extent pool, a confirmation messages is issued that indicates that the rank has been deleted. However, because of the formatting, the process is not complete. You cannot initiate any action on the arrays or extent pools until the formatting is completed.
478
Procedure
1. Issue the lslcu command to generate a report that lists the status of the LCUs that are associated with the storage unit. Enter the lslcu command at the dscli command prompt with the following parameters and variables:
dscli> lslcu -dev storage_unit_ID -l
2. Use the report to determine the LCU or LCUs that you want to modify. The report contains details about the LCUs that you must use to issue the chlcu command for modifications. 3. Issue the chlcu command to implement one of the following types of modifications: a. To maintain the unique identity that is associated with your logical subsystem within your Copy Services domain, you can change your subsystem ID (SSID). Enter the chlcu command at the dscli command prompt with the following parameters and variables:
dscli> chlcu -dev storage_image_ID -ss new_ss_ID lcu_ID
Note: The new SSID that you specify replaces the existing SSID value in the initial target LCU ID. b. To provide your system a format that allows you to process DS CLI transactions. Enter the chlcu command at the dscli command prompt with the following parameters and variables:
dscli> chlcu -dev storage_image_ID -lcutype [3990-3 | 3990-tpf | 3990-6 | bs2000] lcu_ID
Notes: 1) The target LCUs are changed to the LCU type that you designate 2) When you designate multiple LCUs, separate multiple IDs and multiple ID ranges with a space. Separate your LCU range with a dash (-) between the first and last number of the range. To modify the concurrent copy timeout value using the chlcu command, see Modifying the Concurrent Copy timeout value on page 504. To modify the consistency group timeout value, see Modifying the consistency group timeout value on page 505. To modify the critical mode (administrator authority only), see Modifying the critical mode setting on page 506. To modify the z/OS Global Mirror timeout value for DS8000, see Modifying the z/OS Global Mirror timeout value on page 505.
c. d. e. f.
479
Procedure
Issue the lslcu command to generate a list of all the LCUs and their status. Enter the lslcu command at the dscli command prompt with the following parameters and variables:
dscli> lslcu -dev storage_image_ID -l
Notes: 1. Issue the lsaddressgrp command first if you decide to refine your search to include just the LCUs that are associated with a specific address group. The lsaddressgrp command provides a list of address groups that you can then use with the -addrgrp parameter of the lslcu command. 2. To specify a range of LCU IDs, separate the LCU IDs with a dash (-). You must separate multiple LCU IDs or ranges of LCU IDs with a blank space between each ID or range of IDs.
Procedure
Issue the showlcu command to view a report that displays the properties of a single LCU. Enter the showlcu command at the dscli command prompt with the following parameters and variables:
dscli> showlcu -dev storage_image_ID LCU_ID
480
Note: The LCU ID is a two-digit hexadecimal number in the range of 00 - FE for DS8000 or 00 - 1F for DS6000.
Procedure
1. Issue the lslcu command to obtain a list of the LCUs that are associated with the storage configuration that is being deleted. Enter the lslcu command at the dscli command prompt with the following parameters and variables:
dscli> lslcu -dev storage_image_ID -l
2. Look at the list to ensure that the LCUs are in a state to be removed. They are ready if there are no volumes that are assigned to the LCU (zeros are displayed for each LCU in the Confgvols column of the list). 3. Issue the rmlcu command to delete the LCUs from the storage configuration. Enter the rmlcu command at the dscli command prompt with the following parameters and variables:
dscli> rmlcu -dev storage_image_ID lcu_ID
Notes: a. If you have multiple LCUs that are being deleted, you can include the -quiet parameter in your command. This parameter suppresses the confirmation message that is issued for each LCU that is deleted. b. You must separate multiple LCU IDs or ranges of LCU IDs with a blank space between each ID or range of IDs. Each range of LCU IDs must be separated by a dash (-) between the first ID and the last ID of the range.
481
482
FlashCopy functions
This topic provides a list of tasks that help you create, monitor, and manage your FlashCopy operations using DS CLI commands.
Procedure
1. Issue the mkflash command to create FlashCopy relationships. Enter the mkflash command at the dscli command prompt with the following parameters and variables: dscli> mkflash -dev storage_image_ID sourcevolumeID:targetvolumeID Example
dscli> mkflash -dev IBM.2107-75FA150 0001:0004
Notes: a. Specify the storage unit for the -dev storage_image_ID parameter. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and
Copyright IBM Corp. 2006, 2012
483
you do not specify a value for the devid variable in your profile file. If the management console has an IP connection to the specified storage unit, the command works. If the IP connection is not established, you can use the mkremoteflash command if there is a PPRC Path established between the storage unit from which you issue the command and the (remote) storage unit where the FlashCopy volumes are located. b. For further information, including optional parameters, see the mkflash and mkremoteflash commands. A confirmation message is issued for each successful FlashCopy pair that is created. 2. Issue the lsflash command to check the status information for each FlashCopy relationship. A detailed report (when you use the -l parameter) is displayed for each FlashCopy relationship. Enter the lsflash command at the dscli command prompt with the following parameters and variables: dscli> lsflash -dev storage_image_ID -l SourceVolumeID:TargetVolumeID.
dscli> lsflash -dev IBM.2107-75FA150 -l 0100:0100
Use the-l parameter to provide a more detailed report about the FlashCopy relationships. Note: If you used the mkremoteflash command, you must enter the lsremoteflash command to perform a status check.
484
Perform the following step to view status information about existing FlashCopy relationships using DS CLI commands. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format is an example command with declared values for the variables. Issue the lsflash command to provide a report that lists the FlashCopy relationships and status information for each FlashCopy relationship in the list. Enter the lsflash command at the dscli command prompt with the following parameters and variables: dscli> lsflash -dev storage_image_ID -l source_volume_ID:target_volume_ID Example
dscli> lsflash -dev IBM.2107-75FA150 -l 0100:0200 0101:0201 0102:0202 0103:0203
The resulting output Note: The following tables display the output that is associated with the lsflash command using the -l parameter.
Sequence Num 10 10 11 11 Timeout (secs) 120 120 120 120 Active Copy Disabled Disabled Disabled Disabled Record ing Disabled Disabled Disabled Disabled Persist ent Disabled Disabled Disabled Disabled Rever tible Disabled Disabled Disabled Disabled
SrcLSS 01 01 01 01
SourceWriteEnabled Enabled
TargetWriteEnabled Disabled
BackgroundCopy Disabled
CopyIndicator Yes
OutOfSyncTracks 0
DateCreated 12/01 /2003 02:20 :00 12/01 /2003 02:20:00 12/01 /2003 02:20 :00 12/01 /2003 02:20 :00
DateSynced 12/01 /2003 02:23 :47 12/01 /2003 02:23:47 12/01 /2003 02:23 :47 12/01 /2003 02:23 :47
Enabled
Disabled
Disabled
Yes
Enabled
Disabled
Disabled
Yes
Enabled
Disabled
Disabled
Yes
485
Procedure
1. Issue the lsflash command to check the status information for each FlashCopy relationship. A detailed report (when you use the -l parameter) is displayed for each FlashCopy relationship. Enter the lsflash command at the dscli command prompt with the following parameters and variables: dscli> lsflash -dev storage_image_ID -l SourceVolumeID:TargetVolumeID.
dscli> lsflash -dev IBM.2107-75FA150 -l 0100:0100
Use the -l parameter to provide a more detailed report about the FlashCopy relationships. Note: If you have originally used the mkremoteflash command to create your FlashCopy relationships, you must enter the lsremoteflash command to perform a status check. 2. Analyze the list of volumes and ensure that these are the volumes from which the FlashCopy relationship must be removed. 3. Issue the rmflash command to remove the FlashCopy volume relationships. Enter the rmflash command at the dscli command prompt with the following parameters and variables: dscli> rmflash -dev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> rmflash -dev IBM.2107-75FA120 0001:0004 0003:00FF 0008:000C
Notes: a. The example shows the use of multiple FlashCopy pair IDs. Ensure that you separate multiple FlashCopy pair IDs with spaces. b. If you used the mkremoteflash command to create your FlashCopy relationships, you must enter the rmremoteflash command to remove the FlashCopy relationships. 4. A confirmation message is displayed for each FlashCopy relationship that you want to remove. Enter Y in response to each message that requests that you confirm that you want to remove the specified FlashCopy pair. A message like the following appears for each FlashCopy pair being removed when you process the rmflash command.
Are you sure you want to remove the FlashCopy pair 0001:0004? [y/n]: Y FlashCopy pair 0001:0004 successfully removed.
486
To establish a FlashCopy relationship at the target site, remote FlashCopy commands are issued to a source volume of a remote mirror and copy volume pair on a source (local) storage unit and sent across paths (acting as a conduit) to a target storage unit. This eliminates the need for a network connection to the target site solely for the management of FlashCopy relationships. Limitation: Remote FlashCopy commands establish a FlashCopy relationship at the target (remote) site when a network connection to the target site is lost. The Remote FlashCopy operation is not supported through the DS Storage Manager, because network connections to both the source and target sites are required. If the network connection to the target site is lost, the DS Storage Manager cannot connect to the target site. Whether you use the DS Storage Manager or DS CLI for Steps 1 and 2, you must perform Step 3 from the DS CLI. Note: You can perform all steps from the DS CLI. The details are described in "Processing Remote FlashCopy (inband) transactions." The following example illustrates the required steps for creating a remote FlashCopy operation.
Procedure
1. Create paths between the source LSS and the target LSS. For example, IBM.2107-1300861 and IBM.2107-1300871 You need to know which volumes are available for use before you can issue the request to establish the path. 2. Create Metro Mirror volume pairs from the source LSS to the target LSS. For example, volume 2200 (IBM.2107-1300861/2200) from LSS22 and volume 2A00 (IBM.2107-1300871/2A00) from LSS22. 3. Enable a Remote FlashCopy operation at the target site using volume B as the source volume and volume C as the target volume. Assume that the target site network connection is lost. You can create the FlashCopy relationship from volume B to volume C (both volumes at the target site). However, you cannot use the DS Storage Manager for this step because connections to the target site are lost.
Example
Assume that you performed Step 1 and Step 2 from the DS Storage Manager (connections to both storage units at the source and target sites were available at that time) and the Metro Mirror relationship between the volume pair still exists. To create the Remote FlashCopy operation, you must perform Step 3 from the DS CLI using the following command as an example. (You must be logged into the DS CLI in interactive command mode.) Note: Use LSS 22 on the local site as a conduit LSS for the new remote Flash Copy relationship on the remote storage unit that will use volume 2A00 as the source. The target can be any other volume on the remote storage unit (in this example 2A01) dscli> mkremoteflash -dev IBM.2107-1300871 -conduit IBM.2107-1300861/22 2A00:2A01 where: -dev Specifies the storage image ID, which includes manufacturer, machine type, and serial number.
-conduit LSS_ID (Required) Identifies the source LSS of an existing remote mirror and copy relationship that is used as a conduit for communicating with the target storage image. The source volume IDs that are specified in source_volume_ID:target_volume_ID must be the target volumes in a remote mirror and copy relationship in which one of the conduit LSS volumes acts as a source volume. You can specify a fully qualified LSS ID, which includes the storage image ID. source_volume_ID:target_volume_ID (Required) Establishes a remote FlashCopy relationship for the source and target volume pairs with the specified IDs. You can specify fully qualified volume IDs, which includes storage image
Chapter 6. Copy Services functions
487
IDs, or a shortened version without storage image IDs if the -dev parameter is specified. Separate the IDs of the FlashCopy relationships with spaces. This report is displayed if your command input is correct. FlashCopy Pair ID 2A00:2A01 successfully initiated. Use the lsremoteflash command to determine copy completion. Verify that the transaction has processed successfully by issuing the following command: dscli> lsremoteflash -dev IBM.2107-1300871 -conduit IBM.2107-1300861/22 2A00:2A01
488
489
performing this task. It is not valid to perform the FlashCopy Revertible task on a FlashCopy relationship that is already revertible.
Procedure
Issue the setflashrevertible command to apply the revertible option to existing FlashCopy relationships. Enter the setflashrevertible command at the dscli command prompt with the following parameters and variables: dscli> setflashrevertible -dev storage_image_ID sourcevolumeID:targetvolumeID Note: Specify the storage unit for the -dev storage_image_ID parameter. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and you do not specify a value for the devid variable in your profile file. Example
dscli> setflashrevertible -dev IBM.2107-75FA120 0100:0200 The resulting output FlashCopy volume pair 0100:0200 successfully made revertible.
490
Note: The amount of time that the actual physical copy can take depends on the amount of data that is copied and other activities that are occurring on the storage unit. You can monitor when the copy completes by issuing the lsflash command to check the status information for each FlashCopy relationship. Perform the following steps to create FlashCopy relationships with DS CLI commands. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format is an example command with declared values for the variables.
Procedure
1. Issue the mkflash command without the -nocp parameter to create FlashCopy relationships that allow data to be copied from the source volume to the target volume. Enter the mkflash command at the dscli command prompt with the following parameters and variables: dscli> mkflash -dev storage_image_ID sourcevolumeID:targetvolumeID Example
dscli> mkflash -dev IBM.2107-75FA150 0001:0004
Note: Specify the storage unit for the -dev storage_image_ID parameter. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and you do not specify a value for the devid variable in your profile file. A confirmation message is issued for each successful FlashCopy pair that is created. 2. Issue the lsflash command to check the status information for each FlashCopy relationship. A detailed report (when you use the -l parameter) is displayed for each FlashCopy relationship. Enter the lsflash command at the dscli command prompt with the following parameters and variables: dscli> lsflash -dev storage_image_ID -l SourceVolumeID:TargetVolumeID. Example
dscli> lsflash -dev IBM.2107-75FA150 -l 0100:0100
Use the -l parameter to provide a more detailed report about the FlashCopy relationships.
491
Procedure
Issue the mkflash command with the -tgtinhibit parameter to prevent host write operations on the target volume of the FlashCopy relationships that you create. Enter the mkflash command at the dscli command prompt with the following parameters and variables: dscli> mkflash -dev storage_image_ID -tgtinhibit sourcevolumeID:targetvolumeID Example
dscli> mkflash -dev IBM.2107-75FA150 -tgtinhibit 0001:0004
A confirmation message is issued for each successful FlashCopy pair that is created.
Procedure
v Issue the mkflash command with the -tgtpprc parameter to create a FlashCopy target volume on an existing Metro Mirror source volume. Enter the mkflash command at the dscli command prompt with the following parameters and variables: dscli> mkflash -dev storage_image_ID -tgtpprc sourcevolumeID:targetvolumeID Example
dscli> mkflash -dev IBM.2107-75FA150 -tgtpprc 0001:0004
A confirmation message is issued for each successful FlashCopy pair that is created. Note: The -tgtpprc parameter can also be used with the resyncflash command. When you issue a resyncflash command to a FlashCopy relationship, only the new write operations to the source since the last resynchronization are copied to the target. This minimizes the data that is copied to the remote site when you also use the -tgtpprc parameter. The specified parameters in the resyncflash command replace the parameters in the existing relationship. To keep the initial -record, -persist, and -tgtpprc parameters, the -record, -persist, and -tgtpprc parameters must be specified in the resyncflash command. v Issue the resyncflash command with the -tgtpprc parameter to resynchronize FlashCopy relationships and create a FlashCopy target volume on an existing Metro Mirror source volume. Enter the resyncflash command at the dscli command prompt with the following parameters and variables: dscli> resyncflash -dev storage_image_ID -record -persist -tgtpprc sourcevolumeID:targetvolumeID Example
dscli> resyncflash dev IBM.2107-75FA120 -record -persist -tgtpprc 0100:0200
492
Procedure
Issue the revertflash command to correct the FlashCopy relationships and reset them to the last consistency group state. Enter the revertflash command at the dscli command prompt with the following parameters and variables: dscli> revertflash -dev storage_image_ID SourceVolumeID Example
dscli> revertflash -dev IBM.2107-75FA150 0100
Notes: 1. Remember that storage_image_ID is the value for the remote server that has been designated the primary server until the original primary server is again available for use. 2. Global Mirror operations have performed the establish FlashCopy revertible processing but might have failed to form a consistency group before the disaster occurred. If your analysis, through use of the lsflash command, has determined that a revertflash command is needed, there is no need to issue a new mkflash command. A confirmation message like the following one is generated for each FlashCopy relationship that has been successfully reset.
Chapter 6. Copy Services functions
493
Procedure
Issue the commitflash command to correct the FlashCopy relationships and commit them to the consistency group that was being formed before the disaster occurred. Enter the commitflash command at the dscli command prompt with the following parameters and variables: dscli> commitflash -dev storage_image_ID SourceVolumeID Example
dscli> commitflash -dev IBM.2107-75FA150 0100
Note: v Remember that storage_image_ID is the value for the remote server that has been designated the primary server until the original primary server is again available for use. v Global Mirror operations have performed the establish FlashCopy revertible processing and might have failed to form a consistency group before the disaster occurred. If your analysis, through use of the lsflash command, has determined that a commitflash command is needed, there is no need to issue a new mkflash command.
494
A confirmation message like the following one is generated for each FlashCopy relationship that has been successfully reset.
FlashCopy pair 0100:0200 successfully committed.
Procedure
Issue the lspprcpath command to display the list of established paths. Enter the lspprcpath command at the dscli command prompt with the following parameters and variables: dscli> lspprcpath -dev storage_image_ID Source_LSS_ID. Example
dscli> lspprcpath -dev IBM.2107-75FA120 10
Note: You can specify multiple LSS IDs, but they must be separated with spaces.
495
Procedure
1. Issue the lssi command to display the list of WWNNs. Enter the lssi command at the dscli command prompt as follows:
dscli >lssi -l
2. Review the output that displays the WWNN of the storage unit. This information is required when you establish a path.
Procedure
1. Issue the mkpprcpath command to create the Fibre Channel paths for the remote mirror and copy source and target volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables: dscli> mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn -srclss source_LSS_ID -tgtlss target_LSS_ID source_port_ID:target_port_ID Notes:
496
a. The -remotedev parameter specifies the ID of the secondary storage unit. b. The -remotewwnn parameter must specify the WWNN of the secondary storage unit. If you specify the WWNN of the primary storage unit, the command fails. c. You can specify the -dev and -remotedev parameters or specify fully qualified srclss and -tgtlss parameters, but not both. d. The shortened version of the -srclss and -tgtlss parameters are shown (value = 00) because the example uses the fully qualified -dev storage_image_ID parameter. If the fully qualified -dev parameter was not used, you must specify the fully qualified -srclss source_LSS_ID and the -tgtlss target_LSS_ID values. For example: -srclss IBM.2107-75FA120/00 (for DS8000), -srclss IBM.1750-75FA120/00 (for DS6000), -tgtlss IBM.2107-75FA120/01 (for DS8000), and -tgtlss IBM.1750-75FA120/01 (for DS6000). e. The shortened version of the source_port_ID:target_port_ID parameter is shown (value = I1A10:I2A20), because the example uses the fully qualified -dev storage_image_ID and -remotedev storage_image_ID parameters. If the fully qualified -dev and -remotedev parameters are not used, you must use the fully qualified source_port_ID:target_port_ID value. For example: IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20. The fully qualified source_port_ID:target_port_ID parameter is positional on your command line. It must be placed after the -tgtlss parameter. For example:
dscli> mkpprcpath -srclss 00 -tgtlss 00 IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20
Example
dscli> mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -srclss 01 -tgtlss 00 remotewwnn 12341234000A000F I1A10:I2A20
2. Issue the lspprcpath command to review the list of established remote mirror and copy paths.
Procedure
1. Check the original input values you provided for the -remotewwnn and -tgtlss parameters. The following criteria applies to these parameters: -remotewwnn You must use the worldwide node name that is associated with the secondary storage unit. If you use the WWNN (worldwide node name) that is associated with the primary storage unit, the mkpprcpath command fails. Issue the lssi or showsi command to obtain the remote WWNN number of the secondary storage unit.
497
tgtlss
You must use the logical subsystem ID that is associated with the secondary storage unit as the target. You can verify that you have used the correct value by looking at the report that is generated by the lspprcpath command.
2. Obtain the correct values for the remote WWNN or target LSS ID and reissue the mkpprcpath command followed by issuing the lspprcpath command to verify that your transaction has processed correctly.
Removing paths
Complete this task to remove paths between the LSSs on the source storage unit and the target LSSs on the target storage units.
Procedure
1. Issue the lspprcpath command to display a list of existing remote mirror and copy path definitions. Enter the lspprcpath command at the dscli command prompt with the following parameters and variables: dscli> lspprcpath -dev storage_image_ID source_LSS_ID Example
dscli> lspprcpath dev IBM.2107-75FA120 01
The report that displays from this command provides the worldwide node name (WWNN) that is used with the rmpprcpath command. 2. Issue the rmpprcpath command to remove the paths between all source and target pairs. Enter the rmpprcpath command at the dscli command prompt with the following parameters and variables: dscli> rmpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn source_LSS_ID:target_LSS_ID Example
dscli> rmpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -remotewwnn 12341234000A000F 01:01
Note: v The -remotedev parameter specifies the ID of the secondary storage unit. v The -remotewwnn parameter must specify the WWNN of the secondary storage unit. If you specify the WWNN of the primary storage unit, the command fails. v If you do not specify the fully qualified -dev and -remotedev parameters, you must use the fully qualified source_LSS_ID:target_LSS_ID value. For example: IBM.2107-75FA120/ 01:IBM.2107-75FA150/01. The fully qualified source_LSS_ID:target_LSS_ID value must be the last parameter in your command.
498
A confirmation message is displayed for each path that is being removed. 3. Enter Y to confirm that you want to remove the specified remote mirror and copy path. A message like the following appears for each remote mirror and copy path that is being removed when you process the rmpprcpath command.
Are you sure you want to delete PPRC path (whatever was designated)? [y/n]: Y PPRC path (designated in the command) successfully deleted.
4. Repeat Step 2 for all the remote mirror and copy paths that you want removed from the same source LSS to a different target LSS.
Procedure
1. Issue the lsfbvol command (for fixed blocked (FB) volumes) or the lsckdvol command (for count key data (CKD) volumes) to display which volumes are available for Metro Mirror relationships on the source and target LSSs. A report is displayed that shows the availability of the volumes. 2. Issue the mkpprc command to create a Metro Mirror relationship between a source volume and a target volume. The mkpprc command must contain the following parameters and variables: dscli> mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir SourceVolumeID:TargetVolumeID. Note: v The -remotedev parameter specifies the ID of the secondary storage unit. v The -type mmir parameter specifies that you want to establish one or more Metro Mirror volume relationships. Metro Mirror creates the remote mirror and copy relationship in a synchronous manner.
499
v The shortened version of the SourceVolumeID:TargetVolumeID parameter is shown (value = 0100:0100) because the example uses the fully qualified -dev storage_image_ID and -remotedev storage_image_ID parameters. If the fully qualified -dev and -remotedev parameters were not used, you must use the fully qualified SourceVolumeID:TargetVolumeID value. For example IBM.2107-75FA120/0100:IBM.2107-75FA150/0100. Example
dscli> mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -type mmir 0100:0100
A confirmation message is issued for each successful Metro Mirror volume association that is created. 3. Issue the lspprc command to view the status information of each Metro Mirror relationship in the list. Enter the lspprc command at the dscli command prompt with parameters and variables as follows: dscli> lspprc -dev storage_image_ID -remotedev storage_image_ID -s SourceVolumeID:TargetVolumeID.
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -s 0100:0100 0101:0101
500
Procedure
1. Issue the mkpprcpath command to create a consistency group for the remote mirror and copy volume pairs. Enter the mkpprcpath command with the -consistgrp parameter at the dscli command prompt with the following parameters and variables: dscli> mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -srclss source_LSS_ID -tgtlss target_LSS_ID remotewwnn wwnn -consistgrp source_port_ID:target_port_ID Example
dscli> mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -srclss 01 -tgtlss 01 remotewwnn 12341234000A000F -consistgrp I0100:I0100
2. View the current consistency group state setting status of the consistency group by issuing the showlss command. You can also use the chlss command to change the default consistency group timeout value. dscli> showlss -dev storage_image_ID LSS_ID Example
dscli> showlss IBM.2107-75FA120/10
Procedure
Issue the resumepprc command to continue Metro Mirror processing after it has been suspended (paused). Enter the resumepprc command at the dscli command prompt with the following parameters and variables: dscli> resumepprc -dev storage_image_ID -remotedev storage_image_ID -type [mmir, gcp] SourceVolumeID:TargetVolumeID Notes: 1. The -remotedev parameter specifies the ID of the secondary storage unit. 2. Specify the -type parameter when you use the resumepprc command. Otherwise, the command fails.
501
3. If you do not specify the fully qualified -dev and -remotedev parameters, you must use the fully qualified SourceVolumeID:TargetVolumeID value. For example: IBM.2107-75FA120/ 01:IBM.2107-75FA150/01 (DS8000) or IBM.1750-68FA120/01:IBM.1750-68FA150/01 (DS6000) Example
dscli> resumepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -type mmir 0100:0100
Procedure
Issue the pausepprc command to pause Metro Mirror processing. Enter the pausepprc command at the dscli command prompt using the following parameters and variables: dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID Note: v The -remotedev parameter specifies the ID of the secondary storage unit. v If you do not specify the fully qualified -dev and -remotedev parameters, you must use the fully qualified SourceVolumeID:TargetVolumeID value. For example: IBM.2107-75FA120/ 01:IBM.2107-75FA150/01. Example:
dscli> pausepprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
A confirmation message is displayed that indicates that processing for the specified volume pair has been paused.
What to do next
After making your changes, you can resume processing by issuing the resumepprc command.
502
v The remote mirror and copy license key is installed and enabled to allow operations to be performed. If you are using a Model 2105 ESS as part of the configuration, ensure that you have PPRC Version 2 license enabled. v The I/O ports are configured for paths between source and target LSSs. v The Fibre Channel paths are created between all Metro Mirror source and target LSSs. The paths are needed for communication between the volume pairs and to copy data from the source volumes to the target volumes. Otherwise, this task fails.
Procedure
1. Issue the lsfbvol command (for fixed blocked (FB) volumes) or the lsckdvol command (for count key data (CKD) volumes) to display which volumes are available for Global Copy relationships on the source and target LSSs. A report is displayed that shows the availability of the volumes. 2. Issue the mkpprc command to create a Global Copy relationship between a source volume and a target volume. Enter the mkpprc command at the dscli command prompt with the following parameters and variables: dscli> mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -mode full SourceVolumeID:TargetVolumeID Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit. b. The -type gcp parameter specifies that one or more Metro Mirror volume relationships be established. Global Copy creates the remote mirror and copy relationship in an asynchronous manner. c. The shortened version of the SourceVolumeID:TargetVolumeID parameter is shown (value = 0100:0100) because the example uses the fully qualified -dev storage_image_ID and -remotedev storage_image_ID parameters. If the fully qualified -dev and -remotedev parameters were not used, you must use the fully qualified SourceVolumeID:TargetVolumeID value. For example: IBM.2107-75FA120/0100:IBM.210775FA150/0100. This value must be placed at the end of your command line. Example
dscli> mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -type gcp -mode full 0100:0100
A confirmation message is issued for each successful Global Copy volume association that is created. 3. Issue the lspprc command to view the status information of each Metro Mirror relationship in the list. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -remotedev storage_image_ID -s SourceVolumeID:TargetVolumeID.
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -s 0100:0100 0101:0101
503
Procedure
1. Issue the lspprc command to generate a report of Metro Mirror relationships. This can help you determine which Metro Mirror relationship that you want to delete. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -state -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> lspprc -dev IBM.2107-75FA120 -l -remotedev IBM.2107-75FA150 0100:0100 0101:0101
2. Issue the rmpprc command to delete the Metro Mirror relationship between the source and target volume. Enter the rmpprc command at the dscli command prompt with the following parameters and variables: dscli> rmpprc -dev storage_image_ID -remotedev SourceVolumeID:TargetVolumeID Example
dscli> rmpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
Notes: a. If you delete a Metro Mirror volume pair with the source LSS and the process runs successfully, the source and the target volume go into the simplex state. b. If you delete a Metro Mirror volume pair with the target LSS and the process runs successfully, the source volume is in the suspended state, and the target volume is in the simplex state. This option is useful in a disaster situation when the source (local) site has failed.
504
Procedure
Issue the chlcu command to modify a Concurrent Copy timeout value. Enter the chlcu command at the dscli command prompt with the following parameters and variables: dscli> chlcu -dev storage_image_ID -ccsess timeout LCU_ID Example
dscli> chlcu -dev IBM.2107-75FA120 -ccsess 190 00-0F
A confirmation message is displayed for each LCU that has been modified.
Procedure
Issue the chlcu command to modify the consistency group timeout value. Enter the chlcu command at the dscli command prompt with the following parameters and variables: dscli> chlcu -dev storage_image_ID -extlongbusy timeout LCU_ID Example
dscli> chlcu -dev IBM.2107-75FA120 -extlongbusy 3 00-0F
505
default value is 300 seconds. (The z/OS Global Mirror timeout value is also known as the Extended Remote Copy (XRC) timeout value that is supported on the ESS.) The long-busy condition occurs because the system data mover cannot copy data when the volume (or z/OS Global Mirror session) is not able to accept additional data. The value of this timeout is associated with a z/OS Global Mirror session when the session is created. Perform the following step to modify the z/OS Global Mirror timeout value. The example command in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with values declared for the variables.
Procedure
Issue the chlcu command to modify the z/OS Global Mirror timeout value. Enter the chlcu command at the dscli command prompt with the following parameters and variables: dscli> chlcu -dev storage_image_ID -xrcsess timeout LCU_ID Example
dscli> chlcu -dev IBM.2107-75FA120 -xrcsess 175 00-0F
Procedure
Issue the chlcu command to modify the critical mode setting. Enter the chlcu command at the dscli command prompt with the following parameters and variables: dscli> chlcu -dev storage_image_ID -critmode enable LCU_ID Example
dscli> chlcu -dev IBM.2107-75FA120 -critmode enable 00-0F
Note: Use the -critmode parameter only for log devices, not for devices that the system requires. In extreme cases, the host system might require you to load the initial program to recover a device that is write inhibited. Whenever possible, use the freezepprc command as an alternative to using
506
the -critmode parameter. This parameter cannot be used with Global Copy or remote copy and mirror cascading volumes. This parameter only applies to S/390 or System z volumes. The following table presents an overview of how the critical volume mode works.
Critical Mode Normal LCU, Critical Heavy Disabled or Enabled mkpprc critmode Disabled Description v Suspends the primary volume. v Allows write operations to the primary volume. Critical Volume Disabled Enabled v Suspends primary volume when the last path to the secondary volume has failed. v Inhibits write operations to the primary volume. Critical Heavy Enabled Enabled v Suspends the primary volume when the secondary volume cannot be updated for any reason. v Inhibits write operations to the primary volume.
507
Perform the following step to define a path that has enabled the consistency group option for the volume pairs that are associated with the LSS volume pair. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with values declared for the variables.
Procedure
Issue the mkpprcpath command to create a consistency group for the remote mirror and copy volume pairs. Enter the mkpprcpath command with the -consistgrp parameter at the dscli command prompt with the following parameters and variables: dscli> mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -srclss source_LSS_ID -tgtlss target_LSS_ID remotewwnn wwnn -consistgrp source_port_ID:target_port_ID Example
dscli> mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -srclss 01 -tgtlss 01 remotewwnn 12341234000A000F -consistgrp I0100:I0100
Procedure
Issue the lspprcpath command to generate a report of existing remote mirror and copy path definitions. Enter the lspprcpath command at the dscli command prompt with the following parameters and variables: dscli> lspprcpath -dev storage_image_ID -fullid Source_LSS_ID Example
dscli> lspprcpath -dev IBM.2107-75FA120 -fullid 10
508
Perform the following step to perform a failback recovery operation. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with declared values for the variables.
Procedure
1. Issue the failbackpprc command to perform a failback recovery operation. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables: dscli> failbackpprc -dev storage_image_ID -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> failbackpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100-0103:0100-0103
2. Issue the lspprc command to check the status information of each Metro Mirror relationship in the list. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -remotedev storage_image_ID -s SourceVolumeID:TargetVolumeID Example
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -s 0100:0100 0200:0200 0300:0300
Procedure
Issue the failoverpprc command to perform a failover recovery operation. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables: dscli> failoverpprc -dev storage_image_ID -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> failoverpprc -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 0100-0103:0100-0103
509
Procedure
Issue the lspprc command to generate a report of Metro Mirror relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -state -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> lspprc -dev IBM.2107-75FA120 -l -remotedev IBM.2107-75FA150 0100:0100 0101:0101
Procedure
Issue the mkpprc command to convert Global Copy volume pairs to synchronous (Metro Mirror volume pairs). Enter the mkpprc command with the -type mmir parameter at the dscli command prompt with the following parameters and variables:
510
dscli> mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir SourceVolumeID:TargetVolumeID Example
dscli> mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100 -type mmir 0101:0101 0102:0102 0103:0103
Procedure
1. Issue the lsavailpprcport command to display a list of available I/O ports that are available for paths. Enter the lsavailpprcport command at the dscli command prompt with the parameters and variables shown as follows: dscli> lsavailpprcport -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn source_LSS_ID:target_LSS_ID Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit. b. The -remotewwnn parameter must specify the worldwide node name of the secondary storage unit. If you make a mistake and specify the worldwide node name of the primary storage unit, the command fails.
511
c. The shortened version of the source_LSS_ID:target_LSS_ID parameter is shown (value = 01:01) because the example uses the fully qualified -dev storage_image_ID and -remotedev storage_image_ID parameters. If the fully qualified -dev and -remotedev parameters were not used, you must use the fully qualified source_LSS_ID:target_LSS_ID value. For DS8000, example: IBM.2107-75FA120/01:IBM.2107-75FA150/01 The fully qualified source_LSS_ID:target_LSS_ID value must be placed after the -remotewwnn value in your command line. Your command line can look like the following example:
dscli> lsavailpprcport l remotewwnn 12341234000A000F IBM.2107-75FA120/01:IBM.2107-75FA150/01
Example
dscli> lsavailpprcport l dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 remotewwnn 12341234000A000F 01:01
2. Analyze the output that is generated and select from the available I/O ports to create the path. The information that is displayed shows available I/O ports combinations between the source LSSs and the target LSSs and the output depends on the current selection of adapters.
Procedure
1. Issue the lspprc command to generate a report about Metro Mirror relationships. This can help you determine which Metro Mirror relationships must be deleted. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID Example
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100 0101:0101
2. Issue the rmpprc command to delete the pair relationship that the volume still maintains. Enter the rmpprc command at the dscli command prompt with the following parameters and variables: Source volume
dscli> rmpprc -dev storage_image_ID -at src -unconditional SourceVolumeID
512
Example
dscli> rmpprc -dev IBM.2107-75FA120 -at src -unconditional 0100
Target volume
dscli> rmpprc -dev storage_image_ID -at tgt -unconditional TargetVolumeID
Example
dscli> rmpprc -dev IBM.2107-75FA150 -at tgt -unconditional 0100
Notes: a. The -dev parameter must contain the value of the secondary server when you are removing the pair relationship from a target volume. b. The management console must be able to communicate with the secondary server for this command to succeed.
Creating a Metro Mirror volume pair between a DS8000 model or a DS6000 model and a 2105
Complete this task to create a Metro Mirror volume pair using volumes from a DS8000 or a DS6000 model and a 2105.
513
Procedure
1. Issue the lsavailpprcport command to list all of the available ports to the remote system to create a connection. Ensure that you use ports that are not mapped to hosts for PPRC for increased performance, but sharing host ports with PPRC ports is supported. Specify the remote WWPN and device ID for the target cluster. Enter the lsavailpprcport command at the dscli command prompt with the following parameters and variables: dscli> lsavailpprcport -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn Source_LSS_ID:Target_LSS_ID
514
Example
dscli> lsavailpprcport -dev IBM.2107-13AB7DA -remotedev IBM.2105-18602 -remotewwnn 5005076300C08642 10:10
2. Issue the mkpprcpath command to create a path between LSSs on the DS8000 or the DS6000 model to the ESS 800. You associate an LSS on the DS8000 or the DS6000 model to the ESS 800 and specify specific ports. You can list multiple ports. You should create redundant port paths from both controllers of the DS8000 or the DS6000 model to both clusters of the ESS 800. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables: dscli> mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -srclss source_LSS_ID -tgtlss target_LSS_ID remotewwnn wwnn -consistgrp source_port_ID:target_port_ID Example
dscli> mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2105-18602 -srclss 01 -tgtlss 01 remotewwnn 12341234000A000F -consistgrp I0100:I0100
3. Issue the lspprcpath command to display the created paths and their status. Success indicates that the path is valid, failure indicates that the path did not create correctly, or that the relationship has become separated. Enter the lspprcpath command at the dscli command prompt with the following parameters and variables: dscli> lspprcpath -dev storage_image_ID Source_LSS_ID Example
dscli> lspprcpath -dev IBM.2107-75FA120 10
4. Issue the rmpprcpath command to remove a path. You must specify both the source and target device IDs and the source and destination LSS. Enter the rmpprcpath command at the dscli command prompt with the following parameters and variables: dscli> rmpprcpath -dev storage_image_ID -remotedev storage_image_ID source_LSS_ID:target_LSS_ID Example
dscli> rmpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2105-18602 10:10
5. Issue the mkpprc command to create a relationship between a source and target volume. The volumes must be type ESS and be exactly the same size or the attempt to create the volume pair will fail. Enter the mkpprc command at the dscli command prompt with the following parameters and variables: dscli> mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir SourceVolumeID:TargetVolumeID Example
dscli> mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2105-18602 -type mmir 1001:1001
6. Issue the lspprc command to list the pairs that are in existence. Upon creation, the volumes will be in the copy pending state. When the initial copy is complete, the volumes will show as full duplex on the primary and target full duplex on the secondary. If something interrupts the connection, the primary volumes indicate "suspended", but the target volumes still show "full duplex. You can specify a range of volumes to list multiple pairs 1001 - 10ff. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli> lspprc -dev IBM.2107-75FA120 1001-10ff
515
Procedure
1. Issue the lspprc command to obtain a list of the Global Copy volumes that you can add to the Global Mirror session. A detailed report is displayed (if you use the -l parameter) that allows you to see the available volumes. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli> lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID. Example
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100
2. Issue the chsession command to add the available volumes to a Global Mirror session. Enter the chsession command at the dscli command prompt with the following parameters and variables: dscli> chsession -dev storage_image_ID -lss LSS_ID -action add -volume volume_ID session_ID Example
dscli> chsession -dev IBM.2107-75FA120 -lss 10 -action add -volume 0100-010F 01
A confirmation message indicates that the session has been modified successfully. 3. Issue the lssession command to query the status of all volumes being processed including the volumes that you added to the session. Enter the lssession command at the dscli command prompt with the following parameters and variables: dscli> lssession dev storage_image_ID -l LSS_ID
dscli> lssession dev IBM.2107-75FA120 -l 01
When you use the -l parameter, a detailed report displays a list of Global Mirror sessions for the specified logical subsystem (LSS) and information about the volumes of each session in the list.
516
Procedure
1. Issue the pausegmir command to pause Global Mirror processing on the specified logical subsystem and the specified session within the logical subsystem. Enter the pausegmir command at the dscli command prompt using the following parameters and variables: dscli> pausegmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> pausegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
A confirmation message indicates that the session has been paused after all buffered write operations to the target have been processed. 2. Issue the showgmir command to receive a report that provides the current properties or performance metrics for a Global mirror logical subsystem ID. Enter the showgmir command at the dscli command prompt with the following parameters and variables: For a detailed properties report: dscli> showgmir -dev storage_image_ID LSS_ID For a performance metrics report: dscli> showgmir -dev storage_image_ID -metrics LSS_ID Example These commands are entered as follows when you add values:
dscli> showgmir -dev IBM.2107-75FA120 10 dscli> showgmir -dev IBM.2107-75FA120 -metrics 10
3. Analyze the report and determine which if any of the Global Mirror tuning parameters must be changed. 4. Issue the resumegmir command with the values for all three tuning parameters. Enter the resumegmir command at the dscli command prompt with the following parameters and variables:
Chapter 6. Copy Services functions
517
dscli> resumegmir -dev storage_image_ID -lss ID -cginterval seconds -coordinate milliseconds -drain seconds -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example The example command shows all three tuning parameters with new values. You must specify a value for all three tuning parameters even if only one value has changed. The values for the two unchanged tuning parameters would be the DS CLI default values.
dscli> resumegmir -dev IBM.2107-75FA120 -coordinate 60 -drain 35 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00 -lss 10 -cginterval 10
Notes: a. The -cginterval parameter specifies the consistency group interval time, in seconds. The value specifies how long to wait between the formation of consistency groups. If this value is set to zero, consistency groups are formed continuously. The DS CLI default value is 0. b. The -coordinate parameter specifies the maximum coordination interval, in milliseconds. This value indicates the maximum time that Global Mirror processing queues Primary/Host/IO to start forming a consistency group. The DS CLI default value is 50 milliseconds. c. The -drain parameter specifies the maximum amount of time that writes (in seconds) are inhibited to the remote site before the current consistency group must stop. The DS CLI default value is 30 seconds.
Procedure
1. Issue the showgmir command to display a detailed properties or performance metrics report for a Global Mirror logical subsystem ID. Enter the showgmir command at the dscli command prompt with the following parameters and variables: For a detailed properties report: dscli> showgmir -dev storage_image_ID -fullid LSS_ID For a performance metrics report: dscli> showgmir -dev storage_image_ID -metrics LSS_ID
518
2. Use the report as a guide to see what is currently being processed and to determine what topology values you want to change. 3. Issue the rmgmir command to stop Global Mirror processing. Enter the rmgmir command at the dscli command prompt with the following parameters and variables: dscli> rmgmir -dev storage_image_ID -lss ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> rmgmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Notes: a. This command can interrupt the formation of a consistency group. If this command does not complete, an error code is issued. If this occurs, examine the error code and follow your local procedures for problem determination. In most cases, if you correct the error, you can successfully reissue the rmgmir command. If, however, the reissued rmgmir command fails and Global Mirror processing must be stopped, reissue the rmgmir command with the -force parameter. b. You cannot use the rmgmir command to stop a script that involves Global Mirror processing. The only way to stop a script is to press the Ctrl C keys on your keyboard. This action stops the DS CLI session. However, it does not stop the microcode that is processing Global Mirror transactions. To stop the microcode processing, you must log back into the DS CLI session and issue the rmgmir command. 4. Enter Y to confirm that you want to stop Global Mirror processing for the specified session. The message is displayed as follows:
Are you sure you want to stop Session ID (xx)? [y/n]: Y Global Mirror for Session ID 01 successfully stopped.
5. Issue the mkgmir command with your updated master and subordinate LSS changes to start Global Mirror processing. Enter the mkgmir command at the dscli command prompt with the following parameters and variables: dscli> mkgmir -dev storage_image_ID -lss ID -session session_ID -cginterval seconds -coordinate milliseconds -drain seconds Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> mkgmir -dev IBM.2107-75FA120 -lss 10 -session 01 -cginterval 0 -coordinate 40 -drain 35 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Notes: a. You can change your mind and decide not to change any of the topology values. However, you must still issue the mkgmir command to resume Global Mirror processing after you have stopped the processing. Because the resumegmir command is used only with the pausegmir command, you cannot issue the resumegmir command to restart the processing. b. When you stopped the Global Mirror session, the values for the tuning parameters become invalid. You must specify values for these parameters (-cginterval, -coordinate, -drain) when you restart your Global Mirror session.
519
Procedure
Issue the lssession command to display Global Mirror session information regarding the volumes in each session. Enter the lssession command at the dscli command prompt with the following parameters and variables: dscli> lssession dev storage_image_ID -l LSS_ID Example
dscli> lssession dev IBM.2107-75FA120 -l 01
Note: v Use the -l parameter if you want to see a detailed report. The report provides the following information: State of the session status. For example, whether the consistency group of the session is in progress or the increment process is in progress. The status of each volume in the session. Whether the first cycle of the volume in the global mirror relationship has ended. This value is displayed as true or false. v Use the -s parameter if you only want to see the volumes (with no details) that are associated with each session within the LSS.
Procedure
Issue the showgmir command to display a detailed report about the current Global Mirror operations. Or, you can request a report that displays the performance metrics associated with the current Global Mirror operations. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
520
For transaction details, enter: dscli> showgmir -dev storage_image_ID LSS_ID For performance metrics, enter: dscli> showgmir storage_image_ID -metrics LSS_ID Examples
dscli> showgmir -dev IBM.2107-75FA120 dscli> showgmir -dev IBM.2107-75FA120 10 -metrics 10
Procedure
1. Issue the pausegmir command to pause Global Mirror processing. Enter the pausegmir command at the dscli command prompt using the following parameters and variables: dscli> pausegmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> pausegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
2. Use the showgmir command to verify that your changes are correct. When you are ready to resume Global Mirror processing, issue the resumegmir command to continue with the Global Mirror processing. Do not issue the start (mkgmir) command to start Global Mirror processing.
521
Perform the following steps to resume Global Mirror processing. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with declared values for the variables.
Procedure
Issue the resumegmir command to continue Global Mirror processing after you have paused Global Mirror processing. Enter the resumegmir command at the dscli command prompt using the following parameters and variables: dscli> resumegmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> resumegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Note: If you are making changes to your tuning parameters, your command looks like the following example:
dscli> resumegmir -dev IBM.2107-75FA120 -coordinate 50 -drain 30 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00 -lss 10 -cginterval 5
In this example the -cginterval parameter was changed while the -coordinate and -drain parameters maintained their DS CLI default values. However, because the -cginterval parameter was changed, all the parameters and their corresponding values must be listed in your command. Otherwise, the command fails.
Procedure
Issue the mkgmir command to start Global Mirror processing. Enter the mkgmir command at the dscli command prompt using the following parameters and variables: dscli> mkgmir -dev storage_image_ID -lss LSS_ID -cginterval seconds -coordinate milliseconds -drain seconds -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> mkgmir -dev IBM.2107-75FA120 -lss 10 -cginterval 0 -coordinate 50 -drain 30 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Note: Issuing the mkgmir command requires that you specify the tuning parameters. The values for the tuning parameters are not retained when you end Global Mirror processing. So, in the case where you must change the Global Mirror topology parameters, resubmit the tuning parameters when you restart Global Mirror processing.
522
Procedure
1. Press the Ctrl C keys to immediately end the DS CLI session. 2. Log back into a DS CLI session and enter the rmgmir command to stop the microcode processing of the Global Mirror operations. 3. Proceed with the steps that are described in the Recovering when a disaster strikes task.
Procedure
1. Issue the rmgmir command to end Global Mirror processing. Enter the rmgmir command at the dscli command prompt using the following parameters and variables:
523
dscli> rmgmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli> rmgmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
2. Enter Y in response to each message that requests that you confirm that you want the specified session stopped. A message like the following appears when you process the rmgmir command.
Are you sure you want to close Session ID 01? [y/n]: Y Global Mirror for Session ID 01 closed successfully.
Procedure
1. Create Fibre Channel paths between all Global Mirror source and target pairs and between the Master and subordinate storage units. See Creating Fibre Channel paths (Global Mirror setup) for additional steps. 2. Create Global Copy pairs from the local storage units to the remote storage units. See Creating Global Copy pairs (Global Mirror setup) on page 526 for additional information. 3. Create FlashCopy relationships at the remote site between the Global Copy secondary volumes and the FlashCopy target volumes. See Creating FlashCopy relationships (Global Mirror setup) on page 527 for additional information. 4. Create the Global Mirror session. See Creating the Global Mirror session on page 528 for additional information.
Procedure
1. Obtain the worldwide node name of the secondary storage unit. This information is needed when you do the next step. Enter the lssi or showsi at the dscli command prompt as follows:
dscli> lssi -l
524
The showsi command does contain a variable and a command parameter: dscli> showsi storage_image_id -fullid Example
dscli> showsi -fullid IBM.210775FA120
Notes: a. Use the lssi command if you want to display a list of all the storage image instances for a storage-complex and status information for each storage image in the list. b. Use the showsi command if you want to display the detailed properties of a specific storage unit. c. Use the -fullid parameter with the showsi command to display fully qualified IDs, which include the storage image ID, for every ID that is displayed in the command output. d. Record the worldwide node name for the secondary (target) storage unit so that it can be used when you issue the mkpprcpath command. 2. Issue the lsavailpprcport command to display a list of Fibre Channel I/O ports that can be defined as remote mirror and copy paths. Enter the lsavailpprcport command at the dscli command prompt with the parameters and variables shown as follows: dscli> lsavailpprcport -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn source_LSS_ID:target_LSS_ID Example
dscli> lsavailpprcport l dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 remotewwnn 12341234000A000F 01:01
Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit. b. The -remotewwnn parameter must specify the worldwide node name of the secondary storage unit. If you make a mistake and specify the worldwide node name of the primary storage unit, the command fails. c. The shortened version of the source_LSS_ID:target_LSS_ID parameter is shown (value = 01:01) because the example uses the fully qualified -devstorage_image_ID and -remotedevstorage_image_ID parameters. If the fully qualified -dev and -remotedev parameters are not used, you must use the fully qualified source_LSS_ID:target_LSS_ID value. For example: IBM.2107-75FA120/01:IBM.2107-75FA150/01. The fully qualified source_LSS_ID:target_LSS_ID value must be placed after the -remotewwnn value in your command line. Your command line can look like the following example:
dscli> lsavailpprcport l remotewwnn 12341234000A000F IBM.2107-75FA120/01:IBM.2107-75FA150/01
3. Issue the mkpprcpath command to create the Fibre Channel paths between all Global Mirror source and target pairs and between the Master and subordinate storage units. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables as follows: dscli> mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn -srclss source_LSS_ID -tgtlss target_LSS_ID source_port_ID:target_port_ID Example
dscli> mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -remotewwnn 12341234000A000F -srclss IBM.2107-75FA120/00 -tgtlss IBM.2107-75FA150/01 I1A10:I2A20
Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit.
525
b. The -remotewwnn parameter must specify the worldwide node name of the secondary storage unit. If you make a mistake and specify the worldwide node name of the primary storage unit, the command fails. c. The shortened version of the -srclss parameter is shown (value = 00) because the example uses the fully qualified -dev storage_image_ID parameter. If the fully qualified -dev parameter was not used, you must use the fully qualified -srclsssource_LSS_ID value. For example: -srclss IBM.2107-75FA120/00. d. The shortened version of the -tgtlss parameter is shown (value = 01) because the example uses the fully qualified -dev storage_image_ID parameter. If the fully qualified -dev parameter was not used, you must use the fully qualified -tgtlsstarget_LSS_ID value. For example: -tgtlss IBM.2107-75FA120/01. e. The shortened version of the source_port_ID:target_port_ID parameter is shown (value = I1A10:I2A20) because the example uses the fully qualified -devstorage_image_ID and -remotedevstorage_image_ID parameters. If the fully qualified -dev and -remotedev parameters were not used, you must use the fully qualified source_port_ID:target_port_ID value. For example: IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20. The fully qualified source_port_ID:target_port_ID parameter is positional on your command line. It must be placed after the -tgtlss parameter and value. For example:
dscli> mkpprcpath -srclss 00 -tgtlss 01 IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20
Procedure
1. Issue the mkpprc command to create a Global Copy pair from the local storage unit to the remote storage unit and to create a relationship between the associated source volume and target volume. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID
Example
dscli> mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -type gcp 0100:0100
Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit.
526
b. The -type gcp parameter specifies that one or more remote mirror and copy Global Copy volume relationships be established. Global Copy maintains the remote mirror and copy relationship in a nonsynchronous manner. A confirmation message is issued for each successful Global Copy volume association that is created. 2. Issue the lspprc command to check the status information for each remote mirror and copy volume relationship in the list. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev storage_image_ID -l SourceVolumeID:TargetVolumeID -remotedev storage_image_ID
Example
dscli> lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100
Use the -l parameter to provide a more detailed report about the Global Copy volume relationships.
What to do next
Wait until the Global Copy pair process has completed its first pass before you begin creating the FlashCopy relationships. Note: Global Copy source volumes are not in the active Global Mirror session until the volumes have been added to the session and the session has started.
Procedure
1. Issue the mkflash command to create FlashCopy relationships at the remote site between the Global Copy secondary volumes and the FlashCopy target volumes. Enter the mkflash command at the dscli command prompt with the following parameters and variables:
dscli>mkflash -dev storage_image_ID -tgtinhibit -persist -record -nocp sourcevolumeID:targetvolumeID
Example
527
Notes: a. Specify the storage image ID of the secondary storage unit for the -dev storage_image_ID parameter. If the management console has an IP connection to the specified remote site, the command works. If the IP connection is not established, issue the mkremoteflash command with all the same parameters as displayed in the example. b. Specify the -tgtinhibit parameter to prevent writes to the target volume. c. Specify the -record parameter to activate the change recording function on the volume pair. d. Specify the -persist parameter to retain the FlashCopy relationship after the background copy completes. e. Specify the -nocp parameter to prevent creating a background copy. A confirmation message is issued for each successful FlashCopy pair that is created. 2. Issue the lsflash command to check the status information for each FlashCopy relationship at the remote site. Enter the lsflash command at the dscli command prompt with the following parameters and variables:
dscli>lsflash -dev storage_image_ID -l SourceVolumeID:TargetVolumeID -l 0100:0100
Example
dscli>lsflash -dev IBM.2107-75FA150
Use the -l parameter to provide a more detailed report about the FlashCopy relationships. Note: If you used the mkremoteflash command, you must enter the lsremoteflash command to perform a status check.
Procedure
1. Issue the mksession command to create the Global Mirror session. Enter the mksession command at the dscli command prompt using the following parameters and variables:
528
2. Repeat Step 1 for each LSS. You must make a session for each LSS. However, you can associate each LSS with the same session. For example: You have LSS 08 and it contains volumes 0800 - 0810. You create a session and assign it to session 08. You also have LSS 09 and it contains volumes 0900 - 0910. You create a session and assign it to session 08. When you start Global Mirror processing, the volumes for LSS 8 and LSS 9 are processed in the same session (session 08).
Procedure
1. Remove all Global Copy primary volumes from the Global Mirror sessions. See Removing volumes from a session (Global Mirror) for additional information. 2. End the Global Mirror sessions. See Ending a Global Mirror session on page 530 for additional information. 3. Withdraw all FlashCopy relationships between the B and C volumes. See Removing FlashCopy relationships on page 531 for additional information. 4. Remove the Global Copy pair relationships. See Removing the Global Copy pair relationship on page 532 for additional information. 5. Remove the remote mirror and copy paths between the local site and the remote site. Removing the Fibre Channel paths on page 533 for additional information.
529
You can remove Global Copy primary volumes from a Global Mirror session at any time after the Global Mirror session has started without stopping the session. If you have many volumes that you want to remove from a Global Mirror session, you might consider removing them from the session in stages. This lessens the impact on your processing. If you intend to use the volumes in a different configuration, you must remove the pair and path associations. Removing a volume from a Global Mirror session does not remove the pair and path associations. Perform the following steps to remove volumes from a Global Mirror session. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with declared values for the variables. Note: You can issue the commands that are described in the steps either for a DS8000 model or for a DS6000 model, but for the DS6000 model the storage image ID is different.
Procedure
1. Issue the lssession command to query the status of all volumes that are associated with the sessions of a specified logical subsystem. Enter the lssession command at the dscli command prompt with the following parameters and variables: dscli>lssession dev storage_image_ID -l LSS_ID
dscli>lssession dev IBM.2107-75FA120 -l 01
When you use the -l parameter, a detailed report displays a list of Global Mirror sessions for the specified logical subsystem (LSS) and information about the volumes of each session in the list. 2. Analyze the report and determine which volumes that you want to remove. 3. Issue the chsession command to remove the specified volumes from the specified Global Mirror session. Enter the chsession command at the dscli command prompt with the following parameters and variables: dscli>chsession -dev storage_image_ID -lss LSS_ID -action remove -volume volume_ID session_ID Example
dscli>chsession -dev IBM.2107-75FA120 -lss 10 -action remove -volume 0100-010F,0180-018F,0120 01
A confirmation message indicates that the session has been modified successfully. Note: A volume ID range is defined by two volume IDs that are separated by a hyphen. Multiple volume IDs or volume ID ranges must be separated by a comma.
What to do next
After the volumes have been removed from the Global Mirror session, you must end the volume associations for the removed volumes (FlashCopy, Global Copy pair, and remote mirror and copy path) if you plan to use the volumes in a different configuration.
530
Perform the following steps to end a Global Mirror session. The example commands in this task are shown in two formats. The first format shows the type of information that the command requires. The second format provides the command with declared values for the variables. Note: You can issue the commands that are described in the steps either for a DS8000 model or for a DS6000 model, but for the DS6000 model the storage image ID is different.
Procedure
1. Issue the lssession command to obtain a list of all sessions that are associated with the specified logical subsystem. Enter the lssession command at the dscli command prompt with the following parameters and variables: dscli>lssession -dev storage_image_ID -s LSS_ID Example
dscli>lssession dev IBM.2107-75FA120 -s 01
Note: For the circumstance described in this task, it is better to issue the -s parameter. The -s parameter creates a report with the following three items of information: v LSSID v Session number v Volume numbers 2. Print the report or record the session numbers that need to be ended. 3. Issue the rmsession command to end the specified session. Enter the rmsession command at the dscli command prompt with the following parameters and variables: dscli>rmsession -dev storage_image_ID -lss ID session_ID Example
dscli>rmsession -dev IBM.2107-75FA120 -lss 10 01
4. Enter Y to respond to the message that requests that you confirm that you want to end the specified session. A message like the following is displayed when you process the rmsession command.
Are you sure you want to close Session ID 01? y/n Y Global Mirror Session ID 01 closed successfully.
531
Note: Make certain that you no longer need your consistent set of data before you withdraw your relationships. If you still need your consistent data perform a backup data before proceeding with this task. Perform the following steps to remove FlashCopy relationships that existed with the volumes that were part of your Global Mirror environment. The example commands in this task are shown in two formats. The first format shows the type of information the command requires. The second format provides the command with declared values for the variables. Note: You can issue the commands that are described in the steps either for a DS8000 model or for a DS6000 model, but for the DS6000 model the storage image ID is different.
Procedure
1. Issue the lsflash command to check the status information for each FlashCopy relationship at the remote site. A detailed report (when you use the -l parameter) is displayed for each FlashCopy relationship. Enter the lsflash command at the dscli command prompt with the parameters and variables shown as follows: dscli>lsflash -dev storage_image_ID -l SourceVolumeID:TargetVolumeID.
dscli>lsflash -dev IBM.2107-75FA150 -l 0100:0100
Use the -l parameter to provide a more detailed report about the FlashCopy relationships. Note: If you originally used the mkremoteflash command to create your FlashCopy relationships, you must enter the lsremoteflash command to perform a status check. 2. Analyze the list of volumes that have been part of your Global Mirror environment and ensure that these are the volumes from which the FlashCopy relationship must be removed. 3. Issue the rmflash command to remove the FlashCopy volume relationships. Enter the rmflash command at the dscli command prompt with the parameters and variables shown as follows: dscli>rmflash -dev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli>rmflash -dev IBM.2107-75FA120 0001:0004 0003:00FF 0008:000C
Note: v The example shows the use of multiple FlashCopy pair IDs. Ensure that you separate multiple FlashCopy pair IDs with spaces. v If you used the mkremoteflash command to create your FlashCopy relationships, you must enter the rmremoteflash command to remove the FlashCopy relationships. 4. Enter Y in response to each message that requests that you confirm that you want the specified FlashCopy pair removed. A message like the following appears for each FlashCopy pair being removed when you process the rmflash command.
Are you sure you want to remove the FlashCopy pair 0001:0004? [y/n]: Y FlashCopy pair 0001:0004 successfully removed.
532
v Remove FlashCopy relationships that exist with the volumes that were part of your Global Mirror environment.
Procedure
1. Issue the lspprc command to check the status information for each Global Copy volume relationship in the list. Enter the lspprc command at the dscli command prompt with the parameters and variables shown as follows: dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID. Example
dscli>lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100:0100
Use the -l parameter to provide a more detailed report about the Global Copy volume relationships. 2. Analyze the list of volumes that have been part of your Global Mirror environment, and ensure that these are the volumes from which the Global Copy relationships must be removed. 3. Issue the rmpprc command to remove the Global Copy volume relationships. Enter the rmpprc command at the dscli command prompt with the following parameters and variables: dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli>rmpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100
4. Enter Y in response to each message to confirm that you want to remove the specified Global Copy pair. A message like the following is displayed for each Global Copy pair that is being removed when you process the rmflash command.
Are you sure you want to remove PPRC pair 0100:0100? [y/n]: Y Remote Mirror and Copy pair IBM.2107-75FA120/0100:0100 successfully removed.
5.
Repeat Steps 3 and 4 for all the volumes that have Global Copy relationships in the LSSs that were part of your Global Mirror environment.
533
v Remove FlashCopy relationships that exist with the volumes that were part of your Global Mirror environment. v Remove the Global Copy relationships that exist with the volumes that were part of your Global Mirror environment.
Procedure
1. Issue the lspprcpath command to display a list of existing remote mirror and copy path definitions. Enter the lspprcpath command at the dscli command prompt with the following parameters and variables: dscli>lspprcpath -dev storage_image_ID source_LSS_ID Example
dscli>lspprcpath l dev IBM.2107-75FA120 01
Note: The report that is displayed from this command provides the worldwide node name that is used with the rmpprcpath command. 2. Record the path information to use when you issue the rmpprcpath command. 3. Issue the rmpprcpath command to remove the Fibre Channel paths between all Global Mirror source and target pairs and between the master and subordinate storage units. Do this for each path that must be removed. Enter the rmpprcpath command at the dscli command prompt with the following parameters and variables: dscli>rmpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn source_LSS_ID:target_LSS_ID Example
dscli>rmpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -remotewwnn 12341234000A000F 01:01
4. Enter Y in response to each message to confirm that you want to remove the specified remote mirror and copy path. A message like the following is displayed for each remote mirror and copy path that is being removed.
Are you sure you want to delete the Remote Mirror and Copy path (whatever was designated)? [y/n]: Y Remote Mirror and Copy path (designated in the command) successfully deleted.
Note: Use of the -quiet parameter with the rmpprcpath command turns off the confirmation question for each path that is being removed. 5. Repeat Step 3 for all the remote mirror and copy paths per LSS that were part of your Global Mirror environment.
534
What to do next
After this task is complete, you can create your new Global Mirror environment and configuration.
535
536
Procedure
1. End Global Mirror processing when a disaster occurs. See Ending Global Mirror processing when a disaster occurs on page 538 for additional substeps. 2. Check the status of the current processing for Global Mirror transactions. See Checking Global Mirror transaction status in a disaster situation on page 539 for additional substeps. 3. Initiate the failover process of A volumes to B volumes. See Initiating failover processing for B volumes to A volumes on page 540 for additional substeps. 4. Analyze the consistency group status. See Analyzing and validating the consistency group state on page 541 for additional substeps. 5. Use the revertflash command to correct FlashCopy relationships. See Using the revertflash command to correct FlashCopy relationships on page 542 for additional substeps. 6. Use the commitflash command to correct FlashCopy relationships. See Using the commitflash command to correct FlashCopy relationships on page 543for additional substeps. 7. Initiate the fast reverse restore process. See Using fast reverse restore processing to create consistency on page 545 for additional substeps.
537
8. Wait for the background copy to complete. See Waiting for the background copy to complete on page 546 for additional substeps. 9. Reestablish the FlashCopy relationships, B volumes to C volumes. See Reestablishing the FlashCopy relationships between B volumes and C volumes on page 547 for additional substeps. 10. Prepare to reinstate production at the local site. See Preparing to reinstate production at the local site on page 548 for additional substeps. 11. Resynchronize the volumes. See Resynchronizing the volumes on page 549 for additional substeps. 12. Query for first pass and drain time out-of-synch zero value and quiesce your system. See Querying, quiescing, and re-querying on page 550 for additional substeps. 13. Reestablish the remote mirror and copy paths, A site to B site. See Reestablishing remote mirror and copy paths (site A to site B) on page 551 for additional substeps. 14. Perform Global Copy failover processing to the A volumes. See Performing Global Copy failover processing to the A volumes on page 552 for additional substeps. 15. Perform Global Copy failback processing for the A volumes. See Performing Global Copy failback processing for the A volumes on page 553 for additional substeps. 16. Resume Global Mirror processing at site A. See Resuming Global Mirror processing at site A on page 554 for additional substeps.
Procedure
Issue the rmgmir command to end Global Mirror processing or press the CTRL C buttons when you are using a DS CLI script and then issue the rmgmir command.
538
What to do next
After Global Mirror processing has been ended, you are ready for the next step in the Global Mirror failover recovery process.
Procedure
1. If your primary server is still operational, issue the lssession and lspprc commands to obtain reports that allow you to determine the status of your Global Mirror transactions. If your primary server is not available, go to the next step. 2. Gain access to your remote server and navigate to the directory where you installed the DS CLI. 3. Log in to a DS CLI session. 4. Issue the lspprc command to provide a report that allows you to determine the status of your Global Mirror transactions. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID Example
dscli>lspprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -l 0100-0103:0100-0103 0200:0200 0300-0303:0300-0303
Chapter 7. Recovering from a disaster using Global Mirror
539
Note: The report displays your Global Copy pairs with a suspended state.
What to do next
After you obtain your reports, you are ready for the next step in the Global Mirror disaster recovery process, which is to issue the failover command.
Procedure
Issue the failoverpprc command to change the Global Copy state on the B volumes from secondary, target pending to primary, suspended. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables: dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID SourceVolumeID:TargetVolumeID Example
dscli>failoverpprc -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 0100:0100 0101:0101 0102:0102 0103:0103
Note: Unlike most other commands, the storage_image_ID and SourceVolumeID:TargetVolumeID values are reversed for the failoverpprc command, because the command is issued directly to the remote server. You must place the values for the remote server first and the values for the original primary server second. This reversal (where the remote server is no longer the primary server) can have the following results: v The source volumes become suspended v The target volumes become suspended and they are available for mounting
540
An information message like the following one is generated for each Global Copy pair that is changed and moved to a suspended state.
Remote Mirror and Copy pair IBM.2107-75FA150/0100:IBM.2107-75FA120/0100 successfully suspended.
All B volumes must successfully process the failoverpprc command before you can proceed to the next step which involves analyzing the FlashCopy relationships and initiating the appropriate commands.
Procedure
1. Issue the lsflash command to provide a report that lists the FlashCopy relationships and status information for each FlashCopy relationship in the list. Enter the lsflash command at the dscli command prompt with the following parameters and variables:
Chapter 7. Recovering from a disaster using Global Mirror
541
Remember that your remote server has become your primary server. 2. Analyze your report to determine the state of the consistency group between the B volume and C volume. You are looking primarily at the FlashCopy relationships and your analysis determines your next step in the recovery process. The following provides the types of FlashCopy relationships that might exist and a reference to the action that must be taken: v The FlashCopy relationships are nonrevertible and all the sequence numbers are equal. Action: No further action is necessary and the set of C volumes is consistent and a complete copy. v The FlashCopy relationships are revertible and all the sequence numbers are equal. Action: Issue the revertflash command to revert the FlashCopy pairs to the last consistency group. v All the FlashCopy sequence numbers are equal and at least one of the FlashCopy relationships is nonrevertible. Action: Issue the commitflash command to commit the data to a target volume to form a consistency group between the source and target. v The FlashCopy relationships appear as follows: a. Some of the FlashCopy relationships completed processing so that a consistent group was created. These FlashCopy relationships are no longer revertible. b. Some of the FlashCopy relationships have not completed creating a consistency group formation. They are still in a revertible state. c. All the FlashCopy relationships have the same FlashCopy sequence number. This indicates that all the FlashCopy relationships were involved in the same consistency group. Action: Issue the commitflash command to commit the data of the FlashCopy relationships that have not completed creating a new consistency group so that a consistency group is formed. v There is a group of FlashCopy pairs that are all revertible and another group of FlashCopy pairs that are all nonrevertible. In addition, all the FlashCopy sequence numbers are not equal. However, the following conditions exists: a. The FlashCopy sequence number for all revertible pairs is equal. b. The FlashCopy sequence number for all nonrevertible pairs is equal. Action: Issue the revertflash command to revert the FlashCopy pairs to the last consistency group. v The FlashCopy sequence numbers are not equal for all FlashCopy relationships in the concerned consistency group and either a or b in the previous bullet was not true. This indicates that the consistency group is corrupted. Action: Contact your IBM service representative. Note: When you know the state of all the FlashCopy relationships, you might want to initiate a tape backup of the C volume.
What to do next
After determining the state of the FlashCopy relationships, issue the revertflash or commitflash commands, as appropriate.
542
Procedure
Issue the revertflash command to correct the FlashCopy relationships and reset them to the last consistency group state. Enter the revertflash command at the dscli command prompt with the following parameters and variables: dscli>revertflash -dev storage_image_ID SourceVolumeID Example
dscli>revertflash -dev IBM.2107-75FA150 0100
Notes: 1. Remember that the storage_image_ID is the value for the remote server that has been designated the primary server until the original primary server is available for use. 2. Global Mirror operations have performed the establish FlashCopy revertible processing as it was trying to form a consistency group before the disaster occurred. If your analysis, through use of the lsflash command, has determined that a revertflash command is needed, then there is no need to issue a new mkflash command. A confirmation message like the following one is generated for each FlashCopy relationship that has been successfully reset.
FlashCopy pair 0100:0200 successfully reverted to the previous consistency.
What to do next
After all the FlashCopy relationships have been corrected, you are ready to use the fast reverse restore process, which is the next step in the Global Mirror disaster recovery process.
543
Procedure
Issue the commitflash command to correct the FlashCopy relationships and commit them to the consistency group that was being formed before the disaster occurred. Enter the commitflash command at the dscli command prompt with the following parameters and variables: dscli>commitflash -dev storage_image_ID SourceVolumeID Example
dscli>commitflash -dev IBM.2107-75FA150 0100
Notes: 1. Remember that the storage_image_ID is the value for the remote server that has been designated the primary server until the original primary server is available for use. 2. Global Mirror operations have performed the establish FlashCopy revertible processing as the Global Mirror operations were trying to form a consistency group before the disaster occurred. If your analysis, through use of the lsflash command, has determined that a commitflash command is required, then there is no need to issue a new mkflash command. A confirmation message like the following one is generated for each FlashCopy relationship that has been successfully reset.
FlashCopy pair 0100:0200 successfully committed.
What to do next
After all the FlashCopy relationships have been corrected, you are ready to use the fast reverse restore process, which is the next step in the Global Mirror disaster recovery process.
544
Procedure
Issue the reverseflash command to create the same consistency on the B volumes that you have on the C volumes. Enter the reverseflash command at the dscli command prompt with the following parameters and variables: dscli>reverseflash -dev storage_image_ID -fast -tgtpprc source_volume_ID:target_volume_ID Example
dscli>reverseflash -dev IBM.2107-75FA150 -fast -tgtpprc 0200:0100
Notes: 1. The -fast parameter determines that the reverseflash command is processed before the background copy completes. 2. When you reverse a FlashCopy relationship, the source and target IDs that you specify for the reverseflash command must be the same as the source and target IDs from the original FlashCopy relationship (the source and target IDs from the relationship before it is reversed). The target volume ID is the value that is specified for the C volume. The data from this volume is copied back to the source volume ID, which is the B volume. 3. The -tgtpprc parameter allows the FlashCopy target volume (B volume) to be a Remote Mirror and Copy source volume.
545
4. The storage_image_ID parameter is the value that is assigned to the remote storage unit, which has become the primary storage unit as a result of the failover action. 5. You must wait for the background copy to complete before you can proceed to the next process.
Procedure
1. Issue the lsflash command to check the existence of FlashCopy relationships between the B volume and the C volume. Enter the lsflash command at the dscli command line prompt with the following parameters and variables: dscli>lsflash -dev storage_image_ID -s target_volume_ID Example
dscli>lsflash -dev IBM.2107-75FA150 -s 0200
Notes: a. The storage_image_ID is the manufacture, storage unit type, and serial number value of the remote storage unit that has become the primary unit because of the disaster. b. The -s parameter limits the report information that is returned only to the FlashCopy pair relationships that still exist. c. By designating only the target volume ID, you are further limiting the report to display just the target side of the FlashCopy pair relationship. When the report returns a blank screen, it indicates that background copy has completed and that no FlashCopy relationships exist between the B volume and the C volume. 2. Repeat Step one periodically until no FlashCopy relationships exist between the B volume and the C volume.
What to do next
After the fast reverse restore and the background copy operations have completed, you can proceed to the next task which is reestablishing the FlashCopy relationship between the B volume and the C volume.
546
Procedure
1. Issue the mkflash command to create FlashCopy relationships at the remote site between the Global Copy secondary volumes and the FlashCopy target volumes. Enter the mkflash command at the dscli command prompt with the following parameters and variables: dscli>mkflash -dev storage_image_ID -tgtinhibit -persist -record -nocp sourcevolumeID:targetvolumeID Example
dscli>mkflash -dev IBM.2107-75FA150 -tgtinhibit -record -persist -nocp 0001:0004
Notes: a. Specify the secondary storage unit MTS (which has become the primary storage unit because of the disaster) for the -dev storage_image_ID parameter. b. Use the -tgtinhibit parameter to inhibit writes on the target volume. c. Use the -record parameter to activate change recording on the volume pair. d. Use the -persist parameter to retain the FlashCopy relationship after the background copy completes. e. Use the -nocp parameter to inhibit the background copy. f. The source_volume_ID is the value associated with the B volumes and the target_volume_ID is the value associated with the C volumes. 2. Use the lsflash command to check the status of the FlashCopy relationships after you have processed the mkflash command.
What to do next
After you have reestablished the FlashCopy relationships, you can start host I/O processing at the remote site on the B volumes. The production operation on the remote site, in this configuration, remains until you are ready to return production to the local site.
547
Procedure
1. Issue the lssi command against the Site A storage unit to obtain its worldwide node name. A report is displayed that provides the specific information about the Site A storage unit. Enter the lssi command at the dscli command prompt with the following parameters and variables: dscli>lssi -l storage_image_ID Example
dscli>lssi -l IBM.2107-75FA120
Record the worldwide node name because it is used in the next step. 2. Issue the mkpprcpath command to create the Fibre Channel paths from Site B to Site A and between the specific LSSs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables: dscli>mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn -srclss source_LSS_ID -tgtlss target_LSS_ID source_port_ID:target_port_ID Example
dscli>mkpprcpath -dev IBM.2107-75FA150 -remotedev IBM.2107-75FA120 -remotewwnn 12341234000A000A -srclss IBM.2107-75FA150/00 -tgtlss IBM.2107-75FA120/01 I1A20:I2A10
Notes: a. The -dev parameter specifies the ID of your source storage unit. At this point in time, your source is the Site B storage unit. b. The -remotedev parameter specifies the ID of the secondary storage unit. At this point in time, the remote storage unit is your Site A storage unit.
548
c. The -remotewwnn parameter must specify the worldwide node name of the secondary storage unit (Site A at this point in time). If you specify the worldwide node name of the primary storage unit (Site B), the command fails. d. The -srclss parameter refers to Site B storage unit as the source. e. The -tgtlss parameter specifies the Site A storage unit as the target. f. The source_port_ID:target_port_ID value has the Site B port ID as the source and the Site A port ID as the target.
What to do next
After you have established the paths, you are ready to move on to the second step on the failback recovery process which involves issuing the failbackpprc command from the B volume to the A volume.
Procedure
Issue the failbackpprc command to resynchronize your volumes. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables: dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp source_volume_ID:target_volume_ID Example
Chapter 7. Recovering from a disaster using Global Mirror
549
Notes: 1. The -dev parameter specifies the ID of your source storage unit. At this point in time, your source is the Site B storage unit. 2. The -remotedev parameter specifies the ID of the target storage unit. At this point in time, the remote storage unit is your Site A storage unit. 3. The source_volume_ID:target_volume_ID value has the Site B volume ID as the source and the Site A volume ID as the target.
What to do next
After submitting this command for processing, you must track the progress of the transaction until it completes its first pass. So, querying for first pass completion is the next step in the failback recovery process.
Procedure
1. Issue the lspprc command periodically to identify when the first pass of the out-of-sync (OOS) bitmap completes. Depending on the number of transactions that you have, some time elapses. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID Example
dscli>lspprc -dev IBM.210775FA150 -remotedev IBM.210775FA120 1000:1000
Notes: a. The -dev parameter specifies the ID of your source storage unit. Your source is the Site B storage unit. b. The -remotedev parameter specifies the ID of the target storage unit. The remote storage unit is your Site A storage unit.
550
c. The source_volume_ID:target_volume_ID value has the Site B volume ID as the source and the Site A volume ID as the target. 2. Quiesce your I/O and unmount your file systems at the B site to preserve the integrity of your file system. Note: Unmounting your file systems flushes the host cache and ensures that you actually copy valid data sets. 3. Reissue the lspprc on page 392 command periodically to identify when the remaining bits completely drain from the B site. This is indicated when the out-of-sync (OOS) tracks equal zero. Depending on the number of transactions that you have, some time elapses. Enter the lspprc command at the dscli command prompt with the following parameters and variables: dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID Example
dscli>lspprc -dev IBM.210775FA150 -remotedev IBM.210775FA120 1000:1000
What to do next
After this task is completed, you are ready to establish the remote mirror and copy paths from Site A to Site B.
Procedure
1. Obtain the worldwide node name of the secondary storage unit. This information is needed when you do the next step. Enter the lssi or showsi at the dscli command prompt as follows:
dscli>lssi -l
551
The showsi command does contain a variable and a command: dscli>showsi storage_image_id -fullid Example
dscli>showsi -fullid IBM.210775FA120
Notes: a. Use the lssi command if you want to display a list of all the storage image instances for a storage complex and the status information for each storage image in the list. b. Use the showsi command if you want to display the detailed properties of a specific storage unit. c. Use the -fullid DS CLI command with the showsi command to display fully qualified IDs, which include the storage image ID, for every ID that is displayed in the command output. d. Record the worldwide node name for the secondary (target) site B storage unit so that you can use it when you issue the mkpprcpath command. 2. Issue the mkpprcpath command to create the remote mirror and copy paths between all Global Mirror source and target pairs and between the master and subordinate storage units. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables as follows: dscli>mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn -srclss source_LSS_ID -tgtlss target_LSS_ID source_port_ID:target_port_ID Example
dscli>mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -remotewwnn 12341234000A000F -srclss 00 -tgtlss 01 I1A10:I2A20
Notes: a. The -remotedev parameter specifies the ID of the secondary storage unit. b. The -remotewwnn parameter must specify the worldwide node name of the secondary storage unit. If you make a mistake and specify the worldwide node name of the primary storage unit, the command fails. c. The shortened version of the -srclss parameter is shown (value = 00) because the example uses the fully qualified -dev storage_image_ID parameter. If the fully qualified -dev parameter is not used, you must use the fully qualified -srclss source_LSS_ID value. For example: -srclss IBM.2107-75FA120/00. d. The shortened version of the -tgtlss parameter is shown (value = 01) because the example uses the fully qualified -dev storage_image_ID parameter. If the fully qualified -dev parameter is not used, you must use the fully qualified -tgtlss target_LSS_ID value. For example: -tgtlss IBM.2107-75FA120/01. e. The shortened version of the source_port_ID:target_port_ID parameter is shown (value = I1A10:I2A20) because the example uses the fully qualified -dev storage_image_ID and -remotedev storage_image_ID parameters. If the fully qualified -dev and -remotedev parameters are not used, you must use the fully qualified source_port_ID:target_port_ID value. For example: IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20 . The fully qualified source_port_ID:target_port_ID parameter is positional on your command line. It must be placed after the -tgtlss parameter and value. For example:
dscli>mkpprcpath -srclss 00 -tgtlss 01 IBM.2107-75FA120/I1A10:IBM.2107-75FA150/I2A20
552
Procedure
Issue the failoverpprc command to reestablish the extended distance relationship and create the A Volume to B Volume Global Copy relationship. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables: dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID Example
dscli>failoverpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -type gcp 0100:0100 0101:0101 0102:0102 0103:0103
Note: The SourceVolume_ID is the A volume and the TargetVolume_ID is the B volume. A confirmation message like the following is generated for each Global Copy pair that has been changed and moved to a state of suspended.
PPRC pair IBM.2107-75FA120/0100:IBM.2107-75FA150/0100 successfully suspended.
Note: All A volumes must successfully process the failoverpprc command before you can proceed to the next step.
553
Procedure
Issue the failbackpprc command to resynchronize your volumes. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables: dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp SourceVolume_ID:TargetVolume_ID Example
dscli>failbackpprc -dev IBM.210775FA120 -remotedev IBM.210775FA150 -type gcp 1000:1000
Notes: 1. The -dev parameter specifies the ID of your source storage unit. Your source is the Site A storage unit. 2. The -remotedev parameter specifies the ID of the target storage unit. The remote storage unit is your Site B storage unit. 3. The SourceVolume_ID:TargetVolume_ID value has the Site A volume ID as the source and the Site B volume ID as the target.
Procedure
1. Issue the mkgmir command to start Global Mirror processing. Enter the mkgmir command at the dscli command prompt using the following parameters and variables:
554
mkgmir -dev storage_image_ID -lss LSS_ID -cginterval seconds -coordinate milliseconds -drain seconds -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID
Example
dscli>mkgmir -dev IBM.2107-75FA120 -lss 10 -cginterval 0 -coordinate 50 -drain 30 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Note: Issuing the mkgmir command requires that you specify the tuning parameters. The values for the tuning parameters are not retained when you end Global Mirror processing. So, in the case where you need to change the Global Mirror topology parameters, you need to resubmit the tuning parameters when you restart Global Mirror processing. 2. Issue the resumegmir command to continue Global Mirror processing after you have paused Global Mirror processing. Enter the resumegmir command at the dscli command prompt using the following parameters and variables: dscli>resumegmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID Example
dscli>resumegmir -dev IBM.2107-75FA120 -lss 10 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
Note: You might want to change or maintain the values that you had on your B site for the tuning parameters. You must restate these values before you process the resumegmir command. You cannot state a value for just one of the tuning parameters. You must restate all of the values (-cginterval, -coordinate, and -drain). The following example shows how to enter the resumegmir command to provide these values:
dscli>resumegmir -dev IBM.2107-75FA120 -lss 10 -cginterval 5 -coordinate 50 -drain 30 -session 01 IBM.2107-75FA120/00:IBM.2107-75FA150/00
555
556
Chapter 8. Recovery scenarios for planned and unplanned outages using Metro/Global Mirror
This section describes a Metro/Global Mirror environment (DS8000 only) that uses failover and failback operations to switch applications to an alternate site during planned outages such as maintenance updates or unplanned outages such as disasters: Note: The steps in these scenarios are examples. Other configurations might be possible but might not be supported by IBM. v Setting up a Metro/Global Mirror environment v Failover and restore operations to the intermediate (B) site v Failover and restore operations to the remote (C) site
Procedure
1. Ensure that the storage units are configured, assigned, and operating in a normal state. 2. Identify all volumes that will participate in a session. Identify which volumes are to be source and target volumes for Metro Mirror, Global Copy, and FlashCopy relationships, and the storage unit that you will designate as the master storage unit. 3. At each site, establish Fibre Channel paths.
Copyright IBM Corp. 2006, 2012
557
a. Determine that there are I/O ports available for paths between the source and the target LSSs using the lsavailpprcport command. See Determining which I/O ports are available for paths on page 511 for more information. b. Set up paths between local and intermediate sites for the Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
Ensure that you create the paths with the PPRC consistency group option (using the -consistgrp parameter) for the A and B volume pairs in Metro Mirror relationships. Specifying the consistency group option ensures that volume pairs from the specified LSSs that share the same paths belong to this consistency group. When an error occurs that affects any of these volumes in the consistency group, the volumes in the consistency group become suspended and enter a long-busy state until a consistency group operation is run. See Defining a path that has the consistency option enabled on page 507 for more information. c. Set up paths between the intermediate and remote sites for the Global Copy volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -remotewwnn 5005076303FFC220 -srclss 62 -tgtlss 64 I0033:I0303
See Creating remote mirror and copy paths on page 496 for more information. d. Use the lspprcpath command to view the newly created paths. See Displaying the status of established paths on page 495 for more information. 4. At the intermediate site, create Global Copy volume pairs between the intermediate and remote sites. Create the pairs from the intermediate storage unit to the remote storage unit using the previously established paths. Ensure that you specify the -cascade parameter to allow the source volume in a Global Copy relationship to be eligible to be a target volume for another relationship at the same time. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -mode nocp -cascade 0700-075f:1200-125f
See Creating a Global Copy relationship on page 502 for more information. 5. At the local site: a. Establish Metro Mirror volume pairs between the local and intermediate sites, with the Incremental Resynchronization option enabled. Create the pairs from the local storage unit to the intermediate storage unit using the previously established paths. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
558
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -mode full -incrementalresync enable 0700-075f:1200-125f
-type mmir
See Creating a Metro Mirror relationship on page 499 for more information. 6. At the remote site, create FlashCopy relationships. Create the relationships at the remote site between volume C (the FlashCopy source volume that is also the target volume of the Global Mirror session) and volume D (the FlashCopy target volume). Note: Delay initial FlashCopy operations until the Global Copy pairs have completed their first pass of the copying process. Enter the mkflash command at the dscli command prompt with the following parameters and variables:
dscli> mkflash -dev IBM.2107-75ALAG1 -tgtinhibit -record -persist -nocp 1200-125f:1900-195f
When you create FlashCopy relationships, select the following options: Enable Change Recording Select this option to activate the change recording feature on the volume pair that is participating in a FlashCopy relationship. Note: The Persistent FlashCopy option is automatically selected because it is required with the Enable Change Recording option. Inhibit writes to target volume Select this option to ensure that updates cannot be made to the target volume. This ensures data consistency on the target volume. If you select the Inhibit writes to target option, the change recording feature is not active on the target volume. Attention: Do not select the Initiate background copy option. This ensures that data is copied from the source volume to the target volume only if a track on the source volume is modified. See Creating FlashCopy relationships (Global Mirror setup) on page 527 for more information. 7. At the intermediate site: a. Define the Global Mirror session. Define the same session on the LSS that contains the master and on every LSS that contains volumes to be added to the Global Mirror session. Enter the mksession command at the dscli command prompt with the following parameters and variables:
dscli> mksession -lss 07 1
See Creating the Global Mirror session on page 528 for more information. b. Add volumes to the Global Mirror session. Enter the chsession command at the dscli command prompt with the following parameters and variables:
Chapter 8. Recovery scenarios using Metro/Global Mirror
559
See Adding volumes to a session (Global Mirror) on page 516 for more information. Note: If you have many volumes that you want to add to a new or existing Global Mirror session, you might consider adding them to the session in stages. When you add a large number of volumes at once to an existing Global Mirror session, the available resources for Global Copy processing within the affected ranks might be used by the initial copy pass of the new volumes. New volumes on the same ranks as existing volumes can use all the processing resources for the initialization of the new volumes. To avoid too much impact on your processing, you might consider adding new volumes to a Global Mirror session in small numbers per rank and wait until the first pass has completed before adding more volumes. c. Start the Global Mirror session. The master storage unit begins forming consistency groups for the specified Global Mirror session. Enter the mkgmir command at the dscli command prompt with the following parameters and variables:
dscli> mkgmir -lss 07 -session 1
See Starting Global Mirror processing on page 522 for more information. d. Issue a query to confirm that the session exists. Confirm that the individual LSS sessions are populated with the appropriate volumes. See Querying Global Mirror processing on page 520 for more information. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir 07
The following represents an example of the output (in table format for clarity):
CG Interval Time (seconds) 0 Coord. Time (milliseconds) 50 Max CG Drain Time (seconds) 30
Master Count 1
Successful CG Percentage 50
Subordinate Count 0
560
Failover and restore operations to the intermediate site during a planned outage
Use this process to perform failover and restore operations (DS8000 only) to the intermediate (B) site during an unplanned outage.
Procedure
1. At the local site, ensure that data consistency is achieved between the A to B volume pairs. This process helps coordinate the A volumes and B volumes consistency and allows consistent data to be copied to the remote site. You can use either of the following methods to create data consistency: v Quiesce I/O processing to the A volumes at the local site. Continue to step 2 on page 562. v Freeze write activity to the Metro Mirror primary volumes by performing the following steps: a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. Enter the freezepprc command at the dscli command prompt with the following parameters and variables:
dscli> freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07-12
This process ensures that the B volumes are consistent at the time of the freeze. (One command per storage unit or LSS is required.) As a result of the freeze action, the following actions are taken: v The established paths between the logical subsystem (LSS) pairs are deleted. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A Metro Mirror volumes. v I/O processing to the Metro Mirror volume pairs is temporarily queued during the time that updates are frozen. b. If wanted, you can view the state of the pair status at the local site after the freezepprc command has been processed. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -fmt default 0700-075f
Chapter 8. Recovery scenarios using Metro/Global Mirror
561
The following represents an example of the output: Notes: 1) The command example uses the command parameter -fmt default. This command parameter specifies that the output be set to a space-separated plain text table. 2) The following table format is presented for clarity. The actual report is not displayed in this format. 3) The report example represents the information that is reported on when you do not specify the -l parameter. See Viewing information about Metro Mirror relationships on page 510 for more information.
SourceLSS Timeout (secs) unknown unknown unknown Critical Mode Disabled Disabled Disabled First Pass Status Invalid Invalid Invalid
Type
c. Resume operations following a freeze. Issue the unfreezepprc command to allow I/O processing to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables: Note: This activity is sometimes referred to as a thaw operation.
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
2. Issue a failover command to the B to A volume pairs. This process detects that the B volumes are cascaded volumes at the intermediate site. When the command processes, the B volumes remain as primaries in a duplex pending state and secondaries to the A volumes. The B volumes remain nonexistent (or unavailable) secondary volumes to the A volumes in a Metro Mirror relationship. (In a cascaded relationship, the B volumes cannot be primary volumes in a Metro Mirror and Global Copy relationship at the same time.) When the direction of the volumes are switched and I/O processing is directed to the new primary B volumes, it is essential that the primary volumes (the A volumes) be the same size as the secondary volumes (the B volumes). See Performing a failover recovery operation on page 509 for more information. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp -cascade 1200-125f:1a00-1a5f
3. Redirect host I/O processing to the B volumes. Changes are recorded on the B volumes until the A volumes can be resynchronized with the B volumes.
562
4. When the A volumes are ready to return to production, pause the Global Mirror session between the B to C volumes. Direct this command to the same LSS that you used to start the session. This step is needed to later change the direction of the B volumes and restore the A volumes. Enter the pausegmir command at the dscli command prompt with the following parameters and variables:
dscli> pausegmir -dev IBM.2107-75ALA2P -quiet -lss 07 -session 1
See Pausing Global Mirror processing on page 521 for more information. 5. Suspend (pause) the B to C volume pairs. Because the site B volumes cannot be source volumes for Metro Mirror and Global Copy relationships, you must suspend the B to C volumes so that B to A volumes can be established. This step stops all incoming write I/O operations to the affected B and C volume pairs and helps prepare for a later resynchronization of the A volumes with the current operating B volumes. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 1200-125f:0700-075f
See Pausing a Metro Mirror relationship on page 502 for more information. 6. Establish paths between the local site LSS and intermediate site LSS that contain the B to A Metro Mirror volumes. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 07 -tgtlss 12 -consistgrp I0102:I0031 I0002:I0102
See Creating remote mirror and copy paths on page 496 for more information. 7. Issue a failback command to the B volumes (with A volumes as secondaries). Host I/O processing continues uninterrupted to the B volumes as the A volumes are made current. This command copies the changes back to the A volumes that were made to the B volumes while hosts are running on the B volumes. (In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.) See Performing a failback recovery operation on page 508 for more information. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp 1200-125f:1a00-1a5f
8. Wait for the copy process of the B to A volumes to reach full duplex status (all out-of-sync tracks have completed copying). Host writes are no longer tracked. You can monitor when the number of
Chapter 8. Recovery scenarios using Metro/Global Mirror
563
out-of-sync tracks reaches zero by querying the status of the volumes. See Viewing information about Metro Mirror relationships on page 510 for more information. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -l 1200-125f:1a00-1a5f
ID 1200:1a00 1201:1a01
Reason -
Source LSS 10 10
9. Quiesce host I/O processing to the B volumes. 10. Issue a failover command to the A to B volume pairs. This process ends the B to A volume relationships and establishes the A to B volume relationships. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-130126X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
See Performing a failover recovery operation on page 509 for more information. 11. After the failover operation, you can view the status of the volumes with the lspprc command. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-130126X -remotedev IBM.2107-75ALA2P -fmt default 1a00-1a5f
The following represents an example of the output: Notes: a. The command example uses the command parameter -fmt default. This command parameter specifies that the output be set to a space-separated plain text table. b. The following table format is presented for clarity. The actual report is not displayed in this format. c. The report example represents the information that is reported on when you do not specify the -l parameter.
564
Type
SourceLSS
12. Reestablish paths (that were disabled by the freeze operation) between the local site LSS and intermediate site LSS that contain the B to A Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 07 -tgtlss 12 -consistgrp I0102:I0031 I0002:I0102
See Reestablishing remote mirror and copy paths (site A to site B) on page 551 for more information. 13. Issue a failback command to the A to B volumes. This failback command completes the restoration of the A to B volume relationships (the B volume becomes the target). The replication of the data starts immediately when the command is finished. Depending on how many tracks have changed during the disaster recovery test, resynchronization might take a long time. Note: At this point, you can resume host I/O processing to the local site if optimizing host availability is critical. However, new host I/O that is written to the A volumes at the local site is not fully protected by Global Mirror processing until the Global Mirror operation is restored in step 16 on page 566. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
14. Reestablish Global Copy relationships between the B to C volumes with the -cascade option. When the failback operation has been done, Global Copy relationships can be re-created. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -mode nocp -cascade 1200-125f:0700-075f
15. Wait until the first pass of the Global Copy copying processing of the B to C volume pairs has completed. You can monitor this activity by querying the status of the volumes.
565
Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -l -fmt default 1200-125f:0700-075f
Reason -
Source LSS 07 07 07
16. Resume Global Mirror. Now that the original infrastructure has been restored, you can resume the Global Mirror session. Enter the resumegmir command at the dscli command prompt with the following parameters and variables:
dscli> resumegmir -dev IBM.2107-75ALA2P -session 1 -lss 07
See Resuming Global Mirror processing on page 521 for more information. 17. Resume host I/O processing to the A volumes. Direct host I/O processing back to the A volumes in preparation for resuming host I/O on the A volumes. 18. Verify that consistency group are forming successfully. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 07
The following represents an example of the output: See Querying Global Mirror processing on page 520 for more information.
Total Failed CG Count 0 Total Successful CG Count 55 Successful CG Percentage 100 Failed CG after Last Success 0 Last Successful CG Form Time 02/20/ 2006 11:38:25 MST Coord. Time (milliseconds) 50 CG Interval Time (seconds) 0
566
Failover and restore operations to the intermediate site during an unplanned outage
Use this process to perform failover and restore operations (DS8000 only) to the intermediate (B) site during an unplanned outage.
Procedure
1. At the local site, ensure that data consistency is achieved between the A and B volumes. If the local site was not completely destroyed, it is essential that data from any surviving A and B volume pairs be copied and a consistent copy be achieved at the remote site. You can use freeze and unfreeze commands that are supported using external automation software to create data consistency to multiple Metro Mirror volume pairs. To freeze write activity to Metro Mirror primary volumes, perform the following steps: a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. This ensures that the B volumes are consistent at the time of the freeze process. (One command per LSS is required.) Enter the freezepprc command at the dscli command prompt with the following parameters and variables: dscli> freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07-12 The following represents an example of the output:
CMUC00161W freezepprc: Remote Mirror and Copy consistency group 07:12 successfully created.
As a result of the freeze action, the following actions processing occurs: v The established paths between the LSS pairs are deleted. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A volumes in Metro Mirror relationships. v I/O to the Metro Mirror volume pairs is temporarily queued during the time that updates are frozen.
Chapter 8. Recovery scenarios using Metro/Global Mirror
567
b. Resume operations following a freeze. Issue the unfreezepprc command to allow I/O activity to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables: Note: This activity is sometimes referred to as a thaw operation.
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
2. Issue a failover command to the B to A volumes. This process detects that the B volumes are cascaded volumes at the intermediate site. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp -cascade 1200-125f:1a00-1a5f
See Performing a failover recovery operation on page 509 for more information. When the direction of the volumes are switched and I/O processing is directed to the new primary B volumes, it is essential that the primary volumes (the A volumes) be the same size as the secondary volumes (the B volumes). 3. Redirect host I/O processing to the B volumes. Changes are recorded on the B volumes until the A volumes can be resynchronized with the B volumes. 4. When the A volumes are ready to return, pause the Global Mirror session between the B to C volumes. Direct this command to the same LSS that you used to start the session. This step is needed to later change the direction of the B volumes and restore the A volumes. Enter the pausegmir command at the dscli command prompt with the following parameters and variables:
dscli> pausegmir -dev IBM.2107-75ALA2P -quiet -lss 07 -session 1
See Pausing Global Mirror processing on page 521 for more information. 5. Suspend the B and C volume pairs. Because the site B volumes cannot be source volumes for Metro Mirror and Global Copy relationships, you must suspend the B volumes to C volumes so that B volumes to A volumes can be established. This step stops all incoming write I/Os to the affected B and C volume pairs and helps prepare for a later resynchronization of the A volumes with the current operating B volumes. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 1200-125f:0700-075f
See Pausing a Metro Mirror relationship on page 502 for more information.
568
6. Establish paths between the local and intermediate sites that contain the B to A Metro Mirror volumes. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
See Creating remote mirror and copy paths on page 496 for more information. 7. Issue a failback command to the B volumes (with A volumes as secondaries): Host I/O processing continues uninterrupted to the B volumes as the A volumes are made current. This command copies the changes back to the A volumes that were made to the B volumes while hosts are running on the B volumes. (In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp 1200-125f:1a00-1a5f
See Performing a failback recovery operation on page 508 for more information. 8. Wait for the copy process of the B to A volumes to reach full duplex (all out-of-sync tracks have completed copying). Host writes are no longer tracked. Monitor this activity by issuing queries to determine when the B to A volumes reach full duplex status (the number of out-of-sync tracks reaches zero). Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev -remotedev IBM.2107-75ALA2P -l -fmt default 1200-125f:1a00-1a5f
See Viewing information about Metro Mirror relationships on page 510 for more information. 9. Quiesce host I/O processing to the B volumes. 10. Issue a failover command to the A to B volumes. This process ends the B to A volume relationships and establishes the A to B volume relationships. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-130126X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
See Performing a failover recovery operation on page 509 for more information. 11. Reestablish paths (that were disabled by the freeze operation) between the local site LSS and intermediate site LSS that contain the B to A Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
Chapter 8. Recovery scenarios using Metro/Global Mirror
569
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
See Reestablishing remote mirror and copy paths (site A to site B) on page 551 for more information. 12. Issue a failback command to the A to B volumes. This failback command completes the restore of the A to B volume relationship (the B volume becomes the target). The replication of the data starts immediately when the command is finished. Depending on how many tracks have changed during the disaster recovery test, resynchronization might take a long time. Note: At this point, you can resume host I/O processing to the local site if optimizing host availability is critical. However, new host I/O that is copied to the A volumes at the local site is not fully protected by Global Mirror processing until the Global Mirror operation is restored in step 15. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
See Performing a failback recovery operation on page 508 for more information. 13. Reestablish Global Copy relationships between the B and C volumes with the Resync and Cascade options. When the failback operation has been done, Global Copy relationships can be re-created. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -mode nocp -cascade 1200-125f:0700-075f
See Creating a Global Copy relationship on page 502 for more information. 14. Wait until the first pass of the Global Copy processing of the B and C volumes has completed. You can monitor this activity by querying the status of the B to C volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-75ALA2P -fmt default 1200-125f:0700-075f -l
15. Resume Global Mirror. Now that the original infrastructure has been restored, you can resume the Global Mirror session. Enter the resumegmir command at the dscli command prompt with the following parameters and variables:
dscli> resumegmir -dev IBM.2107-75ALA2P -session 1 -lss 07
570
See Resuming Global Mirror processing on page 521 for more information. 16. Resume host I/O processing to the A volumes. Direct host I/O back to the A volumes in preparation for resuming host I/O on the A volumes. 17. Verify that consistency group are forming successfully. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 07
See Querying Global Mirror processing on page 520 for more information.
Failover and restore operations at the remote site during a planned outage
Use this process to perform failover and restore operations (DS8000 only) to your remote (C) site during a planned outage. Because Global Mirror is not used at the intermediate site, E volumes were not included in this scenario.
571
site. Assume that host I/O cannot be sent to the local site (Site A) in a Metro/Global Mirror configuration and it is not possible to run your systems using the B volumes at the intermediate site. You can switch operations to your remote site (Site C), which allows the processing of data to resume at the remote site. The Global Copy relationships between volumes at the intermediate and remote site are still operational. Global Mirror continues to operate between these two sites. Note: For planned and unplanned outages at the local site and for certain disaster scenarios, GDPS HyperSwap can reset and restart systems using data from the B volumes following a failover operation. GDPS HyperSwap does this transparently (without any system outage for systems running at the intermediate site) through the use of a single script statement. Complete these steps for failover and restore operations at the remote site: (The steps in this scenario are examples.)
Procedure
1. At the local site, ensure that data consistency is achieved between the A and B volume pairs. This process will help coordinate the A and B volumes consistency and allow consistent data to be copied to the C volumes at the remote site. You can use either one of the following methods: v Quiesce host I/O to the A volumes at the local site. v Freeze write activity to the Metro Mirror primary volumes. If you quiesce I/O processing to the A volumes at the local site, continue to step 2 on page 573. If you freeze write activity to the Metro Mirror primary volumes, perform the following steps: a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. This process ensures that the B volumes will be consistent at the time of the freeze. (One command per LSS is required.)
freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
As a result of the freeze action, the following processing occurs: v I/O processing to the Metro Mirror volume pairs is temporarily queued during the time that updates are frozen. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A volumes that are in Metro Mirror relationships. v The established paths between the LSS pairs are disabled. b. If wanted, you can view the state of the pair status at the local site after the freezepprc command has been processed. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -fmt default 0700-075f
The following represents an example of the output: Notes: 1) The command example uses the command parameter -fmt default. This command parameter specifies that the output be set to a space-separated plain text table. 2) The following table format is presented for clarity. The actual report is not displayed in this format. 3) The report example represents the information that is reported on when you do not specify the -l parameter.
572
Type
SourceLSS
c. Resume operations following a freeze. Issue the unfreezepprc command to allow I/O activity to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables: Note: This activity is sometimes referred to as a thaw operation.
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
2. Verify that the last data from the local site has been included in a Global Mirror consistency group. Monitor this activity to determine when at least two consistency groups have formed since I/O processing was quiesced or freeze commands were issued to the local site. The "Total Successful CG Count" field from the query output displays this information. At this point, data on the B, C, and D volumes is consistent. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 10
573
3. End the Global Mirror session between the B and C volume pairs. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -quiet -lss 10 -session 31
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 4. Verify that the Global Mirror session has ended. Consistency groups will not be forming when Global Mirror processing is stopped. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 10
574
5. Delete the relationships between the B and C volume pairs between the intermediate and remote sites. This prepares for reversing the direction of the volume pair from the remote site to the intermediate site. The cascaded relationship ends as well. Note: When the relationships between the B and C volumes are deleted, the cascade parameter is disabled for the B volumes and the B volumes are no longer detected as being in cascaded relationships. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.IBM.2107-75ALA2P -remotedev IBM.2107-1831760 1200-125f:0700-075f CMUC00155I rmpprc: Remote Mirror and Copy volume pair 1200:0700 relationship successfully withdrawn. CMUC00155I rmpprc: Remote Mirror and Copy volume pair 1201:0701 relationship successfully withdrawn. CMUC00155I rmpprc: Remote Mirror and Copy volume pair 1202:0702 relationship successfully withdrawn.
6. Issue a failover command to the B and A volume pairs, with the Cascade option. With this process, updates are collected using the change recording feature, which allows for the resynchronization of the B and A volumes. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp -cascade 1200-125f:1a00-1a5f
The resulting The following represents an example of the output: (a shortened version) is displayed:
CMUC00196I failoverpprc: Remote Mirror and Copy pair 1200:1A00 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1201:1A01 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1202:1A02 successfully reversed.
7. Create Global Copy relationships using the C and B volume pairs. Specify the NOCOPY option. You can specify the NOCOPY option with the following command because the B and C volumes contain exact copies of data. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -type gcp -mode nocp 0700-075f:1200-125f
8. Start I/O processing at the remote site. Continue in this mode until production is ready to return to the local site. 9. When you are ready to return production to the local site, quiesce I/O processing at the remote site. This process is used to begin the transition back host I/O to the A volumes.
575
10. Wait for the number of out-of-sync tracks on the C and B volume to reach zero. You can monitor this activity by querying the status of the C and B volumes. As soon as the number of out-of-sync tracks reaches zero, all data has been copied and the data on the C and B volumes is equal. All updates that are needed to resynchronize the A volumes are recorded at the B volumes. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -l -fmt default 0700-075f
Reason -
Source LSS 07 07 07
11. Reestablish paths (that were disabled by the freeze operation) between the local site LSS and intermediate site LSS that contain the B to A Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
See Creating remote mirror and copy paths on page 496 for more information. 12. Issue a failback command to the B to A volume pairs. This command copies the changes back to the A volumes that were made to the B volumes while hosts were running on the B volumes. The A volumes are now synchronized with the B volumes. (In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp 1200-125f:1a00-1a5f
576
See Performing a failback recovery operation on page 508 for more information. 13. Wait for the copy process of the B and A volume pairs to reach full duplex (all out-of-sync tracks have completed copying). You can monitor this activity by querying the status of the B and A volumes. As soon as the number of out-of-sync tracks reaches zero, all data has been copied and the data on the B and A volumes is equal. At this point, the data on volumes A, B, and C is equal. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -l -fmt default 1200-125f:1a00-1a5f
14. Delete the Global Copy relationships between the C and B volume pairs between the intermediate and remote sites. Deleting the Global Copy relationships between the C to B volume pairs prepares for restoring to the original Global Copy relationships between the B to C volume pairs. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P 0700-075f:1200-125f
15. Issue a failover command to the A and B volume pairs. This process ends the Metro Mirror relationships between the B and A volumes and establishes the Metro Mirror relationships between the A and B volumes. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-130165X -remotedev IBM.IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
16. Reestablish paths (that were disabled by the freeze operation) between the local site LSS and the intermediate site LSS that contain the B to A Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
See Creating remote mirror and copy paths on page 496 for more information. 17. Issue a failback command to the A to B volumes. This command copies the changes back to the A volumes that were made to the B volumes in Metro Mirror relationships while hosts were running on the B volumes. The A volumes are now synchronized with the B volumes. (In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables: Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
Chapter 8. Recovery scenarios using Metro/Global Mirror
577
See Performing a failback recovery operation on page 508 for more information. 18. Reestablish the B to C volume pairs in Global Copy relationships. Specify the NOCOPY option and the Cascade options. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -mode nocp -cascade 1200-125f:0700-075f
See Creating a Global Copy relationship on page 502 for more information. 19. Use FlashCopy to create a copy of C source volumes to the D target volumes. Enter the mkflash command at the dscli command prompt with the following parameters and variables. This creates a backup copy of the consistency group.
dscli> mkflash -dev IBM.2107-1831760 -tgtinhibit -record -persist -nocp 1300-125f:1900-195f
See Creating FlashCopy relationships (Global Mirror setup) on page 527 for more information. 20. Resume Global Mirror processing. Enter the resumegmir command at the dscli command prompt with the following parameters and variables:
dscli> resumegmir -dev IBM.2107-75ALA2P -session 31 -lss
See Resuming Global Mirror processing on page 521 for more information. 21. Resume host I/O processing to the A volumes.
Failover and restore operations at the remote site during an unplanned outage
Use this process to perform failover and restore operations (DS8000 only) at your remote (C) site during an unplanned outage, using E volumes at the intermediate site.
578
Procedure
1. If the local site was not completely destroyed, it is essential that data from any surviving A and B volume pairs be copied and a consistent copy be achieved at the remote site. If possible and you are able to freeze write activity to the Metro Mirror primary volumes, perform the following steps: a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. This process ensures that the B volumes are consistent at the time of the freeze. (One command per LSS is required.) Enter the freezepprc command at the dscli command prompt with the following parameters and variables:
dscli> freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
As a result of the freeze action, the following processing occurs: v The established paths between the LSS pairs are deleted. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A volumes that are in Metro Mirror relationships. v I/O processing to the Metro Mirror volume pairs is temporarily queued during the time that updates are frozen. b. Resume operations following a freeze. Issue the unfreezepprc command to allow I/O activity to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables: Note: This activity is sometimes referred to as a thaw operation.
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
579
CMUC00198I unfreezepprc: Remote Mirror and Copy pair 07:12 successfully thawed.
2. Verify that the last data from the local site has been included in a Global Mirror consistency group. Monitor this activity by querying the B and C volumes to determine when at least two successful consistency groups have formed. The "Total Successful CG Count" field from the query output displays this information. Note: When you use the showgmir command with the -metrics parameter, you can monitor the progress of the consistency group formation. When Global Mirror is running, the number of consistency groups is steadily growing each time you issue the showgmir command. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 10
3. Stop the Global Mirror session from which the B and C volume pairs are included. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -quiet -lss 10 -session 31
580
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 4. Verify that the Global Mirror session has ended. Consistency groups do not form when Global Mirror processing is stopped. See Querying Global Mirror processing on page 520 for more information. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir 10
Master Count -
Master Session ID -
Copy State -
Fatal Reason -
Current Time -
CG Time -
Successful CG Percentage -
Master ID -
Subordinate Count -
5. Delete the Global Copy relationships between the B and C volume pairs at the intermediate and remote sites. When the relationships between the B and C volumes are deleted, the cascade parameter is disabled for the B volumes and the B volumes are no longer detected as being in cascaded relationships. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 1200-125f:0700-075f
See Deleting a Metro Mirror relationship on page 503 for more information. 6. Issue a failover command to the B volumes with the Cascade option. With this process, updates are collected using the change recording feature, which allows the later resynchronization of the B to A volumes. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -type gcp -cascade 1200-125f:1a00-1a5f
581
CMUC00196I failoverpprc: Remote Mirror and Copy pair 1200:1A00 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1201:1A01 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1202:1A02 successfully reversed.
See Performing a failover recovery operation on page 509 for more information. 7. Create Global Copy relationships using the C and B volume pairs. Specify the NOCOPY option. Enter the mkpprc command at the dscli command prompt with the following parameters and variables: Note: You can specify the NOCOPY option with the following commands because the B and C volume pairs contain exact copies of data.
dscli> mkpprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -type gcp -mode nocp 0700-075f:1200-125f
See Creating a Global Copy relationship on page 502 for more information. 8. Use FlashCopy to create a copy of B source volumes to E target volumes. Specify the following options: Persistent and Start Change Recording. This creates a backup copy of the consistency group. Enter the mkflash command at the dscli command prompt with the following parameters and variables:
dscli> mkflash -dev IBM.2107-75ALA2P 1200-125f:1900-195f -tgtinhibit -record -persist -nocp
See Creating FlashCopy relationships (Global Mirror setup) on page 527 for more information. 9. Create a Global Mirror session using the C volumes. Enter the mksession command at the dscli command prompt with the following parameters and variables:
dscli> mksession -lss 07 1
See Creating the Global Mirror session on page 528 for more information. 10. Start the Global Mirror session from which the C, B and E volumes are included. Enter the mkgmir command at the dscli command prompt with the following parameters and variables:
dscli> mkgmir -lss 07 -session 1
See Starting Global Mirror processing on page 522 for more information. 11. Verify that the Global Mirror session has started. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir 07
582
Master Count 1
CG Interval (seconds) 0
Subordinate Count 0
12. Allow the I/O to run and monitor the formation of the consistency groups. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir 07
Master Count 1
Subordinate Count 0
13. When the local site is ready to return, issue a failback command to the B and A volumes. Before the applications are started at the local site, data at the local site has to be copied from the intermediate site. Issue the failbackpprc command to start copying data from the B volumes at the intermediate site to the A volumes at the local site while hosts are running on the B volumes. When all data is copied, the A volumes are synchronized with the B volumes. Note: In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.
583
Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type gcp -cascade 1200-125f:1a00-1a5f
See Performing a failback recovery operation on page 508 for more information. 14. Wait for the copy operation of the B and A volumes to reach full duplex status (all out-of-sync tracks have completed copying). You can monitor this activity by querying the status of the B and A volume pairs. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -l -fmt default 1200-125f
Reason -
Source LSS 12 12 12
15. End I/O processing to the C volumes.. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -quiet -lss 07 -session 1
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 16. Verify that at least two consistency groups have formed. Assuming that the consistency groups formed successfully, the A, B, C, and E volumes contain consistent data. (Data at the remote site is consistent to the last successful consistency group formed by the master storage unit.)See Querying Global Mirror processing on page 520 for more information. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
584
17. End the Global Mirror session between the C, B, and E volumes. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -quiet -lss 07 -session 1
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 18. Verify that the Global Mirror session that includes the C, B, and E volumes has stopped. Enter the showgmir command at the dscli command prompt with the following parameters and variables. showgmir 07 The following represents an example of the output:
Total Failed CG Count 23 Total Successful CG Count 139 Successful CG Percentage 85 Failed CG after Last Success 0 Last Successful CG Form Time 02/20/ 2006 11:33:56 MST Coord. Time (milliseconds) 50 CG Interval Time (seconds) 0
585
See Querying Global Mirror processing on page 520 for more information. 19. At the remote site, remove the C volumes (or Global Copy secondary volumes) from the Global Mirror session that includes the C, B, and E volumes. Enter the chsession command at the dscli command prompt with the following parameters and variables:
dscli> chsession -dev BM.2107-75ALA2P -action remove -volume 1200-125f -lss 07 1
See Removing volumes from a session (Global Mirror) on page 529 for more information. 20. Delete the Global Copy relationships between the C to B volumes between the intermediate and remote sites. Deleting the Global Copy relationships between the C to B volume pairs prepares for restoring to the original Global Copy relationships between the B to C volume pairs. The cascaded relationship ends, as well. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P 0700-075f:1200-125f CMUC00155I rmpprc: Remote Mirror and Copy volume pair 0700:1200 relationship successfully withdrawn. CMUC00155I rmpprc: Remote Mirror and Copy volume pair 0701:1201 relationship successfully withdrawn. CMUC00155I rmpprc: Remote Mirror and Copy volume pair 0702:1202 relationship successfully withdrawn.
See Deleting a Metro Mirror relationship on page 503 for more information. 21. Issue a failover command to the A to B volumes. This process ends the Metro Mirror relationships between the B and A volumes and establishes the Metro Mirror relationships between the A and B volume pairs. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
failoverpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
586
CMUC00196I failoverpprc: Remote Mirror and Copy pair 1A00:1200 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1A01:1201 successfully reversed. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1A02:1202 successfully reversed.
22. Reestablish paths that were disabled by the freeze operation between the local site LSS and intermediate site LSS that contain the B to A Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -remotewwnn 5005076303FFC550 -srclss 61 -tgtlss 63 -consistgrp I0102:I0031 I0002:I0102
See Reestablishing remote mirror and copy paths (site A to site B) on page 551 for more information. 23. Issue a failback command to the A and B volumes. This command copies the changes back to the A volumes that were made to the B volumes in Metro Mirror relationships while hosts were running on the B volumes. The A volumes are now synchronized with the B volumes. (In a DS CLI environment, where the local and intermediate sites use different management consoles, you have to use a different DS CLI session for the management console of the B volumes at the intermediate site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-130165X -type mmir 1a00-1a5f:1200-125f -remotedev IBM.2107-75ALA2P
24. Establish the B and C volume pairs in Global Copy relationships. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -mode nocp -cascade 1200-125f:0700-075f
See Creating a Global Copy relationship on page 502 for more information. 25. Optionally, you can issue a FlashCopy operation to create a backup copy of all the C, B, and E volumes from which the last consistency group was created. If you need to preserve data from the set of volumes (or consistency group) that was created using the E volumes, allow the background copy from the FlashCopy process to complete before you continue to the next step, which describes removing the FlashCopy relationship between the B to E volume pairs. Enter the mkflash command at the dscli command prompt with the following parameters and variables:
dscli> mkflash -dev IBM.2107-75ALA2P 1200-125f:1900-195f -tgtinhibit -record -persist -nocp
587
See Creating FlashCopy relationships (Global Mirror setup) on page 527 for more information. 26. Delete the FlashCopy relationship between the B and E volume pairs to end the relationship at the intermediate site. Enter the rmflash command at the dscli command prompt with the following parameters and variables:
dscli> rmflash -dev IBM.2107-75ALA2P -quiet 1200-125f:1900-195f
See Removing FlashCopy relationships on page 531 for more information. 27. Resume Global Mirror at the intermediate site. This starts Global Mirror processing for the B, C , and D volumes. Enter the resumegmir command at the dscli command prompt with the following parameters and variables:
dscli> resumegmir -dev IBM.2107-75ALA2P -session 10 -lss 31
See Resuming Global Mirror processing on page 521 for more information. 28. Resume I/O on A volumes. 29. Verify that consistency groups are forming successfully. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 10
Successful CG Percentage 97
588
See Querying Global Mirror processing on page 520 for more information.
Using forced failover and failback during a planned Metro/Global Mirror outage
Use this process to perform failover operations (DS8000 only) from the local (A) site to the intermediate (B) site during a planned outage.
Procedure
1. At the local site, ensure that data consistency is achieved between the site A and site B volumes. You can use freeze and unfreeze commands that are supported using external automation software to create data consistency to multiple Metro Mirror volume pairs. To freeze write activity to Metro Mirror primary volumes, perform the following steps:
589
a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. This ensures that the B volumes will be consistent at the time of the freeze process. (One command per LSS is required.) Enter the freezepprc command at the dscli command prompt with the following parameters and variables: dscli> freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07-12 The following represents an example of the output:
CMUC00161W freezepprc: Remote Mirror and Copy consistency group 07:12 successfully created.
As a result of the freeze action, the following processing occurs: v The established Remote Mirror and Copy paths between the LSS pairs are deleted. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A volumes in Metro Mirror relationships. v I/O to the Metro Mirror volume pairs is temporarily queued. b. Resume operations following a freeze. This operationalso called a thaw operationallows I/O processing to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables:
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
2.
Create a relationship from the C volumes to the A volumes, using the -force and -cascade parameters. No validation is done at site C to determine that site C is a secondary of site A. Note: For this step to succeed you must ensure that the Remote Mirror and Copy paths between all Global Mirror source and target pairs and between the Master and subordinate storage units have been created. Enter the failoverpprc command at the dscli prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -cascade -force 1200-125f:1A00-1A5f
3. End the Metro Mirror relationship between the A to B volumes at the B volumes intermediate site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -at tgt -unconditional -quiet 1200-125f
590
4. Redirect host I/O processing to the B volumes. Changes are recorded on the B volumes until the A volumes can be resynchronized with the B volumes. Also, Global Mirror continues to operate from site B to site C. Note: You can run in this configuration until the A site has recovered and you want to restore operations there. Begin the next step after the A volumes have been recovered and you're still in production on the B volumes. 5. Copy changes from site C back to site A, using the -force parameter. Host I/O processing continues uninterrupted to the B volumes while the A volumes are made current. (The data is still flowing from B to C, so any changes made to B are being transferred to C and therefore will get from C to A.) This command copies the changes back to the A volumes that were made to the B volumes while hosts were running on the A volumes. (In a DS CLI environment, where the local and remote sites are not using the same management console, you have to use the management console of the remote site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -force SourceVolumeID:TargetVolumeID
Example
dscli> failbackpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -force 1200-125f:1A00-1A5f
6. Wait for the first pass copy to complete from site C to site A. Issue the lspprc command if you want to monitor this activity and determine when the first pass status changes to True. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-183176O -remotedev IBM.2107-75130165X 1200-125f:1A00-1A5f -l
The following represents the first two lines of the report generated by the lspprc command:
SourceLSS IBM.2107130165X /20 Timeout (secs) 300 Critical Mode Disabled First Pass Status True
Reason -
Copy Pending
Global Copy
IBM.2107130165X /20
300
Disabled
True
591
7. Modify Global Copy relationships between the B and C volume pairs. Specify the NOCOPY option and initiate incremental resynchronization without initialization. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -incrementalresync enablenoinit -mode nocp SourceVolumeID:TargetVolumeID
Example
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM2107-183176O -type gcp -incrementalresync enablenoinit -mode nocp 1200-125f:1A00-1A5f
8. Begin the process to return production to site A. First, the Global Mirror session at site B must be stopped. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli>rmgmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID
Example
dscli> rmgmir -dev IBM.2107-75ALA2P -quiet -lss 07 -session 1
9. Verify that the Global Mirror session has ended. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -dev storage_image_ID LSS_ID
Example
dscli> showgmir -dev IBM.2107-75ALA2P 10
In the resulting report, the output indicates in the Copy State field whether the session has stopped. 10. Suspend the B to C volume pairs. This step stops the transfer of data between the B and C volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O 1200-125f:0700-075f
11. Wait until all of the out-of-sync (OOS) tracks have drained from the C and A volume pairs and the OOS count at C is zero. If you want to monitor this process, issue the lspprc command to query the status of the C to A volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
592
Example
dscli> lspprc -dev IBM.2107-183186O -remotedev IBM.2107-75ALA2P 1200-125f:0700-075f -l
12. Suspend the C and A volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X 1200-125f:0700-075f
13. End the Global Copy relationship between the B to C volumes at the C remote volume site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O -at tgt -unconditional -quiet 1A00-1A5f
14. Reverse the direction by making the site A volumes a suspended primary site. Use the failoverpprc command for A to C with cascading allowed and specifying Global Copy mode. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
15. Resynchronize the A to C relationships. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
593
16. Establish Metro Mirror relationships between the A to B volumes using the incremental resynchronization function and the override option. As a result of this step, the relationship verification is bypassed and the incremental resynchronization function stops. The system determines which data to copy, so a full volume copy is bypassed and only changes are copied from the A to B Metro Mirror volume pairs. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -remotedev storage_image_ID -dev storage_image_ID type mmir -mode nocp -incrementalresync override SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -remotedev IBM.2107-75ALA2P -dev IBM.2107-130165X -type mmir -mode nocp -incrementalresync override 2100-2107:2100-2107
17. Start incremental resynchronization with the initialization option on the B volumes in Metro Mirror relationships. Issue the mkpprc command at the intermediate site with the -incrementalresync enable parameter specified. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir -mode nocp -incrementalresync enable SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -dev IBM.2107-130165X -remotedev 2107-75ALA2P -type mmir -mode nocp -incrementalresync enable 2100-2107:2100-2107
18. Wait for the B to A volume pairs to reach the full duplex state. Issue the lspprc command if you want to monitor this activity. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X 1200-125f:1A00-1A5f -l
19. Start the Global Mirror session at the local site. Enter the mkgmir command at the dscli command prompt with the following parameters and variables (from the local site):
dscli>mkgmir -dev storage_image_ID -lss LSS_ID -session session_ID
Example
dscli>mkgmir -remotedev IBM.2107-75ALA2P -lss 07 -session 31
When this step is processed, the Metro/Global Mirror operations are running from site B to site A to site C. You are now ready to transition back to your original configuration, where site A is your production site.
594
20. Quiesce host I/O processing to the B volumes. 21. Suspend the B to A processing. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X 1200-125f:0700-075f
22. Create a relationship from the C volumes to the A volumes using the failoverpprc command with the -force and -cascade parameters specified. Enter the failoverpprc command at the dscli prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P -type gcp -cascade -force 1200-125f:1A00-1A5f
23. End the Global Copy relationships between the B and A volume pairs at the local site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -at tgt -unconditional -quiet 1A00-1A5f
24. Resume host I/O processing to the A volumes. 25. Copy changes from site C back to site A, using the -force parameter. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -force 1A00-1A5f:1200-125f
595
CMUC00196I failoverpprc: Remote Mirror and Copy pair 1A00:1200 successfully failedback. CMUC00196I failoverpprc: Remote Mirror and Copy pair 1A01:1201 successfully failedback.
Note: Global Mirror processing continues to operate with site A volumes to site C volumes. 26. Wait for the first pass copy to complete from site C to site B. Issue the lspprc command if you want to monitor this activity and determine when the first pass status changes to True. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P 1200-125f:1A00-1A5f -l
27. Modify Global Copy relationships between the A and C volume pairs. Specify the NOCOPY option and initiate incremental resynchronization without initialization. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -incrementalresync enablenoinit -mode nocp SourceVolumeID:TargetVolumeID
Example
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM2107-183176O -type gcp -incrementalresync enablenoinit -mode nocp 1200-125f:1A00-1A5f
28. Begin the process to include your B site in the 3-site Metro/Global Mirror configuration with production on site A. The Global Mirror session between the A, C, and D volumes must be stopped. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli>rmgmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID
Example
dscli> rmgmir -dev IBM.2107-130165X -quiet -lss 07 -session 2
29. Suspend the A to C volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O 1200-125f:0700-075f
596
30. End the Global Copy relationships between the A to C volumes at the remote site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -at tgt -unconditional -quiet 1A00-1A5f
31. Wait until all of the out-of-sync (OOS) tracks have drained from the C to B volume pairs and the OOS count is zero. If you want to monitor this process, issue the lspprc command to query the status of the C to B volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183186O 1200-125f:0700-075f -l
32. Suspend the C to B volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P 1200-125f:0700-075f
33. Reverse the direction by making the site B volumes a suspended primary site. Use the failoverpprc command for B to C specifying the Global Copy mode and that cascading is allowed. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
597
Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -remotedev storage_image_ID -dev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -remotedev IBM.2107-183176O -dev IBM.2107-75ALA2P -type gcp -cascade 1A00-1A5f:1200-125f
35. Establish Metro Mirror relationships between the A to B volumes using the incremental resynchronization function and the override option. As a result of this step, the relationship verification is bypassed and the incremental resynchronization function stopped. The system determines which data to copy, so a full volume copy is bypassed and only changes are copied from the A to B Metro Mirror volume pairs. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID type mmir -mode nocp -incrementalresync override SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode nocp -incrementalresync override 2100-2107:2100-2107
36. Start incremental resynchronization with the initialization option on the A volumes in the Metro Mirror relationships. Use the mkpprc command at the local site with the -incrementalresync enable parameter specified. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir -mode nocp -incrementalresync enable SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode nocp -incrementalresync enable 2100-2107:2100-2107
37. Wait for A to B to reach the full duplex state and for the first pass of the Global Copy processing of the B and C volumes to complete. You can monitor this activity by entering the lspprc command to query the status of the B to C volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-75ALA2P -fmt default 1200-125f:0700-075f -l
38. Start Global Mirror at the intermediate site. Now that the original infrastructure has been restored, you can resume the Global Mirror session.
598
Enter the mkgmir command at the dscli command prompt with the following parameters and variables:
dscli> mkgmir -dev IBM.2107-75ALA2P -session 1 -lss 07
39. Verify that consistency groups are forming successfully. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 07
Using forced failover and failback during an unplanned Metro/Global Mirror outage
Use this process to perform failover operations (DS8000 only) from the local (A) site to the intermediate (B) site during an unplanned outage.
599
Procedure
1. At the local site, ensure that data consistency is achieved between the site A and site B volumes. If the local site was not completely destroyed, it is essential that data from any surviving A and B volume pairs be copied and a consistent copy be achieved at the remote site. You can use freeze and unfreeze commands that are supported using external automation software to create data consistency to multiple Metro Mirror volume pairs. To freeze write activity to Metro Mirror primary volumes, perform the following steps: a. Freeze updates to the A volumes in Metro Mirror relationships across the affected LSSs. This ensures that the B volumes will be consistent at the time of the freeze process. (One command per LSS is required.) Enter the freezepprc command at the dscli command prompt with the following parameters and variables: dscli> freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07-12 The following represents an example of the output:
CMUC00161W freezepprc: Remote Mirror and Copy consistency group 07:12 successfully created.
As a result of the freeze action, the following processing occurs: v The established Remote Mirror and Copy paths between the LSS pairs are deleted. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, the storage unit collects data that is sent to the A volumes in Metro Mirror relationships. v I/O to the Metro Mirror volume pairs is temporarily queued. b. Resume operations following a freeze. This operationalso called a thaw operationallows I/O processing to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables:
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
600
2. Create a relationship from the C volumes to the A volumes, using the -force and -cascade parameters. No validation is done at site C to determine that site C is a secondary of site A. Note: For this step to succeed you must ensure that the Remote Mirror and Copy paths between all Global Mirror source and target pairs and between the Master and subordinate storage units have been created. Enter the failoverpprc command at the dscli prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -cascade -force 1200-125f:1A00-1A5f
3. End the Metro Mirror relationship between the A to B volumes at the B volumes intermediate site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X -at tgt -unconditional -quiet 1200-125f
4. Redirect host I/O processing to the B volumes. Changes are recorded on the B volumes until the A volumes can be resynchronized with the B volumes. Also, Global Mirror continues to operate from site B to site C. Note: You can run in this configuration until the A site has recovered and you want to restore operations there. Begin the next step after the A volumes have been recovered and you're still in production on the B volumes. 5. Copy changes from site C back to site A, using the -force parameter. Host I/O processing continues uninterrupted to the B volumes while the A volumes are made current. (The data is still flowing from B to C, so any changes made to B are being transferred to C and therefore will get from C to A.) This command copies the changes back to the A volumes that were made to the B volumes while hosts were running on the A volumes. (In a DS CLI environment, where the local and remote sites are not using the same management console, you have to use the management console of the remote site.) Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -force SourceVolumeID:TargetVolumeID
Example
dscli> failbackpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -force 1200-125f:1A00-1A5f
601
CMUC00197I failbackpprc: Remote Mirror and Copy pair 1200:1A00 successfully failed back. CMUC00197I failbackpprc: Remote Mirror and Copy pair 1201:1A01 successfully failed back. CMUC00197I failbackpprc: Remote Mirror and Copy pair 1202:1A02 successfully failed back.
6. Wait for the first pass copy to complete from site C to site A. Issue the lspprc command if you want to monitor this activity and determine when the first pass status changes to True. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-183176O -remotedev IBM.2107-75130165X 1200-125f:1A00-1A5f -l
The following represents the first two lines of the report generated by the lspprc command:
SourceLSS IBM.2107130165X /20 Timeout (secs) 300 Critical Mode Disabled First Pass Status True
Reason -
Copy Pending
Global Copy
IBM.2107130165X /20
300
Disabled
True
7. Modify Global Copy relationships between the B and C volume pairs. Specify the NOCOPY option and initiate incremental resynchronization without initialization. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -incrementalresync enablenoinit -mode nocp SourceVolumeID:TargetVolumeID
Example
dscli> mkpprc -dev IBM.2107-75ALA2P -remotedev IBM2107-183176O -type gcp -incrementalresync enablenoinit -mode nocp 1200-125f:1A00-1A5f
8. Begin the process to return production to site A. First, the Global Mirror session at site B must be stopped. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli>rmgmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID
Example
602
-lss 07 -session 1
9. Verify that the Global Mirror session has ended. Enter the showgmir command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -dev storage_image_ID LSS_ID
Example
dscli> showgmir -dev IBM.2107-75ALA2P 10
In the resulting report, the output indicates in the Copy State field whether the session has stopped. 10. Suspend the B to C volume pairs. This step stops the transfer of data between the B and C volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O 1200-125f:0700-075f
11. Wait until all of the out-of-sync (OOS) tracks have drained from the C and A volume pairs and the OOS count at C is zero. If you want to monitor this process, issue the lspprc command to query the status of the C to A volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli> lspprc -dev IBM.2107-183186O -remotedev IBM.2107-75ALA2P 1200-125f:0700-075f -l
12. Suspend the C and A volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X 1200-125f:0700-075f
13. End the Global Copy relationship between the B to C volumes at the C remote volume site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Chapter 8. Recovery scenarios using Metro/Global Mirror
603
Example
dscli>rmpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O -at tgt -unconditional -quiet 1A00-1A5f
14. Reverse the direction by making the site A volumes a suspended primary site. Use the failoverpprc command for A to C with cascading allowed and specifying Global Copy mode. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
15. Resynchronize the A to C relationships. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
16. Establish Metro Mirror relationships between the A to B volumes using the incremental resynchronization function and the override option. As a result of this step, the relationship verification is bypassed and the incremental resynchronization function stops. The system determines which data to copy, so a full volume copy is bypassed and only changes are copied from the A to B Metro Mirror volume pairs. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -remotedev storage_image_ID -dev storage_image_ID type mmir -mode nocp -incrementalresync override SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -remotedev IBM.2107-75ALA2P -dev IBM.2107-130165X -type mmir -mode nocp -incrementalresync override 2100-2107:2100-2107
17. Start incremental resynchronization with the initialization option on the B volumes in Metro Mirror relationships. Issue the mkpprc command at the intermediate site with the -incrementalresync enable parameter specified. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
604
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir -mode nocp -incrementalresync enable SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -dev IBM.2107-130165X -remotedev 2107-75ALA2P -type mmir -mode nocp -incrementalresync enable 2100-2107:2100-2107
18. Wait for the B to A volume pairs to reach the full duplex state. Issue the lspprc command if you want to monitor this activity. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X 1200-125f:1A00-1A5f -l
19. Start the Global Mirror session at the local site. Enter the mkgmir command at the dscli command prompt with the following parameters and variables (from the local site):
dscli>mkgmir -dev storage_image_ID -lss LSS_ID -session session_ID
Example
dscli>mkgmir -remotedev IBM.2107-75ALA2P -lss 07 -session 31
When this step is processed, the Metro/Global Mirror operations are running from site B to site A to site C. You are now ready to transition back to your original configuration, where site A is your production site. 20. Quiesce host I/O processing to the B volumes. 21. Suspend the B to A processing. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-130165X 1200-125f:0700-075f
22. Create a relationship from the C volumes to the A volumes using the failoverpprc command with the -force and -cascade parameters specified. Enter the failoverpprc command at the dscli prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P -type gcp -cascade -force 1200-125f:1A00-1A5f
Chapter 8. Recovery scenarios using Metro/Global Mirror
605
23. End the Global Copy relationships between the B and A volume pairs at the local site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -at tgt -unconditional -quiet 1A00-1A5f
24. Resume host I/O processing to the A volumes. 25. Copy changes from site C back to site A, using the -force parameter. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -force SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -type gcp -force 1A00-1A5f:1200-125f
Note: Global Mirror processing continues to operate with site A volumes to site C volumes. 26. Wait for the first pass copy to complete from site C to site B. Issue the lspprc command if you want to monitor this activity and determine when the first pass status changes to True. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
dscli>lspprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P 1200-125f:1A00-1A5f -l
27. Modify Global Copy relationships between the A and C volume pairs. Specify the NOCOPY option and initiate incremental resynchronization without initialization. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -incrementalresync enablenoinit -mode nocp SourceVolumeID:TargetVolumeID
Example
606
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM2107-183176O -type gcp -incrementalresync enablenoinit -mode nocp 1200-125f:1A00-1A5f
28. Begin the process to include your B site in the 3-site Metro/Global Mirror configuration with production on site A. The Global Mirror session between the A, C, and D volumes must be stopped. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli>rmgmir -dev storage_image_ID -lss LSS_ID -session session_ID Master_Control_Path_LSS_ID:Subordinate_Control_Path_LSS_ID
Example
dscli> rmgmir -dev IBM.2107-130165X -quiet -lss 07 -session 2
29. Suspend the A to C volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-130165X -remotedev IBM.2107-183176O 1200-125f:0700-075f
30. End the Global Copy relationships between the A to C volumes at the remote site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli>rmpprc -dev storage_image_ID -remotedev storage_image_ID -at tgt -unconditional -quiet TargetVolumeID
Example
dscli>rmpprc -dev IBM.2107-183176O -remotedev IBM.2107-130165X -at tgt -unconditional -quiet 1A00-1A5f
31. Wait until all of the out-of-sync (OOS) tracks have drained from the C to B volume pairs and the OOS count is zero. If you want to monitor this process, issue the lspprc command to query the status of the C to B volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli>lspprc -dev storage_image_ID -remotedev storage_image_ID -l SourceVolumeID:TargetVolumeID
Example
607
-l
32. Suspend the C to B volume pairs. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev storage_image_ID_-remotedev storage_image_ID SourceVolumeID:TargetVolumeID
Example
dscli> pausepprc -dev IBM.2107-183176O -remotedev IBM.2107-75ALA2P 1200-125f:0700-075f
33. Reverse the direction by making the site B volumes a suspended primary site. Use the failoverpprc command for B to C specifying the Global Copy mode and that cascading is allowed. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli>failoverpprc -dev storage_image_ID -remotedev storage_image_ID -type gcp -cascade SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-183176O -type gcp -cascade 1A00-1A5f:1200-125f
34. Resynchronize the C to B relationships. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli>failbackpprc -remotedev storage_image_ID -dev storage_image_ID -type gcp SourceVolumeID:TargetVolumeID
Example
dscli> failoverpprc -remotedev IBM.2107-183176O -dev IBM.2107-75ALA2P -type gcp -cascade 1A00-1A5f:1200-125f
35. Establish Metro Mirror relationships between the A to B volumes using the incremental resynchronization function and the override option. As a result of this step, the relationship verification is bypassed and the incremental resynchronization function stopped. The system determines which data to copy, so a full volume copy is bypassed and only changes are copied from the A to B Metro Mirror volume pairs. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID type mmir -mode nocp -incrementalresync override SourceVolumeID:TargetVolumeID
Example
608
dscli>mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode nocp -incrementalresync override 2100-2107:2100-2107
36. Start incremental resynchronization with the initialization option on the A volumes in the Metro Mirror relationships. Use the mkpprc command at the local site with the -incrementalresync enable parameter specified. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev storage_image_ID -remotedev storage_image_ID -type mmir -mode nocp -incrementalresync enable SourceVolumeID:TargetVolumeID
Example
dscli>mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode nocp -incrementalresync enable 2100-2107:2100-2107
37. Wait for A to B to reach the full duplex state and for the first pass of the Global Copy processing of the B and C volumes to complete. You can monitor this activity by entering the lspprc command to query the status of the B to C volume pairs in Global Copy relationships. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-75ALA2P -fmt default 1200-125f:0700-075f -l
38. Start Global Mirror at the intermediate site. Now that the original infrastructure has been restored, you can resume the Global Mirror session. Enter the mkgmir command at the dscli command prompt with the following parameters and variables:
dscli> mkgmir -dev IBM.2107-75ALA2P -session 1 -lss 07
39. Verify that consistency groups are forming successfully. Enter the showgmir -metrics command at the dscli command prompt with the following parameters and variables:
dscli> showgmir -metrics 07
609
Procedure
v Discard changes (revert to a previous consistent state). Assume that the sequence numbers of the FlashCopy relationships are different and the copy process has not started for all the volumes. In this case, the FlashCopy data is inconsistent and cannot be used. You must revert changes, which removes all not-committed data from the FlashCopy target and reverts (or is restored) to the last consistency group. Note: You can discard changes to FlashCopy target volumes only if you have modified the FlashCopy relationship using the setflashrevertible command, which changes the Revertible value to Enabled. When you revert a FlashCopy relationship that is in a revertible state, ensure that you specify its associated FlashCopy sequence number. v Commit all FlashCopy relationships in the consistency group to the current level. Assume that the sequence numbers are all equal and there is a mix of revertible and nonrevertible volumes and the copy process to the FlashCopy target volumes has occurred but not completed for some volumes. In this case, the FlashCopy target volumes are usable and the process has to be committed manually. This is done by issuing a commit command to all revertible FlashCopy relationships to commit data to the FlashCopy target volumes and create data consistency between the source and target volumes. The
610
commit process specifies that the last consistency group that has been created by the Global Mirror session is committed to the current state, and reverting to the previous consistency group state is no longer possible. Note: You can commit changes to FlashCopy target volumes only if you have modified the FlashCopy relationship using the setflashrevertible command, which changes the Revertible value to Enabled.
Procedure
1. Enable the incremental resynchronization option for the A to B Metro Mirror volume pairs. If this is the first attempt to establish the volume pairs, specify -mode full as shown in the mkpprc command example. Otherwise, specify -mode nocp. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode full -incrementalresync enable 2100-2107:2100-2107
Chapter 8. Recovery scenarios using Metro/Global Mirror
611
See Creating a Metro Mirror relationship on page 499 for more information. 2. Pause (suspend) all A to B Metro Mirror volume pairs. Some (but not all) volume pairs might have been suspended with the outage of the intermediate site. Note: If the consistency group function is being used, the automation application (such as GPDS) issued the freezepprc command and all devices are suspended. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -unconditional -at src 2100-2107
See Pausing a Metro Mirror relationship on page 502 for more information. Notes: a. With the volume pairs suspended, updates to the A volumes are marked in the change recording and out-of-synchronization bitmaps on the Metro Mirror A volumes at the local site. b. The master storage unit might have been in the process of using FlashCopy to copy the consistency group to the D volumes when the outage occurred and the consistency group formation was not able to complete. If so, you must verify the consistency group formation. See Querying Global Mirror processing on page 520 for more information. 3. Issue a failover command to the C to B volumes at the remote site, specifying the -cascade option: With the loss of the B volumes at the intermediate site, the state of the C volumes is changed from secondary duplex pending (or suspended) to Suspended Host Source when the command processes. Updates are collected in out-of-sync bitmaps. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -type gcp -cascade 2100-2107:2100-2107
See Performing a failover recovery operation on page 509 for more information. 4. After the failover operation, you can view the status of the volumes to determine the state of the volumes: From the remote site, enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -l 2100-2107
612
ID 2100:2100
Reason -
2101:2101
Global Copy
Disabled
Enabled
Date Suspended -
Source LSS 21 21
5. Attempt to clean up any surviving components of Global Mirror at the intermediate site, if needed. a. End the Global Mirror session at the master storage unit. Enter the rmgmir command at the dscli command prompt with the following parameters and variables (from the intermediate site):
dscli> rmgmir -dev IBM.2107-75ALA2P -quiet -lss 20 -session 31
b. End the Global Mirror session at the subordinate storage units. Reissue the command if the Global Mirror session does not stop because of subordinate storage units still associated to the master storage unit. See Ending a Global Mirror session on page 530 for more information. 6. Verify the Global Mirror consistency group formation: If the intermediate site outage occurred in the middle of consistency group formation, you must determine whether the FlashCopy operations must be committed or reverted. Enter the lsflash command at the dscli command prompt with the following parameters and variables.
dscli> lsflash -l 2100-2107
See Viewing information about FlashCopy relationships on page 484 for more information. The following represents an example of the output:
Sequence Num 44357D55 44357D55 Active Copy Disabled Disabled
ID 2100:2300 2101:2301
SrcLSS 21 21
Revertible Disabled
613
Revertible Disabled
7. Establish Global Copy relationships using the A and C volume pairs with the Incremental Resynchronization recover option: Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-1831760 -type gcp -incrementalresync recover 2100-2107:2100-2107
See Creating a Global Copy relationship on page 502 for more information. The following represents an example of the output:
CMUC00153I mkpprc: Remote Mirror and Copy volume pair relationship 2100:2100 successfully created. CMUC00153I mkpprc: Remote Mirror and Copy volume pair relationship 2101:2101 successfully created.
Notes: a. The C volumes were primary suspended volumes that had Global Copy relationships with the B volumes, which were in Metro Mirror relationships with the A volumes. b. The Incremental Resynchronization function that is running on the A volumes is stopped. The tracks of data in the change recording and out-of-synchronization bitmaps are merged and copied from the A volumes to the C volumes. 8. Wait for the first pass of Global Copy processing to complete between the A to C volumes: You can monitor this activity by querying the status of the volumes. From the local site, enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc dev IBM.2107-130165X remotedev IBM.2107-1831760 2101:2101 2100:2101
Reason -
Copy Pending
Global Copy
IBM.21071831760 /20
300
Disabled
True
9. When the first pass of Global Copy processing is completed, start the Global Mirror session on the A volumes.
614
The master storage unit begins forming consistency groups for the specified Global Mirror session. Global Mirror runs from the local site to the remote site until the intermediate site is ready to resume operation. Enter the mkgmir command at the dscli command prompt with the following parameters and variables (from the local site):
mkgmir -dev IBM.2107-130165X -lss 07 -session 31
See Starting Global Mirror processing on page 522 for more information. When the intermediate site has been recovered, the volumes at the intermediate site must be resynchronized with the local volumes. During the outage, data was written to the volumes at the local site. After the intermediate site is recovered, the volumes at the intermediate site must be resynchronized. The former Metro/Global Mirror configuration must be "cleaned up" to reestablish it back to its original configuration. A host connection to the storage unit at the intermediate site is required. 10. Perform the following steps in preparation for a failback operation from the remote site to the intermediate site: a. End the Metro Mirror relationship between the A to B volumes at the intermediate site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.2107-75ALA2P -unconditional -at tgt 2100-2107 -remotedev IBM.2107-130165X
See Deleting a Metro Mirror relationship on page 503 for more information. b. Pause (suspend) the B to C volume pairs if they are not already suspended. You can query the status of the volumes for this determination. From the remote site, enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc dev IBM.2107-130165X remotedev IBM.2107-1831760 2101:2101 2100:2101
The following represents an example of the output: See Pausing a Metro Mirror relationship on page 502 for more information.
SourceLSS Timeout (secs) unknown Critical Mode Disabled First Pass Status True
Reason -
Type
Copy Pending
300
Disabled
True
615
If necessary, clean up the former Global Mirror configuration at the intermediate site using the following two steps: c. End the Global Mirror session from the master storage unit at the intermediate site. Note: If the Global Mirror session was successfully stopped at the time of the outage, this step might not be necessary and it might generate an error message when the command processes. Enter the rmgmir command at the dscli command prompt with the following parameters and variables (from the intermediate site):
dscli> rmgmir -dev IBM.2107-1301261 -quiet -lss 20 -session 31
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. d. If required, stop the Global Mirror session that is running from any of the subordinates. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -quiet -lss 20 -session 31
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 11. From the remote site, perform a failback Global Copy operation between the C to B volumes: When the failbackpprc command processes, data will be copied from the remote site to the intermediate site. Specify the C volumes as the sources and the B volumes as targets with the failback command. Note: Ensure the availability of the paths from the remote site to the intermediate site with the lspprcpath command. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -type gcp -cascade 2100-2107:2100-2107
See Performing a failback recovery operation on page 508 for more information. 12. Wait for the first pass to complete between the C volumes at the remote site and the B volumes at the intermediate site: You can monitor this activity by querying the status of the volumes. Enter the lspprc command at the dscli command prompt with the following parameters and variables: (from the intermediate site)
dscli> lspprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -l -fullid -fmt default 2100-2107
See Querying Global Mirror processing on page 520 for more information. The following represents an example of the output:
616
Reason -
Copy Pending
Global Copy
Disabled
Enabled
Date Suspended -
Invalid
Unknown
Disabled
True
Disabled
Disabled
13. Start the Incremental Resynchronization function without the initialization option on the A volumes: This step allows you to "force" a resynchronization later between primary (A) volumes at the local site and the volumes at the intermediate site to ensure all updates are copied. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type gcp -incrementalresync enablenoinit -mode nocp 2100-2107:2100-2107
See Creating a Metro Mirror relationship on page 499 for more information. You are now ready to restore the original configuration Metro/Global Mirror without interrupting production. 14. Stop the Global Mirror session between the A and C volumes between the local and remote sites. During this transition time, the data on the D volumes in FlashCopy relationships might be consistent but not current until the transition is complete. Enter the rmgmir command at the dscli command prompt with the following parameters and variables:
dscli> rmgmir -dev IBM.2107-130165X -quiet -lss 21 -session 31
See Ending Global Mirror processing (script mode) on page 523 or Ending Global Mirror processing (no script) on page 523 for more information. 15. Allow the resynchronization of the C to B volumes to complete by performing the following steps:
Chapter 8. Recovery scenarios using Metro/Global Mirror
617
a. Pause (suspend) the A to C volume pairs that were established in Global Copy mode. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev IBM.2107-130165X -remotedev IBM.2107-1831760 2100-2107:2100-2107
See Pausing a Metro Mirror relationship on page 502 for more information. b. Wait for data to be copied from the C volumes at the remote site to the B volumes at the intermediate site. Enter the lspprc command at the dscli command prompt with the following parameters and variables:
dscli> lspprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P -l -fmt default 2100-2107
See Querying Global Mirror processing on page 520 for more information. The following represents an example of the output:
Out of Sync Tracks 0 Tgt Read Disabled Src Cascade Enabled
Reason -
Copy Pending
Global Copy
Disabled
Enabled
Date Suspended -
Invalid
Unknown
Disabled
True
Disabled
Disabled
c. End the A and C Global Copy relationship at the remote site. Enter the rmpprc command at the dscli command prompt with the following parameters and variables:
dscli> rmpprc -quiet -dev IBM.2107-1831760 -unconditional -at tgt 2100-2107
618
CMUC00155I rmpprc: Remote relationship successfully CMUC00155I rmpprc: Remote relationship successfully
Mirror and Copy volume pair :2100 withdrawn. Mirror and Copy volume pair :2101 withdrawn.
See Removing the Global Copy pair relationship on page 532 for more information. Notes: 1) The value for the -dev parameter must be the remote site server (site C). 2) The management console must be able to communicate with the remote server for this command to process successfully. When the command processes, the C volumes at the remote site are no longer the secondary volumes in a Global Copy relationship with the A volumes. This process allows for a later failback operation for the B to C volume pairs. The Global Copy relationship between the A to C volumes was stopped at the remote site, which did not affect the status of the A volumes at the local site. The updates on the A volumes continue until the volumes are again fully synchronized. 16. After data on the C volumes has been copied to the B volumes, pause (suspend) the C to B volume pairs. This step is required before a failback operation can be issued between the B to C volumes, which requires the C volumes to be paused. Enter the pausepprc command at the dscli command prompt with the following parameters and variables:
dscli> pausepprc -dev IBM.2107-1831760 -remotedev IBM.2107-75ALA2P 2100-2107:2100-2107
See Pausing a Metro Mirror relationship on page 502 for more information. 17. At the intermediate site, issue a failover Global Copy operation to the B to C volumes, with the -cascade option: The B volumes are primary suspended volumes. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
dscli> failoverpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -cascade 2100-2107:2100-2107
See Performing a failover recovery operation on page 509 for more information. 18. At the intermediate site, perform a failback Global Copy operation for the B to C volumes, with the -cascade option: Enter the failbackpprc command at the dscli command prompt with the following parameters and variables:
dscli> failbackpprc -dev IBM.2107-75ALA2P -remotedev IBM.2107-1831760 -type gcp -cascade 2100-2107:2100-2107
619
CMUC00197I failbackpprc: Remote Mirror and Copy pair 2100:2100 successfully failed back. CMUC00197I failbackpprc: Remote Mirror and Copy pair 2101:2101 successfully failed back.
See Performing a failback recovery operation on page 508 for more information. 19. Establish Metro Mirror relationships between the A to B volumes using the incremental resynchronization function and the override option. As a result, the relationship verification is bypassed and the incremental resynchronization function stopped. The change recording and out-of-synchronization bitmaps that were monitored and tracked on the primary Metro Mirror volumes are merged to determine the data to copy from the A to B Metro Mirror volume pairs. A full volume copy is bypassed and only changes are copied from the A volumes to the B volumes. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir -mode nocp -incrementalresync override 2100-2107:2100-2107
See Creating a Metro Mirror relationship on page 499 for more information. 20. At local site, start the incremental resynchronization with the initialization option on the A volumes in Metro Mirror relationships. The first pass of copying data between the A to B volumes starts (without a full copy). The B to C volumes data copying can also be in the first pass resulting from the failback operation. Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli> mkpprc -dev IBM.2107-130165X -remotedev IBM.2107-1301261 -type mmir -mode nocp -incrementalresync enable 2100-2107:2100-2107
See Creating a Metro Mirror relationship on page 499 for more information. 21. Wait until the first pass of the A to B volume pairs to reach full duplex: You can monitor this activity by querying the status of the A to B volumes. As soon as the number of out-of-sync tracks reaches zero, all data has been copied and the data on the A to B volumes is equal. Global Mirror processing starts to form consistency groups when the status of the A to B volumes is full duplex. See Viewing information about Metro Mirror relationships on page 510 for more information. 22. Start the Global Mirror session at the intermediate site: Enter the mkgmir command at the dscli command prompt with the following parameters and variables (from the local site):
mkgmir -dev IBM.2107-75ALA2P -lss 07 -session 31
See Starting Global Mirror processing on page 522 for more information.
Results
Your original configuration is restored.
620
Procedure
1. Find the fixed block volumes that are to be assigned to a volume group using the following command. dscli> lsfbvol -dev ID -datatype 512 | 520p | 520u -extpool ID The command creates a list of all volumes of the specified volume type within the specified extent pool. It includes only the volumes that are contained by the specified storage image. 2. Retrieve the current volume group volume map using the following command. dscli> showvolgrp -dev ID volume_group_ID The command creates a list of volumes that are assigned to the target volume group. 3. Modify the volume group using the following command. dscli> chvolgrp -dev ID -action add | remove | replace -volume ID,ID,...,ID volume_group_ID To add or remove volumes, you can add or remove volume IDs to the list. This command applies the updated volume ID list.
621
622
Procedure
1. Remove host access to the volumes that are to be removed. This task requires the issuance of the lshostconnect command and the rmhostconnect command. a. Issue the lshostconnect command to display a list of SCSI host port IDs that are associated with the storage to be removed. Enter the lshostconnect command at the dscli command prompt as follows:
dscli>lshostconnect -dev IBM.210775FA120 -l -portgrp 1
Notes: 1) The -portgrp port_grp_number parameter is used to only list those port IDs that are associated with a port group number that you assigned when you originally created the host connection. 2) The -l parameter is used to generate the detailed status report for each host connection. b. Issue the rmhostconnect command to delete the SCSI host port IDs that are associated with the storage volumes to be removed. Enter the rmhostconnect at the dscli command prompt as follows:
dscli>rmhostconnect -dev IBM.210775FA120 1
Notes: 1) The host_connect_ID parameter (1 in the command example) is required and is a unique identifier (0 - 65 534) within the scope of a storage image. 2) A message is displayed with a request that you confirm the deletion of the host connection. 2. Find the volume groups and volume group storage maps by issuing the lsvolgrp and showvolgrp commands. a. Issue the lsvolgrp command to display a list of defined volume group IDs and their characteristics. Enter the lsvolgrp command at the dscli command prompt as follows:
dscli>lsvolgrp -dev IBM.210775FA120 -l
b. Issue the showvolgrp command to display the detailed properties of the volume group that you want to delete. Enter the showvolgrp command at the dscli command prompt as follows:
dscli>showvolgrp -dev IBM.210775FA120 -lunmap V1001
Repeat the showvolgrp command for each volume group you want to delete. Note: The Volume_Group_ID (V1001) parameter is required. The shortened form is allowed when you designate the -dev parameter. c. Copy the list of volumes within the volume group for later use when you analyze which volumes that you want to remove. 3. Remove the volume groups, as a means to remove volume access by host systems, by issuing the rmvolgrp command. Enter the rmvolgrp command at the dscli command prompt as follows:
dscli>rmvolgrp -dev IBM.210775FA120 V123-V125
Notes: a. All volume groups that are specified for deletion must belong to the same storage unit. b. The Volume_Group_ID parameter (V123-V125 in the example) is required. If you designate the -dev parameter, the shortened version of the ID is allowed. c. The example command shows a range of volume group IDs. If you have another volume group or another volume group range, you must add a blank between the designations (for example, V123-V125 V130-V133 V135). d. A message is displayed for each deleted volume group ID or range of volume group IDs. The message requests that you confirm the deletion.
623
4. Remove the fixed block volumes by issuing the rmfbvol command. This action enables the removal of the associated ranks, arrays, and extent pools. Enter the rmfbvol command at the dscli command prompt as follows:
dscli>rmfbvol -dev IBM.2107-75FA120 0100 0101
Notes: a. The associated logical subsystem (LSS) is automatically removed when the last volume that is contained by the LSS is removed. b. The Volume_ID parameter (represented by 0100 0101 in the example) is required when you issue the rmfbvol command. If you designate the -dev parameter, the shortened version of the ID is allowed. c. A message is displayed for each volume that is deleted. The message requests that you confirm the deletion. 5. Remove the ranks by issuing the lsrank and rmrank commands. a. Issue the lsrank command to display a list of rank IDs to be removed. Use the command parameters to develop a selective list of rank IDs. Enter the lsrank command at the dscli prompt as follows:
dscli>lsrank -dev IBM.2107-75FA120 -l
Note: Rank IDs that indicate extents used = 0 are eligible to be removed. If extents used are greater than 0 then rank segments are currently assigned to existing volume IDs. b. Issue the rmrank command to remove the ranks that are assigned to the arrays. Enter the rmrank command at the dscli prompt as follows:
dscli>rmrank -dev IBM.2107-75FA120 R23
Notes: 1) The rank_ID parameter (R23 in the example) is required. If you designate the -dev parameter, the shortened version of the ID is allowed. 2) You must remove the ranks before you can remove the arrays and extent pools. 3) The processing time that is associated with the rmrank command can be lengthy and might inhibit your use of the array on which this command is being processed. 4) When the rmrank command is issued, the following processing occurs: v The rank is unassigned from the array. v The rank is removed. When this process is successful, a message is displayed. This part of the process does not take long; however, the processing that is associated with this command is not complete even though you have received a message that the rank was removed. v The array is formatted. This processing can take some time. During this processing, the array cannot be removed or assigned to another rank. Also, until this process is fully completed, the rank is listed as assigned to the array from which it is has been removed. v You can check the progress of the rmrank command by logging on to another session of DS CLI. Issue the lsarray command against the storage image where the rank or ranks are being deleted. When you no longer see the rank that is assigned to the array from which you removed it, the remove rank process is complete. 6. Remove the arrays by issuing the lsarray and rmarray commands. a. Issue the lsarray command to obtain a list of array IDs to be removed. Enter the lsarray command at the dscli prompt as follows:
dscli>lsarray -dev IBM.2107-75FA120 -state unassigned
Notes:
624
1) The -state unassigned parameter allows you to narrow your list to just the array IDs that are not assigned to a rank ID. 2) If you issue the lsarray command without using the -state parameter, a list of arrays that have a state of unavailable can appear. This state is a good indication that the ranks have not been removed and that the drives are still formatting. You must wait until the ranks have been removed and the drives have been formatted before you can proceed. 3) Proceed to the next step (remove arrays) only after all the associated arrays are displayed with a state of unassigned. b. Issue the rmarray command to delete the unassigned arrays so that the array sites can be redefined as new arrays. Enter the rmarray command at the dscli command prompt as follows:
dscli>rmarray -dev IBM.2107-75FA120 A44-A48 A51
Notes: 1) The example command displays the use of a range of array IDs plus one additional array ID.(A44-A48 A51). A range of arrays requires the use of a hyphen and a space between the next array or another range of arrays. 2) A message is displayed for each array being deleted that requests your confirmation before processing. 7. Remove the extent pools by issuing the lsextpool and rmextpool commands. a. Issue the lsextpool command to obtain a list of extent pool IDs to be removed. Enter the lsextpool command at the dscli command prompt as follows:
dscli>lsextpool -dev IBM.2107-75FA120 -l -stgtype fb
Note: v The -stgtype fb parameter allows you to narrow the list so that it displays only those extent pools that are assigned for use with fixed block volumes. v Extent pool IDs that indicate assigned ranks = 0 are eligible to be removed. If the assigned ranks are greater than 0, the extent pool potentially contains assigned storage volumes. The rank indicator must be 0 before you can remove the extent pool. b. Issue the rmextpool command to delete extent pool IDs that do not contain assigned rank IDs. Enter the rmextpool command at the dscli command prompt as follows:
dscli>rmextpool -dev IBM.2107-75FA120 P21-P25 P30
Notes: 1) All rank assignments must be deleted before the extent pool can be deleted. 2) The example command displays the use of a range of extent pool IDs plus one additional extent pool ID (P21-P25 P30). A range of extent pool IDs requires the use of a hyphen and a space between the next extent pool ID or next range of extent pool IDs.
625
Procedure
1. Remove the CKD volumes by issuing the lsckdvol and rmckdvol commands. a. Issue the lsckdvol command to display a list of CKD volume IDs. Analyze the list to determine which IDs can be removed. Enter the lsckdvol command at the dscli command prompt as follows:
dscli>lsckdvol -dev IBM.210775FA120 -lcu 00 -l
Notes: 1) You can narrow the list of volume IDs for the designated storage image by using the supported parameters of the lsckdvol command. 2) The example displays the use of the -lcu parameter with a value of 00. Logical control unit (LCU) values are in the range 00 - FE for the DS8000 and in the range 00 - 1E for the DS6000. You must specify a specific LCU; otherwise, the entire storage unit is queried, which results in a longer processing time. b. Issue the rmckdvol command to delete volumes. This action enables the removal of the associated ranks, arrays, and extent pools. Enter the rmckdvol command at the dscli command prompt as follows:
dscli>rmckdvol -dev IBM.2107-75FA120 0100 0101
Note: v The Volume_ID parameter (represented by the values 0100 0101 in the command example) is required when you issue the rmckdvol command. v A message is displayed for each volume that is being deleted. The message requests that you confirm the deletion. 2. Issue the rmlcu command to delete LCUs so that the address groups can be redefined for use with fixed block or CKD volumes. Enter the rmlcu command at the dscli command prompt as follows:
dscli>rmlcu -dev IBM.2107-75FA120 00-03 08
Note: The example command displays the use of a range of LCU IDs plus one additional LCU ID (00-03 08). A range of LCU IDs requires the use of a hyphen. If you add an additional LCU ID or a range of LCU IDs, you must allow a space between the next LCU ID or another range of LCU IDs. 3. Remove the ranks by issuing the lsrank and rmrank commands. a. Issue the lsrank command to display a list of rank IDs to be removed. Use the lsrank command parameters to develop a selective list of rank IDs. Enter the lsrank command at the dscli command prompt as follows:
dscli>lsrank -dev IBM.2107-75FA120 -l
626
Note: Rank IDs that indicate extents used = 0 are eligible to be removed. If the displayed value for extents used is greater than 0, it indicates that the ranks are currently assigned to existing volume IDs. b. Issue the rmrank command to remove the ranks that are assigned to the arrays. Enter the rmrank command at the dscli prompt as follows:
dscli>rmrank -dev IBM.2107-75FA120 R23
Notes: 1) You must remove the ranks before you can remove the arrays and extent pools. 2) The processing time that is associated with the rmrank command can be lengthy and might inhibit your use of the array on which this command is being processed. 3) When the rmrank command is issued, the following processing occurs: v The rank is unassigned from the array. v The rank is removed. When this is successful, a message is displayed. This part of the process does not take long; however, the processing that is associated with this command is not complete even though you have received a message that the rank was removed. v The array is formatted. This processing can take some time. During this processing the array cannot be removed or assigned to another rank. Also, until this process is fully completed, the rank is listed as assigned to the array from which it is has been removed. v You can check the progress of the rmrank command by logging onto another session of DS CLI. Issue the lsarray command against the storage image where the rank or ranks are being deleted. When you no longer see the rank that is assigned to the array from which you removed it, the remove rank process is complete. 4. Remove the arrays by issuing the lsarray and rmarray commands. a. Issue the lsarray command to obtain a list of array IDs to be removed. Enter the lsarray command at the dscli prompt as follows:
dscli>lsarray -dev IBM.2107-75FA120 -state unassigned
Notes: 1) The -state unassigned parameter allows you to narrow your list to just the array IDs that are not assigned to a rank ID. 2) If you issue the lsarray command without using the -state parameter, it is possible you will see a list of arrays that have a state of unavailable. This is a good indication that the ranks have not been removed and that the drives are still formatting. You must wait until the ranks have been removed and the drives have been formatted before you can proceed. Proceed to the next step (remove arrays) only after all the associated arrays are displayed with a state of unassigned. b. Issue the rmarray command to delete the unassigned arrays so that the array sites can be redefined as new arrays. Enter the rmarray command at the dscli command prompt as follows:
dscli>rmarray -dev IBM.2107-75FA120 A44-A48 A51
Notes: 1) The example command displays the use of a range of array IDs plus one additional array ID (A44-A48 A51). A range of arrays requires the use of a hyphen and a space between the next array or another range of arrays. 2) A message is displayed for each array being deleted that requests your confirmation before processing. 5. Remove the extent pools by issuing the lsextpool and rmextpool commands.
Chapter 9. Command-line interface scenarios
627
a. Issue the lsextpool command to obtain a list of extent pool IDs to be removed. Enter the lsextpool command at the dscli command prompt as follows:
dscli>lsextpool -dev IBM.2107-75FA120 -stgtype fb -l
Notes: 1) Use the -stgtype fb parameter to narrow the list so that it displays only those extent pools that are assigned for use with fixed block volumes. 2) Extent pool IDs that indicate assigned ranks = 0 are eligible to be removed. If the value for assigned ranks is greater than 0, the extent pool potentially contains assigned storage volumes. The rank indicator must be 0 before you can remove the extent pool. b. Issue the rmextpool command to delete extent pool IDs that do not contain assigned rank IDs. Enter the rmextpool command at the dscli command prompt as follows:
dscli>rmextpool -dev IBM.2107-75FA120 P21-P25 P30
Notes: 1) All rank assignments must be deleted before the extent pool can be deleted. 2) The example command displays the use of a range of extent pool IDs plus one additional extent pool ID (P21-P25 P30). A range of extent pool IDs requires the use of a hyphen. When you add an additional extent pool ID or another range of extent pool IDs, you must put a space between the current extent pool ID value and the next extent pool ID value.
Procedure
1. You must determine which volumes are available for use and then establish a remote mirror and copy path between LSS 22 and LSS 2A. a. Issue the lsavailpprcport command to obtain a report that lists which volumes are available for use. Enter the lsavailpprcport command at the dscli command prompt with the following parameters and variables:
dscli> lsavailpprcport -dev IBM.2107-1300861 -remotedev IBM.2107-1300871 -remotewwnn 5005076303FFC03D 22:2A
628
b. Issue the mkpprcpath command to establish the remote mirror and copy path between LSS 22 and LSS 2A. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli>mkpprcpath -dev IBM.2107-1300861 -remotedev IBM.2107-1300871 -remotewwnn 5005076303FFC03D -srclss 22 -tgtlss 2A I0030:I0031 I0100:I0101
2. Issue the mkpprc command to establish a remote mirror and copy pair (2200 to 2A00). Enter the mkpprc command at the dscli command prompt with the following parameters and variables:
dscli>mkpprc -dev IBM.2107-1300861 -remotedev IBM.2107-1300871 -type mmir 2200:2A00
3. Issue the mkremoteflash command to use LSS 22 on the local site as a conduit LSS for new remote Flash Copy relationships on the remote storage unit. These new relationships use volume 2A00 as their source. The target can be any other volume on the remote storage unit (in this scenario, 2A01). Enter the mkremoteflash command at the dscli command prompt with the following parameters and variables:
dscli>mkremoteflash -dev IBM.2107-1300871 -conduit IBM.2107-1300861/22 -record 2A00:2A01
4. Issue the resyncremoteflash command because the remote FlashCopy relationship (2A00:2A01) was created with the -record parameter. Enter the resyncremoteflash command at the dscli command prompt with the following parameters and variables:
dscli>resyncremoteflash -dev IBM.2107-1300871 -conduit IBM.2107-1300861/22 -record 2A00:2A01
5. Issue the lsremoteflash command to verify that the transaction has processed as you intended. Enter the lsremoteflash command at the dscli command prompt with the following parameters and variables:
dscli>lsremoteflash -dev IBM.2107-1300871 -conduit IBM.2107-1300861/22 2A00:2A01
629
Persistent Enabled
Revertible Disabled
Metro Mirror test scenario: failback operation from local to remote site
This scenario describes the steps required to test the failover and failback procedures in which a failback is done from the local site to the remote site.
Procedure
1. Freeze updates to the primary (A) volumes in Metro Mirror relationships across the affected LSSs. This process ensures that the secondary (B) volumes will be consistent at the time of the freeze. (One command per LSS is required.) Enter the freezepprc command at the dscli command prompt with the following parameters and variables:
freezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
As a result of the freeze action, the following processing occurs: v I/O processing to the Metro Mirror volume pairs is temporarily queued during the time that updates are frozen. v The volume pairs that are associated with the source and target LSSs are suspended. During this time, updates are collected using the change recording feature on the Site A volumes. v The established paths between the LSS pairs are disabled. 2. Resume operations following a freeze. Issue the unfreezepprc command to allow I/O activity to resume for the specified volume pairs. Enter the unfreezepprc command at the dscli command prompt with the following parameters and variables: Note: This action is sometimes referred to as a thaw operation.
dscli> unfreezepprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P 07:12
3. At Site B (remote site), issue a failover command to the B to A volume pairs. Enter the failoverpprc command at the dscli command prompt with the following parameters and variables:
630
When this command processes, the following occurs: v The B volumes become suspended primary volumes. Updates are collected using the change recording feature on the volumes. v The A volumes are suspended primary volumes. 4. Allow test I/O to start at Site B. 5. When testing is complete, perform the following steps: a. Quiesce test I/O at Site B (remote site). b. Enable the remote mirror and copy links between the storage units across the two sites. (The paths will not reestablish automatically.) c. Reestablish paths between the local and remote site LSSs that contain the Metro Mirror volume pairs. Enter the mkpprcpath command at the dscli command prompt with the following parameters and variables:
dscli> mkpprcpath -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -remotewwnn 5005076303FFC550 -srclss 07 -tgtlss 12 -consistgrp I0102:I0031 I0002:I0102
6. At the local site, issue a failback command to the A to B volume pairs. Enter the failbackpprc command at the dscli command prompt with the following parameters and variables
dscli> failbackpprc -dev IBM.2107-130165X -remotedev IBM.2107-75ALA2P -type mmir 1a00-1a5f:1200-125f
When this command processes, the following occurs: v Updates that are made to the volumes at Site B are recorded with the change recording feature. Changed tracks of data are copied from the Site A volumes to Site B volumes. v When the copy process is complete, the Site A volumes will be synchronized with the Site B volumes. 7. Production I/O continues to the A volumes.
631
establish paths between the source and target LSSs. Each LSS with source volumes requires at least one path to be established to the LSS that holds the target volumes. Note: You can issue the commands that are described below either for a DS8000 model or for a DS6000 model, but for the DS6000 model the storage image ID is different. The following mkpprcpath command establishes remote mirror and copy paths:
dscli>mkpprcpath -dev storage_image_ID -remotedev storage_image_ID -remotewwnn wwnn -srclss source_LSS_ID -tgtlss target_LSS_ID source_port_ID:target_port_ID
Example
dscli>mkpprcpath -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 -srclss 01 -tgtlss 00 remotewwnn 12341234000A000F I1A10:I2A20
Example
dscli>mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100 -type gcp 0101:0101 0102:0102 0103:0103
Example
dscli>mkpprc -dev IBM.2107-75FA120 -remotedev IBM.2107-75FA150 0100:0100 -type mmir 0101:0101 0102:0102 0103:0103
Resource Groups
Restrictions for using resource groups for Copy Services scope limiting
A resource group is a policy object containing policy attributes that apply to the resources that are associated with the resource group. The object classes that are associated with a resource group are count
632
key data (CKD) logical volumes, fixed block logical volumes, CKD LCUs and fixed block LSSs. Each object in these object classes has a resource group attribute that specifies the single resource group that the object is assigned to. Each resource group has a resource group label (RGL) that provides a unique name for the resource group. Certain policy attributes in the resource group specify a resource scope (RS), and each user session has an assigned user resource scope (URS). A RS or URS is a pattern that can be matched to the RGLs in all of the resource groups. A resource group (RS) can select a set of RGs whose associated resources are within the scope of the RS. The URS allows access only to the resources that the user ID has permission to issue Copy Services requests to. To issue a Copy Services request to establish a volume pairing, an LSS-pairing, or LCU-pairing, the user must be authorized to access the source volume, source LSS, or source LCU, respectively. To issue a Copy Services request that operates on an LSS or LCU or has a session parameter, the user must be authorized to access the LSS or LCU. A URS can be set to either a wild card ( * ), or a text string with no wild card. When there is a policy attribute that specifies a RS, the RS allows access only to the resources that the resources within this resource group are allowed to relate to according to the specified policy. The attributes of a policy might involve resources that are on other devices (storage images) when Copy Services relationships are involved with the policy. A RS can be set to either a wild card ( * ), a text string with no wild card, or the null string. A URS or RS set to wild card ( * ) matches any RGL. A URS or RS set to a string value matches an RGL that has the same string value. A RS set to null does not match any RGL. Additionally, a URS or an RS other than a source resource scope (SRS, which is the scope of a primary/source logical volumes that a secondary/target logical volume may have) that is set to a string value also matches the RGL PUBLIC. Notes: 1. When resource groups are used to partition the resources of the storage facility between tenants of a multi-tenancy environment, this usually means that all of the resources assigned to a given tenant are associated with a single resource group that is configured for the tenant's resources. Such a resource group for tenant Tenant1 might typically have an RGL=Tenant1, CSGRS=Tenant1, PGRS=Tenant1, GMMastersAllowed=Tenant1_Sessions, and GMSessionsAllowed=Tenant1_Sessions where Tenant1_Sessions would specify one or more Global Mirror session numbers that are to be used exclusively by the tenant. When a tenant is enabled to use Copy Services, any LCUs or LSSs associated with the tenant's logical volumes must also be assigned to the tenant's resource group along with the tenant's logical volumes to have the policies of the resource group have the desired effect. 2. Resource Group 0 is predefined and cannot be created, deleted, or modified. Resource group 0 is the default resource group used when resources are created. The policies in resource group 0 are defined to emulate the behavior of a storage subsystem that does not have support for resource groups. Some restrictions exist when using resource groups and user resource scopes to manage volumes. One restriction is accomplished by having the system administrator set the RG label (RGL) of the volumes/LSSs whose copy services are to be managed, to that of the URS assigned to the users who are managing them. The system administrator can still manage these volumes, if needed. Another restriction involves setting the remaining RG settings, particularly the CS global scope that affects all copy services functions between volumes associated with the RG. These limitations are active no matter who sends the command. There are also existing restrictions for how hosts can access copy services on a unit, including HCDS for CKD hosts. For example, the only RG setting that modifies how CKD hosts can interact with a unit is
Chapter 9. Command-line interface scenarios
633
using copy services pass-through limiting. A CKD volume can be designated as a pass-through volume for data being moved to a fixed block (FB) volume using copy services. Notes: 1. Only exclusive multi-managed groups are supported. For example, there are no sub-managed groups allowed within each managed group. 2. Only copy services is restricted between managed groups. Logical configuration can cross between managed group boundaries. For this reason, managed group user IDs should be assigned only copy services or monitor operator authorization. Caution is recommended, since the managed group user can still copy a company volume to another company's volume on the same unit accidentally. 3. The system administrator sets, for a specific managed group, each users URS, the RGL, the CS global scope, and the CS pass-through scope to the same value. These actions ensure the RG completely protects the volumes being managed. For example, your human resources department might need to keep things separate for security or HIPPAA compliance requirements.
Situation
You are the network administrator for a company and are in charge of all of its machines. Within your company, there are several subgroups that need their own space on your machines. Group_1 is running a seating assignment database for World Cup hosting sites. They need a lot of space for a short amount of time. They use the DS CLI to manage when the FlashCopy relationships are formed. They request the following hardware: v Machine 1 (located on site) Volumes 0000-000f will be used as development volumes on which hosts perform I/O operations. Volumes 0010-001f will be used for nightly FlashCopys of the development volumes from a DS CLI running on a host machine that Group_1 controls. Group_1 can control the backup if they choose to do so. v Machine 2 (located on site) Volumes 0000-000f are synchronous PPRC (Metro Mirror) targets of Machine 1's volumes of the same ID. Volumes 0010-001f are in band FlashCopy target volumes that match the source machine. Group_2 uses the following machines to store client files for a security firm. Due to security audit requirements, data must be held in separate cities in the event of a disaster. They use Tivoli Storage Productivity Center for Replication (TPC-R) to manage these relationships. They request the following hardware: v Machine 1 (located on site) Volumes 0200-02ff are all serving a giant database which is backed up to a remote site. v Machine 3 (located 500 miles away) Volumes 0000-00ff are Global Mirror targets of the volumes above. Group_3 needs a large temporary testing environment to convert a bunch of advertising images from several disparate formats to a common one. They do not need Copy Services overhead, as they want to complete the task as quickly as possible. They request the following hardware: v Machine 1 (located on site)
634
Volumes 0300-0301 are two large volumes, one of which holds the unprocessed advertising images, the other of which holds the formatted version of the images. Group_4 asks you to assist in hosting their customer management databases with data mining using System z. A FlashCopy will be done on the data that is analyzed at that point in time. When the analysis is complete and stored, the FlashCopy will be reestablished and the analysis will be redone. This will occur over and over again, so the System z will control the FlashCopy with in-band commands. You set up the following volumes to handle this: v Machine 1 (located on site) Volumes 0400-040f are the base volumes used for the database. Volumes 0410-041f are the FlashCopy targets to be used for data mining.
3. No user ID will be created for Group 3 or Group 4 since they are not doing Copy Services thorough TPC-R, the DS Storage Manager, or the DS CLI.
Configuration details
Next you will create the following resource groups: 1. You set the label to g1 to ensure that only users/hosts with scope g1 or "*" can issue Copy Services commands to these volumes (all Copy Services commands issued to these volumes will fail if they are not from one of these scopes). 2. You set copyglobalscope to g1 to ensure that the FlashCopy works from/to targets/sources that have a label of g1. If this is not set up, it wouldn't as both source and target FlashCopy volumes would not have a matching copyglobalscope/label pairing. 3. You create RG1 to ensure that the Metro Mirror works between Machine 1 and Machine 2 by setting the target PPRC volumes to RG1 as well. If this is not setup, the source and target PPRC volumes would not have a matching copyglobalscope/label pairing. 4. You set the passglobalscope to g1. Notes: a. Although it does not affect this particular scenario, it is recommended that you set the passglobalscope equal to the copyglobalscope in all cases. b. g1 was used for copyglobalscope and passglobalscope instead of '*'. '*' would have allowed the relationships to be formed, but it wouldn't have prevented these volumes from affecting volumes or being affected by volumes in other resource groups. 5. You issue the following commands:
mkresgrp -label "g1" RG1 manageresgrp -ctrl copyglobal -action set -scope "g1" RG1 manageresgrp -ctrl passglobal -action set -scope "g1" RG1 chfbvol -resgrp RG1 0000-000f 0010-001f
635
7. To prevent any Copy Services commands from being issued to any volumes that are assigned to this scope, you issue the following commands on Machine 1:
mkresgrp -label "g3" RG3 manageresgrp -ctrl copyglobal -action set -scope "" RG3 manageresgrp -ctrl passglobal -action set -scope "" RG3 chfbvol -resgrp RG3 0300-0301
8. Same as RG1, but needs to be issued on only Machine 1. 9. You need to setup HCDS on their System z servers to ensure that only the volumes in RG3 are visible to that host.
mkresgrp -label "g4" RG4 manageresgrp -ctrl copyglobal -action set -scope "g4" RG3 manageresgrp -ctrl passglobal -action set -scope "g4" RG3 chfbvol -resgrp RG3 0300-0301
10. The remaining volumes are not public to these groups, so you set them to RG10 to prevent the groups from issuing Copy Services commands to them. Specifying these volumes as PUBLIC will prevent any named volume from performing Copy Services operations to them, even by administrators. 11. You issue the following commands on Machine 1, Machine 2, and Machine 3.
mkresgrp -label "not_public" RG10 manageresgrp -ctrl copyglobal -action set -scope "not_public" RG10 manageresgrp -ctrl passglobal -action set -scope "not_public" RG10 chfbvol -resgrp RG4 < all the rest of the volumes on the box >
636
Appendix A. Accessibility
IBM strives to provide products with usable access for everyone, regardless of age or ability. This product uses standard Windows navigation keys. For more information, see Accessibility features for IBM System Storage DS8000.
637
638
lsnetworkport
shownetworkport
setoutput
639
640
Notices
The information provided by this media supports the products and services described with consideration for the conditions described herein. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and
641
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others.
642
equipment in a residential area is likely to cause harmful interference, in which case the user will be required to correct the interference at his own expense. Properly shielded and grounded cables and connectors must be used in order to meet FCC emission limits. IBM is not responsible for any radio or television interference caused by using other than recommended cables and connectors, or by unauthorized changes or modifications to this equipment. Unauthorized changes or modifications could void the user's authority to operate the equipment. This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device might not cause harmful interference, and (2) this device must accept any interference received, including interference that might cause undesired operation.
643
EN 55022 Klasse A Gerte mssen mit folgendem Warnhinweis versehen werden: "Warnung: Dieses ist eine Einrichtung der Klasse A. Diese Einrichtung kann im Wohnbereich Funk-Strungen verursachen; in diesem Fall kann vom Betreiber verlangt werden, angemessene Mabnahmen zu ergreifen und dafr aufzukommen." Deutschland: Einhaltung des Gesetzes ber die elektromagnetische Vertrglichkeit von Gerten Dieses Produkt entspricht dem "Gesetz ber die elektromagnetische Vertrglichkeit von Gerten (EMVG)." Dies ist die Umsetzung der EU-Richtlinie 2004/108/EG in der Bundesrepublik Deutschland. Zulassungsbescheinigung laut dem Deutschen Gesetz ber die elektromagnetische Vertrglichkeit von Gerten (EMVG) (bzw. der EMC EG Richtlinie 2004/108/EG) fr Gerte der Klasse A Dieses Gert ist berechtigt, in bereinstimmung mit dem Deutschen EMVG das EG-Konformittszeichen CE - zu fhren. Verantwortlich fr die Einhaltung der EMV Vorschriften ist der Hersteller:
International Business Machines Corp. New Orchard Road Armonk,New York 10504 Tel: 914-499-1900
Der verantwortliche Ansprechpartner des Herstellers in der EU ist: IBM Deutschland GmbH Technical Regulations, Abteilung M372 IBM-Allee 1, 71139 Ehningen, Germany Tele: +49 7032 15 2941 e-mail: [email protected] Generelle Informationen: Das Gert erfllt die Schutzanforderungen nach EN 55024 und EN 55022 Klasse A.
Translation: This is a Class A product based on the standard of the VCCI Council. If this equipment is used in a domestic environment, radio interference may occur, in which case, the user may be required to take corrective actions.
644
Japanese Electronics and Information Technology Industries Association (JEITA) Confirmed Harmonics Guideline (products less than or equal to 20 A per phase)
Japanese Electronics and Information Technology Industries Association (JEITA) Confirmed Harmonics Guideline with Modifications (products greater than 20 A per phase)
rusemi
f2c01252
Notices
645
IBM Taiwan Product Service Contact Information: IBM Taiwan Corporation 3F, No 7, Song Ren Rd., Taipei Taiwan Tel: 0800-016-888
646
f2c00790
Index Numerics
2105 to DS8000 DS CLI upgrade 16 CKD configuration error 463 CKD configuration error, correcting 464 ckd volume creating arrays 459 CKD volume rank 460 ckd volumes, creating 463 CLI displaying WWNN 495 pause 502 postinstallation 24 resuming Metro Mirror relationship 501 CLI commands on a command line 37 CLI commands, overview 47 CLI default configuration profile file 24 CLI help 41 CLI history function 40 CLI interactive mode 40 command line presentation 37 commands applykey 94 chaccess 92 chauthpol 61 chckdvol 226 chextpool 202 chfbvol 259 chhostconnect 156 chkeymgr 97 chlcu 216 chlss 254 chpass 62 chrank 190 chresgrp 324 chsession 430 chsestg 301 chsi 134 chsp 123 chsu 128 chuser 63 chvolgrp 289 commitflash 333 commitremoteflash 355 cpauthpol 65 diagsi 136 dscli 51 echo 52 failbackpprc 386 failoverpprc 389 flagless parameters 47 freezepprc 404 helpmsg 54 initckdvol 228 initfbvol 262 lsaccess 93 lsaddressgrp 215 lsarray 182 lsarraysite 177 lsauthpol 66 lsavailpprcport 373 lsckdvol 229 commands (continued) lsda 110 lsddm 118 lsextpool 203 lsfbvol 263 lsflash 337 lsframe 112 lsgmir 426 lshba 117 lshostconnect 160 lshosttype 175 lshostvol 165 lsioport 144 lskey 95 lskeygrp 97 lskeymgr 100 lslcu 218 lslss 255 lsperfgrp 318 lsperfgrprpt 319 lsperfrescrpt 322 lsportprof 167 lspprc 392 lspprcpath 376 lsrank 191 lsremoteflash 360 lsresgrp 324 lsserver 136 lssession 433 lssestg 303 lssi 138 lsstgencl 114 lssu 129 lsuser 67 lsvolgrp 291 lsvolinit 299 lsvpn 125 manageckdvol 236 managefbvol 270 managehostconnect 168 managekeygrp 101 managepwfile 68 managereckey 102 manageresgrp 326 mkaliasvol 237 mkarray 185 mkauthpol 70 mkckdvol 239 mkesconpprcpath 380 mkextpool 206 mkfbvol 272 mkflash 342 mkgmir 414 mkhostconnect 169 mkkeygrp 104 mkkeymgr 104 mklcu 220 mkpprc 399 mkpprcpath 382 mkrank 195 mkreckey 105
A
accessibility 637 account setup 30 add volumes to session, CLI 516 adding ranks to extent pool, DS CLI 474 address group 447 AIX CLI installation considerations 4 LIBPATH handling 4 AIX LIBPATH 15 alias volumes 239 applykey 94 arrays status 471 arrays, creating (ckd) 459 arrays, creating (FB) 445 arrays, deleting 473 assigning ranks 460 audit report, console 438
B
background copy 546
C
chaccess 92 changing volume states Metro Mirror (DS CLI) 504, 512 chauthpol 61 chckdvol 226 checking command usage 40 chextpool 202 chfbvol 259 chhostconnect 156 chkeymgr 97 chlcu 216 chlss 254 chpass 62 chrank 190 chresgrp 324 chsession 430 chsestg 301 space-efficient storage 301 chsi 134 chsp 123 chsu 128 chuser 63 chvolgrp 289 Cisco MDS 9216 Multilayer Fabric Switch 44, 399, 414 ckd creating LCU 461 CKD deleting configurations 622 volume removal 242 Copyright IBM Corp. 2006, 2012
647
commands (continued) mkremoteflash 365 mkresgrp 329 mksession 432 mksestg 309 mkuser 70 mkvolgrp 293 offloadauditlog 438 overview structure 47 parameters 47 pausegmir 416 pausepprc 405 resumegmir 417 resumepprc 407 resyncflash 334 resyncremoteflash 357 reverseflash 345 revertflash 348 revertremoteflash 367 rmarray 186 rmauthpol 72 rmckdvol 242 rmextpool 208 rmfbvol 276 rmflash 349 rmgmir 418 rmhostconnect 172 rmkeygrp 106 rmkeymgr 106 rmlcu 222 rmpprc 410 rmpprcpath 384 rmrank 196 rmreckey 107 rmremoteflash 369 rmresgrp 330 rmsession 437 rmsestg 311 rmuser 73 rmvolgrp 294 setauthpol 73 setenv 55 setflashrevertible 353 setioport 149 setremoteflashrevertible setrmpw 81 setvpn 124 showarray 187 showarraysite 179 showauthpol 82 showckdvol 243 showenv 57 showextpool 209 showfbvol 278 showgmir 420 showgmircg 428 showgmiroos 429 showhostconnect 173 showioport 150 showkeygrp 108 showlcu 223 showlss 257 showpass 86 showrank 197 showresgrp 331 showsestg 311 showsi 140
371
commands (continued) showsp 126 showsu 131 showuser 87 showvolgrp 295 testauthpol 88 unfreezeflash 352 unfreezepprc 412 variables 47 ver 58 who 89 whoami 91 commitflash 333 commitremoteflash 355 concurrent copy modifying timeout value (DS CLI) 505 conduit LSS 628 configuration error 451 configuration profile file 24 configuring Fibre Channel I/O ports 454, 465 configuring I/O port, System i 454, 465 connection ID, caution 156 consistency group 541 inconsistencies 610 modifying timeout value (DS CLI) 505 consistency group parameters, CLI 517 consistency groups creating (DS CLI) 507 console audit report 438 console mode installation, DS CLI 10 controlling CLI page help 41 conversions Global Copy to Metro Mirror 631 Metro Mirror to Global Copy 631 converting Metro Mirror (DS CLI) 510 volume pairs 510 Copy Services across 2105 and DS6000 513 across 2105 and DS8000 513 correcting path-related configuration error 497 wrong value for remote WWNN 497 wrong value for target LSS ID 497 correcting a CKD configuration error 464 correcting fixed block configuration error 451 correcting FlashCopy relationships, commitflash command 544 correcting FlashCopy relationships, revertflash command 543 count key data volumes creating extent pools 458 cpauthpol 65 create FlashCopy relations, Global Mirror 527 create Global Copy pairs 526 create paths, Global Mirror 524 creating ckd volumes 463 consistency group (DS CLI) 500, 507
creating (continued) extent pools, fixed block 443 fixed block volume groups 452 fixed block volumes 447 FlashCopy relationship 483 LUN volumes 449 Metro Mirror volume pair using a 2105 (DS CLI) 514 persistent FlashCopy 484 ranks for CKD volumes 460 SCSI host port connections 455 volume groups for System i 453 creating a rank, DS CLI 446 creating arrays (ckd) 459 creating arrays (FB) 445 creating extent pools, CKD 458 critical heavy mode 399 critical mode setting (DS CLI) 506 critical volume mode 399
D
DDM status 471 default CLI settings 24 default directories 37 delete arrays 473 delete extent pools, DS CLI 470 delete LCUs 481 delete ranks 478 deleting FlashCopy relationships 486 paths 498 single volume relationship (DS CLI) 512 volume pair (DS CLI) 504 deleting CKD configurations 625 deleting fixed block configuration 622 determining available I/O ports 511 diagsi 136 disableautoresync failbackpprc 386 failoverpprc 389 mkpprc 399 resumepprc 407 disaster recovery drain time 550 failback scenario (DS CLI) 508 failover (DS CLI) 509 failover B volumes to A volumes 540 first pass 550 OOS 550 quiesce your system 550 restoring operations (planned) to the intermediate site 589 restoring operations to the intermediate site 567, 599 planned outage 561 restoring operations to the remote site 571 restoring to the intermediate site 611 disaster recovery, Global Mirror background copy 546 begin the failback recovery process 548 checking status 539
648
disaster recovery, Global Mirror (continued) consistency group analysis 541 correcting FlashCopy relationships, commitflash command 544 end Global Mirror processing 538 fast reverse restore 545 Global Copy failback 553 Global Copy failover 553 process overview 537 reestablish FlashCopy relationships, B to C 547 reestablishing paths 551 resume Global Mirror processing 554 resume Global Mirror processing at the A site 554 resynchronize B volumes to A volumes 549 revertflash and FlashCopy relationships 543 disk drive module 471 displaying paths 495 DS CLI console mode installation 10 create paths 496 creating volume pairs 499, 502 default directories 37 determining 511 ESS machine types 16 first time login 37 graphical mode installation 7 I/O ports 511 installation on Linux 10 interactive mode 40 limitations 44 OpenVMS messages 45 script mode 39 session limitation 44 silent mode installation 14 silent mode installation, DS CLI 14 single-shot mode 38 upgrade preparation 16 DS CLI command format 37 DS CLI commands System i 466 DS CLI exit codes 42 DS CLI installation AIX considerations 4 default directories 4 HP Tru64 considerations 4 key aspects 4 mounting the installation CD 6 System i considerations 4 DS CLI Tasks Global Mirror add volumes to session 516 create FlashCopy relationships 527 create Global Copy pairs 526 create session 528 end a session 530 end processing, no script 523 end processing, script mode 523 modify tuning parameters 517 pausing processing 521
DS CLI Tasks (continued) Global Mirror (continued) query Global Mirror session 520 remove FlashCopy relationships 531 remove Global Copy relationships 532 remove paths 533 remove volumes 529 resume processing 521 setup, creating paths 524 start processing 522 view session 520 DS CLI Tasksmodify topology Global Mirror 518 DS CLI uninstall Linux systems 17 DS CLI upgrade, 2105 to DS8000 16 dscli command 51 during an unplanned outage 579
E
eam (extent allocation method) lsckdvol 229 lsfbvol 263 mkckdvol 239 mkfbvol 272 showckdvol 243 showfbvol 278 EAV (extended addressing volume) mkckdvol 239 echo command 52 end Global Mirror script mode 523 ending Global Mirror processing 538 exit codes, obtaining 42 extent pool modifications, CLI 468 extent pool names 443 extent pool, adding ranks with DS CLI 474 extent pools, delete with DS CLI 470 extent pools, System i 443
F
failback disaster recovery scenario (DS CLI) 508 local to remote 630 restoring operations (planned) to the intermediate site 589 restoring operations (unplanned) to the intermediate site 599 using -force 589, 599 failback recovery process 548 failbackpprc 386 disableautoresync 386 tgtse 386 failover disaster recovery (DS CLI) 509 during an unplanned outage 579 planned outage restoring operations to the intermediate site 561 restoring operations (planned) to the intermediate site 589
failover (continued) restoring operations (unplanned) to the intermediate site 599 restoring operations to the intermediate site 567, 611 restoring operations to the remote site 571 using -force 589, 599 failoverpprc 389 disableautoresync 389 tgtse 389 fast reverse restore 545 Fibre Channel I/O ports configuring 454, 465 fc-al 454, 465 ficon 454, 465 scsi-fcp 454, 465 first pass 550 first time login 37 fixed block deleting configurations 622 fixed block configuration error, correcting 451 fixed block volume creating arrays 445 fixed block volume groups, creating 452 fixed block volume groups, modifying 621 fixed block volumes creating extent pools 443 fixed block volumes, creating 447 FlashCopy background copy 490 creating a FlashCopy relationship 483 deleting relationships 486 inconsistent data on target volumes 610 persistent creating 484 refreshing target volumes 488 reversing relationship 489 revertible option 489 revertible option defined 489 setflashrevertible 489 target volumes on Metro Mirror source 492 removing write inhibits 491 viewing information about FlashCopy relationships 484 FlashCopy relationships, create 527 force parameter 386, 389 freezepprc 404
G
Global Copy creating volume pairs 502 Global Copy failback 553 Global Copy failover 553 Global Copy pairs, create 526 Global Mirror - CLI add volumes to session 516 create FlashCopy relationships create Global Copy pairs 526 create session 528 Index
527
649
Global Mirror - CLI (continued) end processing, no script 523 end processing, script mode 523 end session 530 modify topology 518 modify tuning parameters 517 pausing processing 521 query session 520 remove FlashCopy relationships 531 remove Global Copy pair 532 remove paths 533 remove volumes 529 resume processing 521 setup environment, paths 524 start processing 522 view session 520 Global Mirror processing, ending 538 graphical mode installation, DS CLI 7
H
help, CLI 41 helpmsg 54 HP-UX volume restriction 156
I
I/O ports available 511 i5/OS command format 38 green screen, DS CLI 466 library QDSCLI 466 removing DS CLI directly 20 silent mode CLI installation 14 i5/OS password file directory 68 inband transactions 486, 628 incremental FlashCopy copying updated tracks only 488 incremental resynchronization during a planned outage at an intermediate site 611 incrementalresync 399 initckdvol 228 initfbvol 262 installing the CLI 24 interactive mode history function 40 setoutput command 40 issuing DS CLI commands 466 i5/OS 466
J
Java Virtual Machine Not Found Error 15
L
LCU creation 461 LCU status 480 LCU status, one 480 LCU, modify with CLI 479
LCUs, deleting 481 library QDSCLI 466 limitations remote FlashCopy 486 Linux DS CLI installation, console mode 10 lshostvol command considerations 165 Linux password file directory 68 Linux, DS CLI upgrade considerations 16 Linux, uninstall DS CLI 17 lock account 63 logical control unit creation 461 logical control unit properties 480 lsaccess 93 lsaddressgrp 215 lsarray 182 lsarraysite 177 lsauthpol 66 lsavailpprcport 373 lsckdvol eam (extent allocation method) 229 sam (standard allocation method) 229 lsda 110 lsddm 118 lsextpool 203 lsfbvol 263 eam (extent allocation method) 263 tse 263 lsflash 337 tgtse, space-efficient volume 337 lsframe 112 lsgmir 426 lshba 117 lshostconnect 160 lshosttype 175 lshostvol Linux considerations 165 OpenVMS considerations 165 lsioport 144 lskey 95 lskeygrp 97 lskeymgr 100 lslcu 218 lslss 255 lsperfgrp 318 lsperfgrprpt 319 lsperfrescrpt 322 lsportprof 167 lspprc 392 lspprcpath 376 command 495 lsrank 191 lsremoteflash 360 tgtse, space-efficient volume 360 lsresgrp 324 lsserver 136 lssession 433 lssestg 303 space-efficient storage 303 lssi 138 command 495 lsstgencl 114 lssu 129 lsuser 67
lsvolgrp 291 lsvolinit 299 lsvpn 125 LUN sizes 272 LUN volumes, creating
449
M
manageckdvol 236 managefbvol 270 managehostconnect 168 managekeygrp 101 managepwfile 68 managereckey 102 manageresgrp 326 message types 45 Metro Mirror consistency groups 500 creating volume pairs 499 FlashCopy target on Metro Mirror source 492 scenario 630 Metro/Global Mirror restoring operations (planned) to the intermediate site 589 restoring operations (unplanned) to the intermediate site 599 setting up 557 mkaliasvol 237 mkarray 185 mkauthpol 70 mkckdvol 239 eam (extent allocation method) 239 EAV (extended addressing volume) 239 tse 239 mkesconpprcpath 380 mkextpool 206 mkfbvol 272 eam (extent allocation method) 272 space-efficient storage 272 mkflash 342 tgtse, space-efficient volume 342 mkgmir 414 mkhostconnect 169 mkkeygrp 104 mkkeymgr 104 mklcu 220 mkpprc 399 disableautoresync 399 tgtse 399 volume pairs 499, 502 mkpprcpath 382 creating paths 496 mkrank 195 mkreckey 105 mkremoteflash 365 tgtse, space-efficient volume 365 mkresgrp 329 mksession 432 mksestg 309 space-efficient storage 309 mkuser 70 mkvolgrp 293 modify extent pool, CLI 468
650
modify a rank, CLI 475 modify an LCU, CLI 479 modify topology, CLI 518 modify tuning parameters, CLI 517 modifying concurrent copy timeout value (DS CLI) 505 consistency group timeout (DS CLI) 505 critical mode setting (DS CLI) 506 fixed block volume groups 621 timeout values (DS CLI) 504 z/OS Global Mirror (DS CLI) 505 mounting the DS CLI installation CD 6 multiple LCU status 480 multiple ranks status 476
processing tips 3 site recovery 399 cascade 399 incrementalresync 399 multiple volumes 399 volume grouping method
399
Q
query Global Mirror session quiesce your system 550 520
R
RAID 6 creating extent pools 458 fixed block volumes 443 lsarray 182 lsrank 191 LUN volumes 449 showarray 187 rank configuration 446, 460 rank group 1 or 1 460 rank status, one 477 rank, create with DS CLI 446 rank, modify with CLI 475 ranks status 476 ranks, deleting 478 reestablishing remote mirror and copy paths 551 relationship reversing FlashCopy 489 release rank, CLI 475 remote FlashCopy limitations 486 remote FlashCopy transactions 628 Remote Mirror and Copy relationships viewing (DS CLI) 510 remove arrays 473 remove LCUs 481 remove ranks 478 removing uncorrupted incremental backup 491 write inhibits from FlashCopy target volumes 491 removing DS CLI, i5/OS 20 report formats controlling 40 reserve rank, CLI 475 resource groups using 634 restoring operations (planned) to the intermediate site 589 restoring operations (unplanned) to the intermediate site 599 restoring operations to the intermediate site 561, 567 restoring operations to the remote site 571, 579 resume Global Mirror processing 521 resumegmir 417 resumepprc 407 disableautoresync 407 resuming volumes 501 tgtse 407
N
nonrevertible 543, 544 Novell DS CLI graphical installation 7
O
offloadauditlog 438 OpenVMS DS CLI message considerations 45 lshostvol command considerations 165 operational limitations 44 OS/400 DS CLI graphical installation 7 os400all 453 os400mask 453 out-of-sync 550 overview accessibility features 637
resync target volumes in FlashCopy relationship 488 resyncflash 334 tgtse, space-efficient volume resynchronize B volumes to A volumes 549 resyncremoteflash 357 tgtse, space-efficient volume reverse a FlashCopy relationship reverseflash 345 tgtse, space-efficient volume revertflash 348 revertremoteflash 367 rmarray 186 rmauthpol 72 rmckdvol 242 rmextpool 208 rmfbvol 276 rmflash 349 tgtse, space-efficient volume rmgmir 418 rmhostconnect 172 rmkeygrp 106 rmkeymgr 106 rmlcu 222 rmpprc 410 rmpprcpath 384 rmrank 196 rmreckey 107 rmremoteflash 369 tgtse, space-efficient volume rmresgrp 330 rmsession 437 rmsestg 311 space-efficient storage 311 rmuser 73 rmvolgrp 294
334
349
369
P
password file directories i5/OS 68 LINUX 68 UNIX 68 Windows 68 paths creating 496 deleting 498 displaying 495 lspprcpath 508 mkpprcpath 496 port considerations 496 view existing 508 Paths correcting configuration error pausegmir 416 pausepprc 405 suspending volumes 502 persistent FlashCopy creating 484 planned outage restoring operations to the intermediate site 561 postinstallation CLI 24 postinstallation tasks 24 primary volumes 540
S
script mode 39 script mode, end processing 523 SCSI host port connections creating 455 serial number, obtaining 41 service action report, console 438 service audit log 438 setauthpol 73 setenv 55 setflashrevertible 353 tgtse, space-efficient volume 353 setioport 149 setremoteflashrevertible 371 tgtse, space-efficient volume 371 setrmpw 81 setting up Metro/Global Mirror 557 setup, account 30 setvpn 124 showarray 187 showarraysite 179 showauthpol 82 showckdvol 243 eam (extent allocation method 243 tse 243 showenv 57 Index
497
651
showextpool 209 showfbvol 278 eam (extent allocation method) 278 tse 278 showgmir 420 showgmircg 428 showgmiroos 429 showhostconnect 173 showioport 150 showkeygrp 108 showlcu 223 showlss 257 showpass 86 showrank 197 showresgrp 331 showsestg 311 space-efficient storage 311 showsi 140 showsp 126 showsu 131 showuser 87 showvolgrp 295 single volume relationship deleting (DS CLI) 512 single-shot mode command format, i5/OS 38 command format, Windows 38 space-efficient storage chsestg 301 lsfbvol 263 lssestg 303 mkfbvol 272 mksestg 309 rmsestg 311 showsestg 311 space-efficient volume lsflash 337 lsremoteflash 360 mkflash 342 mkremoteflash 365 resyncflash 334 resyncremoteflash 357 reverseflash 345 rmflash 349 rmremoteflash 369 setflashrevertible 353 setremoteflashrevertible 371 starting FlashCopy 490 status information, fixed block volume 263 stop the process Global Mirror 418 storage image ID, obtaining 41 System i bypassing uninstaller 20 CLI installation considerations 4 configuring I/O port 454, 465 creating FlashCopy relationships 483 Global Copy pairs 502 Metro Mirror pairs 499 DS CLI commands 466 extent pool considerations 443 host connections 455 interactive mode 40 issuing 466
System i (continued) LUN volumes 449 lunmapping 295 os400all 453 os400mask 453 postinstallation tasks 24 removing CLI, direct method 20 removing CLI, remote method 21 script mode 39 serial number reporting 140 showvolgrp 295 single-shot mode 38 volume group creation external load source consideration 453 multipath consideration 453
U
unassign rank, CLI 475 unattended (silent) mode installation 14 unattended (silent) mode installation, DS CLI 14 unfreezeflash 352 unfreezepprc 412 uninstall.dat 21 uninstall.jar 21 UNIX DS CLI graphical installation 7 UNIX password file directory 68 unlock account 63
V
ver 58 view a specific LCU 480 view a specific rank 477 view array sites status 471 view arrays status 471 view LCU status 480 view ranks status 476 view session, CLI 520 viewing existing paths 508 information about FlashCopy relationships 484 Remote Mirror and Copy relationships (DS CLI) 510 volume format processing options 399 volume pair deleting (DS CLI) 504 volume removal, CKD 242 volumes FlashCopy target volumes commit changes 494 discard changes 493 volumes, alias 239
T
target volume commit changes 494 discard changes 493 FlashCopy commit changes 494 discard changes 493 testauthpol 88 tgtse failbackpprc 386 failoverpprc 389 lsflash 337 lsremoteflash 360 mkflash 342 mkpprc 399 mkremoteflash 365 resumepprc 407 resyncflash 334 resyncremoteflash 357 reverseflash 345 rmflash 349 rmremoteflash 369 setflashrevertible 353 setremoteflashrevertible 371 thaw operation 412, 561, 567, 571, 579, 589, 599, 630 timeout connection 24 timeout values modifying concurrent copy (DS CLI) 504 consistency group (DS CLI) 504 critical mode enabled (DS CLI) 504 z/OS Global Mirror (DS CLI) 504 topology defined, CLI 518 Trademarks 642 tse lsckdvol 229 lsfbvol 263 mkckdvol 239 showckdvol 243 showfbvol 278 space-efficient storage lsckdvol 229 tse, mksestg mkfbvol 272 tuning parameters, CLI 517
W
who 89 whoami 91 Windows DS CLI graphical installation 7 Windows password file directory 68 write acceleration restriction 44, 399, 414 write inhibits mkflash command 491 removing from FlashCopy target volumes 491 wwnn displaying for paths 495
Z
z/OS Global Mirror modifying critical mode setting (DS CLI) timeout value (DS CLI) 505 506
652
Thank you for your support. Send your comments to the address on the reverse side of this form. If you would like a response from IBM, please fill in the following information:
Address
Email address
___________________________________________________________________________________________________
Tape do not Fold and _ _ _ _ _ _ _Fold _ _ _and ___ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please _____ __ _ _ staple _____________________________ ___ _ _ Tape ______ NO POSTAGE NECESSARY IF MAILED IN THE UNITED STATES
International Business Machines Corporation Information Development Department 61C 9032 South Rita Road Tucson, AZ 85775-4401
_________________________________________________________________________________________ Fold and Tape Please do not staple Fold and Tape
GC27-4212-00
Printed in USA
GC27-4212-00
Spine information:
Version 7 Release 0