TCP Create Listener Function
- Updated2025-07-30
- 3 minute(s) read
Creates a listener for a TCP network connection. Wire 0 to the port input to dynamically choose an available TCP port the operating system determines is valid for use. Use the TCP Open Connection to query the NI Service Locator for the port number registered with the service name.

Inputs/Outputs
net address
—
net address specifies on which network address to listen. Specifying an address is useful if you have more than one network card, such as two Ethernet cards, and want to listen only on the card with the specified address. If you do not specify a network address, LabVIEW listens on all network addresses. Use the String To IP function to obtain the IP network address of the current computer.
service name
—
service name creates a known reference for the port number. If you specify a service name, LabVIEW registers the service name and the port number with the NI Service Locator.
port
—
port is the port number on which you want to listen for a connection.
timeout ms (25000)
—
timeout ms specifies the time, in milliseconds, that the function waits before the function completes and returns an error. The default value is 25,000 ms or 25 seconds. A value of -1 indicates to wait indefinitely.
error in (no error)
—
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
listener ID
—
listener ID is a network connection refnum that uniquely identifies the listener.
port
—
port returns the port number the function used. If the input port is not zero, the output port number equals the input port number. Wire 0 to the port input to dynamically choose an available TCP port the operating system determines is valid for use. As defined by the Internet Assigned Numbers Authority (IANA), valid port numbers are between the range of 49152 through 65535. Well Known Ports are between the range of 0 through 1023 and Registered Ports are between the range of 1024 through 49151. Not all operating systems follow the IANA standard; for example, Windows returns dynamic ports between the range of 1024 through 5000.
error out
—
error out contains error information. This output provides standard error out functionality. |
Examples
Refer to the following example files included with LabVIEW.
- labview\examples\Data Communication\Protocols\TCP\TCP Named Service\TCP Named Service.lvproj
net address
—
service name
—
port
—
timeout ms (25000)
—
error in (no error)
—
listener ID
—
port
—
error out
—