============================================================================= Run Date: JUN 30, 2022 Designation: MAG*3*290 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #226 Status: Released Compliance Date: AUG 01, 2022 ============================================================================= Subject: VistA Imaging Clinical Display Defects/Adaptive Maintenance Category: - Routine Description: ============ This document describes MAG*3.0*290, a patch that provides fixes to VistA Imaging Clinical Display. This patch also addresses the removal of Internet Explorer (IE) dependencies to be replaced with Microsoft Edge and Google Chrome as the dependent browsers for XML and PDF support. This patch addresses the following issues: Defects: -------- 1. INC17543733 - MAG*3.0*256 Clinical Display message history log file showing unencrypted PW 2. INC15372987 - MAG.INI Workstation timeout setting does not appear to be working Adaptive Maintenance: --------------------- 1. Adaptive Maintenance - Display - Adobe Acrobat Reader DC v20.012.20048 upgrade 2. Adaptive Maintenance - Clinical Display support for P290 Delphi 10.4 & Accusoft 18 3. Adaptive Maintenance - Support XML and PDF Images to open in non-Internet Explorer (IE) browsers. Associated Patches: ------------------- This patch must be installed after MAG*3.0*316 Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- IMAGING USER PREFERENCE APP ALT XML VIEWER(#80) New (2006.18) NOTE: This file holds the selection for the alternative XML viewer. The file indicates whether the user is using an alternate XML viewer or not. 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: ----------------------- N/A 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. INC17543733 - MAG*3.0*256 Clinical Display message history log file showing unencrypted PW Problem: -------- Clinical Display users with the MAG System key and associated System Manager options see the Unencrypted PW for the image share, when looking in the message history log. (This does NOT happen when utilizing the 225 Clinical Display.) Expect that all PWs would be encrypted in the message history log. At this point, it is believed this is a Maintenance Priority of 5 - Logging Software Error, Functionality needed. Resolution: ----------- The VI Display code was changed such that it is now compiled in RELEASE mode and not DEBUG mode. Previously the unencrypted Image Share password was visible within the message history log. The value "Password:" will now be used. 2. INC15372987 - MAG.INI Workstation timeout setting does not appear to be working correctly for Vista Imaging Display Problem: -------- The workstation timeout setting does not appear to be working correctly for the VistA Imaging Display. When any setting other than 0 is entered into the mag.ini - Workstation Time-Out minutes - entry VistA Imaging Display goes into a timeout state on start up. Resolution: ----------- When making the INI value something other than "0", move the set workstation countdown routine so that it kicks off after the user logs in. This is because there is no reason to be running the counter function until after a user has successfully connected to VistA. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. Adaptive Maintenance - Display - Adobe Acrobat Reader DC v20.012.20048 upgrade Description: ------------ Adobe Acrobat Reader DC v20.012.20048 upgrade. Resolution: ----------- After installing the application, verify the version Adobe Acrobat Reader DC v20.012.20048. 2. Adaptive Maintenance - Clinical Display support for P290 Delphi 10.4 & Accusoft 18 Description: ------------ - Install and configure Clinical Display application on workstations. - Validate the Accusoft 18 and Delphi 10.4 components are installed on the workstation. - Regression test the application to make sure all the components are working as expected. Resolution: ----------- Accusoft was upgraded to version 18 and RAD Studio was upgraded to version 10.4. Changes were made to the build script to have the new executables. After installing the application, check the files on the workstation to verify the version numbers for Delphi 10.4/Accusoft V18 upgrades have taken place. 3. Adaptive Maintenance - Support XML and PDF Images to open in non-Internet Explorer (IE)browsers. Description: ------------ Clinical Display currently opens the PDF and XML images in IE browser. As IE support is going away, the desired solution needs to open PDF in Acrobat Reader and Edge, XML files using the inbuilt viewer. Also help link in menu item to open in non-IE browser. Resolution: ----------- To resolve this, the code was changed so that the VI Display help manual will be launched under the browser that is associated with the default file type. Also, changed code such that when previewing an XML file in the browser for the Display process, the XML file will be opened with the inbuilt XML Viewer. Test Sites: ----------- Boise VA Medical Center (Boise, ID) Cheyenne VA Medical Center (Cheyenne, WY) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the installation guide at VistA Imaging Installation Guide (domain.ext) The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P290.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_0P290.KID Distribution System (KIDS) build for MAG*3.0*290 VistA Imaging Clinical Display MAG3_0P290_CLINICAL_DISPLAY_INSTALL.MSI Client installation file VistA Imaging Clinical Display MAG3_0P290_CLINICAL_DISPLAY_SETUP.EXE Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*290 MAG3_0P290_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P290_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*290 is released, the list of supported versions of Clinical Display will change: Client Versions Supported: 3.0.290 3.0.316 3.0.258 Client Versions No Longer Supported: 3.0.256 3.0.264 3.0.226 Pre/Post Installation Overview: -------------------------------- MAG*3.0*290 must be installed on the VistA System. This patch must be installed by the compliance date. 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 MAG*3.0*290. 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_0P290.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*290). B. Select the Backup a Transport Global option to create a backup message of any routines and the build for this patch. It will not backup any other changes such as Data Dictionaries (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. If prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii. If prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?,' answer NO. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*290 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 290 ;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 290 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*290 Checking Install for Package MAG*3.0*290 Install Questions for MAG*3.0*290 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*290: 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^MAGIP290. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*290 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- For installing or updating Clinical display, refer to the VistA Imaging Installation Guide (domain.ext). Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ----------------------------- For uninstalling Clinical Display, refer to the VistA Imaging Installation Guide (domain.ext). KIDS Uninstall: --------------- If it is necessary to uninstall the MAG*3.0*290 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*290 install on And/or Backup of MAG*3.0*290 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: 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 Before Checksum After Patch List ------- --------------- -------------- ---------- MAGGTU4D 4960663 4965155 **93,94,106,117,122, 131,149,138,156,161, 167,181,191,188, 216, 234,225,256,258,316,290** MAGIP290 New 4088731 **290** Routine MAGIP290 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : DEC 15, 2020 Completed By: Date Completed: JUN 29, 2022 Released By : Date Released : JUN 30, 2022 ============================================================================= Packman Mail Message: ===================== No routines included