============================================================================= Run Date: APR 26, 2021 Designation: DG*5.3*1018 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #913 Status: Released Compliance Date: MAY 06, 2021 ============================================================================= Associated patches: (v)DG*5.3*993 <<= must be installed BEFORE `DG*5.3*1018' (v)DG*5.3*1007 <<= must be installed BEFORE `DG*5.3*1018' (v)DG*5.3*1014 <<= must be installed BEFORE `DG*5.3*1018' Subject: AGENT ORANGE EXPOSURE FOR BLUE WATER NAVY VETERANS Category: - Routine - Enhancement (Mandatory) - Data Dictionary Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1018 is being released to support the enhancements for the Enterprise Health Benefits Determination (EHBD) program. This patch focuses on updates for the Enrollment System Modernization (ESM) Phase 3 project. Patch DG*5.3*1018 is also being released in support of the Enrollment System (ES) 5.15 release. Refer to Informational Patch EAS*1*196 (Enrollment Application System) for additional details regarding the ES release. NOTE: DG*5.3*1018 is being released in Host File DG_53_P1018.KID. VistA currently allows Agent Orange (AO) exposure information to be associated to a Veteran during registration. Patch DG*5.3*1018 adds a new AO Exposure Location for Blue Water Navy Veterans. VistA assigns Veterans to Priority Group 6 when the AO Indicator is YES and the AO Exposure Location is "B". VistA continuous enrollment rules for the AO Exposure Location of VIETNAM are updated to include the AO Exposure Location of "B". VistA and ES share the new AO Exposure Location of BLUE WATER NAVY in existing Health Level 7 (HL7) messages. Listing of Updates ------------------ 1. A new value of B for BLUE WATER NAVY is added to the AGENT ORANGE EXPOSURE LOCATION (#.3213) field in the PATIENT (#2) file. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------- 2,.3213 AGENT ORANGE EXPOSURE LOCATION .321;13 SET (Required) Agent Orange Exposure Location 'B' FOR BLUE WATER NAVY; 'K' FOR KOREAN DMZ; 'V' FOR VIETNAM; 'O' FOR OTHER; 2. A new value of B for BLUE WATER NAVY is added to the AGENT ORANGE EXPOSURE LOCATION (#50.22) field in the PATIENT ENROLLMENT (#27.11) file. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------- 27.11,50.22 AGENT ORANGE EXPOSURE LOCATION E;22 SET 'B' FOR BLUE WATER NAVY; 'K' FOR KOREAN DMZ; 'V' FOR VIETNAM; 'O' FOR OTHER; 3. BWN ACTIVE DATE (#1402) field is added to the MAS PARAMETERS (#43) file. The field is used to ensure users cannot add BLUE WATER NAVY as an AO Exposure Location before that date. The field is populated during the installation of the patch by a post-install routine to a value of 05/10/2021 and cannot be modified by the user. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------- 43,1402 BWN ACTIVE DATE BWN;1 DATE INPUT TRANSFORM: S %DT="EX" D ^%DT S X=Y K:Y<1 X LAST EDITED: DEC 07, 2020 HELP-PROMPT: Enter the date on which "BLUE WATER NAVY" is a valid Agent Orange Exposure Location and can be entered by the user. DESCRIPTION: The date on which "BLUE WATER NAVY" is a valid Agent Orange Exposure Location and can be entered by the user. UNEDITABLE 4. The Description of the AGENT ORANGE EXPOS. INDICATED? (.32102) field in the PATIENT (#2) file is updated. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------- 2,.32102 AGENT ORANGE EXPOS. INDICATED? .321;2 SET (Required) EXPOSED TO AGENT ORANGE 'Y' FOR YES; 'N' FOR NO; 'U' FOR UNKNOWN; INPUT TRANSFORM: S DFN=DA D SV^DGLOCK LAST EDITED: DEC 09, 2020 HELP-PROMPT: Enter 'Y' if this patient claims exposure to agent orange, 'N' if not, 'U' if unknown DESCRIPTION: For this veteran applicant enter 'Y' if s/he was exposed to the chemical agent orange, 'N' if not, or 'U' if unknown. Exposure can be claimed by those serving in the KOREAN DMZ between January 1, 1968 and December 31, 1969; or served in country in Vietnam or the offshore waters of Vietnam during Jan 9, 1962 to May 7, 1975. When Consistency Check # 25 is active (AGENT ORANGE EXPOSURE INDICATED WITHOUT VIETNAM ERA PERIOD OF SERVICE), exposure cannot be claimed unless the Period of Service (#.323) field in the Patient (#2) file is answered VIETNAM ERA, which entails those serving in the Korean DMZ between January 1, 1968 and December 31, 1969 or served in country in Vietnam or the offshore waters of Vietnam during Jan 9, 1962 to May 7, 1975. Once the service record has been verified only users who hold the designated security key may enter/edit this field. 5. On the ENVIRONMENTAL FACTORS screen, "(BWN)" displays when BLUE WATER NAVY is the Agent Orange Exposure Location of the Veteran. * BEGIN SCREEN CAPTURE * DGPATIENT,ONE XXX XX, XXXX XXX-XX-XXXX NSC VETERAN ========================================================================== **** ENVIRONMENTAL FACTORS **** [1] A/O Exp.: YES (BWN) Reg: 12/14/2020 Exam: 12/14/2020 A/O#: [2] ION Rad.: Reg: Method: [3] SW Asia Cond: Reg: Exam: [4] N/T Radium: <5> Camp Lejeune: SELECT AN ENVIRONMENTAL FACTOR (1-4) OR (Q)UIT: QUIT// * END SCREEN CAPTURE * 6. On the ENVIRONMENTAL FACTORS screen, in Group [1], the AGENT ORANGE EXPOSURE LOCATION: prompt accepts "B" for BLUE WATER NAVY as a valid entry ONLY on or after the date value in the BWN ACTIVE DATE (#1402) field in the MAS PARAMETERS (#43) file. * BEGIN SCREEN CAPTURE * DGPATIENT,ONE XXX XX, XXXX XXX-XX-XXXX NSC VETERAN ========================================================================== **** ENVIRONMENTAL FACTORS **** [1] A/O Exp.: YES (BWN) Reg: 12/14/2020 Exam: 12/14/2020 A/O#: [2] ION Rad.: Reg: Method: [3] SW Asia Cond: Reg: Exam: [4] N/T Radium: <5> Camp Lejeune: SELECT AN ENVIRONMENTAL FACTOR (1-4) OR (Q)UIT: QUIT// 1 A/O Exp AGENT ORANGE EXPOS. INDICATED?: YES// AGENT ORANGE EXPOSURE LOCATION: BLUE WATER NAVY// ? Enter where the patient was exposed to agent orange. Available locations are shown. Choose from: B BLUE WATER NAVY K KOREAN DMZ V VIETNAM O OTHER AGENT ORANGE EXPOSURE LOCATION: BLUE WATER NAVY// * END SCREEN CAPTURE * 7. On the ENVIRONMENTAL FACTORS screen, when a user enters "?" or "??" at the AGENT ORANGE EXPOSURE LOCATION: prompt, "B BLUE WATER NAVY" displays in the list of locations ONLY on or after the date value in the BWN ACTIVE DATE (#1402) field in the MAS PARAMETERS (#43) file. 8. When the Veteran's current enrollment record meets the following criteria, VistA assigns Priority Group 6 to the Veteran unless entitled to care at a higher level due to other eligibilities: AGENT ORANGE EXPOS. INDICATED? (#.32102) field in the PATIENT (#2) file is YES, AND the AGENT ORANGE EXPOSURE LOCATION (#.3213) field in the PATIENT (#2) file is "V" or "B", AND the AO STA EXP DATE (#1301) field in the MAS PARAMETERS (#43) file is NULL OR today's date is before the date in the AO STA EXP DATE (#1301) field in the MAS PARAMETERS (#43) file. 9. The continuous enrollment rule related to Agent Orange for Vietnam is updated. The Veteran shall be continuously enrolled if the AGENT ORANGE EXPOS. INDICATED? (#.32102) field of the PATIENT (#2) file is Yes, AND the AGENT ORANGE EXPOSURE LOCATION (#.3213) of the PATIENT (#2) file is VIETNAM or BLUE WATER NAVY, and the AO STA EXP DATE (#1301) field in the MAS PARAMETERS (#43) file is not null, and the Veteran's Enrollment Date is prior to the date in the AO STA EXP DATE (#1301) field in the MAS PARAMETERS (#43) file. 10. HL7 ORU/ORF Z07 processing is updated to populate ZEL segment AGENT ORANGE EXPOSURE LOCATION (Sequence Number 29) with value "B" for BLUE WATER NAVY if the PATIENT (#2) file AGENT ORANGE EXPOSURE LOCATION (#.3213) field has a value of "B" for BLUE WATER NAVY. 11. HL7 ORU/ORF Z11 processing is updated to no longer set the VistA AGENT ORANGE EXPOSURE LOCATION (#.3213) field in the PATIENT (#2) file to "V" when the VistA AO Exposure Location is Blank, and ES sends Exposed to Agent Orange = Y and no AO Exposure Location. 12. The Eligibility Upload Changes screen accessed from AU View Upload Audit action protocol within the Patient Enrollment [DGEN PATIENT ENROLLMENT] option displays BLUE WATER NAVY after the "A/O Exp Loc:" label when the selected ORU/ORF Z11 message from ES contains the AO Exposure Location of "B". 13. The supported VADPT API is updated to return the correct external codes from the AGENT ORANGE EXPOSURE LOCATION (#.3213) field of the PATIENT (#2) file in the Agent Orange Exposure Location node in the VASV array, VASV(2,5). This array is created by the SVC component of the VADPT API (SVC^VADPT). The supporting Integration Control Registration for this API is 10061: INTEGRATION REFERENCE INQUIRY #10061 JAN 21, 2021@12:08 PAGE 1 -------------------------------------------------------------------- 10061 NAME: VADPT CUSTODIAL PACKAGE: REGISTRATION Albany SUBSCRIBING PACKAGE: USAGE: Supported ENTERED: MAR 7,1994 STATUS: Active EXPIRES: DURATION: VERSION: DESCRIPTION: TYPE: Routine VADPT is a utility routine designed to provide a central point where a programmer can obtain information concerning a patient's record. Supported entry points are provided which will return demographics, inpatient status, eligibility information, etc. Access to patient information is not limited to using the supported entry points in VADPT. Integration agreements can be established through the DBA between REGISTRATION and other packages to reference information. This integration agreement does not document the input and output variables for any of the components of VADPT. That documentation is located in the PIMS technical manual, section 12.2 CALLABLE ENTRY POINTS IN VADPT. ROUTINE: VADPT COMPONENT: SVC Returns Service-related information for a patient. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- MAS PARAMETERS (#43) BWN ACTIVE DATE (#1402) NEW PATIENT (#2) AGENT ORANGE EXPOSURE MODIFIED LOCATION (#.3212) AGENT ORANGE EXPOS. MODIFIED INDICATED? (#.32102) PATIENT ENROLLMENT (#27.11) AGENT ORANGE EXPOSURE MODIFIED LOCATION (#50.22) 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: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: ----------- Alaska VA Healthcare System, Anchorage, AK Durham VA Medical Center, Durham, NC VA North Florida/South Georgia Veterans Health System, Gainesville/Lake City, FL 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_P1018.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_P1018.KID Release Notes DG_5_3_P1018_RN.PDF PIMS Version 5.3 Technical Manual ADT_PIMS_TM.PDF User Manual Version 5.3 - Registration Menu ADT_PIMS_REG_UM.PDF PIMS Version 5.3 User Manual - ADT Module ADTBE_UM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- The post-install routine, DG531018P, sets the BWN ACTIVE DATE (#1402) field in the MAS PARAMETERS (#43) file to 05/10/2021. NOTE: The post install routine will be automatically deleted after installation by the KIDS build. 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] 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] Load/Edit PTF Data [DG PTF SCREEN] Quick Load/Edit PTF Data [DG PTF QUICK LOAD] 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_P1018.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 the patch DG*5.3*1018. 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 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*1018 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 your build? 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] 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] Load/Edit PTF Data [DG PTF SCREEN] Quick Load/Edit PTF Data [DG PTF QUICK LOAD] 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: ------------------------------- The HL7 incoming/outgoing 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]. 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 restorations. During installation, if the option "Backup a Transport Global" was run as directed, then the entire Build or Routines (depending on which option was chosen) will have the ability to be restored from the "backup" MailMan message that was generated Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 4 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DG531018P Before: n/a After: B3117216 **1018** Routine Name: DGENEGT1 Before: B67955645 After: B70366781 **232,417,454,491,513,451,564, 672,717,688,803,754,1018** Routine Name: DGENELA4 Before: B84037308 After: B86716569 **232,275,306,327,314,367,417, 437,456,491,451,564,672,659, 653,688,803,754,841,909,972, 952,993,1018** Routine Name: DGENUPL9 Before: B7773065 After: B8131378 **232,378,451,564,628,688,1018** Routine Name: DGRP6EF Before: B33321348 After: B33525270 **689,659,737,688,909,1014,1018** Routine Name: VADPT4 Before: B45368870 After: B45245158 **343,342,528,689,688,790,797, 935,952,1007,1018** Routine Name: VAFHLZE1 Before: B32837955 After: B33057349 **342,497,602,672,653,909,952,1018** Routine list of preceding patches: 993, 1007, 1014 ============================================================================= User Information: Entered By : Date Entered : MAY 22, 2020 Completed By: Date Completed: APR 26, 2021 Released By : Date Released : APR 26, 2021 ============================================================================= Packman Mail Message: ===================== No routines included