============================================================================= Run Date: DEC 22, 2022 Designation: MAG*3*315 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #235 Status: Released Compliance Date: JAN 23, 2023 ============================================================================= Associated patches: (v)MAG*3*290 <<= must be installed BEFORE `MAG*3*315' Subject: MAG VistA Imaging Display Category: - Routine Description: ============ MAG*3*315 provides fixes to VistA Imaging Clinical Display. This patch addresses the following issues: Adaptive Maintenance: --------------------- 1. Adaptive Maintenance: Added the RPC (Broker) version number to the About Box within the Help menu. Defects: -------- 1. INC15555081 - The default printer format for the VistA Imaging Viewer is portrait. It can be changed manually but this requires an additional step. Note: This patch is duplicated by: INC19599307- EKG Printing. 2. INC19178408 - The symbolic link/application data link junction is missing on sporadic workstations and needs corrected. 3. INC23598375 - When switching patients in CPRS, VISTA Imaging does not change to the new patient. 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 Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- Adaptive Maintenance: Added the RPC (Broker) version number to the About Box within the Help menu. Description: ------------ We are deploying the new RPC broker, version 1.1.73, in this version of VI display and the user can now display which version of the RPC broker is being used in the About box within the Help menu. Resolution: ----------- Patch MAG*3.0*315 broker 1.1.73 is implemented along with a change to the VI Display application About Box so it displays the RPC Broker version. Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1. INC15555081 - The default printer format for the VistA Imaging Viewer is portrait. It can be changed manually but this requires an additional step. Note: This patch is duplicated by: INC19599307- EKG Printing. Problem: -------- The default printer format for the VistA Imaging (VI) Viewer is portrait. It can be changed manually but this requires an additional step. This should be changed to landscape. Resolution: ----------- Updated the default orientation of all EKG prints to "Landscape". This saves nearly 10 steps that it takes for user to manually change printer orientation for each print. 2. INC19178408 - 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. Problem: -------- After installing patch 258, sites lost the registry entry for VistA and were missing the symbolic link/application data link junction on sporadic workstations. Random workstations are losing mag.ini information, so staff cannot log into VistA. Resolution: ----------- It was 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 to which they can write for the magi.ini file. Note: This fix was tested by changing one of the user preferences such as "workstation timeout minutes" and then exit the application. When the user comes back into VI Display, 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 the C:\Users\All Users\Application Data\vista\imaging on sporadic workstations. 3. INC23598375 - When switching between patients in CPRS, VISTA IMAGING loses patient synchronization with CPRS. Problem: -------- When switching between patients in CPRS, VISTA IMAGING loses patient synchronization with CPRS. This issue was introduced in Patch MAG*3.0*290. Resolution: ----------- In testing, it was found that the ticket was "lagging" behind in the Vista Imaging Display application, and that VI Display is one patient behind CPRS. Research was done on both the 1.1.65 RPC broker and the RPC 1.1.73 broker (since P316 and P290 use different RPC brokers), and then testing was done on both versions of VI Display as well as on the two most recent versions of CPRS until the problem was identified. The resolution involved upgrading the RPC broker to version 1.1.73 in the VI Clinical Display application. After the upgrade the patient lookup was tested and the application is working as expected. Test Sites: ------------ Edward Hines, Jr. VA Hospital (Hines, IL) Lyons VAMC (Lyons, NJ) 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_0P315.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_0P315.KID Distribution System (KIDS) build for MAG*3.0*315 VistA Imaging Display client MAG3_0P315_CLINCAL_DISPLAY_SETUP.EXE installation file VistA Imaging Display MSI file MAG3_0P315_CLINICAL_DISPLAY_INSTALL.MSI 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/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE Documentation Title File Name ------------------------------------------------------------------------ Patch Description for MAG*3.0*315 MAG3_0P315_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P315_DIBORG.PDF and Rollback Guide Patch Readme File MAG3_0P315_README.TXT Patch Installation: ------------------- Supported Client Versions: -------------------------- When MAG*3.0*315 is released, the list of supported versions of Clinical Display will change: Client Versions Supported: -------------------------- 3.0.315 3.0.290 (Rollback to this patch is not recommended due to the defects outlined above) 3.0.316 Client Versions No Longer Supported: ------------------------------------ 3.0.258 3.0.256 3.0.225 Pre/Post Installation Overview: ------------------------------- MAG*3.0*315 must be installed on the VistA System on which the VistA Imaging 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 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. 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_0P315.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.). 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*315 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. vii. Repeat step ii for each build in the host file. 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*315 12/19/19@10:14:39 => VistA Imaging 3.0 - Patch 315 ;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 315 ;Created on Dec 09, 2019@20:45:05 It consisted of the following Install(s): MAG*3.0*315 Checking Install for Package MAG*3.0*315 Install Questions for MAG*3.0*315 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*315 : Dec 19, 2019@10:14:53 Build Distribution Date: Dec 09, 2019 Installing Routines:... Dec 19, 2019@10:14:53 Running Post-Install Routine: POS^MAGIP315. Post Install Mail Message: Dec 19, 2019@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*315 Installed. Dec 19, 2019@10:14:53 Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Please refer to the Deployment, Implementation, Back-Out and Rollback Guide (MAG3_0P315_DIBORG.PDF) for Client Installation instructions. Uninstalling the Application: ----------------------------- If it is necessary to uninstall the MAG*3.0*315 client, use the Uninstall option from Programs and Features within Windows Control Panel to Uninstall: VistA Imaging Clinical Display. It is recommended to install Clinical Display version MAG*3.0*316 instead of MAG*3.0*290 (the actual previous version), as MAG*3.0*290 had CPRS synchronization issues. KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*315 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*315 backup message as shown below: * Backup of MAG*3.0*315 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*315 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*315 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. Type to continue or '^' to exit: ^ 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*315b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*315b Example, Installing Patch Backup (Build) ----------------------------------------------- Select OPTION NAME: XPD MAIN Kernel Installation & Distribution System Select Kernel Installation & Distribution System Option: INstallation Select Installation Option: INstall Package(s) Select INSTALL NAME: MAG*3.0*315b This Distribution was loaded on Sep 07, 2022@11:54:20 with header of Backup of MAG*3.0*315 on Sep 06, 2022 It consisted of the following Install(s): MAG*3.0*315b Checking Install for Package MAG*3.0*315b Install Questions for MAG*3.0*315b Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// 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// Linux Telnet /SSh MAG*3.0*315b -------------------------------------------------------------------------- Build Distribution Date: Sep 06, 2022 Installing Routines: Sep 07, 2022@11:54:36 Installing PACKAGE COMPONENTS: Installing OPTION Sep 07, 2022@11:54:36 Updating Routine file... Updating KIDS files... MAG*3.0*315b Installed. Sep 07, 2022@11:54:36 NO Install Message sent -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Note: Routine MAGIP315 is an installation routine that is automatically deleted after the KIDS installation. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 12 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGGTU4D Before: B4965155 After: B5094003 **93,94,106,117,122,131,149, 138,156,161,167,181,191,188, 216,234,225,256,258,316,290, 315** Routine Name: MAGIP315 Before: n/a After: B4088719 **315** Routine list of preceding patches: 290 ============================================================================= User Information: Entered By : JR Date Entered : AUG 24, 2021 Completed By: Date Completed: DEC 20, 2022 Released By : Date Released : DEC 22, 2022 ============================================================================= Packman Mail Message: ===================== No routines included