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
lsfcmap [ -filtervalueattribute=value ] [ -nohdr ] [ -delimdelimiter ] [ -filtervalue? ] [ { object_id | object_name } ]
Parameters
- -filtervalueattribute=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
Lenovo Storage V series CLI:
- -filtervalue?
- (Optional) Displays the valid filter attributes for the
-filtervalueattribute=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
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.
- 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.
Note: Using rc_controlled indicates that the map is for internal
use only. It cannot be manipulated externally.
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:no
A detailed invocation example
lsfcmap 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
rc_controlled:no
keep_target:yesrestore_progress: