User's Manual

Boomer II User Manual & Integrator’s Guide ______________________Appendix B – SDK NCL-API and Port Server
BM210012WT37 99 Copyright Wavenet Technology © November 2003
 Close Session
Applications can call this function to close its session with the VDD.
An application should call this function before it terminates if a session
was earlier established with the VDD. The reason for this in the
multisession API is to ensure that all created MSMQ queues for the
client are deleted. This will prevent irrelevant/outdated messages from
being posted to inactive MSMQ queues. In the singlesession API, this
call will close the serial port, allowing another application to use it.
Prototype:
int VDDClose(void);
Description:
Close a session with the VDD.
Input:
 None
Output:
 Return value = 0 Operation was successful
 Return value ≠ 0 Operation failed. Value specifies the error type
 Send Data to a Radio Host
Applications can call this function to send data to a radio host. The
Host ID will automatically be inserted into the data header of the SDU
for message routing purposes.
Prototype:
int nclSendData(word *usSduTag, byte *szHostId, byte ucIdLen, byte
*ucData, int iDatLen, bool bResend);
Response:
The VDD will track the response with the Host ID and SDU tag will
post the response to the corresponding RX queue for that session. The
application is responsible for reading and processing the response on
the RX queue. By calling ‘nclReceiveData()’.