$TXT Created by DEVCRN.DOMAIN.EXT (KIDS) on Wednesday, 05/18/22 at 11:34 ============================================================================= Run Date: JUN 23, 2022 Designation: DG*5.3*1071 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #940 Status: Released Compliance Date: JUL 22, 2022 ============================================================================= Associated patches: (v)DG*5.3*1059 <<= must be installed BEFORE `DG*5.3*1071' (v)DG*5.3*1067 <<= must be installed BEFORE `DG*5.3*1071' (v)DG*5.3*1050 <<= must be installed BEFORE `DG*5.3*1071' Subject: MASTER VETERAN INDEX VISTA ENHANCEMENT - SEXUAL ORIENTATION UPDATES Category: - Routine - Data Dictionary - Enhancement (Mandatory) Description: ============ NOTE: Master Veteran Index (MVI) enhancements are being distributed in two VistA namespaces: DG and RG. The only build enforced requirement for this set of related patches is that DG*5.3*1071 be installed before RG*1.0*77. (Do NOT install RG*1.0*77 on legacy sites or on the FORUM CLAIMS system.) NOTE: Legacy sites and the FORUM CLAIMS system can install just the DG*5.3*1071 patch. RG*1.0*77 should NOT be installed on legacy sites or on the FORUM CLAIMS system. DG*5.3*1050, DG*5.3*1059 and DG*5.3*1067 are the required builds for patch DG*5.3*1071. The following enhancements exported in this patch by the Master Veteran Index (MVI) will add additional Sexual Orientation fields to support the Computerized Patient Record System (CPRS) updating of the Sexual Orientation fields from the Clinical Reminder. The following issue resolution exported in this patch is to address a problem that revealed itself after the release of patch DG*5.3*1059 (New Demographic Fields) recently, where the patient's address information is NOT always being displayed correctly when there is a correspondence address and/or a foreign residential address. Enhancement #1 The following Data Dictionary (DD) changes have been made in the PATIENT (#2) file: .SEXUAL ORIENTATION (.025 Sub-File) Record X-REFs: Lookup/Sorting: G202501 / G202502 / G202503 / G202504 Sorting ONLY: AHIST The following new fields were added to the SEXUAL ORIENTATION (#.025) multiple in the PATIENT (#2) file with auditing enabled and an 'AVAFC' cross-reference (X-REF) that will allow MVI to monitor them for changes as indicated below: . STATUS (#.02) - SET OF CODES / AUDITED / AVAFC202502 Sorting X-REF: AHIST . DATE CREATED (#.03) - DATE / AVAFC202503 Lookup/Sorting X-REFs: G202501 / G202503 Sorting X-REF: AHIST . DATE LAST UPDATED (#.04) - DATE / AUDITED / AVAFC202504 Lookup/Sorting X-REFs: G202502 / G202504 Sorting X-REF: AHIST . NOTE (#.05) - POINTER / AUDITED (*Pointer to the TIU DOCUMENT (#8925) file) Sorting X-REF: AHIST . TYPE OF UPDATE (#.06) - SET OF CODES Sorting X-REF: AHIST Note: 'AVAFC' X-REFs make use of the DG FIELD MONITOR tool that was released in patch DG*5.3*527. This tool utilizes the VAFC MPIPD FIELD TRIGGER protocol, which creates an entry in the ADT/HL7 PIVOT (#391.71) file, as well as sets the VAFCF variable to capture the fields that have been modified during an edit. This field will be included in the Health Level Seven (HL7) 2.4 messages generated by the Master Patient Index (MPI) / Patient Demographics (PD) application. Routine VAFCTR supports this effort and was modified to support these new and existing fields. Finally, the SEXUAL ORIENTATION DESCRIPTION (#.0251) field has also been modified to include the "AHIST" Sorting X-REF. Enhancement #2 In continued support of CPRS required access to the new PATIENT (#2) file identity fields listed above, MVI has modified the supported Integration Control Registration (ICR) #7109 for the Demographic Application Programming Interface (API) in DEM^VADPT / DEMUPD^VADPT. The updates to this API will now return the following additional Sexual Orientation demographic information in the output array ([VADM] for DEM^VADPT and [VADEMO] for DEMUPD^VAPDT) upon execution: - VADEMO(14,1,1..n,1) - The current STATUS of the Sexual Orientation for the patient in external^internal format. - VADEMO(14,1,1..n,2) - The DATE CREATED value of the Sexual Orientation for the patient in external^internal format. - VADEMO(14,1,1..n,3) - The DATE LAST UPDATED value of the Sexual Orientation for the patient in external^internal format. - VADEMO(14,1,1..n,4) - The Internal Entry Number (IEN) of the NOTE [DOCUMENT TYPE in TIU DOCUMENT (#8925 file)] for the Sexual Orientation for the patient in external^internal format. - VADM(14,1,1..n,1) - The current STATUS of the Sexual Orientation for the patient in external^internal format. - VADM(14,1,1..n,2) - The DATE CREATED value of the Sexual Orientation for the patient in external^internal format. - VADM(14,1,1..n,3) - The DATE LAST UPDATED value of the Sexual Orientation for the patient in external^internal format. - VADM(14,1,1..n,4) - The Internal Entry Number (IEN) of the NOTE [DOCUMENT TYPE in TIU DOCUMENT (#8925 file)] for the Sexual Orientation for the patient in external^internal format. NOTE: For additional information on the DEM^VAPDT and DEMUPD^VAPDT APIs, see the Patient Information Management System (PIMS) Technical Manual located on the Veteran Affairs (VA) Software Document Library (VDL). Enhancement #3 The [DG PATIENT INQUIRY] menu option has been modified in routine DGRPD to display the following additional *NEW Sexual Orientation demographic fields for the applicable Sexual Orientation on the second screen of the display if they are available: - STATUS (#.02) - DATE CREATED (#.03) - DATE LAST UPDATED (#.04) Birth Sex : FEMALE Sexual Orientation: Bisexual (ACTIVE) Date Created: JAN 20, 2022 Date Last Updated: JAN 20, 2022 Straight or Heterosexual (ACTIVE) Date Created: AUG 18, 2021 Date Last Updated: JAN 24, 2022 Sexual Orientation Description: Pronoun: Enhancement #4 The [Patient MPI/PD Data Inquiry] menu option has been modified in routine VAFCPDAT to display the following additional Sexual Orientation fields associated with the Sexual Orientation if data exists for these fields in the PATIENT (#2) file for the selected patient: - STATUS (#.02) - DATE CREATED (#.03) - DATE LAST UPDATED (#.04) Enhancement #5 The 'Observation/Result' (OBX) HL7 segment builder and processing/filing logic in routines VAFCPTED and VAFCSB have been modified to now support the following demographic information for the patient: OBX - Sexual Orientation *Status *Date Created *Date Last Updated This updated OBX HL7 message segment will now include the internal values of these additional Sexual Orientation demographic fields in the PATIENT (#2) file. OBX^^CE^Sexual Orientation^^BIS~Bisexual~L^^^^^^A^20220118^^20220118 * ******** ******** Note: If Sexual Orientation information is passed in the OBX segment, then routine VAFCPTED will also initialize the TYPE OF UDPATE (#.06) field in the SEXUAL ORIENTATION (#.025) multiple of the PATIENT (#2) file to 'Remote' (R). Enhancement #6 MVI has also created a new Application Programming Interface (API) that will allow the adding/updating/validation and/or rollback of the Sexual Orientation fields in the SEXUAL ORIENTATION multiple (#.025) and the SEXUAL ORIENTATION DESCRIPTION (#.0251) field in the PATIENT (#2) file for a particular patient. $$SOGI^VAFCAPI(,,) Currently, CPRS with the release of Clinical Reminders patch PXRM*2.0*78 will be utilizing this API to add/update and/or rollback these Sexual Orientation values for a specific patient at the site. NOTE: Private ICR #7323 in FORUM has been created/approved for the CLINICAL REMINDER package to use this API. Enhancement #7 The [Patient MPI/PD Data Inquiry] menu option has also been enhanced in routine VAFCPDAT to display the PHONE NUMBER [WORK] (#.132) and the PHONE NUMBER [CELLULAR] (#.134) fields in the PATIENT (#2) file for the selected patient, but ONLY if the value exists. In addition, the Post-Init routine DG1071P will also enable auditing on the PHONE NUMBER [CELLULAR] (#.134) field in the PATIENT (#2) file. Enhancement #8 The following 2 new APIs were created to support multiple CERNER / HealthShare Enterprise Platform (HSEP) CERT and MOCK accounts that require multiple station numbers to exist in the Software Quality Assurance (SQA) environment: : $$GCRNSITE^VAFCCRNR - Returns the CERNER Station Number for the VistA Instance. (ie. '200CRNR' or the SQA defined CERNER Station Number) : $$ISCRNPAT^VAFCCRNR - Returns '0' (No) or '1' (Yes) if the passed patient identifier (DFN) is from CERNER. NOTE: Even though this functionality is ONLY required for some SQA environments it has to be supported in the National Code base. Post-Initialization process will also file '200CRNR' as the default CERNER Station Number for all VistA sites in the MPI ICN BUILD MANAGEMENT (#984.8) file, while SQA environments will be manually updated later to the correct value. Issue Currently the State and Zip Code fields for Correspondence addresses and Province, Postal Code and Country for Residential Foreign addresses are NOT always being displayed correctly due to incorrect variables being used and/or overwritten in the software. The Master Patient Index (MPI) has now updated routine VAFCPDAT to reference the correct address variables so that the correspondence and foreign residential address information for the patient will be displayed correctly/completely when viewed using the menu option: - Patient MPI/PD Data Inquiry [RG EXCEPTION TF INQUIRY]. Patch Components ================ Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- PATIENT (#2) SEXUAL ORIENTATION MODIFIED (New X-REF) DESCRIPTION (#.0251) SEXUAL ORIENTATION SEXUAL ORIENTATION (#.01) MODIFIED (New X-REFs) (#2.025 - Multiple) STATUS (#.02) NEW FIELD DATE CREATED (#.03) NEW FIELD DATE LAST UPDATED (#.04) NEW FIELD NOTE (#.05) NEW FIELD TYPE OF UPDATE (#.06) NEW FIELD 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 Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted --------------------------- -------------------- N/A Additional Information: New Service Requests (NSRs) ---------------------------- N/A Patient Safety Issues (PSIs) ----------------------------- N/A Defect Tracking System Ticket(s) & Overview ------------------------------------------- N/A Test Sites: ---------- Central Alabama AL HCS Tucson AZ VAMC 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. Admission Discharge Transfer (ADT) Documentation can also be found on the VDL at: http://www.domain.ext/vdl/application.asp?appid=55 Documentation Title File Name --------------------------------------------------------------------- PIMS Version 5.3 Technical Manual PIMS_TM.PDF PIMS_TM.DOC Patch Installation: Pre/Post Installation Overview ------------------------------ The post-installation process will enable auditing on the PHONE NUMBER [CELLULAR] (#.134) field in the PATIENT (#2) file and create a new entry 'FOUR' in the MPI ICN BUILD MANAGEMENT (#984.8) file to store the default CERNER Station Number ('200CRNR'). Pre-Installation Instructions ----------------------------- This patch takes less than a minute to install. This patch may be installed with users on the system, but it is recommended that installation occur during off hours to avoid collisions. The following OPTIONs should be disabled during installation: Load/Edit Patient Data [DG LOAD PATIENT DATA] Register a Patient [DG REGISTER PATIENT] Preregister a Patient [DGPRE PRE-REGISTER OPTION] Electronic 10-10EZ Processing [EAS EZ 1010EZ PROCESSING] UPDATE BATCH JOB FOR HL7 v2.3 [VAFC BATCH UPDATE] MPI/PD Patient Admin Coordinator Menu [RG ADMIN COORD MENU] Local/Missing ICN Resolution Background Job [MPIF LOC/MIS ICN RES] The HL7 incoming filers should be stopped. Use the Monitor, Start, Stop Filers [HL FILER MONITOR] option on the Filer and Link Management Options [HL MENU FILER LINK MGT] menu on the HL7 Main Menu [HL MAIN MENU]. 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*1071) 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*1071 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. 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 ----------- --------- [DG LOAD PATIENT DATA] Load/Edit Patient Data [DG REGISTER PATIENT] Register a Patient [DGPRE PRE-REGISTER OPTION] Preregister a Patient [EAS EZ 1010EZ PROCESSING] Electronic 10-10EZ Processing [VAFC BATCH UPDATE] UPDATE BATCH JOB FOR HL7 v2.3 [RG ADMIN COORD MENU] MPI/PD Patient Admin Coordinator Menu [MPIF LOC/MIS ICN RES] Local/Missing ICN Resolution Background Job 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 ------------------------------ After patch installation has completed, restart the HL7 incoming filers. Use the Monitor, Start, Stop Filers [HL FILER MONITOR] 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 ------------- The patch backout procedure would consist of restoring the original routines and DD using the back-up message created during the patch installation, disable auditing on the PHONE NUMBER [CELLULAR] (#.134) field in the PATIENT (#2) file and delete the 'FOUR' record entry in the MPI ICN BUILD MANAGEMENT (#984.8) file. If assistance is still required to back-out the patch please contact the National Service Desk (NSD) to log a help desk ticket so the development team can assist in the process. Note: This process should only be done with the concurrence and participation of the development team and the appropriate VA Site/Region personnel. 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: DG1071P Before: n/a After: B6724117 **1071** Routine Name: DGRPD Before:B124542170 After:B128108199 **109,124,121,57,161,149,286, 358,436,445,489,498,506,513, 518,550,545,568,585,677,703, 688,887,907,925,936,940,941, 987,1006,1056,1061,1059,1071** Routine Name: VADPT1 Before: B70654177 After: B74338795 **415,489,516,614,688,754,887, 941,1059,1067,1071** Routine Name: VAFCAPI Before: n/a After:B139478624 **1071** Routine Name: VAFCCRNR Before: B5042521 After: B8135519 **981,1050,1071** Routine Name: VAFCPDAT Before: B83449271 After: B88865297 **333,414,474,505,707,712,837, 863,876,902,926,937,950,1059, 1071** Routine Name: VAFCPTED Before: B71161644 After: B87903386 **149,333,756,837,974,1059,1071** Routine Name: VAFCSB Before: B75363862 After: B81393667 **707,756,825,876,902,926,967, 1059,1071** Routine Name: VAFCTR Before: B12937603 After: B13948610 **575,648,653,712,876,902,926, 937,944,967,1059,1071** ============================================================================= User Information: Entered By : Date Entered : DEC 16, 2021 Completed By: Date Completed: JUN 23, 2022 Released By : Date Released : JUN 23, 2022 ============================================================================= Packman Mail Message: ===================== $END TXT