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

In the SAN, the SHOW-SAN-PATH statement checks hardware connections between specified hardware units of the FC configuration (source and target units) and displays information on these. All hardware units, all units of one type or explicitly specified channels, controllers and devices of the FC configuration can be defined as source and/or target unit.

Format

SHOW- SAN-PATH

FROM = OWN-UNITS / CHANNEL(...) / CONTROLLER(...) / DEVICE(...)
	*CHANNEL(...)
		\|	NAME = <x-text 2..2> / *ALL
	*CONTROLLER(...)
		\|	NAME = <alphanum-name 2..2> / <x-text 2..2> / <x-text 4..4> / *ALL
	*DEVICE(...)
		\|	NAME = <alphanum-name 2..2> / <x-text 4..4>
,TO = ALL-GENERATED / CHANNEL(...) / CONTROLLER(...) / DEVICE(...) / OWN-UNITS / SAN-UNITS
	*CHANNEL(...)
		\|	NAME = <x-text 2..2> / *ALL
	*CONTROLLER(...)
		\|	NAME = <alphanum-name 2..2> / <x-text 2..2> / <x-text 4..4> / *ALL
	*DEVICE(...)
		\|	NAME = <alphanum-name 2..2> / <x-text 4..4>
,INFORMATION = ZONED-PATH / SAN-PATH / *ERROR
,TABLE-UPDATE = NO / YES

Operands

FROM = *OWN-UNITS / *CHANNEL(...) / *CONTROLLER(...) / *DEVICE(...)
Source hardware unit of the FC configuration whose connections to the hardware unit specified in the TO operand are to be checked and displayed.

FROM = *OWN-UNITS
The connections from all generated units in the FC configuration are checked and displayed. It must be borne in mind that this display can be very extensive.

FROM = *CHANNEL(...)
Specifies a channel as the source hardware unit.

NAME = <x-text 2..2>
Channel path ID of the channel (corresponds to the mnemonic)

NAME = *ALL
All channels of the FC configuration.

FROM = *CONTROLLER(...)
Specifies a controller as the source hardware unit.

NAME =
Mnemonic of the controller (<alphanum-name 2..2> / <x-text 4..4>)

NAME = *ALL
All controllers of the FC configuration.

FROM = *DEVICE(...)
Specifies a device as the source hardware unit.

NAME = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic of a device.

TO = *ALL-GENERATED / *CHANNEL(...) / *CONTROLLER(...) / *DEVICE(...) / *OWN-UNITS / *SAN-UNITS
Target hardware unit of the FC configuration for which the connections from the hardware unit specified in the FROM operand are to be checked and displayed.

TO = *ALL-GENERATED
On the basis of the hardware units specified in the FROM operand, all the paths generated in the system are checked and displayed.

TO = *CHANNEL(...)
Specifies a channel as the target hardware unit.

NAME = <x-text 2..2>
Channel path ID of the channel (corresponds to the mnemonic)

NAME = *ALL
All channels of the FC configuration.

TO = *CONTROLLER(...)
Specifies a controller as the target hardware unit.

NAME =
Mnemonic of the controller (<alphanum-name 2..2> / <x-text 4..4>)

NAME = *ALL
All controllers of the FC configuration.

TO = *DEVICE(...)
Specifies a device as the target hardware unit.

NAME = <alphanum-name 2..2> / <x-text 4..4>
Mnemonic of a device.

TO = *OWN-UNITS
When FROM=*CHANNEL, all the connections to the controllers generated in the home system are searched for and displayed in accordance with the specification in the INFORMATION operand.
When FROM=*CONTROLLER or *DEVICE, all the connections to the channels generated in the home system are searched for and displayed in accordance with the specification in the INFORMATION operand.

TO = *SAN-UNITS
All the connections in the SAN are searched for and displayed in accordance with the specification in the INFORMATION operand. The WWPN is displayed in the case of target hardware units which do not belong to the home system.

INFORMATION = *ZONED-PATH / *SAN-PATH / *ERROR
Determines the scope of the information to be displayed.

INFORMATION = *ZONED-PATH
The set of connections is restricted to those which are permitted on the basis of the zoning settings for the fabric.

INFORMATION = *SAN-PATH
All paths in the SAN are ascertained and displayed for the specified source and target units.

INFORMATION = *ERROR
Messages concerning error states in the SAN are displayed for the connection paths which are specified in the statement.
The following are error states:

No input port is found for a specified hardware unit.
A connection between a channel and a controller which, according to the generation, should be possible is not possible in the SAN because the input ports are located in different fabrics or are not in the same zone.
Individual ports on the connection paths between the controller and the channel display error states.

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 INFORMATION=ZONED-PATH/SAN-PATH

The information is displayed in tabular form. The display begins with a header line which names the display columns. Two types of value line are then displayed: A value line for the source hardware unit (FROM operand) and 0 through n value lines for the target hardware units found in the SAN (TO and INFORMATION operands). If a device (*DEVICE) is specified in the FROM operand, all controllers (*CONTROLLER) to which the device is connected are ascertained as source units and the connections to the target units are displayed.

Display column	Function
In the value line for the source hardware unit:
UNIT	Type of hardware unit Possible values: CHN (channel), CTL (controller), DVC (device)
MNEM	Mnemonic of the hardware unit
WWPN / SWITCH	WWPN for which the input port is searched for in the SAN
PORT-ID	Port index of the switch specified in the LINK-N/SWITCH column on which the designated WWPN was found as a link neighbor
LINK-N / SWITCH	Fabric or switch identifier of the switch which contains the port named above. If the source unit is a device, the controller which was ascertained as the source unit for the SAN paths is specified here, prefixed with an arrow (->).
In the value line for the target hardware unit:
WWPN / SWITCH	Switch identifier of the switch of the fabric in which the target unit was found If the switch is not the same as the source unit, an arrow (->) identifies the switch transition point.
PORT-ID	Port index of the switch named in the WWPN/SWITCH column on which the unit specified in the LINK-N/SWITCH column was found
LINK-N / SWITCH	Hardware unit or WWPN of a port which is connected to the port displayed (link neighbor).
PATH-STATE	Status of the connection. Three types of information are displayed. The first display shows the zoning status: Z = The connection is zoned, i.e. in the zoning table ascertained there is a zone which contains the source and target units and their connection ports or there are no zoning restrictions in the fabric (all connections are permissible). N = There is a zoning table but no zone which contains the source and target units and their connection ports. U = Undefined (the zoning data could not be ascertained for the fabric). The second output provides information on switches and ports of all possible connection paths between the source and target units: H = Healthy, i.e. all ports and switches in the connection are active/online/ready. E = Error, i.e. there are switches or ports on the connection paths which are not active/online/ready. All these switches and/or ports are reported using the INFORMATION=*ERROR operand error for the underlying source and target units. U = Undefined (if no connection paths were found; this indicates incomplete switch data). The third display provides information on whether the connection is generated in BS2000. It is displayed only if the target unit belongs to a controller of a channel on the system. G = generated N = not generated

Examples

Outputs for the output unit CHANNEL

//SHOW-SAN-PATH FROM=*CHANNEL(NAME=94),TO=*SAN-UNITS,INF=*ZONED-PATH 
UNIT  MNEM   WWPN / SWITCH      PORT-ID  LINK-N / SWITCH    PATH-STATE
CHN   94     209400000ea08001   001      FAB_03/SWI_02
             SWI_02             000      CTL B401           Z  H  G
             SWI_02             004      CTL 8301           Z  H  G
             SWI_02             005      CTL 8303           Z  H  N
             SWI_02             006      CTL 2100           Z  H  N
             SWI_02             007      CTL 3500           Z  H  N
             SWI_02             007      CTL 3800           Z  H  G
             SWI_02             008      CTL 8801           Z  H  G
             SWI_02             010      CTL 2601           Z  H  G
             SWI_02             010      CTL 2801           Z  H  N
             SWI_02             011      CTL 6C01           Z  H  N
             SWI_02             015      CTL E401           Z  H  G
             SWI_02             022      CTL 3501           Z  H  G
             SWI_02             022      CTL 3801           Z  H  N
             SWI_02             025      CTL 3D00           Z  H  G
             SWI_02             039      CTL 2701           Z  H  N
             SWI_02             039      CTL 2901           Z  H  G
             -> SWI_04          004      CTL 2F41           Z  H  G
             -> SWI_04          006      5006016310600024   Z  H  -
//SHOW-SAN-PATH FROM=*CHANNEL(NAME=94),TO=*CONTROLLER(2F41),INF=*ZONED-PATH 
UNIT  MNEM   WWPN / SWITCH      PORT-ID  LINK-N / SWITCH    PATH-STATE 
CHN   94     209400000ea08001   001      FAB_04/SWI_02
             -> SWI_04          004      CTL 2F41           Z  H  G
5 switch connection pathes in FAB_04 from SWI_02 to SWI_04:
Path 1: S_02-> S_01-> S_04
Path 2: S_02-> S_01-> S_03-> S_04
Path 3: S_02-> S_03-> S_01-> S_04
Path 4: S_02-> S_03-> S_04
Path 5: S_02-> S_04

If source and target unit (which are connected to different switches of a fabric) were specified explicitly, all the possible connections in the fabric are output.

Output for the output unit CONTROLLER

//SHOW-SAN-PATH  FROM=*CONTROLLER(3801),TO=*ALL-GENERATED,INF=*SAN-PATH
UNIT  MNEM   WWPN / SWITCH      PORT-ID  LINK-N / SWITCH    PATH-STATE
CTL   3801   5006048448586c0e   022      FAB_04/SWI_02
             SWI_02             003      CHN 54             N  H  G
CTL   3801   5006048448586c0d   021      FAB_03/SWI_03
             SWI_03             002      CHN 90             Z  H  G

Output for the output unit DEVICE

//SHOW-SAN-PATH FROM=*DEVICE(8805),TO=*ALL-GENERATED,INF=*SAN-PATH
UNIT  MNEM   WWPN / SWITCH      PORT-ID  LINK-N / SWITCH    PATH-STATE 
DVC   8805                               -> CTL 8800 
CTL   8800   5006048441199e9b   004      FAB_03/SWI_01 
             SWI_01             002      CHN 90             Z  H  G 
             SWI_01             001      CHN 10             Z  H  G 
             SWI_01             012      CHN 50             Z  H  G 
DVC   8805                               -> CTL 8801 
CTL   8801   5006048441199eab   008      FAB_04/SWI_02 
             SWI_02             001      CHN 94             Z  H  G 
             SWI_02             002      CHN 14             Z  H  G 
             SWI_02             003      CHN 54             Z  H  G 
TSOS-Type    : X'A500' 
serial number: 01050 
volume number: 125 (X'007D') 
lun          : 5 (X'0005')

Type-dependent additional information (if any is available in the system) is also displayed for the devices.

Output for INFORMATION=ERROR*

//SHOW-SAN-PATH INFORMATION=*ERROR 
%  SAN0P01 NO ENTRY PORT FOR 'CONTROLLER' 'TE' FOUND IN THE SAN-CONFIGURATION 
(WWPN = 5005076313601B47 )
%  SAN0P01 NO ENTRY PORT FOR 'CONTROLLER' '8801' FOUND IN THE SAN-
CONFIGURATION (WWPN = 5006048441199000 )
%  SAN0P01 NO ENTRY PORT FOR 'CONTROLLER' '8800' FOUND IN THE SAN-
CONFIGURATION (WWPN = 5006048441199000 )
%  SAN0P01 NO ENTRY PORT FOR 'CHANNEL' 'FE' FOUND IN THE SAN-CONFIGURATION 
(WWPN = 20FE00000EA08001 )
%  SAN0P03 CONNECTION BETWEEN 'CHANNEL' '9C' AND 'CONTROLLER' 'TF' NOT ZONED 
%  SAN0P03 CONNECTION BETWEEN 'CHANNEL' '9C' AND 'CONTROLLER' 'T2' NOT ZONED 
%  SAN0P03 CONNECTION BETWEEN 'CHANNEL' '9C' AND 'CONTROLLER' 'T3' NOT ZONED 
%  SAN0P03 CONNECTION BETWEEN 'CHANNEL' '54' AND 'CONTROLLER' '3801' NOT 
ZONED
%  SAN0P04 ENTRY PORTS OF  'CHANNEL' '94' AND 'CONTROLLER' '8801' BELONG TO 
DIFFERENT FABRICS
%  SAN0P04 ENTRY PORTS OF  'CHANNEL' '90' AND 'CONTROLLER' '8801' BELONG TO 
DIFFERENT FABRICS
%  SAN0P04 ENTRY PORTS OF  'CHANNEL' '14' AND 'CONTROLLER' '8800' BELONG TO 
DIFFERENT FABRICS 
%  SAN0S21 PORT WITH PORT-ID '07' , SWITCH-ID '02' AND FABRIC-ID '03' 
INDICATES STATE 'NOT ONLINE'

Messages are issued which display problems in the generated FC configuration and its connections in the SAN.

Your Browser is not longer supported

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

SHOW-SAN-PATH - Checking and displaying hardware connections in the SAN

Format

Operands

Output format when INFORMATION=ZONED-PATH/SAN-PATH

Examples

Outputs for the output unit CHANNEL

Output for the output unit CONTROLLER

Output for the output unit DEVICE

Output for INFORMATION=ERROR*

Your Browser is not longer supported

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

SHOW-SAN-PATH - Checking and displaying hardware connections in the SAN

Format

Operands

Output format when INFORMATION=*ZONED-PATH/*SAN-PATH

Examples

Outputs for the output unit CHANNEL

Output for the output unit CONTROLLER

Output for the output unit DEVICE

Output for INFORMATION=*ERROR

Output format when INFORMATION=ZONED-PATH/SAN-PATH

Output for INFORMATION=ERROR*