============================================================================= Run Date: MAR 20, 2020 Designation: MAG*3*252 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #187 Status: Released Compliance Date: APR 20, 2020 ============================================================================= Subject: VistA Imaging Importer Defect Patch Category: - Routine Description: ============ MAG*3.0*252, a patch that addresses the following Importer issue: The DICOM Importer application does not screen-out inactive diagnostic codes Patch Components: ----------------- MAG3_0P252.KID - Kernel Installation and Distribution System (KIDS) build for MAG*3.0*252 MAG3_0P252_Patch_Description.pdf - Patch Description for P252 MAG3_0P252_DIBORG.pdf - Deployment, Installation, Back-Out, and Rollback Guide 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 --------------------- -------------------- 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. Defect 1153307 (Trouble Ticket INC8022103) DICOM Importer application does not screen-out inactive diagnostic codes Problem: -------- The DICOM Importer application does not screen out inactive diagnostic codes. When selected, this results in imports not completing properly. Resolution: ----------- Addressed the issue by modifying the MAGV GET RAD DX CODES in the MAGVIMRA routine. This modification allows the application to screen out inactive radiology diagnostic codes. Test Sites: ----------- Kansas City VA Medical Center Software and Documentation Retrieval Instructions: -------------------------------------------------- Documentation describing the new functionality and/or a host file containing a build may be included in this release. Sites may retrieve the software and/or documentation directly using Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory on server download.vista.domain.ext Documentation can also be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*252 is released, the list of supported versions of Importer will change: Client Versions Supported: 3.0.237 3.0.217 3.0.206 Client Versions No Longer Supported: 3.0.136 3.0.118 Pre/Post Installation Overview: MAG*3.0*252 must be installed on the VistA System and on 64-bit workstations on which the VistA Imaging Applications will be used. 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 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. Verify that the patches listed in the Associated Patches section of this document have been previously installed. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*252. Note: For Windows 10, check to verify that the Broker Server entries are not missing in their Registry: [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Vista\Broker\Servers] to prevent Importer from closing the login screen. Prerequisite: With the release of patch MAG*3.0*206 KIDS package, all users who access the Importer application must be assigned the secondary menu option called MAGTP WORKLIST MGR in VistA. This is required because currently the REMOTE APPLICATION file has no entry available for the Importer application. This is a temporary work around until there is an entry created for the Importer application via a patch release. Installation Instructions: The actual KIDS installation will take less than one minute. 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_0P252.KID of the Patch 252 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 exported with the patch. It will NOT back up any of the other changes. 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*252. 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. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*252 12/19/19@10:14:39 => VistA Imaging 3.0 - Patch 252 ;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 252 ;Created on Dec 09, 2019@20:45:05 It consisted of the following Install(s): MAG*3.0*252 Checking Install for Package MAG*3.0*252 Install Questions for MAG*3.0*252 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*252 : 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^MAGIP252. Post Install Mail Message: Dec 19, 2019@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*252 Installed. Dec 19, 2019@10:14:53 Installing the Application Client: ---------------------------------- N/A - Application client installation is not required in a KIDS-only build. Post-Installation Instructions: ------------------------------- N/A - Application client installation is not required in a KIDS-only build. Back-Out/Roll Back Plan: ------------------------ Uninstalling the Importer III 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*252 VistA KIDS, then select the Kernel Installation & Distribution System menu option, Backup a Transport Global (see the Installation Steps section) where 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*252 install on 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 #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 1;Feb 15, 2017 CHECK1^XTSUMBLD is used to generate the checksums. Routine Checksums Routine Checksum Checksum Patch List Before After MAGIP252 New 4110395 **252** MAGVIMRA 26121368 27033610 **138,164,252** Routine MAGIP252 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 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP252 Before: n/a After: B4110395 **252** Routine Name: MAGVIMRA Before: B26121368 After: B27033610 **138,164,252** Routine list of preceding patches: 164 ============================================================================= User Information: Entered By : Date Entered : NOV 19, 2019 Completed By: Date Completed: MAR 20, 2020 Released By : Date Released : MAR 20, 2020 ============================================================================= Packman Mail Message: ===================== No routines included