2013-03-16

Preparation - VistA Messaging

Logical Links, Applications and Protocols are required in order to receive HL7 scheduling messages.

Logical Links

From VistA's perspective, links are required to receive and send HL7 messages. Using "HL7 Main Menu" --> "Interface Developer Options" --> "Link Edit"...

Receiving Link

Select HL LOGICAL LINK NODE: QBR39500
Are you adding 'QBR39500' as a new HL LOGICAL LINK (the 137TH)? No// Yes

This is the link that will be used to receive HL7 messages.


Sending Link

Select HL LOGICAL LINK NODE: QBS36400
Are you adding 'QBS36400' as a new HL LOGICAL LINK (the 137TH)? No// Yes

The IP address, 10.0.2.2, corresponds to the IP address of Mirth.


Applications

Applications are used to route messages within VistA. Using "HL7 Main Menu" --> "Interface Developer Options" --> "Application Edit"...

Select HL7 APPLICATION PARAMETER NAME: QBMIB MIRTH SCHED
  Are you adding 'QBMIB MIRTH SCHED' as a new HL7 APPLICATION PARAMETER (the 242ND)? No// Yes

Select HL7 APPLICATION PARAMETER NAME: QBMIB VISTA SCHED
  Are you adding 'QBMIB VISTA SCHED' as a new HL7 APPLICATION PARAMETER (the 242ND)? No// Yes

Protocols

Protocols tie Applications, Links and code together. For a proof oc concept, the initial HL7 v2.x set of scheduling messages are:

  • SIU-S12 – Notification of new appointment booking
  • SIU-S15 – Notification of appointment cancellation

Using "HL7 Main Menu" --> "Interface Developer Options" --> "Protocol Edit"...

SIU-S12 (Notification of new appointment booking)

Select PROTOCOL NAME: QBMIB SCH SIU-S12 RCVR
Not a known package or a local namespace.
  Are you adding 'QBMIB SCH SIU-S12 RCVR' as a new PROTOCOL? No// Yes

The "SENDING APPLICATION" should be the one defined above "QBMIB MIRTH SCHED". The  subscriber can be created directly from this screen; "QBMIB SCH SIU-S12 RSUBS"

The "RECEIVING APPLICATION" should be the one defined above "QBMIB VISTA SCHED". The code for the processing routine (SIURCVR^QBMIBSCHED) can be found in the code repository (link on right).


SIU-S15 (Notification of appointment cancellation)

Select PROTOCOL NAME: QBMIB SCH SIU-S15 RCVR
Not a known package or a local namespace.
  Are you adding 'QBMIB SCH SIU-S15 RCVR' as a new PROTOCOL? No// Yes

The "SENDING APPLICATION" should be the one defined above "QBMIB MIRTH SCHED". The  subscriber can be created directly from this screen; "QBMIB SCH SIU-S15 RSUBS"

The "RECEIVING APPLICATION" should be the one defined above "QBMIB VISTA SCHED". The code for the processing routine (SIURCVR^QBMIBSCHED) can be found in the code repository (link on right).