============================================================================= Run Date: OCT 24, 2024 Designation: DG*5.3*1104 Package : DG - REGISTRATION Priority: Mandatory Version : 5.3 SEQ #986 Status: Released Compliance Date: NOV 24, 2024 ============================================================================= Associated patches: (v)DG*5.3*1064 <<= must be installed BEFORE `DG*5.3*1104' (v)DG*5.3*884 <<= must be installed BEFORE `DG*5.3*1104' (v)DG*5.3*895 <<= must be installed BEFORE `DG*5.3*1104' (v)DG*5.3*1090 <<= must be installed BEFORE `DG*5.3*1104' (v)DG*5.3*1095 <<= must be installed BEFORE `DG*5.3*1104' (v)PX*1*240 <<= must be installed BEFORE `DG*5.3*1104' Subject: CAPTURING COMPACT ACT BENEFIT Category: - Routine - Input Template - Data Dictionary - Other Description: ============ This patch adds functionality to enable communicating with the COMPACT Act EPISODE OF CARE file (#818) created in PX*1.0*240. This COMPACT Act Acute Suicidal Crisis episodes functionality includes the following (note: complete functionality features can be reviewed in the Enhancement Tracking System Ticket(s) & Overview section): o Capture and store Inpatient start and follow-up documentation from new Admission and Transfer workflow prompts o Automatically close an existing Episode of Care (EOC) from the new Admission workflow prompt o Capture and store Inpatient end documentation from the CPRS COMPACT ACT 201 ENCOUNTER template o Display Start date, Remaining days, and End date from menu options: Patient Inquiry (DG PATIENT INQUIRY), Register a Patient (DG REGISTER PATIENT), Load Patient Data (DG LOAD PATIENT DATA), and Enter a Request/Notification (FBCH ENTER REQUEST) from the Notification/Request Menu (FBCH NOTIFICATION MENU) of the Civil Hospital Main Menu (FBCH MAIN MENU) o Display Start date, Remaining days, and End date from the Patient Treatment File (PTF) 501 screen o Capture whether admission or treatment is intended for an Acute Suicidal Crisis from prompts in the Admission and Transfer workflows o Store Admitted for Acute Suicidal Crisis values in the PTF (#45) file, (70;33) position o Store Treatment for Acute Suicidal Crisis values in the PTF 501 (#45.02) sub-file, (0;33) position o Display whether or not the Inpatient visit is related to an Acute Suicidal Crisis on the PTF 101 screen o Upon discharge from Inpatient stay and readmission within same day, COMPACT Act Inpatient Benefit Start Date is maintained from initial admission o Upon discharge from Inpatient stay and no readmission within same day, automatically begin COMPACT Act Outpatient Benefit o When an admission, discharge, or transfer movement is deleted from Admit a Patient (DG ADMIT PATIENT) or Extended Bed Control (DG BED CONTROL EXTENDED), update the COMPACT ACT EPISODE OF CARE file (#818) accordingly o Edit the Start and End dates and Source of Crisis End from the Supervisor ADT Menu using the COMPACT Act EOC Edit Menu option o Change the value to "NO" from the Admitted for Acute Suicidal Crisis prompt, allowing retraction of EOC values if saved for the wrong patient or if the wrong codes were used and were discovered before discharge o Use the COMPACT Act EOC Inpatient Retraction menu option from the Supervisor ADT Menu, allowing retraction of the EOC if saved for the wrong patient or if the wrong codes were used. If an error is discovered after discharge, this menu is the only method to retract the EOC. o Display whether the patient is in an open EOC from Eligibility Inquiry for Patient Billing o Display the Administrative Eligibility status from the Patient Enrollment screen 2 o Updates the method (modified from Release 1) by which COMPACT Act Administrative Eligibility statuses are accessed o Captures and stores requests and responses to the Enrollment and Eligibility Webservice for COMPACT Act Administrative Eligibility status from the DGREGEEWS routine in the COMPACT ACT TRANSACTION LOG file (#33.3) o Allows a Monitor Report to be run from a command line, D QUERY^DGCOMPACT, that displays records to the screen from the COMPACT ACT TRANSACTION LOG FILE (#33.3) by calling routine Additional changes included in this patch unrelated to the COMPACT Act functionality include: o Added enhancement in DG REG for "Sexual Orientation Description" field to display "Sexual Orientation Free Text:" *NOTICE* The COMPACT Act patch installation order: 1. PX*1.0*240 2. DG*5.3*1104 Patch Components: ----------------- File Data Included (via post-install routine): File Name (Number) Entry Name New/Modified/Deleted ----------------------- ------------------ -------------------- VA ADMITTING REGULATION COMPACT ACT New (#43.4) Files & Fields Associated: File Name (Number) Field Name (Number) New/Mod/Del ------------------ ------------------- ------------ PTF (#45) TRT FOR ACUTE New SUICIDAL CRISIS (#79.33) Multiple file (#45.02) 501 (#50) Mod TREATMENT FOR New SUICIDAL CRISIS (#33) COMPACT ACT TRANSACTION LOG New (#33.3) ICN (#.01) CALLING ROUTINE (#2) REQUEST DATE TIMESTAMP (#3) DATA RESPONSE CODE (#4) RESPONSE DATE TIMESTAMP (#5) 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/Del/Mod ------------ ----------- ----------- DG SUPERVISOR MENU Menu Mod PX COMPACT ACT EOC EDIT Run Routine New PX COMPACT EOC IP RETRACTION Run Routine New Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A HL7 Logical Links New/Modified/Deleted ----------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A HL7 Application Parameter Associated: Application Parameter Name New/Modified/Deleted -------------------------- ------------------------ N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- DGPM ADMIT INPUT PATIENT MOVEMENT (405) Modified DGPM DISCHARGE INPUT PATIENT MOVEMENT (405) Modified Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- None Enhancement Tracking System Ticket(s) & Overview: Requirement 1: COMPACT-86 In ADT-REG, Store the values for the 'ADMITTED FOR ACUTE SUICIDAL CRISIS?' Resolution 1: Enhancement created in ADT-REG to store the values for the 'ADMITTED FOR ACUTE SUICIDAL CRISIS? question Requirement 2: COMPACT-445 In ADT-REG, Add COMPACT ACT record to VA ADMITTING REGULATION file (#43.4) Resolution 2: Enhancement created in ADT-REG, to add COMPACT ACT record to VA ADMITTING REGULATION file (#43.4) Requirement 3: COMPACT-458 In ADT-REG, Develop New Menu Option to Edit COMPACT Act EOC Data Elements Resolution 3: Added enhancement in ADT-REG for a new Menu Option to Edit COMPACT Act EOC Data Elements Requirement 4: COMPACT-560 In ADT-REG, Develop Ability to view End Date for Acute Suicidal Crisis Inpatient Services Resolution 4: Added enhancement in ADT-REG to view End Date for Acute Suicidal Crisis Inpatient Services Requirement 5: COMPACT-561 In ADT-PTF, Develop Ability to view End Date for Acute Suicidal Crisis Inpatient Services Resolution 5: Added enhancement in ADT-PTF to view End Date for Acute Suicidal Crisis Inpatient Services Requirement 6: COMPACT-608 In ADT-REG, Modify Business Logic for Admitted for Acute Suicidal Crisis Prompt Resolution 6: Added enhancement in ADT-REG to accommodate modified Business Logic for Admitted for Acute Suicidal Crisis Prompt Requirement 7: COMPACT-652 In ADT-REG, Develop ability to view Start Date of Acute Suicidal Crisis Inpatient Services Resolution 7: Added enhancement in ADT-REG to view Start Date of Acute Suicidal Crisis Inpatient Services Requirement 8: COMPACT-653 In ADT-PTF, Develop Ability to view Start Date of Acute Suicidal Crisis Inpatient Services if EOC Ended Resolution 8: Added enhancement in ADT-PTF to view Start Date of Acute Suicidal Crisis Inpatient Services if EOC ended Requirement 9: COMPACT-805 In ADT-REG, develop ability to view Remaining Days of Acute Suicidal Crisis Inpatient Services Resolution 9: Added enhancement in ADT-REG to view Remaining Days of Acute Suicidal Crisis Inpatient Services Requirement 10: COMPACT-806 In ADT-PTF, develop ability to view Remaining Days of Acute Suicidal Crisis Inpatient Services Resolution 10: Added enhancement in ADT-PTF to view Remaining Days of Acute Suicidal Crisis Inpatient Services Requirement 11: COMPACT-809 In ADT-PTF, Update the Display for COMPACT Act Admitting Eligibility on the PTF LOAD 101 Screen Resolution 11: Added enhancement to update the Display for COMPACT Act Admitting Eligibility on the PTF LOAD 101 Screen in ADT-PTF Requirement 12: COMPACT-885 In ADT-REG, add Acute Suicidal Crisis Y/N Clinical Determination to Eligibility Inquiry for Patient Billing Resolution 12: Added enhancement in ADT-REG for Acute Suicidal Crisis Y/N Clinical Determination to Eligibility Inquiry for Patient Billing Requirement 13: COMPACT-886 In ADT-REG, add Eligibility status to Patient Enrollment Screen 2 Resolution 13: Added enhancement in ADT-REG to view Eligibility status on Patient Enrollment Screen 2 Requirement 14: COMPACT-894 In ADT-REG, View/Edit Acute Suicidal Crisis and Start Date prompts Resolution 14: Added enhancement in ADT-REG to view/edit Acute Suicidal Crisis and Start Date prompts Requirement 15: COMPACT-999 In ADT-REG, Start an Episode of Care during admission process, and provide ability to edit patient through Extended Bed Control or Admit Patient (resolved bug COMPACT-1808) Resolution 15: Added enhancement in ADT-REG to start an Episode of Care during admission process Requirement 16: COMPACT-1013 In ADT-PTF, Create Treatment for Acute Suicidal Crisis Prompt in DG TRANSFER PATIENT; this is a required field (COMPACT-1843) Resolution 16: Added enhancement to create Treatment for Acute Suicidal Crisis Prompt in DG TRANSFER PATIENT in ADT-PTF Requirement 17: COMPACT-1201 In ADT-REG End Inpatient Benefit and Start Outpatient Benefit; users may enter a date of discharge or accept default of "Now//" (COMPACT-1797) Resolution 17: Added enhancement to end Inpatient Benefit and Start Outpatient Benefit in ADT-REG Requirement 18: COMPACT-1264 In DG REG, Update "Sexual Orientation Description" field to display "Sexual Orientation Free Text:" Resolution 18: Added enhancement in DG REG for "Sexual Orientation Description" field to display "Sexual Orientation Free Text:" Requirement 19: COMPACT-1286 In ADT-PTF, store Treatment for Acute Suicidal Crisis Value from DG TRANSFER PATIENT Prompt (501 screen and 101 screen) Resolution 19: Added enhancement in ADT-PTF to store Treatment for Acute Suicidal Crisis Value from DG TRANSFER PATIENT Prompt (501 screen and 101 screen) Requirement 20: COMPACT-1288 Develop DGCOMPACT routine for Acute Suicidal Crisis Inpatient Care and change API references (SETPTFFLG and SETPTFMVMT) to point to the DGCOMPACT routine Resolution 20: Added enhancement to DGCOMPACT routine for Acute Suicidal Crisis Inpatient Care and changed API references (SETPTFFLG and SETPTFMVMT) to point to the DGCOMPACT routine Requirement 21: COMPACT-1315 In ADT-REG Revise End Inpatient Benefit and Start Outpatient Benefit Resolution 21: Added enhancement in ADT-REG that revised End Inpatient Benefit and Start Outpatient Benefit Requirement 22: COMPACT-1316 In ADT-REG Validate Acute Suicidal Crisis Prompt, and provide ability to edit patient through Extended Bed Control or Admit Patient; this is a required field (COMPACT-1808 and COMPACT-1799) Resolution 22: Added enhancement in ADT-REG that validated Acute Suicidal Crisis Prompt Requirement 23: COMPACT-1368 Develop the DG Routine to retract EOC records before Inpatient Discharge entered on wrong patient or using wrong codes Resolution 23: Added enhancement to develop the DG Routine to retract EOC records before Inpatient Discharge entered on wrong patient or using wrong codes Requirement 24: COMPACT-1396 Create the menu to support ability to Retract EOC records entered on wrong patient or using wrong codes for inpatient Resolution 24: Added enhancement to link the new COMPACT Act EOC Inpatient Retraction menu option to the Supervisor ADT menu Requirement 25: COMPACT-1432 In ADT-REG Supervisor Menu, create the menu option, COMPACT Act EOC Inpatient Retraction, to retract records entered on wrong patient or using wrong codes Resolution 25: Added enhancement that created the menu option, COMPACT Act EOC Inpatient Retraction, in the ADT-REG Supervisor menu to execute routine to retract records entered on wrong patient or using wrong codes Requirement 26: COMPACT-1481 In DG TRANSFER Validate Treatment for Acute Suicidal Crisis Prompt; this is a required field (COMPACT-1799) Resolution 26: Added enhancement to provide a confirmation prompt to validate Treatment for Acute Suicidal Crisis prompt Requirement 27: COMPACT-1486 Develop Error Message Handling for Management Mail Group in the PCE Parameter file Resolution 27: Added enhancement in DG to create FileMan error messages when errors are received during updates to the COMPACT ACT TRANSACTION LOG File. The error messages are sent through MailMan to the individual processing the information or the COMPACT ACT COORDINATORS MailMan group if the MailMan group is set up for the site Requirement 28: COMPACT-1487 Fix Volume of and Duplicate Calls to VES Webservices Resolution 28: Added enhancement to cache the results of a call to the VHA Enrollment System (VES) Enrollment and Eligibility Service (EE) Webservices so that calls are not made to Webservices more than one time per patient per user session; moved a line of code to a different routine to eliminate other duplicate calls Requirement 29: COMPACT-1502 Update $$ADMIN^PXCOMPACT and point to ELIG^DGCOMPACTELIG Resolution 29: Added enhancement to replace $$ADMIN^PXCOMPACT function with $$ELIG^DGCOMPACTELIG function and redirect calling routines to the new centralized function Requirement 30: COMPACT-1520 Develop the COMPACT ACT TRANSACTION LOG file in FileMan Resolution 30: Added enhancement that created the COMPACT ACT TRANSACTION LOG File (#33.3) to store EE Webservice Request and Response Data for monitoring and troubleshooting Requirement 31: COMPACT-1521 Capture and store the EE Webservice Request and Response Data in the COMPACT ACT TRANSACTION LOG file Resolution 31: Added enhancement to capture and store the EE Webservice Request and Response Data in the COMPACT ACT TRANSACTION LOG file Requirement 32: COMPACT-1522 Develop the query to write records from the COMPACT ACT TRANSACTION LOG to the screen Resolution 32: Added enhancement to allow an EE Webservice monitoring report to query the COMPACT ACT TRANSACTION LOG File (#33.3) and write the data to the screen Requirement 33: COMPACT-1551 UPDATE In ADT-PTF, Store Treatment for Acute Suicidal Crisis Value from DG TRANSFER PATIENT Prompt (501 screen) and (101 screen) Resolution 33: Added enhancement to store the NO value given at the prompt in the ADT Bed Control Menu - Transfer a Patient section, "Was Treatment for Acute Suicidal Crisis?" in the current PTF 501 (#45.02) only and not the PTF 101 (#45) file Requirement 34: COMPACT-1552 UPDATE - In ADT-REG, Viewing/Editing Acute Suicidal Crisis Start Date prompts, the "Acute Suicidal Crisis Start Date:NOW//" prompt will always display when viewing and editing through Admit a Patient or Extended Bed Control, which requires the end user to enter a date or accept the "Now//" default (COMPACT-1790) Resolution 34: Added enhancement to allow viewing and editing of the START DATE on Inpatient Admission so the "Acute Suicidal Crisis Start Date: NOW//" prompt will always display regardless of whether there is a START date from an earlier admission Requirement 35: COMPACT-1620 Update the Episode Source field in the ADMIT API Resolution 35: Added enhancement to update the Episode Source field in the ADMIT API to include "V" for "VistA" Requirement 36: COMPACT-1804 Delete Movements from DG Admit or the Extended Bed Control Menu - Admission, Transfer, Discharge Resolution 36: Added enhancement to update the COMPACT ACT EPISODE OF CARE file (#818) accordingly when an Admission, Transfer, or Discharge movement is deleted using DG Admit or the Extended Bed Control menu PLEASE NOTE: SAC EXEMPTION 202410220719-05: XINDEX error message will be ignored within patch DG*5.3*1104 and PTF field use of $NEXT function will be corrected on the next Release. No functionality is affected. Test Sites: ----------- Minneapolis VA Medical Center VA Nebraska Western Iowa Health Care System St. Cloud VA Medical Center Test Sites - SNOW Change Order #: --------------------------------- Minneapolis VA Medical Center: Change Order #: CHG0527321 VA Nebraska Western Iowa Health Care System: Change Order #: CHG0527294 St. Cloud VA Medical Center: Change Order #: CHG0527325 Software and Documentation Retrieval Instructions: -------------------------------------------------- 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. File Description File Name FTP Mode ------------------------------------------------------------------------ PIMS Version 5.3 User Manual ADTBE_UM.PDF BINARY - ADT Module PIMS Version 5.3 User Manual ADT_PTF.PDF BINARY - PTF Menu PIMS Version 5.3 User Manual PIMS_REG_UM.PDF BINARY - Registration Menu PIMS Version 5.3 User Manual DG_REG_BC_UM.PDF BINARY - Bed Control Menu PIMS Version 5.3 User Manual SADT_UM.PDF BINARY - Supervisor ADT Menu PIMS Version 5.3 Technical Manual PIMS_TM.PDF BINARY VistA Monograph VISTA_MONOGRAPH.PDF BINARY COMPACT OHI Release 2 Release Notes DG_5.3_1104_RN.PDF BINARY Installation Instructions: 1. For installation instructions, refer to PX*1.0*240. 2. Installing the COMPACT ACT RELEASE 2 DG PX 1.0 multi-build will install both PX*1.0*240 and DG*5.3*1104. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.3;Registration;**[Patch List]**;Aug 13, 1993;Build 59 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: DGCOMPACT Before: n/a After: B15376026 **1104** Routine Name: DGCOMPACTELIG Before: n/a After: B9862470 **1104** Routine Name: DGENL1 Before: B94791439 After: B97161146 **121,147,232,266,343,564,672, 659,653,688,838,841,909,940, 972,993,1090,1104** Routine Name: DGP1104 Before: n/a After: B1205752 **1104** Routine Name: DGPMV3 Before: B26767743 After: B41182829 **34,54,62,95,692,715,895,1104** Routine Name: DGPMV36 Before: B11731899 After: B25367306 **1104** Routine Name: DGPTF1 Before: B41803529 After: B37692245 **69,114,195,397,342,415,565, 664,884,1095,1104** Routine Name: DGPTFM4 Before: B35748755 After: B46195606 **114,195,397,510,565,775,664, 759,850,884,1104** Routine Name: DGPTTS Before: B24184788 After: B26308992 **26,61,164,510,850,884,1104** Routine Name: DGRPD Before:B143437264 After:B146982373 **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, 1064,1086,1095,1104** Routine Name: DGRPDB Before: B35370141 After: B36125258 **26,50,358,570,631,709,713, 749,972,1064,1104** Routine list of preceding patches: 895, 1090, 1095 ============================================================================= User Information: Entered By : Date Entered : AUG 07, 2023 Completed By: Date Completed: OCT 23, 2024 Released By : Date Released : OCT 24, 2024 ============================================================================= Packman Mail Message: ===================== No routines included