Host Environment Commands › ADDRESS SOF—Manage Devices › QUERY SOF Request Types › QUERY DEVICES CONTROLUNIT—Query Range of Control Unit Attached Devices

QUERY DEVICES CONTROLUNIT—Query Range of Control Unit Attached Devices

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

Selection of devices within the range of devices requested can be filtered by the device ID components. Wildcard filtering is supported using the same wildcard matching characters and rules as the OPSLIKE REXX function. The range and filter form of this command are useful for limiting the amount of output per command. Output may be continued by starting at the next sequential relative position number. If STARTPOS is not specified, then STARTPOS defaults to (0,64). The optional BACKWARD keyword results in scanning for devices with global relative position numbers less than or equal to the STARTPOS value.

This command has the following format:

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

Created stem variables:

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

• Global relative position number - Contains integer data
• Device identifier - Contains the device DevID string.
• Device connected system count - Contains integer data
• Device CU connections count - Contains integer data

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