$TXT Created by MNTVBB.DOMAIN.EXT (KIDS) on Wednesday, 02/09/22 at 09:48 ============================================================================= Run Date: MAR 29, 2022 Designation: LR*5.2*554 Package : LR - LAB SERVICE Priority: Mandatory Version : 5.2 SEQ #453 Status: Released Compliance Date: APR 29, 2022 ============================================================================= Associated patches: (v)LR*5.2*549 <<= must be installed BEFORE `LR*5.2*554' Subject: INCORRECT INFORMATION IN TRACK COLLECTION OPTION - HOWDY Category: - Routine Description: ============ This patch addresses the following issue: Incorrect Information in Track Collection Option - HOWDY Associated ticket(s): ===================== INC20231002 - CTX Incorrect Information in VistA Track Collection Associated NSR(s): ================== N/A Defect Tracking System Ticket(s) & Overview: =========================================== INC20231002 - CTX Incorrect Information in VistA Track Collection Problem: ------- The Howdy Phlebotomy Log (LRHY PHLEBOTOMY LOG) option stores, collector's phlebotomy times including the accession number (UID), in the HOWDY SPECIMEN TIMES BY UID file (#69.87). Entries in the HOWDY SPECIMEN TIMES BY UID file (#69.87) are never deleted. After 10 years, when lab accessions (UIDs) are no longer unique, data for current UIDs cannot be added to the HOWDY SPECIMEN TIMES BY UID file (#69.87) if the UID already is present in a file record. This is because the Phlebotomy Log option checks for the presence of the UID and does not allow duplicates. When the option TRACK COLLECTION (LRHY TRACK COLLECTION)is run, the data for the UID that is 10 years old will be retrieved and displayed, which is confusing to the user. Resolution: ---------- Logic is added to the lab NIGHTLY CLEANUP process. The routine LRNIGHT will run LRHOWDY^LRWU9A in the background. LRHOWDY^LRWU9A will delete records that are more than 9 years old from the HOWDY SPECIMEN TIMES BY UID file (#69.87). Technical Resolution: --------------------- Within the SUBTASKS section of routine LRNIGHT, code is added to job off LRHOWDY^LRWU9A to background processing. Entry point LRHOWDY is added to routine LRWU9A. LRHOWDY loops through the B index of the HOWDY SPECIMEN TIMES BY UID file (#69.87) and deletes records that are greater than 9 years old, time is not considered so a record that was scanned anytime today exactly 9 years ago is not deleted, the record must have been scanned over 9 years ago to be purged. If the record does not have a value in the INITIAL SCAN TIME field (#2), then the COLLECTION TIME field (#8) is used, if no COLLECTION TIME field (#8), then the TIME LABEL PRINTED field (#4) is used, if there is no date after looking at these three fields, the record will be purged. Test Sites: =========== Central Texas Veterans Health Care System (Temple,TX) Northern Arizona - VA Health Care System (Prescott, AZ) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Patch Installation: Pre-Installation Instructions: ============================= This patch may be loaded with users on the system. You may wish to install it during non-peak hours. Installation will take less than 1 minute. 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 LR*5.2*554 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 LR*5.2*554 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 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//', 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 Back-out/Rollback Strategy: --------------------------- Back-out will be done only with the concurrence and participation of development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between development team, VA site/region personnel and other appropriate VA personnel. Prior to installing an updated KIDS package, the site/region should have saved a backup of the build in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up build can be loaded with the "Xtract PackMan" function at the Message Action prompt. The Packman function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. The back-out plan is to restore the build from the backup created. No data was modified by this patch installation and, therefore, no rollback strategy is required. Validation of Back-out Procedure: --------------------------------- The Back-out Procedure can be verified by printing the first 2 lines of the routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the build contained in the LR*5.2*554 patch has been backed out, the first two lines of the routines will no longer contain the designation of this patch in the patch list section on line 2. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.2;LAB SERVICE;**[Patch List]**;Sep 27, 1994;Build 13 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: LRNIGHT Before: B8967137 After: B10306333 **291,350,458,543,554** Routine Name: LRWU9A Before: B38755960 After: B45530375 **519,543,549,554** Routine list of preceding patches: 549 ============================================================================= User Information: Entered By : Date Entered : NOV 16, 2021 Completed By: Date Completed: MAR 28, 2022 Released By : Date Released : MAR 29, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT