lspath

Use the lspath command to display paths between ESS and DS devices. You can then use this information for a remote copy.

Syntax

Read syntax diagramSkip visual syntax diagramlspath-help-h-?-s-l-fmtdefaultxmldelim-delimcharstanza-ponoff-hdronoff-rnumber-voffon-srcsource_lss-tgttarget_lss

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 path, including the source and target LSS, path type, status, and whether the path was auto-generated.
-l
Displays detailed information for each path, including:
Column label Details
Source Origin of the path. For ESS, this is an LSS. For the format of this field, see the mkpath command.
Target Target of the path. For ESS this is an LSS. For the format of this field, see the mkpath command.
Type ESCON (ESS or DS only) or Fibre Channel.
Status Whether the path is currently established or not.
Auto-Generated Yes, if the path was generated by the copy services management server. No, if you specified the path.
-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.
-src source_lss
Specifies the source LSS. This must be specified in the format type.serial.lss(hex).port(hex) (for example, ESS:2105.FCA18:LSS:10.00FF).
-tgt target_lss
Specifies the target LSS. This must be specified in the format type.serial.lss(hex).port(hex) (for example, ESS:2105.FCA18:LSS:10.00FF).

Example: Listing all paths with the same source LSS

The following command lists all paths that use source LSS DS8000:2107.04131:LSS:15.

csmcli> lspath -src DS8000:2107.04131:LSS:15

The following output is returned:

Source                          Target                          Type
=============================================================================
DS8000:2107.04131:LSS:15.0x0330 DS8000:2107.NF111:LSS:15.0x0030 Fibre Channel
DS8000:2107.04131:LSS:15.0x0110 ESS:2105.FCA57:LSS:15.0x000C    Fibre Channel
DS8000:2107.04131:LSS:15.0x0110 DS8000:2107.NK791:LSS:15.0x0032 Fibre Channel

Status      Auto-Generated
==========================
Established Yes
Established Yes
Established Yes

Example: Listing information about a specific path

The following command lists information about the path with source LSS DS8000:2107.04131:LSS:15.

csmcli> lspath -src DS8000:2107.04131:LSS:15 -tgt ESS:2105.FCA57:LSS:15

The following output is returned:

Source                          Target                       Type
==========================================================================
DS8000:2107.04131:LSS:15.0x0110 ESS:2105.FCA57:LSS:15.0x000C Fibre Channel

Status      Auto-Generated
==========================
Established Yes