$TXT Created by             KRNIRIS.FO-OAKLAND.DOMAIN.EXT  (KIDS) on Wednesday, 04/27/22 at 08:26
=============================================================================
Run Date: MAY 04, 2022                     Designation: XU*8*769
Package : XU - KERNEL                         Priority: Mandatory
Version : 8       SEQ #607                      Status: Released
                  Compliance Date: JUN 04, 2022
=============================================================================

Associated patches: (v)XU*8*735    <<= must be installed BEFORE `XU*8*769'

Subject: UPDATE [XUMF FORUM] HL LOGICAL LINK

Category: 
  - Other

Description:
============

  
  This patch updates the DNS DOMAIN field for the [XUMF FORUM] HL 
  LOGICAL LINK to be "HL7.FORUM.DOMAIN.EXT".
  
  FileMan Inquire looks like:
  
   Output from what File: OPTION// 870  HL LOGICAL LINK  (165 entries)
   Select HL LOGICAL LINK NODE:    XUMF FORUM
   Another one: 
   Standard Captioned Output? Yes// n  (No)
   First Print FIELD: DNS DOMAIN  
   Then Print FIELD: TCP/IP ADDRESS  
   Then Print FIELD: 
   Heading (S/C): HL LOGICAL LINK List  Replace 
   DEVICE:   TELNET PORT    Right Margin: 80// 
  
   HL LOGICAL LINK List                            MAR 03, 2022@05:19
   DNS DOMAIN
  
  
   TCP/IP ADDRESS
   ------------------------------------------------------------
  
   HL7.FORUM.DOMAIN.EXT
   127.0.0.1
  
  This patch, at the end of the installation process, also queries the 
  Institution Master File (IMF) to get the gold file of Institutions from
  the Forum account, and automatically updates the local INSTITUTION (#4)
  file.
  
  This patch also fixes an <UNDEFINED> ERROR on the Institution Master File
  (IMF) updated process.
   
 Patch Components:
 -----------------
  
 Files & Fields Associated:
  
 File Name (Number)             Field Name (Number)    New/Modified/Deleted
 ------------------             -------------------    --------------------
 N/A
  
 Forms Associated:
  
 Form Name               File #             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:
 -----------------------
  
 HL LOGICAL LINK NODE:    XUMF FORUM
 Updated the DNS DOMAIN
  
  
 Blood Bank Team Coordination
 ============================
 Blood Bank Clearance: 3/9/2022  
  
  EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch XU*8*769 contains 
  changes to a package referenced in VHA OI SEPG SOP 192-023 Review of 
  VISTA Patches for Effects on VISTA Blood Bank Software. 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 XU*8*769 have no 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:
 --------------------------------------------
 INC20482710 
  
  
 Problem:
 ----------
 The DNS DOMAIN field of the [XUMF FORUM] HL LOGICAL LINK is out of date. 
 It will cause error on the option [XUMF LOAD INSTITUTION].
  
  
 Resolution:
 -----------
  
 Updated the DNS DOMAIN field of the [XUMF FORUM] HL LOGICAL LINK to be 
 DNS DOMAIN: HL7.FORUM.DOMAIN.EXT
  
 Updated the routine XUMF04H to handle the <UNDEFINED> ERROR on 
 the Institution Master File (IMF) process.
  
 Test Sites:
 -----------
 - DETROIT, MI VAMC
 - NORTH TEXAS HCS
  
 Software and Documentation Retrieval Instructions:
 ---------------------------------------------------- 
 The software for this patch is being released as a KIDS Build.  There's no
 updated Documentation being released with this patch.
  
  
 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 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 XU*8*769
  
         NOTE: Using <spacebar><enter> 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. You must use this option and specify 
        what to backup; the entire Build or just Routines.
        The backup message can be used to restore the routines
        and components of the build to the pre-patch condition.
  
  
          i.  At the Installation option menu, select Backup 
              a Transport Global
          ii. At the Select INSTALL NAME prompt, enter your 
              build XU*8.0*769
          iii. When prompted for the following, enter "R" for 
               Routines or "B" for Build.
  
                Select one of the following:
  
                       B         Build
                       R         Routines
  
                 Enter response: Build
  
          iv.  When prompted "Do you wish to secure your build? 
               NO//", press <enter> and take the default response 
               of "NO".
          v.   When prompted with, "Send mail to: Last name, First 
               Name", press <enter> to take default recipient. Add 
               any additional recipients.
          vi.  When prompted with "Select basket to send to: IN//", 
               press <enter> and take the default IN mailbox or select 
               a different mailbox.
          vii. Repeat step ii for each build in the host file.
  
  
     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>.
  
  
 Post-Installation Instructions
 ------------------------------
 For PRODUCTION accounts only:
  
 1) Use FM Inquire to check the TCP/IP ADDESS of the [XUMF FORUM] LOGICAL 
 LINK. If it is "127.0.0.1", you may skip #2 and #3.
  
 2) Use the option Ping (TCP Only) [HL PING] to update the correct TCP/IP 
 ADDESS:
  
 Select HL7 Main Menu Option: Filer and Link Management Options
  
    SM     Systems Link Monitor
    FL     Monitor, Start, Stop Filers
    LM     TCP Link Manager Start/Stop
    SA     Stop All Messaging Background Processes
    RA     Restart/Start All Links and Filers
    DF     Default Filers Startup
    SL     Start/Stop Links
    PI     Ping (TCP Only)
    ED     Link Edit
    ER     Link Errors ...
  
 Select Filer and Link Management Options Option: Ping (TCP Only)
 What HL Logical Link do you want to test?
 Select a TCP link:XUMF FORUM  
 Do you want to PING the port used by HLO or the one used by HL7 1.6?
  
      Select one of the following:
  
           1         HLO     --> Port #5026
           2         HL7 1.6 --> Port #5000
  
 Enter response: 1// 2  HL7 1.6 --> Port #5000
 Trying to connect...
 Connected!
 Sending PING ...
 PING sent!
 Reading acknowledgment....
 Acknowledgment received!
  
  3) Run the option [XUMF LOAD INSTITUTION] to Update/refresh
 the INSTITUTION file:
  
 KRN>D ^XUP
  
 Setting up programmer environment
 This is a TEST account.
  
 Terminal Type set to: C-VT320
  
 Select OPTION NAME: XUMF LOAD INSTITUTION       Update/refresh 
 Institution file 
 with IMF data
 Update/refresh Institution file with IMF data
  
  
 Backout and Rollback Procedure:
 -------------------------------
  
 This patch updates the DNS DOMAIN field for the [XUMF FORUM] HL LOGICAL 
 LINK. To rollback/backout the patch, please log a SNOW ticket so the 
 development team can assist.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 5

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: XU8P769
    Before:       n/a   After:   B486398  **769**
Routine Name: XUMF04H
    Before: B59092326   After: B59155172  **549,678,698,723,735,769**
 
Routine list of preceding patches: 735

=============================================================================
User Information:
Entered By  :                               Date Entered  : MAR 01, 2022
Completed By:                               Date Completed: MAY 04, 2022
Released By :                               Date Released : MAY 04, 2022
=============================================================================


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

$END TXT