$TXT Created by G at CHY0077.FO-BAYPINES.DOMAIN.EXT (KIDS) on Monday, 08/19/24 at 16:11 ============================================================================= Run Date: SEP 03, 2024 Designation: SD*5.3*886 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #733 Status: Released Compliance Date: SEP 17, 2024 ============================================================================= Associated patches: (v)SD*5.3*756 <<= must be installed BEFORE `SD*5.3*886' (v)SD*5.3*864 <<= must be installed BEFORE `SD*5.3*886' (v)SD*5.3*881 <<= must be installed BEFORE `SD*5.3*886' (v)SD*5.3*885 <<= must be installed BEFORE `SD*5.3*886' Subject: VS GUI VERSION 1.7.60.0 Category: - Routine - Enhancement (Mandatory) - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.60.0 and patch SD*5.3*886 includes several defect corrections and enhancements including: The SDES CREATE APPT BLK AND MOVE RPC was updated to call the existing SDES2 BLOCK AND MOVE RPC code which includes the latest business logic and prevents a syntax error. The SCMSVUT3 routine was updated to allow additional radiation values. The new SDES2 GET CLINICS BY STATION RPC returns a list of clinics for a given station number. Other was added as an additional preference to the set of codes for the PREFERENCE subfield (#.01) in the PREFERENCES subfile (#409.8451) in the SDEC PREFERENCES AND SPECIAL NEEDS file (#409.845). The new SDES2 SEARCH CLIN BY STOP CODE RPC returns detailed clinic information based on a search on Medical Center Division (Station Number) and/or Stop Code and/or Stop Code range. The SDES CLIN PRECAN RPC was updated to correct an issue with the date range validation. The SDES CREATE CLINIC AVAILABILITY and SDES EDIT CLINIC AVAILABILITY RPCs were updated to allow for the cancellation of the existing indefinite availability and then the creation of a new indefinite availability definition. The SDES2 CANCEL CLINIC AVAIL RPC was updated for the following: 1) To loop correctly through the start and end date range 2) To correctly note the cancelled date 3) To return the complete and properly formatted JSON object 4) To add a validation check to make sure that cancellation is not being attempted for multiple days, if only a Partial cancellation (the RPC Definition was also updated to stress this point.) The new SDES2 GET APPTS BY PAT DFN2 RPC returns appointments for a given Patient within a given date range. The VS GUI was updated to prevent the new PID from being added to the original appointment when an existing appointment is cancelled by patient AND the user updates the PID when cancelling. As a MUMPS developer I want to Modify SDES2 CANCEL APPOINTMENT to check for a lock in the order vs the lock on the patient. Logic already exists in SDES2CREATEAPPT. The SDES2 GET PATIENT EP RPC was updated to return an external date string for "Combat Veteran End Date" that allows no day. The VS GUI was updated to display and allow the selection of the new Other preference. The SDES2GETSTATUS routine was updated to correctly calculate the appointment status when the patient was an inpatient when their appointment was cancelled. This will prevent the cancelled appointment from showing up on the calendar grid. The SDES2 GET PATIENT INFO RPC was updated to use the SDCONTEXT("USER DUZ") so the sensitive record values are calculated correctly. The cancel appointment logic was updated to allow the PID to be editable when rebooking an inpatient consult cancelled appointment. The SDEC APPDEL RPC was updated to prevent mis-matched status values between the SDEC APPOINTMENT file (#409.84) and the APPOINTMENT multiple (#2.98) in the PATIENT file (#2). The SDES2 GET DISP CONT ATTEMPTS RPC was updated for the following: 1) Add a new field to the RPC Return Array to include "ClinicName". 2) Add a new field to the RPC Return Array to include the Clinic "Service". 3) Modify the "RequestType" field in the RPC Return Array to use the External Value, instead of the Internal Value or Code, for Consult/Procedure and Recall Requests. 4) Modify the "RequestType" field in the RPC Return Array to use the Internal Value or Code from the REQUEST TYPE (#4) field of the SDEC APPT REQUEST (#409.85) file for all Appointment Request types. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.60.0 of VS is installed. * * * * * * The previous version of the VS GUI will not operate after this * * patch is installed. Therefore, VS GUI V1.7.60.0 and VistA patch * * SD*5.3*886 must be coordinated and installed during the same * * maintenance window. * * * * * ************************************************************************** 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 ------------------ ---------- -------------------- SDEC PREFERENCES AND PREFERENCES SPECIAL NEEDS (#409.845) (#409.8451) PREFERENCE Modified (#.01) 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 ----------- ---- -------------------- SDECRPC Broker Modified SDESRPC Broker 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 --------------------- -------------------- SDES CREATE APPT BLK AND MOVE New SDES2 CANCEL CLINIC AVAIL Modified SDES2 GET APPTS BY PAT DFN2 New SDES2 GET CLINICS BY STATION New SDES2 GET DISP CONT ATTEMPTS Modified SDES2 SEARCH CLIN BY STOP CODE New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-3869: VistA: Modify SDES CREATE APPT BLK AND MOVE to call new SDES2 version. Problem: As a MUMPS developer, I want to modify the SDES CREATE APPT BLK AND MOVE RPC to call the SDES2 block and move code so that it does not encounter a syntax error. The current SDES CREATE APPT BLK AND MOVE code calls old SDEC code which due to a leaking variable wipes out needed data causing a syntax error. We need to modify the RPC to call code that will take the current input parameters, build the array that the SDES2 Code is expecting (skipping the SDCONTEXT array check) and then converting the output to what the GUI is expecting. Resolution: The SDES CREATE APPT BLK AND MOVE RPC was updated to call the existing SDES2 BLOCK AND MOVE RPC code which includes the latest business logic and prevents a syntax error. 2) VSE-7395: VistA: Modify SCMSVUT3 routine tag RADMTHD to allow additional radiation values. Problem: As a MUMPS developer I want to modify SCMSVUT3 routine tag RADMTHD to allow additional radiation values. Resolution: The SCMSVUT3 routine was updated to allow additional radiation values. 3) VSE-7951: VistA: Create a new RPC in the SDES2 namespace to get clinics by station number. Problem: As a MUMPS developer I want to Create a new RPC in the SDES2 namespace to get clinics by station number. Resolution: The new SDES2 GET CLINICS BY STATION RPC returns a list of clinics for a given station number. 4) VSE-7967: VistA: Add an "Other" option to the preference file Problem: As a MUMPS developer I want to add an "Other" option to the preferences file. I also want to update any existing RPCs that return preferences. Resolution: Other was added as an additional preference to the set of codes for the PREFERENCE subfield (#.01) in the PREFERENCES subfile (#409.8451) in the SDEC PREFERENCES AND SPECIAL NEEDS file (#409.845). 5) VSE-8067: VistA: Create a new SDES2 RPC to retrieve clinic data by division and stop code ranges. Problem: As a MUMPS developer I want to create a new SDES2 RPC to retrieve clinic data by division and stop code ranges. Resolution: The new SDES2 SEARCH CLIN BY STOP CODE RPC returns detailed clinic information based on a search on Medical Center Division (Station Number) and/or Stop Code and/or Stop Code range. 6) VSE-8143: VistA: Modify SDES CLIN PRECAN to correct date range validation. Problem: As a MUMPS Developer I want to Modify SDES CLIN PRECAN to correct date range validation. Testing shows the patient info, but when canceling a different timeslot in that day, it will show the cancelled timeslot and NOT the patient info. Resolution: The SDES CLIN PRECAN RPC was updated to correct an issue with the date range validation. 7) VSE-8144: VistA: DISCOVERY and code if time permits - Modify SDES CREATE CLINIC AVAILABILITY and SDES EDIT CLINIC AVAILABILITY. Problem: As a MUMPS developer I want to Modify SDES CREATE CLINIC AVAILABILITY and SDES EDIT CLINIC AVAILABILITY so that when creating and then cancelling indefinite availability, new indefinite availability is allowed to be created. Resolution: The SDES CREATE CLINIC AVAILABILITY and SDES EDIT CLINIC AVAILABILITY RPCs were updated to allow for the cancellation of the existing indefinite availability and then the creation of a new indefinite availability definition. 8) VSE-8173: VistA: Modify SDES2 CANCEL CLINIC AVAIL to correct discovered defects. Problem: As a MUMPS developer I want to Modify SDES2 CANCEL CLINIC AVAIL to Fix the current logic to correctly loop through the start and end date. I also want to update the logic to tag the cancelled date (full cancel) with the correct day of the month. I also want to modify SDES2 CANCEL CLINIC AVAIL RPC so that it returns the object correctly. I also want to add a validation check to make sure that cancellation is not being attempted for multiple days, if only a Partial cancellation (the RPC Definition will also need to be updated to stress this point.) Resolution: The SDES2 CANCEL CLINIC AVAIL RPC was updated for the following: 1) To loop correctly through the start and end date range. 2) To correctly note the cancelled date. 3) To return the complete and properly formatted JSON object. 4) To add a validation check to make sure that cancellation is not being attempted for multiple days, if only a Partial cancellation (the RPC Definition was also updated to stress this point.) 9) VSE-8177: VistA: Create a new version of SDES2 GET APPTS BY PATIENT DFN and deprecate the current one. Problem: As a MUMPS developer I want to Create a new version of SDES2 GET APPT BY PATIENT DFN and deprecate the current one. The new version should accept a date range, but only dates, no times. Resolution: The new SDES2 GET APPTS BY PAT DFN2 RPC returns appointments for a given Patient within a given date range. 10) VSE-8188: VSE GUI: New PID erroneously entered in original appointment. Problem: When an appointment is cancelled by patient AND the user updates the PID when cancelling, the new PID is erroneously entered into the original appointment. Resolution: The VS GUI was updated to prevent the new PID from being added to the original appointment when an existing appointment is cancelled by patient AND the user updates the PID when cancelling. 11) VSE-8197: VistA: Modify SDES2 CANCEL APPOINTMENT to check for a lock in the order vs the lock on the patient. Problem: As a MUMPS developer I want to Modify SDES2 CANCEL APPOINTMENT to check for a lock in the order vs the lock on the patient. Logic already exists in SDES2CREATEAPPT. Resolution: The SDES2 CANCEL APPOINTMENT RPC was updated to check for a lock on the Order instead of a lock on the Patient. 12) VSE-8205: VistA: Modify SDES2 GET PATIENT EP to return an external date string for fields that allow no day. Problem: As a MUMPS developer I want to Modify SDES2 GET PATIENT EP to return back an external date string for "Combat Veteran End Date" that allow no day. Resolution: The SDES2 GET PATIENT EP RPC was updated to return an external date string for "Combat Veteran End Date" that allows no day. 13) VSE-8221: VS GUI: Add "Other" to SNAP. Problem: Add "Other" as a new preference. Provide "Other" as an option when editing a patient's special needs and preferences. Resolution: The VS GUI was updated to display and allow the selection of the new Other preference. 14) VSE-8250: VistA: Modify SDES2GETSTATUS to fix the Status of a cancelled inpatient appointment. Problem: As a MUMPS developer I want to Modify SDES2GETSTATUS to fix the Status of a cancelled inpatient appointment. The appointment status is calculating incorrectly when the patient was an inpatient when cancelled. This is causing the appointment to display on the clinic calendar grid. Resolution: The SDES2GETSTATUS routine was updated to correctly calculate the appointment status when the patient was an inpatient when their appointment was cancelled. This will prevent the cancelled appointment from showing up on the calendar grid. 15) VSE-8254: VistA: Modify SDES2 GET PATIENT INFO to use the SDCONTEXT("USER DUZ") to pass into POPULATE^SDES2PATSEARCH. Problem: As a MUMPS developer I want to Modify SDES2 GET PATIENT INFO to use the SDCONTEXT("USER DUZ") to pass into POPULATE^SDES2PATSEARCH. Currently SDES2 GET PATIENT INFO does not use the SDCONTEXT("USER DUZ"). The sensitive record status is always calculated based on the DUZ in the system (which is currently the proxy user). The RPC needs to be updated to use the SDCONTEXT("USER DUZ") so the sensitive record values are calculated correctly. Resolution: The SDES2 GET PATIENT INFO RPC was updated to use the SDCONTEXT("USER DUZ") so the sensitive record values are calculated correctly. 16) VSE-8280: VistA: PID not editable when rebooking a cancelled appointment and the incorrect status on an inpatient appt. Problem: As a MUMPS developer I want to fix an issue where the PID is not editable when rebooking a cancelled appointment. I also want to fix the incorrect status on an inpatient appt. Resolution: The cancel appointment logic was updated to allow the PID to be editable when rebooking an inpatient consult cancelled appointment. 17) VSE-8281: VistA: fix an issue where SDEC APPDEL is sometimes causing mis-matched status values in 409.84 and 2.98. Problem: As a MUMPS developer I want to fix an issue where SDEC APPDEL is sometimes causing mis-matched status values in 409.84 and 2.98. For Inpatient appointments that have been cancelled, the 409.84 record remains in the status of 'I' for Inpatient, and 2.98 shows 'PC' or 'C' for 'CANCELLED BY PATIENT' or 'CANCELLED BY CLINIC'. An Outpatient appointment seem to be working correctly in most cases. An Observation has been made of an Incremental lock that may be causing some updates to fail in APCAN^SDEC08. Logic in APCAN^SDEC08 seems to be incorrect, and is attempting to use the appointment status from 2.98 to overwrite the appointment status in 409.84. Modify APPDEL^SDEC08 to preserve the 'Inpatient' status on the 409.84 appointment if the appointment is being cancelled. Resolution: The SDEC APPDEL RPC was updated to prevent mis-matched status values between the SDEC APPOINTMENT file (#409.84) and the APPOINTMENT multiple (#2.98) in the PATIENT file (#2). 18) VSE-8300: VistA: Modify SDES2 GET DISP CONT ATTEMPTS to add new fields Problem: As a MUMPS developer I want to Add two new fields to the RPC Return Array to include the "ClinicName" and Clinic "Service" and Modify the "RequestType" field in the RPC Return Array to use the External Value, instead of the Code, for Consults, Procedures, and Recalls, but use the Internal value or code from the 409.85 REQUEST TYPE field for all Appt Request types. Resolution: The SDES2 GET DISP CONT ATTEMPTS RPC was updated for the following: 1) Add a new field to the RPC Return Array to include "ClinicName". 2) Add a new field to the RPC Return Array to include the Clinic. "Service". 3) Modify the "RequestType" field in the RPC Return Array to use the External Value, instead of the Internal Value or Code, for Consult/Procedure and Recall Requests. 4) Modify the "RequestType" field in the RPC Return Array to use the Internal Value or Code from the REQUEST TYPE (#4) field of the SDEC APPT REQUEST (#409.85) file for all Appointment Request types. Test Sites: ----------- Bay Pines, FL (BAY) Salt Lake City, UT (SLC) Software and Documentation Retrieval Instructions: ---------------------------------------------------- Software is distributed by PackMan message and MSI software. NOTE: There are two installation files. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_60_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_60_0_T.MSI is the preproduction VS GUI file. 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 -------------------------------------------------------------------------- VS GUI R1.7.60.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_60_0_P.MSI Binary VS GUI R1.7.60.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_60_0_T.MSI Binary VS GUI R1.7.60.0 VDD VS_GUI_1_7_60_0 VDD Binary VS GUI R1.7.60.0 DIBR VS_GUI_1_7_60_0 DIBR Binary VS GUI R1.7.60.0 Release Notes VS_GUI_1_7_60_0 RN Binary VS GUI R1.7.60.0 Technical Manual VS_GUI_1_7_60_0 TM Binary VS GUI R1.7.60.0 User Guide Addendum VS_GUI_1_7_60_0_UG_ADD Binary 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: ------------------- GUI Installation Instructions: ------------------------- Sites that employ the VistA Consolidated Server (VACS) installation process will be alerted to the new GUI via an action item from Office of Information and Technology (OIT) Software Product Management (SPM) Services. Follow the detailed instructions in the Action Item email for VistA Consolidated Server (VACS) installation. The Information Operations (IO) HBMC Field Operations (FO) Application Division will lead and coordinate deployment activities with EUO, Client Technology, Citrix Back Office, and Area Managers, and other OIT and business partners as required. The released software package is available at: https://download.vista.domain.ext/index.html/SOFTWARE Release Manager Point of Contact: Name: Stevens Jack Email: jack.stevens1@domain.ext Pre/Post Installation Overview: ------------------------------- Routine SDES886P will update SDEC SETTINGS (#409.98) file. Routine will run at the end of patch installation process. 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*886. 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*886. 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: ------------------------------- Post install routine SDES886P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES886P routine using the Delete Routines [XTRDEL] if they wish. 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*886b. 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*886b backup installs without any issues. The VS GUI NATIONAL and VS GUI LOCAL entries in the SDEC SETTINGS (#409.98) file needs to be reverted to 1.7.59. If 1.7.60.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.59.0. 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: SCMSVUT3 Before: B21452531 After: B21259730 **142,180,208,239,395,441,543, 777,864,886** Routine Name: SDEC08A Before: B15102733 After: B13880894 **745,756,886** Routine Name: SDECCONSJSON Before: B41924440 After: B38468859 **784,785,788,805,807,813,877,886** Routine Name: SDES2CANCELAPPT Before:B203329532 After:B186294665 **869,871,873,875,877,878,880,886** Routine Name: SDES2CANCELAPPT1 Before: n/a After: B1475907 **886** Routine Name: SDES2CANCLNAVAIL Before: B69195423 After: B70532151 **869,873,875,880,886** Routine Name: SDES2CREATEAPPT Before:B147035229 After:B147481337 **866,869,873,875,877,880,881,886** Routine Name: SDES2EPT Before: B31455508 After: B30656278 **861,867,877,880,886** Routine Name: SDES2GETAPPTRPCS Before: B70405869 After: B94989553 **871,873,875,877,880,886** Routine Name: SDES2GETCLNSTA Before: n/a After: B5371795 **886** Routine Name: SDES2GETCONSULTS Before: B67385284 After: B69695438 **873,877,886** Routine Name: SDES2GETDISPCONS Before: B28735494 After: B34254607 **885,886** Routine Name: SDES2GETPATINFO Before: B1333340 After: B1609189 **866,886** Routine Name: SDES2GETSTATUS Before: B31194379 After: B31371915 **871,886** Routine Name: SDES2SDECBLKMOVE Before: n/a After: B6807077 **886** Routine Name: SDES2SRCHCLNBYSC Before: n/a After: B81116019 **886** Routine Name: SDES886P Before: n/a After: B2543075 **886** Routine Name: SDESGETCONSULTS Before: B59782539 After: B60103291 **815,820,824,837,842,847,857, 867,875,877,886** Routine list of preceding patches: 756, 864, 881, 885 ============================================================================= User Information: Entered By : Date Entered : JUL 10, 2024 Completed By: Date Completed: SEP 03, 2024 Released By : Date Released : SEP 03, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT