============================================================================= Run Date: JAN 28, 2021 Designation: MAG*3*280 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #197 Status: Released Compliance Date: FEB 04, 2021 ============================================================================= Subject: VI - Vista Fix for HDIG Category: - Routine Description: ============ This document describes MAG*3.0*280, a patch that addresses the following issue: 1.|TAB|INC11957731 - Service Class Provider (SCP) is receiving DICOM objects with illegal values for Service-Object Pair (SOP) Instance UID Patch Components: ----------------- 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: Option Name Type New/Modified/Deleted ----------- ---- -------------------- N/A 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 --------------------- -------------------- RPC MAG IMAGE Modified CURRENT INFO|TAB| 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.|TAB|Defect 1297600 (Trouble Ticket INC11957731) Service Class Provider (SCP) is receiving DICOM objects with illegal values for Service-Object Pair (SOP) Instance UID Problem: -------- When performing Query Retrieve for a single study/accession number, the system returns the correct images but replaces some of the DICOM header information with incorrect patient information. This is an intermittent issue occurring only for new Service Object Pair classes. Resolution: ----------- The legacy code attempts to start an updated UID look up in the IMAGE SOP INSTANCE (#2005.64) file using the IMAGE INSTANCE (#2005.65) file Image IEN, instead of the IMAGE SOP INSTANCE IEN. MAGDQR04 and MAGDRPC9 have been updated to use the SOP INSTANCE IEN to look up the updated UID when starting the lookup in the IMAGE SOP INSTANCE (#2005.64) file. Test Sites: ----------- |TAB|Mann-Grandstaff VA Medical Center (Spokane, WA) |TAB|Jonathan M. Wainwright Memorial VA Medical Center (Walla Walla, WA) 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_0P280.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 File Title File Name ------------------------------------------------------------------ Kernel Installation and MAG3_0P280.KID Distribution System (KIDS)|TAB||TAB| Documentation Title File Name ------------------------------------------------------------------ Patch Description for P280 MAG3_0P280_Patch_Description.pdf Deployment, Installation, MAG3_0P280_DIBORG.pdf Back-Out, and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- Before installing MAG*3.0*280, stop the Tomcat service on all HDIGs and stop all DICOM Legacy Gateway processes. MAG*3.0*280 must be installed on the VistA System by the compliance date. 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 five minutes to install. Note: All released VistA Imaging patches must be installed on the VistA system before installing this patch. Installation Instructions: -------------------------- 1.|TAB|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/MAG3_0P280.KID 2.|TAB|From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu: A.|TAB|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 patch or build name (ex. MAG*3.0*280). 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 of any routines exported with this patch. It will not backup any other changes such as DDs or templates. C. You may also elect to use the following options: i. |TAB|Print Transport Global - This option will allow you to view the components of the KIDS build. ii. |TAB|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. |TAB|If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install?,' answer NO. ii. |TAB|When prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii.|TAB|When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?,' answer NO a. When prompted 'Enter options you wish to mark as 'Out of Order':,' press the Enter key. b. When prompted 'Enter protocols you wish to mark as 'Out of Order':,' press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//,' answer 0. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*280 12/19/19@10:14:39 => VistA Imaging 3.0 - Patch 280 ;Created on Dec 09, 2019@20:45:05 This Distribution was loaded on Dec 19, 2019@10:14:39 with header Of VistA Imaging 3.0 - Patch 280 ;Created on Dec 09, 2019@20:45:05 It consisted of the following Install(s): MAG*3.0*280 Checking Install for Package MAG*3.0*280 Install Questions for MAG*3.0*280 Want KIDS to INHIBIT LOGONs during the install? NO// Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// HERE Install Started for MAG*3.0*280 : Dec 19, 2019@10:14:53 Build Distribution Date: Dec 09, 2019 Installing Routines:... Dec 19, 2019@10:14:53 Running Post-Install Routine: POS^MAGIP280. Post Install Mail Message: Dec 19, 2019@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*280 Installed. Dec 19, 2019@10:14:53 Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling Client: -------------------- N/A - Application client installation is not required in a KIDS only build. KIDS Uninstall: --------------- If it is necessary to uninstall the MAG*3.0*280 VistA KIDS, then select the Kernel Installation & Distribution System menu option, Backup a Transport Global (see the Installation Instructions section) where step 2b 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.|TAB|Select the message shown below: 2.|TAB|Backup of MAG*3.0*280 install on 3.|TAB|Select the Xtract PackMan option. 4.|TAB|Select the Install/Check Message option. 5.|TAB|Enter Yes at the prompt. 6.|TAB|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: ?5 Answer with PackMan function NUMBER, or NAME Choose from: 1|TAB|ROUTINE LOAD 2|TAB|GLOBAL LOAD 3|TAB|PACKAGE LOAD 4|TAB|SUMMARIZE MESSAGE 5|TAB|PRINT MESSAGE 6|TAB|INSTALL/CHECK MESSAGE 7|TAB|INSTALL SELECTED ROUTINE(S) 8|TAB|TEXT PRINT/DISPLAY 9|TAB|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+[-0- Routines are the only parts that are backed up. NO other parts are backed up, not even globals. You may use the Summarize Message option of PackMan to see what parts the message contains. Those parts that are not routines should be backed up separately if they need to be preserved. 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 MAGXXXX (PACKMAN_BACKUP) Select PackMan function: Routine Information: -------------------- 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]**; Mar 19, 2002;Build 2 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums: ------------------ Routine Checksum Before Checksum After Patch List ------- --------------- -------------- ---------- MAGDRPC9 98039455 100959324 **50,54,53,49, 123,118,138, 180,190,239, 280* MAGDQR04 141742337 143598216 **51,54,66,123, 118,263,280** MAGIP280 New 4110401 **280** Routine MAGIP280 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGDQR04 Before:B141742337 After:B143598216 **51,54,66,123,118,263,280** Routine Name: MAGDRPC9 Before: B98039455 After:B100959324 **50,54,53,49,123,118,138,180, 190,239,280** Routine Name: MAGIP280 Before: n/a After: B4110401 **280** Routine list of preceding patches: 239, 263 ============================================================================= User Information: Entered By : Date Entered : AUG 21, 2020 Completed By: JR Date Completed: JAN 15, 2021 Released By : Date Released : JAN 28, 2021 ============================================================================= Packman Mail Message: ===================== No routines included