Artesyn System Management Interface Based on HPI-B (Centellis CO 31kX-4100-2000-4410) (June 2014) - Manual (Page 50)

Using HPI-B
System Management Interface Based on HPI-B (Centellis CO31kX/4100/2000/4410) User’s Guide 50
4.3.4 Discovering Shelves and Domains
As previously mentioned, one way to discover available domains is to use the Domain
Reference Table. For further details, refer to the SAI-HPI-B.02.01 specification document.
Alternatively, you can use the Shelf Management Resources defined in the default domain. Any
shelves that were added to the HPI environment are represented by one Shelf Management
Resource with the entry ResourceCapability set to SAHPI_CAPABILITY_DOMAIN. So in order to
discover shelves/domains, you simply need to parse the default domain for HPI resources with
the entry ResourceCapability set to SAHPI_CAPABILITY_DOMAIN. Then you can obtain the
respective domain ID by reading the entry DomainId and open a session to the shelf using the
obtained domain ID.
4.3.5 Adding and Removing Shelves and Domains
All shelves which are used by the HPI multishelf library are listed in the multishelf library
configuration file. There are two ways of adding and removing shelves:
 Manually by editing the multishelf configuration file. Changes become effective after the
next restart in this case.
 Dynamically by using the HPI domain management control
For a description of how to manually edit the multishelf library configuration file, refer to
Configuring HPI Clients on page 31 .
A description of how to dynamically add and remove shelves, is given in the following two
subsections.
4.3.5.1 Adding Shelves and Domains
In order to dynamically add a shelf and create a domain, you must invoke the HPI function
saHpiControlStateSet()
and provide the following parameters.
Parameter Value
SessionId
Handle to session context.
ResourceId
Resource ID of the addressed resource.
CtrlNum
Number of the control for which the state is
being set.