$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Thursday, 09/03/20 at 12:16 ============================================================================= Run Date: SEP 17, 2020 Designation: HL*1.6*172 Package : HL - HEALTH LEVEL SEVEN Priority: EMERGENCY Version : 1.6 SEQ #136 Status: Released Compliance Date: SEP 19, 2020 ============================================================================= Associated patches: (v)HL*1.6*153 <<= must be installed BEFORE `HL*1.6*172' (v)HL*1.6*158 <<= must be installed BEFORE `HL*1.6*172' Subject: HL7 UPDATES FOR HL PING MENU OPTION AND ROUTINE UPDATES FOR IRIS Category: - Routine Description: ============ Health Level Seven (HL7) patch, HL*1.6*172, updates three HL7 routines and the HL PING [Ping (TCP Only)] menu option to check for an additional operating system. Patch Components: ----------------- Files & Fields Associated: N/A Forms Associated: N/A Mail Groups Associated: N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- HL PING [Ping (TCP Only)] Action Modified Protocols Associated: N/A Security Keys Associated: N/A Templates Associated: N/A Remote Procedures Associated: N/A Parameter Definitions Associated: N/A Additional Information: ----------------------- Blood Bank Team Coordination: EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch HL*1.6*172 contains changes to a package referenced in ProPath standard titled: BBM Team Review of VistA Patches. This patch does not alter or modify any VistA Blood Bank software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch HL*1.6*172 have no adverse effect on Blood Bank software functionality, therefore RISK is none. New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- INC12022076 - Update HL7 routines affected by IRIS update Problem: -------- The Interoperable, Reliable, Intuitive, and Scalable system (IRIS) will be replacing the CACHE operating system and currently the HL PING [Ping (TCP Only)] menu option only checks for CACHE as an operating system. To circumvent errors, this patch will ensure that the menu option will check for both CACHE and IRIS operating systems. Resolution: ----------- Routines HLOPING, HLOSTRAC, and HLOTRACE are being updated to check for the system version containing "IRIS". Also, ENTRY ACTION (#20) field in the OPTION (#8) file has been modified to check for the system version of "IRIS" in the menu option HL PING [Ping (TCP Only)]. Test Sites: ----------- Jack C. Montgomery VAMC (Muskogee, OK) Southeast Louisiana Veterans HCS (New Orleans, LA) Software and Documentation Retrieval Instructions: -------------------------------------------------- N/A Documentation Title File Name FTP Mode --------------------------------------------------------------------- N/A Host File Name FTP Mode --------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- 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 Note: VistA HL7 has received a SAC exemption for the use of $ZA and ZB in the 3 routines HLOPING, HLOSTRAC, and HLOTRACE. XINDEX will generate the following errors (multiple times): ZB: Non-standard (Undefined) 'Z' command $ZA: Non-standard $Z special variable used The above two "errors" can safely be ignored when running XINDEX for this patch. 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 . 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. When 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? YES//', answer YES a. When prompted 'Enter options you wish to mark as 'Out Of Order':', select the following option: Option Name Menu Text ----------- --------- HLO CLIENT TRACE CLIENT TRACE HLO SERVER TRACE SERVER TRACE HLO PING PING REMOTE SYSTEM HL PING Ping (TCP Only) Press the Enter key when you are done selecting options. b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Post-Installation Instructions: N/A Back-Out/Roll Back Plan: ------------------------ Due to the complexity of this patch, it is not recommended for back-out, and a restore from a backup of the Transport Global should not be attempted. In the event that a site decides to back out this patch, the site should contact the Enterprise Service Desk (ESD) to submit a help desk ticket. The development team will need to issue a follow-on patch in order to comprehensively back-out this patch and restore the system to a functioning state. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.6;HEALTH LEVEL SEVEN;**[Patch List]**;Oct 13, 1995;Build 11 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: HLOPING Before: B28571657 After: B28766493 **147,155,158,172** Routine Name: HLOSTRAC Before: B50796847 After: B50987857 **146,147,153,172** Routine Name: HLOTRACE Before: B73989818 After: B74157887 **146,147,153,172** Routine list of preceding patches: 153, 158 ============================================================================= User Information: Entered By : Date Entered : AUG 18, 2020 Completed By: Date Completed: SEP 17, 2020 Released By : Date Released : SEP 17, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT