============================================================================= Run Date: APR 06, 2020 Designation: YS*5.01*154 Package : YS - MENTAL HEALTH Priority: EMERGENCY Version : 5.01 SEQ #124 Status: Released Compliance Date: APR 15, 2020 ============================================================================= Associated patches: (v)YS*5.01*122 <<= must be installed BEFORE `YS*5.01*154' Subject: MENTAL HEALTH NCC WARRANTY RELEASE 5.01 Category: - Routine - Data Dictionary Description: ============ The MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build is a warranty release for the National Clozapine Registry (NCR) software. This release will fix the defects and incidents reported by the sites to the developers of the National Clozapine Coordination (NCC) Project. The project is also referred to as the Clozapine Modernization (ClozMod) Project. The NCR is maintained by the National Clozapine Coordinating Center (NCCC). The NCCC is responsible for VA's compliance with the clozapine Risk Evaluation and Mitigation Strategy (REMS), which is mandated by the Food and Drug Administration (FDA) for tracking clozapine patients. The multi-build contains the Mental Health patch YS*5.01*154 and the Outpatient Pharmacy patch PSO*7.0*574. The list of defects and their resolution is below. Defect Tracking System Ticket(s) & Overview: -------------------------------------------- * * * * * * Patch YS*5.01*154 contains the following fixes: 1. Patients who are actively receiving clozapine (e.g. had a prescription last month) are discontinued. Defect 1132329 Problem: -------- The YSCL DAILY TRANSMISSION option checks for clozapine patients who should be discontinued. The logic was erroneously discontinuing patients. Resolution: ----------- The YSCLDIS and YSCLTST5 routines were modified to correct issues with clozapine patients being discontinued erroneously when the YSCL DAILY TRANSMISSION runs at the site. The fixes also ensure that information about patients that were discontinued is stored in ^XTMP("YSCLDIS") as a log. A discontinued patient is one who has the CLOZAPINE STATUS field (#54) in the PHARMACY PATIENT FILE (#55) set to "DISCONTINUED". The YSCL154P pre-init routine was created to ensure that the YSCL DAILY TRANSMISSION option is scheduled in the OPTION SCHEDULING FILE (#19.2). If the option is scheduled the installer will see a message like this: YSCL DAILY TRANSMISSION information in file #19.2: QUEUED TO RUN AT WHAT TIME: OCT 02, 2019@01:30 RESCHEDULING FREQUENCY: 1D TASK ID: 2576362 No issues found for the YSCL DAILY TRANSMISSION option. If the YSCL154P routine detects an issue the installer will see messages that look like the two examples shown below. If a message like this is shown then the site will need to take corrective action to schedule the YSCL DAILY TRANSMISSION using TaskMan options. If there are any questions about how to schedule the option please contact the ClozMod team. Error message example 1 from the YSCL154P routine: YSCL DAILY TRANSMISSION information in file #19.2: *** WARNING *** The option is NOT scheduled. The YSCL DAILY TRANSMISSION Option should be scheduled to be run daily, in the early AM hours with no DEVICE. Error message example 2 from the YSCL154P routine: YSCL DAILY TRANSMISSION information in file #19.2: QUEUED TO RUN AT WHAT TIME: * Time not found! * RESCHEDULING FREQUENCY: 1D TASK ID: * Task not found! * The YSCL DAILY TRANSMISSION Option should be scheduled to be run daily, in the early AM hours with no DEVICE. Note: There are routines in the PSO*7.0*574 patch that also address this defect. 2. Registered clozapine patients who have not received a clozapine prescription in more than 56 days may not be discontinued. Defect 1132404 Problem: -------- A patient who had not received Clozapine for more than 56 days did not have their status changed to DSCONTINUED during the nightly scan. Resolution: ----------- Logic in routine YSCLDIS was changed to fix the problem. 3. Newly Registered clozapine patients were only getting a dispense frequency of WEEKLY in file #603.01. Defect 1132352 Problem: -------- A server command being sent from Forum to the YSCLSERVER MailMan server at the sites wasn't being handled correctly by the server routines. Resolution: ----------- Routine YSCLSERV was modified to put the correct DISPENSE FREQUENCY (field #2) in the CLOZAPINE PATIENT LIST file (#603.01); this routine was also modified for defect 1132342 (see below). Routine YSCLTST5 was changed to remove code that was overwriting data written in ^XTMP. 4. Nightly transmission missing required data. Defect 1132355 Problem: -------- The YSCL DAILY TRANSMISSION option may not have sent all the necessary data to the Forum Mail Group. Resolution: ----------- Routines YSCLSERV, YSCLSRV1, YSCLSRV2, and YSCLSRV3 were modified to ensure that all the needed data are returned. The call to the MailMan Application Programmer Interface (API) was updated. 5. Discontinue Message not sent Defect 1132342 Problem: -------- Patients are discontinued without a message being sent to the NCCC alerting them that a patient was discontinued. Resolution: ----------- Routine YSCLSERV was modified to ensure that the discontinue message is sent); this routine was also modified for defect 1132355 (see above). 6. The option Daily Clozapine Transmission [YSCL DAILY TRANSMISSION] was not always sending demographic data to the RUCL files in Hines. Defect 1155009. Problem: -------- The Daily Clozapine Transmission option was not sending demographic data to the CLOZARIL REPORTS file (#1900) in the FOURWORD server that resides in the Hines data center. Resolution: ----------- This is not directly testable at sites. Data are now sent to the FOURWORD server which contains the legacy Clozapine registration database. Routines YSCLDIS, YSCLSERV, and YSCLTST5 were modified. Routine YSCLTST9 was created. 7. YSCL DAILY TRANSMISSION Missing Required Data Defect 1155009 Defect 1132355 Problem: -------- MailMan Messages for tracking Clozapine prescriptions and clinical orders are sent to the FOURWORD server in Hines (Chicago). Some of the records were missing required data for tracking provider overrides. These messages are parsed and stored in the CLOZARIL REPORTS file (#1900.1). This file is part of the NCR. Resolution: ----------- The YSCLTS6 routine has been updated. It had logic that prevented some data from being placed into the list that is stored in the ^XTMP("YSCLTRN"). Unneeded code was removed. Note that this problem cannot be tested in pre-production systems as they have no link to the NCR. * * * * * * Test Sites: ---------- - West Los Angeles VAMC (691) - N. Florida /S. Georgia VAMC (573) - VA Connecticut Healthcare System - West Haven Division (689) There are no documentation updates associated with this patch. Patch Installation: Pre/Post Installation Overview: ------------------------------- There are no tasks to be performed before the installation of this multi-build. Note that the routines should be backed up to a PackMan message before installing the build. 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. It should not be installed when the YSCL DAILY TRANSMISION option is running. If unsure when that is check the OPTION SCHEDULING file (#19.2) using FileMan: Select VA FileMan Option: Inquire to File Entries Output from what File: OPTION SCHEDULING// (17 entries) Select OPTION SCHEDULING NAME: YSCL DAILY TRANSMISSION Another one: Standard Captioned Output? Yes// (Yes) Include COMPUTED fields: (N/Y/R/B): NO// - No record number (IEN), no Computed Fields NAME: YSCL DAILY TRANSMISSION QUEUED TO RUN AT WHAT TIME: OCT 05, 2019@01:30 RESCHEDULING FREQUENCY: 1D TASK ID: 2577736 Installation Instructions: -------------------------- 1. The KIDS multi-build can be found in the VistA software repository at download.vista.domain.ext ANON$:[ANONYMOUS.ANONYMOUS]MH_NCC_WARRANTY_5_01.KID Place the KIDS multi-build file into a local directory and use the KIDS option Load a Distribution option to load it into the transport global. 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 3. From the Kernel Installation and Distribution System Menu, select the Installation Menu. From this menu, you may elect to use the following options. When prompted for the INSTALL NAME enter: MENTAL HEALTH NCC WARRANTY RELEASE 5.01 a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. b. 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 components of this patch routines, DDs, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install (MENTAL HEALTH NCC WARRANTY RELEASE 5.01). 5. Accept the default when prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' 6. Accept the default when prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' 7. Accept the default when prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' 8. If prompted 'Delay Install (Minutes): (0 - 60): 0// enter 0 (zero). Backout /Rollback Strategy: --------------------------- Backout will be done only with the concurrence and participation of development team and appropriate VA site/region personnel. The decision to backout the software will be a joint decision between development team, VA site and regional personnel, and other appropriate VA personnel. Rollback applies to data only and is not applicable to this multi-build. Prior to installing the KIDS multi-build, the site/region should have saved a backup of the routines in a PackMan message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up routines can be loaded with the "Xtract PackMan" function at the Message Action prompt. The PackMan function "INSTALL/CHECK MESSAGE" is then used to install the backed up routines onto the VistA System. Validation of Backout Procedure ------------------------------- The backout Procedure can be verified by printing the first 2 lines of the PSO* and YS* Routines contained in the MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build using the option First Line Routine Print [XU FIRST LINE PRINT]. Once the old routines listed in the multi-build patch have been restored, the first two lines of the Routines will no longer contain the designation of patch 574 (for Outpatient Pharmacy PSO* routines) and patch 154 (for Mental Health YS* routines) in the patch list section on line 2 of the routines. Routine Information: ==================== The second line of each of these routines now looks like: ;;5.01;MENTAL HEALTH;**[Patch List]**;Dec 30, 1994;Build 49 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: YSCL154P Before: n/a After: B5620506 **154** Routine Name: YSCLDIS Before: B33307266 After: B47418871 **122,154** Routine Name: YSCLSERV Before:B113744359 After:B123301096 **18,22,26,47,61,69,74,90,92, 122,154** Routine Name: YSCLSRV1 Before: B2824351 After: B2780525 **61,69,74,90,122,154** Routine Name: YSCLSRV2 Before: B41052596 After: B39436709 **69,90,92,154** Routine Name: YSCLSRV3 Before: B47455212 After: B65335887 **74,90,92,154** Routine Name: YSCLTST5 Before:B144170754 After:B143634815 **122,154** Routine Name: YSCLTST6 Before: B35479087 After: B33242045 **122,154** Routine Name: YSCLTST9 Before: n/a After: B18516972 **154** Routine list of preceding patches: 122 ============================================================================= User Information: Entered By : Date Entered : SEP 29, 2019 Completed By: Date Completed: APR 03, 2020 Released By : Date Released : APR 06, 2020 ============================================================================= Packman Mail Message: ===================== No routines included