$TXT Created by G at CHY0077.FO-BAYPINES.DOMAIN.EXT (KIDS) on Thursday, 07/18/24 at 12:20 ============================================================================= Run Date: AUG 15, 2024 Designation: SD*5.3*885 Package : SD - SCHEDULING Priority: Mandatory Version : 5.3 SEQ #732 Status: Released Compliance Date: AUG 28, 2024 ============================================================================= Associated patches: (v)SD*5.3*686 <<= must be installed BEFORE `SD*5.3*885' (v)SD*5.3*871 <<= must be installed BEFORE `SD*5.3*885' (v)SD*5.3*875 <<= must be installed BEFORE `SD*5.3*885' (v)SD*5.3*877 <<= must be installed BEFORE `SD*5.3*885' Subject: VS GUI VERSION 1.7.59.0 Category: - Routine - Enhancement (Mandatory) - Other Description: ============ VistA Scheduling (VS) Graphical User Interface (GUI) Release 1.7.59.0 and patch SD*5.3*885 includes several defect corrections and enhancements including: The new SDES2 GET DISP CONT ATTEMPTS Remote Procedure Call (RPC) will return all Patient Contacts attempts made during the past year for all request types that have been dispositioned without an appointment being created. The new VETERAN SELF-CANCEL? field (#63) in the HOSPITAL LOCATION file (#44) indicates if a patient can self-cancel for the clinic. VSE GUI and ISS were out of sync when processing time zones. Gui had 128 time zones of which 90% were not being used. We made changes in GUI to match the ISS time zone enumeration. We are now able to update a VVC appointment in GUI and see the updated time zone in ISS and vice versa. The SDECAUD routine was updated to store a date/time value in the DATE APPT MADE field (#.09) in the HOSPITAL LOCATION file (#44) so that the Audit Activity report will correctly display in the VS GUI. The SDUPDATECONSPID routine was updated to return the correct Patient Indicated Date after cancelling an appointment. The SDES2 QUERY APPT REQUESTS RPC was updated to utilize new cross references to increase processing speed when looking for open records. ************************************************************************** * GUI UPDATE NOTICE * * ---------------------------------------------------------------------- * * This patch MUST be installed before the GUI update for release * * 1.7.59.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.59.0 and VistA patch * * SD*5.3*885 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 ------------------ ---------- -------------------- HOSPITAL LOCATION VETERAN SELF-CANCEL? New (#44) (#63) SDEC APPT REQUEST CREATE DATE Modified (#409.85) (#1) REQ SPECIFIC CLINIC Modified (#8) REQ SERVICE/SPECIALTY Modified (#8.5) CID/PREFERRED DATE OF APPT Modified (#22) CURRENT STATUS Modified (#23) 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 ------------- -------------------- Security Keys Associated: ------------------------- Security Key Name ----------------- N/A Templates Associated: --------------------- Template Name Type File Name (Number) New/Modified/Deleted ------------- ----------------------- -------------------- SDB HOSPITAL LOCATION (#44) Modified Remote Procedures Associated: ----------------------------- Remote Procedure Name New/Modified/Deleted --------------------- -------------------- SDEC SUMMGET2 Modified SDES2 CREATE CLINIC Modified SDES2 EDIT CLINIC Modified SDES2 GET CONT ATTEMPTS BY DFN New Parameter Definitions Associated: --------------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- JIRA tasks: =========== 1) VSE-7966: VistA: Create a new SDES2 RPC to return all contact attempts per patient for dispositioned requests. Problem: As a MUMPS developer I want to create a new SDES2 RPC to return all contact attempts per patient (not per appointment or request) within the past 365 days for dispositioned requests. Resolution: The new SDES2 GET DISP CONT ATTEMPTS RPC will return all Patient Contacts attempts made during the past year for all request types that have been dispositioned without an appointment being created. 2) VSE-8036: VistA: Create a new field for Veteran Self-Cancel and add create/edit clinic. Problem: As a MUMPS developer I want to create a new field on the HOSPITAL LOCATION file (#44) to flag if a Veteran can self-cancel for the clinic. I also want to update: SDBUILD logic to add new field. SDES2 logic to create clinic. SDES2 logic to edit clinic. Hash routine Resolution: The new VETERAN SELF-CANCEL? field (#63) in the HOSPITAL LOCATION file (#44) indicates if a patient can self-cancel for the clinic. The SDBUILD option and the SDES2 RPCs to create and edit a clinic were updated to include the new VETERAN SELF-CANCEL? field. The VETERAN SELF-CANCEL? field was also added to the Hashing algorithm for the 3) VSE-8063: VS GUI: Issue between GUI and ISS when creating and editing VVS appointments. Problem: An issue between the VS GUI and ISS when creating and editing VVS appointments. Some time zones (e.g. ATLANTIC and PACIFIC) are not mapping correctly while others do (CENTRAL and HAWAII-ALEUTIAN). Choosing ATLANTIC in GUI caused ISS to display blank time zones. Choosing ATLANTIC in ISS cause GUI to not load the VVS appointment at all. Resolution: VSE GUI and ISS were out of sync when processing timezones. Gui had 128 timezones of which 90% were not being used. We made changes in GUI to match the ISS timezone enumeration. We are now able to update a VVC appointment in GUI and see the updated timezone in ISS and vice versa. 4) VSE-8101: VistA: Update to SDECAUD for change from date to date.time. Problem: Audit Activity report in VS GUI is not displaying correct information. Data use to be stored in the 'AC' Cross reference as just the date and it is now stored as the date.time. SDECAUD needs to be updated to reflect this change. Resolution: The SDECAUD routine was updated to store a date/time value in the DATE APPT MADE field (#.09) in the HOSPITAL LOCATION file (#44) so that the Audit Activity report will correctly display in the VS GUI. 5) VSE-8196: VistA: Wrong PID Is being displayed after cancelling an appointment. Problem: As a MUMPS developer I want to Fix an issue where the Wrong PID is displayed after cancelling an appointment. Resolution: The SDUPDATECONSPID routine was updated to return the correct Patient Indicated Date after cancelling an appointment. 6) VSE-8172: VistA: Modify SDES2QRYAPREQSA to use the new index, only looking at 'open' records. Problem: As a MUMPS developer I want to Modify SDES2QRYAPREQSA to use the new index, only looking at 'open' records. I also want to create a new cross reference in #409.85, by current status, clinic, request date, request IEN. Resolution: The SDES2 QUERY APPT REQUESTS RPC was updated to utilize new cross references to increase processing speed when looking for open records. Test Sites: ----------- Fargo, ND (FAR) Fort Harrison, MT (FHM) 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_59_0_P.MSI is the production VS GUI installation file. The file titled VISTASCHEDULINGGUIINSTALLER_1_7_59_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.59.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_59_0_P.MSI Binary VS GUI R1.7.59.0 INSTALLER VISTASCHEDULINGGUIINSTALLER_1_7_59_0_T.MSI Binary VS GUI R1.7.59.0 VDD VS_GUI_1_7_59_0 VDD Binary VS GUI R1.7.59.0 DIBR VS_GUI_1_7_59_0 DIBR Binary VS GUI R1.7.59.0 Release Notes VS_GUI_1_7_59_0 RN Binary VS GUI R1.7.59.0 Technical Manual VS_GUI_1_7_59_0 TM Binary VS GUI R1.7.59.0 User Guide Addendum VS_GUI_1_7_59_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 SDES885P will: 1. Update SDEC SETTINGS (#409.98) file. 2. Create new indexes in the SDEC APPT REQUEST file (#409.85) is being queued to run in the background. 3. Update the SD Audit Statistics file (#409.97) for option SDEC COMPILE AUDIT REPORT is being queued to run in the background. 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*885. 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*885. 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 SDES885P will automatically run at the end of the installation process. After the post install has finished running, sites can delete the SDES885P 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*885b. 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*885b 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.58. If 1.7.59.0 VS GUI was installed, it will need to be reverted to VS GUI 1.7.58.0. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Scheduling;**[Patch List]**;Aug 13, 1993;Build 5 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: SDECAUD Before:B101121122 After:B102052101 **686,885** Routine Name: SDES2CLINUT Before:B142875568 After:B144584096 **853,857,866,885** Routine Name: SDES2CREATECLIN Before: B66126493 After: B67723672 **853,860,871,885** Routine Name: SDES2EDITCLIN Before:B136139793 After:B143905027 **853,857,864,866,871,885** Routine Name: SDES2GETDISPCONS Before: n/a After: B28735494 **885** Routine Name: SDES2QRYAPREQSA Before: B99577435 After:B100121259 **869,875,885** Routine Name: SDES2VALCRTCLIN1 Before: B43605752 After: B45922275 **853,857,860,871,885** Routine Name: SDES2VALUTIL Before: B36207318 After: B53117728 **853,861,866,885** Routine Name: SDES885P Before: n/a After: B12595940 **885** Routine Name: SDUPDATECONSPID Before: B1499394 After: B1635034 **877,885** Routine list of preceding patches: 686, 871, 875, 877 ============================================================================= User Information: Entered By : Date Entered : JUN 26, 2024 Completed By: Date Completed: AUG 15, 2024 Released By : Date Released : AUG 15, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT