showfbvol

The showfbvol command displays detailed properties for an individual volume. This command can also be used to display the performance metrics of a fixed block volume.


>>-showfbvol--+-------------------------+--+--------+----------->
              '- -dev--storage_image_ID-'  '- -rank-'   

>--+-----------+--+---------------------------+----------------->
   '- -metrics-'  '- -volgrp--volume_group_ID-'   

>--+-volume_ID-+-----------------------------------------------><
   '-" - "-----'

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which consists of the manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the logical volume.

-rank

(Optional) Specifies that a rank extents table be displayed. This table displays the set of ranks that the logical volume has extents configured on and the number of extents for that logical volume.

Note: This parameter cannot be used with the -metrics or -volgrp parameters.

-metrics

(Optional) Displays volume ID and performance metrics for the specified volume.

Notes:

All performance counts are an accumulation since the most recent counter wrap or counter reset. Volume performance counters are reset on a power-up sequence. Volume performance counters are reset by a server failover and failback sequence.
Do not use this parameter with the -rank or -volgrp parameters.

-volgrp volume_group_ID

(Required if you do not specify the volume_ID parameter.) Specifies that the fixed block volumes that are associated with the designated volume group ID be displayed.

Notes:

You can only use the -volgrp parameter when you are doing a query for performance metrics.
Do not use the -volgrp parameter with the volume_ID parameter.
Do not use the -volgrp parameter with the -rank or -metrics parameters.

volume_ID | –

(Required if you do not specify the -volgrp parameter.) Displays information for the specified volume. This parameter accepts a fully qualified volume ID, which consists of the storage_image_ID or a shortened version without the storage image ID, if you specify the -dev parameter. 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).

If you specify the dash (-), this parameter information is automatically supplied. However, you cannot use the dash (-) while you are in the DS CLI interactive command mode.

Note: Do not use the volume_ID parameter with the -volgrp parameter.

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 reports that are associated with the showfbvol command using the -rank parameter. When the rank parameter is specified, a rank extents table is also displayed. It appears at the end of the regular report.

A separate example is not shown for the 1750 because the information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Invoking the showfbvol to show volume properties

Note: The example output is based on using the showfbvol command for a 1.0 (Binary) GB volume.

dscli>showfbvol 
-dev IBM.2107-1300861 -rank 6000

The resulting output

Date/Time: April 13, 2005 2:38:14 PM JST IBM DS CLI Version: 5.0.3.40 DS: IBM.2107-
1300861

Name	ID	acc state	data state	config state	device MTM	data type	addrgrp
My_ volume _6000	6000	Online	Normal	Normal	2107-900	FB 512	6

Rank	Extents
R0	1
R2	2

Report field definitions ( -metrics parameter not specified)

Name

Specifies the nickname that you assigned for this volume object.

ID

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

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

Indicates that the logical volume can be read but not written to 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 conditions has 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

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 changes to Rank repairing if the rank changes 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 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 nonvolatile storage (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 the machine type. The volume MTM 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: This indicates a standard 2107 volume.
1750-500: This indicates a standard 1750 volume.
xxxx-A0x: The xxxx is 2107 or 1750; the A0 indicates a System i protected volume (for example, 2107-A01 or 1750-A07).
xxxx-A8x: 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 values is displayed:

FB 512
FB 520P
FB 520U

Addrgrp

Specifies the address group that contains the designated volume object. An address group ID is one hexadecimal character ( 0 - F ).

Extpool

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

Exts

Specifies the number of extents used by the designated volume ID.

Captype

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

ESS: The capacity unit is 10 ^ 9B.
DS: The capacity unit is 2 ^ 30B.
DS/ESS: The capacity unit is 2 ^ 30B or 10 ^ 9B.
Blocks: The capacity unit 512B.
iSeries: The capacity unit was not specified at volume creation. This fixed block volume was created for iSeries.

Cap (2 ^ 30B)

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

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

Cap (10 ^ 9B)

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

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.

Ranks

Specifies the number of ranks that the volume resides on.

Rank (Rank Extent table)

Specifies the rank ID.

Extents (Rank Extents table)

Specifies the number of extents for the volume on the rank.

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 reports that are associated with the showfbvol command using the -metrics parameter.

Invoking the showfbvol to show performance metrics

dscli>showfbvol -metrics IBM.2107-75FA120/0101

The resulting output

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

ID	Date	norm rdrqts	norm rdhits	norm write req	norm write hits	seq read reqs	seq read hits	seq write req
IBM. 2107- 75FA120 /0101	10/11 /04 02:23:49	10000	10000	10000	10000	10000	10000	10000

seqwrite- hits	cachfwr- reqs	cachfwr- hits	cachfw- reqs	cachfw- hits	inbcach- load	bypass- cach	seq DASD trans
10000	10000	10000	10000	10000	10000	10000	10000

DASD- trans	cache- trans	NVS- spadel	norm write ops	seqwrite- ops	rec cache mis	qwrite- prots	CKDir- trkac
10000	10000	10000	10000	10000	10000	10000	10000

CKD irtrk hits	cachsp- delay	timelow- ifact	phread	phwrite	phwrite	phbyte- read	phbyte- writ
10000	10000	10000	10000	10000	10000	10000	10000

recmo- reads	sfile trk reads	contam- wrts	PPRC- trks	NVS- spallo	time- phread	timeph- write	byte- read
10000	10000	10000	10000	10000	10000	10000	10000

bytewrit	timeread	timewrite
10000	10000	10000

Report field definitions ( -metrics parameter specified)

ID: Specifies the unique identifier that is assigned to this volume object.
Date: Specifies the current time stamp for the volume performance counters.
normrdrqts: Specifies Search/Read Normal I/O Requests.
normrdhits: Specifies Search/Read Normal I/O Requests instances.
normwritereq: Specifies Write Normal I/O Requests.
normwritehits: Specifies DASD Fast Write I/O Request instances.
seqreadreqs: Specifies Search/Read Sequential I/O Requests.
seqreadhits: Specifies Search/Read Sequential I/O Request instances.
seqwritereq: Specifies Write Sequential I/O Requests.
seqwritehits: Specifies DASD Fast Write Sequential I/O Request instances.
cachfwrreqs: Specifies Search/Read Cache Fast Write I/O Requests.
cachfwrhits: Specifies Search/Read Cache Fast Write I/O Request instances.
cachfwreqs: Specifies Cache Fast Write I/O Requests.
cachfwhits: Specifies Cache Fast Write I/O Requests instances.
inbcachload: Specifies Inhibit Cache Loading I/O Requests that operate with DASD.
bypasscach: Specifies Bypass Cache I/O Requests.
seqDASDtrans: Specifies Sequential DASD to Cache Transfer Operations.
DASDtrans: Specifies DASD to Cache Transfer Operation Count.
cachetrans: Specifies Cache to DASD Transfer Operation Count.
NVSspadel: Specifies DASD Fast Write Operations Delayed Due to nonvolatile storage Space Constraints.
normwriteops: Specifies Normal ‘DASD Fast Write’ Write Operation Counts.
seqwriteops: Specifies Sequential Access ‘DASD Fast Write’ Write Operation Counts.
reccachemis: Specifies Number of record cache Read Misses.
qwriteprots: Specifies Quick Write Promotes.
CKDirtrkac: Specifies Irregular Track Accesses.
CKDirtrkhits: Specifies Irregular Track Accesses instances.
cachspdelay: Specifies Operations Delayed Due To Cache Space Constraints.
timelowifact: Specifies Milliseconds of lower interface I/O activity for the indicated device.
phread: Specifies Physical Storage Read Operations.
phwrite: Specifies Physical Storage Write Operations.
phbyteread: Specifies Physical Storage Bytes Read in 128 KB increments.
phbytewrit: Specifies Physical Storage Bytes Written in 128 KB increments.
recmoreads: Specifies Record Mode Read Operations.
sfiletrkreads: Specifies the Number of tracks read from the Concurrent Copy or XRC Sidefile.
contamwrts: Specifies the Number of Contaminating writes for a Concurrent Copy or XRC volume.
PPRCtrks: Specifies the Number of tracks or portion of tracks that were transferred to the secondary device of a PPRC pair.
NVSspallo: Specifies the NVS Space Allocations.
timephread: Specifies the Physical Storage Read Response Time in 16 ms increments.
timephwrite: Specifies the Physical Storage Write Response Time in 16 ms increments.
byteread: Specifies the number of Bytes read in 128 KB increments.
bytewrit: Specifies the number of Bytes written in 128 KB increments.
timeread: Specifies the accumulated response time for all read operations.
timewrite: Specifies the accumulated response time for all write operations.