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.

Read syntax diagramSkip visual syntax diagramlslcu  -dev  storage_image_ID  -s  -l  -addrgrp  address_group  -resgrp  resource_group_ID  LCU_ID   ...   "-"

Parameters

-dev storage_image_ID
(Optional). The storage image ID, which consists of manufacturer, machine type, and serial number. Displays only the objects for the storage system that is specified. The storage image ID is required for the following conditions:
  • A fully qualified LCU ID is not specified.
  • The devid variable is not set in your profile or specified through the setenv command.
  • 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 IBM.2107-75FA120
-s
(Optional). Displays LCU IDs only. You cannot use the -l and the -s parameters together.
-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). 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) 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). The ID associated with an LCU. An LCU ID is two hexadecimal characters 00 - FE.
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.
The ellipsis (...) indicates that, optionally, you can specify multiple values. 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: Displaying LCUs' status information

dscli> lslcu -dev IBM.2107-75FA120 -l
Output
ID Group
addr-
grp
confg-
vols
subsys
con-
base-
type
resgrp
IBM.2107-75FA120/10
0 0 256 8010 3990-6 RG0
IBM.2107-75FA120/11
1 0 256 8011 3990-6 RG0
IBM.2107-75FA120/12
0 0 256 8012 3990-6 RG0
IBM.2107-75FA120/13
1 0 256 8013 3990-6 RG0

Output definitions

ID*
The LCU ID.

The LCU ID is a unique identifier that is assigned to this logical control unit object. The ID includes the storage image ID and the two-digit LCU ID.

Group
The server that is managing the logical control unit group. The server is identified as either 0 or 1.
Addrgrp
The address group object of which the logical control unit is a member.
Confgvols
The number of volumes, or logical devices assigned to the LCU ID. This number includes base CKD volumes and alias CKD volumes.
Subsys
The value that you assigned, or the default SSID value.
Conbasetype
The LCU type. The allowable values include the following LCU types:
  • 3390-3
  • 3390-tpf
  • 3390-6 (this value is the default if no value is assigned)
  • bs2000
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.
Key:
*
Displayed when the -s parameter is specified.
+
Displayed only when the -l parameter is specified.