lsrcrelationship

The list report style can be used to obtain two styles of report.
  1. A list containing concise information about all the Remote Copy relationships visible to the cluster. (Each entry in the list corresponds to a single Remote Copy relationship.)
  2. The detailed information about a single Remote Copy relationship.

Syntax

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

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

>--+-----------------------+-- --+-------------+-- ------------->
   '- -delim -- delimiter -'     +- object_id -+
                                 '- name ------'

>--+-----------------+-----------------------------------------><
   '- -filtervalue? -'

Parameters

-filtervalue attribute=value
Optionally specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are returned. If a capacity is specified, the units must also be included.
-nohdr
By default, headings are displayed for each column of data (in a concise style view), and each item of data (in a detailed style view). Using the -nohdr parameter will suppress the display of these headings.
Note:Note: If there is no data to be displayed (for example, an empty view has been returned), then headings are not displayed irrespective of whether the -nohdr option was used or not.
-delim delimiter
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. Using the -delim parameter will override this behavior. Valid input for the -delim parameter is a one byte character. If, for example, you entered -delim : a colon will be used to separate all items of data in a concise view (for example, the spacing of columns does not occur) and in a detailed view the data is separated from its header by a colon.
object_id | name
Optionally specifies the name or ID of an object. If not supplied, the concise view of all objects, or all of those objects matching the filtering requirements in -filtervalue (if specified), of the given type are returned. If supplied, the detailed view of the specific object is returned, and any filtervalue entry (if entered) is ignored.
-filtervalue?
Display a list of valid filter attributes. The valid filters for the svcinfo lsrcrelationship command are:
  • RC_rel_id
  • RC_rel_name
  • master_cluster_id
  • master_cluster_name
  • master_vdisk_id
  • master_vdisk_name
  • aux_cluster_id
  • aux_cluster_name
  • aux_vdisk_id
  • aux_vdisk_name
  • primary
  • consistency_group_id
  • consistency_group_name
  • state
  • progress

Description

This command will return a concise list or a detailed view, of Remote Copy relationships visible to the cluster.

The following list provides possible values that are applicable to the attributes that are displayed as data in the output views:

primary n/a, master, aux
state inconsistent_stopped, inconsistent_copying, consistent_stopped, consistent_synchronized, idling, idling_disconnected, inconsistent_disconnected, consistent_disconnected
progress 0-100, or n/a
freeze time The time in YY/MM/DD/HH/MM format.
status online, primary_offline, secondary_offline
sync n/a, in_sync, out_of_sync
Note:Note: The names of the Remote Copy relationships and consistency groups may be blank if the relationship or consistency groups are inter-cluster and the cluster partnership is disconnected.

Possible failures

Examples

A concise and detailed invocation example

svcinfo lsrcrelationship -delim : -filtervalue name=j*

The concise and detailed resulting output

id:name:master_cluster_id:master_cluster_name:master_vdisk_id:master_vdisk_name:
 aux_cluster_id:aux_cluster_name:aux_vdisk_id:
 aux_vdisk_name:primary:consistency_group_id:consistency_group_name:state:bg_copy
 _priority:progress
 45:jrel_AB1:0000020061413ABA:clusterA:45:jdisk_B8:0000020060406746:clusterB:38:j
 disk_B1:master:::consistent_stopped:50:
 46:jrel_AB2:0000020061413ABA:clusterA:46:jdisk_A2:0000020060406746:clusterB:39:j
 disk_B2:master:::consistent_stopped:50:
 47:jrel_AB3:0000020061413ABA:clusterA:47:jdisk_A3:0000020060406746:clusterB:40:j
 disk_B3:master:::consistent_stopped:50:
 48:jrel_AB4:0000020061413ABA:clusterA:48:jdisk_A4:0000020060406746:clusterB:41:j
 disk_B4:master:::consistent_synchronised:50:
 49:jrel_BA_1:0000020060406746:clusterB:42:jdisk_B5:0000020061413ABA:clusterA:49:
 jdisk_A5:master:248:jdemo_BA_cons1:consistent
 _stopped:50:
 50:jrel_BA_2:0000020060406746:clusterB:43:jdisk_B6:0000020061413ABA:clusterA:50:
 jdisk_A6:master:248:jdemo_BA_cons1:consistent
 _stopped:50:
 51:jrel_BA_3:0000020060406746:clusterB:44:jdisk_B7:0000020061413ABA:clusterA:51:
 jdisk_A7:master:250:jdemo_BA_cons2:inconsiste
 nt_stopped:50:0
 52:jrel_BA_4:0000020060406746:clusterB:45:jdisk_B8:0000020061413ABA:clusterA:52:
 jdisk_A8:master:::inconsistent_stopped:50:0

A detailed invocation example

svcinfo lsrcrelationship -delim : AB_2

The detailed resulting output

id:9
 name:AB_2
 master_cluster_id:0000020061413ABA
 master_cluster_name:clusterA
 master_vdisk_id:9
 master_vdisk_name:stripe9
 aux_cluster_id:0000020060406746
 aux_cluster_name:clusterB
 aux_vdisk_id:9
 aux_vdisk_name:stripe9_b
 primary:master
 consistency_group_id:
 consistency_group_name:
 state:consistent_stopped
 bg_copy_priority:50
 progress:
 freeze_time:2003/07/05/08/26/46
 status:secondary_offline
 sync:in_sync

Related topics

(C) Copyright International Business Machines Corporation 2003, 2004