VistA Patch Display                                                   Page: 1
=============================================================================
Run Date: DEC 15, 2016                      Designation: XU*8*680  TEST v1
Package : KERNEL                            Priority   : MANDATORY
Version : 8                                 Status     : UNDER DEVELOPMENT
=============================================================================

Subject:  JSON UTILITY

Category:  ROUTINE
           ENHANCEMENT

Description:
===========
 
Patch XU*8.0*680 is designed to copy JSON processing from the Virtual Patient 
Record (VPR) namespace to the Kernel namespace to make the functionality 
avaliable to all applications.
  
This includes four functions for converting between JSON and STRINGS/ARRAYS.
  
     1. DECODE^XLFJSON(XUJSON,XUROOT,XUERR) - Set JSON object into closed 
                                              array ref XUROOT
                                                
     2. ENCODE^XLFJSON(XUROOT,XUJSON,XUERR) - XUROOT (M structure) --> XUJSON
                                              (array of strings)
                                              
     3. $$ESC^XLFJSON(X) - Escape string for JSON
     
     4. $$UES^XLFJSON(X) - Unescape JSON string
   
   
Patch Components:
-----------------
  
Files & Fields Associated:
  
                                                             New/Modified/
File Name (#)              Field Name (#)                       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
  
   
Additional Information:
-----------------------
N/A
  
   
New Service Requests (NSRs):
----------------------------  
N/A
  
   
Patient Safety Issues (PSIs):
-----------------------------
N/A
  
   
Defect Tracking System Ticket(s) & Overview:
--------------------------------------------
N/A
  
   
Blood Bank Clearance:
---------------------
TBD 
   
   
Test Sites:
-----------
TDB
  
  
Software and Documentation Retrieval Instructions:
-------------------------------------------------- 
Documentation describing the new functionality introduced by this patch
is available.
   
The preferred method is to retrieve files from download.DNS      .DNS   .
This transmits the files from the first available server. Sites may 
also elect to retrieve files directly from a specific server. 
Sites may retrieve the software and/or documentation directly using 
Secure Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory 
at the following OI Field Offices:
   
Albany:                 fo-albany.URL       
Hines:                  DNS     .URL           
Salt Lake City:         fo-slc.URL       
   
Documentation can also be found on the VA Software Documentation Library 
at: http://www.DNS   /vdl/ 
   
Title                                File Name          SFTP Mode
-----------------------------------------------------------------
Kernel 8.0 & Kernel Tookkit 7.3     KRN8_0DG.PDF        Binary
   
  
Backout and Rollback Procedure:
-------------------------------
This patch consists of three new individual routines. During the VistA
Installation Procedure of the KIDS build, the installer should back
up the modified routines by the use of the 'Backup a Transport Global'
action (step 3a in the Installations Instructions below).
  
If rollback/backout is required, the installer can restore the routines
using the MailMan message that were saved prior to installing the
patch.
    
   
Patch Installation:
   
Pre/Post Installation Overview:
-------------------------------
There are no pre or post install routines in this patch.
   
   
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.
  
No options or protocols need to be disabled to install this patch.
  
The installation of this patch can be queued.
   
  
Installation Instructions:
--------------------------
1.  Choose the PackMan message containing this patch.
  
2.  Choose the INSTALL/CHECK MESSAGE PackMan option.
  
3.  From the Kernel Installation and Distribution System Menu, select
    the Installation Menu. From this menu, you may elect to use the
    following options. When prompted for the INSTALL NAME enter 
    XU*8.0*680.
    a.  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 Data Dictionaries (DDs) or
        templates.
    b.  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, DDs, templates, etc.).
    c.  Verify Checksums in Transport Global - This option will allow
        you to ensure the integrity of the routines that are in the
        transport global.
  
4.  From the Installation Menu, select the Install Package(s) option and
    When prompted for the INSTALL NAME, enter XU*8.0*680.
  
5.  If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
    Install? NO//' respond NO.
  
6.  When prompted "Want KIDS to INHIBIT LOGONs during the install?
    NO//" respond NO.
  
7.  If prompted "Want to DISABLE Scheduled Options, Menu Options, 
    and Protocols? NO//" respond NO. 
   
8.  If prompted "Delay Install (Minutes): (0 - 60): 0//" respond 0.
  
   
Post-Installation Instructions:
-------------------------------
N/A  


Routine Information:
====================


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

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

Routine Name: XLFJSON
    Before:       n/a   After: B12212651  **680**
Routine Name: XLFJSOND
    Before:       n/a   After: B72001822  **680**
Routine Name: XLFJSONE
    Before:       n/a   After: B24814820  **680**


=============================================================================
User Information:  
  Entered By  :   DIMICELI,RON         Date Entered  :   OCT 24,2016
  Completed By:                        Date Completed:   
  Released By :                        Date Released :   
=============================================================================