============================================================================= Run Date: OCT 26, 2022 Designation: MAG*3*307 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #230 Status: Released Compliance Date: NOV 28, 2022 ============================================================================= Associated patches: (v)MAG*3*156 <<= must be installed BEFORE `MAG*3*307' (v)MAG*3*231 <<= must be installed BEFORE `MAG*3*307' (v)MAG*3*262 <<= must be installed BEFORE `MAG*3*307' (v)MAG*3*305 <<= must be installed BEFORE `MAG*3*307' Subject: DEFECT PATCH Category: - Routine Description: ============ This document describes MAG*3.0*307, a patch that provides fixes to VistA Imaging Code. This patch is a KIDS only installation patch. This patch addresses the following issues: Defects: -------- 1. INC17666082 - Lab Accession number issue - CI-2 V16\NOL Getting an error message on dig7SUS Tasks: 2. INC17524468 - When testing 262 at St. Louis the HDIG was still erroneously generating new Study UIDs 3. INC18693779 - WCO - Error: DICOM Storage SCP Rejected SOP Instance with Duplicate Series 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: N/A Parameter Definitions Associated: 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. INC17666082 - Lab Accession number issue - CI-2 V16\NOL Getting an error message on DIG7 Problem: -------- CI-2 V16\NOL Getting an error message on dig7. Referring this to support to fix in an upcoming patch. Lab Accession number issue. Code uses 2-character Lab area, it's defined in file 68 as a 4-character synonym. VistA side routines will need to be modified to find the correct Lab Accession number. Peter Kuzmak is aware of the issue. Resolution: ----------- Updated three routines that do the lookup of the file 68 entry to utilize the abbreviation to get the internal ID, and then the subscript value. 2. INC17524468 - When testing 262 at St. Louis the HDIG was still erroneously generating new Study UIDs Problem: -------- RPC CHECK STUDY UID does not check for OTHER CASE's(File #74) so when the DAY-CASE does not match the accession passed in, a match failure is returned even though the target accession number is present in 'OTHER CASE#'. This results in a new STUDY UID being generated and returned. This scenario occurs for 'Print Sets' where there are multiple images pointing to the same file #74 record. Resolution: ----------- Add a final check where if the accession was not found in #70 or #74, check for the accession in OTHER CASE and if found, return that accession being searched. 3. INC18693779 - WCO - Error: DICOM Storage SCP Rejected SOP Instance with Duplicate Series Problem: -------- This is partly the same issue as INC17524468 where a new study UID is being generated erroneously with printset exams for site not using site specific accession number. This study has a combination of old and new SOP instance UIDs. When processing old SOP class images with print sets, it generates the new Study UID and some of the images are saved to the original and some to the s new Study UID which is the known issue. However, when the HDIG starts to process the new SOP images with the generated Study ID some images are erroneously being rejected for duplicate Series. HDIG Logs available. When a duplicate study UID exists and so has a replacement UID stored in #2005.62 STUDY INSTANCE UID, and the original in ORIGINAL STUDY INSTANCE UID, then when the RPC MAGV SERIES UID CHECK is called and passes in the original study UID, it doesn't match what is in STUDY INSTANCE UID and considers the series a duplicate. Since the duplicate flag is on, the RPC returns the value "1~NewUIDToUse~0". The action fails. Resolution: ----------- In LINKED^MAGVRS61, if the study UID passed in does not match the stored STUDY INSTANCE UID, and there is an ORIGINAL STUDY INSTANCE UID populated, it will be used to compare to the UID passed in. Test Sites: ----------- New Orleans VAMC (New Orleans, Louisiana) Boise VAMC (Boise, Idaho) 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_0P307.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_0P307.KID Distribution System (KIDS) build for MAG*3.0*307 Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*307 MAG3_0P307_PATCH_DESCRIPTION.PDF Deployment, Installation, Back-Out, MAG3_0P307_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: -------------------------------- MAG*3.0*307 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*307. Before installing MAG*3.0*307, stop the Tomcat service on all HDIGs and stop all DICOM Legacy Gateway processes. Installation of MAG*3.0*307 requires access to VistA instance and ability to install the KIDS build, access to stop LDGW 2-3 process, and access to HDIG to stop processing. 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_0P307.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*307). 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. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter the build name MAG*3.0*307. 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. 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: INSTall Package(s) Select INSTALL NAME: MAG*3.0*307 8/8/22@21:08:08 => VistA Imaging v3.0 ;Created on Aug 08, 2022@17:49:48 This Distribution was loaded on Aug 08, 2022@21:08:08 with header of VistA Imaging v3.0 ;Created on Aug 08, 2022@17:49:48 It consisted of the following Install(s): MAG*3.0*307 Checking Install for Package MAG*3.0*307 Install Questions for MAG*3.0*307 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*307 -------------------------------------------------------------------------- Installing Routines: Aug 08, 2022@21:08:15 Running Post-Install Routine: POS^MAGIP307 Post Install Mail Message: Aug 08, 2022@21:08:15 Updating Routine file... Updating KIDS files... MAG*3.0*307 Installed. Aug 08, 2022@21:08:15 -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Client Installation Instructions -------------------------------- N/A Post-Installation Instructions: ------------------------------- Verify the routine checksums. Back-Out/Roll Back Plan: ------------------------ For information about back-out steps, see this document: MAG3_0P307_DIBORG.PDF in the VistA Documentation Library at: https://download.vista.domain.ext/index.html/SOFTWARE. Uninstalling the Application: ----------------------------- N/A KIDS Uninstall: If it is necessary to uninstall the MAG*3.0*307 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*307 on 2. Select the Xtract PackMan option. 3. Select the Install/Check Message option. 4. Enter Yes at the "Want to Continue with Load?" prompt. 5. Navigate to the Install Package(s) option in the Kernel Installation & Distribution System menu. 6. Enter "MAG*3.0*307b" at the "INSTALL NAME:" prompt. 7. Enter "NO" at the "Want KIDS to INHIBIT LOGONs during the install?" prompt. 8. Enter "NO" at the "Want to DISABLE Scheduled Options, Menu Options, and Protocols?" prompt. 9. Select an output device, or accept the default. Example, loading and installing backup: ------------------------------------------ Select Kernel Installation & Distribution System Option: INstallation Select Installation Option: INstall Package(s) Select INSTALL NAME: MAG*3.0*307b 8/8/22@21:31:36 => Backup of MAG*3.0*307 on Aug 08, 2022 This Distribution was loaded on Aug 08, 2022@21:31:36 with header of Backup of MAG*3.0*307 on Aug 08, 2022 It consisted of the following Install(s): MAG*3.0*307b Checking Install for Package MAG*3.0*307b Install Questions for MAG*3.0*307b 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*307b -------------------------------------------------------------------------- Install Started for MAG*3.0*307b : Aug 08, 2022@21:31:52 Build Distribution Date: Aug 08, 2022 Installing Routines: Aug 08, 2022@21:31:52 Updating Routine file... Updating KIDS files... MAG*3.0*307b Installed. Aug 08, 2022@21:31:52 -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Routine MAGIP307 is an installation routine that is automatically deleted Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;IMAGING;**[Patch List]**;Mar 19, 2002;Build 28 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: MAGDIR8A Before: B52547655 After: B53230428 **11,51,49,123,138,231,307** Routine Name: MAGDRPC9 Before:B154628774 After:B164914893 **50,54,53,49,123,118,138,180, 190,239,280,305,307** Routine Name: MAGIP307 Before: n/a After: B4188067 **307** Routine Name: MAGVGUID Before: B38946715 After: B43605969 **118,138,162,262,307** Routine Name: MAGVORDR Before: B29838762 After: B30296802 **118,138,156,307** Routine Name: MAGVRS61 Before: B95250185 After:B102771415 **118,162,307** Routine list of preceding patches: 156, 231, 262, 305 ============================================================================= User Information: Entered By : JR Date Entered : JUN 15, 2021 Completed By: Date Completed: OCT 25, 2022 Released By : Date Released : OCT 26, 2022 ============================================================================= Packman Mail Message: ===================== No routines included