Command group | Flag affected | Reversible | Execute on client | Platform(s) |
---|---|---|---|---|
External commands | YES | NO | NO | All |
TCPBind (socket,service|port) Returns status
Note: The flag is set according to whether Omnis was able to make a call to this external command.
This Web command is multi-threaded, allowing another thread to execute in the multi-threaded server while it runs. Note that the same socket cannot safely be used concurrently by more than one thread.
TCPBind binds a socket created with TCPSocket to a particular local port.
Socket is an Omnis Long Integer field, containing the number of the socket.
Service/Port is either an Omnis integer field containing the number of the port to which the socket should be bound, or an Omnis character field containing the name of a service which will be resolved to a port number by a local lookup.
Status is an Omnis Long Integer field which receives the value zero for success, or an error code < 0 for failure. Possible error codes are listed in the Web Command Error Codes Appendix.
# Get the next available socket and bind it to port iPort
Calculate iPort as 6000
TCPSocket Returns iSocket
TCPBind (iSocket,iPort) Returns lStatus