$TXT Created by KRNDEV.FO-OAKLAND.DOMAIN.EXT (KIDS) on Wednesday, 01/22/25 at 09:13 ============================================================================= Run Date: MAR 13, 2025 Designation: XU*8*761 Package : XU - KERNEL Priority: Mandatory Version : 8 SEQ #648 Status: Released Compliance Date: APR 13, 2025 ============================================================================= Associated patches: (v)XU*8*163 <<= must be installed BEFORE `XU*8*761' Subject: TASKMAN SYNC FLAG ISSUES Category: - Routine Description: ============ Kernel Patch XU*8.0*761 fixes issues found with the management of TaskMan Sync Flag tasks and adds the ability to view these types of tasks within the TaskMan utility options. Bugs were found with the "SYNC flag file control" [XUTM SYNC] option within the "Taskman Management Utilities" [XUTM UTIL] menu. This option manages and controls Sync Flag type tasks in TaskMan. The bugs with this option stems from calling some internal functions with reversed parameters passed, which caused the different functions of this option to not work properly. Also, when deleting Sync Flag tasks, the pending tasks were not dequeued/unscheduled, which would leave the tasks in an invalid state in the TaskMan files, which can preclude TaskMan from cleaning these tasks up properly. Additionally, there was no way to specifically view Sync Flag type tasks in TaskMan without having to find them manually in the TaskMan globals, which can be burdensome when trying to find this specific type of task. The XUTM SYNC option also had very little or no informational feedback to the user when the option was used, which made it difficult to understand what the option was doing when executed. The items addressed in this patch are: o Fixed all areas where parameters to functions were reversed or set incorrectly in the XUTM SYNC option and properly set and pass the SYNC FLAG and IO device variables within TaskMan correctly. o Fixed the cleanup of Task Sync tasks when deleted by properly dequeueing/unscheduling tasks when these tasks were deleted using the XUTM SYNC option. o Enhanced the output of the XUTM SYNC option to provide proper user feedback to functions used with this option. This makes it clear to the user what is happening and the tasks that are involved with the operation used. o Added a task viewer for Sync Flag type tasks. This task viewer filters on Sync Flag type tasks and was added to both the XUTM SYNC option as an additional selectable sub-option within that option and added to the "Monitor Taskman" [XUTM ZTMON] option within the "??" Help submenu of the that option to view active/pending Sync Flag type tasks. 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: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: 1. INC19891105 - Task Sync File issues (VP-17) Problem: -------- Reporting two issues with resource tasks that use the Sync flag option: 1. The wrong values are being used to schedule tasks from the wait list in the XUTM SYNC option to clear a flag 2. If no task or job information is saved in the Resource file when a device gets blocked by an entry in the Task Sync Flag file, nothing displays in the TaskMan monitor or the Task Waiting options to indicate a problem; requesting that the wait list in ^%ZTSCH("SYNC") also be checked in these options and some indication displayed that a wait list exists and may be growing. Resolution: Variables set for IO and FLAG were set incorrectly and reversed. Additionally, the internal TaskMan function calls used were passed with the incorrect IO and FLAG parameters also reversed. This resulted in only 25% of the functionality of the XUTM SYNC option correctly working, but leaving these types of tasks in an invalid state and would never be cleaned up by TaskMan. The Task Sync type tasks were always running correctly and handled by TaskMan properly, it was only the management of these tasks (running next Sync Pair task or Deleting a Sync Pair) using the XUTM SYNC option that were affected by these bugs. Kernel Patch XU*8.0*761 correctly uses the internal TaskMan function calls to now properly set the IO and FLAG variables. This fix now allows the XUTM SYNC option functionality to operate at 100%. It also puts those tasks (running next Sync Pair task or Deleting a Sync Pair) into a valid state to be properly cleaned up by TaskMan. Test Sites: Change Order #: --------------------------------------- Tomah VAMC CHG0570617 Hampton VAMC CHG0568163 Grand Junction VAMC CHG0571812 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Documentation is not included in this release. Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- There are no Pre/Post installation routine processes. 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. 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 XU*8.0*761 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.0*761 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: None Back-Out/Roll Back Plan: ------------------------ To rollback/backout this patch, a. 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*761". Use the PackMan message action XTRACT KIDS. Use the INSTALL/CHECK MESSAGE option to load the backup build. b. Then use KIDS menu to install the backup KIDS distribution using the Install Package(s) [XPD INSTALL BUILD] option. If assistance is needed to rollback/backout the patch, please log a SNOW ticket so the development team can assist. Routine Information: ==================== The second line of each of these routines now looks like: ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XUTMONH Before: B8408544 After: B9860665 **761** Routine Name: XUTMONH2 Before: B6404587 After: B7712090 **761** Routine Name: XUTMSYNC Before: B1042885 After: B13584036 **163,761** Routine list of preceding patches: 163 ============================================================================= User Information: Entered By : Date Entered : NOV 02, 2021 Completed By: Date Completed: MAR 13, 2025 Released By : Date Released : MAR 13, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT