lsvdisk

Use the lsvdisk command to display a concise list or a detailed view of volumes that are recognized by the system.

Syntax

lsvdisk [ -filtervalueattrib=value [ -unit { b | kb | mb | gb | tb | pb } ] ] [ -nohdr ] [ -bytes ] [ -delimdelimiter ] [ -filtervalue? ] [ { object_id | object_name } ]

Parameters

-filtervalueattrib=value

(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed. If a capacity is specified, the units must also be included.

-unitb | kb | mb | gb | tb | pb

(Optional) Specifies the data units for the -filtervalue parameter.

Note: -unit must be used with -filtervalue.

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.

Note: If there is no data to be displayed, headings are not displayed.

-bytes

(Optional) Displays all capacities as bytes. Capacity values that are displayed in units other than bytes might be rounded. When you filter a capacity value, use a unit of bytes, -unit b, for exact filtering. For thin-provisioned copies, the capacity by tier contains the real capacities.

-delimdelimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-filtervalue?

Displays a list of valid filter attributes. The following filters for the lsvdisk command are valid:

access_IO_group_count
backup_status
capacity
cloud_backup_enabled
cloud_account_id
cloud_account_name
compressed_copy_count
copy_count
deduplicated_copy_count
fast_write_state
FC_id
fc_map_count
FC_name
filesystem
function
id
IO_group_id
IO_group_name
mdisk_grp_name
mdisk_grp_id
mirror_write_priority
name
owner_type
owner_id
owner_name
preferred_node_id
RC_change
RC_id
RC_name
restore_status
se_copy_count
status
type
vdisk_UID
volume_group_id
volume_group_name
volume_id
volume_name

Note: It is not possible to filter the lsvdisk command with mdisk_grp_name=many to identify mirrored volumes. Instead, filter on copy_count=2.

object_id | object_name

(Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | object_name parameter, the concise view of all objects that match the filtering requirements that are specified by the -filtervalue parameter are displayed.

Description

This command displays a concise list or a detailed view of attributes for all volumes and volume copies in the system.

The volume is offline and unavailable if one of the following actions takes place:

Both nodes in the I/O group are missing.
None of the nodes in the I/O group that are present can access the volume.
All synchronized copies for this volume are in storage pools that are offline.
The volume is formatting.

If you have a degraded volume and all of the associated nodes and MDisks are online, refer to your product support information for assistance. A volume is reported as degraded if any of the following occurs:

One of the nodes in the I/O group is missing.
One of the nodes in the I/O group cannot access all the MDisks in the storage pool that the volume spans. In this case, MDisks are shown as degraded and the fix procedures for MDisks must be followed to resolve the problem.
The fast write cache pins data for one or more volumes in the I/O group and is unable to perform a failback until the situation is resolved. An error log indicating that the cache contains pinned data is displayed. Follow the fix procedures for this event log to resolve the problem. The following situations are the most common causes of pinned data:
- One or more volumes in an I/O group is offline due to an asymmetric failure and contains pinned data in the cache. Asymmetric failures can occur because of fabric faults or misconfiguration, back-end controller faults or misconfiguration, or because repeated errors cause the system to exclude access to a MDisk through one or more nodes.
- One or more volumes in an I/O group is offline due to a problem with a FlashCopy mapping.
- A thin-provisioned disk runs out of space.

You can encrypt volumes and volume copies. The volume is encrypted if all volume copies are also encrypted.

Note: This means that during a migration of a volume (with one copy) between an encrypted and unencrypted storage pool the value is no.

The volume is not encrypted if the storage pool has a value of encrypt:no, including if the volume's extents are part of an encrypted MDisk or sequential volume.

The command returns values for the following volume attributes:

IO_groups_id: Indicates the I/O group (ID) that the volume belongs to.
IO_groups_name: Indicates the I/O group (name) that the volume belongs to.
status: Indicates the status. The value can be online, offline, degraded, or deleting.
For onlineHyperSwap volumes the scope of offline copy is included with the status information. For offline volumes the auxiliary copy is included with the status information even if the copy associated with that is online.
mdisk_grp_id: Indicates the ID of the storage pool that the volume belongs to. If the volume has more than one copy, these fields display many.
mdisk_grp_name: Indicates the name of the storage pool that the volume belongs to. If the volume has more than one copy, these fields display many.
type: Indicates the virtualization type of the volume. The value can be striped, seq, image or many. The value many indicates that the volume has more than one copy, which can have different virtualization types.
capacity: Indicates the virtual capacity of the volume that is the size of the volume as seen by the host.
formatted: Indicates whether the volume was formatted when it was created. The value can be yes or no.
formatting: Indicates whether the volume is formatting. The value can be yes or no.
mdisk_id: Indicates the MDisk ID that is used for sequential and image mode volumes. If the volume has more than one copy, these fields display many.
mdisk_name: Indicates the MDisk name that is used for sequential and image mode volumes. If the volume has more than one copy, these fields display many.
FC_id: Indicates the ID of the FlashCopy mapping that the volume belongs to. The value many indicates that the volume belongs to more than one FlashCopy mapping.
FC_name: Indicates the name of the FlashCopy mapping that the volume belongs to. The value many indicates that the volume belongs to more than one FlashCopy mapping.
RC_id: Indicates the ID of the remote copy relationship that the volume belongs to. The value must be numerical.
RC_name: Indicates the name of the remote copy relationship that the volume belongs to.
vdisk_UID: Indicates the UID of the volume. If a volume is mapped to a host using the NVMe protocol, then the vdisk_UID value shows the Namespace Globally Unique Identifier (NGUID) for the volume.
throttle_ID: Indicates the ID for the throttle object. The value is a numeric string in the range 0 - 10241 (or is blank if no throttle is configured).
throttle_name: Indicates the name of the throttle object. The value is an alphanumeric string in the range 1 - 63 characters or blank if no throttle is specified.
IOPs_limit: Indicates the IOPs limit that is configured for the volume. The value is a numeric string or blank if no limit is specified.
bandwidth_limit_MB: Indicates the bandwidth limit configured (in MB) for the volume. The value is a numeric string or is blank if no limit is configured.
preferred_node_id: Indicates the node that processes the I/O data.
Remember: This value must be numeric. (The value is zero if no node is configured in the I/O group that contains the preferred node.)
fast_write_state: Indicates the cache state for the volume or volume copy. The value can be empty, not_empty, corrupt, or repairing. A cache state of corrupt indicates that the volume or volume copy requires repairing or recovery by using either the recovervdisk or repairvdiskcopy command.
cache: Indicates the cache mode of the volume. The value can be readonly, readwrite, or none.
udid: Indicates the unit number for the volume. Only OpenVMS hosts require a unit number.
fc_map_count: Indicates the number of FlashCopy mappings that the volume belongs to.
sync_rate: Indicates the rate for synchronization for mirrored copies.
se_copy_count: Indicates the number of thin-provisioned copies.
Remember: This value represents only thin-provisioned copies and is not used for compressed volume copies.
filesystem: Expressed as a value string (long object name with a maximum of 63 characters), indicates the full name for file system that owns this volume; otherwise, it is blank.
mirror_write_priority: Indicates the mirror write algorithm priority that is used if the volume is mirrored.
RC_change: Indicates whether a volume is a change volume of a remote copy relationship.
compressed_copy_count: Indicates the number of compressed volume copies.
access_IO_group_count: Indicates the number of I/O groups in the volume access set.
protocol: Indicates the protocol that must be used by the hosts that are mapping this volume. The protocol is associated with the volume through existing mappings to hosts. The protocol is inherited from the protocol of the first host the volume is mapped to. If the volume is not mapped to any host, the value is blank. If the volume is unmapped from all hosts, the value becomes blank again. The possible values are scsi, nvme, or blank.

The command returns values for the following volume copy attributes:

copy_id

Indicates a system-assigned identifier for the volume copy. The value can be 0 or 1.

status

Indicates the status. The value can be online, offline, degraded, or deleting.

sync

Indicates whether the volume copy is synchronized.

auto_delete

Indicates that the primary copy is deleted after the secondary copy is synchronized. The values are yes or no.

primary

Indicates whether the volume copy is the primary copy. A volume has exactly one primary copy. The value can be Yes or No.

mdiskgrp_id

Indicates the ID of the storage pool that the volume copy belongs to.

mdiskgrp_name

Indicates the name of the storage pool that the volume copy belongs to.

type

Indicates the virtualization type of the volume. The value can be striped, seq, or image.

mdisk_id

Indicates the MDisk ID that is used for sequential and image mode volumes.

mdisk_name

Indicates the MDisk name that is used for sequential and image mode volumes.

used_capacity

Indicates the portion of real_capacity that is being used to store data. For non-thin-provisioned copies, this value is the same as the volume capacity. If the volume copy is thin-provisioned, the value increases from zero to the real_capacity value as more of the volume is written to. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

real_capacity

Indicates the amount of physical storage that is allocated from a storage pool to this volume copy. If the volume copy is not thin-provisioned, the value is the same as the volume capacity. If the volume copy is thin-provisioned, the value can be different. This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

free_capacity

Indicates the difference between the real_capacity and used_capacity values. This field is blank for storage pools that are not thin-provisioned or compressed volume copies in a data reduction pool.

overallocation

Expressed as a percentage of the volume capacity, indicates the ratio of capacity to real_capacity values. This value is always 100 for non-thin-provisioned or compressed volumes.

Remember:

This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.
This value cannot be blank for compressed volume copies.

This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

autoexpand

Indicates whether autoexpand is enabled on a thin-provisioned volume. The value can be on or off.

Remember: This value cannot be blank for compressed copies.

warning

Expressed as a percentage of the volume capacity, this value indicates a warning for thin-provisioned or compressed volume copies. A warning is generated when the ratio of used_capacity to volume capacity reaches the specified level.

Remember:

This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.
This value cannot be blank for compressed volume copies.

grainsize

For thin-provisioned volume copies, indicates the grain size that is chosen for the volume copy when it was created.

Remember: This value is always blank for compressed volume copies in regular storage pools.

se_copy

Indicates whether the copy is thin-provisioned.

Remember: This value is yes for thin-provisioned copies and no for compressed volume copies.

easy_tier

This value is set by the user and indicates whether Easy Tier is permitted to manage the pool.

Note:

If easy_tier is on, then easy_tier_status can take on any value.
If easy_tier is off, then easy_tier_status is measured or inactive.

easy_tier_status

Indicates which Easy Tier functions are active for the volume copy:

active indicates that a pool is being managed by Easy Tier to provide tier management performance-based pool balancing. For example, extents of this volume copy can be moved for performance (automatic data placement).
inactive indicates that no Easy Tier function is active.
measured indicates that statistics are being gathered for this volume copy, but no extents are moved.
balanced indicates that a pool is being managed by Easy Tier to provide performance-based pool balancing (for example, extents can be moved).

This table displays possible values and related information for easy_tier_status:

Table 1. Easy Tier status values. Easy Tier status values
Storage pool Easy Tier setting	Number of tiers in the storage pool	Volume copy Easy Tier setting	Volume copy Easy Tier status
Off	One	Off	inactive (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__inactive)
Off	One	On	inactive (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__inactive)
Off	Two	Off	inactive (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__inactive)
Off	Two	On	inactive (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__inactive)
Measure	One	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Measure	One	On	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Measure	Two	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Measure	Two	On	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Auto	One	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Auto	One	On	balanced (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__balanced)
Auto	Two	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
Auto	Two	On	(see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__active)
On	One	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
On	One	On	balanced (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__balanced)
On	Two	Off	measured (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__measured)
On	Two	On	active (see note svc_lsvdisk_21pdwu.html#svc_lsvdisk_21pdwu__active)
Notes: When the volume copy status is `inactive`, no Easy Tier functions are enabled for that volume copy. When the volume copy status is `measured`, the Easy Tier function collects usage statistics for the volume but automatic data placement is not active. When the volume copy status is `balanced`, the Easy Tier function enables performance-based pool balancing for that volume copy. When the volume copy status is `active`, the Easy Tier function operates in automatic data placement mode for that volume.

If the volume copy is in image or sequential mode or is being migrated, the volume copy Easy Tier status is measured instead of active.

The default Easy Tier setting for a storage pool is auto, and the default Easy Tier setting for a volume copy is on. This means that Easy Tier functions except pool performance balancing are disabled for storage pools with a single tier, and that automatic data placement mode are enabled for all striped volume copies in a storage pool with two or more tiers.

tier

The tier information being reported:

tier0_flash
tier1_flash
tier_enterprise
tier_nearline

tier_capacity

The total MDisk capacity that is assigned to the volume in the tier.

Note: For thin-provisioned copies, the capacity by tier is the real capacity.

compressed_copy

Indicates whether the volume copy is compressed.

uncompressed_used_capacity

For compressed volume copies, indicates the amount of data written to the volume copy before compression. This field is blank for volume copies in a data reduction storage pool.

used_capacity_before_reduction

Indicates the total amount of data written to a thin-provisioned or compressed volume copy in a data reduction storage pool before data reduction occurs. This field is blank for fully allocated volume copies and volume copies not in a data reduction pool.

block_size

Indicates the volume block sizes.

last_access_time

Indicates the time (YYMMDDHHMMSS) the volume last received Small Computer System Interface (SCSI) commands from any mapped host.

parent_mdisk_grp_id

Indicates the physical storage pool ID that the volume extents are allocated from. This value is a numeric string (in the range 0 - 127 characters) or blank.

parent_mdisk_grp_name

Indicates the physical storage pool name that the volume extents are allocated from. This value is an alphanumeric string (in the range 1 - 63 characters) or blank.

owner_type

Indicates the type of owning component or object (such as a file system). The values are:

filesystem
host_integration_metadata
vvol
none

The value is none if no owner is assigned.

owner_id

Indicates an identification number for the owning object. This value must be a numeric character unless there is no owning object (in which case it is blank).

owner_name

Indicates the name for owning object that owns this volume. The value must be a set of up to 63 alphanumeric characters, but is blank if there is no owning object.

encrypt

Indicates whether all copies of a volume reside in MDisk groups (storage pools) that are reported as encrypting. This means that either one of the following things apply:

The copies reside in a storage pool that has an encryption key.
All MDisks in the group are self-encrypting or encrypted for RAID.

The values are yes and no.

volume_id

Indicates the volume ID (for a high availability volume). This ID must be a numerical value. For a basic volume, the volume ID is the same as the vdisk_UID. For a HyperSwap volume (involved in an active-active relationship), the volume ID is the same as the master volume.

volume_name

Indicates the volume name (for a high availability volume). This value must be an alphanumeric string that contains up to 63 characters. For a basic volume, the volume name is the same as the vdisk_UID. For a HyperSwap volume (involved in an active-active relationship), the volume name is the same as the master volume.

function

Indicates the function of the volume in the remote copy relationship. Remote copy includes Metro Mirror, Global Mirror, and HyperSwap.

The values are:

master, which indicates a master volume in a remote copy relationship.
aux, which indicates an auxiliary volume in a remote copy relationship.
master_change, which indicates a change volume for a master volume in a remote copy relationship.
aux_change, which indicates a change volume for an auxiliary volume in a remote copy relationship.
Blank, which indicates that the volume is not in any remote copy relationship.

volume_group_id

Indicates a volume group ID for a volume group that a volume belongs to. The value must be a number.

volume_group_name

Indicates the volume group name for a volume group that a volume belongs to. The value must be an alphanumeric string.

cloud_backup_enabled

Indicates whether the cloud snapshot feature is enabled for the specified volume. The values are yes or no.

cloud_account_id

Indicates the cloud account ID. The value must be a number.

cloud_account_name

Indicates the cloud account name. The value must be an alphanumeric string.

backup_status

Indicates whether a new cloud snapshot can be started. If a backup is in progress, the status of the backup operation is given. The values are:

off
ready
copying
copying_error
not_ready

last_backup_time

Indicates the time of the most recent backup or snapshot for the specified volume. The value must be in YYMMDDHHMMSS format (or blank).

restore_status

Indicates whether a restore can be performed for the volume. If a restore is in progress, the status of the restore operation is given. The values are:

none
available
restoring
restoring_error
committed
committing
committing_error

backup_grain_size

Indicates the grain size for the volume mappings that are used for the cloud snapshot function. The value is blank if cloud snapshot is not enabled.

Note: This sizing does not reflect the size of the grains that are stored in the cloud (which are fixed at 256 KB).

deduplicated_copy_count

Indicates the number of data deduplicated volume copies.

deduplicated_copy

Indicates whether the volume copy is data deduplicated. The values are:

yes
no