$TXT Created by at DEVVOO.DOMAIN.EXT (KIDS) on Friday, 05/17/24 at 08:32 ============================================================================= Run Date: JUN 27, 2024 Designation: DG*5.3*1118 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #981 Status: Released Compliance Date: JUL 10, 2024 ============================================================================= Associated patches: (v)DG*5.3*1103 <<= must be installed BEFORE `DG*5.3*1118' (v)DG*5.3*1111 <<= must be installed BEFORE `DG*5.3*1118' Subject: VIETNAM MSE DATES, CHANGE TERA DISPLAY UPDATES, CONSISTENCY CHECKS Category: - Enhancement (Mandatory) - Routine - Data Dictionary Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1118 is being released to support enhancements for the Eligibility and Enrollment (E&E) program. Patch DG*5.3*1118 is also being released in support of the Veterans Health Administration (VHA) Enrollment System (VES) 6.10 release. Patch DG*5.3*1118 modifies two entries in the PERIOD OF SERVICE file (#21). Patch DG*5.3*1118 modifies seven entries in the INCONSISTENT DATA ELEMENTS file (#38.6) and via a pre-install routine checks two additional entries to ensure their names are correct. Patch DG*5.3*1118 adds text to the HELP PROMPT, DESCRIPTION and TECHNICAL DESCRIPTION fields of the TOXIC EXPOSURE RISK ACTIVITY field (#.32116) in the PATIENT file (#2). Listing of Updates: =================== This patch makes the following enhancements to VistA REE: ************************************************************************** SECTION 1: DATA DICTIONARY UPDATES ************************************************************************** 1. The BEGIN DATE field (#.04) and the BRIEF DESCRIPTION field (#20) in the PERIOD OF SERVICE file (#21) for the VIETNAM ERA entry is modified to NOV 01, 1955 and (11/1/1955-5/7/1975) respectively. This update occurs via a post-install routine. Refer to the Pre/Post Installation Overview section for details on this process. NAME: VIETNAM ERA ABBREVIATION: VE CODE: 7 BEGIN DATE: NOV 01, 1955 END DATE: MAY 07, 1975 WAR/PEACE: WAR LATEST DOB: 1960 PTF CODE: 6 BRIEF DESCRIPTION: (11/1/1955-5/7/1975) ELIGIBILITY: SERVICE CONNECTED 50% to 100% ELIGIBILITY: AID & ATTENDANCE ELIGIBILITY: SC LESS THAN 50% ELIGIBILITY: NSC, VA PENSION ELIGIBILITY: NSC ELIGIBILITY: HUMANITARIAN EMERGENCY ELIGIBILITY: DOM. PATIENT ELIGIBILITY: HOUSEBOUND ELIGIBILITY: PRISONER OF WAR ELIGIBILITY: PURPLE HEART RECIPIENT 2. The END DATE field (#.05) and the BRIEF DESCRIPTION field (#20) in the PERIOD OF SERVICE file (#21) for the POST-KOREAN entry is modified to OCT 31, 1955 and (2/1/1955-10/31/1955) respectively. This update occurs via a post-install routine. Refer to the Pre/Post Installation Overview section for details on this process. NAME: POST-KOREAN CODE: 5 BEGIN DATE: FEB 01, 1955 END DATE: OCT 31, 1955 WAR/PEACE: PEACE LATEST DOB: 1949 PTF CODE: 5 BRIEF DESCRIPTION: (2/1/1955-10/31/1955) ELIGIBILITY: SERVICE CONNECTED 50% to 100% ELIGIBILITY: AID & ATTENDANCE ELIGIBILITY: SC LESS THAN 50% ELIGIBILITY: NSC, VA PENSION ELIGIBILITY: NSC ELIGIBILITY: HUMANITARIAN EMERGENCY ELIGIBILITY: DOM. PATIENT ELIGIBILITY: HOUSEBOUND ELIGIBILITY: PRISONER OF WAR ELIGIBILITY: PURPLE HEART RECIPIENT 3. Field (#5) CHECK/DON'T CHECK and field (#6) USE FOR Z07 CHECK in the INCONSISTENT DATA ELEMENTS File (#38.6) will be verified to be 'DON'T CHECK' and 'NO' respectively. If not, they will be reset to those values. The entries are listed here after being reset: NUMBER: 4 NAME: DOB UNSPECIFIED TEXT: 'DATE OF BIRTH' IS UNSPECIFIED KEY REQUIRED: NO KEY REQUIRED SET ELIG DR STRING: NO CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: Inconsistency results if the 'DOB' prompt is not answered. NUMBER: 11 NAME: SC PROMPT INCONSISTENT TEXT: 'SERVICE CONNECTED' PROMPT INCONSISTENT WITH NON-VET STATUS KEY REQUIRED: ELIGIBILITY VERIFIED SET ELIG DR STRING: YES CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: Inconsistency results if the 'SERVICE CONNECTED' prompt is inconsistent with the 'VETERAN (Y/N)' prompt. NUMBER: 19 NAME: ELIG/NONVET STAT INCONSISTENT TEXT: 'ELIGIBILITY CODE' INCONSISTENT WITH NON-VET STATUS KEY REQUIRED: ELIGIBILITY VERIFIED SET ELIG DR STRING: YES CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: Inconsistency results if the 'VETERAN (Y/N)' prompt is answered NO but the 'ELIGIBILITY CODE' assigned is a veteran specific code. NUMBER: 34 NAME: POW CLAIMED, NONVET TEXT: 'PRISONER OF WAR' CONFINEMENT INDICATED FOR NON-VETERAN KEY REQUIRED: SERVICE VERIFIED SET ELIG DR STRING: YES CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: Inconsistency results if the patient is a non-veteran and the 'WERE YOU A PRISONER OF WAR' prompt is answered YES. NUMBER: 309 NAME: PATIENT RELATIONSHIP INVALID TEXT: RELATIONSHIP TO PATIENT IS NOT A VALID VALUE KEY REQUIRED: NO KEY REQUIRED SET ELIG DR STRING: NO CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: The value of Relationship to Patient does not match one of the valid values. NUMBER: 310 NAME: DEPENDENT EFF. DATE REQUIRED TEXT: DEPENDENT(S) EFFECTIVE DATE IS MISSING KEY REQUIRED: NO KEY REQUIRED SET ELIG DR STRING: NO CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: A dependent is present but the effective date is null. NUMBER: 312 NAME: PERSON MUST HAVE NATIONAL ICN TEXT: PERSON MUST HAVE NATIONAL ICN KEY REQUIRED: NO KEY REQUIRED SET ELIG DR STRING: NO CHECK/DON'T CHECK: DON'T CHECK USE FOR Z07 CHECK: NO DESCRIPTION: Person does not have National ICN. 4. The TOXIC EXPOSURE RISK ACTIVITY field (#.32116) in the PATIENT file (#2) has text added to the HELP PROMPT, DESCRIPTION and TECHNICAL DESCR fields as shown below: DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2,.32116 TOXIC EXPOSURE RISK ACTIVITY .321;16 SET (BOOLEAN Data Type) LAST EDITED: MAR 21, 2024 HELP-PROMPT: This field is not editable in VistA and is only shared so that it may be displayed to a VistA user along with the patient's other Environmental Factors. Any required updates can only be made in VES. DESCRIPTION: This field should be set to YES if the patient claims exposure to Toxic Exposure Risk Activity (TERA), NO if there was no exposure or UNKNOWN if exposure is not known. The Toxic Exposure Risk Activity indicator will be entered and maintained by the VHA Enrollment System and shared with VistA via HL7 messaging. The field will not be editable in VistA and is only shared so that it may be displayed to a VistA user along with the patient's other Environmental Factors. The TERA Indicator is stored internally as 1 for YES, 0 for No and NULL for UNKNOWN. TECHNICAL DESCR: The Toxic Exposure Risk Activity (TERA) Indicator is stored internally as 1 for YES, 0 for No and NULL for UNKNOWN. It will be entered and maintained by the VHA Enrollment System and shared with VistA via HL7 messaging. Write access for this field is "^". This field is UNEDITABLE. WRITE AUTHORITY: ^ UNEDITABLE ************************************************************************** SECTION 2: REGISTRATION SCREEN UPDATES ************************************************************************** The ENVIRONMENTAL FACTORS screen of the Environment Factors data group (3) on the MILITARY SERVICE DATA, SCREEN <6> screen has been updated. The TERA prompt will display UNKNOWN if the TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2) is NULL. The default value for a patient is "UNKNOWN" if no value was entered. TEST,PATIENT A MMM DD, YYYY ###-##-#### NSC VETERAN ================================================================ **** ENVIRONMENTAL FACTORS **** <1> A/O Exp.: Reg: Exam: <2> ION Rad.: Reg: Method: [3] SW Asia Cond: NO Reg: Exam: [4] N/T Radium: <5> Camp Lejeune: <6> TERA: UNKNOWN Only VES users may enter/edit Agent Orange or ION Radiation Exposure or Toxic Exposure Risk Activity (TERA). ************************************************************************** SECTION 3: VADPT API & ICR MODIFICATIONS ************************************************************************** In support of external packages requiring access to the new TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2), patch DG*5.3*1118 modifies the supported Integration Control Registration (ICR) #10061 for the Service data Application Programming Interface (API) in SVC^VADPT. The new TOXIC EXPOSURE RISK ACTIVITY field (#.32116) field is accessible in the (15) node of the array created by SVC^VADPT (API). The format of this field will be the internal and external values separated by a "^" character. The data in node 15 will be either "1^YES", "0^NO", or if the value of the field is NULL, the return value will be "^UNKNOWN". For example: VASV(15)="^UNKNOWN" The optional input variable VAHOW can be set to return the data in alpha subscripts. The TERA indicator is returned in the "TERA" subscript. For example: VASV("TERA")="0^NO" NOTE: For additional information on the SVC^VAPDT API, see the Patient Information Management System (PIMS) Technical Manual located on the Veteran Affairs (VA) Software Document Library Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT (#2) TOXIC EXPOSURE RISK MODIFIED ACTIVITY (#.32116) 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: -------------------------------------------- N/A Test Sites: ----------- Oscar G. Johnson VA Medical Center (MI) Amarillo VA Health Care System (TX) Pittsburgh Healthcare System (PA) Test Sites - SNOW Change Order #: --------------------------------- Oscar G. Johnson VA Medical Center: CHG0486919 Amarillo VA Health Care System: CHG0490232 Pittsburgh Healthcare System: CHG0489662 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*1118 Release Notes DG_5_3_1118_RN.PDF PIMS Version 5.3 User Manual - Registration Menu PIMS_REG_UM.PDF PIMS Version 5.3 Technical Manual PIMS_TM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- The pre-install routine PRE^DG531118P evaluates the NAME field (#.01) in the INCONSISTENT DATA ELEMENTS file (#38.6) for entries 49:INSURANCE YES BUT NONE ACTIVE and 50:INSUR. NOT YES BUT SOME ACTIVE. If the values in NAME field (#.01) for 49 and 50 are not correct, they will be updated to "INSURANCE YES BUT NONE ACTIVE" and "INSUR. NOT YES BUT SOME ACTIVE" respectively. The post-install routine POST^DG531118P updates the BEGIN DATE field (#.04) and BRIEF DESCRIPTION field (#20) for the VIETNAM ERA entry and the END DATE field (#.05) and BRIEF DESCRIPTION field (#20) for the POST-KOREAN entry in the PERIOD OF SERVICE file (#21). The pre/post-install routine is automatically deleted upon completion of the patch installation process. 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. The following options should be disabled during installation: Option Name Menu Text ----------- --------- Register a Patient [DG REGISTER PATIENT] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Collateral Patient Register [DG COLLATERAL PATIENT] Patient Enrollment [DGEN PATIENT ENROLLMENT] 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*1118) 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*1118. 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] Load/Edit Patient Data [DG LOAD PATIENT DATA] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Collateral Patient Register [DG COLLATERAL PATIENT] Patient Enrollment [DGEN PATIENT ENROLLMENT] 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: ------------------------------- N/A 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*1118, on July 2, 2024." 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]**;Apr 10 2024;Build 7 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DG531118P Before: n/a After: B26231660 **1118** Routine Name: DGRP6EF Before: B57892976 After: B59478265 **689,659,737,688,909,1014,1018, 1075,1084,1090,1103,1118** Routine Name: VADPT4 Before: B45318693 After: B45604614 **343,342,528,689,688,790,797, 935,952,1007,1018,1090,1103, 1118** ============================================================================= User Information: Entered By : Date Entered : JAN 23, 2024 Completed By: Date Completed: JUN 27, 2024 Released By : Date Released : JUN 27, 2024 ============================================================================= Packman Mail Message: ===================== $END TXT