Operating System BS2000 OSD/BC V11.0B (en)

The SHOW- SAN-CONFIGURATION statement displays information on SAN components.

The basis for this is provided by the data of the switches whose IP addresses are contained in the SYSDAT.SANCHECK.SWITCHES file. The switches are grouped on a fabric-byfabric basis. These fabrics are numbered consecutively, starting at 1. Within a fabric the associated switches are numbered consecutively, starting at 1.

These associated numbers are the internal fabric and switch identifiers which are used in the display to identify a fabric or switch and, when they are entered, are expected in order to specify a fabric or switch.

The ports of a switch are numbered from index 0 through n-1 as ascertained from the switch data.

A list of the switch data that has been ascertained and the associated fabric identifiers and switch identifiers can be obtained using the SHOW-SAN-CONFIGURATION statement without any further operands.

Format

SHOW- SAN-CONFIGURATION

UNIT = ALL / FABRIC(...) / SWITCH(...) / PORT(...)
	*FABRIC(...)
		\|	FABRIC-ID = <integer 1..99>
	*SWITCH(...)
		\|	SWITCH-ID = <integer 1..99>
		\|	,FABRIC-ID = <integer 1..99>
	*PORT(...)
		\|	PORT-ID = <integer 0..9999>
		\|	,SWITCH-ID = <integer 1..99>
		\|	,FABRIC-ID = <integer 1..99>
,INFORMATION = STD / OWN-UNITS / CONFIGURATION / ZONES / *ERROR
,TABLE-UPDATE = NO / YES

Operands

UNIT = *ALL / *FABRIC(...) / *SWITCH(...) / *PORT(...)
Specifies the SAN components for which the information is to be displayed. A SAN component is specified using the type and the internal designation.

UNIT = *ALL
Provides information on all the SAN components ascertained. These consist of all fabrics and associated switches whose data can be ascertained via the predefined IP addresses. Only the default information is displayed. Any other value in the INFORMATION parameter is ignored.

UNIT = *FABRIC(...)
Provides information on a specific fabric.

FABRIC-ID = <integer 1..99>
Internal number of the fabric for which information is to be displayed.

UNIT = *SWITCH(...)
Provides information on a specific switch. A switch is specified by its internal number in the higher-level fabric and the internal number of the fabric.

SWITCH-ID = <integer 1..99>
Internal number of the switch for which information is to be displayed.

FABRIC-ID = <integer 1..99>
Internal number of the fabric.

UNIT = *PORT(...)
Provides information on a specific port. A port is specified by its internal number on the associated switch, the internal number of the switch in the higher-level fabric and the internal number of the fabric.

PORT-ID = <integer 0..9999>
Internal number of the port for which information is to be displayed.

SWITCH-ID = <integer 1..99>
Internal number of the switch.

FABRIC-ID = <integer 1..99>
Internal number of the fabric.

INFORMATION = *STD / *OWN-UNITS / *CONFIGURATION / *ZONES / *ERROR Determines which information is to be displayed for the specified SAN component. When an illegal combination of the UNIT and INFORMATION operands is specified, INFORMATION=*STD applies for the display.

INFORMATION = *STD
Displays default information for the fabrics, switches and ports that have been determined. This information comprises the UNIT designation of the SAN component, the name (if available), for ports the port type, the internal number, the internal number of the associated higher-level units, and the number of the lower-level components (number of switches in the fabric or number of ports on the switch).

INFORMATION = *OWN-UNITS
This specification is only permissible for UNIT=*FABRIC/*SWITCH.
Lists all ports of the fabric or switch at which hardware units which are known in the system are connected.

INFORMATION = *CONFIGURATION
When UNIT=*SWITCH, lists all ports of the switch and their link neighbors.
When UNIT=*PORT, detailed specifications of the port are provided.
When UNIT=*FABRIC, all switches of the fabric are listed. If the fabric has more than one switch, a switch connection table is displayed. This shows which switches of the fabric are connected to each other via which ports.

INFORMATION = *ZONES
This specification is only permissible for UNIT=*FABRIC.
Lists all zones of the fabric with the associated ports.

INFORMATION = *ERROR
This specification is permissible for UNIT=*SWITCH/*PORT.
Displays error statuses/error statistics for the required components.
When UNIT=*SWITCH, a table containing statistics and error counters for all ports on the switch which are in the “online” status is displayed.
When UNIT=*PORT, the corresponding data and the port status data is displayed.

TABLE-UPDATE = *NO / *YES
Specifies whether the configuration data should be determined again before the information is displayed. It may be necessary to update the configuration data if the system or fabric configuration has been changed or the existing data is incomplete. For details, see "Ascertaining the fabric configuration" (SANCHECK Checking the SAN configuration).

TABLE-UPDATE = *NO
Information display takes place with the configuration data which has already been ascertained. Only if no data yet exists is it ascertained.

TABLE-UPDATE = *YES
Before the information is displayed, the system configuration data and the switch data is ascertained again.

Output format

When UNIT=*ALL, initially all IP addresses are displayed for which no switch data could be ascertained. The other information for the fabrics, switches and ports is displayed in tables. The display begins with a header line which names the display columns. The standard display contains the following columns (if a different value from *STD is specified in the INFORMATION parameter, additional data is displayed):

Display column	Function
UNIT	Type of SAN component Possible values: FAB (fabric), SWI (switch), PORT (switch port)
NAME/TYPE	Unit=FABRIC: fabric01, fabric02, etc., internally assigned number Unit=SWITCH: Administrative name of the switch UNIT=*PORT: Port type
WWNN	WWNN of the SAN component (the fabric is assigned the master switch’s WWNN)
ID	Internal identifier/index of the SAN component
FAB or FAB / SWI	Specifies the higher-level unit (fabric identifier of a switch, fabric and switch identifier of a port)
#SWI / #PRT	Number of switches in the fabric, number of ports on the switch
LINK-N / IP-ADDR / VFID	Link neighbor at the specified port If this belongs to a hardware unit which is known in the system or to a switch of the fabric, the name of this unit is displayed instead of the LINK-WWPN. In the case of a switch, the IP address of the LAN connection via which the data was ascertained. In the case of a logical switch, the associated virtual fabric ID is displayed.
STATE	Status of the switch or port Possible displays: ONLINE NOT_ON (the status could not be ascertained, but is not ONLINE) UNDEF (the status could not be ascertained) Detailed status displays are output for a special component (switch or port) using INFORMATION=*CONFIGURATION.

Table 18: Output columns for the SHOW-SAN-CONFIGURATION statementN

Examples

Output with INFORMATION=STD*

//SHOW-SAN-CONFIGURATION UNIT=*ALL,INFORMATION=*STD
SAN0S05 NO SWITCH DATA FOR IP-ADDRESS '192.168.224.55'
UNIT NAME         WWNN             ID       #SWI
FAB  fabric01     10000005334f5502 1        4
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE 
SWI  FCSW101      10000005334e1353 1    F01 80   192.168.64.5         ONLINE
SWI  FCSW102      100000051e0375c3 2    F01 64   192.168.64.228       ONLINE
SWI  FCSW103      10000005334f5502 3    F01 74   192.168.64.6    128  ONLINE
SWI  FCSW104      10000027f8884a50 4    F01 93   192.168.64.230  128  ONLINE
UNIT NAME         WWNN             ID       #SWI
FAB  fabric02     100000051ec0b5a5 2        4
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE 
SWI  FCSW201      100000051e3655be 1    F02 144  192.168.64.235       ONLINE
SWI  FCSW202      100000051ec0b5a5 2    F02 80   192.168.66.29        ONLINE
SWI  FCSW203      100000051e021bae 3    F02 32   192.168.64.239       ONLINE
SWI  FCSW204      100050eb1a062416 4    F02 96   192.168.64.237  128  ONLINE
UNIT NAME         WWNN             ID       #SWI
FAB  fabric03     10000005334f5504 3        2
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE 
SWI  switch_1     10000005334f5504 1    F03 2    192.168.64.6    1    ONLINE
SWI  switch_2     10000027f8884a52 2    F03 2    192.168.64.230  1    ONLINE
UNIT NAME         WWNN             ID       #SWI
FAB  fabric04     10000005334f5503 4        2
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE
SWI  switch_11    10000005334f5503 1    F04 6    192.168.64.6    10   ONLINE
SWI  switch_12    10000027f8884a51 2    F04 3    192.168.64.230  10   ONLINE
UNIT NAME         WWNN             ID       #SWI
FAB  fabric05     10000060691211d5 2        1
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE
SWI  Switch13     10000060691211d5 1    F05 16   192.168.82.242       UNDEF

Output with INFORMATION=CONFIGURATION for a fabric*

//SHOW-SAN-CONFIGURATION UNIT=*FABRIC(FABRIC-ID=2),INF=*CONFIGURATION
UNIT NAME         WWNN             ID       #SWI
FAB  fabric02     100000051ec0b5a5 2        4
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE 
SWI  FCSW201      100000051e3655be 1    F02 144  192.168.64.235       ONLINE
SWI  FCSW202      100000051ec0b5a5 2    F02 80   192.168.66.29        ONLINE
SWI  FCSW203      100000051e021bae 3    F02 32   192.168.64.239       ONLINE
SWI  FCSW204      100050eb1a062416 4    F02 96   192.168.64.237  128  ONLINE
Switch Connection Table:
        |SWI_1   |SWI_2   |SWI_3   |SWI_4
--------------------------------------------
SWI_1   | *      |152:28  |136:0   |  0:43
        |        |153:29  |137:1   |  1:47
--------------------------------------------
SWI_2   | 28:152 | *      | 10:12  | 24:8
        | 29:153 |        | 11:13  | 25:12
--------------------------------------------
SWI_3   |  0:136 | 12:10  | *      | 28:0
        |  1:137 | 13:11  |        | 29:4
--------------------------------------------
SWI_4   | 43:0   |  8:24  |  0:28  | *
        | 47:1   | 12:25  |  4:29  |
--------------------------------------------

In addition to the standard information, the standard line for all switches in the fabric is also displayed. As the fabric contains more than one switch, the display also contains a switch connection table. This shows which switches are connected via which ports. Up to 4 connections are displayed for each switch pair. An entry px:py in a line SWI_x and column SWI_y means that the switch with identifier x has a connection via the port with the index px to the port with the index py on the switch with the identifier y.

Output with INFORMATION=CONFIGURATION for a port*

//SHOW-SAN-CONF UNIT=*PORT(PORT-ID=12,SWITCH-ID=1,FABRIC-ID=1),INF=*CONF 
UNIT TYPE         WWNN             ID   FAB/SWI    LINK-N           STATE 
PORT F-Port       200c0005334e1353 12   F01S01     CTL L0           ONLINE
Last Update of Switch Data : <date> <time> 
Port Type           : F-Port
Port State          : ONLINE
Port Status         : READY
Port Hardware State : ACTIVE
Port Speed          : 4 Gbit/s
Link WWPN           : 10000000c94cbc42
Symbolic Port Name  : IBM     ULTRIUM-TD4     94D4
Link WWNN           : 20000000c94cbc42
Member of 4 Zones:
Zone 683 : S200_F0__star_icp1_ctl14
Zone 866 : S210_0001_F0__star_icp1_ctl14
Zone 878 : SE1_0B__star_icp1_ctl14
Zone 940 : SE2_18__star_icp1_ctl14

In addition to the standard information, status displays and details of the port’s zone affiliation are also output:

Information	Possible values
Port type	E-Port (Expansion Port) Port for connection to another Fibre Channel switch. E-Port/log (logical Expansion Port) Logical connection in a logical switch to another logical switch in a virtual fabric. The physical connections (E-Ports) are defined in the associated base switch. F-Port (Fabric Port) Port for a point-to-point connection to a node in the fabric. F-Port/NPIV (Fabric Port) F-Port which supports N-Port virtualization. A technique which enables multiple nodes to be grouped via one N-Port and connected to the fabric. FL-Port (Fabric Loop Port) Port for an arbitrated loop comprising several network nodes. G-Port (Generic Port) Port with an undefined function (e.g. because no node is connected). Can work as an E-Port or as an F-Port. *UNKNOWN All other port types.
Port state	The operating state of the port set by the administrator. ONLINE: The port is operating. OFFLINE: The port is not operating. UNAVAILABLE: The port is not ready to operate; the state is undefined. BYPASSED: The port is ready to operate, but it is currently separated from the connected node by means of a bridge. DIAGNOSTICS: The port is in diagnostic mode. *UNKNOWN: All other states
Port status	The current protocol status of the port. READY: The port is ready for data transfer. WARNING: The port requires maintenance. FAILURE: The port could not be initialized for data transfer. NOT PARTICIPATING: The connected loop does not take part in data communication and has no loop address. INITIALIZING: Initialization of this port has not yet been completed; the port is therefore not yet ready to operate. BYPASS: The port was bridged either automatically of manually. OFFLINE: The port is not ready for data transfer. *UNKNOWN: All other states.
Port hardware state	The operating state of the port ascertained by the device. ACTIVE: The port is connected with a node; light and synchronization are available. FAILED: An error prevented the operating state from being ascertained. BYPASSED: The port is bridged; the connected node can no longer be reached. LOOPBACK: The port is in loopback mode. TX_FAULT: Error in the GBIC transmitter. This port’s GBIC is defective. NO_MEDIA: No GBIC is installed on this port. LINK_DOWN: The port is waiting for an incoming signal; light is available, but no synchronization. *UNKNOWN: All other states.
Port speed	Transmission rate of the port
LINK-WWPN	If necessary, WWPN of the link port
Symbolic Port Name	If necessary, name of the link port
Link WWNN	If necessary, WWNN of the link node
Symbolic Node Name	If necessary, name of the link node

Output for a port with N-Port ID Virtualization (NPIV)

//SHOW-SAN-CONF UNIT=*PORT(PORT-ID=6,SWITCH-ID=2,FABRIC-ID=2),INF=*CONF
UNIT TYPE         WWNN             ID   FAB/SWI    LINK-N           STATE 
PORT F-Port/NPIV  200600051ec0b5a5 6    F02S02     201400051ea4cb45 ONLINE
                                   6               10000000c9831b8f
                                   6               10000000c9831b93
Last Update of Switch Data : <date> <time> 
Port Type           : F-Port/NPIV
Port State          : ONLINE
Port Status         : READY
Port Hardware State : ACTIVE
Port Speed          : 4 Gbit/s
Link WWPN           : 201400051ea4cb45
Link WWNN           : 100000051ea4cb45
Link_2:
Link WWPN           : 10000000c9831b8f
Symbolic Port Name  : Emulex PPN-10:00:00:00:c9:83:1b:8f
Link WWNN           : 20000000c9831b8f
Symbolic Node Name  : Emulex LPe12002 FV1.11A5 DV8.3.5.8.2p
Link_3:
Link WWPN           : 10000000c9831b93
Symbolic Port Name  : Emulex PPN-10:00:00:00:c9:83:1b:93
Link WWNN           : 20000000c9831b93
Symbolic Node Name  : Emulex LPe12002 FV1.10A5 DV8.2.2.1-18vmw

With NPIV, all link ports are output.

Output for a logical E-Port (in a virtual fabric)

//SHOW-SAN-CONF UNIT=*PORT(PORT-ID=81,SWITCH-ID=3,FABRIC-ID=1),INF=*CONF
UNIT TYPE         WWNN             ID   FAB/SWI    LINK-N           STATE 
PORT E-Port/log   50005334f553d051 81   F01S03     SWI FCSW104      ONLINE
Last Update of Switch Data : <date> <time> 
Port Type           : E-Port/log
Port State          : ONLINE
Port Status         : READY
Port Hardware State : *UNKNOWN
Port Speed          : -
Link WWPN           : 50027f8884a8b061 
Physical Ports      : 44,45

If it was possible to ascertain the data of the associated base switch, the associated physical port numbers are output.

Output with INFORMATION=OWN-UNITS*

//SHOW-SAN-CONFIGURATION UNIT=*SWITCH(SWITCH-ID=1,FABRIC-ID=1),INF=*OWN-UNITS
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE
SWI  FCSW101      10000005334e1353 1    F01 80   192.168.64.5         ONLINE
UNIT TYPE         WWNN             ID   FAB/SWI  LINK-N               STATE
PORT F-Port       20010005334e1353 1    F01S01   CTL FC00             ONLINE 
PORT F-Port       20020005334e1353 2    F01S01   CTL CD00             ONLINE 
PORT F-Port       20080005334e1353 8    F01S01   CTL 3400             ONLINE 
                                   8             CTL 3600
PORT F-Port       200c0005334e1353 12   F01S01   CTL L0               ONLINE 
PORT F-Port       20280005334e1353 40   F01S01   CTL 3400             ONLINE 
PORT F-Port       202a0005334e1353 42   F01S01   CTL 5600             ONLINE 
PORT F-Port       20410005334e1353 65   F01S01   CTL 9A00             ONLINE 
PORT F-Port       204f0005334e1353 79   F01S01   CTL 8000             ONLINE 
                                   79            CTL 8100
                                   79            CTL 8800
                                   79            CTL 8900

The standard display for the switch contains the standard outputs for all ports of the switch whose link neighbor belongs to channels or controllers which are known in the system.

Outputs with INFORMATION=ERROR*

//SHOW-SAN-CONFIGURATION UNIT=*SWITCH(SWITCH-ID=3,FABRIC-ID=2),INF=*ERROR
UNIT NAME         WWNN             ID   FAB #PRT IP-ADDR         VFID STATE
SWI  FCSW203      100000051e021bae 3    F02 32   192.168.64.239       ONLINE
Last Update          : <date> <time> 
Port Error and Statistic Counters:
--------------------------------------------------------------------------
|PORT-| LINK-    |      LOSSES OF      | TRANSMITTED    | RECEIVED       |
| ID  | FAILURES |SYNCHRON. | SIGNAL   | BYTES          | BYTES          |
--------------------------------------------------------------------------
|  00 |      0   |      2   |      3   |           1 TB |           2 TB |
|  01 |      0   |      2   |      3   |           1 TB |           2 TB |
|  06 |      0   |      8   |     11   |           2 GB |           3 GB |
|  07 |    195   |    608   |    608   |          14 GB |           7 GB |
|  08 |    570   |    583   |    586   |           6 GB |          11 GB |
|  10 |    122   |    139   |    162   |           6 GB |           2 GB |
|  11 |      1 M |    109 K |    218 K |          44 KB |          42 KB |
|  12 |      1   |      3   |      4   |           7 TB |           7 TB |
|  18 |     64 K |     10 K |     20 K |           2 TB |           2 TB | 
|  19 |     23   |    744 K |      1 M |          44 TB |          28 TB | 
|  20 |      1   |      6   |      7   |           1 MB |           1 MB | 
|  21 |     41   |     47   |     50   |          13 TB |          16 TB | 
|  22 |      7   |      4 K |      8 K |         962 GB |         927 GB | 
|  24 |     14   |     17   |     19   |          56 MB |          83 MB | 
|  30 |      2 K |      1 K |      3 K |           3 GB |           8 GB | 
|  31 |     53   |     49 K |     98 K |          21 GB |          22 GB | 
-------------------------------------------------------------------------- 
  K:  10^3         M:  10^6
  KB: 2^10 bytes   MB: 2^20 bytes   GB: 2^30 bytes   TB: 2^40 bytes

The error counters specify the number of events. Values >= 1000 are specified with a precision of 10³ (K), 10⁶ (M), or 10⁹ (G).

The amount of data transferred is specified in bytes or in KB (2¹⁰), MB (2²⁰), GB (2³⁰) or TB (2⁴⁰).

//SHOW-SAN-CONF UNIT=*PORT(PORT-ID=10,SWITCH-ID=1,FABRIC-ID=1),INF=*ERROR
UNIT TYPE         WWNN             ID   FAB/SWI     LINK-N           STATE
PORT F-Port       200a00606951c12e 10   F01S01      10000000c951cd8e ONLINE 
Last Update of Switch Data : <date> <time> 
Port-State          : ONLINE
Port-Status         : READY
Port-Hardware-State : ACTIVE
Error Counters:
Link Failures             :      0
Losses of Synchronisation :   5014
Losses of Signal          :      4
Statistic Counters:
Transmitted Bytes :          80 GB
Received Bytes    :          80 GB

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-SAN-CONFIGURATION - Displays information on SAN components

Format

Operands

Output format

Examples

Output with INFORMATION=STD*

Output with INFORMATION=CONFIGURATION for a fabric*

Output with INFORMATION=CONFIGURATION for a port*

Output for a port with N-Port ID Virtualization (NPIV)

Output for a logical E-Port (in a virtual fabric)

Output with INFORMATION=OWN-UNITS*

Outputs with INFORMATION=ERROR*

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-SAN-CONFIGURATION - Displays information on SAN components

Format

Operands

Output format

Examples

Output with INFORMATION=*STD

Output with INFORMATION=*CONFIGURATION for a fabric

Output with INFORMATION=*CONFIGURATION for a port

Output for a port with N-Port ID Virtualization (NPIV)

Output for a logical E-Port (in a virtual fabric)

Output with INFORMATION=*OWN-UNITS

Outputs with INFORMATION=*ERROR

Output with INFORMATION=STD*

Output with INFORMATION=CONFIGURATION for a fabric*

Output with INFORMATION=CONFIGURATION for a port*

Output with INFORMATION=OWN-UNITS*

Outputs with INFORMATION=ERROR*