showckdvol

The showckdvol command displays detailed properties of an individual count key data volume. This command can also be used to display the performance metrics for an individual volume ID.


>>-showckdvol--+-------------------------+--+--------+---------->
               '- -dev--storage_image_ID-'  '- -rank-'   

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

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

Parameters

Note: All performance counts are an accumulation from the most recent counter wrap or counter reset. A reset of the volume performance counters occurs in association with the following events:

The storage unit is turned on.
There has been a server failure and the server failover or failback sequence has been initiated.

-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 the volume ID and performance metrics for the specified volume.

Note:

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 CKD volumes that are associated with the designated volume group ID be displayed. There is only one volume group for CKD volumes and it contains all volumes.

Notes:

The -volgrp parameter can only be used 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 when 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.

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 showckdvol 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 machine types. The only difference is the machine type designations 2107 versus 1750.

Invoking the showckdvol to show volume properties

Note: The following example is based on the use of the showckdvol command for a 3390 volume with 3339 cylinders.

dscli>showckdvol -dev 
IBM.2107-1300861 -rank 1410

The resulting output

Date/Time: April 13, 2005 3:44:27 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-3	A03967	3390

voltype	orgb- vols	addrgrp	extpool	exts	cap (cyl)	cap (2^30B)	cap (10^9B)	Ranks
CKD Base	–	1	P2	3	3339	2.6	2.8	3

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

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 designations can be 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 will be displayed:

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

Volser

Specifies the volume serial number. A volume serial number is six bytes of data, displayed as six characters.

Datatype

Specifies the volume data type setting (3380 or 3390).

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 share a common LCU ID.
- (null) is displayed for a CKD base volume type.

Addrgrp

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

Extpool

Specifies the extent pool ID.

Exts

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

Cap (cyl)

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

Cap (2^30B)

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

Cap (10^9B)

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

Ranks

Specifies the number of ranks 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 showckdvol command using the -metrics parameter.

Invoking the showckdvol to show performance metrics

dscli>showckdvol -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	timeph- read	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 the number of normal read operations issued by a host to a volume.
normrdhits: Specifies the number of normal read operations where data did not move to or from a storage device.
normwritereq: Specifies Write Normal I/O Requests
normwritehits: Specifies DASD Fast Write I/O Request Hits
seqreadreqs: Specifies Search/Read Sequential I/O Requests
seqreadhits: Specifies Search/Read Sequential I/O Request Hits
seqwritereq: Specifies Write Sequential I/O Requests
seqwritehits: Specifies DASD Fast Write Sequential I/O Request Hits
cachfwrreqs: Specifies Search/Read Cache Fast Write I/O Requests
cachfwrhits: Specifies Search/Read Cache Fast Write I/O Request Hits
cachfwreqs: Specifies Cache Fast Write I/O Requests
cachfwhits: Specifies Cache Fast Write I/O Requests Hits
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 Hits
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.