$TXT Created by at SPPNXT.HMP-PILOT.DOMAIN.EXT (KIDS) on Tuesday, 12/17/19 at 15:59 ============================================================================= Run Date: JAN 22, 2020 Designation: YS*5.01*130 Package : YS - MENTAL HEALTH Priority: Mandatory Version : 5.01 SEQ #119 Status: Released Compliance Date: FEB 22, 2020 ============================================================================= Associated patches: (v)YS*5.01*123 <<= must be installed BEFORE `YS*5.01*130' Subject: MHA WEB PATIENT ENTRY Category: - Other - Data Dictionary - Routine Description: ============ The purpose of this patch is to enable patients to enter mental health assessments themselves via a new web application. There is no longer a need to use Secure Desktop for patient entered assessments (and Secure Desktop does not function with Windows 10). When "Instrument Administration" is used in the Mental Health Assistant (MHA) client application, clicking the "Patient Entry" button will now display a five-digit number rather than activate the secure desktop. This number is entered at a kiosk or on an iPad to bring up the assigned assessment(s) for a patient. The kiosk workstations and iPads will need to be configured for operation at each facility. For additional information about configuring these devices see the MHA3 Installation Guide (YS*5.01*130). Patch Components: ================= Files & Fields Associated: File Name (Number) Field Name (Number) New/Mod/Del ------------------ ------------------- ----------- MH TESTS AND SURVEYS (#601.71) STAFF ENTRY ONLY (#94) New Field MH TESTS AND SURVEYS (#601.71) CATEGORY (#101) New Field MH STAGED DOCUMENTS (#601.96) New File MH INSTRUMENT CATEGORY (#601.97) New File Forms Associated: N/A Mail Groups Associated: N/A Options Associated: Option Name Type New/Mod/Del ----------- ---- ----------- YS BROKER1 version 1.0.3.75~1.0.5.6~1.0.3.80 broker Modified [YS BROKER1] MHA Assignments By Patient run routine New [YTQR ASSIGNMENT BY PATIENT] MHA Patient Entry 1.0 broker New [YTQREST PATIENT ENTRY] Protocols Associated: N/A Remote Procedures Associated: Remote Procedure Name New/Mod/Del --------------------- ----------- YTQREST QENTRY New YTQREST QSTAFF New YTQRRPC SELECT New Security Keys Associated: N/A Templates Associated: N/A Additional Information ====================== New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A NSD Ticket(s) & Overview: ------------------------- N/A Test Sites: ---------- Milwaukee Orlando Documentation Retrieval Instructions: ------------------------------------- Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ MHA3 Installation Guide (YS*5.01*130) YS_501_130_IG.pdf MHA3 Technical Manual and Security Guide YS_TM.pdf MHA3 User Manual YS_MHA_UM.pdf Software and Documentation Retrieval Instructions: -------------------------------------------------- The VistA portion of this patch is distributed via a PackMan message. The updated GUI executable is being distributed as a host file. The name of the host file is YS_501_130.ZIP. The Install Guide and supporting manuals are also available. These files may be downloaded using BINARY format from: download.vista.domain.ext. File Name: Description: Protocol ========== ============ ========= YS_501_130_IG.pdf MHA3 Patch 130 Install Guide BINARY YS_501_130.ZIP PATCH 130 MHA GUI V 1.0.3.80 BINARY YS_TM.PDF MHA3 Technical Manual BINARY YS_MHA_UM.PDF MHA3 User Manual BINARY Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ Installation: ============= This patch can be loaded with users in the system, but it is recommended that it be installed when user activity is low. Installation time will be less than 5 minutes. 1. Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: Installation 1 Load a Distribution 2 Verify Checksums in Transport Global 3 Print Transport Global 4 Compare Transport Global to Current System 5 Backup a Transport Global 6 Install Package(s) Restart Install of Package(s) Unload a Distribution 3. From this menu, you may elect to use the following options (When prompted for the INSTALL NAME, enter YS*5.01*130): a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as DD's or templates. 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, DD's, 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. Use the Install Package(s) option and select the package YS*5.01*130. a. When prompted "Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//", answer NO. b. When prompted "Want KIDS to INHIBIT LOGONs during the install? NO//", answer NO. c. When prompted "Want to DISABLE Scheduled Options and Menu Options and Protocols? NO//", answer NO. Post-Installation Instructions ------------------------------ After the KIDS build for YS*5.01*130 is installed, the existing MHA executable (1.0.3.75) and the new MHA executable (1.0.3.80) will both still function. A simultaneous update of the Windows executable is not required. This provides the option of having some users continue with the existing executable while others (perhaps those with access to iPads or kiosks) use the new executable. Adding another MHA item to the CPRS Tools menu can accomplish this. These are the basic steps: o Rename the new "YS_MHA.exe" to something like "YS_MHA_130.exe" and place it in the directory where you currently have YS_MHA.exe. o Edit the parameter, ORWT TOOLS MENU, and add another item named something like "MHA Patient Entry" that invokes the executable that you just renamed. o When you are ready for all users to use the new executable, simply delete the YS_MHA.exe file and rename "YS_MHA_130.exe" to "YS_MHA.exe". Don't forget to remove the temporary item from the ORWT TOOLS MENU. If your site's workstations are all Windows 10 and you are not using "Secure Desktop" with MHA anymore, you can just move to the new YS_MHA.exe immediately, without adding a new item to the CPRS Tools menu. Back-Out Plan ------------- For information about back out steps see this document: YS_501_130_IG.pdf in the VistA Documentation Library at: http://www.domain.ext/vdl/ Routine Information: ==================== The second line of each of these routines now looks like: ;;5.01;MENTAL HEALTH;**[Patch List]**;Dec 30, 1994;Build 62 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: YS130PS0 Before: n/a After: B35085086 **130** Routine Name: YS130PST Before: n/a After: B6726554 **130** Routine Name: YTQAPI Before: B15475641 After: B17118160 **85,130** Routine Name: YTQAPI2 Before: B31600888 After: B34492962 **85,96,119,121,123,130** Routine Name: YTQREST0 Before: n/a After: B7041728 **130** Routine Name: YTQRIS Before: n/a After: B89215067 **130** Routine Name: YTQROPT Before: n/a After: B3569685 **130** Routine Name: YTQRQAD Before: n/a After: B17984488 **130** Routine Name: YTQRQAD1 Before: n/a After: B43113757 **130** Routine Name: YTQRQAD2 Before: n/a After: B33515515 **130** Routine Name: YTQRQAD3 Before: n/a After: B21425312 **130** Routine Name: YTQRRPC Before: n/a After: B6690032 **130** Routine Name: YTQRRPT Before: n/a After: B35953484 **130** Routine Name: YTQRUTL Before: n/a After: B67291165 **130** Routine Name: YTSBAMC Before: B2786313 After: B15807209 **123,130** Routine Name: YTSBAMI Before: n/a After: B2972389 **130** Routine Name: YTSBAMR Before: B21293411 After: B30507042 **123,130** Routine Name: YTWJSON Before: n/a After: B85561808 **130** Routine Name: YTWJSONF Before: n/a After: B9425991 **130** Routine Name: YTWJSONO Before: n/a After: B21552194 **130** Routine Name: YTWJSONU Before: n/a After: B5383901 **130** Routine Name: YTXCHG Before: B65891565 After: B70845213 **121,123,130** Routine Name: YTXCHGT Before: B22991016 After: B23916651 **121,123,130** Routine list of preceding patches: 123 ============================================================================= User Information: Entered By : Date Entered : MAR 02, 2017 Completed By: Date Completed: JAN 22, 2020 Released By : Date Released : JAN 22, 2020 ============================================================================= Packman Mail Message: ===================== $END TXT