Listeners

Working With HL7 Listeners

How to use the program to run Listener Profiles

The listener profiles section of the main window is your primary user interface to working with your HL7 Listeners. Create or Edit profiles by clicking on the 'New' or 'Edit' buttons of the Listener toolbar or double-clicking an entry in the list.

The Listener Profiles 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 Listener 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 Listener Runtime window (Collapsed View)

Listener 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 Rcvd - How many HL7 messages has the listener received since it was started.

•	Acks Sent - How many HL7 acknowledgements has the listener sent.

•	NAKS Sent - How many HL7 NEGATIVE Acknowledgements has the listener sent.

•	NARs - How many messages have required no acknowledgement (based on message content AND the profile settings).

•	Errors - How many HL7 errors or malformed messages have occurred.

•	Bytes Rcvd - The total number of ASCII bytes received by the listener since it was started.

The Listener Runtime window (Expanded View)

Listener Profile Runtime Engine (Expanded)

•	The Listener 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. The External Monitor Available LED will be green if the profile has enabled the EasyHL7 Monitor Interface.