Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY CONTROLUNITS—Query Global Control Unit

QUERY CONTROLUNITS—Query Global Control Unit

The QUERY CONTROLUNITS command obtains global control unit information for the following:

• A specific control unit or device by the DevID
• A range of control units based on the global relative position number assigned by SOF for all known control units.

You can use the range form of this command for limiting the amount of output per command. Output may be continued by starting at the next sequential relative position number. If CONTROLUNIT and DEVICE are omitted and STARTPOS is not specified, then STARTPOS defaults to (0,65535).

This command has the following format:

QUERY CONTROLUNITS
  [CONROLUNIT(devid)|DEVICE(devid)|STARTPOS
  (global relative position number, count of CUs to return)]

Created stem variables:

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

• Global relative position number - Contains integer
• CU identifier - Contains the CU DevID string.

  For more information see the section Device ID String Composition in this chapter.

• Connected devices count - Contains integer
• Connected switches count - Contains integer
• Connected systems count - Contains integer