$TXT Created by T at DEVVSB.DOMAIN.EXT (KIDS) on Wednesday, 01/22/20 at 09:37 ============================================================================= Run Date: MAR 09, 2020 Designation: SD*5.3*737 Package : SD - SCHEDULING Priority: EMERGENCY Version : 5.3 SEQ #599 Status: Released Compliance Date: MAR 19, 2020 ============================================================================= Associated patches: (v)SD*5.3*686 <<= must be installed BEFORE `SD*5.3*737' (v)SD*5.3*723 <<= must be installed BEFORE `SD*5.3*737' Subject: PENDING APPOINTMENTS LIST - CHECK-IN DISPLAY Category: - Routine Description: ============ This patch addresses issues that VistA Scheduling (VS) Graphical User Interface (GUI) experiences due to software incompatibilities with Veterans Point of Service (VPS) Kiosks, Cancel Clinic Availability (SDCANCEL option) and with missing data from appointments made by applications other than VS GUI. When an appointment is checked in using a VPS Kiosk, the underlying software updates the appropriate fields in the HOSPITAL LOCATION file (#44) but not in the SDEC APPOINTMENT file (#409.84). VPS Kiosk software was written before VS GUI but was not retrofitted. The SDEC FAPPTGET Remote Procedure Call (RPC) which populates the Pending Appointments List was modified to perform additional data checks in the HOSPITAL LOCATION file (#44) file so that this incompatibility is masked to the user. When SDCANCEL cancels appointments before blocking the clinic schedule, it marks the appointment cancelled in the PATIENT file (#2) and in the HOSPITAL LOCATION file (#44) but does not update the SDEC APPOINTMENT file (#409.84). Other cancellation processes also fail to update the status in the SDEC APPOINTMENT file (#409.84). Accordingly, the SDEC FAPPTGET RPC which populates the Pending Appointments List was modified to perform additional data checks in the PATIENT (#2) file so that this incompatibility is masked to the user. A new List Appointments and Encounters by status [SDEC APPT-ENC STATUS LIST] option was added for sites to identify future appointments with the wrong status caused by the SDCANCEL error. Once the incorrect status is identified, the sites can fix these appointments proactively. An appointment made by a scheduling application other than VS GUI sometimes files data in the SDEC APPOINTMENT file (#409.84) that is missing Appointment Type. When VS GUI encounters such an appointment while producing the Pending Appointments list, it generates a subscript error. The SDEC FAPPTGET RPC was modified to substitute REGULAR when it encounters a null Appointment Type data field. Patch SD*5.3*740, TSTART/TCOMMIT/TROLLBACK CORRECTIONS, exposed a subscript error in the scheduling consult edit routine (SDCNSLT). Under some conditions and by scheduling application unknown, the HOSPITAL LOCATION file (#44) pointer parameter is passed in null. This results in subscript errors. SDCNSLT was modified so that it does not fail under this data condition. 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: Option Name Type New/Modified/ Deleted ----------- ---- ------------- List Appointments and Encounters by status [SDEC APPT-ENC STATUS LIST] Routine 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 ------------- ---- ------------------ ------------- Additional Information: N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1. RTC 1177717 Problem: ------- During patch SD*5.3*722, Large Background Job Fix, and SD*5.3*723, Fix for Appointments with No Resource, Initial Operating Capacity (IOC) testing at Minneapolis, schedulers noticed that appointments checked in using a VPS Kiosk showed as NO ACTION TAKEN in the Pending Appointments List. It was determined that the VPS Kiosk software updates the HOSPITAL LOCATION file (#44) but not the SDEC APPOINTMENT file (#409.84). Resolution: ---------- The routine that generates the data used by VS GUI to populate the Pending Appointments List was modified to check the HOSPITAL LOCATION file (#44) for check-in date/time. 2. RTC 1177719 Problem: ------- During patch SD*5.3*722 and SD*5.3*723 IOC testing at Minneapolis, schedulers noticed that appointments cancelled using the cancel clinic availability option (SDCANCEL) were showing as NO ACTION TAKEN or FUTURE in the Pending Appointments List. It was determined that SDCANCEL updates the PATIENT file (#2) but not the SDEC APPOINTMENT file (#409.84). Resolution: ---------- The routine that generates the data used by VS GUI to populate the Pending Appointments List was modified to check the PATIENT file (#2) for appointment cancellations. 3. INC8375420, INC8344843 - Subscript error Problem: ------- Following installation of patches SD*5.3*722 and SD*5.3*723, two sites received subscript errors when loading the Pending Appointments list for a patient. Analysis determined that a scheduling application calling the make appointment Application Programming Interface (API) code at the secondary entry point SDECADD may pass in a null appointment type. This cannot occur if the API is called at the main entry point (APPADD). Resolution: ---------- The routine that generates the data used by VS GUI to populate the Pending Appointments List was modified to substitute REGULAR if the appointment type field is null. 4. Incorrect Status Report Problem: -------- There is currently no systematic report that can be used to identify Appointments with incorrect status. Resolution: ---------- Create a report that will identify Appointments with incorrect status. ========================================================================== Test Sites: ---------- Minneapolis, MN Fayetteville, AR Software and Documentation Retrieval Instructions: ---------------------------------------------------- Documentation describing the new functionality and/or a host file containing a build may be included in this release. Sites may retrieve the software and/or documentation directly using Secure File Transfer Protocol (SFTP) from the DOWNLOAD.VISTA.DOMAIN.EXT. Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ Documentation Title File Name FTP Mode ----------------------------------------------------------------------- VistA Scheduling Enhancements VSE_VA_GUI_1_6_User_Guide.PDF Binary GUI User Guide Patch Installation: Pre/Post Installation Overview: ------------------------------- 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 plus the time required to rebuild the menu trees. 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*737): 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. Backout Plan: -------------------- In order to back out this patch, restore the transport global that was saved in Step 3.a. of the installation. Edit the SDSUP option to remove the new option (SDEC APPT-ENC STATUS LIST) from its list of items. Next, delete the SDEC APPT-ENC STATUS LIST option. Finally, delete the following routines: SDECSTSQ, SDECSTSR. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 13 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDCNSLT Before: B45406127 After: B47180500 **478,496,630,627,686,737** Routine Name: SDEC50 Before:B165813690 After:B169535547 **627,658,665,672,722,723,737** Routine Name: SDECSTSQ Before: n/a After: B35405698 **737** Routine Name: SDECSTSR Before: n/a After: B57183153 **737** Routine list of preceding patches: 686, 723 ============================================================================= User Information: Entered By : Date Entered : NOV 01, 2019 Completed By: Date Completed: MAR 09, 2020 Released By : Date Released : MAR 09, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT