$TXT Created by at KRNDEV.FO-OAKLAND.DOMAIN.EXT (KIDS) on Tuesday, 04/15/25 at 15:17 ============================================================================= Run Date: JUN 25, 2025 Designation: XU*8*807 Package : XU - KERNEL Priority: Mandatory Version : 8 SEQ #653 Status: Released Compliance Date: JUL 26, 2025 ============================================================================= Subject: SERVICE/SECTION EDIT TO CLASS I MODIFICATION Category: - Routine - Data Dictionary - Other Description: ============ Kernel Patch XU*8.0*807 was developed to convert and enhance the existing software for the "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] option from Class II "R2XTAD" namespace to Class I Kernel "XUXTAD" namespace. Currently, this Class II software prevents issues that can arise when local sites edit entries in the SERVICE/SECTION (#49) file manually using VA FileMan. While this is not a bug, it can create wide-spread issues up to and including HPI/CPI events; most recently described in ServiceNow (SNOW) ticket #INC34745455. Kernel Patch XU*8.0*807 Changes: * Fixes the deletion problem by preventing the user from using VA FileMan directly to make changes to the SERVICE/SECTION (#49) file. Instead, guides the user to use the improved "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] option to complete their work. - Adds the Class I form 'XUXTAD SERVICE/SECTION EDIT' for the file Service/Section (#49). - Allows editing of the NAME (#.01) field. - Adds and allows editing of the DATE CLOSED (#13) multiple, DATE CLOSED (#.01) and DATE RE-OPENED (#1) fields. - Adds a display only Service/Section Open/Closed Status field. This is a calculated field that determines the status of the Service/Section. - Adds the Class I option: "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] - If the Class II option: "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] exists: Set OUT OF ORDER MESSAGE (#2) field= "Replaced by SSE Service/Section Edit". - If the Class II option: "User Information Menu" [R2XTAD USER INFO MENU] exists: Add menu item option: "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT]. Delete menu item option: "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] if it exists. - Updates the Data Dictionary Field-level attributes: HELP-PROMPT and DESCRIPTION for SERVICE/SECTION (#49) file and NAME (#.01) field. * Converts all required code associated with the "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] option from Class II "R2XTAD" namespace to Class I "XUXTAD" namespace. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- SERVICE/SECTION (#49) NAME (#.01) Modified Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- XUXTAD SERVICE/SECTION EDIT Service/Section (#49) New Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- XUXTAD SERVICE/SECTION EDIT run routine New Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A 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: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. SCTASK16043983 R2XTAD SERVICE/SECTION EDIT conversion to Class I Problem: -------- Issues arise when local sites delete entries in the SERVICE/SECTION (#49) file. Converting routine R2XTADSSE and its associated option 'R2XTAD SERVICE/SECTION EDIT' may help limit such problems. While this is not a bug, the problems arising when local sites delete entries create wide-spread issues up to and including HPI/CPI events, most recently INC34745455. Resolution: ----------- Kernel Patch XU*8.0*807 converts and enhances all required code associated with the "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] option from Class II "R2XTAD" namespace to Class I "XUXTAD" namespace. Adds the Class I "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] option to the Class II [R2XTAD USER INFO MENU] parent option menu. Disables the Class II "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] option. Test Sites: Change Order #: --------------------------------------- Phoenix CHG0605393 Northport CHG0605150 Saginaw CHG0607375 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Document 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 ----------------------------------------------------------------------- Kernel 8.0 System Management KRN_8_0_SM_UTILITIES_UG.PDF Utilities User Guide KRN_8_0_SM_UTILITIES_UG.DOCX Kernel 8.0 and Kernel Toolkit 7.3 KRN_8_0_TM.PDF Technical Manual KRN_8_0_TM.DOCX Patch Installation: ------------------- Pre/Post Installation Overview: There is a Post installation routine: POSTINSTALL^XUP807. This routine will be deleted once the install is completed. Pre-Installation Instructions: 1. 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. 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. XU*8.0*807 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 XU*8*807 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Backup Type: B//, answer B. 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 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//', 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. Post-Installation Instructions: The Post-Install Routine: KIDS calls POSTINSTALL^XUP807 after the installation to verify the following: A. The form 'XUXTAD SERVICE/SECTION EDIT' exists. B. The option "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] exists. C. The option "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] has ROUTINE (#25) field="ENTER^XUXTADSSE". D. If the option "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] exists: Set OUT OF ORDER MESSAGE (#2) field= "Replaced by SSE Service/Section Edit". E. If the option [R2XTAD USER INFO MENU] exists: Add "Service/Section Edit" [XUXTAD SERVICE/SECTION EDIT] as menu item option. Delete "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] menu item option if it exists. F. The SERVICE/SECTION (#49) file NAME (#.01) field attributes 'HELP-PROMPT', and 'DESCRIPTION' have been updated. XUP807 is deleted after the install is completed. 1. Verify that the installation was successful. See Sample Install below. 2. Verify that no new errors related to this patch are appearing in the Error Log [XUERTRAP]. Sample Install on a test account shown below, note the two lines containing information about the Post-Install routine being run and its output: -------------------------------------- Installing OPTION Dec 24, 2024@11:01:11 Running Post-Install Routine: POSTINSTALL^XUP807 Post-Installation check is good Updating Routine file... Updating KIDS files... XU*8.0*807 Installed. Dec 24, 2024@11:01:11 Not a production UCI NO Install Message sent --------------------------------------- Back-Out/Roll Back Plan: ------------------------ To rollback/backout this patch: 1. Use MailMan menu to locate the PackMan message containing the backup build. The subject of the PackMan message begins with "Backup of XU*8.0*807". Use the PackMan message action XTRACT KIDS. Use the INSTALL/CHECK MESSAGE option to load it. 2. Then use KIDS menu to install the backup KIDS distribution using the Install Package(s) [XPD INSTALL BUILD] option. 3. If the option "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] exists, use FileMan to delete the OUT OF ORDER MESSAGE (#2) field from the "Service/Section Edit" [R2XTAD SERVICE/SECTION EDIT] option. Example FileMan session below: >D P^DI VA FileMan 22.2 Select OPTION: ENTER OR EDIT FILE ENTRIES Input to what File: OPTION// (11418 entries) EDIT WHICH FIELD: ALL// OUT OF ORDER MESSAGE THEN EDIT FIELD: Select OPTION NAME: R2XTAD SERVICE/SECTION EDIT Service/Section Edit OUT OF ORDER MESSAGE: Replaced by SSE Service/Section Edit Replace @ SURE YOU WANT TO DELETE? Y (Yes) 4. Use ScreenMan to delete the FORM 'XUXTAD SERVICE/SECTION EDIT'. Example FileMan session below: >D P^DI VA FileMan 22.2 Select OPTION: OTHER OPTIONS Select OTHER OPTION: SCREENMAN Select SCREENMAN OPTION: DELETE A FORM Delete Form for what File: SERVICE/SECTION (54 entries) Select FORM to delete: XUXTAD SERVICE/SECTION EDIT XUXTAD SERVICE/SECTION EDIT #28 9/24/24 File #49 BLOCKS USED ON FORM "XUXTAD SERVICE/SECTION EDIT" (IEN #28) Internal Used on Entry Number Block Name Other Forms? Deletable? ------------ ---------- ------------ ---------- 588 SSEH NO YES 589 SSEP NO YES Delete all deletable blocks used on form XUXTAD SERVICE/SECTION EDIT from the BLOCK file (Y/N)? YES// Delete blocks without prompting (Y/N)? NO// YES Continue (Y/N)? NO// YES Deleting form XUXTAD SERVICE/SECTION EDIT (IEN #28) ... Deleting block SSEH (IEN #588) ... Deleting block SSEP (IEN #589) ... DONE! Routine Information: ==================== The second line of each of these routines now looks like: ;;8.0;KERNEL;**[Patch List]**;Dec 20, 2024;Build 56; The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XUP807 Before: n/a After: B77079667 **807** Routine Name: XUXTADAPI Before: n/a After:B140873262 **807** Routine Name: XUXTADAPI2 Before: n/a After:B156073988 **807** Routine Name: XUXTADAPI3 Before: n/a After:B171593961 **807** Routine Name: XUXTADASK1 Before: n/a After: B77930665 **807** Routine Name: XUXTADDILG Before: n/a After: B11971651 **807** Routine Name: XUXTADDT1 Before: n/a After: B63146849 **807** Routine Name: XUXTADPRT1 Before: n/a After: B55121039 **807** Routine Name: XUXTADPRT2 Before: n/a After: B9806088 **807** Routine Name: XUXTADSSE Before: n/a After: B26534307 **807** Routine Name: XUXTADSSEF Before: n/a After:B223184570 **807** ============================================================================= User Information: Entered By : Date Entered : JUL 30, 2024 Completed By: Date Completed: JUN 24, 2025 Released By : Date Released : JUN 25, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT