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 will have the following word delimited fields for each local device information record returned by the SOF server. In addition the simple variable name, stemTOT will contain 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.
