YS*5.01*154 (11568)    BUILD (9.6)

Name Value
NAME YS*5.01*154
DATE DISTRIBUTED 2020-03-23 00:00:00
PACKAGE FILE LINK MENTAL HEALTH
REQUIRED BUILD
  • YS*5.01*122
    ACTION:   Don't install, leave global
TYPE SINGLE PACKAGE
ALPHA/BETA TESTING NO
DESCRIPTION OF ENHANCEMENTS
The MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build is a warranty 
Risk Evaluation and Mitigation Strategy (REMS), which is mandated by the 
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.
 
Food and Drug Administration (FDA) for tracking clozapine patients. 
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 
The multi-build contains the Mental Health patch YS*5.01*154 and the 
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.
Outpatient Pharmacy patch PSO*7.0*574.  The list of defects and their 
 
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.
resolution is below.
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.
 
   *   *   *   *   *   *
 
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:
-------------------------------
Defect Tracking System Ticket(s) & 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
release for the National Clozapine Registry (NCR) software. This release 
   *   *   *   *   *   *
 
    ANON$:[ANONYMOUS.ANONYMOUS]MH_NCC_WARRANTY_5_01_T06.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.).
 
Patch YS*5.01*154 contains the following fixes:
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
1. Patients who are actively receiving clozapine (e.g. had a prescription 
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
last month) are discontinued.
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 
Defect 1132329
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.
 
Problem:
--------
will fix the defects and incidents reported by the sites to the 
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 
developers of the National Clozapine Coordination (NCC) Project. The 
(#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
project is also referred to as the Clozapine Modernization (ClozMod) 
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:
Project.
 
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.
 
The NCR is maintained by the National Clozapine Coordinating Center 
 
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.
 
(NCCC).  The NCCC is responsible for VA's compliance with the clozapine 
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:
--------
TRACK PACKAGE NATIONALLY YES
BUILD COMPONENTS
  • ENTRIES:
    • YSCLDIS
      ACTION:   SEND TO SITE
      CHECKSUM:   B47418871
    • YSCLTST5
      ACTION:   SEND TO SITE
      CHECKSUM:   B143634815
    • YSCLSERV
      ACTION:   SEND TO SITE
      CHECKSUM:   B123301096
    • YSCLSRV1
      ACTION:   SEND TO SITE
      CHECKSUM:   B2780525
    • YSCLSRV2
      ACTION:   SEND TO SITE
      CHECKSUM:   B39436709
    • YSCLSRV3
      ACTION:   SEND TO SITE
      CHECKSUM:   B65335887
    • YSCLTST9
      ACTION:   SEND TO SITE
      CHECKSUM:   B18516972
    • YSCLTST6
      ACTION:   SEND TO SITE
      CHECKSUM:   B33242045
PRE-INSTALL ROUTINE START^YSCL154P