Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY SWITCHES—Query ESCON/FICON Switch by Device ID

QUERY SWITCHES—Query ESCON/FICON Switch by Device ID

The QUERY SWITCHES command obtains global ESCON/FICON switch information for a specific switch by device ID or for a range of switches based on the global relative position number assigned by SOF for all known switches. Use the range form of this command to limit the amount of output per command. Output may be continued by starting at the next sequential relative position number. If SWITCH is omitted and STARTPOS is not specified, then STARTPOS defaults to (0,65535).

This command has the following format:

QUERY SWITCHES

[SWITCH(devid)|STARTPOS(global relative position number,
count of switches to return)]

Created stem variables:

The output stem variable records will have the following word delimited fields for each GLOBAL switch information record returned by the SOF server.

• Relative position number - Specified as integer.
• Switch name - Contains 1 to 24 characters or N/A. Imbedded blanks in the name are translated to 'FE'x and need to be translated back to blanks for display and commands.
• Switch identifier - Contains the switch DevID string.
• Ports implemented - Contains small integer 0-255
• Ports installed - Contains small integer 0-255
• ChpIDs attached - Contains small integer 0-255
• Control units attached - Contains small integer 0-255
• Systems attached - Contains small integer 0-255
• 1 byte status flag expressed as 2 byte printable hexadecimal. Multiple flag settings may be combined. The flag indicators are defined as follows:

  '80'x = switch could not be allocated

  '40'x = switch is offline

  '20'x = SW_SWNUM contains global switch number

  '10'x = switch is virtual

  '08'x = FICON switch

• 256 words of eight-character port descriptors in printable hexadecimal. The port descriptor consists of the following substring fields:
  • 1-2 Port attribute flag

    '80'x = port is not installed

    '40'x = port is blocked

    '20'x = port is prohibited for dynamic connections

    '10'x = port has a dedicated connection

    '08'x = port number and address are valid

    '05'x = FICON port

    '04'x = external laser port

    '03'x = external LED port

    '01'x = internal port

    '00'x = unknown or not installed port

  • 3-4 Port hardware status flag

    '80'x = port not installed

    '40'x = port link failure

    '20'x = spare port

    '10'x = port is offline

    '08'x = port is in maintenance mode

    '04'x = control unit is connected to port

    '02'x = port requires service

    '01'x = invalid port attachment

  • 5-7 Port number 00-FF
  • 7-8 Port address 00-FF

Note: Port addresses are not necessarily the same as their physical port numbers