Configure the Healthcare Listener

After you install a Jamf Infrastructure Manager instance, the JSS allows you to enable and configure the Healthcare Listener on the Infrastructure Manager instance.

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

  • Specify IP addresses or a range of IP addresses to accept incoming ADT 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 that the Healthcare Listener uses to receive healthcare management system communications.

  • Add rules by configuring settings that enable the JSS to send commands to devices (For more information, see Healthcare Listener Rules.)
    You can also enable email notifications in the event that a command is not sent.

Healthcare Listener Rules

Configuring a rule enables the JSS to send remote commands to devices when the Healthcare Listener receives an ADT message. If you want to send more than one type of command or use more than one type of ADT message, you must configure a separate rule for each. You can configure as many rules as your organization requires.

The following table provides an overview of the settings you can configure for each rule:

Setting

Description

Remote Command

This setting allows you to specify which command you want sent from the JSS when the Healthcare Listener receives an ADT message. You can choose from the following commands:

  • Wipe Device
    Note: If a mobile device has Activation Lock enabled, the Activation Lock is cleared when the device is wiped.

  • Lock Device

  • Clear Passcode

  • Enable Lost Mode
    Choosing Enable Lost Mode requires you to configure custom messaging.

  • Disable Lost Mode

For more information, see Remote Commands for Mobile Devices in the Casper Suite Administrator's Guide.

ADT Message

For the JSS to send commands to devices, the Healthcare Listener must receive an ADT message. You can choose from the following ADT message types:

  • Admit/Visit Notification (ADT-A01)

  • Patient Transfer (ADT-A02)

  • Patient Discharge (ADT-A03)

  • Cancel Admit/Visit Notification (ADT-A11)

  • Cancel Transfer (ADT-A12)

  • Cancel Discharge/End Visit (ADT-A13)

Mapping Fields

ADT messages contain multiple fields of information that the Healthcare Listener can extract. You can choose which ADT message field to extract, and then map that field to an attribute from user and location information in device inventory. For example, you can choose the field that returns "bed number" and map that field to the "Room" attribute in a device's inventory information. The command you specify is then sent to devices that match the inventory attribute you select.

You can choose from the following ADT message fields:

  • Patient Visit - Person Location - Bed (PV1-3-3)

  • Patient Visit - Prior Person Location - Bed (PV1-3-6)

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 option. (For more information about creating an extension attribute for a mobile device, see Mobile Device Extension Attributes in the Casper Suite Administrator's Guide.)

Email Notifications

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

  • A command fails to send.

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

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

Requirements

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

Setting up the Healthcare Listener

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

  2. In the top-right corner of the page, click Settings.

  3. Click Server Infrastructure.

  4. Click Infrastructure Manager Instances.

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

  6. Click Edit.

  7. Select the Enable Healthcare Listener checkbox.

  8. 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 in the Casper Suite Administrator's Guide.)

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

    • Select All IP Addresses to accept incoming ADT messages 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.

  10. Enter the port number of your healthcare management system.

  11. Click Save.

After the Healthcare Listener is set up, you can add rules. Adding a rule enables the JSS to send remote commands to devices.

Adding a Healthcare Listener Rule

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

  2. In the top-right corner of the page, click Settings.

  3. Click Server Infrastructure.

  4. Click Infrastructure Manager Instances.

  5. Click the Infrastructure Manager instance with the Healthcare Listener that you want to add a rule to.

  6. Click Edit, and then click the Add (+) button.

  7. Enter a display name for the rule.

  8. Choose the remote command you want the JSS to send to devices when the Healthcare Listener receives an ADT message.

  9. Choose which ADT message the Healthcare Listener can receive.

  10. Use the Field Mapping options to map a field from the ADT message to an attribute of inventory information.

  11. (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 command is pending before sending an email to specified email addresses.

  12. Click Save.

When the Healthcare Listener receives an ADT message, the JSS automatically sends the specified command to devices that are mapped to the field in the ADT message.

You can view the date/time of when the remote command was sent to a specific mobile device in the device's inventory information. (For more information, see View when a Mobile Device Receives a Remote Command.)

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