$TXT Created by MICHAEL at DEVVOO.DOMAIN.EXT (KIDS) on Thursday, 10/19/23 at 11:05 ============================================================================= Run Date: DEC 11, 2023 Designation: DG*5.3*1103 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #968 Status: Released Compliance Date: DEC 20, 2023 ============================================================================= Associated patches: (v)DG*5.3*1061 <<= must be installed BEFORE `DG*5.3*1103' (v)DG*5.3*1093 <<= must be installed BEFORE `DG*5.3*1103' (v)DG*5.3*1098 <<= must be installed BEFORE `DG*5.3*1103' Subject: TOXIC EXPOSURE RISK ACTIVITY (TERA) INDICATOR Category: - Enhancement (Mandatory) - Data Dictionary - Routine Description: ============ Veterans Health Information Systems and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE) patch DG*5.3*1103 is being released to support enhancements for the Eligibility and Enrollment (E&E) program. Patch DG*5.3*1103 is also being released in support of the Veterans Health Administration (VHA) Enrollment System (VES) 6.7.1 release. Patch DG*5.3*1103 adds a new field TOXIC EXPOSURE RISK ACTIVITY (#.32116) to the PATIENT file (#2). The ENVIRONMENTAL FACTORS sub-screen of the MILITARY SERVICE DATA, SCREEN <6> screen is modified to display the new TOXIC EXPOSURE RISK ACTIVITY field (#2,.32116). The ZEL segment of the Health Level 7 (HL7) ORU/ORF Z11 message is modified. Sequence 48 is added for TOXIC EXPOSURE RISK ACTIVITY (TERA) INDICATOR. The value from this sequence is stored in the TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2). Patch DG*5.3*1103 modifies the Integration Control Registration (ICR) #10061 SVC^VADPT to return the new value TOXIC EXPOSURE RISK ACTIVITY (#2,.32116). Patch DG*5.3*1103 modifies the Enrollment Priority algorithm to assign Priority Group 6 to a patient with the TOXIC EXPOSURE RISK ACTIVITY field (#2,.32116) equal to YES when recalculating Priority Group values unless the Veteran qualifies for Priority Group 1, 2, 3, 4, or 5. NOTE: For additional information on the Enrollment Priority Algorithm, please see the 'PIMS Version 5.3 ADT Module User Manual' located on the Veteran Affairs (VA) Software Document Library. Listing of Updates: =================== This patch makes the following enhancements to VistA REE: ************************************************************************** SECTION 1: DATA DICTIONARY UPDATES ************************************************************************** 1. A new field TOXIC EXPOSURE RISK ACTIVITY (#.32116) is added to the PATIENT file (#2). The field is read-only and cannot be edited in FileMan. DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 2,.32116 TOXIC EXPOSURE RISK ACTIVITY .321;16 SET (BOOLEAN Data Type) LAST EDITED: SEP 15, 2023 HELP-PROMPT: Enter YES if patient claims exposure to Toxic Exposure Risk Activity (TERA). Otherwise, enter NO. DESCRIPTION: This field should be set to YES if the patient claims exposure to Toxic Exposure Risk Activity (TERA). 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. WRITE AUTHORITY: ^ UNEDITABLE ************************************************************************** SECTION 2: REGISTRATION SCREEN UPDATES ************************************************************************** The ENVIRONMENTAL FACTORS sub-screen of the MILITARY SERVICE DATA, SCREEN <6> screen is modified to display the new TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2). The field is display-only and cannot be entered or edited by the user. In addition, the message below the new field has been updated to include Toxic Exposure Risk Activity (TERA). ** BEGIN SCREEN CAPTURE ** DGPATIENTONE, DGONE SEP 02, 1945 XXX-XX-XXXX 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: YES Only VES users may enter/edit Agent Orange, ION Radiation Exposure or Toxic Exposure Risk Activity (TERA). SELECT AN ENVIRONMENTAL FACTOR (3-4) OR (Q)UIT: QUIT// ** END SCREEN CAPTURE ** ************************************************************************** SECTION 3: VADPT API & ICR MODIFICATIONS ************************************************************************** In support of external systems requiring access to the new TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2), patch DG*5.3*1103 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 NULL. For example: VASV(15)="1^YES" 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 ************************************************************************** SECTION 4: HL7 ORU/ORF-Z11 PROCESSING ************************************************************************** The field below is added to the ZEL segment in the ORU/ORF Z11 HL7 message received from VES. The data from this field is stored in the TOXIC EXPOSURE RISK ACTIVITY field (#.32116) of the PATIENT file (#2). SEQ FIELD --- ----- 48 TOXIC EXPOSURE RISK ACTIVITY (TERA) INDICATOR Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- ------------------- PATIENT (#2) TOXIC EXPOSURE RISK ACTIVITY NEW (#.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, Iron Mountain, MI North Florida / South Georgia VA Health Care System (Gainesville, Lake City) Test Sites - SNOW Change Order #: --------------------------------- Oscar G. Johnson VA Medical Center: CHG0429309 North Florida / South Georgia VA Health Care System: CHG0429475 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*1103 Release Notes DG_5_3_1103_RN.PDF PIMS Version 5.3 User Manual - Registration Menu PIMS_REG_UM.PDF PIMS Version 5.3 Technical Manual PIMS_TM.PDF PIMS Version 5.3 ADT Module User Manual ADTBE_UM.PDF Changes to the IVM Technical Manual for patch DG*5.3*1103 are described in Informational Patch IVM*2.0*213. Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- N/A 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 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] Eligibility Verification [DG ELIGIBILITY VERIFICATION] View Registration Data [DG REGISTRATION VIEW] 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*1103) 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*1103 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// 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] Eligibility Verification [DG ELIGIBILITY VERIFICATION] View Registration Data [DG REGISTRATION VIEW] 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: ------------------------------- 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]. 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*1103, on Jan 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]**;Aug 13,1993;Build 7 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGENELA4 Before: B98611609 After:B101730897 **232,275,306,327,314,367,417, 437,456,491,451,564,672,659, 653,688,803,754,841,909,972, 952,993,1018,1090,1098,1103** Routine Name: DGENPTA1 Before: B38212371 After: B38698474 **121,147,314,677,659,653,688, 810,754,838,841,842,978,1036, 1064,1093,1103** Routine Name: DGENUPL Before: B47617701 After: B49381688 **147,222,232,363,472,497,564, 677,672,688,871,909,952,1103** Routine Name: DGENUPLA Before:B130856592 After:B138070375 **397,379,497,451,564,672,659, 583,653,688,754,909,978,952, 1064,1090,1103** Routine Name: DGRP6EF Before: B55306230 After: B57892976 **689,659,737,688,909,1014,1018, 1075,1084,1090,1103** Routine Name: VADPT Before: B18284728 After: B18417337 **193,343,389,415,489,498,688, 754,887,996,1061,1103** Routine Name: VADPT0 Before: B15225267 After: B15320923 **343,342,415,489,498,528,689, 789,688,759,754,887,952,996, 1059,1064,1103** Routine Name: VADPT4 Before: B44263588 After: B45318693 **343,342,528,689,688,790,797, 935,952,1007,1018,1090,1103** Routine list of preceding patches: 1061, 1093, 1098 ============================================================================= User Information: Entered By : Date Entered : JUL 06, 2023 Completed By: Date Completed: DEC 11, 2023 Released By : Date Released : DEC 11, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT