lsrcconsistgrp

Use the lsrcconsistgrp command to return a concise list or a detailed view of remote copy consistency groups such as Metro Mirror, Global Mirror, or active-active consistency groups visible to the system.

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 displayed. If a capacity is specified, the units must also be included.

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 IBM Spectrum Virtualize command line interface (CLI):

The wildcard character is an asterisk (*).
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, you must enclose the filter entry with double quotation marks (""), as follows:
```
lsrcconsistgrp -filtervalue "name=md*"
```

-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 displayed and any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id | 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) Specifies that you want your report to display any or all of the list of valid filter attributes. The following filter attributes for the lsrcconsistgrp command are valid:

group_id
name
master_cluster_id
master_cluster_name
aux_cluster_id
aux_cluster_name
primary
state
relationship_count
id
copy_type

For more information about filtering attributes, see Attributes of the -filtervalue parameters.

Description

This command returns a concise list or a detailed view of remote copy consistency groups such as Global Mirror, Metro Mirror, or active-active consistency groups that are visible to the system.

This table provides possible values for the attributes that are displayed as data in the output views.

Table 1. lsrcconsistgrp command output values
Attribute	Value
primary	Indicates which volumes have the primary role. A primary volume is accessible for write I/O. A secondary volume is not available for write I/O. The direction of copying is from primary to secondary. The values are `master`, `aux`, or `blank`.
state	Indicates the state. The values are: `consistent_copying` `inconsistent_stopped` `inconsistent_copying` `consistent_stopped` `consistent_synchronized` `idling` `idling_disconnected` `inconsistent_disconnected` `consistent_disconnected` empty
cycle_period_seconds	Indicates the minimum period in seconds between multiple cycles. The value is a number (integer) in a range in the range 60 - 86400. The default value is 300.
previous_primary	For Global Mirror, Metro Mirror, and GMCV relationships whose state is idling, this field indicates the previous primary volume for the group. For these types of groups, when the state is not idling, the field is blank. For active-active groups that are part of a HyperSwap group, this field is not used and is blank. The valid values are blank, master, or aux.
cycling_mode	Indicates the type of Global Mirror, Metro Mirror, or `active-active` cycling to use: `none` (default) or `multi`
freeze_time	Indicates the time in `YYMMDDHHMM` format
status	Indicates the relationship status. The values are: `online`, which indicates that the relationship is online and accessible. If the relationship state is `ConsistentSynchronized`, `ConsistentCopying`, or `InconsistentCopying` the volumes replicate host I/O operations that the primary volume receives. `primary_offline`, which indicates that the primary volume in the relationship is offline. This prevents extra I/O operations, and synchronization pauses until the primary volume is online again. `secondary_offline`, which indicates that the secondary volume in the relationship is offline. For r Global Mirror relationships in a `ConsistentSynchronized` state (no change volumes) and Metro Mirror relationships, extra I/O write operations to the primary volume terminate the relationship. `io_channel_offline`, which indicates that the remote system is not accessible. For Global Mirror relationships in a `ConsistentSynchronized` state (no change volumes) and Metro Mirror relationships, extra I/O write operations to the primary volume terminate the relationship. `primary_change_offline`, which indicates that the primary change volume in the relationship is offline. For Global Mirror with change volume relationships, the current I/O cycle ends, and a new I/O cycle begins when the primary change volume is online again. `secondary_change_offline`, which indicates that the secondary change volume in the relationship is offline. For Global Mirror with change volume relationships, the current I/O cycle pauses and a new I/O cycle resumes when the secondary volume is online again. `change_volumes_needed`, indicates an `active-active` relationship that is in a HyperSwap® volume or Global Mirror volume with a change volume relationship. Additionally, at least one change volume is not configured.
sync	Indicates whether a consistent stopped or idling consistency group is still synchronized. The values are `in_sync`, `out_of_sync`, or `blank`. The sync attribute has a value of `in_sync` when the contents are synchronized (identical) between volumes. If write operations take place on either the primary or secondary volume after a consistent (stopped) or idling state occurs, they will no longer be synchronized.
copy_type	Indicates the copy type. The values are: `metro` `global` `activeactive` blank

Note: The names of the Global Mirror or Metro Mirror relationships and consistency groups might be blank if the relationship or consistency groups are intersystem and the system partnership is disconnected.

A concise invocation example

lsrcconsistgrp -delim :

The concise resulting output:

id:name:master_cluster_id:master_cluster_name:aux_cluster_id:aux_cluster_name:
primary:state:relationship_count:copy_type:cycling_mode:freeze_time

 248:jdemo_BA_cons1:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
consistent_stopped:2:global:none:06/06/27/08/31/37
 249:rccstgrp0:0000020061413ABA:clusterA:0000020061413ABA:clusterA::empty:0
:empty_group
 250:jdemo_BA_cons2:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
inconsistent_stopped:1:metro:none:06/06/27/08/31/37
 251:BA_cons1:0000020060406746:clusterB:0000020061413ABA:clusterA:master:
consistent_stopped:4:metro:none:06/06/27/08/31/37
 252:AB_cons2:0000020061413ABA:clusterA:0000020060406746:clusterB::empty:0
:empty_group:none:06/06/27/08/31/37
 253:AB_cons1:0000020061413ABA:clusterA:0000020060406746:clusterB:aux:
consistent_stopped:3:global:none:06/06/27/08/31/37
 254:AA_cons2:0000020061413ABA:clusterA:0000020061413ABA:clusterA::empty:0
:empty_group:none:06/06/27/08/31/37
 255:AA_cons1:0000020061413ABA:clusterA:0000020061413ABA:clusterA:master:
consistent_synchronized:2:global:none:06/06/27/08/31/37

A detailed invocation example

lsrcconsistgrp -delim : 254

The detailed resulting output:

id:254
name:rccstgrp0
master_cluster_id:0000010030A007E5
master_cluster_name:clusterA
aux_cluster_id:0000010030A007E5
aux_cluster_name:clusterA
primary:master
state:consistent_synchronized
relationship_count:1
freeze_time:06/06/27/08/31/37
status:online
sync:in_sync
copy_type:activeactive
cycle_period_seconds:300
previous_primary aux
cycling_mode:none
RC_rel_id:2
RC_rel_name:aaa