$TXT Created by DIMICELI,RON at NXT.FO-OAKLAND.MED.VA.GOV  (KIDS) on Monday, 04/21/08 at 09:45
=============================================================================
Run Date: SEP 30, 2008                     Designation: XU*8*491
Package : XU - KERNEL                         Priority: Mandatory
Version : 8       SEQ #406                      Status: Released
                  Compliance Date: OCT 31, 2008
=============================================================================


Subject: API to return date/time patch installed

Category: 
  - Routine
  - Enhancement (Mandatory)

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

 This patch adds a new API to the routine XPDUTL. This enhancement was
  requested by the GMRV developers to help them repair some records that
  were corrupted after a patch was installed.
  
 The extrinsic function, INSTALDT is used to populate the RESULT array with a
  list of install date/times for a given INSTALL name. The function will return
  the number of records in the RESULT array.
  
  $$INSTALDT^XPDUTL(INSTALL, .RESULT) returns the number of records in the
   passed by reference RESULT array.
   Input: INSTALL = name of install in the INSTALL file, 9.7
          RESULT = variable passed by reference
   Output: number of records in the RESULT array
           RESULT = number of records
           RESULT(internal date/time) = TEST# ^ SEQ#
  
 Example:
 =======
 1.      Install a patch using the KIDS options.
 2.      Enter programmer mode.
 3.      At the programmer prompt, enter the following M code:
  
 ISC>W $$INSTALDT^XPDUTL("XU*8.0*491",.RESULT)
 3
 ISC>ZW RESULT 
 RESULT=3
 RESULT(3080417.124045)="2^"
 RESULT(3080421.150338)=""
 RESULT(3080924.113524)="6^"
 ISC>
  
 Remedy Ticket
 =============
  236456
  
 Thanks to Test Sites:
 =====================
 Oklahoma City VAMC
 Connecticut HCS
 Central TX HCS
  
  
 Documentation Changes
 =====================
 See the updated API information at:
 http://vaww.vista.med.va.gov/kernel/apis/index.shtml
  
 Kernel Developer's Guide will also be updated in future. 
  
 Blood Bank Clearance
 ====================
 Clearance - 3/17/2008
 EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch XU*8*491 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 sofware design safeguards or safety critical elements
  functions.
  
  RISK ANALYSIS: Changes made by patch XU*8*491 have no effect on Blood Bank
  software functionality, therefore RISK is none.
  
  
  
 Installation Instructions
 =========================
 This patch may be installed with VISTA users online.  However, it is 
 recommended that it be Queued for a time of generally least activity.  
  
 TaskMan does not need to be STOPPED or placed in a WAIT state and 
 installation should take less than a minute.
  
     1. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu.  
        This option will load the KIDS package onto your system.  
  
     2. The patch has now been loaded into a transport global on your 
        system. You now need to use KIDS to install the transport global.  
   
     3. On the KIDS menu, under the 'Installation' menu, use the 
        following options: 
            Print Transport Global 
            Compare Transport Global to Current System 
            Verify Checksums in Transport Global
            Backup a Transport Global 
  
     4. On the KIDS menu, under the 'Installation' menu, use the 
        following option: 
            Select Installation Option: Install Package(s) 
            Select INSTALL NAME: XU*8.0*491
                                 ==========
        Want KIDS to INHIBIT LOGONs during the install? NO//
        Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//

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

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

Routine Name: XPDUTL
    Before: B19386445   After: B22402525  **21,28,39,81,100,108,137,181,
                                           275,491**
 
Routine list of preceding patches: 275

=============================================================================
User Information:
Entered By  : DIMICELI,RON                  Date Entered  : MAR 12, 2008
Completed By: SINGH,GURBIR                  Date Completed: SEP 25, 2008
Released By : TILLIS,LEWIS                  Date Released : SEP 30, 2008
=============================================================================


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

$END TXT