$TXT Created by at KRNDEV.FO-OAKLAND.DOMAIN.EXT (KIDS) on Friday, 05/12/23 at 17:01 ============================================================================= Run Date: AUG 16, 2023 Designation: XU*8*779 Package : XU - KERNEL Priority: Mandatory Version : 8 SEQ #628 Status: Released Compliance Date: SEP 16, 2023 ============================================================================= Associated patches: (v)XU*8*771 <<= must be installed BEFORE `XU*8*779' (v)XU*8*780 <<= must be installed BEFORE `XU*8*779' Subject: REMOTE APPLICATION FIXES Category: - Routine - Data Dictionary Description: ============ This patch fixes some issues with REMOTE APPLICATION (#8994.5) file lookups. Also, this patch will remove REMOTE APPLICATION entries that were added with Kernel Patch XU*8.0*780. Items addressed in this patch are: o The SAML (Security Assertion Markup Language) Authentication is forcing lowercase hashing to occur when referencing and verifying a matching registered REMOTE APPLICATION (#8994.5) file entry. o The "ACODE" cross reference of the APPLICATIONCODE (#.03) field in the REMOTE APPLICATION (#8994.5) file was truncating the entries to 30 characters. o The Help Prompt and Description for the APPLICATIONCODE (#.03) field needed some corrections. o REMOTE APPLICATION entries "NUMI VDIF" and "BMS VDIF", that were added with patch XU*8.0*780, will be removed. These entries were temporary duplicate entries for their system migration. Since this patch addresses the bug in REMOTE APPLICATION lookups, these entries will no longer be required for those systems to work properly. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- REMOTE APPLICATION (#8994.5) APPLICATIONCODE (#.03) Modified 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: ----------------------- None. New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC24784438 - VistA Remote Application lookup issue(s) Problem: -------- The SAML Authentication is forcing lowercase hashing to occur when referencing and verifying a matching registered REMOTE APPLICATION (#8994.5) file entry. Resolution: ----------- XUSAML and XUESSO2 will be modified to not force lowercase hashing before checking the "ACODE" cross reference. For backward compatibility, the logic will check lower case and mixed case to be sure that lookups for REMOTE APPLICATION entries in the past and present function as they should. Problem: -------- The "ACODE" cross reference of the APPLICATIONCODE (#.03) field in the REMOTE APPLICATION (#8994.5) file was truncating the entries to 30 characters. Resolution: ----------- The "ACODE" cross reference will be rebuilt with a "New-Style" type cross reference, which corrects having a fixed number of characters and use the entire APPLICATIONCODE entry as the cross reference. Problem: -------- REMOTE APPLICATION entries "NUMI VDIF" and "BMS VDIF", that were added with patch XU*8.0*780, will be removed. These entries were temporary duplicate entries for their system migration. Since this patch addresses the bug in REMOTE APPLICATION lookups, these entries will no longer be required for those systems to work properly. Resolution: ----------- The "NUMI VDIF" and "BMS VDIF" entries will be removed from the REMOTE APPLICATION (#8994.5) file. Test Sites: ----------- Carl Vinson VAMC (Dublin, GA) Butler VAMC (Butler, PA) Test Sites - SNOW Change Order #: Carl Vinson VAMC: CHG0394374 Butler VAMC: CHG0390970 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality is not included in this release. Patch Installation: ------------------- Pre/Post Installation Overview: The Post Install routine, XU8P779, performs the following actions: o Replaces the old style "ACODE" index for the APPLICATIONCODE (#.03) field in the REMOTE APPLICATION (#8994.5) file with a new style index of the same name. This removes the issue of truncating the index to 30 characters and allows the index to store all the characters in the field. o Removes the "BMS VDIF" and "NUMI VDIF" entries in the REMOTE APPLICATION (#8994.5) file that were added as a temporary fix from patch XU*8.0*780. These entries are no longer needed after this patch is installed as REMOTE APPLICATION lookups will function correctly. The post-install routine, XU8P779, will be automatically deleted. Pre-Installation Instructions: 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 5 minutes to install. No options need to be placed out of order. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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. or XXXXX BUILD X.X) XU*8.0*779 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 XXX*#.#*### XU*8.0*779 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. When prompted "Do you wish to secure your build? 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 of the 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? NO//', press and take the default response of "NO". ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', press and take the default response of "NO". iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', press and take the default response of "NO". Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ If assistance is needed to rollback/back-out the patch please, log a ServiceNow (SNOW) ticket so the development team can assist in this process. Note: During installation, if the option to back-up the routines was executed as directed, "Backup a Transport Global" (Step 2B.), then the routines will have the ability to be restored from the 'backup' MailMan message that was generated. However, the Kernel Installation and Distribution System (KIDS) process does NOT perform a back up of the other VistA software components, such as RPCs. Routine Information: ==================== The second line of each of these routines now looks like: ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XU8P779 Before: n/a After: B10661668 **779** Routine Name: XUESSO2 Before:B132367444 After:B134263161 **655,659,630,701,731,771,779** Routine Name: XUSAML Before:B165559906 After:B164935883 **655,659,630,701,731,771,779** Routine list of preceding patches: 771 ============================================================================= User Information: Entered By : Date Entered : OCT 03, 2022 Completed By: Date Completed: AUG 16, 2023 Released By : Date Released : AUG 16, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT