$TXT Created by at MDEVA.FO-BIRM.DOMAIN.EXT (KIDS) on Monday, 01/25/21 at 13:45 ============================================================================= Run Date: MAR 09, 2021 Designation: PREA*1*3 Package : PREA - ADVANCED MEDICATION PLATFORM Priority: Mandatory Version : 1 SEQ #2 Status: Released Compliance Date: APR 09, 2021 ============================================================================= Associated patches: (v)PREA*1*2 <<= must be installed BEFORE `PREA*1*3' Subject: IDENTIFYING AMPL USERS Category: - Routine - Other Description: ============ This patch exports a new option that will identify the users who will receive access to the Advanced Medication Platform (AMPL) GUI application when it is initially installed at each site at a later date. Other than verifying successful patch PREA*1*3 installation, no further action is required at this time. The AMPL application will be a phased rollout. The AMPL Implementation Manager will be in contact with each site at the appropriate time prior to the site's AMPL implementation, and will coordinate with the appropriate site personnel the running of the option exported with this patch. The option will work as follows: The stand-alone option, PREA AMPL GUI ACCESS, when invoked creates the list of users that will receive AMPL access based on VistA Security Key ownership and Person Class affiliation. When the option is run in the test account, the list will only be sent to the person who ran the option, in a VistA Mail Message. The message might also be sent to that person in outlook, depending on the mail configuration at each site. When the option is run in production the user will be given the choice to only send the list to the person who ran the option, or additionally send it to the VA IT EPMO EPMD PRE Pharm GUI SSOi Outlook Mail Group that will handle the granting of AMPL access to everyone on the list. When the option is run and the list goes to the mail group, the option will be inactivated. The list will not be submitted immediately to get the access granted, so until that time, the site contact can request changes to the user list by messaging the VA IT EPMO EPMD PRE Pharm GUI SSOi Outlook Mail Group. The site will be notified when the list is submitted. After submission, access can still be granted to users or removed from users on an individual basis by following the steps provided by Appendix A of the PREA Technical Manual. The option uses the following hierarchy to determine the granting of AMPL access: 1) A user is not granted AMPL access if the user has a past date or the current date in the TERMINATION DATE Field (#9.2) of the NEW PERSON File (#200). 2) A user is not granted AMPL access if the DISUSER Field (#7) of the NEW PERSON File (#200) is set to '1' (YES) for that user. 3) A user is granted AMPL access if they are assigned any of the following VistA Security Keys: PSORPH PSO TECH ADV PSD TECH PSD TECH ADV PSDRPH PSDMGR PSJ PHARM TECH PSJ RPHARM PSJI MGR PSJI PHARM TECH PSJU MGR PSJU RPH 4) A user is granted AMPL access if that user has an active entry in the PERSON CLASS Subfile (#200.05) of the NEW PERSON File (#200), and that Person Class entry in the PERSON CLASS File (#8932.1) has the text "PHARM" contained in the PROVIDER TYPE Field (.01) or the CLASSIFICATION Field (#1). The text "PHARM" can be in uppercase, lowercase, or any combination. Note: Routine PREAPO2 is included in this patch only to correct some minor issues to non-executable code to adhere to the M Programming Standards and Conventions. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- PREA AMPL GUI ACCESS Run New Protocols Associated: Protocol Name New/Modified/Deleted ------------- -------------------- N/A Security Keys Associated: Security Key Name ----------------- N/A Templates Associated: Template Name Type File Name (Number) New/Modified/Deleted ------------- ---- ------------------ -------------------- N/A Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- N/A Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: ----------- Eastern Colorado HCS West Palm Beach, FL Software and Documentation Retrieval Instructions: -------------------------------------------------- The AMPL technical manual is being updated in this release. Documentation describing the new functionality is included in this release. Documentation can be found on the VA Software Documentation Library at: https://www.domain.ext/vdl/. Documentation can also be obtained at https://download.vista.domain.ext/index.html/SOFTWARE. Documentation Title File Name FTP Mode --------------------------------------------------------------------- Advanced Medication Platform PREA_1_TM_R0321 Binary VistA Technical Manual Host File Name FTP Mode --------------------------------------------------------------------- N/A Patch Installation: ------------------- Pre/Post Installation Overview: There are no pre-installation or post-installation activities with this patch. Pre-Installation Instructions: This patch can be installed at any time, users do not need to be off the system. Installation of this patch should take less than 1 minute. 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. When prompted for the INSTALL NAME, enter the patch number: PREA*1.0*3. 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 PREA*1.0*3. B. Select the Backup a Transport Global option to create a backup message of any routines exported with this patch. [REQUIRED] 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. D. Select the Install Package(s) option and choose the patch to install. i. When prompted Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//', answer NO. ii. When prompted 'Want KIDS to INHIBIT LOGINs during the install? NO//', answer NO. iii. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//, answer NO. Post-Installation Instructions: Validate that the checksums of routines PREAPO2 and PREAPO3 now match the 'after checksums' listed 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. The Back-out steps include the restore of the PREAPO2 routine, the deletion of the PREAPO3 routine, and the deletion of the PREA AMPL GUI ACCESS option. Please call the Help Desk before these steps are taken if a backout is necessary. Routine Information: ==================== The second line of each of these routines now looks like: ;;1.0;ADVANCED MEDICATION PLATFORM;**[Patch List]**;9/1/20;Build 19 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PREAPO2 Before: B24404078 After: B24404078 **2,3** Routine Name: PREAPO3 Before: n/a After: B67166833 **3** Routine list of preceding patches: 2 ============================================================================= User Information: Entered By : Date Entered : OCT 06, 2020 Completed By: Date Completed: MAR 09, 2021 Released By : Date Released : MAR 09, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT