lszhyperlinkport

The lszhyperlinkport command displays a list of zHyperLink ports for the specified storage image.

Note: zHyperLink connections are not available on DS8882F systems.

Parameters

-s: (Optional) Displays only the port IDs. You cannot use the -l and the -s parameters together.
-l: (Optional) Displays the default output for each port ID in this list. You cannot use the -l and the -s parameters together.
-dev storage_image_ID: (Optional) The storage image ID, which consists of manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified port ID. It is also required if you do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.
port_ID ... | -: (Optional) Displays the ports that match the specified IDs. A port ID is prefixed with the letter "HL" and consists of four hexadecimal characters.

Example: Displaying a list of zHyperLink ports for the storage image

dscli> lszhyperlinkport

Output

ID            State                      Loc                  Speed         
====================================================================
HL0028      Connected        U1500.1B3.RJBAY03-P1-C7-T3       8 GB/s      
HL0029      Connected        U1500.1B3.RJBAY03-P1-C7-T4       8 GB/s     
HL0038      Disconnected     U1500.1B4.RJBAY04-P1-C7-T3       8 GB/s       
HL0039      Disconnected     U1500.1B4.RJBAY04-P1-C7-T4       8 GB/s

Output definitions

ID: zHyperLink port ID.
State: State of the zHyperLink port in the I/O enclosure PCIe/PCN card. One of the following values display: Connected, Disconnected, Offline, or Fenced.
Loc: Location of the zHyperLink port in the I/O enclosure PCIe/PCN card.
Speed: Speed of the link of the zHyperLink port in the I/O enclosure PCIe/PCN card.
Width: Number of PCIe lanes operational on the zHyperLink port in the I/O enclosure PCIe/PCN card.