Class Reference
IRIS for UNIX 2024.1.2
InterSystems: The power behind what matters   
Documentation  Search
  [USER] >  [%IO] >  [ServerSocket]
Private  Storage   

class %IO.ServerSocket extends %IO.DeviceStream, %IO.IParts.ServerSocketIO, %IO.SocketCommon

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
9


Summary

Properties
AllowedClientIPAddresses AtEnd CharEncoding ConnectionQueueSize
DefaultFlushOnWrite DisconnectHandler InputBufferSize IsCharacter
IsConnected IsOpen IsSingleByte KeepAliveInterval
LineTerminator LocalInterface Name OutputBufferSize
Port Remote SSLConfig TCPReceiveBuffer
TCPSendBuffer TranslationTable

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
Attach AttachNew CharEncodingSet Close
CopyFrom CopyReplace CopyReplaceArray DefaultFlushOnWriteGet
Disconnect Flush GetCharEncodingTable GetDeviceLineTerminator
GetDeviceTranslationTable GetLocalInterfaces GetLocaleDefaultTable GetTableCharEncoding
InputFromDevice IsCharacterGet IsLocaleUnicode IsTableSingleByte
Listen ListenJob Open OutputToDevice
Read ReadAny ReadLine ReadUntil
ReadUntilArray SetCharEncodingTable SetDeviceLineTerminator SetDeviceTranslationTable
SetTranslationTable TranslationTableSet Write WriteLine


Methods

• method Close(Output pSC As %Status) as %Boolean
Disconnect the current connection and close the Socket for listening. Any connections the OS may have accepted for the current port and queued for us will be disconnected as well.
• method Disconnect(Output pSC As %Status, pIntentional As %Boolean = 1, pSCReason As %Status = $$$OK)
Disconnect the current connection but keep the socket open for listening
• method Listen(ByRef pTimeout As %Numeric = -1, Output pSC As %Status) as %Boolean
Until pTimeout, wait for an inbound TCP connection to be received on the port specified in the prior Open() call. Note that the OS may accept up to ConnectionQueueSize connections for the port on your behalf before you call this method. If the OS has queued one or more accepted connections, this method will return immediately with one of them connected.
• method ListenJob(ByRef pTimeout As %Numeric = -1, pOnConnectedClass As %String, pJobArgs As %String = "", pSocketClass As %String = "%IO.ServerSocket", pMaxJobs As %Integer = -1, pDummy As %Boolean, Output pSC As %Status) as %Integer
Until pTimeout, listen for incoming connections and spawn a job for each one, up to pMaxJobs. If pMaxJobs threshold has already been reached, wait for an existing connected job to quit and then spawn a job for the new connection. When the timeout expires, this method will return but any spawned jobs will continue running until they terminate on their own. pOnConnectedClass is the classname of a customer defined class that must contain a classmethod called OnConnected(). ListenJob() will arrange for this classmethod to be called each time a new connection arrives. It will call OnConnected() with 2 arguments, a %IO.ServerSocket instance representing the connected socket, and a string that was passed in to ListenJob() in the pJobArgs argument. This allows the OnConnected() method to engage in TCP communications over the socket from within a fresh job created for the purpose. The pSocketClass argument to ListenJob() allows you to specify a subclass of %IO.ServerSocket should be instantiated in the connection jobs. This could implement additional methods for handling common protocol elements expected to be exchanged across the TCP connection. Normally you will just use %IO.ServerSocket and its Read() and Write() methods. The pDummy argument is ignored.
• method Open(pPort As %String = "", ByRef pTimeout As %Numeric = -1, Output pSC As %Status) as %Boolean
Open the socket for listening on the port given by pPort, waiting up to pTimeout for the port to be available to listen on.


Copyright (c) 2025 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.