$TXT Created by at CHY0009.FO-BAYPINES.DOMAIN.EXT (KIDS) on Friday, 12/04/20 at 16:51 ============================================================================= Run Date: FEB 25, 2021 Designation: PSO*7*613 Package : PSO - OUTPATIENT PHARMACY Priority: Mandatory Version : 7 SEQ #519 Status: Released Compliance Date: MAR 12, 2021 ============================================================================= Associated patches: (v)PSO*7*621 <<= must be installed BEFORE `PSO*7*613' Subject: CLOZMOD WARRANTY: ERRONEOUS CLOZ DC, MISSING LAB RESULTS, MISSING DD, NEW X-REF Category: - Routine - Data Dictionary Description: ============ This patch will resolve the following issues: 1. Clozapine Lab Results Not Displaying ---------------------------------------- INC 16836212 - Description: In Patient Prescription Processing, recent lab results are not displaying for patients if a temporary registration number was created in a previous session. See "Defect Tracking System Ticket(s) & Overview" section for Details. 2. Erroneous Clozapine Discontinues ----------------------------------- Description: The clozapine REGISTRATION DATE field (#58) in the PHARMACY PATIENT file (#55) is in some cases set as a date and time, erroneously discontinuing the patient's clozapine registration. Problem: The clozapine REGISTRATION DATE field (#58) in the PHARMACY PATIENT file (#55) is in some cases set as a date and time, erroneously causing patients' CLOZAPINE STATUS field (#54) to be set to "D" (Discontinued) when a pharmacy order is written on the same calendar date as the clozapine registration date. The clozapine auto-discontinue logic sets a patient's Clozapine Status to Discontinued if there are no clozapine orders during the first 28 days following the patient's clozapine registration. When the clozapine registration date contains a time in addition to the date, orders that were created immediately after the registration (on the same day) are not counted as clozapine activity because the order's Fill Date, which is a date only, is incorrectly evaluated as being before the registration date. Resolution: Change the auto-discontinue functionality to properly recognize clozapine orders that were created on the same date as the clozapine registration. Technical Resolution: The REGISTRATION DATE field (#58) in the PHARMACY PATIENT file (#55) are corrected to be filed as a date only, (with no time). Existing registration date/times are converted to date only via a post-installation routine. 3. New Data Dictionary fields in the CLOZAPINE PRESCRIPTION OVERRIDES file (#52.52). --------------------------------------------------------------------- Data Dictionary Update: During the research and development of this patch, it was discovered that 3 pieces of data are being stored in the CLOZAPINE PRESCRIPTION OVERRIDES (#52.52) file that are not documented in the FileMan Data Dictionary. These fields were documented and approved by the VA DBA as part of a previously released patch but were not included in that patch. These fields are being deployed in this patch. The three new fields are the OVERRIDE TEAM MEMBER field (#7), OVERRIDE PROVIDER field (#8), and the ORDER field (#9), all in the CLOZAPINE PRESCRIPTION OVERRIDE file (#52.52). See the 'Files and Fields Associated:' section of this patch description for more details. Standard FileMan listing of the three fields included in this patch: DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 52.52,7 OVERRIDE TEAM MEMBER 0;7 POINTER TO NEW PERSON FILE (#200) LAST EDITED: JUN 30, 2020 HELP-PROMPT: Enter the name of the clozapine team member who verified the override. DESCRIPTION: This is the member of the clozapine team who was selected to verify an override for this prescription or order. UNEDITABLE 52.52,8 OVERRIDE PROVIDER 0;8 POINTER TO NEW PERSON FILE (#200) LAST EDITED: JUL 02, 2020 HELP-PROMPT: Enter the name of the provider who entered the clozapine override. DESCRIPTION: This the provider who made the override for the prescription or order. UNEDITABLE 52.52,9 ORDER 0;9 POINTER TO ORDER FILE (#100) LAST EDITED: JUL 02, 2020 HELP-PROMPT: Enter the order number associated with this override. DESCRIPTION: This is the clozapine order number associated with this override. UNEDITABLE Cross Reference ---------------- A new MUMPS type Cross Reference has been added to the DATE TIME field (#.01) and the PRESCRIPTION NUMBER field (#1) in the CLOZAPINE PRESCRIPTION OVERRIDES file (#52.52) to populate the OVERRIDE PROVIDER field (#8) and the ORDER field (#9) in the CLOZAPINE PRESCRIPTION file (#52.52). A post-installation routine has also been included to re-index this new index. See the 'Files and Fields Associated:' section of this patch description for more details. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- CLOZAPINE PRESCRIPTION OVERRIDE TEAM MEMBER (#7) New OVERRIDES (52.52) OVERRIDE PROVIDER (#8) New ORDER (#9) New Cross References Associated: Cross Cross Cross Reference Reference Reference File Name (Number) Name Fields Type New/Modified/Deleted ------------------ --------- --------- ------ -------------------- CLOZAPINE REFERENCE AC .01 MUMPS New REFERENCE OVERRIDES 1 (52.52) File Name Forms Associated: Form Name File # New/Modified/Deleted --------- ------ -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A 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: -------------------------------------------- INC16836212 - In Patient Prescription Processing, recent lab results are not displaying for patients if a temporary registration number was created in a previous session. Problem: ---------- A patient where a temporary clozapine registration number is authorized followed by a blood work for WBC and ANC. This patient will not display this blood work upon subsequent entry of the prescription for clozapine. Instead, the pharmacist will see the misleading message "no previous results" which is incorrect. Resolution: ------------- Change line PSOCLO1+35^PSOCLO1 to remove the erroneous trailing Q From: > .I '$G(CLOZFLG),$G(^TMP($J,"CLOZFLG",DFN)) S CLOZFLG=1 Q To: > .I '$G(CLOZFLG),$G(^TMP($J,"CLOZFLG",DFN)) S CLOZFLG=1 This Quit was necessary in previous versions of the code to prevent displaying the labs twice. In the current version of the code, it has the effect of not displaying labs at all. Test Sites: ----------- Boston HCS (523) Fargo, ND (437) 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 ------------------------------------------------------------------------- Title File Name ------------------------------------------------------------------------- Deployment Installation Back-Out pso_7_p613_dibrg.docx and Rollback Guide pso_7_p613_dibrg.pdf Patch Installation: ------------------- Pre/Post Installation Overview: Post installation validation must be done on the fields installed for the CLOZAPINE PRESCRIPTION OVERRIDES file (#52.52). 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: 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 PSO*7*613. 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 for each patch contained in the Host File. For each patch you can specify what to backup; the entire Build or just Routines. The backup message can be used to restore just the routines or everything that will restore your system to 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. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//', answer NO. ii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//', answer NO. Post-Installation Instructions: Using FileMan, validate that the install of the following three fields in the CLOZAPINE PRESCRIPTION OVERRIDES file (#52.52) were successful: OVERRIDE TEAM MEMBER field (#7) OVERRIDE PROVIDER field (#8) ORDER field (#9) Steps: 1. From FileMan, select the DATA DICTIONARY UTILITIES option. 2. Select the LIST FILE ATTRIBUTES option. 2. Select file 52.52 3..Select STANDARD for LISTING FORMAT 4. Start with field 7 5. Go to field 9 6. The 3 fields should be displayed like below. Example: Select OPTION: ? Answer with OPTION NUMBER, or NAME Choose from: 1 ENTER OR EDIT FILE ENTRIES 2 PRINT FILE ENTRIES 3 SEARCH FILE ENTRIES 4 MODIFY FILE ATTRIBUTES 5 INQUIRE TO FILE ENTRIES 6 UTILITY FUNCTIONS 7 OTHER OPTIONS 8 DATA DICTIONARY UTILITIES 9 TRANSFER ENTRIES Select OPTION: 8 DATA DICTIONARY UTILITIES Select DATA DICTIONARY UTILITY OPTION: ? Answer with DATA DICTIONARY UTILITY OPTION NUMBER, or NAME Choose from: 1 LIST FILE ATTRIBUTES 2 MAP POINTER RELATIONS 3 CHECK/FIX DD STRUCTURE 4 FIND POINTERS INTO A FILE 5 UPDATE THE META DATA DICTIONARY Select DATA DICTIONARY UTILITY OPTION: 1 LIST FILE ATTRIBUTES START WITH What File: CLOZAPINE PRESCRIPTION OVERRIDES// 52.52 CLOZAPINE PRESCRIPTION OVERRIDES (449 entries) GO TO What File: CLOZAPINE PRESCRIPTION OVERRIDES// (449 entries) Select LISTING FORMAT: STANDARD// Start with field: FIRST// 7 OVERRIDE TEAM MEMBER Go to field: 9 ORDER DEVICE: HOME (CRT) Right Margin: 80// STANDARD DATA DICTIONARY #52.52 -- CLOZAPINE PRESCRIPTION OVERRIDES FILE 1/25/21 PAGE 1 STORED IN ^PS(52.52, (449 ENTRIES) DATA NAME GLOBAL DATA ELEMENT TITLE LOCATION TYPE -------------------------------------------------------------------------- 52.52,7 OVERRIDE TEAM MEMBER 0;7 POINTER TO NEW PERSON FILE (#200) LAST EDITED: JUN 30, 2020 HELP-PROMPT: Enter the name of the clozapine team member who verified the override. DESCRIPTION: This is the member of the clozapine team who was selected to verify an override for this prescription or order. UNEDITABLE 52.52,8 OVERRIDE PROVIDER 0;8 POINTER TO NEW PERSON FILE (#200) LAST EDITED: JUL 02, 2020 HELP-PROMPT: Enter the name of the provider who entered the clozapine override. DESCRIPTION: This the provider who made the override for the prescription or order. UNEDITABLE 52.52,9 ORDER 0;9 POINTER TO ORDER FILE (#100) LAST EDITED: JUL 02, 2020 HELP-PROMPT: Enter the order number associated with this override. DESCRIPTION: This is the clozapine order number associated with this override. UNEDITABLE FILES POINTED TO FIELDS NEW PERSON (#200) OVERRIDE TEAM MEMBER (#7) OVERRIDE PROVIDER (#8) ORDER (#100) ORDER (#9) Back-Out/Roll Back Plan: ------------------------ The routines can be restored from the backup message created in the installation steps. The data dictionary components of this patch can be removed using standard VA FileMan options. See the patch PSO*7.0*613 Routine Information: ==================== The second line of each of these routines now looks like: ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997;Build 10 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PSO613P Before: n/a After: B14106846 **613** Description of Changes: 52.52,7 OVERRIDE TEAM MEMBER 0;7 POINTER TO NEW PERSON FILE (#200) Routine Name: PSOCLADD Before: B17784992 After: B29193035 **612,613** Routine Name: PSOCLO1 Before:B206896982 After:B207134495 **1,23,37,222,457,574,612,621,613** Routine list of preceding patches: 621 ============================================================================= User Information: Entered By : Date Entered : MAY 07, 2020 Completed By: Date Completed: FEB 25, 2021 Released By : Date Released : FEB 25, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT