Technical information

Datasubscriptionandremotecontrol
Response
TheserverapplicationwillrespondwithaResponsemessagecontainingatleastthe
clientidiftheconnectcommandsucceeded,oranerroriftheconnectcommand
failed.Thecontentsofthevariouspartsofaresponsemessageforasuccessfulconnect
commandisshownbelow.
structResponse
{
charHeader[4];//”RES\0”
charRequest[4];//”CON/0”
charMsgControl[22];//”\0”
charMsgResponse[1400];
//Responsetextcontainingresultof
//connectionrequest
};
MsgResponse
ThecontentsoftheMsgResponseeldconsistofResultCodeandParameters.
ResultCode:Resultoftheoperation.Thefollowingvaluescanbepresent:
•S_OK:operationwassuccessful
•E_ACCESSDENIED:operationfailedduetounknownaccountorwrongpassword
•E_FAIL:operationfailedduetoanunspeciederror
Parameters:Commaseparatedlistofvariousname:valuepairsthatmaybepresent,only
providediftheConnectRequestissuccessful.
•ClientID:identicationofthecurrentclient,tobeusedinallfurthercommunication
withtheserverapplication
•AccessLevel:generalaccesslevelforthecurrentclient
AsuccessfulconnectionwillforexampleprovideaMsgResponsecontaining:
ResultCode:S_OK,
Parameters:{ClientID:1,AccessLevel:1}\0
Connectionfailure
Incasetheconnectcommandfails,theResponseFieldwillcontainaResultInfoeld.
ResultInfo:Textdescribingthefailure
Keepconnectionalive
Oncetheclientapplicationisconnectedtotheserverapplicationatwo-waymonitoring
oftheapplicationandcommunication”health”mustbestarted.Thismeansthatboththe
clientandtheserverapplicationmustsendan”alive”message,AliveReport,periodically
(eachsecond).
164692/D
203