============================================================================= Run Date: SEP 19, 2022 Designation: OR*3*569 Package : OR - ORDER ENTRY/RESULTS REPORTING Priority: Mandatory Version : 3 SEQ #498 Status: Released Compliance Date: OCT 20, 2022 ============================================================================= Associated patches: (c)LR*5.2*553 install with patch `OR*3*569' (v)OR*3*377 <<= must be installed BEFORE `OR*3*569' (v)OR*3*434 <<= must be installed BEFORE `OR*3*569' (v)OR*3*539 <<= must be installed BEFORE `OR*3*569' (v)LR*5.2*544 <<= must be installed BEFORE `OR*3*569' Subject: ANATOMIC PATHOLOGY ORDER DIALOG UPDATE Category: - Routine - Other - Enhancement (Mandatory) - Data Dictionary Description: ============ This patch is part of a multi-package build. The other patch is LR*5.2*553. These patches resolve some technical issues needed before anatomic pathology order dialogs can be enabled nationwide. Once these patches are released, sites are approved to enable Anatomic Pathology ordering in CPRS. When your site is ready to enable Anatomic Pathology ordering in CPRS, please follow the setup instructions in the 'CPRS OR*3.0*569/LR*5.2*553 AP Order Dialog Setup and Configuration Guide' that is being released with this patch. As part of this patch, the following modifications are being made: 1) This patch creates a new file, AP DIALOG CONFIG (#101.45), to configure anatomic pathology order dialogs. This file is almost identical to the LR AP DIALOG CONFIG File (#69.73). File #69.73 will not be used anymore and will be deleted in the bundled patch, LR*5.2*553. File #101.45 will resolve the following issues that existed in file #69.73: a. Logically, this file should have existed in the ORDER ENTRY/RESULTS REPORTING (OR) namespace. b. It was impossible for sites to change which entry in the ORDERABLE ITEMS File (#101.43) was associated with a specific test. c. It was impossible to add new entries to the file without a patch. d. It was difficult to create patches that sent changes to nationally distributed dialogs. e. The UROLOGY,PROSTATE entry was missing configuration information needed before Operative Findings and Post-Operative Findings entered in CPRS would save with the order. 2) A new option, Update AP Order Dialogs [ORCM UPDATE AP DIALOGS], is being added to the Order Menu Management [ORCM MGMT] menu. This option lets you copy, edit, or create new anatomic pathology order dialogs for use in CPRS. 3) Quick Orders can now be created for AP orders. At this time, this will only work for system quick orders, but a personal quick order can still not be created for AP. 4) There was a GUI bug preventing making the Surgeon/Provider order prompt required (in the CPRS AP Dialog). This bug is being fixed in CPRS v32b. This patch creates a background task, that will update the Surgeon/Provider order prompt to be required (for the 13 pre-configured national AP order dialogs) once CPRS v32b (OR*3.0*405) is installed at the site. 5) This patch updates which Laboratory Tests can be mapped to an AP Order Dialog. In order to be mapped to an AP Order Dialog, the test must: a) have a SUBSCRIPT of SP, CY, or EM b) be mapped to a NATIONAL VA LAB CODE c) be mapped to a CPRS SCREEN Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- AP DIALOG CONFIG (101.45) NAME (.01) New ALLOW OTHER New SPECIMENS (.02) RESTRICT MULTIPLE New SPECIMEN (.03) ORDERABLE ITEM (.04) New NATIONAL STANDARD (.05) New INACTIVE (.06) New PROMPT CHANGE New MESSAGE (4) ORDER PROMPTS ORDER PROMPT (.01) New Multiple (101.451) HIDE (.02) New REQUIRED (.03) New DEFAULT (.04) New PAGES Multiple (101.452) PAGE# (.01) New PAGE NAME (.02) New HIDE (.03) New REQUIRED (.04) New RESPONSE ID (.05) New WP TITLE (.06) New BUILDER BLOCK PG BLOCK TITLE (.01) New Multiple (101.4521) REQUIRED (.02) New LIST (.03) New DEFAULT (.04) New VALUES VALUE (.01) New Multiple (101.45211) ASSOCIATE WITH (.02) New SPECIAL (.03) New DATE RESTRICTION (.04) New SPECIMEN SPECIMEN (.01) New Multiple (101.453) HIDE FROM New DESCRIPTION (.02) DESCRIPTION New POSITION (.03) COLLECTION SAMPLE New HIDE (2.1) COLLECTION SAMPLE New DEFAULT (2.2) BUILDER BLOCK SP BLOCK TITLE (.01) New Multiple (101.4531) INACTIVATE (.02) New REQUIRED (.03) New DEFAULT (.04) New DESCRIPTION New POSITION (.05) VALUES VALUES (.01) New Multiple (101.45311) SPECIAL (.02) New 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 ----------- ---- -------------------- ORCM MGMT Menu Modified ORCM UPDATE AP DIALOGS Run Routine 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 ------------- ---- ------------------ -------------------- OR AP DIALOG ACTIVATE INPUT AP DIALOG CONFIG New ONLY (#101.45) OR AP DIALOG EDIT INPUT AP DIALOG CONFIG New TEMPLATE (#101.45) Remote Procedures Associated: Remote Procedure Name New/Modified/Deleted --------------------- -------------------- ORWDX APORDITM Modified ORWLRAP1 CONFIG Modified ORWLRAP1 SPEC Modified Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- N/A Additional Information: ----------------------- Blood Bank Team Coordination: N/A New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: Fresno VA Medical Center (Fresno, CA) Philadelphia, PA VAMC (Philadelphia, PA) Southern Arizona VA HCS (Tucson, AZ) Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released using a host file. The host file is available at the following location: download.vista.domain.ext/index.html/SOFTWARE/OR_3_0_569_LR_5_2_553.KID Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/. Documentation Title File Name --------------------------------------------------------------------- CPRS OR*3.0*569/LR*5.2*553 AP Order Dialog OR_3_0_569_SETUP.DOCX Setup and Configuration Guide OR_3_0_569_SETUP.PDF AP Order Dialog OR*3.0*569/LR*5.2*553 OR_3_0_569_RN.DOCX Release Notes OR_3_0_569_RN.PDF CPRS User Manual: GUI Version (OR*3.0*569) CPRSGUIUM.DOCX CPRSGUIUM.PDF CPRS Technical Manual - GUI Version CPRSGUITM.DOCX (OR*3.0*569) CPRSGUITM.PDF CPRS Technical Manual: List Manager Version CPRSLMTM.DOCX (OR*3.0*569) CPRSLMTM.PDF Patch Installation: ------------------- Pre/Post Installation Overview: ------------------------------- The patch post-install will copy the data from file #69.73 and move it to file #101.45. The data will be converted to the new file format. The post-install will also kick off a task, that will update the Surgeon/Provider order prompt to be required (for the 13 pre-configured national AP order dialogs) if CPRS v32b (OR*3.0*405) is installed at the site. If CPRS v32b is not yet installed, it will keep requeuing itself to try again at T+1@04:00. 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: -------------------------- 1. Use the Load a Distribution option contained on the Kernel Installation and Distribution System Menu to load the Host file. When prompted to Enter a Host File: enter /srv/vista/patches/SOFTWARE/OR_3_0_569_LR_5_2_553.KID 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 the patch name OR*3.0*569. NOTE: Using 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 OR*3.0*569 iii. When prompted for the following, enter R for Routines or B for Build. Select one of the following: B Build (including Routines) R Routines Enter response: Build (including Routines) iv. When prompted with, 'Enter a Host File', enter a host file to save the backup to. v. When prompted with, 'Header Comment', press to accept the default header comment. 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. Post-Installation Instructions: ------------------------------- When your site is ready to enable Anatomic Pathology ordering in CPRS, please follow the setup instructions in the 'CPRS OR*3.0*569/LR*5.2*553 AP Order Dialog Setup and Configuration Guide' that is being released with this patch. Back-Out/Roll Back Plan: ------------------------ Back-out will be done only with the concurrence and participation of the development team and appropriate VA site/region personnel. The decision to back-out or rollback software will be a joint decision between the development team, VA site/region personnel and other appropriate VA personnel. In order to back-out this patch, the site/region should have saved a backup in a host file using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The host file containing the back-up can be installed using the Installation Menu on the Kernel Installation and Distribution System Menu. After the backup is installed, the site can run D RESTORE^LR553A to restore the data in the LR AP DIALOG CONFIG file (#69.73). Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;ORDER ENTRY/RESULTS REPORTING;**[Patch List]**;Dec 17, 1997;Build 23 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: ORAPDLG Before: n/a After: B496068 **569** Routine Name: ORCMEDT0 Before: B21322904 After: B21334091 **46,60,190,215,243,296,389,539,569** Routine Name: ORCMEDT1 Before: B47348452 After: B51517720 **8,46,57,95,110,245,243,296, 341,377,569** Routine Name: ORWDXM4 Before: B43793101 After: B44496594 **10,85,215,296,280,394,350,434,569** Routine Name: ORWLRAP1 Before: B21846310 After:B154038036 **539,569** Routine Name: ORWLRAP2 Before: n/a After: B48529499 **569** Routine Name: ORY569 Before: n/a After: B26167396 **569** Routine list of preceding patches: 377, 434, 539 ============================================================================= User Information: Entered By : Date Entered : AUG 24, 2021 Completed By: Date Completed: SEP 14, 2022 Released By : Date Released : SEP 19, 2022 ============================================================================= Packman Mail Message: ===================== No routines included