Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY DEVICES—Query Specific Global Device

QUERY DEVICES—Query Specific Global Device

The QUERY DEVICES command obtains global device information for a specific device or for a range of devices based on the global relative position number assigned by SOF for all known devices.

Filtering capabilities are as follows:

• The device ID components filter the device selection within the range of devices. Wildcard filtering is supported by the same wildcard matching characters and rules as the OPSLIKE REXX function.
• The range and filter form of this command limits the amount of output per command. Continue the output by starting at the next sequential relative position number. If DEVICE is omitted and STARTPOS is not specified, then STARTPOS defaults to (0,64).
• The optional BACKWARD keyword scans for devices with global relative position numbers less than or equal to the STARTPOS value.

This command has the following format:

QUERY DEVICES
  [DEVICE(devid)|STARTPOS(global relative position number,
   count of devices to return) BACKWARD]
  [FILTERBY(devtype,devmodel,devmfg,devplant,devserial,devtag)]

Created stem variables: See the QUERY DEVICES CONTROLUNIT command request.