$TXT Created by                    MNTVBB.DOMAIN.EXT  (KIDS) on Wednesday, 12/01/21 at 13:19
=============================================================================
Run Date: JAN 10, 2022                     Designation: PSO*7*646
Package : PSO - OUTPATIENT PHARMACY           Priority: Mandatory
Version : 7       SEQ #539                      Status: Released
                  Compliance Date: FEB 10, 2022
=============================================================================

Associated patches: (v)PSO*7*617   <<= must be installed BEFORE `PSO*7*646'

Subject: ERX PRINT QUEUE ERROR

Category: 
  - Routine

Description:
============

 This patch will resolve the following issue:
   
 There is a recurring error when utilizing the option PSO ERX FINISH 
 (Complete Orders from eRx). This option is used to process prescriptions 
 that reside in the ERX HOLDING QUEUE file #52.49. The error occurs when
 the user selects the Print action, enters yes to have the print queued to
 run in the background and the prescription has an assigned message type of
 CA, CN, RE or RR.
  
  
 Associated ticket(s):
 =====================
  
 INC18437851 - VistA eRx errors      
               
  
 Associated NSR(s):
 ==================
 N/A
  
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
 INC18437851 - VistA eRx errors
  
  
 Problem: 
 -------
 There is a recurring error when utilizing the option PSO ERX FINISH 
 (Complete Orders from eRx). This option is used to process prescriptions 
 that reside in the ERX HOLDING QUEUE file #52.49. The error occurs when
 the user selects the Print action, enters yes to have the print queued to
 run in the background and the prescription has an assigned message type of
 CA, CN, RE or RR.
  
 The error is displayed as follows:  <UNDEFINED>PRINTQ+229~PSOERX1C *VALMAR
  
 Note: It was discovered during testing of the fix for the error mentioned 
 above that a new error occurs. 
  
 The new error is as follows:  <UNDEFINED>RRRES+16^PSOERXU3 *IORVON
  
 The fix for this error will addressed with this patch as well.
  
  
 Resolution:
 -----------
 The process is erroring because the calling routine of the tasked print 
 job does not define all variables that need defined prior to the calling 
 of the tasked job. Therefore, to prevent the error these variables will 
 be defined prior to the calling of the tasked job.  
  
 Technical Resolution:
 ---------------------
 A modification was made to PRINT+8^PSOERX1C to assign a null value to 
 ZTSAVE("VALMAR") and ZTSAVE("VALMEVL") prior to the execution of D 
 ^%ZTLOAD.
  
 Additional modifications were made to the following to address the second
 error identified in testing:
  
 RRRES^PSOERXU3 -Added a third parameter to be used to indicate if reverse
                 video should be turned on.
  
 PSOERX1G -Added a 1 to the third parameter of the call of RRRES^PSOERXU3 
           to indicate the reverse video to be turned on.
  
  
 Patient Safety Issues (PSIs):
 -----------------------------
 N/A
         
  
 Test Sites:
 -----------
 Miami VAMC, Miami FL
 Upstate NY HCS, Syracuse NY
  
  
 Software and Documentation Retrieval Instructions:
 --------------------------------------------------
 The software for this patch is being released in a PackMan message.
  
  
 Patch Installation:
 -------------------
  
 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 2 
 minutes to install.
  
 For this install there are no options that are required to be disabled.
  
 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 PSO*7.0*646.
  
        NOTE: Using <spacebar><enter> 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 and specify 
        what to backup; the entire Build or just Routines.
        The backup message can be used to restore the routines
        and components of the build to the pre-patch condition.
  
  
          i.  At the Installation option menu, select Backup 
              a Transport Global
         
          ii. At the Select INSTALL NAME prompt, enter your 
              build PSO*7.0*646.
         
         iii. When prompted for the following, enter "R" for 
              Routines or "B" for Build.
  
                 Select one of the following:
  
                       B         Build
                       R         Routines
  
                 Enter response: Build
  
          iv.  When prompted "Do you wish to secure your build? 
               NO//", press <enter> and take the default response 
               of "NO".
  
          v.   When prompted with, "Send mail to: Last name, First 
               Name", press <enter> to take default recipient. Add 
               any additional recipients.
  
          vi.  When prompted with "Select basket to send to: IN//", 
               press <enter> and take the default IN mailbox or select 
               a different mailbox.
  
  
     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.  If prompted 'Want KIDS to Rebuild Menu Trees Upon 
               Completion of Install? NO//', answer NO.
     
          ii.  When prompted 'Want KIDS to INHIBIT LOGONs during the 
               install? NO//', answer NO.
           
         iii.  When prompted 'Want to DISABLE Scheduled Options, Menu 
               Options, and Protocols? NO//', answer NO.
            
            a. When prompted 'Enter options you wish to mark as 
               'Out Of Order':', press the Enter key.
  
            b. When prompted 'Enter protocols you wish to mark as 
               'Out Of Order':', press the Enter key.
  
            c. When prompted 'Delay Install (Minutes):  (0 - 60): 0//',
               answer 0.
  
  
  
 Back-out/Rollback Strategy:
 ===========================
 Post-Installation Instructions:
 -------------------------------
  
 Installation Verification:
 --------------------------
 Successful installation can be verified by reviewing the first 2 lines 
 of the routines contained in the patch. The second line will contain the 
 patch number (646) in the [PATCH LIST] section.
   
   ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997
    
 The option Calculate and Show Checksum Values [XTSUMBLD-CHECK] can be run 
 to compare the routine checksums to what is documented in the patch
 description.
  
 Back-out/Roll Back Plan:
 ------------------------
 Back-out will be done only with the concurrence and participation
 of development team and appropriate VA site/region personnel. The
 decision to back-out or rollback software will be a joint decision
 between development team, VA site/region personnel and other
 appropriate VA personnel.
  
 Prior to installing an updated KIDS package, the site/region should
 have saved a backup of the routines in a mail 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. 
 No data was modified by this patch installation and, therefore, no 
 rollback strategy is required.
  
 Validation of Back-out Procedure
 ---------------------------------
 The Back-out Procedure can be verified by printing the first 2
 lines of the PSO Routines contained in this patch using the option
 First Line Routine Print [XU FIRST LINE PRINT]. Once the routines
 contained in the PSO*7.0*646 patch have been rolled back, the first
 two lines of the Routines will no longer contain the designation
 of patch PSO*7.0*646 in the patch list section on line 2.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;7.0;OUTPATIENT PHARMACY;**[Patch List]**;DEC 1997;Build 5

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: PSOERX1C
    Before:B114573841   After:B114763111  **467,520,527,508,551,581,617,646**
Routine Name: PSOERX1G
    Before:B180972623   After:B181029040  **617,646**
Routine Name: PSOERXU3
    Before:B188287287   After:B189510920  **508,591,606,581,617,646**
 
Routine list of preceding patches: 617

=============================================================================
User Information:
Entered By  :                               Date Entered  : JUL 13, 2021
Completed By:                               Date Completed: JAN 10, 2022
Released By :                               Date Released : JAN 10, 2022
=============================================================================


Packman Mail Message:
=====================

$END TXT