============================================================================= Run Date: DEC 19, 2022 Designation: MAG*3*332 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #234 Status: Released Compliance Date: JAN 19, 2023 ============================================================================= Associated patches: (v)MAG*3*283 <<= must be installed BEFORE `MAG*3*332' Subject: IMPORTER: ADAPTIVE MAINTENANE AND DEFECT FIXES Category: - Routine Description: ============ This document describes, MAG*3.0*332, a patch that provides adaptive maintenance and defect fixes to VistA Imaging DICOM Importer. This patch addresses the following issues: Adaptive Maintenance: --------------------- 1. Adaptive Maintenance: Update .NET framework to 4.8 - Importer 2. Adaptive Maintenance: Update C# language to version 9 3. Adaptive Maintenance: Addressed Fortify issues Defects: -------- 1. INC21152812: Vista Importer III not identifying when images already in Vista Imaging displayed. 2. INC21205722: Duplicate of INC21152812 3. INC22698505: Duplicate of INC21152812 and INC21205722 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 --------------------- -------------------- 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 Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. Adaptive Maintenance: Update .NET framework to 4.8 - Importer Description: ------------ Previous build of this software used an old version of the .NET framework runtime library. Resolution: ----------- Upgraded the Importer .NET framework library to 4.8 and compiled in Visual Studio 2019. 2. Adaptive Maintenance: Update C# language to version 9 Description: ------------ Previous build of this software was compiled according to an old C# language specification. Resolution: ----------- Set the C# language specification and feature version to use when compiling Importer in Visual Studio 2019. 3. Adaptive Maintenance: Addressed Fortify issues Description: ------------ Fortify software scan produces an analysis report of the Importer source code. This report contains recommendation on how to improve a software from both technical and overall specification. Resolution: ----------- Changed source code (C#) of Importer according to Fortify scan recommendation. Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1.INC21152812 - Vista Importer III not identifying when images already in Vista Imaging displayed. Duplicated in INC21205722 and INC22698505. Problem: -------- The RPC called to check the import status is being passed the original UID values so if any are replaced with a new UID, a status of false (file not found) is returned. Resolution: ----------- The entry point routines MAGVIM01 and MAGVIM09 of 'MAGV IMPORT STATUS' RPC have been modified to check for replaced UIDs if the ones passed are not found. No changes were made to the 'MAGV IMPORT STATUS' RPC definition. Test Sites: ----------- VA Lexington Health Care (Lexington, KY) Jesse Brown VA Medical Center (Chicago, IL) 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_0P332.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_0P332.KID Distribution System (KIDS) build for MAG*3.0*332 VistA Imaging DICOM Importer MAG3_0P332_IMPORTERIII_SETUP.MSI MSI File VistA Imaging DICOM Importer MAG3_0P332_IMPORTERIII_SETUP.EXE EXE File 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 -------------------------------------------------------------------------- Patch Description for MAG*3.0*332 MAG3_0P332_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P332_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: -------------------------------- MAG*3.0*332 must be installed on the VistA System. This patch must be installed 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 5 minutes to install. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*332. 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_0P332.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 (MAG*3.0*332). 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. 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. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter your build (MAG*3.0*332). 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. vii. Repeat step ii for each build in the host file. 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 NO. 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. iv. 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*332 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 332; 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 332; Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*332 Checking Install for Package MAG*3.0*332 Install Questions for MAG*3.0*332 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*332: 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^MAGIP332. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*332 Installed. Nov 19, 2020@10:14:53 DICOM Importer III Installation Instructions -------------------------------------------- For installing or updating Importer III, refer to the VistA Imaging System DICOM Importer III User Manual. Post-Installation Instructions: ------------------------------ N/A Back-Out/Roll Back Plan: ------------------------ For information about back-out steps, see this document: MAG3_0P332_DIBORG.PDF in the VistA Documentation Library at: http://www.domain.ext/vdl/ Uninstalling the Application: ----------------------------- For installing or updating Importer III, refer to the VistA Imaging System DICOM Importer III User Manual. KIDS Uninstall: --------------- If it is necessary to uninstall the MAG*3.0*332 VistA KIDS, the patch backup must be installed. The Kernel Installation & Distribution System menu option, Backup a Transport Global should have been used to create a patch backup of the build prior to installing the patch. (see Installation Instructions section step 2B above). Administrators will need to check MailMan for the backup message sent by the Backup a Transport Global function executed prior to the patch install. The patch backup must first be loaded from the MailMan backup message, by performing the message action Xtract KIDS, followed by the PackMan function INSTALL/CHECK MESSAGE. The patch may then be installed using the Install Package(s) option in the KIDS Installation menu. 1. Navigate to the Mailman inbox containing the patch backup message. a. Select the MAG*3.0*332 backup message as shown below: * Backup of MAG*3.0*332 install on b. At the "Enter message action:" prompt, select the Xtract PackMan option. c. At the "Select PackMan function:" prompt, select the Install/Check Message option. d. Enter Yes at the prompt "OK to continue with Load?" 2. Navigate to the Kernel Installation and Distribution System Menu and select the Installation Menu. From this menu: a. 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 NO. 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. iv. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Example, Loading Patch Backup (Build) -------------------------------------------- IN Basket Search *=New/!=Priority.........Subject...............Lines.From.....Read/Rcvd 13093. [313643] 09/06/22 Backup of MAG*3.0*332 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*332 on Sep 06, 2022 [#313643] 09/06/22@12:43 3099 lines From: MANAGER,SYSTEMS In 'IN' basket. Page 1 -------------------------------------------------------------------------- $TXT Created by PROGRAMMER,MAG at DOSO.DOMAIN.EXT (KIDS) on Tuesday, 09/06/22 at 12:42 Warning: Installing this backup patch message will install older versions of routines and Build Components (options, protocols, templates, etc.). Please verify with the Development Team that it is safe to install. Type to continue or '^' to exit: ^ Enter message action (in IN basket): Ignore// Xtract KIDS Select PackMan function: 6 INSTALL/CHECK MESSAGE Line 8 Message #313643 Unloading KIDS Distribution MAG*3.0*332b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*332b Example, Installing Patch Backup (Build) ----------------------------------------------- Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Select Kernel Installation & Distribution System Option: INstallation Select Installation Option: INstall Package(s) Select INSTALL NAME: MAG*3.0*332b This Distribution was loaded on Sep 07, 2022@11:54:20 with header of Backup of MAG*3.0*332 on Sep 06, 2022 It consisted of the following Install(s): MAG*3.0*332b Checking Install for Package MAG*3.0*332b Install Questions for MAG*3.0*332b 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// 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 MAG*3.0*332b -------------------------------------------------------------------------- Build Distribution Date: Sep 06, 2022 Installing Routines: Sep 07, 2022@11:54:36 Installing PACKAGE COMPONENTS: Installing OPTION Sep 07, 2022@11:54:36 Updating Routine file... Updating KIDS files... MAG*3.0*332b Installed. Sep 07, 2022@11:54:36 NO Install Message sent -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 34 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP332 Before: n/a After: B4110386 **332** Routine Name: MAGVIM01 Before:B204260385 After:B167014405 **118,138,221,250,283,332** Routine Name: MAGVIM09 Before: B12262639 After: B56577125 **118,138,332** Routine list of preceding patches: 283 ============================================================================= User Information: Entered By : Date Entered : MAR 11, 2022 Completed By: Date Completed: DEC 19, 2022 Released By : Date Released : DEC 19, 2022 ============================================================================= Packman Mail Message: ===================== No routines included