PSO*7.0*574 (11567)    BUILD (9.6)

Name Value
NAME PSO*7.0*574
DATE DISTRIBUTED 2020-03-23 00:00:00
PACKAGE FILE LINK OUTPATIENT PHARMACY
REQUIRED BUILD
  • PSO*7.0*457
    ACTION:   Don't install, leave global
TYPE SINGLE PACKAGE
ALPHA/BETA TESTING NO
DESCRIPTION OF ENHANCEMENTS
 
(NCCC).  The NCCC is responsible for VA's compliance with the clozapine 
--------
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 
Risk Evaluation and Mitigation Strategy (REMS), which is mandated by the 
the MailMan messages sent to the CLOZAPINE ROLL-UP Mail Group in Forum.
 
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 
Food and Drug Administration (FDA) for tracking clozapine patients. 
"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 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.
 
The multi-build contains the Mental Health patch YS*5.01*154 and the 
 
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 
Outpatient Pharmacy patch PSO*7.0*574.  The list of defects and their 
wanted it removed.
 
Resolution:
-----------
The routine PSOSIG was modified to display this message ONLY for 
non-clozapine prescriptions.
 
9. CPRS Complex Order Default Dose Incorrect
Defect 1180952
 
resolution is below.
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
 
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:
-----------
Defect Tracking System Ticket(s) & Overview:
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:
The MENTAL HEALTH NCC WARRANTY RELEASE 5.01 multi-build is a warranty 
 
--------
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.
Patch PSO*7.0*574 contains the following fixes:
 
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.
 
 
 
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:
1.      Incorrect computation of drug costs
--------
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.
 
 Defect 1132310
15. Error on Clozapine Inpatient Medication
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:
 INC7277287 - East Bay Division - Martinez Outpatient Clinic
-----------
Routine PSOCLO1 was modified to set PSODFN if it's undefined, based on 
the value in DFN.
 
   *   *   *   *   *   *
 
Test Sites:
----------
 - West Los Angeles VAMC (691)
 - N. Florida /S. Georgia VAMC (573)
 INC7340377 - VA Connecticut Healthcare System West Haven Campus
 - 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:
Problem:
 
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_T06.KID
release for the National Clozapine Registry (NCR) software. This release 
Users would see incorrect values for the costs of prescriptions.
 
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.
Resolution:
 
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
The PSODRG routine has been updated to fix the problem with incorrect 
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
computation for prescription costs.
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.
The PSODRG routine was incorrectly referencing this field for the drug 
cost:
  50,15        DISPENSE UNITS PER ORDER UNIT 660;5 NUMBER
will fix the defects and incidents reported by the sites to the 
It has been changed to this field:
  50,16        PRICE PER DISPENSE UNIT 660;6 NUMBER
 
2. During backdoor pharmacy process of Outpatient 4 Day Override order, a 
field called LIMITED DURATION appears.
Defect 981761
 
Problem:
--------
When entering a clozapine prescription for an Outpatient 4 Day Override 
developers of the National Clozapine Coordination (NCC) Project. The 
order, a field called LIMITED DURATION is presented.  The IOC sites 
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.
 
project is also referred to as the Clozapine Modernization (ClozMod) 
3. 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 code uses a Mail Group and an ^XTMP storage 
location that are in the Pharmacy namespace.
 
Project.
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 
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).
The NCR is maintained by the National Clozapine Coordinating Center 
 
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:
TRACK PACKAGE NATIONALLY YES
BUILD COMPONENTS
  • ENTRIES:
    • PSOCLO1
      ACTION:   SEND TO SITE
      CHECKSUM:   B207810764
    • PSOBKDED
      ACTION:   SEND TO SITE
      CHECKSUM:   B101355784
    • PSOSIG
      ACTION:   SEND TO SITE
      CHECKSUM:   B104287072
    • PSODIR1
      ACTION:   SEND TO SITE
      CHECKSUM:   B110146447
    • PSOORED6
      ACTION:   SEND TO SITE
      CHECKSUM:   B64222067
    • PSONEW1
      ACTION:   SEND TO SITE
      CHECKSUM:   B22417680
    • PSOEXDT
      ACTION:   SEND TO SITE
      CHECKSUM:   B6664815
    • PSOORED2
      ACTION:   SEND TO SITE
      CHECKSUM:   B80807728
    • PSOOREDT
      ACTION:   SEND TO SITE
      CHECKSUM:   B93222791
    • PSODRG
      ACTION:   SEND TO SITE
      CHECKSUM:   B100773722
    • PSOORED5
      ACTION:   SEND TO SITE
      CHECKSUM:   B115791466
    • PSOCLUTL
      ACTION:   SEND TO SITE
      CHECKSUM:   B110091416
    • PSODIR2
      ACTION:   SEND TO SITE
      CHECKSUM:   B31690418
    • PSOORED4
      ACTION:   SEND TO SITE
      CHECKSUM:   B59779291
    • PSOORED3
      ACTION:   SEND TO SITE
      CHECKSUM:   B68311355
    • PSOCLOU
      ACTION:   SEND TO SITE
      CHECKSUM:   B79141906
PRE-INSTALL ROUTINE START^PSO574P