lsfbvol

Edit online

The lsfbvol command displays a list of fixed block (FB) volumes in a storage image and status information, including Safeguarded Copy information for each volume in the list.

Parameters

Note: For a storage system that is heavily configured, specify the -lss or the -volgrp parameter as part of your command.

-dev storage_image_ID

(Optional) Displays the storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify fully qualified IDs. It is also required if you 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 temporarily overrides any defined value for devid for the current command.

-s

(Optional) Displays only the volume IDs. You cannot use the -l and the -s parameters together.

-l

(Optional) Displays default output plus extra attributes that are identified as long output in the Output definitions list. You cannot use the -l and the -s parameters together.

-datatype 512 | 512t | 520p | 520u | 520pv | 520uv

(Optional) Displays volumes of the specified volume data type. Standard 2107/1750 volume (512), T10-DIF algorithm protection (512t), System i protected (520p), System i unprotected (520u), IBM® i protected variable size (520pv), IBM i unprotected variable size (520uv).

-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 zeros, 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 - FE.

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

-sam standard | tse | ese

(Optional) The storage allocation method as follows.

standard: Fully allocates the volume with real extents when it creates the volumes.
tse: Creates track space-efficient volumes. After creation, these space-efficient volumes contain a set of virtual extents that are associated with the space-efficient storage in the same extent pool. The physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage.
Note: Track space-efficient (TSE) repositories are required to create TSE volumes. However, starting with DS8000® Release 8, TSE repositories can no longer be created.
ese: Provisions an extent space efficient logical volume with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and deallocated from the extent pool.

-eam legacy | rotatevols | rotateexts | managed

(Optional) Displays only volumes that meet the criteria of the designated extent allocation method as follows:

legacy: Volumes that were created before the current algorithms were implemented.
rotateexts: The extents for each new logical volume are allocated across all available ranks, also known as storage-pool striping. This value is the default.
rotatevols: The extents for each new logical volume are allocated from each successive rank. The extents for a particular volume are allocated from one rank, while the extents for the next volume are allocated from the next successive rank, and so on.
managed: The extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage.

-perfgrp performance_group_ID

(Optional) Displays only the volumes that belong to the specified performance group. The performance group ID begins with the letters PG.

-resgrp resource_group_ID

(Optional) Displays only the volumes that are assigned to the specified resource group ID. The resource group ID begins with the letters RG and ends with a decimal number.

-sgc

(Optional) Displays Safeguarded Copy information for the volumes.

volume_ID ... | –

(Optional) Displays volumes with the specified IDs. The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ where:

XY: The logical subsystem number, 00 - FE.
ZZ: The volume number, 00 - FF.
X: The address group, 0–F.

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.

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 0100-010F 0180-018F 0120

Example: Displaying a list of fixed block (FB) volumes in a storage image and status information, including Safeguarded Copy information for each volume in the list

The following tables represent the headers that are displayed on the output report that is associated with the lsfbvol command using the -l parameter.

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

Output

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
My_ _volume 0004	0104	Online	Normal	Normal	2107-099	FB 520UV
My_ _volume 0007	0105	Online	Normal	Normal	2107-050	FB 520PV

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	-
P0	standard	iSeries	5.0	5.4	10485760	-
P0	standard	iSeries	5.0	5.4	10485760	-

reqcap (blocks)	eam	perfgrp	resgrp
2097152	legacy	PG1	RG0
2097152	rotateexts	PG1	RG0
2097152	legacy	PG1	RG0
10485760	rotateexts	PG0	RG0
10485760	rotateexts	PG0	RG0

GUID	safeguardedcap (2^30B)	safeguardedloc
60050763CXFFC03 D0000000000000100	16.0	mypool_1
60050763CXFFC03 D0000000000000101	16.0	mypool_1
60050763CXFFC03 D0000000000000102	16.0	mypool_1
60050763CXFFC03 D0000000000000103	16.0	mypool_1

Output definitions

Name

The nickname that you assigned for the specified volume object.

ID

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

None of the other data states apply. The access state is Online.

Read only

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

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.

Virtual space fault

The logical volume has a storage allocation method of track space-efficient. Not enough space was available to convert a virtual logical track to a real logical track. The access state is Online.

Indeterminate data loss

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

Data states that do not apply:

Rank failed
Rank repairing
Rank repaired
Global inaccessible
Global lost data

Conditions - one of the conditions 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 indicates that extents on the logical volume were active FlashCopy targets.

The access state is fenced.

Rank failed

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

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

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

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 data

Global metadata that is associated with the logical volume configuration was 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

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 is displayed:

Normal: No logical volume configuration operations are in progress, and the volume is not being deconfigured, merged, or migrated.
Configuring: The logical volume is in the process of being configured for the first time.
Reconfiguring: The logical volume is allocating or deallocating extents due to a modification of the requested capacity attribute after initial creation.
Deconfiguring: The logical volume is being deleted.
Configuration error: 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. If you have a volume in this state, use the rmfbvol command to delete each volume that is listed with the configuration state of "configuration error".
Merging: The volume is merging. For example, merging from one extent pool to a different extent pool.
Migrating: The volume is migrating, or waiting to be migrated.
Migration Cancelled: The volume was migrating and then the ‘migcancel' action of the manageckdvol command was issued. Some of the extents were waiting to be migrated in the source pool while other extents already migrated to the target pool. Migration stopped, and cannot be resumed. If you have a volume in this state, try to migrate it again to the original source or target extent pool.
Migration Paused: The volume was migrating and then the ‘migpause' action of the manageckdvol command was issued. Migration stopped, but can be resumed.
Migration Error: The volume migration process failed to complete successfully. This state reflects an internal error condition and not an error in the request of the user to migrate a volume. If you have a volume in this state, try to migrate it again to the original source or target extent pool.
Reconfiguration error: The reconfiguration request did not complete successfully.
Deconfiguration error: 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.
Transposition Error: The volume is in an extent pool that was unsuccessfully merged. This state reflects an internal error condition. Corrective action Use the chextpool command with the -merge parameter again to redrive the merge extent pool and to correct this state.

deviceMTM

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: A standard 2107 volume.
1750-500: A standard 1750 volume.
xxxx-A0x: The xxxx is a 2107 or 1750. The value A0 indicates a System i protected volume (for example, 2107-A01 or 1750-A07).
xxxx-A8x: The xxxx is 2107 or 1750. The value A8 indicates a System i unprotected volume (for example, 2107-A81 or 1750-A87).
2107-050: The machine type is 2017. The value 050 indicates that the volume is a System i unprotected variable size volume.
2107-099: The machine type is 2107. The value 099 indicates that the volume is a System i protected variable size volume.

Datatype

The volume data type setting. One of the following values is displayed:

FB 512
FB 512T
FB 520P
FB 520U
FB 520PV
FB 520UV

Extpool

The extent pool ID. Volume extents are allocated from this extent pool ID.

Note: Volumes that belong to an encrypted extent pool are encrypted. You can see the key group of an extent pool by using the lsextpool -l, or showextpool commands.

SAM

The storage allocation method. The following values are displayed:

standard: The system fully allocated the volume with real extents at volume creation time.
tse: A track space-efficient logical volume contains a set of virtual extents that are associated with the space-efficient storage in the same extent pool. Physical space for a given logical track on a track space-efficient logical volume is dynamically allocated and deallocated from the repository in the space-efficient storage.
ese: An extent space efficient logical volume is provisioned with a set of virtual extents that are associated with the space efficient storage in the same extent pool. Physical space for an extent space efficient logical volume is dynamically allocated and deallocated from the extent pool.

Captype

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

ESS: The capacity unit is decimal gigabytes (GB).
DS: The capacity unit is gibibytes (GiB).
DS/ESS: The capacity unit is gibibytes (GiB) or decimal gigabytes (GB).
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)

The size of the volume that is available for host system access in gibibytes (GiB).

Note: " – " is displayed if the capacity unit type of the volume is ESS (captype=ESS)

Cap (10^9B)

The size of the volume that is available for host system access in decimal gigabyte (GB) units.

Note: " – " is displayed if the capacity unit type of the volume is DS (captype=DS)

Cap (blocks)

The quantity of volume logical blocks that are available for host system access.

Volgrp

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 " – " is displayed if no volume groups exists that are associated with the volume.

Unknown displays if information about the volume groups is not available.

Reqcap (blocks)

The requested quantity of volume logical blocks (for example, 3339).

EAM

The extent allocation method that is used if the volume is migrated or expanded.

legacy: The volume was created before the use of the current algorithm.
rotateexts: The extents for each new logical volume are allocated across all available ranks, and is also known as storage-pool striping. This value is the default.
rotatevols: The extents for each new logical volume are allocated from each successive rank. This means that the extents for a particular volume are allocated from one rank, while the extents for the next volume are allocated from the next successive rank, and so on.
managed: The extents are currently managed by Easy Tier, and the extents for any new volumes are initially allocated across all available ranks in the lowest tier of storage.
" – ": A dash " - " value is displayed if the extent allocation method does not apply , for example if the volume is a track space efficient (TSE) volume.

perfgrp

The performance group ID that the volume is assigned to. The performance group ID begins with the letters PG and ends with a decimal number.

resgrp

The resource group ID that the volume is assigned to. The resource group ID begins with the letters RG and ends with a decimal number.

GUID

The GUID (Globally Unique Identifier): The NAA (Network Addressing Authority) unique value that identifies a volume object.

safeguardedcap(2^30B)

The amount of safeguarded virtual capacity that is reserved for the volume.

safeguardedloc

The pool where the safeguarded copies for the volume are written.