Source Map Variables

Key	Description
localAddress	The IP address that the TCP socket is locally bound to.
localPort	The port that that TCP socket is locally bound to.
remoteAddress	The IP address of the remote system.
remotePort	The TCP port of the remote system.

Mirth® Connect by NextGen Healthcare User Guide

Basic TCP Transmission Mode

This transmission mode allows you to specify basic TCP frame data (beginning and ending byte sequences). This allows the source connector to know when a message has been fully received. Destination connectors also use these sequences when sending data outbound. Item Name Default Value Description A Start of Message Bytes The bytes before the beginning of the actual message. Only valid hexadecimal characters (0-9, A-F) are allowed. B End of Message Bytes The bytes after the end of the actual message. Only valid hexadecimal characters (0-9, A-F) are allowed. If this is not specified, the only way a connector knows whether a message has been received is if the socket timeout is reached or if the remote side closes the socket. Byte Abbreviations Parent topic: TCP Listener

Mirth® Connect by NextGen Healthcare User Guide

TCP Listener

This source connector listens for messages coming in over a TCP connection. It can either listen on a TCP interface/port and wait for clients to connect, or connect to an external server. There are options to decide when to keep connections open, and how many clients can connect at once. Configurable transmission modes allow you to decide how to receive inbound messages and send responses. When sending responses, you can choose to send the data back on the same connection, or on a new connection. Supported property groups: Listener Settings Source Settings Item Name Default Value Description A Transmission Mode MLLP The transmission mode determines how to receive message data from the incoming byte stream, and how to send responses out. For additional information, see TCP Transmission Modes. B Sample Frame <VT> <Message Data> <FS> <CR> An example of a valid incoming message. This is dependent on the Transmission Mode. C Mode Server Select Server to listen for connections from clients.

Mirth® Connect by NextGen Healthcare User Guide

Source Map Variables

Key Description localApplicationEntityTitle The Application Entity Title of the local Service Class Provider (SCP). remoteApplicationEntityTitle The Application Entity Title of the remote Service Class User (SCU). localAddress The IP address that the TCP socket is locally bound to. localPort The port that that TCP socket is locally bound to. remoteAddress The IP address of the remote connecting client. remotePort The TCP port of the remote connecting client. associateACProtocolVersion The associate protocol version of the local SCP. associateACImplClassUID The associate implementation class unique identifier of the local SCP. associateACImplVersionName The associate implementation version name of the local SCP. associateACApplicationContext The associate application context of the local SCP. associateACPresentationContexts A map containing all supported presentation contexts of the local SCP. associateRQProtocolVersion The associate protocol version of the remote SCU. associateRQImplCl

Mirth® Connect by NextGen Healthcare User Guide

TCP Sender

This destination connector opens a new TCP client connection and sends messages over it. You can decide whether to keep a connection open, and if so for how long. Configurable transmission modes allow you to decide how to send outbound messages and receive responses. Supported property groups: Destination Settings Item Name Default Value Description A Transmission Mode MLLP The transmission mode determines how to send message data out on the socket byte stream, and how to receive responses. For additional information, see TCP Listener B Sample Frame <VT> <Message Data> <FS><CR> This is dependent on the Transmission Mode and displays an example of how an outgoing message frame is expected to look. C Mode Client Client: The TCP Sender will initiate new connections outbound to a remote server, and then send messages outbound on that connection. Server: The TCP Sender will open a server socket and listen for incoming connections. If queuing is enabled, messages will continue to queue until

Mirth® Connect by NextGen Healthcare User Guide

Source Map Variables

If this connector receives a message from a Channel Writer, the following source map variables will be available: Key Description sourceChannelId The unique ID of the channel that dispatched a message to the current channel. sourceMessageId The ID of the message from which the current message dispatch originated. sourceChannelIds If there are more than two channels in a Channel Writer -> Reader chain, this will be a List containing the IDs of all channels in the chain. sourceMessageIds If there are more than two channels in a Channel Writer -> Reader chain, this will be a List containing the IDs of all messages in the chain. Parent topic: Channel Reader

Mirth® Connect by NextGen Healthcare User Guide

Source Map

This map is isolated to the current message as it processes through a channel. Unlike the channel map however, this one is read only. The Source Connector or an upstream process can inject source map variables. For example, the File Reader will automatically inject the "originalFilename" variable Get source map value: var value = sourceMap.get('key'); var value = $s('key'); Parent topic: Variable Maps

Source Map Variables

Recommendations

Basic TCP Transmission Mode

TCP Listener

Source Map Variables

TCP Sender

Source Map Variables

Source Map

Basic TCP Transmission Mode

TCP Listener

Source Map Variables

TCP Sender

Source Map Variables

Source Map