$TXT Created by G at CHY0016.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 02/06/25 at 15:42 ============================================================================= Run Date: FEB 27, 2025 Designation: SD*5.3*899 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #747 Status: Released Compliance Date: MAR 12, 2025 ============================================================================= Associated patches: (v)SD*5.3*881 <<= must be installed BEFORE `SD*5.3*899' (v)SD*5.3*898 <<= must be installed BEFORE `SD*5.3*899' Subject: SCHEDULING UPDATES TO SUPPORT FRONT END APPLICATIONS Category: - Routine - Enhancement (Mandatory) - Other Description: ============ VistA Scheduling (VS) patch SD*5.3*899 includes several defect corrections and enhancements to support the various front-end applications including: The SDES2CREATECLIN routine was updated to use the correct error return array name when login and error. The SDES2 EDIT CLINIC Remote Procedure Call (RPC) definitions was updated to include Display Increments Per Hour and Length of Appointment and the output definition elements for fully alphabetized to follow Scheduling standards. The logic supporting the Block and Move functionality was updated to log and error and exit gracefully when the required Clinic Internal Entry Number (IEN) was not passed in. The logic supporting the SDES2 CREATE APPT REQ RPC was updated to store both the date and time from the parent request in the DATE/TIME ENTERED (#9.5) field. Routine SDES2PATSEARCH was updated to set SEARCHSTRING to the first 30 characters of the search string if the length is greater than 30. Routine SDES2PATSEARCH was updated to remove any control characters in the search string. The input validation logic supporting the SDES2 CREATE CLINIC AVAIL RPC was updated to log and error and exit gracefully when the required input parameter Length of Appointment is not passed in. The new SDES2 GET DIVISION LIST RPC will return a list of divisions, given the search text provided. The division list comes from the MEDICAL CENTER DIVISION (#40.8) file. The SDES2SEARCHSLOTS routine was updated to kill the PARTIALSLOTS variable between clinic searches so that the return JavaScript Object Notation (JSON) object won't be adversely affected. The SDES2 PRINT APPT LETTER and SDES2 PRINT APPT LETTERS RPCs were updated to add the last name first initial to the letter prior to the last four Social Security Number (SSN). The SDBUILD option was updated to display the following message upon entering the option: "OPTION will be decommissioned starting December 2025. To transition, please use the Clinic Configuration Manager (CCM) website for all needs" Patch Components: ----------------- Files & Fields Associated: New/Modified/Deleted -------------------------- -------------------- File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- N/A Forms Associated: ----------------- Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: ----------------------- Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: ------------------- Option Name Type New/Modified/Deleted ----------- ---- -------------------- SDBUILD Run Routine Modified SDESRPC Broker Modified SDSUP Menu Modified Protocols Associated: --------------------- Protocol Name New/Modified/Deleted ------------- -------------------- Security Keys Associated: ------------------------- Security Key Name ----------------- N/A Templates Associated: --------------------- Template Name Type File Name (Number) New/Modified/Deleted ------------- ----------------------- -------------------- N/A Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES2 EDIT CLINIC Modified SDES2 GET DIVISION LIST New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-8975 - VistA: Modify SDES2CREATECLIN to correctly return an error when saving the clinic fails. Problem: Modify SDES2CREATECLIN to correctly return additional information in the error when saving the clinic fails. Resolution: The SDES2CREATECLIN routine was updated to use the correct error return array name when login and error. 2) VSE-9024 - VistA: Modify the RPC documentation for SDES2 EDIT CLINIC. Problem: Modify the RPC documentation for SDES2 EDIT CLINIC. Resolution: The SDES2 EDIT CLINIC Remote Procedure Call (RPC) definitions was updated to include Display Increments Per Hour and Length of Appointment and the output definition elements for fully alphabetized to follow Scheduling standards. 3) VSE-9042 - VistA: Blocking and moving without an appointment IEN is causing an error. Problem: Blocking and moving an appointment without an appointment IEN is causing an error. Resolution: The logic supporting the Block and Move functionality was updated to log and error and exit gracefully when the required Clinic IEN was not passed in. 4) VSE-9156 - VistA: Modify SDES2 CREATE APPT REQ to update the DATE/TIME ENTERED (field 9.5). Problem: Modify SDES2 CREATE APPT REQ to update the DATE/TIME ENTERED (field 9.5) with that date/time entered date from the parent. Resolution: The logic supporting the SDES2 CREATE APPT REQ RPC was updated to store both the date and time from the parent request in the DATE/TIME ENTERED (#9.5) field. 5) VSE-9281 - VistA: Long search strings are sometime erroneously sent in and causing a error. Problem: Long search strings are sometime erroneously sent in and causing a error. Add logic to extract 30 characters of the string and strip any control character. Resolution: Routine SDES2PATSEARCH was updated to set SEARCHSTRING to the first 30 characters of the search string if the length is greater than 30. Routine SDES2PATSEARCH was updated to remove any control characters in the search string. 6) VSE-9296: JJ - VistA: Modify SDES2 CREATE CLINIC AVAIL to quit error and quit out if length of appointment is missing. Problem: When the SDES2 CREATE CLINIC AVAIL RPC is called without a Length of appointment, the code will hard error out. Resolution: The input validation logic supporting the SDES2 CREATE CLINIC AVAIL RPC was updated to log and error and exit gracefully when the required input parameter Length of Appointment is not passed in. 7) VSE-9340: VistA: Create SDES2 version of SDES GET DIVISION LIST Problem: Create SDES2 version of SDES GET DIVISION LIST so that Clinic Configuration Manager (CCM) can get a list of divisions that will be presented to the user when remapping a clinic. Resolution: The new SDES2 GET DIVISION LIST RPC will return a list of divisions, given the search text provided. The division list comes from the MEDICAL CENTER DIVISION (#40.8) file. 8) VSE-9348: VistA: When multiple clinics are searched the results are including incomplete results from the previous clinic. Problem: An issue was found when multiple clinics are searched the results are including incomplete results from the previous clinic. Resolution: The SDES2SEARCHSLOTS routine was updated to kill the PARTIALSLOTS variable between clinic searches so that the return JavaScript Object Notation (JSON) object won't be adversely affected. 9) VSE-9349: VistA: Last name initial missing from letter. Problem: During testing SDES2 PRINT APPT LETTER and SDES2 PRINT APPT LETTERS it was discovered that the last name initial was missing from before the last four of the Social Security Number. Resolution: The SDES2 PRINT APPT LETTER and SDES2 PRINT APPT LETTERS RPCs were updated to add the last name first initial to the letter prior to the last four Social Security Number (SSN). 10) VSE-9364: VistA: Banner for decommissioning Set Up A Clinic option. Problem: Need to update the Set Up a Clinic OPTION with a decommissioning message. Resolution: The SDBUILD option was updated to display the following message upon entering the option: "OPTION will be decommissioned starting December 2025. To transition, please use the Clinic Configuration Manager (CCM) website for all needs" Test Sites: ----------- El Paso, TX (ELP) Lebanon, PA (LEB) Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software is distributed by PackMan message. Other Software Files: This release also includes documentation and other software files. They can be obtained at: https://download.vista.domain.ext/index.html/SOFTWARE/ Documentation Title File Name FTP Mode -------------------------------------------------------------------------- PIMS Technical Manual SD_PIMS_TM Binary Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/ Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- N/A Pre-Installation Instructions: ------------------------------ N/A Setup/Configuration 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. 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the KIDS Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME, enter SD*5.3*899. a. Backup a Transport Global - This option will create a backup message of any components exported with this patch. You are prompted to select "R" for Routines or "B" for Build. For this patch, backing up the "B"uild is suggested. Select one of the following: B Build R Routines Enter response: Build 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 SD*5.3*899. 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 Back-Out Plan/Roll Back Plan: ----------------------------- 1. Load the Backup MailMan Message a. Go into MailMan and find the backup message created in step 3a of the installation process and read that message. b. At the "Type to continue or '^' to exit:" prompt enter ^ to get to the command prompt. c. At the command prompt enter X for eXtract and press enter. d. At the "Select PackMan function:" prompt enter 6 for INSTALL/CHECK MESSAGE and press enter. e. At the "OK to Continue with Load? NO//" prompt, type YES and press enter. f. At the "Want to Continue with Load? YES//" prompt, press enter. g. Exit MailMan. 2. Go Into the Kernel Installation & Distribution System (KIDS) and load and install the backup like you would a regular patch. a. Enter D ^XUP at the command prompt. b. At the "Select OPTION NAME:" prompt, enter Kernel Installation & Distribution System" and press enter. c. From the main KIDS menu, select the Installation ... option. d. From the Installation ... option, select 6 Install Package(s). e. At the "Select INSTALL NAME:" prompt enter SD*5.3*899b. f. If prompted for "Want KIDS to INHIBIT LOGONs during the install? NO//" take the default by pressing enter. g. If prompted for "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" take the default by pressing enter. h. At the DEVICE: prompt, enter the output device of your choice. i. Verify that the SD*5.3*899b backup installs without any issues. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 2 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDES2APTLETTER Before:B124618249 After:B128238899 **895,898,899** Routine Name: SDES2BLOCKANDMOV Before: B84200869 After: B85914002 **875,880,889,895,897,898,899** Routine Name: SDES2CREATECLIN Before: B70688883 After: B71631320 **853,860,871,885,893,895,899** Routine Name: SDES2CRTAPREQ Before:B222236517 After:B224592683 **869,871,875,877,893,895,897,899** Routine Name: SDES2CRTCLNAVAIL Before:B144990183 After:B145167971 **890,897,899** Routine Name: SDES2GETDIVLIST Before: n/a After: B17179790 **899** Routine Name: SDES2PATSEARCH Before:B108492622 After:B110731856 **864,866,881,899** Routine Name: SDES2SEARCHSLOTS Before: B92418510 After: B92499373 **897,899** Routine list of preceding patches: 881, 898 ============================================================================= User Information: Entered By : Date Entered : DEC 05, 2024 Completed By: Date Completed: FEB 27, 2025 Released By : Date Released : FEB 27, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT