Using TCP Adapters with Ensemble - InterSystems Documentation

Available Helper Methods3. When you want to call one of the methods in EnsLib.TCP.TextLineOutboundAdapter, use the Adapter property to identifythe adapter object. In the following example, the Demo.Loan.FindRateTCPOperation class calls theEnsLib.TCP.TextLineOutboundAdapter method SendMessageString:/// Send an approval to the output TCP listenerMethod TCPSendReply(pRequest As Demo.Loan.Msg.SendReply,Output pResponse As Ens.Response) As %Status{Set tSC=..Adapter.SendMessageString(pRequest.Text)}Quit tSCYou can use similar syntax to call any of the EnsLib.TCP.TextLineOutboundAdapter methods described in “AvailableHelper Methods.”4. Optionally, you may implement the OnConnect() callback method in your business operation class.OnConnect() is available for a TCP outbound adapter to call back to its associated business operation. If present inthe business operation, this method is called each time the TCP outbound adapter establishes a new connection to orfrom a remote system.If you add an OnConnect() method to your business operation class, it must have the following signature:Method OnConnect(pTimeout As %Numeric) As %StatusImplement an OnConnect() method in your business operation if you need to take some action each time a new connectionis established, for example to send a logon sequence or a handshake token. The timeout argument is automaticallyprovided by the TCP outbound adapter. It takes its value from the ConnectTimeout adapter setting. For details, see“Adapter Settings.”Returning an error status from OnConnect() causes the new connection to fail and be disconnected. If an untrappedexception occurs within OnConnect(), the adapter catches it and continues as if OnConnect() were not implemented.5. Compile your new business operation class. Compiling also saves it.6. After creating and compiling the business operation class in Studio, add an instance of the business operation to theproduction and configure it using the Management Portal. See the appendix “Common Tasks in the ManagementPortal.”7.4 Available Helper MethodsWhen your business operation class references the EnsLib.TCP.TextLineOutboundAdapter, the following adapter methodsbecome available. You can call these adapter methods from the methods in your business operation class using the Adapterproperty as described in the previous section:Connect()Method Connect(pTimeout As %Numeric) As %StatusConnect() opens a TCP socket to a port on the TCP listener machine. Connect() has one input argument, a%Numeric value that identifies the number of seconds to wait for the connection attempt to succeed. A typical callto the Connect() method gives this input argument the value of the configurable ConnectTimeout property.If the StayConnected adapter setting is set to –1, the Ensemble framework will create the connection automaticallyat startup time, from within the OnInit() method.Using TCP Adapters with Ensemble 47