$TXT Created by T at CLE623.FO-BAYPINES.DOMAIN.EXT (KIDS) on Monday, 10/30/23 at 09:58 ============================================================================= Run Date: NOV 06, 2024 Designation: EHM*1*10 Package : EHM - ELECTRONIC HEALTH MODERNIZATI Priority: Mandatory Version : 1 SEQ #1 Status: Released Compliance Date: DEC 06, 2024 ============================================================================= Subject: IFC AND PRF HL7 MESSAGE REPOSITORY Category: - Routine - Other - Data Dictionary Description: ============ This patch is part of the IFC PROXY ADD/ORDER RESUBMISSION 1.0 build. Below is a list of all the applications involved in this multi-build host file along with their patch numbers: APPLICATION/VERSION PATCH -------------------------------------- ------------- REGISTRATION v5.3 DG*5.3*1096 ELECTRONIC HEALTH MODERNIZATION v1.0 EHM*1*10 CONSULT/REQUEST TRACKING v3.0 GMRC*3*189 REGISTRATION v5.3 DG*5.3*1091 Resolution of errors and data discrepancies involving converted and non-converted sites is made difficult by the routine purging of HL7 messages in VistA. Problems with Inter-Facility Consults (IFC) and Patient Record Flags (PRF) regularly require greater time to resolve than is allowed by the current scheduled HL7 message purge. Since IFC and PRF HL7 message traffic that involves both a converted and a non-converted site are small relative to the overall HL7 message traffic in VistA, the solution is to save the few relevant messages separately rather than to extend the retention period of the greater whole. EHM*1*10 creates a repository (EHM HL7 Message #1609) for HL7 messages and provides APIs that save messages in the repository. It also supplies software tools to inquire about messages in the repository and to purge its messages. Purging records from file #1609 is performed by the EHMHL7 PURGE option based on retention periods defined in the EHRM HL7 Message Retention file (#1609.1) for each message type (IFC and PRF). As indicated below in the Patch Installation instructions, this option should be scheduled in TaskMan to run each day. Retention periods are initially set during patch load to 30 days but can be customized at each VistA site by editing the RETENTION field (#1) using FileMan. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- EHM HL7 Message (#1609) DATE/TIME POSTED (#.01) NEW TYPE (#1) NEW MESSAGE ID (#2) NEW VISTA CONSULT NUMBER (#3) NEW CERNER ORDER NUMBER (#4) NEW PATIENT'S NAME (#5) NEW ICN (#6) NEW SENDER (#7) NEW RECEIVER (#8) NEW HL7 MESSAGE (#10) NEW EHM HL7 Message Retention (#1609.1) TYPE (#.01) NEW RETENTION (#1) NEW Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- EHMHL7 INQUIRE ROUTINE NEW EHMHL7 MENU MENU NEW EHMHL7 PURGE ROUTINE NEW Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- N/A Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: ----------- VA Portland Health Care System (Portland, Vancouver) Chalmers P. Wylie Ambulatory Care Center, Columbus SNOW Change Order #: -------------------- VA Portland Health Care System (Portland, Vancouver) - CHG0485482 Chalmers P. Wylie Ambulatory Care Center, Columbus - CHG0526853 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released as part of the IFC PROXY ADD/ORDER RESUBMISSION 1.0 multi-build. The patches in this build are released in host file /srv/vista/patches/SOFTWARE/IFC_PROXY_ADD_ORDER_RESUBMISSION.KID Other Software Files: N/A File Title File Name Format --------------------------------------------------------------------- N/A Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name --------------------------------------------------------------------- ELECTRONIC HEALTH MODERNIZATION User Guide EHM_UG.DOCX EHM_UG.PDF ELECTRONIC HEALTH MODERNIZATION Technical Manual EHM_TM.DOCX EHM_TM_PDF Patch Installation: Pre/Post Installation Overview ------------------------------ N/A Pre-Installation Instructions: This build may be installed with users on the system although it is recommended that it be installed during non-peak hours to minimize potential disruption to users. This build should take less than 30 minutes to install. This patch should not be queued. Installation Instructions: 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/IFC_PROXY_ADD_ORDER_RESUBMISSION.KID. 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter the build name IFC PROXY ADD/ORDER RESUBMISSION 1.0. NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option for each patch contained in the Host File. For each patch you can specify what to backup; the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to pre-patch condition. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: Please refer to the "IFC PROXY ADD/ORDER RESUBMISSION Deployment, Installation, Back Out and Rollback Guide" for additional post-installation instructions. After patch installation has completed, restart the HL7 incoming filers. First, use the Monitor, Start, Stop Filers [HL FILER MONITOR] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU] to stop the filers. After the filers have stopped, use the Monitor, Start, Stop Filers [HL FILER MONITOR] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU] to start the filers. Back-Out/Roll Back Plan ----------------------- Please refer to the "IFC PROXY ADD/ORDER RESUBMISSION Deployment, Installation, Back Out and Rollback Guide". Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;ELECTRONIC HEALTH MODERNIZATION;**[Patch List]**;Apr 19, 2021;Build 17 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: EHMHL7 Before: n/a After: B42633520 **10** ============================================================================= User Information: Entered By : Date Entered : MAR 10, 2022 Completed By: Date Completed: NOV 05, 2024 Released By : Date Released : NOV 06, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT