Print Page as PDF
HL7 MESSAGE REPOSITORY (EHRM HL7 Message #1609) ICR (7424)

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.

Effective with EHM*1*16, the repository also stores Prosthetics (PSAS) HL7
messages exchanged between non-converted VistA sites and Cerner Millennium.
STATUS Active
DURATION Till Otherwise Agreed
ID EHMHL7
COMPONENT/ENTRY POINT
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","PRF" or "PSAS")

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","PRF" or "PSAS".
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","PRF" or "PSAS")

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","PRF" or
"PSAS".
SUBSCRIBING PACKAGE
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 2025/04/23