============================================================================= Run Date: DEC 01, 2021 Designation: MAG*3*271 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #212 Status: Released Compliance Date: JAN 04, 2022 ============================================================================= Subject: VistA Defect Patch Category: - Routine Description: ============ Description: This document describes MAG*3.0*271, a patch that adds new SOP class entries to VistA file #2006.539, the DICOM UID SPECIFIC ACTION file. This patch addresses the following issue: Defect: -------- 1. IMAG-504:INC11026650 - 1.2.840.10008.5.1.4.1.1.78.7 is listed in DICOM Options - Edit Supported SOP Classes but not in listener File, is it ok to add to my listener file? Note: MAG*3.0*271 requires the installation of MAG*3.0*257. MAG*3.0*257 adds the new SOP class entries in the Listen file. MAG*3.0*271 installs the new SOP class entries in VistA file #2006.539 Patch MAG*3.0*257 introduced new SOP classes to the Listen file but they could not be enabled because of the necessary corresponding entries in #2006.539 that are being brought in by MAG*3.0*271. If the new SOP Class entries introduced by MAG*3.0*271 KIDS in #2006.539 do not exist in the Listen file, they can be added. Once the SOP Class entries exist in the Listen file, they can be enabled by removing the # in front of the SOP Classes. After changes are made to the Listen file, restart the Tomcat service for it to take effect. The gateway Listen file can be found at C:\DCF_RunTime\cfg\apps\defaults\LISTEN\ Note: A new menu option MAG MANAGE NEW SOP CLASSES (Manage New SOP Classes) was added to the MAG SYS MENU. The new menu has two options MAG DICOM DISABLE SOP CLASSES(Disable SOP Classes)and MAG DICOM ENABLE SOP CLASSES(Enable SOP Classes) which can be used to enable and disable all new SOP classes. 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 ----------- ---- -------------------- MAG MANAGE NEW SOP CLASSES SEND TO SITE New MAG DICOM DISABLE SOP CLASSES SEND TO SITE New MAG DICOM ENABLE SOP CLASSES SEND TO SITE 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: ----------------------- 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. IMAG-504:INC11026650 - 1.2.840.10008.5.1.4.1.1.78.7 is listed in DICOM Options - Edit Supported SOP Classes but not in listener File, is it ok to add to my listener file? Problem: -------- VistA Imaging does not currently support the below listed SOP classes. 1.2.840.10008.5.1.4.1.1.78.7|Ophthalmic Axial Measurements Storage 1.2.840.10008.5.1.4.1.1.78.8|Intraocular Lens Calculations Storage 1.2.840.10008.5.1.4.1.1.79.1|Macular Grid Thickness and Volume Report Storage 1.2.840.10008.5.1.4.1.1.80.1|Ophthalmic Visual Field Static Perimetry Measurements Storage 1.2.840.10008.5.1.4.1.1.81.1|Ophthalmic Thickness Map Storage 1.2.840.10008.5.1.4.1.1.82.1|Corneal Topography Map Storage 1.2.840.10008.5.1.4.1.1.66.3|Deformable Spatial Registration Storage 1.2.840.10008.5.1.4.1.1.66.4|Segmentation Storage 1.2.840.10008.5.1.4.1.1.66.5|Surface Segmentation Storage 1.2.840.10008.5.1.4.1.1.66.6|Tractography Results Storage 1.2.840.10008.5.1.4.1.1.67|Real World Value Mapping Storage 1.2.840.10008.5.1.4.1.1.68.1|Surface Scan Mesh Storage 1.2.840.10008.5.1.4.1.1.68.2|Surface Scan Point Cloud Storage 1.2.840.10008.5.1.4.1.1.88.34|Comprehensive 3D SR Storage 1.2.840.10008.5.1.4.1.1.88.35|Extensible SR Storage 1.2.840.10008.5.1.4.1.1.88.70|Implantation Plan SR Document Storage 1.2.840.10008.5.1.4.1.1.88.71|Acquisition Context SR Storage 1.2.840.10008.5.1.4.1.1.88.72|Simplified Adult Echo SR Storage 1.2.840.10008.5.1.4.1.1.88.73|Patient Radiation Dose SR Storage 1.2.840.10008.5.1.4.1.1.88.74|Planned Imaging Agent Administration SR Storage 1.2.840.10008.5.1.4.1.1.88.75|Performed Imaging Agent Administration SR Storage 1.2.840.10008.5.1.4.1.1.104.2|Encapsulated CDA Storage 1.2.840.10008.5.1.4.1.1.104.3|Encapsulated STL Storage 1.2.840.10008.5.1.4.1.1.104.4|Encapsulated OBJ Storage 1.2.840.10008.5.1.4.1.1.104.5|Encapsulated MTL Storage 1.2.840.10008.5.1.4.1.1.481.9|RT Ion Beams Treatment Record Storage 1.2.840.10008.5.1.4.1.1.481.10|RT Physician Intent Storage 1.2.840.10008.5.1.4.1.1.481.11|RT Segment Annotation Storage 1.2.840.10008.5.1.4.1.1.481.12|RT Radiation Set Storage 1.2.840.10008.5.1.4.1.1.481.13|C-Arm Photon-Electron Radiation Storage 1.2.840.10008.5.1.4.1.1.481.14|Tomotherapeutic Radiation Storage 1.2.840.10008.5.1.4.1.1.481.15|Robotic-Arm Radiation Storage 1.2.840.10008.5.1.4.1.1.481.16|RT Radiation Record Set Storage 1.2.840.10008.5.1.4.1.1.481.17|RT Radiation Salvage Record Storage 1.2.840.10008.5.1.4.1.1.481.18|Tomotherapeutic Radiation Record Storage 1.2.840.10008.5.1.4.1.1.481.19|C-Arm Photon-Electron Radiation Record Storage 1.2.840.10008.5.1.4.1.1.481.20|Robotic Radiation Record Storage 1.2.840.10008.5.1.4.34.7|RT Beams Delivery Instruction Storage 1.2.840.10008.5.1.4.34.10|RT Brachy Application Setup Delivery Instruction Storage Resolution: ----------- Patch MAG*3.0*257 introduced new SOP classes to the Listen file but they could not be enabled because of the necessary corresponding entries in #2006.539 that are being brought in by MAG*3.0*271. If the new SOP Class entries introduced by MAG*3.0*271 KIDS in #2006.539 do not exist in the Listen file, they can be added. Once the SOP Class entries exist in the Listen file, they can be enabled by removing the # in front of the SOP Classes. After changes are made to the Listen file, restart the Tomcat service for it to take effect. Note: IOD Validation needs to be off in the AE Security Matrix for each entry (VALIDATE=NO) to prevent an IOD check error until a new patch can update the XML file used for IOD Validation, which is part of the DCF Toolkit, for the following SOP Classes: 1.2.840.10008.5.1.4.1.1.78.7|Ophthalmic Axial Measurements Storage 1.2.840.10008.5.1.4.1.1.78.8|Intraocular Lens Calculations Storage 1.2.840.10008.5.1.4.1.1.80.1|Ophthalmic Visual Field Static Perimetry Measurements Storage 1.2.840.10008.5.1.4.1.1.81.1|Ophthalmic Thickness Map Storage 1.2.840.10008.5.1.4.1.1.82.1|Corneal Topography Map Storage 1.2.840.10008.5.1.4.1.1.66.6|Tractography Results Storage 1.2.840.10008.5.1.4.1.1.68.1|Surface Scan Mesh Storage 1.2.840.10008.5.1.4.1.1.68.2|Surface Scan Point Cloud Storage 1.2.840.10008.5.1.4.1.1.88.34|Comprehensive 3D SR Storage 1.2.840.10008.5.1.4.1.1.88.35|Extensible SR Storage 1.2.840.10008.5.1.4.1.1.88.70|Implantation Plan SR Document Storage 1.2.840.10008.5.1.4.1.1.88.71|Acquisition Context SR Storage 1.2.840.10008.5.1.4.1.1.88.72|Simplified Adult Echo SR Storage 1.2.840.10008.5.1.4.1.1.88.73|Patient Radiation Dose SR Storage 1.2.840.10008.5.1.4.1.1.88.74|Planned Imaging Agent Administration SR Storage 1.2.840.10008.5.1.4.1.1.88.75|Performed Imaging Agent Administration SR Storage 1.2.840.10008.5.1.4.1.1.104.3|Encapsulated STL Storage 1.2.840.10008.5.1.4.1.1.104.4|Encapsulated OBJ Storage 1.2.840.10008.5.1.4.1.1.104.5|Encapsulated MTL Storage 1.2.840.10008.5.1.4.1.1.481.10|RT Physician Intent Storage 1.2.840.10008.5.1.4.1.1.481.11|RT Segment Annotation Storage 1.2.840.10008.5.1.4.1.1.481.12|RT Radiation Set Storage 1.2.840.10008.5.1.4.1.1.481.13|C-Arm Photon-Electron Radiation Storage 1.2.840.10008.5.1.4.1.1.481.14|Tomotherapeutic Radiation Storage 1.2.840.10008.5.1.4.1.1.481.15|Robotic-Arm Radiation Storage 1.2.840.10008.5.1.4.1.1.481.16|RT Radiation Record Set Storage 1.2.840.10008.5.1.4.1.1.481.17|RT Radiation Salvage Record Storage 1.2.840.10008.5.1.4.1.1.481.18|Tomotherapeutic Radiation Record Storage 1.2.840.10008.5.1.4.1.1.481.19|C-Arm Photon-Electron Radiation Record Storage 1.2.840.10008.5.1.4.1.1.481.20|Robotic Radiation Record Storage 1.2.840.10008.5.1.4.34.7|RT Beams Delivery Instruction Storage 1.2.840.10008.5.1.4.34.10|RT Brachy Application Setup Delivery Instruction Storage Test Sites: ----------- Jesse Brown VAMC (Chicago, IL) VA Eastern Colorado Health Care System (Denver, CO) 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_0P271.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 Distribution MAG3_0P271.KID System (KIDS) build for Patch 271 Documentation Title File Name ------------------------------------------------------------------ Patch Description for MAG*3.0*271 MAG3_0P271_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P271_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- MAG*3.0*271 must be installed on the VistA System. This patch must be installed by the compliance date. All sites running VistA Imaging 3.0 must install the KIDS portion of this patch. This patch can be loaded while the VistA Imaging System is active, and users are on the system. Installing the MAG*3.0*271 KIDS takes 2-5 minutes. Note: Verify that the patches listed in the Associated Patches section of this document have been previously installed. Note: To avoid losing configuration changes, sites with a modified HDIG Listen file will need to save a copy of the file before installing this patch. After the installation is complete, restore the file and restart the Tomcat service. C:\DCF_RunTime\cfg\apps\defaults\LISTEN 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/MAG3_0P271.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 patch or build name (ex. MAG*3.0*271). 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. 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 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?,' answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install?', answer NO. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*271 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 271 ;Created on Nov 09, 2020@20:45:05 This Distribution was loaded on Nov 19, 2020@10:14:39 with header of VistA Imaging 3.0 - Patch 271 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*271 Checking Install for Package MAG*3.0*271 Install Questions for MAG*3.0*271 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*271 : Nov 19, 2020@10:14:53 Build Distribution Date: Nov 09, 2020 Installing Routines:... Nov 19, 2020@10:14:53 Running Post-Install Routine: POS^MAGIP271. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*271 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- N/A 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*271 VistA KIDS, select the Kernel Installation & Distribution System menu option, Backup a Transport Global, (see Installation Steps section, step 2-B 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*271 install on And/Or Backup of MAG*3.0*271 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 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 #43934 Unloading Routine MAGXXXX (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]**;Mar 19, 2002;Build 4;Apr 07, 2011 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Before Checksum After Patch List MAGIP271 NEW 43402165 **271** MAGVSOPD NEW 111454455 **271** MAGVSOPE NEW 106859824 **271** MAGVSOPU 118959735 111247396 **118,271** MAGVSPD2 NEW 35364902 **271** MAGVSPE2 NEW 33733229 **271** MAGVSPU2 NEW 35193509 **271** Routine MAGIP271 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JUN 17, 2020 Completed By: Date Completed: NOV 30, 2021 Released By : Date Released : DEC 01, 2021 ============================================================================= Packman Mail Message: ===================== No routines included