$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Monday, 06/08/20 at 14:32 ============================================================================= Run Date: SEP 21, 2020 Designation: LR*5.2*538 Package : LR - LAB SERVICE Priority: Mandatory Version : 5.2 SEQ #438 Status: Released Compliance Date: OCT 22, 2020 ============================================================================= Associated patches: (v)LR*5.2*440 <<= must be installed BEFORE `LR*5.2*538' (v)LR*5.2*524 <<= must be installed BEFORE `LR*5.2*538' Subject: COLLECTION LIST, RESULT VERIFICATION, AND LOAD/WORKLIST ISSUES Category: - Routine Description: ============ This patch addresses the following issues: 1. A panel might remain on the "Incomplete test status list" if it was ordered twice as Lab Collect. 2. Building a Load/Worklist for a yearly accession area might cause an orphan entry in the ACCESSION (#68) file. Associated ticket(s): --------------------- INC10219673 - Panel Issue in Collection List and Result Verification INC10122909 (d) INC10436902 (d) INC10676331 - Load/Worklist Issue with Yearly Accession Areas Additional Information: ----------------------- Blood Bank Team Coordination: EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch LR*5.2*538 does not contain any changes to the VISTA BLOOD BANK Software as defined by ProPath standard titled: BBM Team Review of VistA Patches. EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch LR*5.2*538 does not alter or modify any software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch LR*5.2*538 have no adverse effect on Blood Bank software functionality, therefore RISK is none. VALIDATION REQUIREMENTS BY OPTION: Because of the nature of the changes made, no specific validation requirements exist as a result of installation of this patch. Defect Tracking System Ticket(s) & Overview: 1. INC10219673: Panel Issue in Collection List and Result Verification Problem: -------- A panel might remain on the "Incomplete test status list" if the panel was ordered twice as Lab Collect, and if the first order for the panel was canceled before the collection list generated. The root cause of the issue is that the collection list logic and the result verification logic assume that a panel will only be filed once per specimen number subscript in the LAB ORDER ENTRY (#69) file. However, a test might be filed more than once if the first test has been canceled and the collection list merged the second test order into the first order. The assumption by the collection list causes a mismatch of the CPRS order number to the test subscript in the LAB ORDER ENTRY (#69) file. The same assumption by the result verification logic causes the test status to not be determined correctly. Resolution: ----------- Modify routines LR7OF2 and LRVER3A to allow for the fact that a test might be filed more than once at the specimen number subscript of the LAB ORDER ENTRY (#69) file. A determination is made as to which entry in the LAB ORDER ENTRY (#69) file is correct for the test. Routines: LR7OF2 and LRVER3A 2. INC10676331: Load/Worklist Issue with Yearly Accession Areas Problem: -------- If a Load/Worklist is built for a yearly accession area, the load list pointer will file into the previous year's subscript for the LOAD LIST ENTRY (#2) field in the TESTS SUB-FIELD (#68.04) of the ACCESSION (#68) file. (Example: Accession 100 for year 2020 is built with load list pointer "23;5;4". The pointer is stored for year 2019 instead at accession 100.) If the same accession number exists for the previous year, that accession number now points to this year's load list pointer. If the same accession number does not exist for last year, an orphan node exists in the ACCESSION (#68) file. If the same accession number exists for the previous year and the test was not ordered on that accession for the previous year, the display of the test on the previous year accession in the CPRS Labs Tab "Most Recent" report might indicate "Collected - Specimen in Lab" even though the test was not ordered on the accession. The incorrect display will occur only for tests (such as those for Chemistry) that display in a "grid" type of format. Resolution: ----------- Modify routine LRLL1A to not file the load list pointer into the previous year's ACCESSION (#68) file. Also, create a post-install routine that will delete orphan load list pointers in the ACCESSION (#68) file. (Only orphan entries are deleted. If the test was ordered for the previous year's accession, the load list pointer might have been correct at the time. Those entries cause no harm and are not deleted.) Routines: LRLL1A, LR538PST Test Sites: ----------- Northport VAMC (Northport, NY) VA Puget Sound HCS (Seattle, WA) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. Patch Installation: ------------------- Pre/Post Installation Overview: Post-install routine LR538PST will delete orphan entries in the ACCESSION (#68) file that were set as a result of the issue for ticket INC10676331. The post-install routine is tasked by the install and will be deleted in a future patch. 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 the patch or build name. (ex. or XXXXX BUILD X.X) 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 of any routines exported with this patch. It will not backup any other changes such as DDs or templates. 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: Check MailMan for the message that will be sent after the post-install routine completes. The message will have the following subject line: Subj: LR*5.2*538 Post-Install No action is necessary. This message is only confirmation that the cleanup of orphan load list pointers in the ACCESSION file (#68) was completed. Back-out/Roll Back Plan: ------------------------ In the event of a catastrophic failure, the Facility CIO may make the decision to back-out the patch. It is imperative that you have performed a backup of the routines included in this patch prior to installation. The back-out plan is to restore the routines from the backup created. No rollback strategy is required for the post-install file corrections to the ACCESSION (#68) file since orphan nodes should not exist. To verify the back-out completed successfully, ensure the checksum matches the pre-patch checksum from the patch description. The orphan nodes that were deleted from the ACCESSION (#68) file by the post-install routine LR538PST do not need to be restored. The orphan nodes were corrupt file fragments. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.2;LAB SERVICE;**[Patch List]**;Sep 27, 1994;Build 9 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: LR538PST Before: n/a After: B27429831 **538** Routine Name: LR7OF2 Before: B25837155 After: B26652082 **121,187,440,538** Routine Name: LRLL1A Before: B16892953 After: B16883776 ***538*** Routine Name: LRVER3A Before:B218379813 After:B224170360 **1,5,42,100,121,153,190,221, 254,263,266,274,295,373,350, 512,524,538** Routine list of preceding patches: 440, 524 ============================================================================= User Information: Entered By : Date Entered : APR 17, 2020 Completed By: Date Completed: SEP 21, 2020 Released By : Date Released : SEP 21, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT