lsfcconsistgrp

Edit online

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.

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

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

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