zfcp_show - Retrieve SAN details

Edit online

The zfcp_show command retrieves information about the SAN topology and details about the SAN components.

The command output can be extensive. Consider using command options to limit the scope of the command.

Figure 1. zfcp_show syntax

1  zfcp_show?  -a <adapter>?  -i <domain>?  -p <value>
1?  -o
1?  -O
2?  -t
2?  -c
2?  -n
2?  -v
2?  -d

where:

-a <adapter>
specifies the FCP channel through which the management server of the SAN is accessed. <adapter> can be the bus ID of the FCP device, the host name that is assigned to the FCP channel, the WWPN of the channel port, or the port ID of the channel port. If omitted, any configured FCP channel is used.
-i <domain>
limits the output to a particular SAN domain.
-p <value>
limits the output to a particular port that is attached to the SAN switch, for example, a target port of a storage controller. <value> can be the WWPN or the port ID of the attached port.
-o
limits the output to ports that are online.
-O
limits the output to ports that are offline.
-t
shows the SAN topology only.
-c
creates output in CSV format.
-n
directs the command to the local name server and limits the output to information available to the local name server.
-v
provides verbose output. The command output can be extensive even without verbose output.
-d
provides very detailed output; for expert users only.
-h
displays help information for the command. To view the man page, enter man zfcp_show.
-V
displays version information.

Examples

  • This example shows the beginning of the default command output for a SAN. 
    # zfcp_show
Interconnect Element Name        0x100000051e4f7c00
Interconnect Element Domain ID   005
Interconnect Element Type        Switch
Interconnect Element Ports       224
       ICE Port 000 Online
               Attached Port [WWPN/ID] 0x50050763030b0562 / 0x650000 [N_Port]
       ICE Port 001 Online
               Attached Port [WWPN/ID] 0x50050764012241e5 / 0x650100 [N_Port]
       ICE Port 002 Online
               Attached Port [WWPN/ID] 0x5005076303008562 / 0x650200 [N_Port]
       ICE Port 003 Offline
       ICE Port 004 Online
               Attached Port [WWPN/ID] 0x5005076303140335 / 0x650400 [N_Port]
       ICE Port 005 Online
               Attached Port [WWPN/ID] 0x5005076303104562 / 0x650500 [N_Port]
...
    In the output, the lines that begin with ICE Port specify switch ports and the lines that begin with Attached Port specify the ports of the attached nodes.
  • This example shows the verbose equivalent of the previous example. 
    # zfcp_show -v
Using adapter BUS_ID    0.0.3c02
              Name      0x5005076401a241e5
              N_Port_ID 0x657700
              OS-Device /dev/bsg/fc_host0
              Speed     4 GBit/s
Interconnect Element Name       0x100000051e4f7c00
Interconnect Element Domain ID  005
Interconnect Element Type       Switch
Interconnect Element Ports      224
Interconnect Element Vendor     Brocade Communications, Inc.
Interconnect Element Model      62.3
Interconnect Element Rel. Code  v6.2.0g
Interconnect Element Log. Name  fcsw14

       ICE Port 000 Online [0x200000051e4f7c00]
       ICE Port Type SFP with serial ID Short wave laser - SN (850nm) [F_Port]
               Attached Port [WWPN/ID] 0x50050763030b0562 / 0x650000 [N_Port]

       ICE Port 001 Online [0x200100051e4f7c00]
       ICE Port Type SFP with serial ID Short wave laser - SN (850nm) [F_Port]
               Attached Port [WWPN/ID] 0x50050764012241e5 / 0x650100 [N_Port]

       ICE Port 002 Online [0x200200051e4f7c00]
       ICE Port Type SFP with serial ID Short wave laser - SN (850nm) [F_Port]
               Attached Port [WWPN/ID] 0x5005076303008562 / 0x650200 [N_Port]

       ICE Port 003 Offline [0x200300051e4f7c00]

       ICE Port 004 Online [0x200400051e4f7c00]
       ICE Port Type SFP with serial ID Short wave laser - SN (850nm) [F_Port]
               Attached Port [WWPN/ID] 0x5005076303140335 / 0x650400 [N_Port]

       ICE Port 005 Online [0x200500051e4f7c00]
       ICE Port Type SFP with serial ID Short wave laser - SN (850nm) [F_Port]
               Attached Port [WWPN/ID] 0x5005076303104562 / 0x650500 [N_Port]
...
  • This example shows part of the CSV equivalent of the previous examples. 
    # zfcp_show -c
...
ICE-name,domain,ICE-type,ppn,status,port name,port module type,
...port TX type,port type,att. port name,att. port ID,att. port type
0x100000051e4f7c00,005,Switch,000,Online,0x200000051e4f7c00,SFP with serial ID,
...Short wave laser - SN (850nm),F_Port,0x50050763030b0562,0x650000,N_Port
...
  • This example shows information as provided by a local name server. 
    # zfcp_show -n
Local Port List:
0x500507630313c562 / 0x656000 [N_Port] proto = SCSI-FCP FICON
0x50050764012241e4 / 0x656100 [N_Port] proto = SCSI-FCP
0x5005076303048335 / 0x656300 [N_Port] proto = SCSI-FCP FICON
0x5005076401221b97 / 0x656400 [N_Port] proto = SCSI-FCP
0x500507630300c562 / 0x656500 [N_Port] proto = SCSI-FCP FICON
0x5005076401a23517 / 0x656700 [N_Port] proto = SCSI-FCP
0x5005076401a219a0 / 0x656800 [N_Port] proto = SCSI-FCP
0x5005076401a0b7bf / 0x656900 [N_Port] proto = SCSI-FCP
0x500507640120b9a3 / 0x656a00 [N_Port]
0x500507630310c562 / 0x657000 [N_Port] proto = SCSI-FCP FICON
0x5005076401a241e4 / 0x657100 [N_Port] proto = SCSI-FCP
...