$TXT Created by CAREY,BILL at SERVER  (KIDS) on Wednesday, 03/22/17 at 12:52
=============================================================================
Run Date: APR 13, 2017                     Designation: PSS*1*203
Package : PSS - PHARMACY DATA MANAGEMENT      Priority: Mandatory
Version : 1                                     Status: Under Development
=============================================================================


Subject: EPIP PSS REMEDIATION 1.0

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

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

 PSS*1.0*203 provides the following enhancements to VistA:
  
      *  Enables auditing of drug file changes. This enhancement generates 
         a message to a new MailMan Group called PSS DEE AUDIT when a user 
         or automated process makes changes to the DRUG file (#50). The
         message shows the date/time of the change, the name of the user
         who made the change, and before/after descriptions of the changed
         field(s). After installation, a Pharmacy Clinical Application
         Coordinator (CAC) or Pharmacy Automated Data Processing
         Application Coordinator (ADPAC) must modify the PSS DEE AUDIT  
         mail group to include the necessary recipients. This modification
         allows Pharmacy CAC'S and ADPACs to maintain consistency and
         control when multiple users create and edit DRUG file entries
         across integrated facilities. Not all fields in the DRUG file are
         subject to audit. The following list of auditable fields is stored
         internally in the PSSDEEA routine:
  
         GENERIC NAME (#.01)
         VA CLASSIFICATION (#2)
         DEA, SPECIAL HDLG (#3)
         MAXIMUM DOSE PER DAY (#4)
         STANDARD SIG (#5)
         FSN (#6)
         WARNING LABEL (#8)
         MESSAGE (#101)
         PHARMACY ORDERABLE ITEM  (#2.1)
         RESTRICTION (#102)
         APPLICATION PACKAGES' USE (#63)
         NDC (#31)
         CMOP DISPENSE (#213)
         ATC MNEMONIC (#212.2)
         REORDER LEVEL (#11)
         ORDER UNIT (#12)
         PRICE PER ORDER UNIT (#13)
         PRICE PER DISPENSE UNIT (#16)
         SOURCE OF SUPPLY (#17)
         DISPENSE UNIT (#14.5)
         CURRENT INVENTORY (#50)
         DAW CODE (#81)
         NCPDP DISPENSE UNIT (#82)
         NCPDP QUANTITY MULTIPLIER (#83)
         INACTIVE DATE (#100)
         NATIONAL DRUG FILE ENTRY (#20)
         VA PRODUCT NAME (#21)
         PSNDF VA PRODUCT NAME ENTRY (#22)
         PACKAGE SIZE (#23)
         PACKAGE TYPE (#24)
         NATIONAL DRUG CLASS (#25)
         CMOP ID (#27)
         NATIONAL FORMULARY INDICATOR (#29)
  
         If a user makes changes to a non-auditable field, or views any
         field but does not make changes, then the mail message Subject is
         DRUG ENTER/EDIT ACCESS, and the message body indicates "No Audited
         Changes Made."
  
      *  Tracks information on the date/time of the most recent drug price
         change in the DRUG (#50) file. When a user or an automated 
         process adds or changes the PRICE/DISPENSE UNIT (#15) field, or
         when the PRICE/DISPENSE UNIT field is automatically updated by a
         change to the PRICE PER ORDER UNIT (#13) field, the system will
         store the following in the new HISTORY PRICE DISPENSE (#950)
         multiple in the DRUG (#50) file: the date and time of the update;
         the user who updated the field ; and the new value in the
         PRICE/DISPENSE UNIT field. This HISTORY PRICE DISPENSE multiple is
         searchable via FileMan, and is viewable using either FileMan or
         the Lookup into Dispense Drug File [PSS LOOK] option in VistA. The
         new PSS DRUG AUDIT RETENTION MOS parameter is used to limit the
         historical data held in the HISTORY PRICE DISPENSE multiple.  This
         parameter can be set to a positive whole number of retention
         months. The time period for retaining historical data is based on
         the last date of a price change, minus the parameter number
         (retention months) times 30 days. Only those entries that fall
         within this time period will be stored in the file multiple.
  
         If the parameter is not set to a whole number of retention months,
         then all entries in the HISTORY PRICE DISPENSE  multiple will be
         retained. This modification enables pharmacies to better manage
         drug prices by verifying that the price shown is up to date, and
         by providing a price update history.
  
 Patch Components: 
 -----------------
  
 Files & Fields Associated:
  
 File Name (Number)         Field Name (Number)      New/Modified/Deleted
 ------------------         -------------------      --------------------
 DRUG (#50)                 HISTORY PRICE DISPENSE    NEW
                             (#950)
  
  
 Forms Associated:
  
 Form Name                  File #                   New/Modified/Deleted
 ---------                  ------                   --------------------
 N/A
  
  
 Mail Groups Associated:
  
 Mail Group Name            New/Modified/Deleted
 ---------------            --------------------
 PSS DEE AUDIT              NEW
  
  
 Options Associated:
  
 Option Name                Type                     New/Modified/Deleted
 -----------                ----                     -------------------- 
 N/A
  
  
 Protocols Associated:
  
 Protocol Name              New/Modified/Deleted
 -------------              -------------------- 
 N/A
  
 Parameters Associated:
  
 Parameter Name                                       New/Modified/Deleted
 --------------                                       --------------------
 PSS DRUG AUDIT RETENTION MOS                         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):
 ----------------------------  
 NSR20150115 Audits for DRUG file 50 Changes
 NSR20080714 Drug File Price Change Date/Time Stamp
  
 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:                 FTP.SERVER       
 Hines:                  FTP.SERVER         
 Salt Lake City:         FTP.SERVER      
  
 Documentation can also be found in the VA Software Documentation Library 
 (VDL) at:
 http://URL            /.
  
  
 Title                                       File Name             FTP Mode
 --------------------------------------------------------------------------
 Pharmacy Data Management:  Manager's   pss_1_um_r0417.pdf        Binary
 User Manual
 Pharmacy Data Management:  Manager's   pss_1_um_r0417.doc        Binary
 User Manual
 Pharmacy Data Management: Technical    pss_1_tm_r0417.pdf        Binary
 Manual/Security Guide
 Pharmacy Data Management: Technical    pss_1_tm_r0417.doc        Binary
 Manual/Security Guide
  
 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.
  
 For both single and multi-divisional (integrated) sites, the installer
 must identify a specific user as the Mail Group Coordinator. This
 individual will coordinate the recipients of the MailMan messages. This is
 usually a Pharmacy CAC/ADPAC. Once identified, the Mail Group Coordinator
 will be able to add new users to the Mail Group PSS DEE AUDIT to allow
 those users to receive Drug File Audit MAILMAN messages.
  
  
 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 Menu, select 
         the Installation Menu.  From this menu, you may elect to use the 
         following options. When prompted for the INSTALL NAME enter
         PSS*1.0*203.
  
         a. Verify Checksums in Transport Global - This option will allow
         you to ensure the integrity of the routines that are in the
         transport global.
  
         b. Print Transport Global - This option will allow you to view the
         components of the KIDS build.
  
         c. 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,
         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:
 -------------------------------
  
 The Mail Group Coordinator user identified during installation will need
 to add new users to the PSS DEE AUDIT mail group in order for them to
 receive MAILMAN messages regarding edits to the DRUG (#50) file.  They
 should use the EDIT MAIL GROUP (XMEDITMG) option to do this.  New users
 may be entered as 'I' (Informational) or 'CC' (Carbon-copy) users, as
 appropriate.
  
 The installer should notify the Mail Group Coordinator that this task must
 be performed.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;1.0;PHARMACY DATA MANAGEMENT;**[Patch List]**;9/30/97;Build 11

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

Routine Name: PSSDEE
    Before:B142583898   After:B144630517  **3,5,15,16,20,22,28,32,34,33,
                                           38,57,47,68,61,82,90,110,155,
                                           156,180,193,200,207,203**
Routine Name: PSSDEEA
    Before:       n/a   After: B33844941  **203**
Routine Name: PSSLOOK
    Before: B94208630   After:B101221589  **3,7,15,16,20,24,29,38,68,61,
                                           87,90,127,147,170,189,192,200,
                                           203**
Routine Name: PSSP203
    Before:       n/a   After:  B5653270  **203**
Routine Name: PSSPRICE
    Before:       n/a   After:  B5093136  **203**
 
Routine list of preceding patches: 207

=============================================================================
User Information:
Entered By  : WERTH,WARREN                  Date Entered  : OCT 17, 2016
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================


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

$END TXT
