$TXT Created by BERTRAM,ZACHARY E at DEVVVV.DNS      URL          (KIDS) on Wednesday, 05/08/19 at 10:05
=============================================================================
Run Date: MAY 08, 2019                     Designation: SD*5.3*723
Package : SD - SCHEDULING                     Priority: EMERGENCY
Version : 5.3                                   Status: Under Development
=============================================================================

Associated patches: (u)SD*5.3*722  <<= must be installed BEFORE `SD*5.3*723'

Subject: FIX FOR APPTS WITH NO RESOURCE

Category: 
  - Routine
  - Print Template
  - Sort Template
  - Other

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

 This patch addresses a problem where the code that populated the Pending
 Appointments list could encounter a SUBSCRIPT error in a certain bad data
 scenario and cause the VistA Scheduling Graphical User Interface (VS GUI) to
 crash.
  
 This bad data is introduced when appointments are created in roll-and-scroll
 VistA Scheduling (not in VS GUI) for a clinic that does not have an entry in
 the ALOC cross-reference in the SDEC RESOURCE file (#409.831). This usually
 means that there is no matching resource for the clinic. In this case, the
 record in the SDEC APPOINTMENT file (#409.84) is created without a link to
 the SDEC RESOURCE file.
  
 In order to assist with identifying and correcting existing records with this
 bad data, new print and sort templates are included, as well as a utility that
 can be run interactively or automatically to link appointments to resources.
  
 In addition, a check has been added to the Make Appointment function in VistA 
 Scheduling so that a user will no longer be permitted to create an appointment 
 in a clinic with no linked resource.
  
  
 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:
  
                                                                   New/Modified/
 Option Name                                              Type       Deleted    
 -----------                                              ----     -------------
 AUTOMATICALLY FIX APPOINTMENTS WITH NO RESOURCE [SDEC NO RES APPT AUTO FIX]
                                                          Routine  NEW
 MANUALLY FIX APPOINTMENTS WITH NO RESOURCE [SDEC NO RES APPT FIX]
                                                          Routine  NEW
 SDEC MISSING RESOURCE [SDEC MISSING RESOURCE]            Print    NEW
 SDEC NULL RESOURCE [SDEC NULL RESOURCE]                  Print    NEW
 SUPERVISOR MENU [SDSUP]                                  Menu     MODIFIED
  
  
 Protocols Associated:
  
 Protocol Name    New/Modified/Deleted
 -------------    -------------------- 
 N/A
  
  
 Security Keys Associated:
  
 Security Key Name
 -----------------
 N/A
  
  
 Templates Associated:
  
                                                            New/Modified/
 Template Name          Type    File Name (Number)             Deleted 
 -------------          ----    ------------------          --------------
 SDEC MISSING RESOURCE  Print   HOSPITAL LOCATION (#44)     NEW
 SDEC MISSING RESOURCE  Sort    HOSPITAL LOCATION (#44)     NEW
 SDEC NULL RESOURCE     Print   SDEC APPOINTMENT (#409.84)  NEW
 SDEC NULL RESOURCE     Sort    SDEC APPOINTMENT (#409.84)  NEW
  
  
 Additional Information:
 N/A
  
  
 New Service Requests (NSRs):
 ----------------------------  
 N/A
  
  
 Patient Safety Issues (PSIs):
 -----------------------------
 N/A
  
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 1. RTC 997191 - SUBSCRIPT Error for Appointments with no Resource Pointer
  
 Problem:
 -------
 It is possible, when making an appointment via roll-and-scroll VistA
 Scheduling, to create an entry in the SDEC APPOINTMENT file (#409.84) that
 lacks a pointer to the SDEC RESOURCE file (#409.831). (This cannot occur when
 creating the appointment using VS GUI.) This scenario exists when there is no
 link between the clinic and the resource in the resource file's ALOC cross-
 reference. Once one of these appointments exists, VS GUI will return a
 SUBSCRIPT error when loading appointments for the Pending Appointments list
 after selecting a patient, causing the GUI to crash.
  
 Resolution:
 ----------
 The GUI will no longer crash in this instance, and "*CORRUPT DATA" will display
 in place of the name of the resource/clinic in the second column of the
 Pending Appointments list. If the appointment is corrected using the included
 utility, then the real clinic will appear instead of "*CORRUPT DATA".
  
 Test Sites:
 ----------
 North Texas
 Fayetteville, NC
 Philadelphia
  
  
 Software and Documentation Retrieval Instructions:
 ---------------------------------------------------- 
 Software being released as a host file and/or documentation describing 
 the new functionality introduced by this patch are available.
  
 The preferred method is to retrieve files from download.DNS.URL.
 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 File 
 Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the following 
 OI Field Offices:
  
 Hines:    DNS     .URL         
 Salt Lake City:    DNS.URL       
  
 Documentation can also be found on the VA Software Documentation Library at:
 http://URL            /
  
  
 Title                                          File Name          FTP Mode
 --------------------------------------------------------------------------
 VistA Scheduling Enhancements Technical Manual VSE_TM.PDF         Binary
  
 Patch Installation:
  
  
 Pre/Post Installation Overview:
 -------------------------------
 No pre- or post-installation steps are required.
  
  
 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 the patch number (ex. 
 SD*5.3*723):
 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 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
 choose the patch to install.
  
 5. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
 Install? YES//', respond YES.
  
 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//',
 respond NO.
  
 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
 Protocols? NO//', respond NO.
  
 8. If prompted 'Delay Install (Minutes):  (0 - 60): 0//' respond 0.
  
  
 Back-Out Plan:
 --------------------
 In order to back out this patch, restore the transport global that was saved
 in Step 3.a. of the installation. Delete the sort and print templates that
 were included in the patch, as well as the options besides SDSUP. Edit the
 SDSUP option to remove the new options.

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

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

Routine Name: SDEC50
    Before:B102324779   After:B168221413  **627,658,665,672,722,723**
Routine Name: SDECDATA
    Before:       n/a   After: B32998876  **723**
Routine Name: SDM
    Before: B36241723   After: B38764012  **15,32,38,41,44,79,94,167,168,
                                           218,223,250,254,296,380,478,
                                           441,619,723**
 
Routine list of preceding patches: 619, 722

=============================================================================
User Information:
Entered By  : CHAVE,WARREN                  Date Entered  : JAN 10, 2019
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


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