Synopsis:
SsendDGRAM(sock,addr,port,data,no_bytes,[data1[,data2...])
Arguments:
socket - The socket handle
addr - The IP address to send data to
port - The IP port to send data to
data - The data string to send
no_bytes - The number of bytes to send
[data1[,data2..]] - Optional additional data to send if data to send exceeds maximum Telecom Engine string length
Description: This function allows for a connectionless datagram message to be sent to the specified addr and port. The data to send is passed in the data variable and the number of bytes to send is specified by the argument no_bytes. However if more data needs to be sent than can be fit into a single Telecom Engine string variable then addtional data can be sent by specifying the optional [data1[,data2...] arguments. These additional data arguments will be simple appended to the first data argument and sent out in a single send command. Note however that the same effect can be achieved by issuing multiple SsendDGRAM() commands.
Note that datagrams do not guarantee that the data will be delivered to the far end so should only be used over a reliable network for non-essential message (or else an underlying protocol (for example using acknowledgements and timeouts) should be implemented).
Returns: Returns 0 on success or negative error code. Not that a 0 return value only indicates that the data was sent succesfully, it does not gaurantee that the data will get to the other end.