============================================================================= Run Date: NOV 18, 2025 Designation: PX*1*241 Package : PX - PCE PATIENT CARE ENCOUNTER Priority: Mandatory Version : 1 SEQ #184 Status: Released Compliance Date: DEC 18, 2025 ============================================================================= Associated patches: (v)PX*1*240 <<= must be installed BEFORE `PX*1*241' Subject: COMPACT ACT RELEASE 3 Category: - Routine - Data Dictionary Description: ============ This patch updates the COMPACT ACT EPISODE OF CARE (EOC) file (#818) and renames the Acute Suicidal Crisis flag to the EOC Open/Close flag. No end user functionality is updated or added with this patch. Additional functionality includes the following (note: complete functionality features can be reviewed in the Enhancement Tracking System Ticket(s) & Overview section): o Ability to share COMPACT ACT EOC data with VHA Enrollment System (ES) via an (Application Programming Interface (API) that populates Income Verification Match (IVM) Patient Health Level (HL) 7 segments. o Ability to send Treatment For values - Inpatient and Outpatient - to VistA Integrated Billing via an API. New indices were added to the COMPACT ACT EOC file to facilitate efficient lookup. o Update SETVSTFLG API to include new indices. o Update all PX routines to point to the new EOC Open/Close flag. o Update batch API for DSS, Inc. to include Administrative Eligibility Field #08 of the COMPACT ACT EPISODE OF CARE File (#818). o Added the COMPACT ACT DISPLAY EOC DATA option to view COMPACT data These patches are being released via a Kernel Installation and Distribution System (KIDS) multi-build distribution. KIDS multi-build name: COMPACT ACT RELEASE 3 DG PX 1.0 KIDS Host File name: COMPACT_ACT_RELEASE_3.KID *NOTICE* The COMPACT Act patch installation order: 1. PX*1.0*241 2. DG*5.3*1117 EHRM Impact Statement: ---------------------- - This patch can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- File Data Included: File Name (Number) Entry Name Modified -------------------------------- ------------------------ ------------ N/A Files & Fields Associated: File Name (Number) Field Name (Number) New/Mod/Del ---------------------------- ------------------------------ ----------- COMPACT ACT EPISODE OF CARE (#818) EOC OPEN/CLOSE FLAG (#2) Mod Multiple file (#818.01) EPISODES OF CARE (#10) Mod EPISODE START DATE (#.01) Mod INPATIENT BENEFIT END DATE (#4) Mod OUTPATIENT BENEFIT END DATE (#5) Mod REMAINING INPATIENT DAYS (#42) computed REMAINING OUTPATIENT DAYS (#43) computed Multiple file (#818.02) INPATIENT EXTENSION (#20) Mod IP EXTN BENEFIT END DATE (#4) Mod IP EXTN REMAINING DAYS (#5) computed Multiple file (#818.03) OUTPATIENT EXTENSION (#30) Mod OP EXTN BENEFIT END DATE (#4) Mod OP EXTN REMAINING DAYS (#5) computed Multiple file (#818.04) TREATMENT (#40) Mod PTF (#.01) Mod MOVEMENT (#1) New Multiple file (#818.41) MOVEMENT (#.01) New Multiple (#818.141) VISIT (#41) Mod VISIT (#.01) Mod TREATMENT FOR FLAG (#2) Mod 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 ------------ ----------- ----------- PX COMPACT ACT EOC DISPLAY Routine New PX COMPACT ACT EOC MAIN MENU Menu Mod Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A HL7 Logical Links New/Modified/Deleted ----------------- -------------------- N/A Security Keys Associated: Security Key Name New/Deleted ----------------- ----------- PX EOC EDIT HL7 Application Parameter Associated: Application Parameter Name New/Modified/Deleted -------------------------- ------------------------ 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 New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- None Enhancement Tracking System Ticket(s) & Overview: Requirement 1: COMPACT-1014 Develop API and IVM Trigger for VHA ES to consume COMPACT EOC data via custom HL7 messaging workbench file. Resolution 1: Added database triggers to the EOC file that will call the IVM trigger entry point API (EVENT^IVMPLOG). Requirement 2: COMPACT-1209 Update batch API for DSS, Inc. to include Administrative Eligibility Field #08. Resolution 2: Updated batch API for DSS to include Administrative Eligibility Field #08. Requirement 3: COMPACT-1302 Update the PX routines with EOC OPEN/CLOSE FLAG field name where Acute Suicidal Crisis flag is referenced. Resolution 3: Updated three routines: PXCOMPACT, PXCOMPACTHL7 and PXCOMPACTAPI to now reference EOC OPEN/CLOSE FLAG field. Requirement 4: COMPACT-1367 Create an EXTRACTIB API that is triggered by parameters sent from Integrated Billing (IB) and returns the specific data elements that are needed for IB to cancel first party co-pays. Resolution 4: Created EXTRACTIB API that accepts IB parameters and returns Treatment For values. Requirement 5: COMPACT-1677 Update the SETVISIT API to include the new indices - ^PXCOMP(818,"COMPACTVISIT",VISIT IEN)=TREATMENT FOR FLAG. Resolution 5: Updated SETVISIT API with new indices. Requirement 6: COMPACT-1813 Update Episode of Care VISIT subfile xrefs 818.141, field 2. Resolution 6: Updated EOC VISIT subfile xrefs 818.141, field 2. Requirement 7: COMPACT-1846 Finalize Display of EOC Data for VistA End Users. Resolution 7: Added the COMPACT ACT DISPLAY EOC DATA option to view COMPACT data. 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 #: CHG0651661 VA Nebraska Western Iowa Health Care System: Change Order #: CHG0651662 St. Cloud VA Medical Center: Change Order #: CHG0651656 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: /srv/vista/patches/SOFTWARE/COMPACT_ACT_RELEASE_3.KID 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 ------------------------------------------------------------------------ Patient Care Encounter Version 1 PX_TM.PDF Technical Manual PX_TM.DOCX Patient Care Encounter Version 1 PX_UM.PDF User Manual PX_UM.DOCX Patch Installation: ------------------- Pre/Post Installation Overview: 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. Installation Instructions: Note: Installing the COMPACT ACT RELEASE 3 DG PX 1.0 multi-build will install both PX*1.0*241 and DG*5.3*1117. 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to "Enter a Host File:" enter /srv/vista/patches/SOFTWARE/COMPACT_ACT_RELEASE_3.KID 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 COMPACT ACT RELEASE 3 DG PX 1.0. 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 COMPACT ACT RELEASE 3 DG PX 1.0. 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 to Enter a Host File, enter the path and name for the host file backup file. If you don't specify a directory,the default directory of HFS Primary Directory will be used. (ex. COMPACT_ACT_RELEASE_3_BACKUP.KID) The backup host file can be used to restore your system to its pre-patch condition. 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. Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO// respond NO. ii. When Prompted "Want KIDS to INHIBIT LOGONs during the install? NO//" respond NO. iii. When Prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//" respond NO. iiii. If prompted 'Delay Install (Minutes): (0-60): 0//' respond 0. Post-Installation Instructions: After installation, verification of the update of the COMPACT ACT EPISODE OF CARE (#818) with EOC Open/Close Flag field name in field #.02 will be completed. Back-Out/Roll Back Plan: ------------------------ Back-out will be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between the development team, VA site/region personnel and other appropriate VA personnel. Prior to installing an updated KIDS package, the site/region should have saved a backup of the routines in a KIDS file using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The file containing the backed-up routines can be loaded with the Load a Distribution option contained on the Kernel Installation and Distribution System Menu. The Install Package(s) option is then used to install the backed-up routines onto the VistA System. The back-out plan is to restore the routines from the backup created. No data was modified by this patch installation and, therefore, no rollback strategy is required. Validation of Back-out Procedure -------------------------------- The Back-out Procedure can be verified by printing the first 2 lines of the routines contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the routines contained in the PX*1.0*241 and DG*5.3*1117 patches have been backed out, the first two lines of the routines will no longer contain the designations of these patches. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;PCE PATIENT CARE ENCOUNTER;**[Patch List]**;Aug 12, 1996;Build 31 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PXCOMPACT Before:B198710909 After:B242641375 **240,241** Routine Name: PXCOMPACTAPI Before: n/a After: B60160024 **241** Routine Name: PXCOMPACTDISP Before: n/a After: B15083845 **241** Routine Name: PXCOMPACTEVAL Before: B53015537 After: B53212391 **240,241** Routine Name: PXCOMPACTHL7 Before: n/a After: B9771800 **241** Routine Name: PXCOMPACTIB Before: n/a After: B5590718 **241** Routine list of preceding patches: 240 ============================================================================= User Information: Entered By : Date Entered : JAN 16, 2024 Completed By: Date Completed: NOV 17, 2025 Released By : Date Released : NOV 18, 2025 ============================================================================= Packman Mail Message: ===================== No routines included