$TXT Created by at DEVVOO.DOMAIN.EXT (KIDS) on Tuesday, 07/03/18 at 12:23 ============================================================================= Run Date: OCT 24, 2018 Designation: DG*5.3*947 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #846 Status: Released Compliance Date: NOV 26, 2018 ============================================================================= Associated patches: (v)DG*5.3*842 <<= must be installed BEFORE `DG*5.3*947' (v)DG*5.3*935 <<= must be installed BEFORE `DG*5.3*947' Subject: ENROLLMENT SYSTEM MODERNIZATION (ESM) EARLY SEPARATION REASON Category: - Routine - Data Dictionary - Enhancement (Mandatory) Description: ============ Patch DG*5.3*947 is being released to support the enhancements for the Enterprise Health Benefits Determination (EHBD) program that focuses on updates for the Enrollment System Modernization (ESM) Phase 2 project, which supports Enrollment System Community Care (ESCC). DG*5.3*947 is also being released in support of the Enrollment System (ES) 5.3 release. Refer to Informational Patch EAS*1*165 (Enrollment Application System) for additional details regarding the ES release. The REASON FOR EARLY SEPARATION (#.09) field within the MILITARY SERVICE EPISODE (.3216) multiple within the PATIENT (#2) file is added in Veterans Health Information System and Technology Architecture (VistA) Registration, Eligibility & Enrollment (REE). The data for this field will be received from ES in ORF-Z11/ORU-Z11 HL7 messages in the ZMH segment. The Reason for Early Separation cannot be edited or deleted by VistA users and will not be sent back to ES in a Z07 message. Note: DBIA 5783 MILITARY SERVICE EPISODE API - DGMSEUTL includes component GETMSE that returns all records in the MILITARY SERVICE EPISODE (#.3216) multiple within the PATIENT (#2) file in the MSE array. While no modifications were made to this component, the REASON FOR EARLY SEPARATION (#.09) field is included in the returned array. Listing of Updates ================== This patch makes the following enhancements to REE: 1. The REASON FOR EARLY SEPARATION (#.09) field within the MILITARY SERVICE EPISODE (#.3216) multiple within the PATIENT (#2) file is added. 2. The FUTURE DISCHARGE DATE (#.08) field within the MILITARY SERVICE EPISODE (#.3216) multiple within the PATIENT (#2) file is modified to be NONEDITABLE. 3. The HL7 interface with ES is modified to include the additional data element of "REASON FOR EARLY SEPARATION" that is associated with each MSE. The ORU-Z11 message contains a new sequence, #9, in the ZMH segment for the "REASON FOR EARLY SEPARATION". 4. MSEs that contain a REASON FOR EARLY SEPARATION will not be included in the ORU-Z07 or ORF-Z07 messages sent to ES. 5. The following VistA menu options were modified to display the Reason for Early Separation: a. View Registration Data [DG REGISTRATION VIEW] b. Load/Edit Patient Data [DG LOAD PATIENT DATA] c. Register a Patient [DG REGISTER PATIENT] d. Eligibility Verification [DG ELIGIBILITY VERIFICATION] e. Preregister a Patient [DGPRE PRE-REGISTER OPTION] f. Admit a Patient [DG ADMIT PATIENT] Note: In the Preregister a Patient [DGPRE PRE-REGISTER OPTION] option, the field is shown only if there are MSE inconsistencies in the record. 6. The VistA REE system displays the Reason for Early Separation on the following screens as view-only next to the caption "Early Separation Reason:" (screen mockups below): a. Military Service Data, Screen <6> b. Military Service Data, Screen <6.1> BEGIN SCREEN CAPTURE #1 MILITARY SERVICE DATA, SCREEN <6> DGPATIENT,ONE; 666-04-1041 NSC VETERAN ========================================================================== [1] Service Branch/Component Service # Entered Separated Discharge ------------------------ --------- ------- --------- --------- NAVY/REGULAR 666041041 02/29/2000 UNKNOWN UNKNOWN MARINE CORPS/RESERVE UNKNOWN 01/28/2000 02/05/2000 HONORABLE COAST GUARD 666041041 01/07/2000 01/20/2000 HONORABLE Early Separation Reason: DISABILITY, SEVERANCE PAY, NON COMBAT (ENHANCED) [2] Conflict Locations: < None Specified > [3] Environment Factors: < None Specified > [4] POW: NO From: To: War: [5] Combat: From: To: Loc: [6] Mil Disab Retirement: Dischrg Due to Disab: [7] Dent Inj: Teeth Extracted: [8] Purple Heart: to CONTINUE, 1-8 or ALL to EDIT, ^N for screen N or '^' to QUIT: END SCREEN CAPTURE #1 BEGIN SCREEN CAPTURE #2 Military Service Jun 15, 2018@13:00:39 Page: 1 of 2 MILITARY SERVICE DATA, SCREEN <6.1> Patient: DGPATIENT,ONE (1041) NSC VETERAN Service Branch/Component Service # Entered Separated Discharge -------------------------------------------------------------------------- [1] NAVY/REGULAR 666041041 02/29/2000 UNKNOWN UNKNOWN [2] MARINE CORPS/RESERVE UNKNOWN 01/28/2000 02/05/2000 HONORABLE [3] COAST GUARD 666041041 01/07/2000 01/20/2000 HONORABLE Early Separation Reason: DISABILITY, SEVERANCE PAY, NON COMBAT (ENHANCED) [4] AIR FORCE/REGULAR 666041041 01/01/2000 01/05/2000 HONORABLE Early Separation Reason: DISABILITY, OTHER [5] AIR FORCE/REGULAR 666041041 06/30/1979 07/31/1989 HONORABLE + Enter ?? for more actions AD Add DE Delete ED Edit VH View History Select Action:Next Screen// END OF SCREEN CAPTURE #2 7. The VistA REE system does not display the Reason for Early Separation caption if one does not exist for the MSE. 8. The VistA REE system does not allow the user to edit an MSE Reason for Early Separation. 9. The VistA REE system does not allow the user to delete an MSE Reason for Early Separation. 10. When the number of MSEs spans multiple pages on screen <6> or screen <6.1> the VistA REE system displays all the data elements for each MSE on the same page. The MSE data elements to be displayed together include the following: Branch, Component, Service #, Entered, Separated, Discharge Type, and Future Discharge Date or Reason for Early Separation. Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT (#2) MILITARY SERVICE Modified EPISODE (#.3216) FUTURE DISCHARGE Modified DATE (#.08) REASON FOR EARLY New SEPARATION (#.09) Forms Associated: Form Name File # 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 Additional Information: N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Problem: -------- N/A Resolution: ----------- N/A Test Sites: ----------- C.W. Bill Young VA Medical Center, Bay Pines, FL Lebanon VA Medical Center, Lebanon, PA VA Western New York Healthcare System, Buffalo, NY Software and Documentation Retrieval Instructions: ---------------------------------------------------- This software is being released as a patch (PackMan) message. Updated documentation describing the new functionality introduced by this patch is available. The preferred method is to retrieve files from download.vista.domain.ext. This transmits the files from the first available server. Sites may also elect to retrieve files directly from a specific server. Sites may retrieve the documentation directly using Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the following OI Field Offices: Hines: domain.ext Salt Lake City: domain.ext Documentation can also be found on the VA Software Documentation Library at: http://www4.domain.ext/vdl/ Title File Name SFTP Mode -------------------------------------------------------------------------- Release Notes DG_5_3_947_RN.PDF (binary) User Manual - Registration Menu DG_5_3_947_REG_UM.PDF (binary) IVM Technical Manual IVM_2_TM_RES.PDF (binary) Patch Installation: Pre/Post Installation Overview ------------------------------ N/A Pre-Installation Instructions ----------------------------- This patch should NOT be installed while the IVM BACKGROUND JOB [IVM BACKGROUND JOB] is running. 1. The Health Level Seven (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]. 2. Use Global Output Function to backup MILITARY SERVICE EPISODE (MSE) sub-file (#.3216) and associated data dictionary of the MSE sub-file by running the command below (be sure to enter "V" for the parameters). You will need to specify a local directory and file name for the Device. DEVISC1A1:DEVVOO>D ^%GOGEN Device: USER$:[VISTA]dg_53_947_backup.gbl Parameters? ("V") => V Global ^DD(2.3216 -- NOTE: translation in effect Global ^ DEVISC1A2:DEVVOO> If the system you are installing this patch on is a LINUX system, you will need to run a different utility, GOGEN^%ZSPECIAL. Enter the following command: D GOGEN^%ZSPECIAL Device: /srv/vista/xxx/user/sftp/dg_53_947_backup.gbl Parameters? ("V") => V Global ^DD(2.3216 -- NOTE: translation in effect Global ^ DEVISC1A2:DEVVOO> where "xxx" is the site designation, then follow the instructions above for entering the globals to save. 3. The following options should be disabled during installation: Load/Edit Patient Data [DG LOAD PATIENT DATA] Register a Patient [DG REGISTER PATIENT] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Admit a Patient [DG ADMIT PATIENT] 4. This patch may be installed with users on the system, however, because the Registration options need to be placed out of order, we suggest it be installed after business hours. This patch should take less than 5 minutes to install. Installation Instructions ------------------------- 1. Choose the PackMan message containing this patch. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter the patch# (DG*5.3*947): a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as DD's or templates. b. 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 components of this patch (routines, DD's, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', respond NO. 6. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', respond YES. 7. When prompted 'Enter options you wish to mark as 'Out Of Order':' Enter the following options: Load/Edit Patient Data [DG LOAD PATIENT DATA] Register a Patient [DG REGISTER PATIENT] View Registration Data [DG REGISTRATION VIEW] Eligibility Verification [DG ELIGIBILITY VERIFICATION] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Admit a Patient [DG ADMIT PATIENT] 8. When prompted 'Enter protocols you wish to mark as 'Out Of Order':' press . 9. If prompted 'Delay Install (Minutes): (0 - 60): 0//', respond 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 Plan ------------- In the event a site determines that this patch should be backed out, the site should submit a YOUR IT Services ticket with the Enterprise Service Desk (ESD) for assistance with the procedure. Refer to the DG*5.3*P947 Deployment, Installation, Back-out, and Rollback Guide (dg_5_3_947_dibrg.docx) for complete instructions on back-out and rollback procedures. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;REGISTRATION;**[Patch List]**;Aug 13,1993;Build 13 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGENUPL3 Before: B89567535 After: B94088270 **147,230,232,377,404,451,653, 688,793,797,841,928,935,947** Routine Name: DGMSEUTL Before: B17883475 After: B18882941 **797,935,947** Routine Name: DGRP6 Before: B18281969 After: B20074399 **161,247,343,397,342,451,672, 689,797,841,842,947** Routine Name: DGRP61 Before: B57864374 After: B64590268 **797,909,935,947** Routine list of preceding patches: 842, 935 ============================================================================= User Information: Entered By : Date Entered : JUL 04, 2017 Completed By: Date Completed: OCT 24, 2018 Released By : Date Released : OCT 24, 2018 ============================================================================= Packman Mail Message: ===================== $END TXT