lsfcmap

The lsfcmap command generates a list containing concise information about all of the FlashCopy® mappings that are visible to the cluster, or detailed information for a single FlashCopy mapping.

Syntax


>>- svcinfo -- -- lsfcmap -- ----------------------------------->

>--+-----------------------------------+-- --+----------+-- ---->
   '- -filtervalue -- attribute=value -'     '- -nohdr -'      

>--+-----------------------+-- -- --+-----------------+--------->
   '- -delim -- delimiter -'        '- -filtervalue? -'   

>--+---------------+-------------------------------------------><
   +- object_id ---+   
   '- object_name -'

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 SAN Volume Controller CLI:

The wildcard character is the asterisk (*), which must be used as the first or last character in the string.
The command can contain a maximum of one wildcard.
When you use a wildcard, enclose the filter entry within double quotation marks (""), as follows:
```
svcinfo 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

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

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 matching the filtering requirements that is 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 cluster.

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

status: idle_or_copied, preparing, prepared, copying, stopped, suspended or stopping
start_time: Displays the time that the copy was last started. It is in the format YYMMDDHHMMSS. If a copy has not been started, a blank line is displayed.

A concise invocation example

svcinfo 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
0: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:no

A detailed invocation example

svcinfo lsfcmap -delim : 0

The detailed resulting output

id:0
name:fcmap0
source_vdisk_id:63
source_vdisk_name:vdisk63
target_vdisk_id:57
target_vdisk_name:vdisk57
group_id:
group_name:
status:idle_or_copied
progress:0
copy_rate:0
start_time:
dependent_mappings:0
autodelete:off
clean_progress:100
clean_rate:50
incremental:off
difference:100
grain_size:256
IO_group_id:1
IO_group_name:io_grp1
partner_FC_id:
partner_FC_name:
restoring:no