$TXT Created by at DEVRAD.DOMAIN.EXT (KIDS) on Monday, 02/10/25 at 09:57 ============================================================================= Run Date: MAR 11, 2025 Designation: RA*5*220 Package : RA - RADIOLOGY/NUCLEAR MEDICINE Priority: Mandatory Version : 5 SEQ #202 Status: Released Compliance Date: APR 11, 2025 ============================================================================= Associated patches: (v)RA*5*162 <<= must be installed BEFORE `RA*5*220' (v)RA*5*218 <<= must be installed BEFORE `RA*5*220' Subject: HL7 LOCK ERROR REPROCESS Category: - Routine - Data Dictionary - Other Description: ============ This patch introduces a new option that enables automatic reprocessing of HL7 result messages rejected due to locked studies or reports. This patch is approved for both VA VistA and EHRM sites Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- HL7 MESSAGE EXCEPTIONS REPROCESS (.07) NEW (79.3) RAD/NUC MED HL7 APPLICATION ENABLE LOCK STUDY NEW EXCEPTION (79.7) REPROCESSING (1.6) REPROCESS RETURN TO NEW SENDER (1.7) 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 ----------- ---- -------------------- Reprocess locked study Run Routine NEW accession error (RA REPROC) Enable HL7 reprocessing Run Routine NEW for locked studies (RASAN ENABLE REPROCESSING) IRM Menu (RA SITEMANAGER) Menu Modified 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 New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- INC34859823 - Powerscribe lock of study INC36016231 - R4 - (PRO)Radiology report fails to go through to Vista if tech is editing study the same time it is released. ADPAC has to resend report. Problem: -------- In the past, the absence of enforced record locking during HL7 processing led to data corruption. A patch was later implemented to enhance record locking. However, due to workflow changes over time, we are now experiencing issues with patient results being rejected. This occurs when a record is being edited at the same time an HL7 result message is processed. As a result, the PACS administrator must manually intervene to resend the affected result. Resolution: ------------ This patch introduces two new options that enables automatic reprocessing of messages rejected due to locked studies or reports. Reprocessing is enabled by the application and the new scheduled option will be setup to run every fifteen (15) minutes at the top of the hour following the patch installation. The following new option resides on the IRM Menu [RA SITEMANAGER]: NAME: RASAN ENABLE REPROCESSING MENU TEXT: Enable HL7 reprocessing for locked studies TYPE: run routine PACKAGE: RADIOLOGY/NUCLEAR MEDICINE DESCRIPTION: This option enables a sending application to reprocess HL7 result messages that were rejected due to a locked study error. Additionally, it includes a flag that, when set, overrides the radiology NOSEND flag and sends the reprocessed result message back to the sending application. ROUTINE: SANABLE^RAHLRPRO UPPERCASE MENU TEXT: ENABLE HL7 REPROCESSING FOR LO The following new option is stand alone (does not reside on a parent menu) and is not called interactively (It will be automatically scheduled to run.): NAME: RA REPROC MENU TEXT: Reprocess locked study accession error TYPE: run routine PACKAGE: RADIOLOGY/NUCLEAR MEDICINE E ACTION PRESENT: YES X ACTION PRESENT: YES DESCRIPTION: This option should be scheduled to run every fifteen minutes. Its primary function is to monitor the 'HL7 MESSAGE EXCEPTION' file for any 'REPROCESS' flags that are triggered by study or report lock errors. Upon detection, it will automatically reinitiate processing of the affected result message that was previously rejected due to this issue. EXIT ACTION: K RAOPT("REPROC") ENTRY ACTION: S RAOPT("REPROC")="" ROUTINE: REPROC^RAHLRPRO SCHEDULING RECOMMENDED: YES UPPERCASE MENU TEXT: REPROCESS LOCKED STUDY ACCESSI Test Sites: ----------- Providence VAMC, Providence RI Salt Lake City VAMC, Salt lake City UT SNOW Change Order # ------------------- Providence VAMC, CO# - CHG0572817 Salt Lake City VAMC, CO# - CHG0572713 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. 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 --------------------------------------------------------------------- Radiology/Nuclear Medicine Technical Manual RA5_0TM.PDF RA5_0TM.DOCX Patch Installation: ------------------- Pre-Installation Instructions: This patch 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 patch should take less than 5 minutes to install. No options should be disabled at installation. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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 RA*5.0*220. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. When prompted for the following, enter "B" for Build. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter your build RA*5.0*220. iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. 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 YES only if menus are not scheduled to be rebuilt every night. 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: INSTALLERS: Confirm the 'Reprocess locked study accession error' (RA REPROC) option has been scheduled to run every fifteen minutes in production. Note that it will not be scheduled in the TEST environment. RADIOLOGY ADPACS: To enable application reprocessing, it must be enabled using the new menu option (note that application naming conventions vary) Select IRM Menu Option: Enable HL7 reprocessing for locked studies Select RAD/NUC MED HL7 APPLICATION EXCEPTION HL7 APPLICATION NAME: RA-PS360-TCP ACTIVE ...OK? Yes// (Yes) ENABLE LOCK STUDY REPROCESSING: YES// <-- Enables reprocessing REPROCESS RETURN TO SENDER: YES// <-- For powerscribe to send the result back to PS and clear the error, set to YES. Back-out/Rollback Strategy: --------------------------- Back-out will be done only with the concurrence and participation of development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between development team, VA site/region personnel and other appropriate VA personnel. A national help desk ticket should be logged before attempting any backout procedures. Prior to installing an updated KIDS package, the site/region should have saved a backup of the routines in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The Packman function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. If the new backup build option was used, after Xtracting the patch message use the KIDS Installation menu and enter RA*5.0*220b at the INSTALL NAME prompt. --- Routine Information: ==================== The second line of each of these routines now looks like: ;;5.0;Radiology/Nuclear Medicine;**[Patch List]**;Mar 16, 1998;Build 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: RAHLEX Before: B73527008 After: B75134433 **12,17,25,220** Routine Name: RAHLEXF Before: B22623264 After: B28445336 **12,25,47,220** Routine Name: RAHLO1 Before: B65243058 After: B66397045 **4,5,12,17,21,27,48,55,66,87, 84,94,104,47,157,162,220** Routine Name: RAHLRPRO Before: n/a After: B8909797 **220** Routine Name: RAHLTCPX Before:B127047715 After:B131830178 **47,114,129,141,144,157,195, 207,218,220** Routine Name: RAIPS220 Before: n/a After: B2138576 **220** Routine list of preceding patches: 162, 218 ============================================================================= User Information: Entered By : Date Entered : AUG 27, 2024 Completed By: Date Completed: MAR 11, 2025 Released By : Date Released : MAR 11, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT