lsfcconsistgrp

Use the lsfcconsistgrp command to display a concise list or a detailed view of FlashCopy consistency groups that are visible to the clustered system (system). This information is useful for tracking FlashCopy consistency groups.

The list report style can be used to obtain two styles of report:

Syntax

 lsfcconsistgrp    [  -filtervalue  attribute=value  ]   [  -nohdr  ]   [  -delim  delimiter  ]     [  -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 returned.
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 Storwize V5000 CLI:
  • The wildcard character is an asterisk character (*).
  • The command can contain a maximum of one wildcard, which must be the first or last character in the string.
  • When you use a wildcard, surround the filter entry with double quotation marks (""), as follows:
    lsfcconsistgrp -filtervalue "name=md*"
-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.
-delimdelimiter
(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

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 or off.
FC_mapping_id
Indicates the FlashCopy mapping ID.
FC_mapping_name
Indicates the FlashCopy mapping name.

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