Specifications

Chapter 18. TCP/IP
485
Syntax:
CALL "SOCKET.FN3" .fcSendto SOCKFD%, SENDBUFF$[()],
SENDLEN%, SENDMODE%, FAMILY%, PORT%, address,
SENDSIZE%
where address is ADDRESS or IPADDRESS$
Description: This function transmits data from the specified buffer to the IP address and
port number connected to the specified socket identifier.
BSD4.4 socket API equivalent: This function is equivalent to the BSD4.4
socket API sendto() function.
Parameters:
SOCKFD% Socket identifier
SENDBUFF$[()] Transmit buffer
SENDLEN% Number of bytes to transmit
SENDMODE% Transmit mode
FAMILY% Protocol family
PORT% Port
ADDRESS Local address for connection
IPADDRESS$ Internet address in dotted quad notation
The transmit buffer (
SENDBUFF$) can be either a string non-array or
string array variable. The maximum size for a string non-array is 255
bytes; for a string array, 1472.
The transmit mode (
SENDMODE%) must be one of the following values:
The protocol family (
FAMILY%) must be 2, the value indicating the ARPA
Internet protocols.
Return value:
SENDSIZE% Number of bytes transmitted
Run-time errors:
.fcSendto Send message to another UDP socket
.soSdNrm 0 Normal
.soSdDnRt 4 Bypass pathway control function
.soINet 2 ARPA Internet protocols
Error code Meaning
105h
Power-off detected
209h
Socket identifier is invalid.
216h
A parameter is invalid.
228h
The maximum number of bytes to receive is too small.
229h
TCP is the wrong protocol here.
237h
There is insufficient system area memory.
241h
There is no connection pathway to the host.