srv_send_ctlinfo

Sends control messages to Client-Library.

CS_RETCODE srv_send_ctlinfo(SRV_PROC *srvproc, CS_INT
ctl_type, CS_INT paramcnt, SRV_CTLITEM *param)

ctl_type

An enumerated type with the following values:

SRV_CTL_LOGINREDIRECT

Only valid during a connect handler. When used, a SRV_PROC for which SRV_T_REDIRECT is true will instruct the client to restart login using the passed-in server addresses.
SRV_CTL_HAUPDATE

Valid at any time srv_sendinfo is valid. When the server sends this message to a client, the client will replace its current HA failover target information with the server connection information as expressed via param.

paramcnt

The number of elements in the param array

param

Added to pass library control message parameters. It has the following fields:

SRV_CTLTYPES srv_ctlitemtype, where srv_ctlitemtype indicates the parameter type. The following types are available:
- SRV_CT_SERVERNAME, which indicates that srv_ctlptr points to a CS_CHAR string containing the name of the server whose address will be looked up.
- SRV_CT_TRANADDR, which indicates that srv_ctlptr points to a CS_TRANADDR structure containing the server address information.
- SRV_CT_ADDRSTR, which indicates that srv_ctlptr points to a string formated by srv_getserverbyname.
- SRV_CT_OPTION, which indicates that srv_ctlptr points to a CS_INT bitmask that contains a set of options for this message.

CS_INT srv_ctllength, which is the length of variable size parameters. This is currently SRV_CT_SERVERNAME and SRV_CT_ADDRSTR, where CS_NULLTERM is a valid length.