lspartnership

Edit online

Use the lspartnership command to display a concise or detailed view of the current clustered systems (systems) that are associated with the local 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.

Some filters allow the asterisk character (*) when you enter the command. The following rules apply to the use of wildcard characters with the command-line interface (CLI):
- The wildcard character is an asterisk (*).
- The command can contain a maximum of one wildcard.
- When you use a wildcard, you must enclose the filter entry within double quotation marks (""):
```
lspartnership -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.

-filtervalue?

(Optional) displays a list of filters that can be applied against this view. The following filter attributes are valid:

id
name
link1=portset1
link2=portset5

system_id | system_name

(Optional) Specifies the name or ID of a system. This parameter displays the detailed view of the specified system.

Description

This table described attribute values.

Table 1. lspartnership attribute values
Attribute	Value
id	Indicates the system ID.
name	Indicates the system name.
location	Indicates the system location.
code_level	Indicates the code level.
partnership	Indicates the current state of the partnership; not applicable for the local system and is blank. The partnership field can show the following values: fully_configured The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. partially_configured_local The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The remote system is online and available for partnership. partially_configured_local_stopped The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The chpartnership command with the stop parameter is issued from the local system, and the remote system is online and available. Issue chpartnership -start on the local system, and mkfcpartnership or mkippartnership on the remote system not_present The mkfcpartnership or mkippartnership command is issued from the local system to the remote system, and the remote system is not available. The remote system is either offline or not connected to the local system. fully_configured_stopped The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the local system. fully_configured_remote_stopped The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the remote system. fully_configured_local_excluded The mkfcpartnership or mkippartnership command is issued in both directions. The local system excludes the connection to the remote system and the partnership is unable to sustain the I/O workload for the Metro Mirror or Global Mirror relationships. fully_configured_remote_excluded The mkfcpartnership or mkippartnership command is issued in both directions. The local system excludes the connection to the remote system and the partnership is unable to sustain the I/O workload for the Metro Mirror or Global Mirror relationships. fully_configured_exceeded There are too many systems in the system network and the partnership from the local system to the remote is disabled.
relationship_bandwidth_limit	Indicates the current relationship bandwidth limit setting. The relationship bandwidth limit controls the maximum rate at which any one remote-copy relationship can synchronize. The default value for the relationship bandwidth limit is 25 megabytes per second (MBps).
type	Indicates the type of partnership: Fibre Channel (FC) Internet Protocol Version 4 (IPv4) or Internet Protocol Version 6 (IPv6) DNS FC partnerships are created connecting two systems over FC or Fibre Channel over Ethernet (FCoE) fabrics. IPv4 or IPv6 partnerships are created connecting two systems over native IP links.
cluster_ip	Indicates the partner system IP address, which can be IPv4, IPv6 or FQDNs. This information is displayed for IP-based partnerships. For IP-based partnership this field displays the system IP address that is specified while the partnership using mkippartnership is created.
chap_secret	Indicates the Challenge-Handshake Access Protocol (CHAP) secret (up to 80 alphanumeric characters) for the partner system. The CHAP authenticates the local system with the partner system during discovery, and Internet Small Computer System Interface (iSCSI) system session creation. For FC-based and FCoE-based relationships this field is always blank.
link_bandwidth_mbits	Indicates the aggregate bandwidth for the Remote Copy (RC) link in megabits per second (Mbps). This is a numeric value from `0` to `100000`. If there are multiple links between the local and remote systems, this parameter is set to the sum of the link bandwidths for these links.
background_copy_rate	Indicates the bandwidth allocation for background copy operations that are performed over the replication link. It is expressed as a percentage of the link bandwidth value, and is the maximum rate at which background copy operations are performed. This value is a number from `0` to `100` .
event_log_sequence	Indicates the last sequence number (indicating the last event) from event log for this partnership. This is a numeric value in the range 100 - 8000000. For FC-based and FCoE-based relationships this field is always blank.
max_replication_delay	Indicates the value for maximum replication delay. This value is a number in the range 100 - 360.
compressed	Indicates whether compression is enabled. The value can be `yes` or `no` (default).
link1	Indicates the local portset name used for WAN Link 1. The value can be string with up to 63 characters.
link2	Indicates the local portset name used for WAN Link 2. The value can be string with up to 63 characters.
link1_ip_id	Indicates the IP address index which is currently in use for IP Partnership for WAN Link1 from lsip view. The value can be numeric from `0 - 2047`.
link2_ip_id	Indicates the IP address index which is currently in use for IP Partnership for WAN Link 2 from lsip view. The value can be numeric from `0 - 2047`.

A concise invocation example

lspartnership

The concise resulting output:


id               name                         location partnership      type cluster_ip    event_log_sequence link1    link2    link1_ip_id link2_ip_id
000002042020FBA8 FAB3-R62-Cluster             local
000002043421A050 FAB3-R62-Replication-Cluster remote   fully_configured ipv4 x.xxx.xxx.xxx                    portset1 portset2 34          35

A concise invocation example

lspartnership -filtervalue "link1=portset1"

The concise resulting output:


id               name                         location partnership      type cluster_ip    event_log_sequence link1    link2    link1_ip_id link2_ip_id
000002043421A050 FAB3-R62-Replication-Cluster remote   fully_configured ipv4 x.xxx.xxx.xxx                    portset1 portset2 34          35

A detailed invocation example

lspartnership FAB3-R62-Replication-Cluster

The detailed resulting output:


id 000002043421A050
name FAB3-R62-Replication-Cluster
location remote
partnership fully_configured
code_level 8.5.2.0 (build 161.15.2209100513000)
console_IP x.xxx.xxx.xxx:xxx
gm_link_tolerance 300
gm_inter_cluster_delay_simulation 0
gm_intra_cluster_delay_simulation 0
relationship_bandwidth_limit 25
gm_max_host_delay 5
type ipv4
cluster_ip x.xxx.xxx.xxx
chap_secret
event_log_sequence
link_bandwidth_mbits 18000
background_copy_rate 50
max_replication_delay 0
compressed no
link1 portset1
link2 portset2
link1_ip_id 34
link2_ip_id 35
secured yes
pbr_in_use yes