============================================================================= Run Date: FEB 13, 2024 Designation: LR*5.2*567 Package : LR - LAB SERVICE Priority: Mandatory Version : 5.2 SEQ #465 Status: Released Compliance Date: MAR 15, 2024 ============================================================================= Associated patches: (v)LR*5.2*563 <<= must be installed BEFORE `LR*5.2*567' Subject: NLT/LOINC V2.76 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.74 which was released in 2023. The goal of this patch is to update the LAB LOINC file (#95.3) and related files to version 2.76 Patch Components: ================= Files & Fields Associated: ========================== File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- #95.3 |TAB||TAB| LAB LOINC|TAB||TAB||TAB|Modified #95.31 |TAB| |TAB| LAB LOINC COMPONENT|TAB||TAB|Modified #64 |TAB||TAB| WKLD CODE|TAB||TAB||TAB|Modified #64.061 |TAB||TAB| LAB ELECTRONIC CODES|TAB|Modified #64.2 |TAB||TAB| WKLD SUFFIX CODES|TAB||TAB|Modified 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: ======================= N/A New Service Requests (NSRs): ============================ N/A Patient Safety Issues (PSIs): ============================= N/A Defect Tracking System Ticket(s) & Overview: ============================================ N/A Problem: ========= N/A Resolution: ============ N/A Technical Resolution: ===================== N/A Test Sites: ============== VISN 6 Salem VISN 2 Upstate New York Health Care System (Buffalo, Batavia, Canandaigua, Syracuse, Bath, Albany) SNOW Change Order #: ====================== VISN 6 Salem: CHG0446571 VISN 2 Upstate New York Health Care System: CHG0445336 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_567.KID (note use this location in step #2 of the Installation Instructions below) Documentation describing the new functionality is NOT included in this release. Patch Installation: =================== Pre/Post Installation Overview: =============================== The pre-installation routine/tag: PRE^LR567 The Post-installation routine/tag: POST^LR567 Pre-Installation Instructions: ============================== Size/Disk Space Requirements The changes to the LAB globals will result in a combined growth of about 85 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_LR567_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_LR567_DATA_FILE_BKUP_20231208.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: LR567 : Application Error! please disregard No Need to report it 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_567.KID 3) KIDS Installation: Install the patch using the KIDS Installation Menu action "Install Package(s)" and the install name LR*5.2*567 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 Back-out/Rollback Strategy: =============================== N/A Post-Installation Instructions: =============================== Cleanup The PRE and POST installation routine LR567 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 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: LR567 Before: n/a After:B113122330 **567** ============================================================================= User Information: Entered By : Date Entered : AUG 22, 2023 Completed By: Date Completed: FEB 12, 2024 Released By : Date Released : FEB 13, 2024 ============================================================================= Packman Mail Message: ===================== No routines included