============================================================================= Run Date: JUN 04, 2021 Designation: MAG*3*283 Package : MAG - IMAGING Priority: EMERGENCY Version : 3 SEQ #204 Status: Released Compliance Date: JUN 15, 2021 ============================================================================= Subject: VistA Imaging Importer Defect Patch Category: - Routine - Enhancement () Description: ============ This document describes, MAG*3.0*283, a KIDS only patch that provides fixes to the VistA Imaging Importer. This patch addresses the following 2 defects: 1. INC13422239 and INC14307041 - DICOM Importer III is not showing staged jobs 2. INC13801691 - In some cases the user's location is not being recorded correctly in the MAGV IMPORT STUDY LOG #2006.9421 Patch Components: Associated Patches: This patch must be installed after MAG*3.0*250. 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 --------------------- --------------- MAGVC WI SUBMIT NEW (shares the same code with Modified with MAGV CREATE WORK ITEM) MAGV IMPORT STUDY LOG STORE Modified 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 IMAG-1088 and IMAG-1096 (INC13422239 and INC14307041) - DICOM Importer III is not showing staged jobs Problem: -------- VistA Imaging DICOM Importer III is not showing staged jobs. Images are scanned from a CD and the progress bar progresses. Once finished, the importer states staging is complete and please remove drive media. User checks the import job list to process exam/images but nothing is there. The location in file #2006.941 MAG WORK ITEM for this site is incorrect. The station number is being stored instead of the IEN of the station from the INSTITUTION file #4, so the import does not display the entries. Resolution: ----------- Modified MAGVC WI SUBMIT NEW (shares the same code with MAGV CREATE WORK ITEM) RPC to only accept Station Numbers and to convert to IEN prior to storage. 2. Defect IMAG-1089 (INC13801691) - In some cases the user's location is not recorded correctly in the MAGV IMPORT STUDY LOG #2006.9421 Problem: -------- In some cases, the user's location is not recorded correctly in the MAGV IMPORT STUDY LOG #2006.9421. The Station Number is being stored instead of the IEN of the station from the INSTITUTION file #4. Resolution: ----------- Modified MAGV IMPORT STUDY LOG STORE RPC to only accept Station Numbers and to convert to IEN prior to storage. Test Sites: ----------- West Palm Beach VA Medical Center VA Montana Health Care System VA Texas Valley Coastal Bend Health Care System 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_0P283.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_0P283.KID Distribution System (KIDS) build for MAG*3.0*283 Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*283 MAG3_0P283_Patch_Description.pdf Deployment, Installation, Back-Out, MAG3_0P283_DIBORG.pdf and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: -------------------------------- MAG*3.0*283 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*283. 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_0P283.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*283). 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install?,' answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols?,' answer NO a. When prompted 'Enter options you wish to mark as 'Out of Order':,' press the Enter key. b. When prompted 'Enter protocols you wish to mark as 'Out of Order':,' press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//,' answer 0. KIDS Installation Example: --------------------------- Select Installation Option: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*283 11/19/20@10:14:39 => VistA Imaging 3.0 - Patch 283 ;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 283 ;Created on Nov 09, 2020@20:45:05 It consisted of the following Install(s): MAG*3.0*283 Checking Install for Package MAG*3.0*283 Install Questions for MAG*3.0*283 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*283 : 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^MAGIP283. Post Install Mail Message: Nov 19, 2020@10:14:53 Updating Routine file...... Updating KIDS files....... MAG*3.0*283 Installed. Nov 19, 2020@10:14:53 VistA Client Installation Instructions ---------------------------------------- N/A - Application client installation is not required in a KIDS-only build. Post-Installation Instructions: -------------------------------- N/A - Application client installation is not required in a KIDS-only build. Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ------------------------------ N/A - Application client installation is not required in a KIDS-only build. KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*283 VistA KIDS, 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*283 install on And/Or * Backup of MAG*3.0*283 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 MAGVCWIA 117974804 119665638 **138,162,283** MAGVIM01 205136809 204260385 **118,138,221,250,283** MAGVIM03 41664423 43977410 **118,283** MAGIP283 New 4110428 **283** Routine MAGIP283 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 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGIP283 Before: n/a After: B4110428 **283** Routine Name: MAGVCWIA Before:B117974804 After:B119665638 **138,162,283** Routine Name: MAGVIM01 Before:B205136809 After:B204260385 **118,138,221,250,283** Routine Name: MAGVIM03 Before: B41664423 After: B43977410 **118,283** Routine list of preceding patches: 162, 250 ============================================================================= User Information: Entered By : Date Entered : OCT 14, 2020 Completed By: Date Completed: JUN 03, 2021 Released By : Date Released : JUN 04, 2021 ============================================================================= Packman Mail Message: ===================== No routines included