Displaying port information

6.10 LPAR mode z/VM guest

For each target port, there is a number of read-only sysfs attributes with port information.

About this task

Table 1 and Table 2 summarize the relevant attributes.

Table 1. zfcp-specific attributes with port information within the FCP device sysfs tree
Attribute	Explanation
access_denied	This attribute is obsolete. The value is always `0`.
fc_security	IBM® Fibre Channel Endpoint Security status of the connection between an FCP device and the port. See Investigating IBM Fibre Channel Endpoint Security.
in_recovery	Shows if port is in recovery (0 or 1)

Table 2. Transport class attributes with port information
Attribute	Explanation
node_name	WWNN of the remote port (target port).
port_name	WWPN of the remote port.
port_id	Destination ID of the remote port
port_state	State of the remote port.
roles	Role of the remote port (usually FCP target).
scsi_target_id	Linux® SCSI ID of the remote port.
supported_classes	Supported classes of service.

Procedure

Use the cat command to read an attribute.

Issue a command of this form to read a zfcp-specific attribute:
```
# cat /sys/bus/ccw/drivers/zfcp/<device_bus_id>/<wwpn>/<attribute>
```
where:

<device_bus_id>

specifies the FCP device.

<wwpn>

is the WWPN of the target port.

<attribute>

is one of the attributes in Table 1.
To read transport class attributes of the associated target port, use a command of this form:
```
# cat /sys/class/fc_remote_ports/<rport_name>/<attribute>
```
where:

<rport_name>

is the name of the remote port.

<attribute>

is one of the attributes in Table 2.

Tip: With the HBA API package installed, you can also use the zfcp_ping and zfcp_show commands to find out more about your ports.

Examples

In this example, information is displayed for a target port 0x500507630300c562 that is attached through an FCP device with bus ID 0.0.3d0c:
```
# cat /sys/bus/ccw/drivers/zfcp/0.0.3d0c/0x500507630300c562/in_recovery
0
```

To display transport class attributes of a target port you can use lszfcp:

# lszfcp -p 0x500507630300c562 -a
0.0.3d0c/0x500507630300c562 rport-0:0-0
Class = "fc_remote_ports"
    dev_loss_tmo        = "2147483647"
    fast_io_fail_tmo    = "5"
    maxframe_size       = "2112 bytes"    
    node_name           = "0x5005076303ffc562"
    port_id             = "0x652113"
    port_name           = "0x500507630300c562"
    port_state          = "Online"
    roles               = "FCP Target"
    scsi_target_id      = "0"
    supported_classes   = "Class 2, Class 3"