Parameters for the Medical devices to EMR pattern

Observation results
Pattern parameter Default Description
Expiry time (seconds) 60

This is a period of time expressed in seconds set on each medical device message when it is measured. Device messages become eligible to be discarded if they have not been processed before this period of time elapses.

Leaving this parameter empty ensures a device message is never timed out. It is recommended to set a message expiry time so that aged device messages do not accidentally get associated with an incorrect patient when they are subsequently processed.

Source identifier Message Broker This parameter defines an identifier that is used to describe the source in error messages, notifications, and standard journaling messages.
Source facility This parameter defines the source facility that is included in error messages, notifications, and standard journaling messages.
Patient identifiers Use patient identifiers from device

This parameter defines how patient identifiers are associated with device messages. The patient identifier is used to populate the PID (patient identifier) segment of the HL7 observation result messages:

  1. No patient identifier in observation results - specifies that no PID segment is required in the HL7 observation result messages.
  2. Use patient identifier from the device message - the patient identifier configured for the device is copied directly into the PID segment of the HL7 observation result message..
  3. Lookup the patient identifier in a database - the device identifier in the device message is used as a key into a database table to lookup the associated patient identifier. The patient identifier is then copied into the PID segment of the HL7 observation result message.

Message identifiers Current date and time

This parameter defines how the MSH.10 message identifier field is created in the HL7 observation result (ORU) messages.

Current date and time combines the current date and time into a sequence of numeric characters. The date and time is accurate to 0.000001 seconds on the current machine. Current date and time is not suitable for highly available configurations where more than one broker can send observation results to the same destination application.

Globally unique identifier creates an alpha numeric identifier based on the current time stamp and additional information including the current machine's network MAC address. Globally Unique Identifier creates identifiers longer than the 20 character limit recommended by the HL7 standard.

Patient class Inpatient I

The patient class is used by systems to categorize patients by site. It does not have a consistent industry-wide definition. It is subject to site specific variations. The parameter value selected is used to populate the Patient Class field (PV1-2) in the HL7 ORU R01 Patient Visit Segment (PV1).

Lookup patient identifiers
Pattern parameter Default Description
Create web service Selected

If this parameter is checked, additional flows are generated to implement a web service which manages the patient identifiers database.

Data source PATIENTSDSN

This parameter defines the data source name from which patient identifiers are queried.

This parameter is read only - it is presented to highlight the ODBC data source name which must be configured for the pattern.

Patient identifiers table PATIENTS

This parameter defines the table which contains the patient and device identifiers. The pattern instance queries this table using the device identifiers from the device messages. A row should exist in this table for each device which a patient is associated with.

This parameter is read only - it is presented to highlight the database table which must be configured for the pattern.

Destination EMR
Pattern parameter Default Description
Destination type Generic This parameter defines the type of the destination application. The parameter is used to select the GenericHL7Output node in the Sender flow.
Destination identifier EMR This parameter defines the identity of a destination. This identity is used in error, report, and notification messages related to the destination.
Destination facility This parameter defines the facility of a destination. This facility is used in error, report, and notification messages related to the destination.
Connection details localhost:2222 This parameter defines the TCP/IP connection for a destination in the form hostname:port
Standard MLLP Selected This parameter determines whether a default configuration for TCP/IP and MLLP is used. The default configuration has the following values:
  • Timeout: 60 seconds
  • Leading MLLP byte: 0B
  • Delimiter: Not applicable
  • Retry limit: 3
  • Log retries: true
  • Validation: false

If the parameter is not selected, the parameter group to define non-standard values becomes visible.

Destination communications
Pattern parameter Default Description
Timeout (seconds) 60 This parameter defines the timeout for a destination in seconds.
Leading MLLP byte 0B This parameter defines the leading MLLP byte, which is added to outgoing records.
Trailing MLLP bytes 1C0D This parameter defines what the delimiter is. This value must be in hexadecimal.
Retry limit 3 This parameter defines the number of times a Sender flow attempts to deliver an HL7 message to the destination application.
Log retry Selected This parameter determines whether each attempt to deliver a message is logged.
Validation None This parameter determines whether the message is validated against the HL7 message set.
Options
Pattern parameter Default Description
Journaling Standard This parameter determines the journaling options. Valid values are:
  • None: No journaling. This option can also be used if the pattern user wants to use a source feed to carry out journaling to their own requirements.
  • Standard: A copy of each message is produced with standard header information defined by the pattern. This copy is published to the topic PatternInstance/Journal or written to the journal queue as determined by the Publish parameter.
Canonical feed Cleared This parameter determines whether a copy of the message in canonical form is generated. If selected, the Publish parameter determines whether this copy of the message is sent to the PatternInstance.CAN queue or to the topic PatternInstance/Canonical
Publish Publish This parameter determines whether journal messages, remainder messages, and other reports are published or written to queues.
General
Pattern parameter Default Description
Description Medical Devices to EMR Pattern This parameter defines the purpose of the flow that is generated, and can include any details that you require.
Queue prefix This parameter defines a string that you want to prefix to the queue names. The standard queues are created with this prefix and a standard set of suffixes.

If this parameter is left blank, the pattern instance name is processed to remove non-alphanumeric characters and then it is used as the queue prefix.

Flow prefix This parameter defines a string that is added to the start of the name of each main message flow in a generated pattern instance. This string helps to identify the components of the pattern instance in reports and monitoring.

If this parameter is left blank, the pattern instance name is processed to remove non-alphanumeric characters and then it is used as the flow prefix.

Configurable service prefix This parameter defines a string that you want to prefix to the configurable service name.

If this parameter is left blank, the pattern instance name is processed to remove non-alphanumeric characters and then it is used as the configurable service name.

Generate scripts Selected This parameter determines whether an MQSC deployment script is generated.
Trace file name tracefile.txt This parameter defines the file name, including the path, to which trace output is sent. If no path is provided, the trace file is written into the bin directory of your broker installation.

All the pattern parameters are listed with their default values. Where no default is indicated, the default value is an empty string.

Back to the Medical devices to EMR pattern specification