HL7 MESSAGE REPOSITORY (EHRM HL7 Message #1609) ICR (7424)

Name

Value

NUMBER

7424

IA #

7424

DATE CREATED

2023/05/02

CUSTODIAL PACKAGE

ELECTRONIC HEALTH MODERNIZATION

USAGE

Controlled Subscription

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

EHMHL7

NAME

HL7 MESSAGE REPOSITORY (EHRM HL7 Message #1609)

GENERAL DESCRIPTION

Effective with patch EHM*1*10, a repository (EHRM HL7
Message file (#1609)) exists to store HL7 messages that can be used to
research production issues.  The repository is intended to store only
Inter-Facility Consult (IFC) and Patient Record Flags (PRF) HL7 messages
exchanged between non-converted VistA sites and Cerner Millennium.  This
ensures that the size of the repository is small relative to the total number
of HL7 messages on any individual VistA.

In addition to the repository, EHM*1*10 creates Application Programming
Interfaces (API) callable by subscribing packages to populate the repository.
The patch also supplies options to inquire into the repository and to purge
records.

Effective with patch GMRC*3*189, when an IFC is initiated by or received on a
non-converted VistA site, the order message and all follow-up messages are
added to the HL7 Message Repository.

Effective with patch DG*5.3*1091, when a PRF is initiated by or received on a
non-converted VistA site, the message is added to the HL7 Message Repository.

Note:  EHM*1*10, GMRC*3*189, DG*5.3*1091 and TIU*1*350 are combined in the IFC
ORDER/ADDENDUM UPDATES 1.0 build released in IFC_ORDER_ADDENDUM_UPDATES.KID.

STATUS

Active

DURATION

Till Otherwise Agreed

EHMHL7

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

SAVEHL7

Usage: $$SAVEHL7(TYPE)

To add a new record to the EHRM HL7 Message file (#1609).

Arguments:      TYPE - HL7 message type ("IFC" or "PRF")

The HL7 message is extracted from the standard HL7 array.

Returns: IEN in file #1609 if successful or 0^error message if not.

Example: $$SAVEHL7^EHMHL7("IFC")

VARIABLES	TYPE	VARIABLES DESCRIPTION
TYPE	Input	Specifies the type of HL7 message. Valid values are "IFC" or "PRF".

SAVEHL7X

Usage: $$SAVEHL7X(NODE,TYPE)

To add a new record to the EHRM HL7 Message file (#1609)

Arguments:      NODE - ^TMP node where the HL7 message is stored, i.e.,
^TMP(NODE,$J,i)=HL7 segment
TYPE - HL7 message type ("IFC" or "PRF")

Returns: IEN in file #1609 if successful or 0^error message if not.

Example: $$SAVEHL7X^EHMHL7("HLS","IFC")

VARIABLES	TYPE	VARIABLES DESCRIPTION
NODE	Input	Specifies the ^TMP node where the HL7 message is stored, i.e., ^TMP(NODE,$J,i)=HL7 segment.
TYPE	Input	Specifies the type of HL7 message "IFC" or "PRF".

SUBSCRIBING PACKAGE

SUBSCRIBING DETAILS

CONSULT/REQUEST TRACKING

Patch GMRC*3*189 modifies 2 routines - GMRCIMSG and
GMRCIUTL - to use the APIs provided by this ICR to record Inter-Facility
Consult HL7 messages involving Cerner as placer or filler so that production
questions and issues can be researched and resolved.

REGISTRATION

Patch DG*5.3*1091 modifies 2 routines - DGPFHLR and
DGPFHLS - to use the APIs provided by this ICR to record Patient Record Flag
HL7 messages involving Cerner so that production questions and issues can be
researched and resolved.

PROSTHETICS

Added 3/6/24, effective with patch RMPR*3*217 adds
several routines, one of which - RMPRINF0 - uses the API provided by this ICR
to record HL7 order and order-related messages received from or sent to
Cerner.

DATE ACTIVATED

2023/05/09