$TXT Created by CHAN,ALAN at NXT.KERNEL.FO-OAKLAND.MED.VA.GOV  (KIDS) on Friday, 08/25/06 at 14:39
=============================================================================
Run Date: OCT 26, 2006                     Designation: XU*8*430
Package : XU - KERNEL                         Priority: Mandatory
Version : 8       SEQ #353                      Status: Released
                  Compliance Date: NOV 26, 2006
=============================================================================

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

Subject: RETURN VALUE FOR ADMINISTRATIVE PARENT (KAAJEE)

Category: 
  - Routine

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

  
  
  Patch Tracking #: FORUM message #44029086
                    with subject titled 'Patch Tracking Message XU*8.0*430'
  
  Test sites: New Jersey HCS, Tampa VAMC, Chicago HCS, Pittsburgh HCS 
  
  Blood Bank Clearance: 9/18/2006
  
  Related Remedy Tickets:
  
  HD0000000156299
  HD0000000158112
  HD0000000160131
  
  
  HealtheVet VistA applications that use KAAJEE for Authentication
  will encounter an error when a user attempts to login.
  This only happens when the Administrative Parent associated with
  the current login station has no station number defined
  in the Institution file (#4).
  
  As part of the login process via KAAJEE, the XUS KAAJEE GET USER INFO
  Remote Procedure is invoked to return user demographic information.
  When this information is returned to KAAJEE on the Java side,
  KAAJEE can encounter an error as it attempts to parse the data.
  An example of this situation occurs when an Administrative Parent has no
  station number defined.  This causes an empty string to be passed to
  KAAJEE and in turn causes KAAJEE to skip to the next data element.  This
  causes the user demographic data to shift resulting in an error due
  to misaligned data.
  
  Part one of this fix is addressed by this patch.  This patch will return
  an '^' for the Administrative Parent station number whenever it is not 
  defined.  This will prevent the Java-side code of KAAJEE from skipping.
  
  Part two of this fix will be addressed later by a Java-side patch to 
  KAAJEE to convert this '^' back to an empty string.
  
  
  
 Required Builds: 
 ================
  XU*8.0*329 
   
  
 Installation Instructions: 
 ==========================
  
  Install Time   less than 5 minutes.
  
      1.   Users ARE allowed to be on the system during the 
      installation.  However, it is recommended that you install
      at a time when most users are off the system.
      You DO NOT need to stop TaskMan.  
   
      2.   Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. 
      This option will load the KIDS (Kernel Installation and Distribution 
      System) package onto your system.  
     
      3.   The patch has now been loaded into a transport global on your 
      system.  On the KIDS menu, select the 'Installation' menu and use 
      the following options: 
            2 Verify Checksums in Transport Global 
            3 Print Transport Global 
            4 Compare Transport Global to Current System 
            5 Backup a Transport Global 
            6 Install Package(s) 
  
            Select KIDS OPTION: Install 
                                =======
             Install Package(s) 
             Select INSTALL NAME: XU*8.0*430
                                  =========
  
        Logons DO NOT need to be inhibited.  
        No Options or Protocols need to be placed out-of-order.  
  
        Want KIDS to INHIBIT LOGONs during the install? YES// NO 
                                                              ==
        Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO 
                                                                        ==
  
 Routine Summary: 
 ================
  
  The following routines are included in this patch.  The second line of each of
  these routines now looks like: 
  
      <tab>;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995 
  
 Checksums: 
 ==========
  
  Checksums shown are OLD Checksums
  The following routines are included in this patch.  The second line of each
  of these routines now looks like:
   ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995
  
                   Checksums
  Routine         Old         New      Patch List
  XUSKAAJ       3624100     3601991    **329,430**
  
  Sites should use CHECK^XTSUMBLD to verify checksums.
  
   List of preceding patches: 329

Routine Information:
====================
The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: XUSKAAJ
    Before: B11494891  After: B11629985  **329,430**

=============================================================================
User Information:
Entered By  : CHAN,ALAN                     Date Entered  : AUG 24, 2006
Completed By: ALDERMAN,MATT S               Date Completed: OCT 25, 2006
Released By : TILLIS,LEWIS                  Date Released : OCT 26, 2006
=============================================================================


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

$END TXT