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--+-'  '- -extpool--extentpool_ID-'   
                 +-520p-+                                   
                 '-520u-'                                   

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

>--+--------------------------+--+---------------+-------------->
   '- -config--+-normal-----+-'  '- -lss--LSS_ID-'   
               '-not_normal-'                        

>--+---------------------------+--+----------------------+-----><
   '- -volgrp--volume_group_ID-'  +-volume_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) Specifies the storage image ID, which consists of manufacturer, type, and serial number.
-s: (Optional) Displays the 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 512 | 520p | 520u: (Optional) Displays volumes of the specified volume data type. Standard 2107/1750 volume (512), 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 - 1F (for 1750).
-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.
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 X is the address group (0 - 1), XY together is the logical subsystem number 00 - 1E, and ZZ is 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 specify the dash (-), this parameter information is automatically supplied.; 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. A separate example is not shown for the 1750 because the information is the same for both machine types. The only difference is the machine type designation, 2107 versus 1750.

Note:

Invoking the lsfbvol command

dscli>lsfbvol 
-dev IBM.2107-75FA120 -l -volgrp V2

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107-75FA120

Name	ID	accstate	datastate	config state	device MTM	data type
My_ volume_ 0001	0100	Online	Normal	Normal	2107-900	FB 512
My_ volume_ 0002	0102	Online	Normal	Normal	2107-A07	FB 520P
My_ _volume 0003	0103	Online	Normal	Normal	2107-900	FB 512

extpool	sam	captype	cap (2^30B)	cap (10^9B)	cap (blocks)	Volgrp
P21	standard	DS	64.0	-	134217728	V2
P31	standard	iSeries	128.0	68.7	268435456	V2
P21	standard	ESS	-	35.0	68359424	-

Report field definitions

Name

Identifies the nickname that you assigned for the specified volume object.

ID

Identifies the unique identifier that is assigned to this volume object.

Accstate

One of the following access states are displayed: Online or Fenced.

Online: The logical volume is accessible to a host.
Fenced: The logical volume is in the volume fenced state and is not accessible to the host.

Datastate

One of the following data states are displayed:

Normal

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

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

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. 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 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.
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

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 binary (B) values will be displayed:

FB 512
FB 520P
FB 520U

Extpool

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

SAM (Storage Allocation Method)

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

Captype

Indicates the capacity unit type that is used at volume creation. One of the following values is displayed:

ESS: The capacity unit is 10⁹B.
DS: The capacity unit is 2³⁰B.
DS/ESS: The capacity unit is 2³⁰B or 10⁹B.
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 2^30B (binary GB) units.

Note: "–" (null) 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 10^9B (decimal GB) units.

Note: "–" (null) 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 null (-) is displayed if there are no volume groups that are associated with the volume.