| 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
At least one site has reported temporary registration starting with the
letter "R" when they were expecting it to start with "Z".
Resolution:
-----------
The PSO574P pre-init routine also updates the CLOZAPINE WEEKEND
REGISTRATION list that is stored in ^XTMP("PSJ CLOZ"). This will ensure
that any temporary registration numbers that were generated during IOC
tests and were not used will be recovered. This issue was revealed in
the MailMan messages sent to the CLOZAPINE ROLL-UP Mail Group in Forum.
Food and Drug Administration (FDA) for tracking clozapine patients.
6. Ensure "Expires:" Date is Correct
Defect 1132368
Problem:
--------
The CPRS team found a typo in routine PSODIR2. The code had a comma
where it should have a less than sign. Only clozapine prescriptions
would have been affected. This logic is used to create the value for the
"Expires:" prompt in Patient Prescription Processing.
Resolution:
-----------
Routine PSODIR2 was corrected.
7. Dose default is missing for active or pending prescriptions.
Defect 1106891
Problem:
--------
The multi-build contains the Mental Health patch YS*5.01*154 and the
The default dose is missing when editing all prescriptions in Pharmacy
backdoor orders. It should be there for non-clozapine prescriptions.
The prior fix removed this for all prescriptions.
Resolution:
-----------
The logic in routines PSOBKDED and PSONEW1 was modified to only remove
the default dose for Clozapine prescriptions.
Outpatient Pharmacy patch PSO*7.0*574. The list of defects and their
8. Remove the "Quantity Being Changed" message displaying during backdoor
pharmacy processing of a Clozapine Outpatient 4 Day Override Order.
Defect 1155637
Problem:
--------
The "Quantity Being Changed" message was being displayed when a
pharmacist was editing a 4 day temporary override Clozapine
prescription. Users at the IOC sites found this to be confusing wand
wanted it removed.
resolution is below.
Resolution:
-----------
The routine PSOSIG was modified to display this message ONLY for
non-clozapine prescriptions.
9. CPRS Complex Order Default Dose Incorrect
Defect 1180952
Problem:
--------
Complex orders which have multiple dosages were not displaying the
correct defaults during dosage edit.
Resolution:
-----------
Routine PSOBKDED was modified to add the default dose.
10. Missing Unit Price of Drug
Defect 1181628
Defect Tracking System Ticket(s) & Overview:
Problem:
--------
Prescriptions for certain medications were not storing the UNIT PRICE OF
DRUG field. This occurred when the DRUG had a REORDER LEVEL field (#11)
value of zero or null.
Resolution:
-----------
The branching logic in the SET^PSODRG subroutine was corrected.
--------------------------------------------
11. Temporary numbers generated off the date
Defect 1181858
Problem:
--------
The logic to generate a temporary clozapine registration number was not
always generating a sequential counter.
Resolution:
-----------
The logic in FINDNEXT^PSOCLUTL was modified.
12. ^XTMP("PSJ CLOZ",0) purge date
Defect 1181868
Problem:
--------
release for the National Clozapine Registry (NCR) software. This release
Patch PSO*7.0*574 contains the following fixes:
The purge date in the ^XTMP("PSJ CLOZ",0) global node was not always set
to the same number of days in the future. This is a matter of programming
style. No error was generated; no functionality was affected. The
development accepted this as a defect to end the discussion. The change
cannot be seen by users and there is no way to test this.
Resolution:
-----------
Routine PSOCLO1 was changed to call the line tag XTMPZRO^PSOCLOU.
13. Expiration Date Calculated Incorrectly
Defect 1182728
Problem:
--------
When a Clozapine prescription was being edited the expiration date may
not have been computed correctly. This was related to editing the
quantity and days supply values.
1. Incorrect computation of drug costs
Resolution:
-----------
Routines PSOCLO1, PSODIR1, and PSOORED6 were modified. The logic to
compute the expiration was moved to the new subroutine EXPDT^PSOCLO1.
14. Patient Lookup in Register Clozapine Patient [PSOL REGISTER PATIENT]
Defect 1210946
Problem:
--------
Defect 1132310
The Patient Lookup in the Register Clozapine Patient [PSOL REGISTER
PATIENT] option doesn't allow a user to enter the last initial and last 4
digits of the patient's Social Security Number (SSN).
Resolution:
-----------
Routine PSOCLUTL was modified in the REG subroutine to add an "M" to the
DIC(0) value to allow a patient lookup on multiple cross-references.
15. Error on Clozapine Inpatient Medication
INC7277287 - East Bay Division - Martinez Outpatient Clinic
Defect 1227862
Problem:
--------
When a user enters the Inpatient Order Entry [PSJ OE] option for
Clozapine patients an <UNDEFINED> error occurs. The PSODFN variable is
undefined,
Resolution:
-----------
INC7340377 - VA Connecticut Healthcare System West Haven Campus
Routine PSOCLO1 was modified to set PSODFN if it's undefined, based on
the value in DFN.
* * * * * *
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
Problem:
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
Users would see incorrect values for the costs of prescriptions.
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.
will fix the defects and incidents reported by the sites to the
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.
Resolution:
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.
The PSODRG routine has been updated to fix the problem with incorrect
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
computation for prescription costs.
(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
The PSODRG routine was incorrectly referencing this field for the drug
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).
cost:
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.
50,15 DISPENSE UNITS PER ORDER UNIT 660;5 NUMBER
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.
It has been changed to this field:
* * * * * *
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.
developers of the National Clozapine Coordination (NCC) Project. The
50,16 PRICE PER DISPENSE UNIT 660;6 NUMBER
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)
2. During backdoor pharmacy process of Outpatient 4 Day Override order, a
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
field called LIMITED DURATION appears.
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_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.
Defect 981761
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).
Problem:
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.
When entering a clozapine prescription for an Outpatient 4 Day Override
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
-------------------------------
order, a field called LIMITED DURATION is presented. The IOC sites
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.
project is also referred to as the Clozapine Modernization (ClozMod)
stated that this may be misleading to the pharmacy staff and want it
removed.
Resolution:
-----------
The logic in routine PSOORED5 was modified to remove the LIMITED DURATION
field for clozapine prescriptions. Routine PSONEW1 was modified to
correct the sig for the clozapine prescription.
3. Patients who are actively receiving clozapine (e.g. had a prescription
Project.
last month) are discontinued.
Defect 1132329
Problem:
--------
The YSCL DAILY TRANSMISSION option checks for clozapine patients who
should be discontinued. The code uses a Mail Group and an ^XTMP storage
location that are in the Pharmacy namespace.
Resolution:
-----------
The PSO574P pre-init routine was created to ensure that the PSOCLOZ Mail
Group TYPE is set to "PUBLIC" and ALLOW SELF ENROLLMENT? is set to "NO".
This will prevent any issues when email messages are sent to that Mail
Group.
Note: There are routines in the YS*5.01*154 patch that also address this
defect.
4. The Register Clozapine Patient option needs a restriction to only
The NCR is maintained by the National Clozapine Coordinating Center
allow registered patients.
Defect 1133724
Problem:
--------
The Register Clozapine Patient [PSOL REGISTER PATIENT] option needs a
restriction to only allow patients that have a CLOZAPINE REGISTRATION
NUMBER in the CLOZAPINE PATIENT LIST file (#603.01). The option updates
fields in the PHARMACY PATIENT file (#55).
(NCCC). The NCCC is responsible for VA's compliance with the clozapine
Resolution:
-----------
The PSOCLUTL routine was modified to only allow patients who have a
registration number to be updated in the PHARMACY PATIENT file (#55).
5. Temporary Clozapine Authorization Number not in correct format
Defect 1132422
Problem:
--------
|
