On this page:
   24.44    HL7 v2.x Listener Script 24.46    FHIR to HL7 v2.x Mapper Script   

24.45HL7 v2.x MLLP Listener

 

The HL7 v2.x MLLP Listener configuration category includes the following configurable options:

  • HL7 v2.x Listener Port

  • Charset: Respect MSH-18

  • Charset: Forced

  • Unprocessable Message Handling

  • Transport Protocol

24.45.1Property: HL7 v2.x Listener Port

 
Property Key
Property Type POSITIVE_INTEGER
Description The TCP port on which this module listens.
Default Value (no default)
Is Optional? No

24.45.2Property: Charset: Respect MSH-18

 
Property Key
Property Type BOOLEAN
Description If enabled, the Minimal Lower Level Protocol (MLLP) listener will use the charset specified in MSH-18 of a given message as the encoding to use when parsing the rest of the message. This is disabled by default as MSH-18 is often incorrect in real world applications; however, it should be enabled in systems that are known to use it correctly. Ignored for HL/7 over HTTP.
Default Value false
Is Optional? Yes

24.45.3Property: Charset: Forced

 
Property Key
Property Type STRING
Description If a charset is specified here (e.g. ISO-8859-1 or UTF-8), all message parsing will use the given charset. Only used for MLLP. Ignored for HL7 over HTTP.
Default Value (no default)
Is Optional? Yes

24.45.4Property: Unprocessable Message Handling

 
Property Key
Property Type ENUM
Values
  • REJECT_WITH_AE
  • ACCEPT_WITH_AA
Description This setting controls how the HL7 v2.x listening endpoint should respond when a message can not be processed (e.g. due to the message being invalid, business rule failures, conversion failures, etc.). This setting does not affect behavior when Smile CDR experiences internal errors such as database connectivity failures.
Default Value REJECT_WITH_AE
Is Optional? No

24.45.5Property: Transport Protocol

 
Property Key
Property Type ENUM
Values
  • MLLP_OVER_TCP
  • HL7_OVER_HTTP
Description Specifies the transport used to send HL7 v2.x messages to Smile CDR. Note that most existing systems will send the MLLP protocol unless specifically configured otherwise.
Default Value MLLP_OVER_TCP
Is Optional? No
   24.44    HL7 v2.x Listener Script 24.46    FHIR to HL7 v2.x Mapper Script