============================================================================= Run Date: JUN 19, 2020 Designation: MAG*3*242 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #189 Status: Released Compliance Date: JUL 20, 2020 ============================================================================= Subject: TeleReader Delphi Upgrade Category: - Routine Description: ============ Description: This document describes MAG*3.0*242, a patch that provides fixes to the VistA Imaging TeleReader and TeleReader Configurator. This patch addresses the following issues: 1. VistA Imaging environment upgrade Delphi XE8 to Delphi 10.2.3 Tokyo. 2. VistA Imaging TeleReader workstations are not on the 'Imaging Clients Version Report' [MAG CLIENT VERSION REPORT] 3. VistA Imaging TeleReader and TeleReader Configurator Manual Mismatch Associated Patches: VistA Imaging MAG*3.0*242 must be installed after MAG*3.0*219. 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 Defect Tracking System Ticket(s) & Overview: 1. Story 789535 & 789545 VistA Imaging environment upgrade Delphi XE8 to Delphi 10.2.3 Tokyo Problem: -------- This task upgrades the environments for VistA Imaging TeleReader and TeleReader Configurator from Delphi XE8 to Delphi 10.2.3 Tokyo. Resolution: ----------- The version of Delphi used to build VistA Imaging TeleReader and TeleReader Configurator has been upgraded to Delphi 10.2.3 Tokyo. 2. Story 990639 VistA Imaging TeleReader workstations are not on the 'Imaging Clients Version Report' [MAG CLIENT VERSION REPORT] Problem: -------- When a user logs into VistA Imaging TeleReader the information is not being logged in the VistA file #2006.81 like Clinical Display and Clinical Capture. Therefore, the workstation information for the VistA Imaging TeleReader is not on the 'Imaging Clients Version Report' [MAG CLIENT VERSION REPORT] Resolution: ----------- Modified the VistA Imaging TeleReader to add information to file #2006.81 when a user logs into the VistA Imaging TeleReader application. 3. Defect 1175206 (Trouble Ticket # INC8470731) VistA Imaging TeleReader and TeleReader Configurator Manual Mismatch Problem: -------- VistA Imaging TeleReader and TeleReader Configurator applications both launch different manuals than what is on the Virtual Document Library (VDL). VistA Imaging TeleReader and TeleReader Configurator User Manual opens a January 2019 version, VDL has February 2019. Resolution: ----------- Updated version of the User Manual distributed with the build so that VistA Imaging TeleReader and TeleReader Configurator open the most current version. Test Sites: ----------- Minneapolis VA Health Care System, Minneapolis, MN 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_0P242.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 MAG3_0P242.KID and Distribution System (KIDS) build for MAG*3.0*242-New VistA Imaging TeleReader MAG3_0P242_TeleReader_Setup.exe client installation file - New VistA Imaging TeleReader MAG3_0P242_TeleReader_Install.msi push installation file - New TeleReader Configurator MAG3_0P242_TeleReaderConfigurator_Setup.exe client installation file - New TeleReader Configurator MAG3_0P242_TeleReaderConfigurator_Install.msi push installation file - New Documentation Title File Name --------------------------------------------------------------------- Patch Description MAG3_0P242_Patch_Description.pdf for MAG*3.0*242 Deployment, Installation, MAG3_0P242_DIBORG.pdf Back-Out, and Rollback Guide Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*242 is released, the list of supported versions of VistA Imaging TeleReader and TeleReader Configurator will change: VistA Imaging TeleReader Client Versions Supported: 3.0.242 3.0.219 3.0.182 Client Versions No Longer Supported: 3.0.127 3.0.122 3.0.106 TeleReader Configurator Client Versions Supported: 3.0.242 3.0.182 Client Versions No Longer Supported: 3.0.127 3.0.122 3.0.106 Pre/Post Installation Overview: MAG*3.0*242 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. 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. Verify that all previous patches have been installed. Note: All released VistA Imaging patches must be installed on the VistA system before installing MAG*3.0*242. 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_0P242.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*242). 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. VistA Imaging TeleReader and TeleReader Configurator Client Installation Instructions Note: The VistA Imaging TeleReader and TeleReader Configurator Application is only supported on Windows 7 and 10 operating systems. Other operating systems are not officially supported. VistA Imaging TeleReader and TeleReader Configurator are distributed as an MSI and EXE installation. The MSI is intended for sites that want to do a push installation (using SCCM or another tool). The EXE is intended for use to install on a single workstation. The TeleReader Configurator portion of this patch is to be installed only on the administrator's workstation. The MAG3_0P242_TeleReaderConfigurator_Setup.exe file can be installed manually on workstations as described in the Single Workstation Installation section of the VistA Imaging System Installation Guide. The VistA Imaging TeleReader portion of this patch is to be installed on the clinical workstations. The MAG3_0P242_TeleReader_Setup.exe file can be installed manually on workstations as described in the Installing TeleReader section of the VistA Imaging System Installation Guide. Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: VistA Imaging TeleReader Uninstall If it is necessary to uninstall the MAG*3.0*242 VistA Imaging TeleReader application, uninstall VistA Imaging TeleReader from the Windows control panel. Reinstall the VistA Imaging TeleReader application from MAG*3.0*219 (to return to the Patch 219 TeleReader application). TeleReader Configurator Uninstall If it is necessary to uninstall the MAG*3.0*242 TeleReader Configurator application, uninstall VistA Imaging TeleReader Configurator from the Windows control panel. Reinstall the TeleReader Configurator application from MAG*3.0*182 (to return to the Patch 182 TeleReader Configurator application). KIDS Uninstall: If it is necessary to uninstall the MAG*3.0*242 VistA KIDS, then select the Kernel Installation & Distribution System menu option, Backup a Transport Global (see Installation Steps section, 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*242 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 #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 Checksum Patch List Before After MAGGTU4T 4911131 4820146 **93,94,106,117,122, 127,182,219,242** MAGIP242 New 4110387 **242** Routine MAGIP242 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : MAY 09, 2019 Completed By: Date Completed: JUN 18, 2020 Released By : Date Released : JUN 19, 2020 ============================================================================= Packman Mail Message: ===================== No routines included