$TXT Created by at CHY0077.FO-BAYPINES.DOMAIN.EXT (KIDS) on Tuesday, 06/16/26 at 14:59 ============================================================================= Run Date: JUL 09, 2026 Designation: SD*5.3*947 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #793 Status: Released Compliance Date: JUL 23, 2026 ============================================================================= Associated patches: (v)SD*5.3*945 <<= must be installed BEFORE `SD*5.3*947' Subject: SCHEDULING UPDATES TO SUPPORT FRONT END APPS - SPRINT 16.1 Category: - Routine - Enhancement (Mandatory) - Other Description: ============ ************************************************************************** * This patch should be queued to be installed during off hours to * * minimize errors being logged as users actively call the Remote * * Procedure Calls (RPC) being updated by the patch. * * * * This patch should NOT be installed or queued to be installed * * during the installation of any other Scheduling patch. * ************************************************************************** VistA Scheduling (VS) patch SD*5.3*947 includes several defect corrections and enhancements including: Modified SDES2 UNDO NO-SHOW to return the full appointment object. Modified SDES2 CHECKIN to return the full appointment object. Modified Update SDES2 GET CLINIC AVAIL BY SVC to return back all clinics with the primary stop code when only the primary stop code is sent in regardless of credit stop on clinic. Modified SDES2 CREATE CLINIC AVAIL 2 to keep cancelled slots and the reason. Modified SDES2 CREATE CLINIC AVAIL 2 to return message if it cannot delete indefinite availability. This Should return back the date that it deleted. Created SDES2 GET SUMMS BY PATIENT DFN RPC to only return the ApptSummary object. Created SDES2BLDSUMMOBJ to only return an ApptSummary object, and not the full Appointment object. Modified the SDES2CANCLNAVAIL routine within tag CANCELAPPTS to take both the Partial day call and the full day call of EN^SDTMPHLC outside of the loop so that the call only happens once per cancelation. Modified SDES2 UNDO CHECKOUT to return a successful undo checkout occurs an "Appointment" object is sent as the return. EHRM Impact Statement: ---------------------- This patch should have no EHRM impact, and can be installed at all sites, including EHRM converted sites. Patch Components: New/Modified/Deleted ----------------- -------------------- 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 ----------- ---- -------------------- SDESRPC Broker (Client/Server) Modified 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 Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDES2 GET SUMMS BY PATIENT DFN (NEW) SDES2 CHECKIN (MODIFIED) SDES2 UNDO NO-SHOW (MODIFIED) SDES2 CREATE CLINIC AVAIL 2 (MODIFIED) Parameter Definitions Associated: --------------------------------- N/A Additional Information: ----------------------- N/A New Service Requests (NSRs): N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- 1) VSE-11423: VistA: Return back appointment object - SDES2 UNDO NO-SHOW. Problem: To help improve VSA performance, this RPC was identified as needing a full appointment object on SDES2 UNDO NO-SHOW. Resolution: Modified SDES2 UNDO NO-SHOW to return the full appointment object. 2) VSE-11428: VistA: Return back appointment object - SDES2 CHECKIN. Problem: To help improve VSA performance, this RPC was identified as needing a full appointment object on SDES2 CHECKIN. Resolution: Modified SDES2 CHECKIN to return the full appointment object. 3) VSE-11732: VistA: Include secondary stop code in availability search. Problem: Update CCST VistA availability search to return availability from clinics based on match of primary stop code, including results with a secondary stop code. Currently, search parameters include primary stop code only and results are limited to clinics that match exactly to the primary stop code with no secondary stop code. So, if a user searches by 323, results include availability for clinics with primary stop code 323 and no secondary stop code and exclude clinics with primary stop code 323 plus any secondary stop code. Resolution: Modified Update SDES2 GET CLINIC AVAIL BY SVC to return back all clinics with the primary stop code when only the primary stop code is sent in regardless of credit stop on clinic. 4) VSE-11793: VistA: Modify SDES2 CREATE CLINIC AVAIL 2 to keep cancelled slots and the reason. Problem: Currently when new timeslots are created and the user opts to Keep cancelled timeslots, the remarks for the cancelled timeslots are removed, thus showing "No Comments given" when remarks are blanked out. Resolution: Modified SDES2 CREATE CLINIC AVAIL 2 to keep cancelled slots and the reason. 5) VSE-11794: VistA: Return a message if indefinite availability cannot be deleted. Problem: Return a message if indefinite availability cannot be deleted. Resolution: Modified SDES2 CREATE CLINIC AVAIL 2 to return message if it cannot delete indefinite availability. This Should return back the date that it deleted. 6) VSE-12087: VistA: Create new version of SDES2 GET APPTS BY PAT DFN2 (including SDES2BLD* routines) that will return a condensed summary version of the Appointment object. Problem: For the SDES2 GET APPTS BY PAT DFN2 RPC, create a new version of the driver routine (currently SDES2GETAPPTRPCS) and supporting SDES2BLD* routines (can be condensed into a single routine, like SDES2BLDAPPTSUMM) that will only return a small subset of the Appointment object, containing only the fields required by ISS for the basic Patient Appt Page display fields, which should have a different object name, such as "ApptSummary". Resolution: Created SDES2 GET SUMMS BY PATIENT DFN RPC to only return the ApptSummary object. Created SDES2BLDSUMMOBJ to only return an ApptSummary object, and not the full Appointment object. 7) VSE-12114: VistA: Clinic Availability Cancellation Sends Duplicate TMP Records. Problem: When cancelling availability for a clinic the call to the TMP routine is erroneously in a loop so it sends a record for each appointment cancelled saying that the clinic was deleted for that day or that time frame. Resolution: Modified the SDES2CANCLNAVAIL routine within tag CANCELAPPTS to take both the Partial day call and the full day call of EN^SDTMPHLC outside of the loop so that the call only happens once per cancelation. 8) VSE-12129: VistA: Update SDES2UNDOCHKOUT to correctly build the appointment object Problem: During Acheron testing it was discovered that appointment object is being built into a return object of "1". This is due to calling the SDES2GETAPPTRPC at the RPC level. This logic needs to be modified to use SDES2BLDAPPTOBJ instead so that the return back from the get appointment logic is in an array before the JSON is built. Resolution: Modified SDES2 UNDO CHECKOUT to return a successful undo checkout occurs an "Appointment" object is sent as the return. Test Sites: ----------- Central Texas (CTX) Hines Illinois (HIN) Test Sites - SNOW Change Order #: --------------------------------- Central Texas (CTX): CHG0751804 Hines Illinois (HIN): CHG0751824 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/ File Title File Name Format -------------------------------------------------------------------------- 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/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name --------------------------------------------------------------------- PIMS Technical Manual SD_PIMS_TM Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- Sites will read the National Patch Module (NPM) MailMan message and extract the Kernel Installation & Distribution System (KIDS) build. Then sites will use the Kernel Installation & Distribution System [XPD MAIN] menu to perform checks and install the 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. Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 2. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, A. Select the Verify Checksums in Transport Global option to confirm the integrity of the routines that are in the transport global. When prompted for the INSTALL NAME enter SD*5.3*947. NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. B. Select the Backup a Transport Global option to create a backup message. You must use this option and specify what to backup; the entire Build or just Routines. The backup message can be used to restore the routines and components of the build to the pre-patch condition. i. At the Installation option menu, select Backup a Transport Global ii. At the Select INSTALL NAME prompt, enter SD*5.3*947 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. When prompted "Do you wish to secure your build? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. C. You may also elect to use the following options: i. Print Transport Global - This option will allow you to view the components of the KIDS build. ii. 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 of the components of this patch, such as routines, DDs, templates, etc. D. Select the Install Package(s) option and choose the patch to install. i. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: ------------------------------- 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*947b. 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*947b 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 3 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDES2BLDSUMMOBJ Before: n/a After: B34342372 **947** Routine Name: SDES2CANCLNAVAIL Before: B77287650 After: B79092052 **869,873,875,880,886,893,898, 902,914,922,909,947** Routine Name: SDES2CHECKIN Before: B36079138 After: B40632105 **866,878,909,947** Routine Name: SDES2CRTCLNAVAL2 Before:B172211109 After:B111838938 **904,914,919,920,922,909,941, 944,945,947** Routine Name: SDES2CRTCLNAVL2B Before: n/a After: B28890279 **947** Routine Name: SDES2GETCLINAVL Before: B53297637 After: B54250023 **880,887,898,901,902,909,947** Routine Name: SDES2GETSUMMRPCS Before: n/a After: B70484210 **947** Routine Name: SDES2UNDOCHKOUT Before: B24317583 After: B25024148 **877,919,909,942,945,947** Routine Name: SDES2UNDONOSHOW Before: B27575934 After: B29391425 **871,875,927,909,929,944,947** Routine list of preceding patches: 945 ============================================================================= User Information: Entered By : Date Entered : JAN 29, 2026 Completed By: Date Completed: JUL 09, 2026 Released By : Date Released : JUL 09, 2026 ============================================================================= Packman Mail Message: ===================== $END TXT