============================================================================= Run Date: JAN 10, 2023 Designation: MAG*3*331 Package : MAG - IMAGING Priority: Mandatory Version : 3 SEQ #236 Status: Released Compliance Date: FEB 10, 2023 ============================================================================= Associated patches: (v)MAG*3*293 <<= must be installed BEFORE `MAG*3*331' Subject: Defect Patch - Background Processor Category: - Routine Description: ============ This document describes MAG*3.0*331, an adaptive maintenance patch which addresses Windows 2019 Server operating system (OS) functionality and one IaaMS storage defect. This patch addresses the following issue: Defect: -------- 1. INC22251843 - Background Processor System displays the error: "Overlapped I/O Operation is in process:997" when SMB2 is enabled on IaaMS Storage. Adaptive Maintenance: --------------------- 1. Adaptive Maintenance - Background Processor Application support on Windows 2019 Servers 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: ----------------------- 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. INC22251843 - Background Processor System displays the error: "Overlapped I/O Operation is in process:997" when SMB2 is enabled on IaaMS Storage. Problem: -------- Background Processor System displays the error: "Overlapped I/O Operation is in process:997" when SMB2 is enabled on IaaMS Storage. Response 997 occurs when the JUKEBOX queue copies files from T1 to T2 and both locations reside on the same server. Resolution: ----------- A new Delphi routine (CopyAFile) was introduced to a new Delphi unit (BPCopyAFile.pas) that includes additional error handling. This addition confirms correct functioning with SMB2 on Windows 2019 Servers. The success or the failure of the routine is logged in the Background Processor Log. Adaptive Maintenance Tracking System Ticket(s) & Overview: ---------------------------------------------------------- 1. Adaptive Maintenance - Background Processor Application support on Windows 2019 Server OS compliance Problem: -------- Adaptive Maintenance Background Processor - Needed to upgrade application and server to function with Windows 2019 Server OS Resolution: ----------- Verified application will install on Windows 2012/2016 Servers as well as Windows 2019 Servers and work as expected. To perform this action, application-related build scripts and the necessary binaries were upgraded to work with the newly supported Windows 2019 Servers. To validate this change, the application was installed on the Windows 2019 Server OS. Images were successfully saved and transferred to IAAMS T1 and T2 running on the Windows 2019 Server OS. Test Sites: ----------- James J. Peters VAMC (Bronx, NY) W.G. (Bill) Hefner Salisbury Department of VAMC (Salisbury, NC) 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_0P331.KID Additional software for this patch can be installed by following the installation guide at https://www.domain.ext/vdl/documents/Clinical/Vista_Imaging_Sys/ IMGinstallgd.pdf 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_0P331.KID Distribution System (KIDS) build for MAG*3.0*331 Background Processor client MAG3_0P331_BACKGROUND_PROCESSOR_SETUP.EXE installation file - New Documentation describing new functionality is not included in this release. Patch description and installation documentation can be obtained at https://download.vista.domain.ext/index.html/SOFTWARE Documentation Title File Name --------------------------------------------------------------------- Patch Description for MAG*3.0*331 MAG3_0P331_PATCH_DESCRIPTION.PDF Patch ReadMe File MAG3_0P331_README.TXT Deployment, Installation, Back-Out, MAG3_0P331_DIBORG.PDF and Rollback Guide Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- MAG*3.0*331 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*331. 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_0P331.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*331). 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 the build name MAG*3.0*331. 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: 6 Install Package(s) Select INSTALL NAME: MAG*3.0*331 11/19/20@10:14: This Distribution was loaded on Dec 02, 2022@11:30:33 with header of VistA Imaging 3.0 - Patch 331 ;Created on May 23, 2022@11:15:25 It consisted of the following Install(s): MAG*3.0*331 Checking Install for Package MAG*3.0*331 Install Questions for MAG*3.0*331 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*331 -------------------------------------------------------------------------- ------ Installing Routines: Dec 02, 2022@11:30:42 Running Post-Install Routine: POS^MAGIP331 Post Install Mail Message: Dec 02, 2022@11:30:42 Updating Routine file... Updating KIDS files... MAG*3.0*331 Installed. Dec 02, 2022@11:30:42 -------------------------------------------------------------------------- ------ +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Client Installation Instructions -------------------------------- For installing or updating Background Processor applications, refer to the VistA Imaging System Installation Guide Post-Installation Instructions: ------------------------------- N/A Back-Out/Roll Back Plan: ------------------------ Uninstalling the Application: ----------------------------- For uninstalling or updating Background Processor applications, refer to the VistA Imaging System Installation Guide KIDS Uninstall: ---------------- If it is necessary to uninstall the MAG*3.0*331 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*331 backup message as shown below: * Backup of MAG*3.0*331 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*331 3099 Search finished. Enter message number or command: 13093 Subj: Backup of MAG*3.0*331 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*331b OK to continue with Load? NO// YES Distribution OK! Want to Continue with Load? YES// Loading Distribution... MAG*3.0*331b 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*331b This Distribution was loaded on Sep 07, 2022@11:54:20 with header of Backup of MAG*3.0*331 on Sep 06, 2022 It consisted of the following Install(s): MAG*3.0*331b Checking Install for Package MAG*3.0*331b Install Questions for MAG*3.0*331b 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*331b -------------------------------------------------------------------------- Install Started for MAG*3.0*331b : Nov 10, 2022@10:07:46 Build Distribution Date: Aug 12, 2022 Installing Routines: Nov 10, 2022@10:07:46 Updating Routine file... Updating KIDS files... MAG*3.0*331b Installed. Nov 10, 2022@10:07:46 -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed 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: MAGIP331 Before: n/a After: B4088699 **331** Routine Name: MAGQBUT4 Before: B97858724 After: B97945715 **7,8,48,20,81,39,121,135,196, 198,214,222,235,238,243,248, 325,293,331** Routine list of preceding patches: 293 ============================================================================= User Information: Entered By : Date Entered : MAR 03, 2022 Completed By: Date Completed: JAN 09, 2023 Released By : Date Released : JAN 10, 2023 ============================================================================= Packman Mail Message: ===================== No routines included