============================================================================= Run Date: MAY 05, 2021 Designation: MAG*3*255 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #202 Status: Released Compliance Date: JUN 07, 2021 ============================================================================= Associated patches: (v)MAG*3*199 <<= must be installed BEFORE `MAG*3*255' Subject: VISTARAD Help Files Defect Category: - Routine Description: ============ VistA Patch Display Page: 1 ============================================================================= Run Date: APR 30, 2021 Designation: MAG*3*255 Package : IMAGING Priority : MANDATORY Version : 3 Status : COMPLETE/NOT RELEASED ============================================================================= Subject: VISTARAD Help Files Defect Category: ROUTINE Description: =========== This document describes MAG*3.0*255, a patch that addresses the following VistARad issues: INC8473143 - Link to VistARad help files link is not consistent in user guides posted in the VDL and on SharePoint. INC7921331 - VistARad - Brokerserver location/site issue after installation INC9433506 - OS Version for file 2006.81 and 2006.82 is not showing Windows 10 as entry 10.0 on the report. 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. Defect 1175183 (Trouble Ticket INC8473143) Link to VistARad help files link is not consistent in user guides posted in the VDL and on SharePoint. Problem: -------- The link provided to access VistARad help files is not consistent in the VistARad User Manuals and Quick Start Guides in the VDL and on SharePoint. The VistARad User Manual and Quick Start guide in the VDL directs the user to MAG*3.0*199. The VistARad User Manual and Quick Start guide on SharePoint directs the user to MAG*3.0*184. Resolution: ----------- Updated the VistARad User Manual to remove patch-specific information. 2. Defect 1196996 (Trouble Ticket INC7921331) VistARad Brokerserver location/site issue after installation Problem: -------- When users at the Alexandria, VA Health Care system install VistARad workstations, they noticed a blank Brokerserver entry is created. This causes the "Connect To" Brokerserver dialog box to display, forcing the user select a Brokerserver site although only one Brokerserver is configured. The user is required to make additional clicks, unnecessarily delaying each login process. Resolution: ----------- When the user gets prompted to enter 5 Hostname/IP Addresses, the installation process makes sure the user enters at least one Hostname/IP Address. This process assures there is no default entry in the Registry. Also corrected the spelling of "Addresses" in the Connection Information Screen during the installation process. 3. Defect 1216846 (Trouble Ticket INC 9433506) OS Version for file 2006.81 and 2006.82 is not showing Windows 10 (10.0) - VistARad Problem: -------- When the user runs the report or routine MAGQE1 on VistA, it shows the Workstations name, the VistA Imaging application (VistARad), the operating system, and additional details. The issue is Windows 10 shows the entries stored as 6.2 instead of 10.0. Resolution: ----------- Updated the VistARad code to capture system information and send to VistA. Test Sites: ----------- Alexandria VA Health Care System Martinsburg VA Medical Center 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_0P255.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 Note: The VistARad User Guide is also available in VA's Document Library (VDL). This document can be obtained by accessing https://www.domain.ext/vdl/. File Title File Name --------------------------------------------------------------------- Kernel Installation and MAG3_0P255.KID Distribution System (KIDS) build for MAG*3.0*255 VistARad installation file - New MAG3_0P255_VRAD_setup.exe Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*255 MAG3_0P255_Patch_Description.pdf Deployment, Installation, Back-Out, MAG3_0P255_DIBORG.pdf and Rollback Guide VistARad User Guide MAG_VISTARAD_UG.PDF Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*255 is released, the list of supported versions of VistARad will change: Client Versions Supported: * MAG*3.0*255 * MAG*3.0*220 - KIDS only patch * MAG*3.0*199 Client Versions No Longer Supported: * MAG*3.0*184 * MAG*3.0*153 * MAG*3.0*133 Pre/Post Installation Overview: ------------------------------- MAG*3.0*255 must be installed on the VistA System workstation on which the VistA Imaging Applications will be used. This patch must be installed by the compliance date. Pre-Installation Instructions: ------------------------------ 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 previous patch in the Supported Client Versions section has been installed. Note: All released VistA Imaging patches must be installed on the VistA system before installing this patch. KIDS 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_0P255.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*255). 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. KIDS Installation Example: -------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*255 12/19/19@10:14:39 => VistA Imaging 3.0 - Patch 255 ;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 255 ;Created on Dec 09, 2019@20:45:05 It consisted of the following Install(s): MAG*3.0*255 Checking Install for Package MAG*3.0*255 Will first run the Environment Check Routine, MAGJMN1 Wait for Background Compile program to stop; this might take up to a few minutes.. Background Compile Stopped; proceeding with install. Install Questions for MAG*3.0*255 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*255: Dec 19, 2019@10:14:53 Build Distribution Date: Dec 09, 2019 Installing Routines:... Dec 19, 2019@10:14:53 Running Post-Install Routine: POSTINST^MAGJMN1 ... Enabling background compile Background Compile Enabled. Updating Routine file... Updating KIDS files... MAG*3.0*255 Installed. Dec 19, 2019@10:14:53 Client Installation Instructions: --------------------------------- Note: The VistARad application is only supported on the Windows 10 operating system. Other operating systems are not officially supported. VistARad is distributed as a .EXE installation. The MAG3_0P255_VistARad_Setup.exe file can be installed manually on workstations as described in the Single Workstation Installation section of the VistA Imaging System Installation Guide. Post-Installation Instructions: ------------------------------- Verify the checksums of the added/updated routines in the table below. Routine Checksums Routine Checksum Before Checksum After Patch List MAGJMN1 98640707 98640707 **16,9,22,18,65,76,101,90,115, 120,133,152,153,184,199,255** MAGJTU4V 5010066 5011207 **90,115,120,133,152,153, 184,199,255** MAGJUTL5 38137763 38137400 **65,76,101,90,115,104,120,133, 152,153,184,199,255** Back-Out/Roll Back Plan: ------------------------ Client Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*255 client, use the Uninstall option from Programs and Features within Windows Control Panel to uninstall VistARad MAG*3.0*255. Then install the previous version of VistARad which was included in MAG*3.0*199. KIDS Uninstall: --------------- If it is necessary to uninstall the MAG*3.0*255 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*255 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: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. *** Please note that before and after checksums for routine MAGJMN1 are expected to match for Before and After. Routine Name: MAGJMN1 Before: 98640707 After: 98640707 **16,9,22,18,65,76,101,90,115, 120,133,152,153,184,199,255** Routine Name: MAGJTU4V Before: 5010066 After: 5011207 **90,115,120,133,152,153,184, 199,255** Routine Name: MAGJUTL5 Before: 38137763 After: 38137400 **65,76,101,90,115,104,120,133, 152,153,184,199,255** Routine list of preceding patches: 199 Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : Date Entered : JAN 24, 2020 Completed By: JR Date Completed: MAY 03, 2021 Released By : Date Released : MAY 05, 2021 ============================================================================= Packman Mail Message: ===================== No routines included