$TXT Created by at CDVF.DEVSLC.DOMAIN.EXT (KIDS) on Monday, 05/08/23 at 15:26 ============================================================================= Run Date: JUL 06, 2023 Designation: PX*1*234 Package : PX - PCE PATIENT CARE ENCOUNTER Priority: Mandatory Version : 1 SEQ #178 Status: Released Compliance Date: JUL 13, 2023 ============================================================================= Associated patches: (v)PX*1*217 <<= must be installed BEFORE `PX*1*234' Subject: V HEALTH FACTORS MEASUREMENT REPAIR Category: - Routine - Other Description: ============ There was a bug introduced in PX*1.0*211 where for health factors that had a measurement defined, when one of those health factors was given to a patient, the UCUM CODE was stored in the V HEALTH FACTORS entry even though a measurement was not being recorded. The bug that created that bad data was fixed by PX*1.0*217. That bug was fixed in PX*1.0*217. The purpose of this emergency patch: PX*1*234, is to repair the corrupted measurements. When this patch is installed, it will automatically repair as many of those entries as it can. It will do this by examining the COMMENTS field and if a numeric value, that meets the criteria of the measurement definition in the health factor, can be extracted from the COMMENTS field, that numeric value will be stored in the MAGNITUDE field. For the two LCS health factors: LCS PACKS/DAY and LCS YEARS SMOKED, this process will be carried out even if the UCUM CODE field is empty. If the MAGNITUDE can be set, then the UCUM CODE will also be set to the UCUM CODE in the corresponding health factor. A list of all the V HEALTH FACTORS entries where a MAGNITUDE could not be automatically extracted from the COMMENTS will be built and sent to the members of the PCE Management Mail group. The COMMENTS can be manually reviewed and determine if a valid MAGNITUDE can be extracted and set. Details of this process are given in the post-installation steps. If health factors with incomplete measurement definitions are found a list of them will be sent to the members of the defined mail group listed in the MANAGEMENT MAIL GROUP (Field #650) within the PCE PARAMETERS file (File#815). These can be corrected using the option PXTT HEALTH FACTOR MANAGEMENT. In the routine PXCECCLS the variable VSIT was not being newed, so it was being left in the symbol table. This caused the following problem: In the input to DATA2PCE, if INPUT("ENCOUNTER",1,"MST")=1 and the patient has a current MST status of YES in the MST History file, #29.11, then PXCECCLS sets VSIT("MST")=1 and the Visit file entry that is created has MILITARY SEXUAL TRAUMA, field #80005 set to YES. Because VSIT is left in the symbol table, if the routine calling DATA2PCE makes multiple calls to DATA2PCE, without clearing the symbol table, subsequent patients can incorrectly have field #80005 set to YES. The solution is to new VSIT. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A 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/Modified/Deleted ----------- ---- -------------------- PX HF MEASUREMENT REPAIR R New 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: ----------------------- N/A Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: INC25254570 INC25300306 1. INC25254570 and INC25300306 Problem: -------- Corrupted V HEALTH FACTORS measurements. Resolution: ----------- Automatic repair of as many entries as possible. Repair by a human for those entries that could not be automatically repaired. 2. INC25418902 Problem: -------- DATA2PCE's input validation is rejecting VISIT/ADMIT DATE&TIME values where the time is exactly 24 hours, for example: 3221221.24, even though they are valid FileMan dates. Resolution: ----------- Change the input validation to allow dates with the 24 hour time. 3. Problem: -------- Incorrect setting of Visit file field #80005, MILITARY SEXUAL TRAUMA, to YES. See the Description for details. Resolution: ----------- New VSIT variable in VST^PXCECCLS. Test Sites: ----------- Seattle VA Medical Center Seattle, WA Miami Flagler VA Clinic Miami, FL 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 and /srv/vista/patches/SOFTWARE. Documentation Title File Name -------------------------------------------------------------------------- PX*1.0*234 Deployment, Installation, Back-Out, PX_1_0_234_DIBR.docx and Rollback Guide PX_1_0_234_DIBR.pdf PCE Health Factors Measurements Repair Release px_1_0_234_rn.docx Notes px_1_0_234_rn.pdf Patient Care Encounter Technical Manual pxtm.docx pxtm.pdf Patch Installation: ------------------- Pre-Installation Instructions: Prior to the patch installation the site should carry out the following steps: Make sure the MANAGEMENT MAIL GROUP, field #650, in the PCE PARAMETERS file, #815, is defined. Use the option PX SITE PARAMETER MENU then select SITE to review and if necessary, edit this field. Select OPTION NAME: PX SITE PARAMETER MENU PCE Site Parameter Menu SITE PCE Site Parameters Edit RPT PCE HS/RPT Parameter Menu ... Select PCE PARAMETERS ONE: 1 STARTUP VIEW: APPOINTMENT// BEGINNING PATIENT DATE OFFSET: -30// ENDING PATIENT DATE OFFSET: 1// BEGINNING HOS LOC DATE OFFSET: -7// ENDING HOS LOC DATE OFFSET: 0// RETURN WARNINGS: YES// MULTIPLE PRIMARY DIAGNOSES: RETURN WARNING// NO PRIMARY DIAGNOSIS: SD/PCE SWITCH OVER DATE: AUG 23,1996// HEALTH SUMMARY START DATE: AUG 23,1996// MANAGEMENT MAIL GROUP: If the MANAGEMENT MAIL GROUP is not already set, you can use an existing mail group or you can create a new mail group for this purpose. The members of the mail group will receive the MailMan messages that are generated during the installation of this patch. If you need to create a new mail group a suggested name is PCE MANAGEMENT. 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 15 seconds to install. 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. PX*1.0*234 NOTE: Using will not bring up a Multi-Package build even if it was loaded immediately before this step. It will only bring up the last patch in the build. 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 PX*1.0*234 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 this message? 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? NO//', answer NO. Post-Installation Instructions: After a successful installation the following init routine can be deleted: PXP234I If there were any Health Factors entries with incomplete measurement definitions, a MailMan message; Subject: HEALTH FACTORS WITH INCOMPLETE MEASUREMENT DEFINITION, with a list of these health factors was sent to the installer and to the members of the MANAGEMENT MAIL GROUP. See section 5.1.1 of the PCE V Health Factors Measurements Repair Release Notes for instructions on how to process the list and make repairs. If there were any V Heath Factors entries with measurements that could not be automatically repaired a MailMan message; Subject: V HEALTH FACTORS MEASUREMENT REPAIR, with a list of these entries was sent to the installer and to the members of the MANAGEMENT MAIL GROUP. See section 5.1.2 of the PCE V Health Factors Measurements Repair Release Notes for instructions on how to process the list and make repairs. Back-Out/Roll Back Plan: ------------------------ Refer to the PX*1.0*234 Deployment, Installation, Back-Out, and Rollback Guide. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;PCE PATIENT CARE ENCOUNTER;**[Patch List]**;Feb 12, 2004;Build 6 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PXCECCLS Before: B8826649 After: B8942797 **124,174,168,211,234** Routine Name: PXDATE Before: B6911810 After: B2676269 **211,217,234** Routine Name: PXHFMEASREPAIR Before: n/a After:B138237669 **234** Routine Name: PXP234I Before: n/a After: B1846762 **234** Routine list of preceding patches: 217 ============================================================================= User Information: Entered By : Date Entered : DEC 19, 2022 Completed By: Date Completed: JUL 05, 2023 Released By : Date Released : JUL 06, 2023 ============================================================================= Packman Mail Message: ===================== $END TXT