Healthcare Listener

The Healthcare Listener is a secure service that receives ADT messages from a healthcare management system. It allows traffic to pass securely from the healthcare management system to the Jamf Software Server (JSS).

After the Healthcare Listener is enabled and configured, it can receive ADT messages. When the Healthcare Listener has received an ADT message, the JSS interprets the message to automatically send remote commands to mobile devices. For example, when a patient is discharged, the Healthcare Listener receives a "Patient Discharge" ADT message, and the JSS automatically sends a remote command to the mobile device. (For more information about the communication process of the Healthcare Listener, see the Healthcare Listener Communication Knowledge Base article.)

When you configure the Healthcare Listener, you must do the following:

  • Specify IP addresses or a range of IP addresses to accept incoming messages from
    Note: The Healthcare Listener is compatible with IPv4 and IPv6 connection methods.

  • Specify a port number
    Note: The default port value is 8080. This should be changed to the port number of your healthcare management system.

  • Choose which ADT messages the Healthcare Listener can receive. These messages allow the JSS to automatically send remote commands to mobile devices. (For more information, see ADT Message Types.)

  • Choose a mobile device inventory field to use to automatically map a mobile device to the value for the bed number in the healthcare management system. (For more information, see Mobile Device Inventory Field Mapping.)
    Note: The value returned from the healthcare management system is "bed number".

In addition, email notifications can be sent from the JSS when a remote command fails to send or remains in a pending state. (For more information, see Notifications.)

The Healthcare Listener is hosted by the Jamf Infrastructure Manager, a service that is managed by the JSS. After you install an instance of the Infrastructure Manager, the JSS allows you to enable the Healthcare Listener. For more information, see Jamf Infrastructure Manager Instances.

ADT Message Types

For the JSS to automatically send remote commands to mobile devices, the Healthcare Listener must receive an ADT message. The JSS allows you to choose the following ADT message types the Healthcare Listener can receive:

  • Patient Transfer (ADT-A02)

  • Patient Discharge (ADT-A03)

Note: The remote command that is automatically sent to a mobile device is the Wipe Device remote command. The Wipe Device command is automatically sent for all ADT messages that the Healthcare Listener receives. If a mobile device has Activation Lock enabled, the Activation Lock is cleared when the device is wiped.

Mobile Device Inventory Field Mapping

When configuring the Healthcare Listener, you must choose an attribute from user and location information in mobile device inventory to use to map a mobile device to a bed number. The attribute you choose is automatically mapped to the value for the bed number in the healthcare management system.

In addition, you can create an extension attribute for a specific inventory attribute that fits your environment. After you create the extension attribute, it is available as an inventory field option. (For more information about creating an extension attribute for a mobile device, see Mobile Device Extension Attributes.)

Notifications

Email notifications can be sent from the JSS to specified users for the following events:

  • A remote command fails to send.

  • A remote command is in a pending state after a specified amount of time.

Before you configure notifications, make sure you have the email addresses of the recipients you want to send the notification to.

To enable the email notifications, you need an SMTP server set up in the JSS. (For more information, see Integrating with an SMTP Server.)

Requirements

To configure the Healthcare Listener and take full advantage of its latest features and enhancements, you must install the latest version of the Jamf Infrastructure Manager. (For more information, see the Jamf Infrastructure Manager Installation Guide.)

In addition, you need to ensure that your healthcare management system is compliant with Health Level Seven (HL7) messaging. For more information about HL7 messaging, see www.hl7.org.

Configuring the Healthcare Listener

  1. Log in to the JSS with a web browser.

  2. In the top-right corner of the page, click Settings images/download/thumbnails/10126656/Settings_icon.png .

  3. Click Server Infrastructure.

  4. Click Computer Management.

  5. In the “Computer Management–Server Infrastructure” section, click Infrastructure Manager Instances images/download/thumbnails/12985605/InfrastructureManager.png .
    A list of Infrastructure Manager instances is displayed along with the services that are installed on each instance.

  6. Click the Infrastructure Manager instance with the Healthcare Listener that you want to configure.

  7. Click Edit.

  8. Click the General tab, and then select the Enable Healthcare Listener checkbox.

  9. Enter a display name for the Healthcare Listener.
    This is the name that is displayed for the Healthcare Listener on the Infrastructure Manager. (For more information about viewing the services that are installed on an Infrastructure Manager instance, see Jamf Infrastructure Manager Instances.)

  10. To specify the IP addresses to accept incoming ADT messages from, do one of the following:

    • Select All IP addresses to accept incoming messages from any IP address. The JSS automatically sends a remote command to mobile devices if the Healthcare Listener receives an ADT message from any IP address.

    • Select Single IP address or Range of IP addresses to specify the IP addresses to accept incoming ADT messages from, and do the following:

      1. To specify a single IP address, click the (+) Add button for Single, and enter the IP address.

      2. To specify a range of IP addresses, click the (+) Add button for Range, and enter the starting and ending IP addresses.

  11. Specify which ADT messages the Healthcare Listener can receive.

  12. Choose a mobile device inventory field to use to map a mobile device to the bed number in the healthcare management system.
    The inventory field is automatically mapped to the bed number in the healthcare management system.

  13. (Optional) To enable email notifications, click the Notifications tab and do the following:

    1. Select the Enable Email Notifications checkbox.

    2. Enter an email address or multiple email addresses separated by a line break or a comma.

    3. Use the Email Delay pop-up menu to choose how many minutes to wait when a remote command is pending before sending an email to specified email addresses.

  14. Click Save.

When the Healthcare Listener receives an ADT command, the JSS automatically sends a remote command to mobile devices that are mapped to the healthcare management system.

Related Information

Copyright | Privacy | Terms of Use | Security
© copyright 2002-2017 Jamf. All rights reserved.