showlss

The showlss command displays detailed properties of a logical subsystem (LSS).

Read syntax diagramSkip visual syntax diagram showlss  -dev  storage_image_ID  -sfstate  - spidfstate  LSS_ID " - "

Parameters

-dev storage_image_ID
(Optional) 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.
-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 LSS.
-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.
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.
The following example is a fully qualified LSS ID: IBM.2107-75FA120/10
The following example is 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: Displaying detailed properties of an LSS

dscli> showlss IBM.2107-75FA120/10
Output
ID Group Addrgrp Stgtype Confgvols
2107-75FA120/10
0 1 fb 256
Subsys Pprcconsistgrp Xtndlbztimout resgrp
FF10 Disabled 60 secs RG0

Output definitions

ID
The unique identifier that is assigned to this logical subsystem. It includes the storage image ID and the 2 digit LSS ID 00 - FE.
Group
The server that manages the logical subsystem. The displayed values are 0 or 1.
Addrgrp
The address group object that the logical subsystem is a member of.
Stgtype
The type of storage volumes contained by this logical subsystem. The value displayed is fb (fixed block) or ckd (count key data)
Confgvols
The number of volumes that are assigned to this logical subsystem.
Subsys
The user assigned, or default SSID value.
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. LSSs are created with an extended long busy timeout value of 60 seconds.
resgrp
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.

Example 2

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

dscli> showlss -sfstate 14
Date/Time: September 22, 2016 3:18:07 PM MST IBM. 
DS: IBM.2107-75LH321
ID              14
Group           0
addrgrp         1
stgtype         fb
confgvols       16
subsys          0xFF14
pprcconsistgrp  Disabled
xtndlbztimout   60 secs
resgrp          RG0
============Soft Fence State============
Name         ID   sfstate
========================
RegrFBVol1 1400 Disabled
RegrFBVol1 1401 Disabled
RegrFBVol1 1402 Disabled
RegrFBVol1 1403 Disabled
RegrFBVol1 1404 Disabled
RegrFBVol1 1405 Disabled
RegrFBVol1 1406 Disabled
RegrFBVol1 1407 Disabled
RegrFBVol1 1408 Disabled
RegrFBVol1 1409 Disabled
RegrFBVol1 140A Enabled
RegrFBVol1 140B Enabled
RegrFBVol1 140C Enabled
RegrFBVol1 140D Enabled
RegrFBVol1 140E Enabled
RegrFBVol1 140F Enabled
dscli>

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.