Intel ZT 4901 Network Router User Manual


 
66 High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification
Redundant Host API
Synopsis:
This function requests domain software connection. It initiates software connection for the
specified domains:
Startup of all devices in the domain
Creation of corresponding software representation for devices (device objects and so forth)
If software disconnection is in progress for this domain, this function cancels the software
disconnection
This function just initiates the software connection–it does not wait for its completion. The
function RhGetDomainSwConnectionStatus can be used to poll the progress of the pending
connection. Alternatively, the notification functions provide a callback-based notification
approach. See Section 6.2.6, “Notification, Reporting and Alarms” on page 70 for more
information on these functions.
In the cooperative switchover scenario, this function should be called for the domains that have
been software disconnected if the switchover is being cancelled (for example, because another
domain specified in the switchover request cannot be software disconnected).
The function can be called on a host that does not own the domain; in that case, the request may be
forwarded to the owning host via an applicable inter-host communication channel. However, the
same host must own all specified domains.
6.2.5.4 RhGetDomainSwConnectionStatus
Prototype:
HSI_STATUS
RhGetDomainSwConnectionStatus(
IN RH_HANDLE Handle,
IN uint32 Domain,
OUT RH_DOMAIN_SWC_STATE *pState );
Arguments:
Handle – the handle of the current session
Domain – the number of the domain to query state
pState – pointer to the variable that receives the state
Return Value:
HSI_STATUS_SUCCESS
returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle or the specified domain does not exist
HSI_STATUS_NOT_SUPPORTED
returned if this function is not supported by the infrastructure
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis: