Select PATCH: XU*8*689    DEA EPCS PSDRPH Key Allocation                UND BF

DEVICE: HOME// ;;999  SSH VIRTUAL TERMINAL

VistA Patch Display                                                   Page: 1
=============================================================================
Run Date: JAN 08, 2018                      Designation: XU*8*689  TEST v
Package : KERNEL                            Priority   : MANDATORY
Version : 8                                 Status     : UNDER DEVELOPMENT
=============================================================================

Subject:  DEA EPCS PSDRPH Key Allocation

Category:  ROUTINE

Description:
===========
 
The Kernel package is being updated to enhance the functionality related 
to Allocation and De-allocation of the Pharmacy Prescribing for CS 
[PSDRPH] security key. Options 'Allocation of Security Keys' [XUKEYALL], 
'De-ALLOCATION OF SECURITY KEYS' [XQKEYDEALL] have been modified to 
prevent the allocation or de-allocation of the PSDRPH key. This prevents 
allocation and de-allocation through the un-auditable path.
 
The option 'Allocate/De-allocate of PSDRPH Key' [XU EPCS PSDRPH KEY] 
option is being enhanced to honor delegation, so users who are delegated 
the key and do not hold the key can manage keys for other users through 
the auditable pathway.
 
Finally, the 'Allocate/De-allocate of PSDRPH Key' [XU EPCS PSDRPH KEY] is 
being orphaned from the 'ePCS DEA Utility Functions' [XU EPCS UTILITY 
FUNCTIONS] menu option so a user must have the XU EPCS PSDRPH KEY menu 
option as a secondary menu option in order to have access.
 
 
Patch Components:
-----------------
 
Files & Fields Associated:
--------------------------
N/A
 
Forms Associated:
-----------------
N/A
 
Mail Groups Associated:
-----------------------
N/A
 
Options Associated:
-------------------
 
Option Name                     Type               New/Modified/Deleted
-----------                     ----               -------------------- 
XU EPCS UTILITY FUNCTIONS       Menu                     Modified
XU EPCS EXP DATE               Action                  Attach to Menu
XU EPCS SET PARMS              Action                  Attach to Menu
XU EPCS PRIVS                  Action                  Attach to Menu
XU EPCS LOGICAL ACCESS         Action                  Attach to Menu
XU EPCS PSDRPH AUDIT           Action                  Attach to Menu
XU EPCS XDATE EXPIRES          Action                  Attach to Menu
XU EPCS EDIT DEA# AND XDATE    Action                  Attach to Menu
XU EPCS PRINT EDIT AUDIT       Action                  Attach to Menu
XU EPCS DISUSER EXP DATE       Action                  Attach to Menu
XU EPCS DISUSER PRIVS          Action                  Attach to Menu
XU EPCS DISUSER XDATE EXPIRES  Action                  Attach to Menu
 
Protocols Associated:
---------------------
N/A
 
Security Keys Associated:
------------------------
N/A
 
Templates Associated:
---------------------
N/A
 
Additional Information:
-----------------------
 
New Service Requests (NSRs):
----------------------------  
NSR #20130711
 
Item #1:
--------
As a user, I need option XU EPCS PSDRPH Key Allocate/De-Allocate of 
PSDRPH Key [XU EPCS PSDRPH KEY] to be orphaned from any Kernel menus that 
it exists on, so that it is always explicitly assigned to the users that 
will be using it.
 
Resolution:
-----------
The XU EPCS PSDRPH Key Allocate/De-Allocate option has been removed, and 
the XU EPCS UTILITY FUNCTIONS option is being re-delivered without this 
option in the 'item' multiple. This removes the option from being 
accessible through XU EPCS UTILITY FUNCTIONS.
 
Item #2:
--------
As a user, I need the Kernel key allocation of PSDRPH to only be permitted
through a pathway that is audited, so that it cannot be allocated in a
manner that is untrackable.
 
Resolution:
-----------
1.) Blocked the ability to assign the PSDRPH key in the current 
    Allocation/De-allocation options. Routine XQ6 was modified to prevent
    a user from assigning or removing the PSDRPH keys from these options.
 
2.) Enhanced routine XUEPCSRT to honor delegation when using the XU EPCS
    PSDRPH KEY option.
 
Patient Safety Issues (PSIs):
-----------------------------
N/A
 
Remedy Ticket(s) & Overview:
----------------------------
N/A
 
Test Sites:
----------
TBD
 
Documentation Retrieval Instructions:
------------------------------------- 
Updated documentation describing the new functionality introduced by this 
patch is available.
 
The preferred method is to retrieve files from download.DNS      URL. 
 
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 documentation directly using Secure File Transfer 
Protocol (SFTP) from the ANONYMOUS.SOFTWARE directory at the following OI
Field Offices:
 
Hines:                  DNS     .URL           
Salt Lake City:         DNS.URL       
 
Documentation can also be found on the VA Software Documentation Library 
at:
http://URL            /
 
Title                         File Name                       FTP Mode
-----------------------------------------------------------------------
<Documentation title>       
 
 
Patch Installation:
 
 
Pre/Post Installation Overview:
-------------------------------
N/A
 
 
Pre-Installation Instructions:
------------------------------
N/A
 
 
Installation Instructions:
--------------------------
Patch XU*8*689 will install updates to two routines (XQ6 and XUEPCSRT).
 
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 the patch 
    XU*8.0*689.
    a.  Backup a Transport Global - This option will create a backup
        message of any routines exported with this patch. It will not
        backup any other changes such as DDs or templates.
    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.
 
5.  When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
    Install? NO//', answer 'NO'.  
 
6.  When prompted 'Want KIDS to INHIBIT LOGONs during the install?
    NO//', answer 'NO'
 
7.  When prompted 'Want to DISABLE Scheduled Options, Menu Options, 
    and Protocols? NO//', answer 'NO'.
 
8.  If prompted 'Delay Install (Minutes):  (0 - 60): 0//' respond 0.
 
 
Post-Installation Instructions:
-------------------------------
N/A


Routine Information:
====================


The second line of each of these routines now looks like:
 ;;8.0;KERNEL;**[Patch List]**;Jul 10, 1995;Build 7

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

Routine Name: XQ6
    Before: B21547163   After: B23032498  **689**
Routine Name: XUEPCSRT
    Before: B22030133   After: B22089125  **580,689**


=============================================================================
User Information:  
  Entered By  :   FISHER,BRADLEY       Date Entered  :   NOV 15,2017
  Completed By:                        Date Completed:   
  Released By :                        Date Released :   
=============================================================================


