Dec 29

New release, v0.7, is available – see link below for downloadable archive. Throughput masurements were added. Manpages were updated.

I spend considerable time working with HL7. In the past I used SeeBeyond ICAN and Sun Java CAPS products, and OpenESB with HL7 Binding Component,  to rapidly create MLLP senders and receivers for the HL7 solutions I was building and testing. I also tried, at various times, 7 Scan, Interface Explorer and more recently HL7 Browser. For the blog articles I am writing on HL7 I need simple tooling that allows me to send HL7 v2 delimited messages from a file to a MLLP listener and receive acknowledgements, receive HL7 messages from a sender and retrun acknowledgements, and recently to combine multiple sender message streams into a single stream, with correct acknowledgement handling. The tooling has to be free for me to distribute with the projects and the articles and to use in my day job as well.

Not finding anything that would fit the bill, and that would work reliably enough, I developed my own tools.

I embellished the basic sender a bit so I could send multiple messages, one after the other, from a file, delay between successive sends, generate MSH-10, replace MSH-3-1, MSH-4-1, MSH-5-1 and MSH-6-1, and increase timeout for acknowledgements.

The tools are all old fashioned command line tools – no graphical user interface.

CMDHL7Listener – man page: https://blogs.czapski.id.au/wp-content/uploads/2010/12/CMDHL7Listener.pdf

CMDHL7Sender – man page: https://blogs.czapski.id.au/wp-content/uploads/2010/12/CMDHL7Sender.pdf

CMDHL7Proxy – man page: https://blogs.czapski.id.au/wp-content/uploads/2010/12/CMDHL7Proxy.pdf

Deprecated Distribution: https://blogs.czapski.id.au/wp-content/uploads/2010/12/CMDHL7_v0.5.zip

Current Distribution: https://blogs.czapski.id.au/wp-content/uploads/2010/12/CMDHL7_v0.7.zip

Release 0.5 and 0.7 are free to use by anyone for any purpose and will stay that way. There may not be future releases 🙂
I used HAPI 1.0.1 libraries for HL7 processing – http://hl7api.sourceforge.net/

4 Responses to “HL7 Sender, HL7 Listener and HL7 Proxy – developer tools I always wanted”

  1. Ugo says:

    Hi,
    Very useful tools.
    Is it possible to have source code for maintenance?
    Could you send me please?

    Thank you and best regards,
    Ugo

  2. Jochen says:

    Hi,

    I use the CMDHL7Proxy_v0.7.jar ‘FileHandler’ in the `logging.properties` to write the HL7 Messages to a log file in linux.

    I just want the content of the transferred HL7 Messages and responses in the log file nothing else.

    This means only the entries ( with timestamp ) from:

    Jan 28, 2019 5:29:34 PM au.id.czapski.hl7.SimpleForwardApplicaiton processMessage
    INFO: ===>>> Forwarding message:

    and

    Jan 28, 2019 5:29:34 PM au.id.czapski.hl7.SimpleForwardApplicaiton processMessage
    INFO: ===>>> Received response:

    How can I achieve this in the .properties file

    • Hello, Johen.

      Add the line:
      au.id.czapski.hl7.SimpleForwardApplicaiton = INFO
      to the end of the logging_warning.properties file and use that file as the logging properties file. See documentation for how to do that.
      There are only two lines that log at info level in the SimpleForwardApplicaiton class.
      All other logging being set at WARN level in the logging_warning.properties file should reduce logging to just these two messages.
      If this does not work, review the source code, included in the JAR, and see if you want to hack your way to the desired outcome.

      All the best

Leave a Reply to Mchael Czapski

preload preload preload