Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY PORTS PORTADDR—Query ESCON/FICON Switch Ports

QUERY PORTS PORTADDR—Query ESCON/FICON Switch Ports

The QUERY PORTS PORTADDR command obtains information on a range of ESCON/FICON switch ports for a specific switch device.

This command has the following format:

QUERY PORTS PORTADDR(fromport|*,toport|*) {SWITCH(devid)}

PORTADDR

Specifies a range of port addresses (00-FF) such as PORTADDR(C0,DF). If the PORTADDR keyword is omitted, then the default is PORTADDR(*,*).

fromport|*

Defaults to 00 when * is specified.

toport|*

Defaults to FF when * is specified. If omitted, then the fromport specification is copied.

SWITCH

Contains the switch device ID obtained from the QUERY SWITCHES command or other switch-connected device commands.

Created stem variables:

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

• Port number - Two printable hex characters 00-FF.
• Port address - Two printable hex characters 00-FF.
• Port descriptor - Eight printable hex characters. Same structure as port descriptor words returned by QUERY SWITCH.
• Dedicated port address - Two printable hex characters 00-FF. Only valid when port is marked as dedicated in the port descriptor.
• Port prohibit mask - 256 character string of Y and N characters.

  Y - Prohibits dynamic connections

  N - Allows dynamic connections

  The position of each character in the mask maps to the port address range 00-FF. For example, the second character in the string indicates (Y/N) whether the current port is prohibited from dynamically connecting to port address 01.

• Port name - 1-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.
• Port DCM Flag - Two hex character flag byte with dynamic channel management information for the port.

  '80'x = Port is installed

  '40'x = Offline to DCM by command

  '20'x = Offline to DCM by system

  '10'x = Ineligible for use by DCM

  '04'x = Attached to a channel

  '02'x = Attached to control units

  '01'x = Neither channel nor control unit attached

• Port Misc Flag - Two hex character flag byte with additional connection information for the port.

  '80'x = Channel is known on a local system

  '40'x = Port is an E-port connected to another switch.

• Port ChpID - Two hex character ChpID number when the port is connected to a channel. Only valid if the DCM flag indicates that a channel is attached to the port.
• Node device type - small integer

  0 = Unspecified

  1 = I/O Device

  2 = Control unit

• Node device class - small integer

  0 = Unspecified

  1 = DASD

  2 = Magnetic tape

  3 = Unit record (input)

  4 = Unit record (output)

  5 = Printer

  6 = Communications controller

  7 = Full screen terminal

  8 = Line mode terminal

  9 = Channel-to-channel adapter

  10 = Switch

• Node identifier - the attached device node ID string.