Using TCP Adapters in Productions

Configure InterSystems IRIS TCP adapters for inbound and outbound data exchange.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/sorodriguezz/skills-objectscript --skill using-tcp-adapters-in-productions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Using TCP Adapters in Productions
Source: https://github.com/sorodriguezz/skills-objectscript/tree/main/skills/using-tcp-adapters
Command: npx skills add https://github.com/sorodriguezz/skills-objectscript --skill using-tcp-adapters-in-productions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides the foundational knowledge and examples for integrating InterSystems IRIS productions with external systems using TCP/IP communication.

Core Features & Use Cases

  • Inbound Adapters: Configure services to receive data over TCP using EnsLib.TCP.CountedInboundAdapter, EnsLib.TCP.CountedXMLInboundAdapter, and EnsLib.TCP.TextLineInboundAdapter.
  • Outbound Adapters: Configure operations to send data over TCP using EnsLib.TCP.CountedOutboundAdapter, EnsLib.TCP.CountedXMLOutboundAdapter, and EnsLib.TCP.TextLineOutboundAdapter.
  • Use Case: Connect a legacy system that sends data as text lines to an InterSystems IRIS production for processing.

Quick Start

Configure an InterSystems IRIS business service to use EnsLib.TCP.TextLineInboundAdapter to receive data.

Frequently Asked Questions about Using TCP Adapters in Productions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure TCP/IP communication for InterSystems IRIS productions?

TCP/IP communication for InterSystems IRIS productions is configured using inbound and outbound TCP adapters. These adapters enable business services to receive data and business operations to send data over TCP connections.

What is the difference between Counted, CountedXML, and TextLine TCP adapters?

TCP adapters differ by message framing: Counted uses length-prefixed framing, CountedXML handles XML payloads with length prefixes, and TextLine processes data delimited by line terminators for text-based legacy systems.

How do I receive data from a legacy system sending text lines over TCP in IRIS?

To receive text line data over TCP, configure an InterSystems IRIS business service to use the EnsLib.TCP.TextLineInboundAdapter, which processes incoming line-delimited text from external legacy systems.

Can I use TCP adapters for both inbound and outbound real-time data exchange?

Yes, TCP adapters support bidirectional real-time data exchange. Inbound adapters like EnsLib.TCP.CountedInboundAdapter receive data, while outbound adapters like EnsLib.TCP.CountedOutboundAdapter send data to external systems.

Does InterSystems IRIS support TCP connections for system interoperability?

InterSystems IRIS supports system interoperability via TCP/IP connections using dedicated adapter classes. This facilitates real-time data exchange between IRIS productions and external TCP-based systems.

What are the limitations of using TextLine TCP adapters for production integration?

TextLine TCP adapters are limited to processing data delimited by line terminators. They are best suited for legacy text-based systems and may not handle binary data or unframed continuous streams appropriately.