List Component commands request a list of the components in a system. This command can be used to return all components in a system or only those with a certain group class. Calls for all components are referred to as unfiltered, and calls for a specific group class are filtered.

There are three List Component commands:

DmiListComponentCmd

Requests data for a specific component.
DmiListFirstComponentCmd
Requests data for the first component in a system. The component with the lowest component ID is considered the first component in the system. This will always be the service layer itself, which always has component ID of 1. The service layer fills in as many component definitions as the size of the confirm buffer allows.
DmiListNextComponentCmd
Requests data for the component instrumentation whose ID is the next highest value after the one passed in the DmiListComponentCmd block. The service layer fills in as many component definitions as the size of the confirm buffer allows.

For a description of the DmiListComponentReq block used to issue these List commands, read DmiListComponentReq Command Block.

The service layer does not contact any component instrumentation when performing List commands. It relies on the MIF database for all information. When specifying keys that require components to be run before the values can be determined, the service layer returns the key as a possible match. Any matches from data in the MIF database are listed as hard matches. It is the responsibility of the management application to follow up with each component instrumentation and convert possible matches into hard matches.

---

[Back] [Next]