TCP/IP HL7 V3 Adapter Outbound Connectivity Map Properties

Max Data Size

A number that indicates the maximum amount of data that the programs can hold internally. The valid range is a numeric value from 1 to 2147483647 bytes (2GB), which is the maximum value of a Java integer.

Scope Of State

The scope of the state object, which is a Message Library node. Select one of the following options for this property: 

• Resource Adapter Level – The state has the same life cycle as the resource adapter.

• Connection Level – The state has the same life cycle as the connection.

• OTD Level – The state has the same life cycle as the Message Library object.

  This scope represents the life cycle of the state.

Connection Type

The way the adapter establishes the TCP/IP connection. Select one of the following options: 

• Client – The adapter connects to an external server (host/port) to establish the connection. The adapter is in active mode.

• Server – The adapter waits and listens on a certain port for an incoming connection request from an external client. Once the request is received, the adapter accepts the request and establishes the connection. The adapter is in passive mode.

Server is the default setting. Unless you specifically require Client mode, leave the default value. 

ServerSoTimeout

The value (in milliseconds) of the SO_TIMEOUT parameter for ServerSocket. The timeout must be greater than zero (0). A timeout of zero is interpreted as an infinite timeout.

This value is used for the ServerSocket.accept() method. When this option is set to a non-zero timeout, calling accept() for this ServerSocket will block for the configured length of time. If the timeout expires, a java.net.SocketTimeoutException (or java.net.InterruptedIOException) is thrown, but the ServerSocket remains valid.

Enable this option prior to entering the blocking operation. This property is only used when the Connection Type property is set to Server.

Keep Alive

An indicator of whether the client’s SO_KEEPALIVE option is enabled or disabled. Select true to enable SO_KEEPALIVE; otherwise, select false.

When the option is enabled for a TCP socket and no data has been exchanged across the socket in either direction for two hours, TCP automatically sends a KEEPALIVE probe to the peer (the actual value is implementation dependent). This probe is a TCP segment to which the peer must respond. One of three responses is expected: 

1. The peer responds with the expected ACK. The application is not notified (since everything is OK). TCP will send another probe following another two hours of inactivity.

2. The peer responds with an RST, which tells the local TCP that the peer host has crashed and rebooted. The socket is closed.

3. There is no response from the peer. The socket is closed. The purpose of this option is to detect if the peer host has crashed. This is used for the accepted client Socket.

For some properties, the server socket itself does not have direct property settings associated with it. Instead, the properties map to the accepted client socket.

Receive Buffer Size

A number indicating the receive buffer size. This is the value of the SO_RCVBUF option for the current socket, which is the buffer size used by the operating system for input on this socket. It provides an estimate of the size of the underlying buffers used by the platform for incoming network I/O.  

When used in set mode, this is a suggestion for the kernel from the application regarding the size of buffers to use for the data to be received over the socket. When used in get mode, this must return the actual size of the buffer used by the platform when receiving data on this socket. 

Send Buffer Size

A number indicating the send buffer size. This is the value of the SO_SNDBUF option for the current socket, which is the buffer size used by the operating system for output on this socket. It provides an estimate of the size of the underlying buffers used by the platform for outgoing network I/O.  

When used in set mode, this is a suggestion for the kernel from the application regarding the size of buffers to use for the data to be sent over the socket. When used in get mode, this must return the actual size of the buffer used by the platform when sending out data on this socket. 

SoLinger

An indicator of whether the adapter performs a “linger-on-close” timeout. This option disables or enables an immediate return from a call to the close() method for a TCP Socket. To enable the linger-on-close timeout, select true; otherwise, select false.

If you enable this property, specify the maximum length of the timeout in the SoLinger Timeout property.

SoLinger Timeout

The server’s linger–on–close timeout in seconds. Use SoLinger Timeout when SoLinger is set to true (see the description for SoLinger above). You can specify an integer between -1 and 65535. The default is -1 seconds, which indicates that the SoLinger option is disabled.

When SoLinger is set to true, the SoLinger Timeout value indicates the following:

• A non-zero integer means that calling close() will block pending the transmission and acknowledgement of all data written to the peer. When all data is written, the socket is closed gracefully. Upon reaching the linger timeout value specified here, the socket is closed forcefully with a TCP RST. If the specified timeout value exceeds 65,535 it will be reduced to 65,535.

• A zero integer means that a forceful close is performed immediately.

SoTimeout

The value of the SoTimeout in milliseconds. You can enter a value greater than or equal to zero (0). When set to zero (0), the timeout is infinite.

With this option set to a non-zero value, calling the read() method on the input stream associated with this socket will block for only the configured length of time. If the timeout expires, a java.io.InterruptedIOException or java.net.SocketTimeoutException is thrown, but the socket remains valid.

Enable this option prior to entering the blocking operation. 

TcpNoDelay

An indicator of whether data packets that are smaller than the maximum transfer unit (MTU) size are sent out immediately over the network (this refers to Nagle’s algorithm). Select one of the following options: 

• True – Indicates that the server allows data packets that are smaller than the MTU size to be sent out immediately over the network. This can improve performance for higher-speed networks.

• False– Indicates that the server does not allow data packets that are less than the MTU size be sent out immediately over the network.

  This is used for the accepted client socket.

Socket Factory Implementation Class Name

The name of the Java class that implements the socket factory. This class is used to create the socket. If you have provided your own socket implementation, enter the name of the Java class that contains this implementation here. The factory implementation class must implement the com.stc.connector.tcpip.model.factory.TCPIPSocketFactory interface.

The default value is com.stc.connector.tcpip.model.factory.TCPIPSocketFactoryImpl

Time To Wait Before Attempting Connection

The length of time (in milliseconds) the adapter waits before attempting to connect to the external system. 

Always Create New Connection

An indicator of whether the adapter always attempts to create a new connection when a connection establishment request is received. Select on of the following options: 

• true – The adapter always attempts to create a new connection without attempting to match an existing connection.

• false – The adapter attempts to match an existing connection (managed by the container).

Auto Reconnect Upon Matching Failure

An indicator or whether to attempt to reconnect automatically when the adapter gets a matching connection from a container, even though this connection is not valid; for example, the external side of the connection is closed or reset due to the external application’s logic. 

Select one of the following options:

• true – The adapter discards the invalid matching connection and automatically attempts to reconnect using a new connection.

• false – The adapter does not automatically attempt to reconnect using a new connection. Instead, the adapter defers the reconnect control to the user business rules. It is up to the business rules to detect this type of failure and act appropriately.

Max Connection Retry

The maximum number of times the adapter attempts to connect to a specific external TCP/IP destination (host/port) before giving up. 

Retry Connection Interval

The length of time (in milliseconds) the adapter waits between attempts to connect to a specific external TCP/IP destination (host or port). 

Max Binding Retry

The maximum number of times the adapter will attempt to bind to the specified TCP/IP port on the localhost before giving up. 

Retry Binding Interval

The amount of time (in milliseconds) that the adapter waits between attempts to bind to the specified TCP/IP port on the localhost. 

Acknowledgment Level

The acknowledgment type provided by the Java Collaboration. Select one of the following types: 

• Immediate

• Deferred

• Queued

LLP Type

The lower layer protocol (LLP) type. The supported option is MLLP v2.0 (Minimal Lower Layer Protocol v2.0). 

For more information on MLLP v2.0, see Lower Layer Protocol.

Start Block Character

The first envelope marker character in the HL7 envelope, as a decimal ASCII number. Enter a number from 1 to 127. Unless there is a conflict, the value should be ASCII VT (decimal 11). 

End Data Character

The second to the last envelope marker character in the HL7 envelope, as a decimal ASCII number. Enter a number from 1 to 127. Unless there is a conflict, the value should be ASCII FS (decimal 28). 

End Block Character

The last envelope marker character in the HL7 envelope, as a decimal ASCII number. Enter a number from 1 to 127. To strictly comply with the HL7 Standard, this property must be set to a carriage return (decimal 13). 

Max Number of Retries

The maximum number of times the adapter tries to send a message upon receiving the MLLP v2.0 Negative Commit Acknowledgement from the peer before giving up. This property is used by the adapter in outbound mode. Enter any integer. 

Sequence Number Enabled

An indicator of whether sequence numbering is enabled or disabled. Enabling sequence numbering helps prevent duplication of data. Select true to enable sequence numbering; otherwise select false.

Interaction ID

The identification of the unique information interchange. The attribute values are derived from the HL7 MDF interaction names; for example, POLB_INI00100 and COMT_IN300652.

Processing Code

An indicator of the type of system the message is part of. Specify one of the following options: 

• D - The message is part of a debugging system.

• P - The message is part of a production system.

• T - The message is part of a training system.

Processing Mode Code

An indicator of the mode in which the message is processed. Specify one of the following options: 

• T – Current processing (online mode)

• A – Archive mode

• I – Initial mode

• R – Restore from archive mode

Version Code

The HL7 version. This value is matched by the receiving system to its own version to ensure that messages are interpreted correctly. The default value is v3.0.

Validate Transmission Wrapper

An indicator of whether to validate the transmission wrapper of the data message (for inbound case) and transmission wrapper of the ACK response (for outbound case). Select true to validate messages; otherwise select false.

This property is used in the Collaboration code. 

Time To Wait For A Response

The amount of time (in milliseconds) that the adapter waits for a response from the external system before taking recourse action (see Action on No Response in HL7 Recourse Action). Any data from the external system is considered a response.

This property corresponds to the initial read/receive operation timeout. Once a response is received, the subsequent read/receive operation uses the value specified for SoTimeout (see TCPIP Outbound Settings). A value of 0 (zero) indicates an infinite timeout.

Max Empty Read Retry

The maximum number of times the adapter attempts to read data from the external system after the read/receive operation returns nothing. This applies to the read or receive operation after a response starts to arrive. Empty Read means that a timeout occurs on the read/receive operation, which uses the SoTimeout property in the TCPIP Outbound Settings section as the timeout setting (see TCPIP Outbound Settings). The corresponding recourse action is specified by the Action on Max Failed Read Retry (see HL7 Recourse Action).

Max No Response

The maximum number of response timeouts the adapter allows while waiting for data from the external system before taking recourse action (see Action on Max No Response in HL7 Recourse Action).

This property is used in the Collaboration code. It works in conjunction with the Resend option of the Action on No Response property (see HL7 Recourse Action table).

Max NAK Receive Retry

The maximum number of negative acknowledgments (NAKs) the adapter receives before taking recourse action (see Action on Max Nak Received in HL7 Recourse Action).

This property is used for the outbound Collaboration code. 

Max NAK Send Retry

The maximum number of negative acknowledgments (NAKs) the adapter sends before taking recourse action (see Action on Max Nak Sent in HL7 Recourse Action).

Max Canned NAK Send Retry

The maximum number of canned negative acknowledgments that the adapter sends before taking recourse action (see Action on Max Nak Sent in HL7 Recourse Action). A value of 0 (zero) indicates that the adapter will not attempt to create or send a canned NAK.

Enable Journaling

An indicator of whether message journaling is enabled. To enable message journaling, select true; otherwise select false.

This property is used for outbound Collaboration code. 

Action on No Response

The action the adapter takes when no ACK is received from the external system in the allotted time. The amount of time is determined by the Time To Wait For A Response property (see Communication Control - TCP/IP). Select one of the following options:

• Exit – The adapter terminates its connection with the external system and shuts down.

• Resend – The adapter attempts to resend the message to the external system. The Resend option is only allowed when sequence numbering is in effect.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

  This property is used for outbound Collaboration code.

Action on Max No Response

The action the adapter takes when it attempts to send a message to the external system the maximum allowed number of times and does not receive any response (HL7 Application Acknowledgement) from the external system. The maximum number times the adapter sends a message without receiving a response is determined by the Max No Response property (see Communication Control - TCP/IP). Select one of the following options:

• Exit – The adapter terminates its connection with the external system and shuts down.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

  This property is used for outbound Collaboration code.

Action on Max Failed Read Retry

The action the adapter takes after it has reached the empty read limit set by the Max Empty Read Retry property. Select one of the following recourse options:

• Exit – The adapter terminates its connection with the external system and shuts down.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

  This property is used for outbound Collaboration code.

Action on Nak Received

The action the adapter takes when it receives an HL7 Application NAK from the external system. Select one of the following options: 

• Resend – The adapter attempts to resend the message to the external system.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

• Skip Message – The adapter remains connected, but writes the message to an error queue.

  ---

  Note –

  Do not set both the Action On NAK Received and Action On Max NAK Received properties to Skip Message.

  ---

  This property is used for outbound Collaboration code.

Action on Max Nak Received

The action the adapter takes when the maximum number of HL7 Application NAKs have been received from the external system, as set by the Max NAK Receive Retry property (see Communication Control - TCP/IP). Select one of the following options:

• Exit – The adapter terminates its connection with the external system and shuts down.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

• Skip Message – The adapter remains connected, but writes the message to an error queue.

  This property is used for outbound Collaboration code.

  ---

  Note –

  Do not set both the Action On NAK Received and Action On Max NAK Received properties to Skip Message.

  ---

Action on Max Nak Sent

The action the adapter takes when it has sent the maximum allowed number of NAKs to the external system, as set by the Max NAK Send Retry parameter (see Communication Control - TCP/IP). Select one of the following options:

• Exit – The adapter terminates its connection with the external system and shuts down.

• Reset – The adapter closes its connection with the external system and goes through the connection scenario.

  This property is used for inbound Collaboration code.