============================================================================= Run Date: JUN 10, 2022 Designation: MAG*3*321 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #224 Status: Released Compliance Date: JUN 15, 2022 ============================================================================= Subject: VISTA IMAGING CAPTURE DEFECT PATCH Category: - Routine Description: ============ This document describes MAG*3.0*321, a patch that provides fixes to VistA Imaging Clinical Capture. This patch addresses the following issues: Defect: ------- 1. INC19138802 - The symbolic link/application data link junction is missing on SOME workstations. C:\ProgramData\Application Data\vista\imaging is being affected on SOME workstations. It needs to be corrected. There is a duplicate ticket related to the same issue: INC19178408(also included in Clinical Display Patch MAG*3.0*315). Adaptive Maintenance: --------------------- 1. The help link should open through non-Internet Explorer (IE) Browsers. Clinical Capture should also support XML files when opened through Notepad. Associated Patches: ------------------- This patch must be installed after patch MAG*3.0*267 is installed. 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. INC19138802 - The symbolic link/application data link junction is missing on SOME workstations. C:\ProgramData\Application Data\vista\imaging is being affected on SOME workstations. It needs to be corrected. There is a duplicate ticket related to the same issue: INC19178408 (also included in Clinical Display Patch MAG*3.0*315). Problem: -------- Users without admin rights do not see the symbolic link or the appropriate MAG.INI file at the following path: C:\ProgramData\Application Data\vista\imaging Users who have admin rights can see the MAG.INI file, however it is not consistent on all workstations. Regardless of admin rights, the location of the MAG.INI file needs to be consistent across all workstations. Resolution: ----------- After consulting with CLIN3 and desktop support, VistA Imaging decided to move the location for MAG.INI (user preferences) from the "ALLUSERSPROFILE" location to the "PROGRAMDATA" location. The difference between these two is that the first one requires privileged access, whereas the "PROGRAMDATA" does not. As a result, each user will get a location for the MAG.INI file that they can write to. Note: When the user comes back into VI Capture, the value will be remembered and the MAG.INI will be found at the new location C:\ProgramData\Application Data\vista\imaging instead of under C:\Users\All Users\Application Data\vista\imaging on the workstations. Adaptive Maintenance Tracking System Ticket(s) & Overview: ----------------------------------------------------------- 1. The help link should open through non-IE Browsers. Clinical Capture should also support XML files when opened through Notepad. Description: ------------ This Clinical Capture application patch addresses opening the help link under menu options in a non-IE browser (i.e., Google Chrome or Microsoft Edge). Also, when uploading an XML file, the contents can be validated through the Notepad application. Resolution: ----------- For VI Capture, the code was changed so that the Clinical Capture User Manual will now launch via Google Chrome or Microsoft Edge. Test Sites: ----------- Phoenix Health Care System (Phoenix, AZ) Battle Creek Health Care System (Battle Creek, MI) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch can be installed by following the VistA Imaging System Installation Guide: The host file is available at the following location: /srv/vista/patches/SOFTWARE/MAG3_0P321.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_0P321.KID Distribution System (KIDS) Build for MAG*3.0*321 VistA Imaging Clinical Capture MAG3_0P321_ CLINICAL_CAPTURE_INSTALL.MSI Push Installation File Vista Imaging Clinical Capture MAG3_0P321_ CLINICAL_CAPTURE_INSTALL.EXE Workstation Installation File Documentation Title File Name -------------------------------------------------------------------- Patch Description for MAG*3.0*321 MAG3_0P321_PATCH_DESCRIPTION_PDF Deployment, Installation, Back-Out, MAG3_0P321_DIBORG.PDF and Rollback Guide Readme File for MAG*3.0*321 MAG3_0P321_README.PDF Patch Installation: ------------------- Supported Client Versions: When MAG*3.0*321 is released, the list of supported versions of Clinical Capture will change: Client Versions Supported: 3.0.321 3.0.267 3.0.264 Client Versions No Longer Supported: 3.0.226 3.0.233 3.0.223 Pre/Post Installation Overview: ------------------------------- MAG*3.0*321 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*321. 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_0P321.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*321). 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*321 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 321 ;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 321 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*321 Checking Install for Package MAG*3.0*321 Install Questions for MAG*3.0*321 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*321 : 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^MAGIP321. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*321 Installed. Nov 19, 2020@10:14:53 Client Installation Instructions -------------------------------- For installing or updating Clinical Capture refer to the VistA Imaging System Installation Guide: See section 2.5.5. Note: The VistA Imaging Capture Application is only supported on Windows 10 operating systems. Other operating systems are not officially supported. VistA Imaging Capture is 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 MAG3_0P321_Clinical_ Capture_Setup.exe file can be installed manually on workstations as described in the Single Workstations Installation section in the VistA Imaging System Installation Guide. Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*321 client, use the Uninstall option from Programs and Features within Windows Control Panel to uninstall VistA Imaging Clinical Capture. Then install the previous version of Clinical Capture which was included in MAG*3.0*267. Refer to the MAG3_0P321_README.PDF file for additional back-out considerations. KIDS Uninstall: -------------- If it is necessary to uninstall the MAG*3.0*321 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*321 install on And/Or Backup of MAG*3.0*321 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 ------- --------------- -------------- ---------- MAGIP321 New 4088691 **321** MAGGTU4C 4973788 4977181 **93,94,106,117,122, 129 140,151,178,189, 211,215,223,233,226, 264,267,321** Routine MAGIP321 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== No routines included. ============================================================================= User Information: Entered By : JR Date Entered : OCT 25, 2021 Completed By: Date Completed: JUN 09, 2022 Released By : Date Released : JUN 10, 2022 ============================================================================= Packman Mail Message: ===================== No routines included