
=============================================================================
Run Date: DEC 23, 2024                     Designation: LR*5.2*576
Package : LR - LAB SERVICE                    Priority: Mandatory
Version : 5.2       SEQ #475                    Status: Released
                  Compliance Date: JAN 23, 2025
=============================================================================

Associated patches: (v)LR*5.2*571  <<= must be installed BEFORE `LR*5.2*576'

Subject: NLT/LOINC V2.78 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.77 which was released in 2024.
  The goal of this patch is to update the LAB LOINC file (#95.3) and related
  files to version 2.78
  
  
 Patch Components:
 =================
  
 Files & Fields Associated:
 ==========================
 File Name (Number)          Field Name (Number)       New/Modified/Deleted
 ------------------          -------------------       --------------------
  #95.3                         LAB LOINC                       Modified
  #95.31                        LAB LOINC COMPONENT             Modified
  #64                           WKLD CODE                       Modified
  #64.061                       LAB ELECTRONIC CODES            Modified
  #64.2                         WKLD SUFFIX CODES               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 #:
 ======================
 Salem: CHG0552101
 VISN 2: CHG0549240
  
  
 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_576.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^LR576
 The Post-installation routine/tag: POST^LR576
  
  
 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_LR576_DATA_FILE_BKUP_YYYYMMDD.GBL)
 4.      At the Parameters? Prompt, press <enter>.
 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_LR576_DATA_FILE_BKUP_20240508.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:
 LR576 : 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_576.KID
  
     3)  KIDS Installation:
  
         Install the patch using the KIDS Installation Menu action
         "Install Package(s)" and the install name LR*5.2*576
           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 LR576 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 <UNDEFINED> 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: LR576
    Before:       n/a   After:B113124033  **576**

=============================================================================
User Information:
Entered By  :                               Date Entered  : AUG 26, 2024
Completed By:                               Date Completed: DEC 23, 2024
Released By :                               Date Released : DEC 23, 2024
=============================================================================


Packman Mail Message:
=====================

No routines included
