============================================================================= Run Date: JAN 17, 2023 Designation: LR*5.2*560 Package : LR - LAB SERVICE Priority: Mandatory Version : 5.2 SEQ #461 Status: Released Compliance Date: FEB 17, 2023 ============================================================================= Associated patches: (v)LR*5.2*550 <<= must be installed BEFORE `LR*5.2*560' (v)LR*5.2*556 <<= must be installed BEFORE `LR*5.2*560' Subject: NLT/LOINC V2.73 UPDATE Category: - Routine - Enhancement (Mandatory) Description: ============ Laboratory Logical Observation Identifiers Names and Codes (LOINC) are intended to incorporate efficiencies in the Department of Veterans to the LOINC in use. The LAB LOINC file (#95.3) currently contains LOINC version 2.72 which was released in 2022. The goal of this patch is to update the LAB LOINC file (#95.3) and related files to version 2.73 Patch Components: ================= Files updated in this patch: 95.3 LAB LOINC 95.31 LAB LOINC COMPONENT 64 WKLD CODE 64.061 LAB ELECTRONIC CODES 64.2 WKLD SUFFIX CODES DATA DICTIONARY MODIFICATIONS ============================= Modification of 95.3 LAB LOINC file: ===================================== File screen to exclude Deleted records from pickup list was added: FILE SCREEN (SCR-node) : I $P($G(^LAB(95.3,Y,4)),U)'=1 This DDs approved modification has been for time being put on hold. Files & Fields Associated: ========================== N/A Forms Associated: ================= N/A Mail Groups Associated: ======================= N/A Options Associated: =================== N/A Protocols Associated: ===================== N/A Security Keys Associated: ========================= N/A Templates Associated: ===================== N/A Additional Information: ======================= N/A New Service Requests (NSRs): ============================ N/A Patient Safety Issues (PSIs): ============================= N/A Defect Tracking System Ticket(s) & Overview: ============================================ N/A Remote Procedures Associated: ============================= N/A Parameter Definitions Associated: ================================= N/A Test Sites: ============== VISN 6 Salem VISN 2 Upstate New York Health Care System (Buffalo, Batavia, Canandaigua, Syracuse, Bath, Albany) BLOOD BANK CLEARANCE ==================== EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch LR*5.2*560 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*560 does not alter or modify any software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch LR*5.2*560 have no 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. LOINC Copyright acknowledgement: ================================ 1995-2017, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee. All rights reserved. LOINC is a trademark of the Regenstrief Institute. Contact information: LOINC c/o Regenstrief Center for Biomedical Informatics The Regenstrief Institute, Inc 410 West 10th Street, Suite 2000 Indianapolis, IN 46202-3012 Modification of 64 WKLD CODE file. ===================================== There is the special treatment to transfer WKLD file 64. This file cannot be shipped like the other files which delete all data in each file and then copy all data that is shipped. This routine copies the entire file #64 to the TRANSPORT sub-file (field #17) of the LAB NLT/CPT CODES file (#64.81). The post install routine of patch LR560 uses file #64.81 to update file #64 on site. Software and Documentation Retrieval Instructions: ================================================== The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/LR_52_560.KID (note use this location in step #2 of the Installation Instructions below) Documentation describing the new functionality is NOT included in this release. Documentation Title File Name --------------------------------------------------------------------- NA Patch Installation: =================== Pre/Post Installation Overview: =============================== The pre-installation routine/tag: PRE^LR560 The Post-installation routine/tag: POST^LR560 Pre-Installation Instructions: ============================== Size/Disk Space Requirements The changes to the LAB globals will result in a combined growth of about 80 MB of data. Make sure there is sufficient space for the growth to the VistA globals. If this is the reinstallation, please call support center for assistance, if this is regular (first) installation, please proceed with next step. **IMPORTANT**: Back up the Laboratory global data files; this is necessary if the data must be restored. Back up data files using your site's policy for backing up data. If the steps are unknown, here is a way it can be done: 1. Go to a command prompt. 2. At the prompt, enter D GOGEN^%ZSPECIAL. 3. At the device prompt, enter the name of the local directory where the file is to be stored with the name of the file. (EX: VA5$:[SITEDIR]PRE_LR560_DATA_FILE_BKUP_YYYYMMDD.GBL) 4. At the Parameters? Prompt, press . 5. At the Global prompt, enter the file globals below LAB LOINC #95.3 ^LAB(95.3, LAB LOINC COMPONENT #95.31 ^LAB(95.31, WKLD CODE #64 ^LAM WKLD SUFFIX CODES #64.2 ^LAB(64.2, LAB ELECTRONIC CODES #64.061 ^LAB(64.061, 6. Verify that the file was created and exists in the directory specified. These backup files may get as large as 90 MB. Make sure space is available before proceeding. It should take from 5 to 10 minutes to create the backup files. EXAMPLE: VISTA>d GOGEN^%ZSPECIAL Device: VA5$:[LOCALDIR]MA_PRE_LR560_DATA_FILE_BKUP_20221125.GBL (YYYYMMDD - YYYY-year, MM-month, DD-date) Parameters? "WNS" => Warning: Use a "V" format to avoid problems with control characters. Global ^LAM -- NOTE: translation in effect Global ^LAB(64.2 -- NOTE: translation in effect Global ^LAB(64.061 -- NOTE: translation in effect Global ^LAB(95.3 -- NOTE: translation in effect Global ^LAB(95.31 -- NOTE: translation in effect Global ^ Installation Instructions =========================== LABORATORY USERS MUST LIMIT ACCESSIONING OF SPECIMENS OR VERIFYING OF RESULTS DURING THE INSTALLATION; PATCH INSTALLATION SHOULD OCCUR DURING NON-PEAK PERIODS FOR THE LAB. No laboratory background jobs need to be stopped. No options need to be placed out of service. All users may remain on the system. Installation time is less than 30 minutes. An Alert is sent to G.LMI when the install starts and finishes. Note: The patch should be installed during off peak hours. Note: System may hang while performing the Full Comparison of the Compare Transport Global Part of installation is the Symbol Table is dumped into Error trap. The Error with this label can be seen after installation: LR560 : Application Error!, please disregard Please note, this is not real error and doesn't need to be reported to developer. This may help to trace any issue from installation. 1) From the Kernel Installation & Distribution System menu, select the Installation menu 2) From this menu, select the option Load a Distribution and enter /srv/vista/patches/SOFTWARE/LR_52_560.KID 3) KIDS Installation: Install the patch using the KIDS Installation Menu action "Install Package(s)" and the install name LR*5.2*560 Respond "NO" at the "Want KIDS to INHIBIT LOGONs during the install?" prompt. Respond "NO" at the "Want to DISABLE Scheduled Options, Menu Options, and Protocols?" prompt. The KIDs install should take from 4-9 minutes Post-Installation Instructions: =============================== Cleanup The PRE and POST installation routine LR560 may be deleted using the KERNEL option 'Delete Routines' [XTRDEL] upon completion of the installation. Back-Out/Roll Back Plan ======================= To back-out data from a production account could cause broken pointers, cause errors and hard MUMPS crashes. The back-out plan for data only patches is to "Report the findings and wait for a repair patch." Contact the Enterprise Service Desk to log an Incident to the NTL.APP.VISTA.Lab.General which assigns the ticket to the appropriate National Support team. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.2;LAB SERVICE;**[Patch List]**;Sep 27, 1994;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: LR560 Before: n/a After:B112540451 **560** ============================================================================= User Information: Entered By : Date Entered : JUL 19, 2022 Completed By: Date Completed: JAN 12, 2023 Released By : Date Released : JAN 17, 2023 ============================================================================= Packman Mail Message: ===================== No routines included