The WSO2 ESB HL7 inbound protocol is a multi-tenant capable alternative to the WSO2 ESB HL7 transport. The HL7 inbound endpoint implementation is fully asynchronous and is based on the Minimal Lower Layer Protocol(MLLP) implemented on top of event driven I/O.
...
| Parameter | Description | Default Value | Possible Values |
|---|---|---|---|
| inbound.hl7.Port | The port on which you need to run the MLLP listener. | N/A | You need to specify this. |
| inbound.hl7.AutoAck | Whether or not an auto acknowledgement should be sent on message receipt. If set to false, you can define the type of HL7 acknowledgement to be sent. For more information, see HL7 inbound endpoint mediation level properties. | true | true | false |
| inbound.hl7.ValidateMessage | This enables HL7 message validation. | true | true | false |
| inbound.hl7.TimeOut | The timeout interval in milliseconds to trigger a NACK message. | 10000 | [0..9]* |
| inbound.hl7.CharSet | The character set used for encoding and decoding messages. Some multi-byte character encodings (e.g. UTF-16, UTF-32) may result in byte values equal to the MLLP framing characters or byte values lower than 0x1F, resulting in errors. | UTF-8 | ISO-8859-1 UTF-8 US-ASCII |
| inbound.hl7.BuildInvalidMessages | If the inbound.hl7.ValidateMessage parameter is set to false and the incoming message is invalid, this parameter specifies whether the raw message received through the MLLP transport should be passed onto the mediation layer. | false | true | false |
| inbound.hl7.PassthroughInvalidMessages | If the inbound.hl7.BuildInvalidMessages parameter is set to true, this parameter notifies the Axis2 HL7 transport sender whether to use the raw message. | false | true | false |
| inbound.hl7.MessagePreProcessor | An implementation of the org.wso2.carbon.inbound.endpoint.protocol.hl7.HL7MessagePreprocessor interface can be defined here. It provides an extension point to intercept incoming messages before any type of message parsing occurs. | N/A | Fully qualified class name. |
...
| Property | Description | Value |
|---|---|---|
| hl7_id_generator | By default the HAPI HL7 parsing library uses a file based ID generator to generate unique control IDs. To use a UUID based ID generator you can change this to ‘uuid’. | file | uuid (default = file) |
| worker_threads_core | Defines the HL7 inbound worker thread pool size. | [0..9]* (default = 100) |
| io_thread_count | Defines the number of IO threads the IO Reactor uses. It is recommended to set this to the number of cores on the machine. | [0..9]* (default = 2) |
| so_timeout | Defines TCP socket timeout. | [0..9]* (default = 0) |
| connect_timeout | Defines the TCP connect timeout. | [0..9]* (default = 0) |
| so_keep_alive | Defines TCP socket keep alive. | true | false (default = true) |
| so_rcvbuf | Defines the TCP socket receive buffer size. | [0..9]* (default = 0 uses OS default. Maximum value depends on OS settings). |
| so_sndbuf | Defines the TCP socket send buffer size. | [0..9]* (default = 0 uses OS default. Maximum value depends on OS settings). |
Samples
For a sample that demonstrates how the HL7 inbound protocol can be used to receive a simple HL7 message, see Sample 905: Inbound HL7 with Automatic Acknowledgement.