lsrcconsistgrp

The lsrcconsistgrp command returns a concise list or a detailed view of Metro or Global Mirror consistency groups visible to the cluster.

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

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svcinfo -- -- lsrcconsistgrp -- ---------------------------->

>--+--------------------------------+-- --+----------+-- ------->
   '- -filtervalue -- attrib=value -'     '- -nohdr -'      

>--+-----------------------+-- -- --+-----------------+--------->
   '- -delim -- delimiter -'        '- -filtervalue? -'   

>--+---------------+-------------------------------------------><
   +- object_id ---+   
   '- object_name -'   

Parameters

-filtervalue attrib=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 SAN Volume Controller 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 using a wildcard, you must enclose the filter entry with double quotation marks (""), as follows:
    svcinfo 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 possible 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 one-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 matching the filtering requirements that is 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 svcinfo 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

Description

This command returns a concise list or a detailed view of Metro or Global Mirror consistency groups that are visible to the cluster.

Table 1 provides possible values for the attributes that are displayed as data in the output views.
Table 1. lsrcconsistgrp command output values
Attribute Value
primary n/a, master, aux
state inconsistent_stopped, inconsistent_copying, consistent_stopped, consistent_synchronized, idling, idling_disconnected, inconsistent_disconnected consistent_disconnected, empty
freeze_time The time in YY/MM/DD/HH/MM format.
status online, primary_offline, secondary_offline
sync in_sync, out_of_sync
copy_type metro, global, empty_group
Note: The names of the Metro or Global Mirror relationships and consistency groups might be blank if the relationship or consistency groups are intercluster and the cluster partnership is disconnected.

A concise invocation example

svcinfo 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

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

A detailed invocation example

svcinfo 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:inconsistent_stopped
relationship_count:1
freeze_time:
status:online
sync:
copy_type:metro
RC_rel_id:2
RC_rel_name:aaa
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.