$TXT Created by G at CHY0017D.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 01/11/24 at 20:15 ============================================================================= Run Date: FEB 06, 2024 Designation: SD*5.3*867 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #718 Status: Released Compliance Date: FEB 20, 2024 ============================================================================= Associated patches: (v)SD*5.3*813 <<= must be installed BEFORE `SD*5.3*867' (v)SD*5.3*845 <<= must be installed BEFORE `SD*5.3*867' (v)SD*5.3*857 <<= must be installed BEFORE `SD*5.3*867' (v)SD*5.3*861 <<= must be installed BEFORE `SD*5.3*867' (v)SD*5.3*864 <<= must be installed BEFORE `SD*5.3*867' (v)SD*5.3*866 <<= must be installed BEFORE `SD*5.3*867' Subject: Updates to Scheduling RPCs Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ VistA Scheduling (VS) patch SD*5.3*867 includes several defect corrections and enhancements including: The following new SDES2 Remote Procedure Calls (RPCs) were created from their SDES version: SDES2 CREATE APPT REQ SDES2 EDIT APPT REQ SDES2 GET APPTS CLINIEN LIST SDESS APPT CHECKOUT SDES2 CREATE VET REQ AND APPT These new SDES RPCs include a new input array parameter that contains Audit information. When storing DUZ into audit fields, the new audit array input value, USER DUZ, will be used. This value, USER DUZ, will also be used to determine if a patient is sensitive for the user. The new SDES2 GET RESOURCE IEN RPC was created and if given a Resource Type and IEN, will return the SDEC RESOURCE (#409.831) IEN. The SDES2 GET PATIENT EP RPC was updated to return all dates in ISO format. The SDES GET APPT REQ LIST BY DFN, SDES GET CONSULTS BY DFN and the SDES GET CONSULTS BY IEN RPCs were updated to return to return the stop codes for consults and procedures. The logic in the SDES01C routine was updated to so that all clinics are returned regardless of no abbreviation or too long of an abbreviation. The SDES CREATE APPT REQ RPC definition was updated to show an example of successful RPC in JSON format. The SDES GET CLINIC INFO2 RPC was updated to return the Resource IEN in the returned JSON object. The SDES GET CANCEL REASONS RPC was updated to return back the REOPEN UPON CANCELLATION field so that VSA can determine whether or not to reopen the appointment request. A new RPC SDSE2 GET EXPAND ENTRY 2 was created to add the diagnosis code as a child element to Diagnosis whereas before it was being formatted as its own array The SDAMUTDT routine was updated to properly identify a "zero offset" clinic so that it doesn't return an error. The SDES Block and Move functionality was updated to properly block the original clinic's appointment slot so that another appointment does not get booked in that slot. The logic supporting the SDES2 GET RESOURCE GROUP RPC was updated to reference the INACTIVE field (#.02) in the SDEC RESOURCE file (#409.831) instead of the INACTIVATED DATE/TIME field (#.021) field. Patch Components: ----------------- Files & Fields Associated: New/Modified/Deleted -------------------------- -------------------- SDES ERROR CODES New errors being Modified (#409.93) deployed File Name (Number) Field Name New/Modified/Deleted ------------------ ---------- -------------------- 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 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 --------------------- -------------------- SDES CREATE APPT REQ Modified SDES GET APPT REQ LIST BY DFN Modified SDES GET CANCEL REASONS Modified SDES GET CLINIC INFO2 Modified SDES GET CONSULTS BY DFN Modified SDES GET CONSULTS BY IEN Modified SDES SEARCH CLINIC Modified SDES2 CREATE VET REQ AND APPT New SDES2 GET APPTS CLINIEN LIST New SDES2 GET EXPANDED ENTRY 2 New SDES2 GET PATIENT EP Modified SDES2 GET RESOURCE IEN New SDES2 SET APPT CHECKOUT New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-6482: VistA: SDES2 Priority 8: Rewrite SDES GET APPTS BY CLINIEN LIST in the SDES2 namespace. Problem: As a Mumps developer I want to rewrite the SDES GET APPTS BY CLINIEN LIST in the SDES2 namespace so that I have the USER DUZ in the SDCONTEXT array to store the correct requesting user in the database. Need to ensure that the code for sensitive patient is updated. Resolution: The new SDES2 GET APPTS CLINIEN LIST was created and contains the USER DUZ in the SDCONTEXT array so that the correct requesting user can be stored in the database. In addition, the sensitive patient code was updated for efficiency. 2) VSE-6486: VistA: SDES2 Priority 12: Rewrite SDES CHECKOUT in the SDES2 namespace. Problem: As a Mumps developer I want to rewrite the SDES CHECKOUT in the SDES2 namespace so that I have the USER DUZ in the SDCONTEXT array to store the correct requesting user in the database. Resolution: The new SDES2 SET APPT CHECKOUT was created and contains the USER DUZ in the SDCONTEXT array so that the correct requesting user can be stored in the database. 3) VSE-6487: VistA: SDES2 Priority 13: Rewrite SDES CREATE VET REQ SCHED APPT in the SDES2 namespace. Problem: As a Mumps developer I want to rewrite the SDES CREATE VET REQ SCHED APPT in the SDES2 namespace so that I have the USER DUZ in the SDCONTEXT array to store the correct requesting user in the database. Resolution: The new SDES2 CREATE VET REQ AND APPT RPC was created and contains the USER DUZ in the SDCONTEXT array so that the correct requesting user can be stored in the database. 4) VSE-6550: VistA: VistA: Create a new SDES2 RPC that accepts a Resource Type and IEN and returns RESOURCE IEN. Problem: As a VSA Developer I want to send in a Resource Type and IEN and receive a Resource IEN back. Resolution: The new SDES2 GET RESOURCE IEN RPC was created and if given a Resource Type and IEN, will return the SDEC RESOURCE (#409.831) IEN. 5) VSE-6682: VistA: Modify SDES2 GET PATIENT EP to return all dates in ISO 8601 format. Problem: As a Mumps developer I want to modify SDES2 GET PATIENT EP to return all dates in ISO 8601 format so that other applications can deal with the time correctly. Resolution: The SDES2 GET PATIENT EP RPC was updated to return all dates in ISO format. 6) VSE-6725: VistA: Modify SDES GET APPT REQ* RPCs and SDES2 GET REQUESTS BY INST to return stop codes for consults and procedures. Problem: As a VSA developer I want the SDES GET APPT REQ* RPCs, SDES2 GET REQUESTS BY INST, and SDES GET CONSULTS BY IEN to return the stop codes for consults and procedures so that I can ensure the correct clinic is selected. Resolution: The SDES GET APPT REQ LIST BY DFN, SDES GET CONSULTS BY DFN and the SDES GET CONSULTS BY IEN RPCs were updated to return to return the stop codes for consults and procedures. 7) VSE-6726: VistA: Modify SDES01C routine to remove lines 58 though 61 and skip looking at abbreviations in the C cross reference. Problem: As a Mumps developer I want to remove lines 58 through 61 of the SDES01C routine and the code for the function $$SDCHK to skip looking at the abbreviations in the "C" cross reference so that all clinics are returned regardless of no abbreviation or too long of an abbreviation. Resolution: The logic in the SDES01C routine was updated to so that all clinics are returned regardless of no abbreviation or too long of an abbreviation. 8) VSE-6791: VistA: Update the RPC definition for SDES CREATE APPT REQ in FileMan to add the properly formatted JSON return. Problem: Need to update the RPC definition for SDES CREATE APPT REQ in FileMan to add the properly formatted JSON return. Resolution: The SDES CREATE APPT REQ RPC definition was updated to show an example of successful RPC in JSON format. 9) VSE-6817: VistA: Modify SDES GET CLINIC INFO2 to return the Resource IEN to the return object. Problem: As a Mumps developer I want to modify SDES GET CLINIC INFO2 to add the Resource IEN to the return object. Resolution: The SDES GET CLINIC INFO2 RPC was updated to return the Resource IEN in the returned JSON object. 10) VSE-6831: VistA: Modify SDES GET CANCEL REASONS to return back the REOPEN UPON CANCELLATION field. Problem: As a MUMPS developer I want to modify SDES GET CANCEL REASONS to return back the REOPEN UPON CANCELLATION field so that VSA can determine whether or not to reopen the appointment request. Resolution: The SDES GET CANCEL REASONS RPC was updated to return back the REOPEN UPON CANCELLATION field so that VSA can determine whether or not to reopen the appointment request. 11) VSE-6835: VistA: Modify SDES2 GET EXPANDED ENTRY to return the diagnostic code with the diagnosis. Problem: As a MUMPS developer I want to Modify SDES2 GET EXPANDED ENTRY to return the diagnostic code with the diagnosis so that I get 1 list instead of 2 separate lists. Resolution: A new RPC SDSE2 GET EXPAND ENTRY 2 was created to add the diagnosis code as a child element to Diagnosis whereas before it was being formatted as its own array 12) VSE-6840: VistA: Modify SDAMUTDT routine to correctly recognize a "zero offset" clinic. Problem: As a MUMPs developer I want to modify SDAMUTDT routine to correctly recognize a "zero offset" clinic so that I don't return an error when the calling application sends in a zero offset clinic. Resolution: The SDAMUTDT routine was updated to properly identify a "zero offset" clinic so that it doesn't return an error. 13) VSE-6877: VistA: Issue with SDES BLOCK AND MOVE. Problem: As a MUMPS developer, when blocking and moving an appointment, I want to block the original clinic's appointment slot so that another appointment does not get booked in that slot. Resolution: The SDES BLOCK AND MOVE functionality was updated to properly block the original clinic's appointment slot so that another appointment does not get booked in that slot. 14) VistA: Modify SDES2 GET RESOURCE GROUP to include resources that have been inactivated in the past. Problem: A defect was identified in the SDES2 GET RESOURCE GROUP RPC where the wrong field was being referenced to determine if a resource group was inactive. Resolution: The logic supporting the SDES2 GET RESOURCE GROUP RPC was updated to reference the INACTIVE field (#.02) in the SDEC RESOURCE file (#409.831) instead of the INACTIVATED DATE/TIME field (#.021) field. Test Sites: ----------- Altoona, PA (ALT) Orlando, FL (ORL) 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 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*867. 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*867. 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*867b. 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*867b backup installs without any issues. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;13 Aug 1993;Build 8 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDAMUTDT Before: B49653370 After: B49640078 **266,805,809,813,867** Routine Name: SDES01C Before: B23244718 After: B21749252 **790,807,836,837,851,867** Routine Name: SDES2APPTCLNLST Before: n/a After: B19650056 **867** Routine Name: SDES2CRTVETAPPT Before: n/a After: B43514341 **867** Routine Name: SDES2EPT Before: B18652257 After: B21009205 **861,867** Routine Name: SDES2GETRESGROUP Before: B7959402 After: B7969654 **866,867** Routine Name: SDES2GETRESIEN Before: n/a After: B7117446 **867** Routine Name: SDES2GETXPENTRY2 Before: n/a After: B37622894 **867** Routine Name: SDES2PATDATA Before: n/a After: B25470403 **867** Routine Name: SDES2SETCHECKOUT Before: n/a After:B217184352 **867** Routine Name: SDESBLOCKANDMOVE Before: B51481870 After: B51916717 **853,866,867** Routine Name: SDESCANCELRSNS Before: B8385911 After: B9319913 **836,845,867** Routine Name: SDESCHECKOUT Before:B198668956 After:B198686634 **826,827,836,853,867** Routine Name: SDESGETCONSULTS Before: B51190610 After: B55491441 **815,820,824,837,842,847,857,867** Routine Name: SDESRTVCLN2 Before:B125551542 After:B130701492 **823,825,827,828,833,836,851, 864,867** Routine list of preceding patches: 813, 845, 857, 861, 864, 866 ============================================================================= User Information: Entered By : Date Entered : NOV 01, 2023 Completed By: Date Completed: FEB 06, 2024 Released By : Date Released : FEB 06, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT