$TXT Created by BOSTWICK,LEONARD L at DNS                  (KIDS) on Friday, 08/04/17 at 12:32 =============================================================================
Run Date: AUG 24, 2017                     Designation: PSGW*2.3*19
Package : PSGW - AUTO REPLENISHMENT/WARD STOC Priority: Mandatory
Version : 2.3                                   Status: Under Development
=============================================================================

Associated patches: (v)PSGW*2.3*11 <<= must be installed BEFORE `PSGW*2.3*19'
                    (v)PSGW*2.3*18 <<= must be installed BEFORE `PSGW*2.3*19'

Subject: EPIP PSGW REMEDIATION 1.0

Category: 
  - Routine
  - Data Dictionary
  - Enhancement (Mandatory)

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

  
 PSGW*2.3*19 provides the following enhancements to VistA: 
  
 - Displays the maximum allowed ward stock level when using the Enter/Edit  Nurses' On-Demand Request [PSGW ON-DEMAND NURSING EDIT] option in the  Auto Replenishment/Ward Stock Nurses' Menu [PSGW RN]. Since the Pharmacy  will fill an order for no more than the allowed stock level, nurses need  to know the amount of stock that they can receive at one time. Currently,  the allowed stock level displays only when a request is placed for more  than double the allowed amount. This modification always displays the  allowed stock level, thus preventing delays and frustration when trying  to reorder stock.
  
 This modification also displays the maximum allowed ward stock level when  using the On-Demand Request Report by Date/AOU [PSGW ON-DEMAND PRINT]  option. This option is used by Pharmacy staff to review nurses' ward  stock requests. The allowed stock level is not currently displayed on the  report, so Pharmacy staff must look up this information to determine  whether a request exceeds the allowed amount. This modification always  displays the allowed stock level on the report, which allows Pharmacy  staff to easily compare the allowed and requested amounts. 
  
 This patch adds a system-level parameter WS_LVL_ON in the PARAMETER  DEFINITION (#8989.51) file to turn the display functionality On/Off. 
 Initially, this parameter is delivered as null and is treated the same  as No, which is OFF. A Clinical Application Coordinator (CAC) or Automated  Data Processing Application Coordinator (ADPAC) at each site will need to  set this parameter to ON (Yes) to activate this functionality at the site.
  
 - Adds the ability to automatically print ward stock medications on a  designated printer within a pharmacy. Currently, pharmacy technicians do  not have a quick way to determine which ward stock medications need to be  delivered to the various wards and clinics. This enhancement provides a  new DEFAULT PHARMACY PRINTER (#32) field in the PATIENT SITE file (#59.4)  that allows the pharmacy manager to select a default printer. To use the  new functionality, a CAC or ADPAC must populate this field to display a  printer from the DEVICE (#3.5) file. If the field is not populated with a  printer, then the auto-print functionality is effectively turned off. For  sites with multiple location entries in the PATIENT SITE file, managers  can select a default printer for each location.
  
 Patch Components: 
 ----------------- 
  
 Files & Fields Associated: 
  
 File Name (Number)    Field Name (Number)        New/Modified/Deleted 
 ------------------    -------------------        -------------------- 
 PATIENT SITE (#59.4)  DEFAULT PHARMACY PRINTER   New 
                       (#32)
  
 Forms Associated: 
  
 Form Name File # New/Modified/Deleted
 --------- ------ --------------------
 N/A 
  
 Mail Groups Associated: 
  
 Mail Group Name  New/Modified/Deleted
 ---------------  --------------------
 N/A 
  
 Options Associated: 
  
 Option Name                      Type        New/Modified/Deleted 
 ----------------------           ----        --------------------- 
 PSGW ON-DEMAND NURSING EDIT      Routine     Modified 
 PSGW ON-DEMAND PRINT             Routine     Modified 
  
 Protocols Associated: 
  
 Protocol Name New/Modified/Deleted
 ------------- --------------------
 N/A 
  
 Parameters Associated: 
  
 Parameter Name          New/Modified/Deleted 
 ---------------         -------------------- 
 WS_LVL_ON               New 
  
 Security Keys Associated: 
  
 Security Key Name
 -----------------
 N/A 
  
 Templates Associated: 
  
 Template Name Type File Name (Number) New/Modified/Deleted
 ------------- ---- ------------------ --------------------  N/A 
  
 Additional Information: 
                       
 N/A 
  
 New Service Requests (NSRs): 
 ----------------------------
 NSR20170308 Add Stock Level to On-Demand Reports
 NSR20170314 Auto Print Ward Stock Requests on Designated Pharmacy Printer 
  
 Patient Safety Issues (PSIs): 
 -----------------------------
 N/A 
  
 Defect Tracking System Ticket(s) & Overview: 
 --------------------------------------------
 N/A 
  
 Problem: 
 -------
 N/A 
  
 Resolution: 
 ----------
 N/A 
  
 Test Sites: 
 ----------
 TBD 
  
 Software and Documentation Retrieval Instructions: 
 ----------------------------------------------------
 Software being released as a host file and/or documentation describing  the new functionality introduced by this patch are available. 
  
 The preferred method is to retrieve files from download.DNS      .DNS   . 
 This transmits the files from the first available server. Sites may  also elect to retrieve files directly from a specific server. 
  
 Sites may retrieve the software and/or documentation directly using  Secure File Transfer Protocol (SFTP) from the ANONYMOUS.SOFTWARE  directory at the following OI Field Offices:
  
 Albany:                 DNS      .URL        
 Hines:                  DNS     .URL        
 Salt Lake City:               .URL        
  
 Documentation can also be found in the VA Software Document Library (VDL)
 at: http://URL            /. 
                                
 Title                                 File Name                  FTP Mode
 -------------------------------------------------------------------------
 Inpatient Pharmacy Automatic          wsuser_r0817.doc           Binary
 Replenishment/Ward Stock Module
 User Manual     
  
 Inpatient Pharmacy Automatic          wsuser_r0817.pdf           Binary
 Replenishment/Ward Stock Module
 User Manual
  
  
 Patch Installation: 
  
 Pre/Post Installation Overview: 
 -------------------------------
 Review the Pre-Installation Instructions provided before beginning  installation of the patch. 
  
 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. 
  
 Installation Instructions: 
 ------------------------------
 To install the patch: 
  
 1. Choose the PackMan message containing this patch. 
  
 2. Choose the INSTALL/CHECK MESSAGE PackMan option. 
  
 3. From the Kernel Installation and Distribution System (KIDS) menu,  select the Installation Menu. From this menu, you may elect to use the  following options. When prompted for the INSTALL NAME, enter the patch  number PSGW*2.3*19. 
  
 a. Verify Checksums in Transport Global - This option will help ensure  the integrity of the routines that are in the transport global. 
  
  
 b. Print Transport Global - This option will enable viewing the  components of the KIDS build.
  
 c. Compare Transport Global to Current System - This option will enable  viewing all changes that will be made when this patch is installed. It  compares all components of this patch (routines, data dictionaries,  templates, etc.). 
  
 d. Back up a Transport Global - This option will create a backup message  of any routines exported with this patch. It will not back up any other  changes such as data dictionaries or templates.
  
 4. From the Installation Menu, select the Install Package(s) option and  choose the patch to install. 
  
 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of  Install? NO//', press <Enter>. 
  
 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//',  press <Enter>. 
  
 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and  Protocols? NO//', press <Enter>. 
  
 8. If prompted 'Delay install (Minutes): (0-60): 0//', press <Enter>. 
  
 9. If prompted 'Enter the Device you want to print the Install messages. 
 You can queue the install by enter a 'Q' at the device prompt. Enter a  '^' to abort the install. DEVICE: HOME// HOME (CRT)', press <Enter>. 
  
 Post-Installation Instructions: 
 -------------------------------
 NSR20170308 switch activation:
 A site CAC will have to set the WS_LVL_ON parameter to a value of "Yes" 
 using the XPAR MENU TOOLS option for this functionality to be accessed.
  
 NSR20170314:
 N/A
  
 Backout Procedure: 
 ------------------
 Backout of this patch will be performed only with the concurrence and  participation of the appropriate VA site/region personnel. The decision  to back out the patch will be a joint decision between VA site/region  personnel and other appropriate VA personnel. 
  
 Prior to installing the 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. 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 two lines of  the PSGW routines contained in this patch using the option First Line  Routine Print [XU FIRST LINE PRINT]. Once the PSGW routines have been  backed out, the first two lines of the routines will no longer contain  the designation of patch PSGW*2.3*19 on line 2 in the patch list section.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;2.3;Automatic Replenishment/Ward Stock;**[Patch List]**;4 JAN 94;Build 19

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

Routine Name: PSGWODP
    Before: B13201999   After: B15776680  **18,19**
Routine Name: PSGWODPR
    Before:  B8623684   After:  B9116786  **15,18,19**
Routine Name: PSGWODRN
    Before: B21066215   After: B25466962  **11,19**
 
Routine list of preceding patches: 11, 18

=============================================================================
User Information:
Entered By  : BOSTWICK,LEONARD L            Date Entered  : APR 24, 2017
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================
