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-+-'  '- -extpool--extentpool_ID-'   
                 '-3390-'                                   

>--+----------------------+--+------------------------+--------->
   '- -access--+-online-+-'  '- -data--+-normal-----+-'   
               '-fenced-'              '-not_normal-'     

>--+--------------------------+--+---------------+-------------->
   '- -config--+-normal-----+-'  '- -lcu--lcu_ID-'   
               '-not_normal-'                        

>--+----------------------+--+----------------------+----------><
   '- -voltype--+-base--+-'  +-volume_ID--+-------+-+   
                '-alias-'    |            '-. . .-' |   
                             '-" - "----------------'

Parameters

Note: For a storage unit that is heavily configured, it is recommended that you include the -lcu parameter as part of your command.

-dev storage_image_ID: (Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number.
-s: (Optional) Displays volume IDs. You cannot use the -l and the -s parameters together.
-l: (Optional) Displays default output plus additional attributes that are identified as long output. You cannot use the -l and the -s parameters together.
-datatype 3380 | 3390: (Optional) Displays only volumes of the specified volume data type.
-extpool extentpool_ ID: (Optional) Display only volumes that are associated with the specified extent pool.
-access online | fenced: (Optional) Displays only volumes with the specified access state.
-data normal | not_normal: (Optional) Displays only volumes with the specified data state.
-config normal | not_normal: (Optional) Displays volumes with the specified configuration state.
-lcu lcu_ID: (Optional) Displays only volumes with IDs that contain the specified logical control unit ID. Each logical control unit can contain up to 256 volumes. A logical control unit ID is two hexadecimal characters 00 - 1F (for 1750).
Note: If you are doing a query on a fully configured storage unit, it is recommended that you specify a specific LCU. If you do not specify a specific LCU, the entire storage unit is queried which results in a longer processing time.
-voltype base | alias: Specifies the type of CKD volumes you want displayed.
volume_ID . . . | -: (Optional) Displays volumes with the specified IDs. A volume ID is four hexadecimal characters in the range 0000 - 1FFF (for 1750).; 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 specify a dash (-), this parameter information is automatically supplied.

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 lsckdvol command using the -l parameter. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

The following example is based on the output results for a volume with 3340 cylinders.

Invoking the lsckdvol

dscli>lsckdvol 
-dev IBM.2107-1300861 -l 1410

The resulting output

Date/Time: April 12, 2005 6:06:31 PM JST 
IBM DS CLI Version: 5.0.3.40 
DS: IBM.2107-1300861

Name	ID	acc state	data state	config state	device MTM	Volser	data type
My_ volume _1410	1410	Online	Normal	Normal	3390-9	A03976	3390

voltype	orgbvols	extentpool	sam	cap (cyl)	cap (2^30B)	cap (10^9B)
CKD base	-	P2	standard	3340	2.6	2.8

Report field definitions

Name

Identifies the nickname that you assigned to the designated volume object.

ID

Identifies the unique identifier that is assigned to the designated volume object

Accstate (access state)

One of the following designations can be displayed:

Online: Specifies that the logical volume is accessible to a host.
Fenced: Specifies that the logical volume is in the volume fenced state and is not accessible to the host.
- (null): Specifies that the logical volume is designated as a CKD alias volume.

Datastate

One of the following designations can be displayed:

Normal

Specifies that none of the other data states apply. The access state is Online.

Pinned

Specifies that none of the other data states apply and the logical volume has one or more pinned non-retryable tracks. The access state is Online.

Read only

Specifies 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. The access state is Online.

Inaccessible

Specifies that one or more extents that are associated with the logical volume are on a rank that is in the inaccessible data state. The access state is fenced.

Indeterminate data loss

Specifies that the following data states do not apply and that one of the following conditions has occurred:

Data states that do not apply:

Rank failed
Rank repairing
Rank repaired
Global inaccessible
Global lost data

Conditions - one of the following occurred:

Committed write data was lost before it was destaged and the track identifiers that are associated with the data are unknown.
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.

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.

- (null)

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.
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.
Migrating: Indicates that the logical volume is in the process of performing dynamic volume relocation to a specified extent pool.
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.; Corrective action: Use the rmfbvol command to delete each volume 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.
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.

deviceMTM

One of the following is displayed:

3380-2
3380-3
3390-3
3390-9

Volume MTM is determined by the CKD base volume data type and volume capacity (in cylinders).

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:

CKD base
CKD alias

Orgbvols (original base vol)

One of the following will be specified:

Identifies the original base CKD volume ID to which this CKD alias volume is assigned.
For a CKD Alias type volume, the base and alias volume IDs are of a common LCU ID.
- (null) is displayed for a CKD base volume type.

Extpool

Identifies the extent pool ID. Volume extents are allocated from this extent pool ID.

SAM (Standard Allocation Method)

Specifies the space efficient implementation. The current designation is Standard.

Cap (cyl)

Specifies the quantity of volume CKD cylinders that are available for host system access.

Cap (2³⁰B)

Specifies the size of volume that is available for host system access in 2³⁰B (binary GB) unit.

Cap (10⁹B)

Specifies the size of volume that is available for host system access in 10⁹B (decimal GB) unit.