============================================================================= Run Date: SEP 10, 2021 Designation: MAG*3*306 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #206 Status: Released Compliance Date: OCT 12, 2021 ============================================================================= Associated patches: (v)MAG*3*231 <<= must be installed BEFORE `MAG*3*306' Subject: DICOM AUTOMATIC Q/R IMPROVEMENT Category: - Routine Description: ============ This document describes MAG*3.0*306, a KIDS only patch that provides fixes to the VistA Study Tracker Automatic Compare and Retrieve option. This patch addresses the following issue: 1. INC18351116 - The Automatic Compare and Retrieve in Study Tracker is pulling the wrong images from picture archiving and communication system (PACS) and they are going to DICOM Correct. Associated Patches: ----------------- This patch must be installed after: MAG*3.0*231 Patch Components: ----------------- MAG3_0P306.KID - Kernel Installation and Distribution System (KIDS) build for Patch 306 - New MAG3_0P306_DIBORG.PDF - Legacy DICOM Gateway Deployment, Installation, Back-Out, and Rollback Guide - New Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Synonym Option Name Display Text ------- ----------- -------------------- N/A Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name New/Modified/Deleted ----------------- -------------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. Defect 967062 (Trouble Ticket INC4101382) INC18351116 - The Automatic Compare and Retrieve in Study Tracker is pulling the wrong images from PACS and they are going to DICOM Correct. Problem: -------- When the Study Tracker does a Radiology automatic compare or retrieve from the PACS it queries by accession number. Some PACS have studies that have the same accession number but are from different locations and prior to appending the site code on the front of the accession number. The Study Tracker query pulls the first encounter of the accession numbers and the study demographics from the PACS may not match the study in VistA so the study goes to DICOM Correct. Resolution: ----------- Study Tracker was updated to query by accession number and last four of the SSN so that the correct study is returned. Test Sites: ----------- Ann Arbor Boston Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P306.KID Other Software Files: This release also includes other software files. These files can be obtained by accessing the URL: https://download.vista.domain.ext/index.html/SOFTWARE Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*306 is released, the list of supported versions of Legacy DICOM Gateway (LDGW) will not change: Client Versions Supported: 3.0.231 3.0.218 3.0.190 Client Versions No Longer Supported: 3.0.183 3.0.166 3.0.174 Pre/Post Installation Overview: Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*306. All sites running VistA Imaging 3.0 must install the KIDS portion of this patch on the VistA System. This patch can be loaded while the VistA Imaging System is active, and users are on the system. This patch must be installed by the compliance date to conform to VHA Directive 2001-023 Installation Instructions: -------------------------- The actual KIDS installation will take less than 2 minutes. 1 On the VistA system, access the Kernel Installation and Distribution System Menu [XPD MAIN]. 2 Run the Installation option [XPD INSTALLATION MENU]. 3 Load the KIDS file by performing the following steps: a. Run the Load a Distribution option [XPD LOAD DISTRIBUTION] to load the KIDS distribution. b. When prompted, enter the path and file name (MAG3_0P306.KID) of the Patch 306 KIDS file. c. When prompted to continue with the load, enter "YES". A Distribution OK! message will be displayed when the load is complete. 4 After loading the KIDS file, use the following options to verify the contents of the patch and to back up any affected routines a. Verify Checksums in Transport Global [XPD PRINT CHECKSUM] - Run this option to ensure the integrity of the routines in the patch. b. Compare Transport Global to Current System [XPD COMPARE TO SYSTEM] - Run this option to view all changes that will be made when the patch is installed. All components (routines, options, and so on) in the patch will be compared. c. Backup a Transport Global [XPD BACKUP] - Run this option to create a backup message of any Routines and the Build for this patch. 5 After performing the load and any optional verification steps, install the KIDS file by performing the following steps: a. Run the Install Package(s) [XPD INSTALL BUILD] option. b. When prompted for the install name, enter "MAG*3.0*306". c. Answer "NO" to the following prompts: Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// 6 When installation is finished, an Install Complete message will be displayed. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: N/A KIDS Uninstall: If it is necessary to uninstall the MAG*3.0*306 VistA KIDS, then select the "Kernel Installation & Distribution System" menu option, "Backup a Transport Global" (see Installation Steps section, step 4c must be done before installing the patch). Administrators will need to use the PackMan function INSTALL/CHECK MESSAGE. Check the MailMan messages for the backup message sent by the "Backup a Transport Global" function executed prior to the patch install. 1. Select the message shown below: Backup of MAG*3.0*306 install on And/Or Backup of MAG*3.0*306 install on Routines Only 2. Select the Xtract PackMan option. 3. Select the Install/Check Message option. 4. Enter "Yes" at the prompt. 5. Enter "No" at the backup prompt. There is no need to back up the backup. Enter message action (in IN basket): Ignore// Xtract PackMan Select PackMan function: ? Answer with PackMan function NUMBER, or NAME Choose from: 1 ROUTINE LOAD 2 GLOBAL LOAD 3 PACKAGE LOAD 4 SUMMARIZE MESSAGE 5 PRINT MESSAGE 6 INSTALL/CHECK MESSAGE 7 INSTALL SELECTED ROUTINE(S) 8 TEXT PRINT/DISPLAY 9 COMPARE MESSAGE Select PackMan function: Select PackMan function: 6 INSTALL/CHECK MESSAGE Warning: Installing this message will cause a permanent update of globals and routines. Do you really want to do this? NO// YES Shall I preserve the routines on disk in a separate back-up message? YES// NO No backup message built. Line 2 Message #42925 Unloading Routine MAGGGTU4C (PACKMAN_BACKUP) Select PackMan function: Routine Information: VistA KIDS Checksums: This section lists modified routines for the VistA KIDS build. For each routine, the second line will contain the following information: ;;3.0;IMAGING;**[Patch List]**;5-May-2007;Build 1 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Before Checksum After Patch List MAGDSTA1 165724732 165765303 **231,306** MAGDSTA6 26478026 26350388 **231,306** MAGDSTA9 26552534 26490456 **231,306** MAGDSTAA 95449718 97863099 **231,306** MAGDSTAB 20075272 21702130 **231,306** MAGDSTAS 135860082 135924682 **231,306** MAGDSTD2 61061497 61060762 **231,306** MAGDSTD3 54201984 54201363 **231,306** MAGIP306 N/A 4282497 **306** Routine MAGIP306 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JUN 11, 2021 Completed By: Date Completed: SEP 09, 2021 Released By : Date Released : SEP 10, 2021 ============================================================================= Packman Mail Message: ===================== No routines included