============================================================================= Run Date: OCT 09, 2024 Designation: MAG*3*334 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #257 Status: Released Compliance Date: NOV 12, 2024 ============================================================================= Associated patches: (v)MAG*3*138 <<= must be installed BEFORE `MAG*3*334' (v)MAG*3*351 <<= must be installed BEFORE `MAG*3*334' Subject: DEFECT PATCH - DISPLAY Category: - Routine Description: ============ This document describes MAG*3.0*334, a patch that provides fixes to VistA Imaging Clinical Display. This patch addresses displaying and printing issues with XML Forms Architecture (XFA) PDFs, ROI Print, QA Print, and print orientation. It also addresses the video capture error when loading AVI file with codec H264, a new message when alternate video binaries not available, moving alternate video workstation settings menu item and setting the timeout windows. Due to the volume of tickets this patch corrects, duplicates for each are listed in the associated Defect and Adaptive Maintenance Tracking sections. Defects: -------- 1. VISTAIS-171/INC19268863 - In VistA Imaging Clinical Display, a defect was identified during the troubleshooting of INC15372987 due to a Windows timeout, which resulted in the failure to prompt a timeout dialog window. Location Reporting Incident: Samuel S. Stratton Veteran Affairs Medical Center, New York (Albany). 2. VISTAIS-172/INC22010358 - In VistA Imaging Clinical Display, when attempting to open a video player, the video fails to open. Location Reporting Incident: Durham Veteran Affairs Medical Center, North Carolina. 3. VISTAIS-173/INC26318295 - VistA Imaging Clinical Display is experiencing issues with ROI Printing/ Display. Location Reporting Incident: George H. O'Brien, Jr Veteran Affairs Medical Center, Texas (Big Spring). 4. VISTAIS-174/INC26067115 - VistA Imaging Clinical Display is experiencing issues with displaying and printing PDF files. Location Reporting Incident: Tomah Veteran Affairs Medical Center, Wisconsin. 5. VISTAIS-175/INC26384023 - VistA Imaging Clinical Display Imported Community Care images cannot be viewed through the QA Review utility. Location Reporting Incident: Salem Veteran Affairs Medical Center, Virginia. 6. VISTAIS-176/INC21023088 - In VistA Imaging Clinical Display, errors are triggered when opening video using both the imaging player and alternate player. Location Reporting Incident: Syracuse VA Medical Center, New York. 7. VISTAIS-54/INC30764778 - In VistA Imaging Clinical Display, the print orientation defaults to landscape mode on the Image List when the user switches from Muse/EKG (electrocardiogram). Location Reporting Incident: Fort Harrison Veterans Affairs Medical Center, Montana 8. VISTAIS-51 - In VistA Imaging Clinical Display, when the user selects the Alternate Video Viewer, the system throws an error stating "The system cannot find the file specified." 9. VISTAIS-55 - In VistA Imaging Clinical Display, there is an issue with print fuzziness for both regular and XFA PDFs. 10.VISTAIS-56 - In VistA Imaging Clinical Display on the QA Review Window when opening video message is updated (Yellow Banner). 11.VISTAIS-59 - The user cannot set the Alternate Video Viewer path without elevated privileges. 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: ----------------------- 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. VISTAIS-171/INC19268863 - In VistA Imaging Clinical Display, a defect was identified during the troubleshooting of INC15372987 due to a Windows timeout, which resulted in the failure to prompt a timeout dialog window. Location Reporting Incident: Samuel S. Stratton Veteran Affairs Medical Center, New York (Albany). Problem: -------- The Display Window timeout value is BLANK (zero), and the MAG.ini value is also blank. The VistA Imaging Clinical Display Windows Timeout value should be set via MAGGTU6 Routine. Partial solution was implemented in MAG*3.0*315 to address the Timeout issue to the GUI. Complete solution with MUMPS changes is added to this patch to address the Timeout issue. Resolution: ----------- VistA Routine MAGGTU6 was modified, if the value in the TIMEOUT WINDOWS DISPLAY field (#121) of the IMAGING SITE PARAMETERS File #2006.1 is blank and the MAG.ini value is also blank, it will return the default value of 6 minutes. 2. VISTAIS-172/INC22010358 - In VistA Imaging Clinical Display, when attempting to open a video player, the video fails to open. Location Reporting Incident: Durham Veteran Affairs Medical Center, North Carolina. Problem: -------- When attempting to open a video within VistA Imaging Clinical Display, the video does not open. Issue encountered when attempting to open the video with both the Imaging video player and alternate video player causes a disconnect between VistA Imaging Clinical Display and Windows Media Player. Resolution: ----------- The codec H264 has been updated to ensure that videos can now be opened using both the Imaging video player and the alternate video player installed on the workstation. 3. VISTAIS-173/INC26318295 - VistA Imaging Clinical Display is experiencing issues with ROI Printing/ Display. Location Reporting Incident: George H. O'Brien, Jr Veteran Affairs Medical Center, Texas (Big Spring). Problem: -------- An issue arises with displaying and printing ROI Group images in all PDFs. Initially, the study is viewable and printable, but upon reaching the second page, the display turns blank (all white). Although printing is possible, subsequent pages also turn blank, with printing success being inconsistent. Additionally, there are instances where the regular PDF display fails to open. The application experiences significant slowness when saving a group of documents to PDF. Moreover, the print orientation functionality is unreliable, requiring users to double-check before printing to ensure that it saves in portrait orientation; otherwise, it automatically saves in landscape orientation and appears shrunk. Resolution: ----------- AccuSoft V18.2 provides a solution by updating the control code with the 'Rasterize' method, which converts the page control's printer canvas into a bitmap. 4. VISTAIS-174/INC26067115 - VistA Imaging Clinical Display is experiencing issues with displaying and printing PDF files. Location Reporting Incident: Tomah Veteran Affairs Medical Center, Wisconsin. Problem: -------- When printing scanned PDF documents using VistA Imaging Clinical Display from outside facilities like reports, users have noticed unexpected issues. Despite PDF pages being printed with the margins visible all other information like title headers, patient information, page headings and text are missing. This problem seems to occur randomly, with some documents printing correctly while others exhibit this issue. Certain print jobs contain a mix of pages with and without text, adding to the complexity of the issue. Resolution: ----------- AccuSoft V18.2 provides a solution by updating the control code with the 'Rasterize' method, which converts the page control's printer canvas into a bitmap. 5. VISTAIS-175/INC26384023 - VistA Imaging Clinical Display Imported Community Care images cannot be viewed through the QA Review utility. Location Reporting Incident: Salem Veteran Affairs Medical Center, Virginia. Problem: -------- Imported community care records are not viewable through the VistA Imaging Clinical Display QA Review utility. Instead of displaying the image(s) for QA, only a blank page appears. Nothing is viewable, and this issue seems to occur specifically with imported PDF images from community care. Resolution: ----------- AccuSoft V18.2 provides a solution by updating the control code with 'Rasterize' method, which converts the page control's printer canvas into a bitmap. 6. VISTAIS-176/INC21023088 - In VistA Imaging Clinical Display, errors are triggered when opening video using both the imaging player and alternate player. Location Reporting Incident: Syracuse VA Medical Center, New York. Problem: -------- The Vista Imaging Clinical Display Video Player does not support the H264 codec required for display. When attempting to open this file within the VistA Imaging Clinical Display client, the user encounters an error. Even when selecting the alternate video player, the VistA Imaging Clinical Display throws the following error; GetLastError: 2 Result: 2 SysMessage: The system cannot find the file specified. Resolution: ----------- Created a new form and added a new ActiveX Media Player Component (TWindowsMediaPlayer) to VistA Imaging Clinical Display client code. Modified the source code in the procedure 'OpenVideoImage' to play the video files. 7.VISTAIS-54/INC30764778 - In VistA Imaging Clinical Display, the print orientation defaults to landscape mode on the Image List when the user switches from Muse/EKG (electrocardiogram). Problem: -------- Print orientation defaults to landscape mode on Image List when user changes from Muse/EKG. Resolution: ----------- Adjusted the code to set the default print orientation to 'portrait' for non-MUSE/EKG. Set the default print orientation to 'landscape' for MUSE/EKG. 8. VISTAIS-51 - In VistA Imaging Clinical Display, when the user selects the Alternate Video Viewer, the system throws an error stating "The system cannot find the file specified." Problem: -------- If the path/filename of the alternate video viewer was not valid, the following error message was displayed: 'GetLastError: 2 Result: 2 SysMessage: The system cannot find the file specified,' which is not user friendly. Resolution: ----------- The message displayed on the popup window was modified to read: 'Media Player not found. Please use the "Options Menu" listed on the main "VistA Imaging Display" window. 9. VISTAIS-55 - In VistA Imaging Clinical Display, there is an issue with print fuzziness for both regular and XFA PDFs. Problem: -------- PDF images for both PDFs and XFA PDFs appear fuzzy (unclear) after saving to file. Resolution: ----------- AccuSoft ImageGear 18.2 internal resolution for PDF documents has been changed to 300 DPI. This will be the new default for all regular and XFA PDF documents. 10.VISTAIS-56 - In Vista Imaging Clinical Display on the QA Review Window when opening video message is updated (Yellow Banner). Problem: -------- The Message in QA Review window is not user friendly. Resolution: ----------- Updated message for video to: 'Preview not available. Video will open in a new window. Close the video player manually.' 11. VISTAIS-59 - The user cannot set the Alternate Video Viewer path without elevated privileges. Problem: -------- An option was created for the users to edit the location for the alternate video player. Resolution: ----------- Moved the menu option "Set the alternate video viewer location" from "System Manager menu" to "Options menu" under VistA Imaging Clinical Display main window. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number Test Sites: ----------- Durham VA Medical Center, NC Alexandria VA Medical Center, LA Fort Harrison VA Medical Center, MT Test Sites - SNOW Change Order #: --------------------------------- Durham VA Medical Center, NC - CHG0520780 Alexandria VA Medical Center, LA - CHG0519601 Fort Harrison VA Medical Center, MT - CHG0519490 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_0P334.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 Format -------------------------------------------------------------------------- Kernel Installation and MAG3_0P334.KID ASCII Distribution System (KIDS) Build for MAG*3.0*334 VistA Imaging Clinical Display MAG3_0P334_CLINICAL_DISPLAY_INSTALL.MSI Binary Client installation file VistA MAG3_0P334_CLINICAL_DISPLAY_SETUP.EXE Imaging Clinical Display Binary 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/application.asp?appid=105 Documentation Title File Name -------------------------------------------------------------------------- Patch Description for MAG*3.0*334 MAG3_0P334_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P334_DIBORG.PDF and Rollback Guide VistA Imaging Clinical MAG_DISPLAY_USER_MANUAL.PDF Display Workstation User Manual README MAG3_0P334_README.PDF Patch Installation: ------------------- Pre/Post Installation Overview: Supported Client Versions: When MAG*3.0*334 is released, the list of supported versions of VistA Imaging Clinical Display will change: Client Versions Supported: 3.0.334 3.0.351 3.0.315 3.0.316 Client Versions No Longer Supported: 3.0.258 3.0.256 Pre-Installation Instructions: MAG*3.0*334 must be installed on the VistA System on which the VistA Imaging Clinical Display Application will be used. 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. All released VistA Imaging Clinical Display patches must be installed on the VistA system before installing MAG*3.0*334. Routine MAGIP334 is an installation routine that is automatically deleted after the KIDS installation. 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_0P334.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*334). 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*334). 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. 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. v. 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// Linux Telnet /SSh MAG*3.0*334 -------------------------------------------------------------------------- Install Started for MAG*3.0*334 : Jun 10, 2024@13:06:23 Build Distribution Date: Jun 10, 2024 Installing Routines: Jun 10, 2024@13:06:23 Running Post-Install Routine: POS^MAGIP334 Post Install Mail Message: Jun 10, 2024@13:06:23 Updating Routine file... Updating KIDS files... MAG*3.0*334 Installed. Jun 10, 2024@13:06:23 -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Client Installation Instructions For installing or updating VistA Imaging Clinical Display, refer to the VistA Imaging Clinical Display Installation Guide (VA Software Document Library) Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ For information about back-out steps, see document: MAG3_0P334_DIBORG.PDF. Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*334 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging Clinical Display. Then install the previous version of Clinical Display which was included in MAG*3.0*351 or if site needs to print XFA PDFs use version of Clinical Display MAG*3.0*316 or refer to the VistA Imaging Clinical Display Installation Guide (VA Software Document Library) KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*334 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 Steps section, step 2b). 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*334 backup message as shown below: * Backup of MAG*3.0*334 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*334 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*334 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. 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*334b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*334b Example, Installing Patch Backup (Build) ----------------------------------------------- Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Select Kernel Installation & Distribution System Option: Installation Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*334 The input value contains control characters. Select INSTALL NAME: MAG*3.0*334 8/15/24@10:52:35 => MAG*3.0*334 TEST v5 ;Created on Aug 08, 2024@16:59:10 This Distribution was loaded on Aug 15, 2024@10:52:35 with header of MAG*3.0*334 TEST v5 ;Created on Aug 08, 2024@16:59:10 It consisted of the following Install(s): MAG*3.0*334 Checking Install for Package MAG*3.0*334 Install Questions for MAG*3.0*334 Want KIDS to INHIBIT LOGONs during the install? NO// YES 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*334 ------------------------------------------------------------------------- - Installing Routines: Aug 15, 2024@10:54:16 Running Post-Install Routine: POS^MAGIP334 Post Install Mail Message: Aug 15, 2024@10:54:16 Updating Routine file... Updating KIDS files... MAG*3.0*334 Installed. Aug 15, 2024@10:54:16 ------------------------------------------------------------------------- - +------------------------------------------------------------+ 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 51 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4D Before: B4930855 After: B5132306 **93,94,106,117,122,131,149, 138,156,161,167,181,191,188, 216,234,225,256,258,316,290, 315,351,334** Routine Name: MAGGTU6 Before: B52891889 After: B53671836 **24,8,48,45,20,46,59,72,93, 117,138,334** Routine Name: MAGIP334 Before: n/a After: B4062766 **334** Routine list of preceding patches: 351 ============================================================================= User Information: Entered By : Date Entered : JUN 15, 2022 Completed By: Date Completed: OCT 09, 2024 Released By : Date Released : OCT 09, 2024 ============================================================================= Packman Mail Message: ===================== No routines included