lsremoteflash

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


>>-lsremoteflash--+-------------------------+-- -conduit--LSS_ID--+-----+-->
                  '- -dev--storage_image_ID-'                     +- -s-+   
                                                                  '- -l-'   

>--+------------+--+----------+--+-----------+------------------>
   '- -activecp-'  '- -record-'  '- -persist-'   

>--+--------------+--+------+----------------------------------->
   '- -revertible-'  '- -cp-'   

>--+----------------------------------+------------------------->
   '- -state--+-valid---------------+-'   
              +-invalid-------------+     
              +-validation-required-+     
              +-volume-inaccessible-+     
              +-tgt-failed----------+     
              +-not-valid-----------+     
              '-path-unavailable----'     

>--+------------------------------+--+----------------+--------->
   '- -seqnum--flash_sequence_num-'  '- -srcss--SS_ID-'   

>--+-SourceVolumeID:TargetVolumeID--+-------+-+----------------><
   |                                '-. . .-' |   
   '-" - "------------------------------------'

Parameters

Note: All settings apply to all FlashCopy pairs that are specified.

-dev storage_image_ID: (Optional) Specifies the storage image ID, which consists of manufacturer, machine type, and serial number. This parameter is required if you do not specify a fully qualified ID for the source and target volumes or you do not specify a value for the devid variable in your profile file.
-conduit LSS_ID: (Required) Specifies the source logical subsystem (LSS) of an existing Remote Mirror and Copy relationship that is used as a means for communicating with the remote storage image.; The source volume IDs that are specified in the SourceVolumeID:TargetVolumeID parameter must serve as secondary volumes in a Remote Mirror and Copy relationship in which one of the conduit LSS volumes serves as a primary volume.; This parameter accepts a fully qualified LSS ID, which includes the storage image ID. The fully qualified LSS ID format is storage_image_ID/XX, where XX is a hexadecimal number in the range 00 - 1F (1750 only).
-s: (Optional) Specifies that FlashCopy pair IDs be displayed. You cannot use the -l and the -s parameters together.
-l: (Optional) Specifies that the default detailed output plus Out-of-Sync Tracks and Date Created information be displayed. You cannot use the -l and the -s parameters together.
-activecp: (Optional) Specifies that FlashCopy relationships where their background copy process is active be displayed.
-record: (Optional) Specifies that the FlashCopy relationships that were established with the -record parameter be displayed.
-persist: (Optional) Specifies that the FlashCopy relationships that were established with the -persist parameter be displayed.
-revertible: (Optional) Specifies that the FlashCopy relationships that were established with the -revertible parameter be displayed.
-cp: (Optional) Specifies that the FlashCopy relationships that were established with the run background copy (-cp) parameter be displayed.
-state valid | invalid | validation-required | volume-inaccessible | tgt-failed | not-valid | path-unavailable: (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 of the valid state are displayed.
-seqnum flash_sequence_number: (Optional) Specifies that the FlashCopy relationships that are associated with the specified sequence number be displayed.; This parameter is not supported for machine type 2105.
-srcss SS_ID: (Optional) Specifies the subsystem ID of the source logical subsystem at the remote site. The ID is in the format 0x0001 - 0xFFFF.; This value is required for the IBM System Storage™ Enterprise Storage Server versions 2.4.0 and 2.4.1. When you specify SS_IDs, the source volumes are restricted to one LSS.; Example: FF10
SourceVolumeID:TargetVolumeID . . . | -: (Required) Specifies that the FlashCopy relationships for the source and target volume pairs with the specified IDs be displayed.; This parameter accepts fully qualified volume IDs, which includes storage image IDs, or a shortened version without storage image IDs if the -dev parameter is specified.; 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.; You must 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 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 (for 1750) , and ZZ is the volume number (00 - FF).; If you specify the dash (-), this parameter information is automatically supplied.; Example of a fully qualified volume ID pair: IBM.1750-75FA120/0001:IBM.1750-68FA120/0004; Example of a shortened version: 0001:0004; Example of multiple pairs: 0001:0004 0003:00FF 0008:000C

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 lsremoteflash command using the -l parameter. A separate example is not shown for the 1750 as the information is the same for both. The only difference is the machine type designation, 2107 versus 1750.

Invoking the lsremoteflash command

dscli>lsremoteflash -l -dev IBM.2107-75FA120 
-conduit IBM.2107-75FA150/10 IBM.2107-75FA120/0100:IBM.2107-75FA120/0200

The resulting output

Date/Time: Sun Jan 09 02:23:49 PST 2005 DS CLI Version: 5.0.0.0 
 DS: IBM.2107-75FA120

ID	SrcLSS	Sequence Num	Active Copy	Recording	Persistent	Revertible
0100:0200	01	10	Disabled	Disabled	Disabled	Disabled

Source- Write- Enabled	Target- Write- Enabled	Back- ground- Copy	Copy- Indic- ator	OutOf- Sync- Tracks	Date- Created	Date- Synced	State
Enabled	Disabled	Disabled	Yes	0	12/01 /2003 02:20:00	12/01 /2003 02:23:47	Valid

Report field definitions

ID

Specifies the FlashCopy pair ID. The FlashCopy pair ID consists of two volume IDs. One is designated as the source and the other is the target volume for a FlashCopy relationship.

SrcLSS

Specifies the logical subsystem ID.

Sequence Num

Specifies the sequence number that is associated with the FlashCopy relationship.

ActiveCopy

Specifies (enabled or disabled) whether the background copy is active on the specified FlashCopy pair.

Recording

Specifies (enabled or disabled) whether the designated FlashCopy pair is established with recording activated.

Persistent

Specifies (enabled or disabled) whether the designated FlashCopy pair is established with persistent activated.

Revertible

Specifies (enabled or disabled) whether the designated FlashCopy pair is established with the revertible option activated.

SourceWriteEnabled

Specifies (enabled or disabled) whether or not 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

Background Copy

Specifies (enabled or disabled) whether this FlashCopy relationship was established with the Run Background Copy option.

OutofSync Tracks

Specifies the number of tracks that are not synchronized for this FlashCopy relationship.

DateCreated

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

DateSynced

Specifies the date and the time that 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 has occurred when the query is processed.
Path Unavailable: The specified inband path does not exist. The user should verify that the Remote Mirror and Copy pair exists.