lsfcmap

Use the lsfcmap command to generate a list that contains concise information about all of the FlashCopy® mappings that are visible to the system, or detailed information for a single FlashCopy mapping.

Syntax

Read syntax diagramSkip visual syntax diagram lsfcmap -showhiddenobject_idobject_name

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
-showhidden
(Optional) Volume group snapshot mappings (snapshot, clone, thinclone and restore) and policy-based replication mappings are system-owned FlashCopy mappings. To display system-owned mappings in the concise view, use the -showhidden parameter.
object_id | object_name
(Optional) Specifies the name or ID of an object.

Description

This command returns a concise list or a detailed view of FlashCopy mappings that are visible to the system.

The following attributes are displayed:
id
Displays the mapping ID.
name
Displays the mapping name.
source_vdisk_id
Displays the source volume ID.
source_vdisk_name
Displays the source volume name.
target_vdisk_id
Displays the target volume ID.
target_vdisk_name
Displays the target volume name.
group_id
Displays the group ID.
group_name
Displays the group name.
status
Displays the status:
  • idle_or_copied
  • preparing
  • prepared
  • copying
  • stopped
  • suspended
  • stopping
progress
Displays the progress. The percentage of the target volume that has its own copy of the data.
copy_rate
Displays the copy rate 0-150, where 50 is 2MB/s, 60 is 4MB/s etc.
start_time
Displays the time that the copy was last started. It is in the format YYMMDDHHMMSS. If a copy is not started, a blank line is displayed.
dependent_mappings
Displays any dependent mappings.
autodelete
Specifies if autodelete is on or off. If on, then the map will automatically delete its self once the progress is 100%, the mappings state is idle_copied and the target volume has no dependent mappings.
clean_progress
Indicates the clean progress. The percentage of the target volume that is not required by a dependent target volume.
clean_rate
Indicates the clean rate, 0-150, where 50 is 2MB/s, 60 is 4MB/s etc.
incremental
Indicates whether incremental is on or off.
difference
Indicates the difference for an incremental mapping by showing the percentage of the source volume that has changed since the mapping was last initiated.
grain_size
Indicates the grain size used by the FlashCopy mappings metadata, can be 64KiB or 256KiB.
IO_group_id
Displays the I/O group ID.
IO_group_name
Displays the I/O group name.
partner_FC_id
Displays the partner FlashCopy ID. The partner is a mapping whose source volume matches this maps target volume and target volume matches this maps source volume.
partner_FC_name
Displays the partner FlashCopy name. The partner is a mapping whose source volume matches this maps target volume and target volume matches this maps source volume.
restoring
Displays the restoring status. The values are yes or no.
rc_controlled (Deprecated)
keep_target
Displays the target and source volume availability. The values are:
  • yes indicates that source volume will be offline if the target volume is offline and the mappings is copying
  • no indicates that if target volume is offline and the mapping is copying, then mapping will be force stopped if copy-on-write operations are prevented by the offline target volume.
restore_progress

Displays the percentage of the source volume that is restored from the target.

fc_controlled

Indicates that the FlashCopy mapping is a cloud tiering mapping that cannot be modified.

owner_id

Indicates the ID of the ownership group.

owner_name

Indicates the name of the ownership group.

size_mismatch

Indicates that the source and target VDisks have different virtual capacity. The value is set to yes or no.

size_capacity

Indicates that size of the source and target at the time the FlashCopy mapping was last started.

is_snapshot

Indicates the FlashCopy mapping is used to maintain a snapshot.

snapshot_id

Indicates the ID of the snapshot associated with the FlashCopy mapping.

type

Indicates the type of the FlashCopy mapping.
  • generic
    Indicates the standard mapping, includes policy-based replication change volume mappings.
    snapshot
    If is_snapshot is yes then volume group snapshot mapping, otherwise a thinclone.
    thinclone

    To display a thinclone mapping, requires the -showhidden to view.

    clone
    If source volume is the target volume group snapshot mappings then its a VGS clone mapping otherwise it is a restore mapping.
    restore
    Indicates the volume group snapshot restore mapping.
    cloud_backup
    Indicates the cloud tiering backup mapping.
    cloud_restore
    Indicates the cloud tiering restore mapping.
    accesspoint
    Indicates the policy-based replication 3-site accesspoint forward mapping.
    accesspoint_restore
    Indicates the policy-based replication 3-site accesspoint reverse mapping.
    reverse_change
    Indicates the policy-based replication change volume reverse mapping.
    forward_change
    Indicates the policy-based replication change volume forward mapping.