Working with HL7 Routers

PreviousNext

Using the program to send HL7 messages using Router Profiles

(c) 2007-2008 Hermetech International Ltd.

To send HL7 messages over TCP/IP using a router profile you first have to create (or acquire) some ASCII HL7 message data files. Place these HL7 files into the HL7 Message Folder with the HL7 File Extension defined in your router profile and you are ready to start.

 

The Routers Profile list

The Routers Profile list

Clicking the 'Run' button on the toolbar will validate the profile, if no immediate errors are detected, it will immediately launch a TCP/IP workstation Router engine. USEFUL NOTE: Once you start either a Listener or Router profile, you can actually close the main window and your profile(s) will continue running. When the profile starts, the runtime window is collapsed by default. You can expand / collapse the window by clicking the up & down facing blue 'toggle' arrows in the top right section of the window (see below).


The Router Runtime window (Collapsed View)

 

Router Profile Runtime Engine (Collapsed)

Router Profile Runtime Engine (Collapsed)

 

The Active LED (see above) will indicate whether the profile is actually processing. If it's RED, then the profile has stopped for some reason and you should expand the window to see details. If you are running as a Trial Version for instance, your profiles will only stay active for a few minutes before halting.
Msgs Sent - How many HL7 messages has the router sent since it was started.
Acks Rcvd - How many HL7 acknowledgements has the router received.
No Acks - How many messages have NOT been acknowledged.
Queued - How many messages are waiting queue to be sent. (See FAQ for more info about the message queue)
Errors - How many HL7 errors or malformed messages have been found.
Bytes Sent - The total number of ASCII bytes sent by the router since it was started.

The Router Runtime window (Expanded View)

 

 

Router Profile Runtime Engine (Expanded)

Router Profile Runtime Engine (Expanded)

 

The Router Trace Log - Shows events as they occur while HL7 data is being received. The Trace log will also display any errors that occur.
Profile Settings - Shows a selection of pertinent profile settings.