tcp.port

function

Library: TCP/IP client and server support (OMTCP)
Import : omtcp.xmd

Returns:


Declaration
define external integer function tcp.port
   of value tcp.service Service

Argument definitions

Service
is an existing tcp.service object.


Purpose

Use tcp.port to learn which port number the TCP service object listens on for incoming connections.

Requirements

Service must represent an existing service (else external exception TCP05).

Usage Notes

This API is particularly useful when you call tcp.create-service without specifying a port.

Example


  import "omtcp.xmd" prefixed by tcp.
  
  process
     local tcp.service Demo
     local integer Port
  
     set Demo to tcp.create-service
     set Port to tcp.port of Demo
     output "The selected service port for Demo is %d(Port)%n"