lsrolepairs

Parameters

-help | -h | -?

Lists help for the command. If you specify additional parameters and arguments, those parameters and arguments are ignored.

-s

Displays default information for each role pair, including the role name, session (copy) type, and whether the role pair is recoverable, has errors, or is in the process of copying data.

-l

Displays detailed information for each role pair, including:

Column label	Details
Name	System-generated text string used to identify a role pair. The value listed here is what is to be entered on the lspair command.
Recoverable	An indicator of whether the role pair is recoverable. Value values are Yes or No.
Error	An indicator of whether the role pair has errors. Value values are Yes or No.
Copying	An indicator of the role pair is in the process of copying data. Value values are Yes or No.
Progress	The overall copy progress associated with the role pair.
Copy Type	The current session (copy) type of the role pair.
Error Volumes	Total number of volumes in an exception state.
Recoverable Pairs	Number of recoverable pairs
Copying Pairs	Number of copying pairs
Total Pairs	Total number of pairs
Recovery Time	An indicator of the time to which the session is recoverable. Includes both date and time. For point-in-time copy, this is the time that the copy was taken. For continuous synchronous remote copy, this is the time at which the Freeze and Run commands were issued. This field is blank if Recoverable is set to No.
CG Name	This is the user defined consistency group name for the role pair. If the user did not explicitly set a consistency group name for the role pair, or one is not allowed to be set for this role pair, a dash (-) will be displayed.

-fmt { default | xml | delim | stanza }

Specifies the format of the output. You can specify one of these values:

default

Specifies that the output is displayed in tabular format using spaces as delimiters between columns. This is the default value.

xml

Specifies that the output is displayed in XML format.

delim

Specifies that output is displayed in a tabular format using commas as delimiters between columns.

To use a character other than a comma as the delimiter, specify -fmt delim -delim char , where char represents the character that you want to use as the delimiter. For example, if you want to use a colon (:) as the delimiter, use the following -fmt parameter:

-fmt delim -delim :

If you use a shell metacharacter as the delimiting character, enclose the character in quotation marks or single quotation marks. A blank space is not a valid character.

stanza

Specifies that the output is displayed as one keyword-value pair per line.

-p { on | off }

Specifies whether to display one page of text at a time or all text at once.

on

Displays one page of text at a time. Pressing any key displays the next page. This is the default value when the command is run in interactive mode.

off

Displays all text at once. This is the default value when the command is run in single-shot mode.

-hdr { on | off }

Specifies whether to display the table header. You can specify one of these values:

on

Displays the table header. This is the default value.

off

Hides the table header.

-r number

Specifies the number of rows per page to display when the -p parameter is specified. You can specify a value of 1 - 100. The default value is 22.

-v { on | off }

Specifies whether to enable verbose mode. You can specify one of these values:

on

Enables verbose mode.

off

Disables verbose mode. This is the default value.

session_name | -

Specifies the session name for which you display the role pairs.

Alternatively, use the dash (-) to specify that input for this parameter comes from an input stream (stdin). The dash is supported only in single-shot mode.