Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY DEVICES LOCAL DEVICE—Query Device ID

QUERY DEVICES LOCAL DEVICE—Query Device ID

The QUERY DEVICES LOCAL DEVICE command obtains local system device information for a specific device by device ID for each system on which the device is defined.

This command has the following format:

QUERY DEVICES LOCAL DEVICE(devid)

Created stem variables:

The output stem variable records have the following word delimited fields for each local device information record that is returned by the SOF server. In addition, the simple variable name, stemTOT contains the total number of local devices available for retrieval.

CCI system name

Contains one to eight characters.

Device number

Contains four printable hex characters.

Device identifier

Contains the device DevID string.

Device UCB type

Contains eight printable hex characters. This value is mapped by the UCBTYP field in the IEFUCBOB macro.

Device Type

Contains the one- to eight-character device type determined by the EDTINFO macro using the UCB device type.

Device last known status

Contains two printable hex characters that contain the device status. This value is mapped by the UCBSTAT field in the IEFUCBOB macro.

Device last known volser

Contains one to six characters or N/A.

CU connection count

Contains small integer.

ChpID connection count

Contains small integer.

ChpID connections array

Contains 16 printable hex characters. Eight occurrences of ChpID where each occurrence is a two-character hexadecimal ChpID number or 00. The number of valid ChpIDs is determined by the ChpID connection count.

ChpID status bit flag array

16 printable hex characters. Eight occurrences of ChpID status bits flag where each occurrence is a two-character hexadecimal value. The value meanings are defined in the IOSDPATH macro at label PATHBITS.

ChpID type array

16 printable hex characters. Eight occurrences of ChpID channel type where each occurrence is a two-character hexadecimal value. Value meanings are defined in the IOSDPATH macro at label PATHINTTYPE.

ChpID port array

16 printable hex characters. Eight occurrences of port address where each occurrence is a two-character hexadecimal value.

CU port array

16 printable hex characters. Eight occurrences of switch port number where each occurrence is a two-character hexadecimal port number or 00.

CU connections array

32 printable hex characters. Eight occurrences of CU number where each occurrence is a four-character hexadecimal CU number or 0000. The number of valid CUs is determined by the CU connection count.

Logical path mask

Eight-byte string consisting of the letters Y and N representing bit settings 1 and 0 in the LPM.

CU switch array

Contains 16 printable hex characters. Eight occurrences of CU switch number where each occurrence is a two-character hexadecimal CU switch number or 00. The number of valid CU switch numbers is determined by the ChpID connection count.

CU switch devid array

Contains 240 printable hex characters. Eight occurrences of CU switch device ID where each occurrence is a thirty-character CU switch device ID or ‘N/A---------------------------‘. The number of valid CU switch device ids is determined by the ChpID connection count.