lsflash

Edit online

The lsflash command displays a list of FlashCopy® relationships and status information for each FlashCopy relationship in the list.

Parameters

-dev storage_image_ID

(Optional) The storage image ID consists of the manufacturer name, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified ID for the source and target volumes, 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 FlashCopy pair IDs. You cannot use the -s and the -l parameters together.

-l

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

-activecp

(Optional) Displays the FlashCopy relationships where their background copy process is active.

Note: The background copy process might be inactive for a while before it starts.

-dataset

(Optional) Displays the volumes that are participating in Dataset FlashCopy relationships.

-record

(Optional) Displays only the FlashCopy relationships that were established with the –record or -multinc option.

-persist

(Optional) Displays the FlashCopy relationships that were established with the -persist parameter and will remain until the FlashCopy relationships until they are removed.

-revertible

(Optional) Displays the FlashCopy relationships that were established with the -revertible parameter. This parameter determines whether data committed to the target volume forms a new consistency group or reverts to the last consistency group.

-cp

(Optional) Displays the FlashCopy relationships that were established with the -cp parameter.

-tgtse

(Optional) Displays the FlashCopy relationships that have a space-efficient target.

(Optional) Displays the FlashCopy relationships that are identified by the specific state.

Note: When you specify not-valid, all FlashCopy relationships that do not meet the requirements for the valid state are displayed.

-seqnum flash_sequence_number

(Optional) Displays the FlashCopy relationships that are associated with the specified sequence number. The default is 0000.

-retry count[,interval]

(Optional) Displays the number of retries that the system uses to process a validation-required state.

The system currently handles a validation-required state as follows:

If there are one or more FlashCopy relationships, an immediate retry is initiated. In most cases, the reasons for the validation-required state are cleared by the time that the retry is processed and normal processing continues.
If the validation-required state still exists after the first retry, the system initiates five wait and retry cycles with a delay of 5 seconds between each cycle. At any time during these cycles, if the reasons for the validation-required state are cleared, normal processing continues.

You can change how the system handles a validation-required state as follows:

Set the number of retries (count) to 0. When you set the number of retries to 0, it prevents the system from attempting any retries.
Set the number of retries to 1. The system performs an immediate retry if there are one or more FlashCopy relationships in the validation-required state. The 5-second delay is not initiated.
Set the number of retries to N, with N greater than 1. The system performs an immediate retry if there are one or more FlashCopy relationships in the validation-required state, followed by at least one wait and retry loop. The default for N is 6. You can change the length of the 5-second default wait delay using the optional interval value.

source_volume_ID:target_volume_ID | volume_ID ... | -

(Required) Displays the FlashCopy relationships for the source and target volume pairs with the specified IDs, or displays the FlashCopy relationships for a single volume ID if the volume ID is specified.

This parameter accepts fully qualified volume IDs, which includes the storage image IDs, or a shortened version without storage image IDs, if the -dev parameter is specified or you can specify a value for the devid variable in your profile file.

A FlashCopy pair ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. You must separate the two volume IDs of a FlashCopy pair ID with a colon and no space. The first volume ID is the source volume. The second volume ID is the target volume.

The volume ID is a 32-bit number that can be represented as four hexadecimal digits in the form of XYZZ, where:

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

Separate multiple IDs with spaces. You can specify FlashCopy pair IDs and a range of FlashCopy pair IDs, or you can specify volume IDs and a range of volume IDs. You cannot specify a combination of FlashCopy pair IDs and volumes 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: Displaying a list of FlashCopy relationships and status information for each FlashCopy relationship

dscli> lsflash -dev IBM.2107-75FA120 -l 0100:0200 0101:0201 0102:0202 0103:0203

Output

ID	SrcLSS	SequenceNum	Time-out	Active Copy	Recording	Persistent	Revertible
0100:0200	01	10	60	Disabled	Disabled	Disabled	Disabled
0101:0201	01	10	60	Disabled	Disabled	Disabled	Disabled
0102:0202	01	11	60	Disabled	Disabled	Disabled	Disabled
0103:0203	01	11	60	Disabled	Disabled	Disabled	Disabled

Source- Write- Enabled	Target- Write- Enabled	Back- ground- Copy	SGC Recovered	Date- Created	Date- Synced	State	is- TgtSE
Enabled	Disabled	Disabled	Yes	10/01 /2007 02:20:00	10/01 /2007 02:23:47	Valid	TSE
Enabled	Disabled	Disabled	No	10/01 /2007 02:20:00	10/01 /2007 02:23:47	Valid	TSE
Enabled	Disabled	Disabled	Yes	10/01 /2007 02:20:00	10/01 /2007 02:23:47	Valid	ESE
Enabled	Disabled	Disabled	No	10/01 /2007 02:20:00	10/01 /2007 02:23:47	Valid	ESE

Output definitions

ID

The FlashCopy pair ID, which consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship. For dataset FlashCopy relationships, the source volume ID is the same as the target volume ID, which indicates that this volume is participating as a source or a target in a dataset FlashCopy relationship.

SrcLSS

The Consistency Group LSS ID that is associated with the source volume of this FlashCopy relationship.

SequenceNum

The sequence number that is associated with the FlashCopy relationship.

Note: This item is not supported on the 2105.

Timeout

The consistency group Long Busy Timeout setting for the LSS ID that is associated with the source volume of this FlashCopy relationship. This value can be modified using the chlss (FB) or the chlcu (CKD) command.

ActiveCopy

The background copy process is active for this FlashCopy relationship.

Recording

The FlashCopy relationship was created with one of the change recording options. One of the following values is displayed for each FlashCopy relationship:

Table 1. Change recording options
Option	Description
Disabled	The relationship was created without any of the change recording parameters.
Enabled	A type 1 relationship that was created with the –record parameter but without the -multinc parameter.
MultInc	A type 2 relationship that was created with the –record and –multinc parameters or with the –multinc parameter, but without – record parameter.

Persistent

The FlashCopy relationship was established with the persistent option and will remain until it is removed.

Revertible

The FlashCopy relationship was established to allow the FlashCopy relationship target volume to be reverted to the last consistency group.

SourceWriteEnabled

The FlashCopy relationship was established to allow source writes.

TargetWriteEnabled

The FlashCopy relationship was established to allow target writes.

BackgroundCopy

The FlashCopy relationship was established with the run background copy option.

SGCRecovered

The SGCRecovered field indicates whether the volume is in a Safeguarded recovery relationship or not.

OutOfSyncTracks

The number of tracks that are not synchronized for this FlashCopy relationship. The maximum value that can be displayed is dependent on the source volume size. A dash (-) is displayed when the track counter is not available.

DateCreated

The date and the time that the FlashCopy relationship was established.

DateSynced

The date and time that FlashCopy relationship was synchronized, or specifies " - " if the relationship is not synchronized.

State

The state of the FlashCopy relationships. One of the following values is displayed for each FlashCopy relationship:

Note: When a query indicates any state other than valid, the only information that is displayed on the report is the FlashCopy pair ID and the state condition. The rest of the information columns are displayed with a " - " value.

Valid: The FlashCopy relationship is in a normal state, and that it has been queried successfully.
Validation Required: The FlashCopy relationship cannot be queried. The reason that the query is blocked is only temporary. If you issue a new query within several seconds, the problem no longer exists.
Tgt Failed: The FlashCopy relationship is in an error state. The point-in-time copy is lost, and the FlashCopy relationship must be withdrawn. You must issue the rmflash command to remove the FlashCopy relationship.
Volume Inaccessible: The volume cannot be accessed and that the query has failed. When this state is displayed, it generally means that the volume is in a fenced condition.
Invalid: A general internal error occurred when the query was processed.
Dataset: The source volume is participating as a source or a target in a dataset, or extent level, FlashCopy relationship.

Note: For dataset FlashCopy relationships, a dash (-) will be listed for all of the fields except the ID and the State.

isTgtSE

The FlashCopy relationship has a space-efficient target. Valid options include:

No: The target is not space-efficient.
TSE: The target is a track space-efficient volume.
ESE: The target is an extent space-efficient (ESE) volume. ESE volumes are used for thin provisioning.
Unknown: The space allocation method of the target is not known.