$TXT Created by PANNELL,BRIAN at MNTVBB.FO-ALBANY.MED.VA.GOV  (KIDS) on Thursday, 04/01/10 at 08:06
=============================================================================
Run Date: OCT 18, 2010                     Designation: DG*5.3*823
Package : DG - REGISTRATION                   Priority: Mandatory
Version : 5.3       SEQ #733                    Status: Released
                  Compliance Date: NOV 18, 2010
=============================================================================

Associated patches: (v)DG*5.3*621  <<= must be installed BEFORE `DG*5.3*823'

Subject: VISTA PIMS API

Category: 
  - Routine

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

 This patch is to fix an error with the software logic in two Vista PIMS
 Application Programming Interfaces (APIs) where the wrong string of data
 is returned. The problem could be passed on to any package that calls 
 Registration and would result in either extra, unneeded or no data.
   
 Associated Remedy ticket(s):
 ============================
 HD0000000363619     Vista PIMS VAFHLPV1 APIs
  
     
 Associated NSR(s):
 ==================
 N/A
   
  
 Associated Test Sites:
 ======================
 ALEXANDRIA, LA
 NEW YORK HCS
  
   
 REMEDY OVERVIEW:
 ================ 
 HD0000000363619     Vista PIMS VAFHLPV1 APIs
  
   
 Problem: 
 --------
 The logic for the software code in the Vista PIMS EN and DGBUILD APIs
 is incorrect as it does not account for an input string that is entered
 incorrectly.  In order for the software to return the correct string of
 data the input string must be preceded by a ",".  
  
 The EN API is used by packages outside of Registration (DG) to return
 Health Level 7 (HL7) messages about a certain patient.  The DGBUILD APT is
 an internal DG call that returns information about a patient with a 
 deleted admission.  
  
 The problem with the logic is that the data being relayed back to the 
 calling routine could contain extra, unneeded or no data for a patient. 
  
    
 Resolution:
 -----------
 A check was created in the software to ensure that the inputted string is
 formatted correctly for the logic that is used.  The software for 
 both APIs was changed to be the same format, eliminating the chance for
 errors due to a bad input string.  
  
   
 INSTALLATION INSTRUCTIONS:
 =========================
 It is not necessary to disable any options.  You may install this patch at
 any time without interruption to users.  It should take less
 than 2 minutes to install this patch.
  
    1. Choose the PackMan message containing this patch and invoke the
       INSTALL/CHECK MESSAGE PackMan option.  
   
    2. From the Kernel Installation & Distribution System menu, select 
       the Installation menu.  
   
    3. From this menu, you may select to use the following options: 
       (when prompted for INSTALL NAME, enter DG*5.3*823)
   
         a.  Verify Checksums in Transport Global - This option will allow
             you to ensure the integrity of the routines that are in the
             transport global.
         b.  Print Transport Global - This option will allow you to view
             the components of the KIDS build.
         c.  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 components of this patch
             (routines, DD's, templates, etc.).
         d.  Backup a Transport Global - This option will create a backup
             message of any routines exported with this patch. It will not
             backup any other changes such as DD's or templates.
   
    4. Use the Install Package(s) option and select the package DG*5.3*823.
  
    5. When Prompted "Want KIDS to INHIBIT LOGONs during the install? 
       NO//" respond NO.  
   
    6. When Prompted "Want to DISABLE Scheduled Options, Menu Options, and 
       Protocols? NO//" respond NO.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 6

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

Routine Name: VAFHAPV1
    Before: B80986421   After: B86007604  **91,209,190,298,494,621,823**
 
Routine list of preceding patches: 621

=============================================================================
User Information:
Entered By  : PANNELL,BRIAN                 Date Entered  : JAN 11, 2010
Completed By: LANG,MICKEY                   Date Completed: OCT 06, 2010
Released By : DANE,SIDNEY                   Date Released : OCT 18, 2010
=============================================================================


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

$END TXT