showlcu

The showlcu command displays the detailed properties of an individual logical control unit (LCU).

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.; Example: IBM.2107-75FA120
-sfstate: (Optional) Displays a table at the end of the command output that contains the name, ID, and soft fence state for each volume in the specified LCU.
-spidfstate: (Optional) Displays a table at the end of the command output that contains the name, ID, and SPID (set path group ID) fence state for each volume in the specified LCU.
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.; 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.

Example 1: Displaying detailed properties of an LCU

dscli> showlcu -dev IBM.2107-75FA120 10

Output

ID	Group	Addr- grp	Confg- vols	Subsys	Con- base- type
IBM.2107-75FA120/10	0	1	256	0010	3990-6

Pprc- consist- grp	Xtndlbz- timeout	Ccsess- timout	Xrc- sess- timout	Crit- hvmode	resgrp
Disabled	120 secs	300 secs	300 secs	Disabled	RG0

Output definitions

ID: The unique identifier that is assigned to this logical control unit object. It includes the storage image ID and the 2-digit LCU ID: 00 - FE.
Group: The server that manages the logical control unit group. The displayed values are 0 or 1.
Addrgrp: The address group object that the logical control unit is a member of.
Confgvols: 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: The subsystem ID that you assigned to this logical control unit. The range of values that you selected from is 0001 - FFFF.
Conbasetype: 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.
Pprcconsistgrp: The assigned PPRC consistency group state setting. If you do not designate enabled, the default value of disabled is assigned.
Xtndlbztimout: 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: 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: The assigned XRC session timeout value. If you do not designate a value, the default value of 300 seconds is assigned and displayed.
Crithvmode: Indicates 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: 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.

Example 2: Displaying detailed properties of an LCU

If you specify the -sfstate parameter, the output includes the soft fence state table.

dscli> showlcu -sfstate ef IBM.2107-75FA120 10

Output

 
Date/Time: September 22, 2016 8:43:04 AM MST  
2107-1300861
ID               EF
Group            1
addrgrp          E
confgvols        4
subsys           0x1111
conbasetype      3990-6
pprcconsistgrp   Disabled
xtndlbztimout    120 secs
ccsesstimout     300 secs
xrcsesstimout    300 secs
crithvmode       Disabled
resgrp           RG0
============Soft Fence State============
Name ID   sfstate
========================
-    EFFC Disabled
-    EFFD Disabled
-    EFFE Disabled
ffff EFFF Disabled

Output definitions ( -sfstate parameter is specified)

Name

The user-assigned nickname for this volume object.

ID

The unique identifier that is assigned to this volume object. A volume ID is four hexadecimal characters (0x0000 - 0xFEFF).

sfstate

The soft fence state. The following values are possible.

Enabled: The host has set this volume to the soft fence state.
Disabled: The host has not set this volume to the soft fence state.
N/A: The host cannot set this volume to the soft fence state. For example, an alias volume.

Output definitions ( -spidfstate parameter is specified)

Name

The user-assigned nickname for this volume object.

ID

The unique identifier that is assigned to this volume object. A volume ID is four hexadecimal characters (0x0000 - 0xFEFF).

spidfstate

The soft fence state. The following values are possible.

Enabled: The volume is set to the SPID fence state by the host.
Disabled: The volume is not set to the SPID fence state by the host.
N/A: The volume is not capable of being set into the SPID fence state by the host. For example, an alias volume.