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.4RhGetDomainSwConnectionStatus

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:

66

High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification

Page 66
Image 66
Intel ZT 4901 manual RhGetDomainSwConnectionStatus