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

Parameters

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

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the IBM Spectrum Virtualize for Public Cloud CLI:

The wildcard character is the asterisk (*).
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""), as follows:
```
lsfcmap -filtervalue "name=md*"
```

-filtervalue?

(Optional) Displays the valid filter attributes for the -filtervalue attribute=value parameter:

name
id
source_vdisk_id
source_vdisk_name
target_vdisk_id
target_vdisk_name
group_name
group_id
status
copy_rate
FC_mapping_name
FC_id
partner_FC_id
partner_FC_name
restoring
is_snapshot
snapshot_id

For more information about filtering attributes, see Attributes of the -filtervalue parameters.

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The nohdr parameter suppresses the display of these headings.

Note: If there is no data to be displayed, headings are not displayed.

-delim delimiter

(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed the data is separated from the header by a space. The delim parameter overrides this behavior. Valid input for the delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-showhidden

(Optional) Specifies that FlashCopy maps used for snapshots and system-owned maps are displayed.

object_id | object_name

(Optional) Specifies the name or ID of an object. When you use this parameter, the detailed view of the specific object is returned and any value that is specified by the filtervalue parameter is ignored. If you do not specify the object_ID or object_name parameter, the concise view of all objects that match the filtering requirements that are specified by the filtervalue parameter are displayed.

Description

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

The following list shows attribute values that can be displayed as output view data:

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.

copy_rate

Displays the copy rate.

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.

clean_progress

Indicates the clean progress.

clean_rate

Indicates the clean rate.

incremental

Indicates whether incremental is on or off.

difference

Indicates the difference.

IO_group

Displays the I/O group ID.

IO_group_name

Displays the I/O group name.

partner_FC_id

Displays the partner FlashCopy ID.

partner_FC_name

Displays the partner FlashCopy name.

restoring

Displays the restoring status. The values are yes or no.

rc_controlled

Displays the rc_controlled status.

copy_rate_mb

Displays the copy rate MB amount.

clean_rate_mb

Displays the clean rate MB amount.

keep_target

Displays the target and source volume availability. The values are:

yes indicates that the source volume availability is connected to the availability of the target volume.
no indicates that if there is a problem with the target volume that can impact FlashCopy operations, the target volume is removed.

restore_progress

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

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.

start_capacity

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

Note: Using rc_controlled indicates that the map is for internal use only. It cannot be manipulated externally.

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.

Note: Use the detailed view of the command to view system-owned FlashCopy mappings that are used in policy-based replication. To display system-owned mappings in the concise view, use the -showhidden parameter.

A concise invocation example

lsfcmap -delim :

The concise resulting output:

id name source_vdisk_id:source_vdisk_name:target_vdisk_id:target_vdisk_name:group_id 
   group_name:status:progress:copy_rate:clean_progress:incremental:partner_FC_id:
   partner_FC_name:restoring:start_time:rc_controlled
0:test:0:vdisk0:1:vdisk1:idle_or_copied:0:50:100:off:no
no0:fcmap0:0:vdisk0:1:vdisk1:0:fccstgrp0:idle_or_copied:0:50:0:on:2:fcmap2:no
1:fcmap1:2:vdisk2:3:vdisk3:0:fccstgrp0:idle_or_copied:0:0:100:off:::no
2:fcmap2:1:vdisk1:0:vdisk0:0:fccstgrp1:idle_or_copied:0:0:100:off:0:fcmap0:noowner_id:0:owner_name:tenantA