============================================================================= Run Date: FEB 27, 2023 Designation: DG*5.3*1085 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #952 Status: Released Compliance Date: MAR 06, 2023 ============================================================================= Associated patches: (v)DG*5.3*1064 <<= must be installed BEFORE `DG*5.3*1085' (v)DG*5.3*952 <<= must be installed BEFORE `DG*5.3*1085' Subject: PREFERRED LANGUAGE MODIFICATIONS Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1085 is being released to support enhancements for the Eligibility and Enrollment (E&E) program. Patch DG*5.3*1085 is also being released in support of the Veterans Health Administration (VHA) Enrollment System (VES) 6.4 release. DG*5.3*1085 is being released with IVM*2.0*210 in Host File DG_53_P1085.KID. VistA is being updated to synchronize Preferred Language between VES and VistA. Patch DG*5.3*1085 modifies the PATIENT DEMOGRAPHIC DATA, SCREEN <1> screen DATA GROUP [5], "Pref Lang:" and "Date/Time:", to no longer display the LANGUAGE DATE/TIME: prompt when editing DATA GROUP [5]. This patch makes the following enhancements to VistA REE: ************************************************************************** SECTION 1: DATA DICTIONARY UPDATES ************************************************************************** 1. A trigger is added to the PREFERRED LANGUAGE (#.02) field in the LANGUAGE DATE/TIME (#7) sub file (#2.07) of the PATIENT (#2) file. 2.07,.02 PREFERRED LANGUAGE 0;2 FREE TEXT (Required) INPUT TRANSFORM:D INPXF207^DGRPE MAXIMUM LENGTH: 60 LAST EDITED: DEC 09, 2022 HELP-PROMPT: Your answer must be 1-60 characters in length. If the patient wishes not to give a preferred language or declines to answer, enter an * (asterisk) at the prompt to respond as 'DECLINED TO ANSWER'. DESCRIPTION: This is the preferred language of the patient. A patient may speak, read and write several languages but this is the one that he/she prefers. You may also answer with the 2- or 3-letter code assigned to the language or type in the language name. TECHNICAL DESCR:Any language selected for this field is screened to be a "living" language and to have a 2-character code included. This facilitates selection of languages based on whether it is used today or not and if it has the information needed. EXECUTABLE HELP:D XHELP207^DGRPE NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER CROSS-REFERENCE:2.07^AC^MUMPS 1)= D EVENT^IVMPLOG($G(DA(1))) 2)= D EVENT^IVMPLOG($G(DA(1))) 3)= DO NOT DELETE This cross-reference is used to notify HEC of changes that may affect enrollment. 2. The Input Transform of the LANGUAGE DATE/TIME (#.01) field in the LANGUAGE DATE/TIME (#7) sub file (#2.07) of the PATIENT (#2) file is modified to add the "S" flag to the %DT variable to allow seconds to be stored for the date/time. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2.07,.01 LANGUAGE DATE/TIME 0;1 DATE (Required) INPUT TRANSFORM: S %DT="ESTXR",%DT(0)="-NOW" D ^%DT S X=Y K :Y<1 X K %DT(0) LAST EDITED: DEC 20, 2022 HELP-PROMPT: Enter the date and time the preferred language information was recorded. You may use N or n for 'NOW'. Future values may not be entered. DESCRIPTION: The date/time the preferred language information was given by the patient and recorded in the Patient File. EXECUTABLE HELP: N DPTX S DPTX="This field entry must be to day's date or earlier and must include a t ime." D EN^DDIOL(DPTX),EN^DDIOL("") NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER CROSS-REFERENCE: 2.07^B 1)= S ^DPT(DA(1),.207,"B",$E(X,1,30),DA)=" " 2)= K ^DPT(DA(1),.207,"B",$E(X,1,30),DA) ************************************************************************** SECTION 2: REGISTRATION SCREEN UPDATES ************************************************************************** The PATIENT DEMOGRAPHIC DATA, SCREEN <1> screen DATA GROUP [5] no longer displays the LANGUAGE DATE/TIME: prompt when editing: ** BEGIN SCREEN CAPTURE ** PATIENT DEMOGRAPHIC DATA, SCREEN <1> DGPATIENT,ONE MON DD,YYYY ###-##-#### NSC VETERAN ========================================================================== [1] Name: DGPATIENT,ONE [6] Preferred Name: Not Answered DOB: MON DD,YYY SS: ###-##-#### Family: Birth Sex: MALE MBI: Given: [2] Alias: Middle: Prefix: Suffix: Degree: Self-Identified Gender Identity: UNANSWERED [3] Remarks: NO REMARKS ENTERED FOR THIS PATIENT [4] Cell Phone: Pager #: Email Address: [5] Pref Lang: PERSIAN Date/Time: DEC 6,2022@17:21:51 to CONTINUE, 1-6 or ALL to EDIT, ^N for screen N or '^' to QUIT: 5 PREFERRED LANGUAGE: PERSIAN// ** END SCREEN CAPTURE ** ************************************************************************** SECTION 3: HL7 ORU/ORF-Z07 and ORU-Z05 PROCESSING ************************************************************************** VistA is updated to send patient Preferred Language information in the ZPD segment (Sequence numbers 46 and 47) of the HL7 ORU/ORF-Z07 message. The mapping of these fields to the corresponding fields in the database is shown below. SEQ Element Name File Name (#) Field Name (#) --- ------------ ------------- -------------- 46 Preferred Language LANGUAGE (#.85) THREE LETTER CODE (#.03) 47 Preferred Language PATIENT (#2) LANGUAGE DATE/TIME (#2.07,#.01) Date/Time VistA is updated to receive patient Preferred Language information in the ZPD segment (Sequence numbers 46 and 47) of the HL7 ORU/ORF-Z05 message. It also updates the PATIENT (#2) file with Preferred Language and Preferred Language Date/Time. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT (#2) LANGUAGE DATE/TIME Modified (#2.07,.01) PREFERRED LANGUAGE Modified (#2.07,.02) 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 ----------- ---- -------------------- N/A 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 --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Test Sites: ----------- Robley Rex VA Medical Center (Louisville), KY VA Tennessee Valley Health Care System (Nashville, Murfreesboro), TN Durham VA Medical Center, NC Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/DG_53_P1085.KID. 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 --------------------------------------------------------------------- DG_53_P1085.KID Release Notes DG_5_3_P1085_RN.PDF User Manual Version 5.3 - Registration Menu PIMS_REG_UM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: 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. It should NOT be installed while the IVM BACKGROUND JOB [IVM BACKGROUND JOB] is running. 1. The IVM BACKGROUND JOB [IVM BACKGROUND JOB] should be unscheduled. Use the Schedule/Unschedule Options [XUTM SCHEDULE] option on the TaskMan Management [XUTM MGR] menu. Note the currently scheduled date/time. 2. The HL7 incoming/outgoing filers should be stopped. Stop All Messaging Background Processes by using the [HL STOP ALL] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. The following is a list of menu options to disable: Option Name Menu Text ------------------------------ --------------------------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Enter a Request/Notification [FBCH ENTER REQUEST] Installation Instructions: 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/DG_53_P1085.KID 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 DG*5.3*1085. 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 your build DG*5.3*1085 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build iv. When prompted "Do you wish to secure this message? 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. vii. Repeat step ii for each build in the host file. 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? YES//', answer YES. a. When prompted 'Enter options you wish to mark as 'Out Of Order':', select the following option: Option Name Menu Text ------------------------------ --------------------------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Enter a Request/Notification [FBCH ENTER REQUEST] Press the Enter key when you are done selecting options. b. When prompted 'Enter protocols you wish to mark as 'Out Of Order':', press the Enter key. c. When prompted 'Delay Install (Minutes): (0 - 60): 0//', answer 0. Post-Installation Instructions: ------------------------------- 1. The HL7 incoming filers should be restarted. Use the Restart/Start All Links and Filers [HL TASK RESTART] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. 2. The IVM BACKGROUND JOB [IVM BACKGROUND JOB] should be rescheduled. Use the Schedule/Unschedule Options [XUTM SCHEDULE] option on the TaskMan Management [XUTM MGR] menu and enter the scheduled date/time that was noted in the Pre-Installation instruction section above. Back-Out/Roll Back Plan: ------------------------ In the event a site/patch installer determines that this patch should be backed out, the site/patch installer should submit a YOUR IT Services ticket with the Enterprise Service Desk (ESD) for assistance with the procedure. Any issues would need to be evaluated to determine if: a back-out of the software is appropriate; a new patch is needed; or if data requires correction or restoration. During installation, if the option Backup a Transport Global [XPD BACKUP] was run as directed, either the entire build or routines will be available for restoration should the need arise. If only the routines were backed up, they will be available in a MailMan message with a subject similar to the following: "Subject: Backup of DG*5.3*1085, IVM*2.0*210 on Dec 27, 2022." For multi-builds, if the full build was backed up, the backup will be available in the Host File specified during the backup process. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 11 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGRPE Before:B140992373 After:B141854375 **32,114,139,169,175,247,190, 343,397,342,454,415,489,506, 244,547,522,528,555,508,451, 626,638,624,677,672,702,689, 735,688,797,842,865,871,887, 941,985,997,1014,1040,1044,1056, 1067,1064,1085** Routine Name: DGRPE1 Before: B10632210 After: B14854913 **114,327,451,631,688,808,804, 909,952,1085** Routine Name: VAFHLZPD Before: B66459111 After: B78945651 **94,122,160,220,247,545,564, 568,677,653,688,1002,1064,1085** Routine list of preceding patches: 952, 1064 ============================================================================= User Information: Entered By : Date Entered : SEP 21, 2022 Completed By: Date Completed: FEB 27, 2023 Released By : Date Released : FEB 27, 2023 ============================================================================= Packman Mail Message: ===================== No routines included