Using TCP Adapters with Ensemble - InterSystems Documentation

More documents

Recommendations

Info

Creating Custom TCP Adapter ClassesOnInit()Method OnInit() As %StatusThe Ensemble framework calls OnInit() after creating the outbound adapter object and setting its configurableproperty values. The OnInit() method provides a way for an outbound adapter to perform any special setup actions.Depending on the values of the relevant adapter settings, one of these actions might be to open a socket to a porton the TCP listener.OnTearDown()Method OnTearDown() As %StatusThe Ensemble framework calls OnTearDown() during shutdown, before destroying the outbound adapter object.The OnTearDown() method provides a way for an outbound adapter to perform any special cleanup actions suchas disconnecting from the TCP listener.54 Using TCP Adapters with Ensemble
ASettings for the Abstract TCP AdaptersFor reference, this appendix describes the settings defined in the two abstract TCP adapters:• Settings for EnsLib.TCP.InboundAdapter• Settings for EnsLib.TCP.OutboundAdapterA.1 Settings for EnsLib.TCP.InboundAdapterThis topic describes the settings that are specific to the EnsLib.TCP.InboundAdapter or any subclass.AllowedIPAddressesCallIntervalA comma-separated list of remote IP addresses from which to accept connections. The adapter accepts named IPaddresses, IPV4 addresses, or IPV6 addresses. An optional :port designation is supported; so, for example, bothof the following address formats are acceptable: 192.168.1.22 or 192.168.1.22:3298.If a port number is specified, Ensemble refuses connections from other ports.If the string starts with an exclamation point (!) character, the adapter initiates a connection to the specified address.In this case, you can only provide one address, and if you specify a port, it supersedes the value of the Port setting.Number of seconds that the adapter listens for incoming data from its configured source, before checking for ashutdown signal from the Ensemble framework.If the adapter finds input, it acquires the data and passes it to the business service. The business service processesthe data, and then the adapter immediately begins waiting for new input. This cycle continues whenever the productionis running and the business service is enabled and scheduled to be active.The default CallInterval is 5 seconds. The minimum is 1 second.JobPerConnectionWhen True, the adapter spawns a new job to handle each incoming TCP connection and allows simultaneoushandling of multiple connections. When False, it does not spawn a new job for each connection; False is usuallythe appropriate choice for HL7 or X12 connections. The default is True.Using TCP Adapters with Ensemble 55
Page 2:
Using TCP Adapters with EnsembleEns
Page 6 and 7:
List of TablesTable 6-1: TCP Status
Page 9 and 10: 1Choosing a TCP AdapterThis chapter
Page 11 and 12: 2Using the TCP Counted Inbound Adap
Page 13 and 14: Using the AdapterAn Ensemble produc
Page 15 and 16: Sample Business Service Class Code4
Page 17: Adapter SettingsEndianA choice of B
Page 20 and 21: Using the TCP Counted Outbound Adap
Page 28 and 29: Using the TCP Counted XML Inbound A
Page 34 and 35: Using the TCP Counted XML Outbound
Page 42 and 43: Using the TCP Text Line Inbound Ada
Page 50 and 51: Using the TCP Text Line Outbound Ad
Page 58 and 59: Creating Custom TCP Adapter Classes
Page 62 and 63: Settings for the Abstract TCP Adapt
Page 65 and 66: BCommon Tasks in the Management Por
show all

Using TCP Adapters with Ensemble - InterSystems Documentation

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?