The lsflash command displays a list of FlashCopy relationships and status information for each FlashCopy relationship in the list.
>>-lsflash--+-------------------------+--+-----+----------------> '- -dev--storage_image_ID-' +- -s-+ '- -l-' >--+------------+--+----------+--+-----------+------------------> '- -activecp-' '- -record-' '- -persist-' >--+--------------+--+------+-----------------------------------> '- -revertible-' '- -cp-' >--+----------------------------------+-------------------------> '- -state--+-valid---------------+-' +-invalid-------------+ +-validation-required-+ +-volume-inaccessible-+ +-tgt-failed----------+ '-not-valid-----------' >--+------------------------------+-----------------------------> '- -seqnum--flash_sequence_num-' >--+---source_volume_ID:target_volume_ID----+-------+-+-------->< | '-. . .-' | '-" - "--------------------------------------------'
Parameters
- -dev storage_image_ID
- (Optional) Specifies the storage image ID, which includes manufacturer, type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes and you do not specify a value for the devid variable in your profile file.
- -s
- (Optional) Displays FlashCopy pair IDs. You cannot use the -l and the -s parameters together.
- -l
- (Optional) Displays the default output plus copy indicator, out of sync tracks, date created, and date synchronized. You cannot use the -l and the -s 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.
- -record
- (Optional) Displays the FlashCopy relationships that were established with the -record parameter.
- -persist
- (Optional) Displays the FlashCopy relationships that were established with the -persist parameter.
- -revertible
- (Optional) Displays the FlashCopy relationships that were established with the -revertible parameter.
- -cp
- (Optional) Displays the FlashCopy relationships that were established with the -cp parameter.
- -state valid | invalid | validation-required | volume-inaccessible | tgt-failed | not-valid
- (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 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.
- source_volume_ID:target_volume_ID | source_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 source volume ID is specified.
Example
For this command and all other DS CLI list 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 report that is associated with the lsflash command using the -l parameter. 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 lsflash command
dscli>lsflash -dev IBM.2107-75FA120 -l 0100:0200 0101:0201 0102:0202 0103:0203
The resulting output
Date/Time: Sun Aug 11 02:23:49 PST 2004 DS CLI Version: 5.0.0.0 DS: IBM.2107-75FA120
| ID | SrcLSS | Sequen- |
Time- |
Active |
Record- |
Persis- |
Revert- |
|---|---|---|---|---|---|---|---|
| 0100:0200 | 01 | 10 | 120 | Disabled | Disabled | Disabled | Disabled |
| 0101:0201 | 01 | 10 | 120 | Disabled | Disabled | Disabled | Disabled |
| 0102:0202 | 01 | 11 | 120 | Disabled | Disabled | Disabled | Disabled |
| 0103:0203 | 01 | 11 | 120 | Disabled | Disabled | Disabled | Disabled |
Source- |
Target- |
Back- |
Copy- |
OutOf- |
Date- |
Date- |
State |
|---|---|---|---|---|---|---|---|
| Enabled | Disabled | Disabled | Yes | 0 | 12/01 |
12/01 |
Valid |
| Enabled | Disabled | Disabled | Yes | 0 | 12/01 |
12/01 |
Valid |
| Enabled | Disabled | Disabled | Yes | 0 | 12/01 |
12/01 |
Valid |
| Enabled | Disabled | Disabled | Yes | 0 | 12/01 |
12/01 |
Valid |
Report field definitions
- ID
- Specifies the FlashCopy pair ID. This ID consists of two volume IDs, one designated as the source and the other as the target volume for a FlashCopy relationship.
- SrcLSS
- Specifies the Consistency Group LSS ID that is associated with the source volume of this FlashCopy relationship.
- Sequence Num
- Specifies the sequence number that is associated with the FlashCopy relationship. Note: This item is not supported on the 2105.
- Timeout (secs)
- Specifies the consistency group Long Busy Timeout setting for the LSS ID that is associated with the source volume of this FlashCopy relationship. You can specify a value in the range of 1 - 600 000. The default value is 120 seconds.
- ActiveCopy
- Specifies (Enabled or Disabled) whether the background copy process is active for this FlashCopy relationship.
- Recording
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the record changes option.
- Persistent
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the persistent option.
- Revertible
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the revertible option.
- SourceWriteEnabled
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the allow source writes option.
- TargetWriteEnabled
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the allow target writes option.
- BackgroundCopy
- Specifies (Enabled or Disabled) whether this FlashCopy relationship was established with the run background copy option.
- CopyIndicator
- Specifies (Yes or No) whether the CopyIndicator is set for this FlashCopy relationship.
- OutOfSyncTracks
- Specifies 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.
- DateCreated
- Specifies the date and the time that the FlashCopy relationship was established.
- DateSynced
- Specifies the date and time this FlashCopy relationship was synchronized, or null (-) if the relationship is not synchronized.
- State
- Specifies 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 null (-) value.
- Valid
- Indicates that the FlashCopy relationship is in a normal state, and that it has been queried successfully.
- Validation Required
- Indicates that the FlashCopy relationship cannot be queried. Generally, 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
- Indicates that 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
- Indicates that 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
- Indicates that a general internal error occurred when the query was processed.