$TXT Created by NTHONY at DEVVOO.DOMAIN.EXT (KIDS) on Thursday, 05/18/23 at 11:00 ============================================================================= Run Date: JUL 24, 2023 Designation: DG*5.3*1093 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #961 Status: Released Compliance Date: JUL 31, 2023 ============================================================================= Associated patches: (v)DG*5.3*1081 <<= must be installed BEFORE `DG*5.3*1093' (v)DG*5.3*1085 <<= must be installed BEFORE `DG*5.3*1093' Subject: MODIFY INDIAN CAPABILITY AND DEMOGRAPHIC RELIGION PHASE 2 UPDATES Category: - Enhancement (Mandatory) - Routine - Data Dictionary Description: ============ ************************************************************************** ************************************************************************** IMPORTANT NOTE: The national release date for patch DG*5.3*1093 is July 24, 2023, with a seven-day compliance period. This patch must be installed at all VistA sites by close of business on Monday, July 31, 2023. ************************************************************************** ************************************************************************** Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1093 is being released to support enhancements for the Eligibility and Enrollment (E&E) program. Patch DG*5.3*1093 is also being released in support of the Veterans Health Administration (VHA) Enrollment System (VES) 6.6 release. To bring the entry into alignment with the name in VES and VA Profile, patch DG*5.3*1093 modifies the name of UNITARIAN-UNIVERSALISM in the RELIGION file (#13) to UNITARIAN-UNIVERSALIST. A separate entry has been created for UNITARIAN-UNIVERSALISM (code 89) to use to capture the UNITARIAN-UNIVERSALISM (code 28) which is being replaced by UNITARIAN-UNIVERSALIST (Code 28). Patch DG*5.3*1093 adds five additional new entries to the RELIGION file (#13): AFRICAN AMERICAN EPISCOPAL (code 84), BUDDHISM, OTHER (code 85), EVANGELICAL (code 86), HOLINESS CHURCHES (code 87), and CATHOLIC (NON-ROMAN CATHOLIC) (code 88). Patch DG*5.3*1093 modifies the file description of the RELIGION file (#13). All of the data previously entered into Vista regarding the patient status as an Indian or having Tribal Affiliation has been deemed to be incorrect due to the Veteran having to make a self-attestation. A Validation Process is being put in place with a list of acceptable documentation that a Veteran must present in order to verify their Tribal Affiliation. Due to this, Patch DG*5.3*1093 makes the following changes: - The PATIENT DATA, SCREEN <2> screen is modified to prevent the entry of data in group 6, Indian attestation data. Group <6> is made read-only. - The Health Level 7 (HL7) ORU/ORF Z07 message is modified. The Indian attestation related fields in the ZPD segment will contain NULL values. - The INDIAN SELF IDENTIFICATION field (#.571) and the INDIAN ATTESTATION DATE field (#.573) of the PATIENT file (#2) have the trigger removed which queues an ORU-Z07 HL7 message to be sent to VES, and the Write Authority flag is set on both, which prevents entry of data via VA FileMan. - All Indian attestation data is removed from patient records in the PATIENT file (#2). Refer to the Pre/Post Installation Overview section for details on this process. Patch DG*5.3*1093 includes a fix to an error encountered when entering the Preferred Language in the PATIENT DEMOGRAPHIC DATA, SCREEN <1> screen. See the Defect Tracking System Ticket(s) & Overview section for details. ************************************************************************** SECTION 1: DATA DICTIONARY UPDATES ************************************************************************** 1. The NAME field (#.01) of the existing entry with a CODE field (#3) of 28 in the RELIGION file (#13) is changed from UNITARIAN-UNIVERSALISM to UNITARIAN-UNIVERSALIST: NAME: UNITARIAN-UNIVERSALIST CODE: 28 2. A separate entry has been created for UNITARIAN-UNIVERSALISM (code 89) to use to capture the UNITARIAN-UNIVERSALISM (code 28) which is being replaced by UNITARIAN-UNIVERSALIST (Code 28). NAME: UNITARIAN-UNIVERSALISM CODE: 89 3. An additional five entries have been added to the RELIGION file (#13). Only the NAME field (#.01) and the CODE field (#3) are populated: NAME CODE ----------------------------- ---- AFRICAN AMERICAN EPISCOPAL 84 BUDDHISM, OTHER 85 EVANGELICAL 86 HOLINESS CHURCHES 87 CATHOLIC (NON-ROMAN CATHOLIC) 88 4. The DESCRIPTION field (#4) is modified for the RELIGION file (#13) entry in the FILE file (#1). The "currently contains 84 entries" phrase is changed to "currently contains 90 entries". Also, the typo "affects" is changed to "effects": BEFORE: NUMBER: 13 NAME: RELIGION APPLICATION GROUP: VA DESCRIPTION: The RELIGION file currently contains 84 entries. These entries are determined by VACO MAS. This file should not be added to nor should entries in it be altered or deleted by the facility. Entry, edit or deletion of these entries could have severe negative affects on the performance of the MAS module. AFTER: NUMBER: 13 NAME: RELIGION APPLICATION GROUP: VA DESCRIPTION: The RELIGION file currently contains 90 entries. These entries are determined by VACO MAS. This file should not be added to nor should entries in it be altered or deleted by the facility. Entry, edit or deletion of these entries could have severe negative effects on the performance of the MAS module. 5. The INDIAN SELF IDENTIFICATION field (#.571) and the INDIAN ATTESTATION DATE field (#.573) of the PATIENT file (#2) have the trigger removed which queues an HL7 ORU-Z07 message to be sent to VES and the Write Authority flag set, which prevents entry of data via VA FileMan. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2,.571 INDIAN SELF IDENTIFICATION .57;1 SET (audited) 'Y' FOR YES; 'N' FOR NO; LAST EDITED: APR 27, 2023 HELP-PROMPT: Enter YES or NO, as answered by the Applicant on the 1010EZ or 1010EZR in response to the Are you an Indian question. DESCRIPTION: This field will contain the value from the "Are you an Indian" question on the 1010EZ, 1010EZR, or the online application as answered by the applicant. AUDIT: YES, ALWAYS WRITE AUTHORITY: ^ UNEDITABLE CROSS-REFERENCE: ^^TRIGGER^2^.575 1)= K DIV S DIV=X,D0=DA,DIV(0)=D0 S Y(1)=$ S($D(^DPT(D0,.57)):^(.57),1:"") S X=$P(Y(1 ),U,5),X=X S DIU=X K Y S X=DIV S X=$$NOW^X LFDT() S DIH=$G(^DPT(DIV(0),.57)),DIV=X S $P(^(.57),U,5)=DIV,DIH=2,DIG=.575 D ^DICR 2)= K DIV S DIV=X,D0=DA,DIV(0)=D0 S Y(1)=$ S($D(^DPT(D0,.57)):^(.57),1:"") S X=$P(Y(1 ),U,5),X=X S DIU=X K Y S X=DIV S X=$$NOW^X LFDT() S DIH=$G(^DPT(DIV(0),.57)),DIV=X S $P(^(.57),U,5)=DIV,DIH=2,DIG=.575 D ^DICR CREATE VALUE)= S X=$$NOW^XLFDT() DELETE VALUE)= S X=$$NOW^XLFDT() FIELD)= INDIAN SELF IDENT CHANGE DT/TM This cross-reference will be used to update the Date/Time stamp for an Indian Self Identification change. 2,.573 INDIAN ATTESTATION DATE .57;3 DATE (audited) INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X K:Y>DT X K :Y=-1 X LAST EDITED: APR 27, 2023 HELP-PROMPT: Enter the Stamp Date from the hard copy 1010EZ or 1010EZR. If no Stamp Date was indicated, enter today's date. The date cannot be in the future. DESCRIPTION: This field will contain the date on which an applicant or previously enrolled Veteran informed the VA of their status as an Indian. AUDIT: YES, ALWAYS WRITE AUTHORITY: ^ UNEDITABLE NOTES: XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER ************************************************************************** SECTION 2: REGISTRATION SCREEN UPDATES ************************************************************************** The PATIENT DATA, SCREEN <2>, screen Data Group 6 is made read-only. Any Indian attestation data will be displayed but the user will be unable to enter/edit the data. ** BEGIN SCREEN CAPTURE ** PATIENT DATA, SCREEN <2> DGPATIENT,ONE MON DD,YYYY XXX-XX-XXXX NSC VETERAN ========================================================================== [1] Marital: DIVORCED POB: CHICAGO, ILLINOIS Religion: LUTHERAN Father: UNANSWERED SCI: NOT APPLICABLE Mother: UNANSWERED Mom's Maiden: HUFF, [2] Previous Care Date Location of Previous Care NONE INDICATED NONE INDICATED [3] Ethnicity: UNANSWERED Race: UNANSWERED <4> Date of Death Information Date of Death: Source of Notification: Updated Date/Time: Last Edited By: [5] Emergency Response: <6> Indian: UNANSWERED to CONTINUE, 1,2,3,5 or ALL to EDIT, ^N for screen N or '^' to QUIT: ** END SCREEN CAPTURE ** ************************************************************************** SECTION 3: HL7 ORU/ORF-Z07 PROCESSING ************************************************************************** The fields below are set to NULL in the ZPD segment in the ORU/ORF Z07 HL7 message when sending data to VES. Processing incoming data from VES on the Z11 is not changed. SEQ FIELD --- ----- 42 INDIAN SELF IDENTIFICATION 43 INDIAN ATTESTATION DATE 44 INDIAN START DATE 45 INDIAN END DATE Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- ------------------- FILE (#1) N/A - The description of the RELIGION entry is changed PATIENT (#2) INDIAN SELF IDENTIFICATION (#.571) Modified INDIAN ATTESTATION DATE (.#573) Modified 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: ----------------------- N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- Problem: -------- INC26282817 -R2 - (MIN) VISTA PREFERRED LANGUAGE GLITCH When editing data groups 1,5 in the PATIENT DEMOGRAPHIC DATA, SCREEN <1> screen, an error is encountered when entering the Preferred Language. Resolution: ----------- Variables X and Y are NEW'd at DR207^DGRPE1 to protect them when calling ^DIR to enter the Preferred Language. Test Sites: ----------- Alaska VA Healthcare System (Anchorage) VA Pittsburgh Healthcare System, PA VA North Florida / South Georgia VA Health Care System (Gainesville FL, Lake City GA) Minneapolis VA Medical Center, MN Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. 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*5.3*1093 Release Notes DG_5_3_1093_RN.PDF PIMS Version 5.3 Technical Manual PIMS_TM.PDF PIMS Version 5.3 User Manual - Registration Menu PIMS_REG_UM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- The pre-install routine PRE^DG531093P changes the NAME field (#.01) of the existing entry "UNITARIAN-UNIVERSALISM" to "UNITARIAN-UNIVERSALIST" in the RELIGION file (#13). The post-install routine POST^DG531093P performs the following actions: - Removes the trigger that queues an ORU Z07 HL7 message to VES for the INDIAN SELF IDENTIFICATION field (#.571) and the INDIAN ATTESTATION DATE field (#.573) in the PATIENT file (#2). - Queues off a background job to remove all Indian attestation data from the patient records in the PATIENT file (#2). This process runs through each patient record and for any record that contains data in the INDIAN SELF IDENTIFICATION field (#.571), the following fields are set to NULL: a. INDIAN SELF IDENTIFICATION field (#.571) b. INDIAN START DATE field (#.572) c. INDIAN ATTESTATION DATE field (#.573) d. INDIAN END DATE field (#.574) e. INDIAN SELF IDENT CHANGE DT/TM field (#.575) f. INDIAN SELF IDENT CHANGE USER field (#.576) - Upon successful completion of the job, a MailMan message is sent to the Patch installer. This message contains statistics of the job, including start and end times. - The statistics as well as the list of DFNs of the records that were modified are captured in the ^XTMP("DG531093P" global. The MailMan message will include information on where to view that list. See an example of the message in the 'Post-Installation Instructions' section. Should this patch be re-installed, the background job will not be queued and the ^XTMP("DG531093P" global from the original installation will not be removed. 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 options should be disabled during installation. Register a Patient [DG REGISTER PATIENT] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Load/Edit Patient Data [DG LOAD PATIENT DATA] Eligibility Verification [DG ELIGIBILITY VERIFICATION] View Registration Data [DG REGISTRATION VIEW] Collateral Patient Register [DG COLLATERAL PATIENT] Enter a Request/Notification [FBCH ENTER REQUEST] Installation Instructions: 1. Choose the PackMan message containing this build. Then select the INSTALL/CHECK MESSAGE PackMan option to load the build. 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 the patch or build name. (ex. DG*5.3*1093) 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*1093 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. 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? NO//', 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] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Load/Edit Patient Data [DG LOAD PATIENT DATA] Eligibility Verification [DG ELIGIBILITY VERIFICATION] View Registration Data [DG REGISTRATION VIEW] Collateral Patient Register [DG COLLATERAL PATIENT] 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: ------------------------------- IMPORTANT NOTE: Do not do the following steps until you have received the MailMan message indicating the successful completion of the DG531093P post-installation background step. A sample of that message is shown below. 1. The post-installation routine DG531093P should be manually deleted from your system using the KERNEL option Delete Routines [XTRDEL]. 2. 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]. 3. 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. Below is a sample of the MailMan message upon the completion of the post-installation job which is sent to the patch installer. Subj: DG*5.3*1093 INDIAN ATTESTATION DATA CLEANUP JOB RESULTS [#507392] 04/27/23@12:57 22 lines From: POSTMASTER In 'IN' basket. Page 1 *New* -------------------------------------------------------------------------- The DG*5.3*1093 process has completed. This process ran through the PATIENT file (#2) and for each patient record, if a value was defined in the INDIAN SELF IDENTIFICATION field (#.571), these fields were set to null: - INDIAN SELF IDENTIFICATION field (#.571) - INDIAN START DATE field (#.572) - INDIAN ATTESTATION DATE field (#.573) - INDIAN END DATE field (#.574) - INDIAN SELF IDENT CHANGE DT/TM field (#.575) - INDIAN SELF IDENT CHANGE USER field (#.576) The process statistics: Job Start Date/Time: APR 27, 2023@12:57:04 Job End Date/Time: APR 27, 2023@12:57:04 Total records with INDIAN ATTESTATION data removed: 27 Total errors encountered: 0 If a list of records that had Indian Attestation data removed is needed, you may view global ^XTMP("DG531093P",28614,"IA" NOTE: The global ^XTMP("DG531093P") will be purged after 60 days. 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. The development team will then assist with the backout process and restoration of the Data Dictionary for the Patient file (#2) and the data for the FILE file (#1) and the RELIGION file (#13). Any issues would need to be evaluated to determine if a back-out of the software is appropriate or if a new patch is needed. NOTE: Due to the fact that the VA has determined that a self-attestation by the Veteran is insufficient to claim being an Indian or having a tribal affiliation, all data regarding Indian Attestation entered prior to the release of this patch has been determined to be invalid. Therefore, backing up Indian Attestation data was not included as part of the installation instructions for this patch and this data should not be restored as part of any rollback process. 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*1093, on May 2, 2023." Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 12 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DG531093P Before: n/a After: B76638766 **1093** Routine Name: DGENPTA1 Before: B37867609 After: B38212371 **121,147,314,677,659,653,688, 810,754,838,841,842,978,1036, 1064,1093** Routine Name: DGRP2 Before: B17144398 After: B17259664 **415,545,638,677,760,867,1014, 1064,1093** Routine Name: DGRPE1 Before: B14854913 After: B14922549 **114,327,451,631,688,808,804, 909,952,1085,1093** Routine Name: DGRPV Before: B22201716 After: B22343325 **109,114,247,190,327,365,343, 397,415,489,546,545,451,624, 677,672,689,716,688,797,842, 871,887,941,985,997,1014,1064, 1081,1093** Routine Name: VAFHLZPD Before: B78945651 After: B73360025 **94,122,160,220,247,545,564, 568,677,653,688,1002,1064,1085, 1093** Routine list of preceding patches: 1081, 1085 ============================================================================= User Information: Entered By : Date Entered : FEB 03, 2023 Completed By: Date Completed: JUL 24, 2023 Released By : Date Released : JUL 24, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT