lsfcconsistgrp
Use the lsfcconsistgrp command to display a concise list or a detailed view of FlashCopy® consistency groups that are visible to the system. This information is useful for tracking FlashCopy consistency groups.
The list report style can be used to obtain two styles of report:
- A list that contains concise information about all of the FlashCopy consistency groups on a system. (Each entry in the list corresponds to a single FlashCopy consistency group.)
- The detailed information about a single FlashCopy consistency group.
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 returned.
- -nohdr
- (Optional) By default, headings are displayed for each item of data in a concise view. The
-nohdr parameter suppresses the display of these headings. Detailed view is not
valid for this command.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, the headers are displayed, and the data is separated from the header by a space.
The -delim parameter overrides this behavior. Valid input for the
-delim parameter is a o1-byte character. If you enter
-delim :
on the command line, the colon character (:
) separates all items of data in a concise view; 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 returns an error message. 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.
- -filtervalue?
- (Optional) Displays the list of valid filter attributes in the report. The valid filter
attributes for the lsfcconsistgrp command are:
- name
- id
- status
- FC_group_id
- owner_name
- owner_id
Description
This command returns a concise list or a detailed view of FlashCopy consistency groups that are visible to the system.
The following list provides values of the status attribute that are
displayed as data in the output views:
- status
- Indicates the status. The values are:
-
idle_or_copied
-
preparing
-
prepared
-
copying
-
stopped
-
suspended
-
stopping
- Empty
-
- id
- Indicates the mapping ID.
- name
- Indicates the mapping name.
- start_time
- Indicates the time that the group was started in
YYMMDDHHMMSS
format (or blank). - autodelete
- Indicates whether auto deletion is
on
oroff
. - FC_mapping_id
- Indicates the FlashCopy mapping ID.
- FC_mapping_name
- Indicates the FlashCopy mapping name.
- size_mismatch
- Indicate one or more of the FlashCopy mappings in the group that has size mismatching. The value is set to yes or no.
A concise invocation example
lsfcconsistgrp -delim :
The concise resulting output:
id:name:status:start_time
1:ffccg0:empty:060627083237
2:ffccg1:idle_or_copied:060627083337
3:ffccg2:idle_or_copied:060627083437
A detailed invocation example
lsfcconsistgrp -delim : 1
The detailed resulting output:
id:1
name:ffccg0
status:empty
A detailed invocation example
lsfcconsistgrp -delim : fccstgrp0
The detailed resulting output:
id:1
name:FCcgrp0
status:idle_or_copied
start_time:060627083137
autodelete:off
FC_mapping_id:0
FC_mapping_name:fcmap0
FC_mapping_id:1
FC_mapping_name:fcmap1
A concise invocation example with size_mismatch
lsfcconsistgrp -delim :
The concise resulting output:
id:name:status:start_time:owner_id:owner_name:size_mismatch
1:ffccg0:empty:060627083237:::no
2:ffccg1:idle_or_copied:060627083337:::no
3:ffccg2:idle_or_copied:060627083437:::yes