Install: DG*5.3*966

Patch Subject:  SEPARATION REASON CODE
Description:

============
 Patch DG*5.3*966 is being released to support enhancements introduced in
 the Enrollment System (ES) 5.4 release.  For additional information on
 the v5.4 release, please refer to informational patch EAS*1.0*169 for
 details.  This patch provides enhancements to Veterans Health Information
 System and Technology Architecture (VistA) Registration, Eligibility &
 Enrollment (REE) that ensure a Veteran's complete and accurate military
 service record is displayed in the system.
 This patch provides for validation of the Early Separation Reason for a
 veterans' Military Service Episode (MSE).  This ensures greater data
 integrity.  DG*5.3*966 ensures that eligibility for care is accurately
 determined across Veterans Health Administration (VHA) systems and that
 the Veteran's military service information is accurate and accessible at
 any VHA facility.
 Listing of Updates
 ==================
 This patch makes the following enhancements to VistA REE:
 1. The SEPARATION REASON CODE (#.1) sub-field within the MILITARY SERVICE
    EPISODE (#.3216) multiple in the PATIENT (#2) file is added. This
    field is a pointer to the SEPARATION REASON (#26) file and the data for
    this field will be received from ES in ORF-Z11/ORU-Z11 HL7 messages in
    the ZMH segment. The SEPARATION REASON CODE 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, the routine DGMSEUTL
    includes component GETMSE that returns all records in the MILITARY
    SERVICE EPISODE (#.3216) multiple within the PATIENT (#2) file in the
    Military Service Episode (MSE) array. While no modifications were made
    to this component, the SEPARATION REASON CODE (#.1) field is included
    in the returned array.
 2. The SEPARATION REASON (#26) file is added to VistA REE. This file
    contains the codes and associated descriptions for the Reason for Early
    Separation with data matching the equivalent table in (ES). The data
    for this file is included in the build. (See the Post-Installation
    Instructions section below.) The file consists of two fields:
    a.  CODE field (#.01) - Free-text field of 3 digits for the Reason for
        Separation Code.
    b.  DESCRIPTION field (#.02) - Free-text field of 3-128 characters.
 3. The HL7 interface with ES is modified to include the additional
    "SEPARATION REASON CODE" (#.01) field that is associated with each MSE.
    The ORU-Z11/ORF-Z11 message contains a new sequence, (#10), in the
    ZMH segment.
 4. When VistA receives an HL7 message with a Separation Reason Code, the
    code is validated against the SEPARATION REASON (#26) file in VistA.
    VistA processes the field based on the following criteria:
    a. If the Separation Reason Code is present in the SEPARATION REASON
       (#26) file, it is stored in the SEPARATION REASON CODE (#.1) field
       within the MILITARY SERVICE EPISODE (#.3216) multiple within the
       PATIENT (#2) file.
    b. If the Separation Reason Code is not present in the SEPARATION
       REASON (#26) file, the text "Refer to Enrollment System for Reason"
       is stored in the patient record in the REASON FOR EARLY SEPARATION
       (#.09) field in the MILITARY SERVICE EPISODE (#.3216) multiple
       within the PATIENT (#2) file.
 5. MSEs that contain a SEPARATION REASON CODE will not be included
    in the ORU-Z07 or ORF-Z07 messages sent to ES.
 6. There are no display changes in VistA REE. The internal logic used to
    retrieve the Reason for Early Separation description from the patient
    record for display on screens <6> and <6.1> is modified as follows:
    a. If the SEPARATION REASON CODE (#.1) sub-field within the MILITARY
       SERVICE EPISODE (#.3216) multiple in the PATIENT (#2) file is
       present, it is used to acquire the DESCRIPTION (#.02) field from the
       SEPARATION REASON (#26) file.
    b. If the SEPARATION REASON CODE (#.1) sub-field within the MILITARY
       SERVICE EPISODE (#.3216) multiple in the PATIENT (#2) file is not
       present, the REASON FOR EARLY SEPARATION (#.09) sub-field within the
       MILITARY SERVICE EPISODE (#.3216) multiple in the PATIENT (#2) file
       field is used to retrieve the description.
 Patch Components:
 -----------------
 Files & Fields Associated:
 File Name (Number)         Field Name (Number)     New/Modified/Deleted
 ------------------         -------------------     --------------------
 PATIENT (#2)               MILITARY SERVICE        Modified
                            EPISODE (#.3216)
                            SEPARATION REASON       New
                            CODE (#.1)
 SEPARATION REASON (#26)                            New
                            CODE (#.01)             New
                            DESCRIPTION (.02)       New
 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:
 -----------
 VA Greater Los Angeles Healthcare System, Los Angeles CA
 James E. Van Zandt VA Medical Center, Altoona PA
 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_53_P966_RN.PDF       (binary)
 IVM Technical Manual                  IVM_2_P175_TM.PDF       (binary)
 Patch Installation:
 Pre/Post Installation Overview
 ------------------------------

Use default answers for KIDS load/install questions.

Patch-Files: http://code.osehra.org/VistA.git/tree/master/Packages/Registration/Patches/DG_5.3_966

Packages/Kernel/Globals/14.4+TASKS.zwr

@@ -1,6 +1,6 @@
 OSEHRA ZGO Export: TASKS
-15-MAR-2019 04:43:02 ZWR
-^%ZTSK(-1)=4315
+15-MAR-2019 05:29:27 ZWR
+^%ZTSK(-1)=4319
 ^%ZTSK(0)="TASKS^14.4^4237"
 ^%ZTSK(1001,0)="TASK^XMXBULL^16^^63957,36927^63957,36927^R^^^PATCH,USER^PLA^PLA^ZTDESC^^"
 ^%ZTSK(1001,.02)="^PLA^^"
@@ -39189,6 +39189,47 @@ OSEHRA ZGO Export: TASKS
 ^%ZTSK(4315,.3,"DUZ(",0)="@"
 ^%ZTSK(4315,.3,"XQSCH")=8
 ^%ZTSK(4315,.3,"XQY")=9891
+^%ZTSK(4316,0)="HOUR^XUTMHR^.5^^65087,19496^65087,19496^R^^^POSTMASTER^VISTA^VISTA^ZTDESC^^"
+^%ZTSK(4316,.02)="^VISTA^^"
+^%ZTSK(4316,.03)="Taskman Hourly Job"
+^%ZTSK(4316,.04)=5623536296
+^%ZTSK(4316,.1)="B^65087,19556^Task's volume set not listed in index.^^^^^^"
+^%ZTSK(4316,.2)=""
+^%ZTSK(4316,.21)=""
+^%ZTSK(4316,.25)=""
+^%ZTSK(4317,0)="ZTSK^XQ1^.5^VISTA^65087,19556^65087,19556^O^8853^HL AUTOSTART LINK MANAGER^POSTMASTER^VISTA^VISTA^ZTDESC^VISTA^"
+^%ZTSK(4317,.02)="^VISTA^^"
+^%ZTSK(4317,.03)="No Description (%ZTLOAD)"
+^%ZTSK(4317,.04)=5623536356
+^%ZTSK(4317,.1)="B^65087,19558^Task's volume set not listed in index.^^^^^^"
+^%ZTSK(4317,.2)=""
+^%ZTSK(4317,.21)=""
+^%ZTSK(4317,.25)=""
+^%ZTSK(4317,.3,"DUZ(",0)="@"
+^%ZTSK(4317,.3,"XQSCH")=10
+^%ZTSK(4317,.3,"XQY")=8853
+^%ZTSK(4318,0)="ZTSK^XQ1^.5^VISTA^65087,19556^65087,19556^O^8412^HL TASK RESTART^POSTMASTER^VISTA^VISTA^ZTDESC^VISTA^"
+^%ZTSK(4318,.02)="^VISTA^^"
+^%ZTSK(4318,.03)="No Description (%ZTLOAD)"
+^%ZTSK(4318,.04)=5623536356
+^%ZTSK(4318,.1)="B^65087,19560^Task's volume set not listed in index.^^^^^^"
+^%ZTSK(4318,.2)=""
+^%ZTSK(4318,.21)=""
+^%ZTSK(4318,.25)=""
+^%ZTSK(4318,.3,"DUZ(",0)="@"
+^%ZTSK(4318,.3,"XQSCH")=11
+^%ZTSK(4318,.3,"XQY")=8412
+^%ZTSK(4319,0)="ZTSK^XQ1^.5^VISTA^65087,19556^65087,19556^O^9891^XOBV LISTENER STARTUP^POSTMASTER^VISTA^VISTA^ZTDESC^VISTA^"
+^%ZTSK(4319,.02)="^VISTA^^"
+^%ZTSK(4319,.03)="No Description (%ZTLOAD)"
+^%ZTSK(4319,.04)=5623536356
+^%ZTSK(4319,.1)="B^65087,19563^Task's volume set not listed in index.^^^^^^"
+^%ZTSK(4319,.2)=""
+^%ZTSK(4319,.21)=""
+^%ZTSK(4319,.25)=""
+^%ZTSK(4319,.3,"DUZ(",0)="@"
+^%ZTSK(4319,.3,"XQSCH")=8
+^%ZTSK(4319,.3,"XQY")=9891
 ^%ZTSK(1082462,.1)="E^64013,39495^Interrupted While Running"
 ^%ZTSK(1082463,.1)="E^64013,39495^Interrupted While Running"
 ^%ZTSK(1082464,.1)="E^64013,39495^Interrupted While Running"