$TXT Created by COC-CCAD-DEV.AAC.DOMAIN.EXT (KIDS) on Monday, 11/05/18 at 18:01 ============================================================================= Run Date: FEB 15, 2019 Designation: GMRC*3*113 Package : GMRC - CONSULT/REQUEST TRACKING Priority: Mandatory Version : 3 SEQ #99 Status: Released Compliance Date: MAR 18, 2019 ============================================================================= Subject: CANCELLED TO DISCONTINUED CONSULTS Category: - Data Dictionary - Routine - Enhancement (Mandatory) - Other Description: ============ This patch contains a new routine that does the following: 1. An overnight TaskMan job called GMRC CHANGE STATUS X TO DC will run for a period of time specified by a new parameter called CSLT CANCELLED TO DISCONTINUED. Following the installation of this patch, that period of time will be 31 days prior to today, and going back in time to 365 days prior to today. **NOTE: The GMRC CHANGE STATUS X TO DC option should never be run from any menu. If that were attempted, the user will receive a message "This option is only for use by TaskMan as an overnight job"** 2. The overnight job will find consults that were cancelled in the period defined in 1. above, and will discontinue those consults. 3. A new option called GMRC CX TO DC PARAMETER EDIT will be installed by the patch. This option will allow users at VA sites to change the timescale referred to in 1. above. 4. The patch will install an option in file #19.2 (OPTION SCHEDULING) called GMRC CHANGE STATUS X TO DC. It will initially be set to run at 11:00 PM every night. 5. A temporary file in the XTMP namespace will be created during the overnight job. This file will contain details of every consult that was discontinued. The file will be set to be purged after 60 days. Patch Components ================ Files & Fields Associated: New/Modified/ File Name (Number) Field Name(Number) Deleted ------------------- ------------------ ------------- REQUEST/CONSULTATION (#123) REQUEST PROCESSING ACTIVITY (#40),sub-fields .01 (DATE/TIME OF ACTION) and #1 (ACTIVITY) Modified,new index "ASTATUS" Forms Associated: New/Modified/ Form Name File Number Deleted --------- ----------- ------------- N/A Mail Groups Associated: New/Modified/ Mail Group Name Deleted --------------- ------------- N/A Options Associated: New/Modified/ Option Name Type Deleted ----------- ---- ------------- GMRC CHANGE STATUS X TO DC Run Routine New GMRC CX TO DC PARAMETER EDIT Run Routine New Protocols Associated: New/Modified/ Protocol Name Deleted ------------- ------------- N/A Security Keys Associated: New/Modified/ Security Key Name Deleted ----------------- ------------- N/A Templates Associated: New/Modified/ Template Name Type File Name (Number) Deleted ------------- ---- ------------------ ------------- N/A Additional Information: ----------------------- N/A New Service Requests (NSRs): ---------------------------- N/A Patient Safety Issues (PSIs): ----------------------------- N/A Defect Tracking System Ticket(s) & Overview: -------------------------------------------- N/A Test Sites: ---------- Houston Salisbury 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.vista.domain.ext. 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: Hines: domain.ext Salt Lake City: domain.ext Documentation can also be found on the VA Software Documentation Library at: http://www.domain.ext/vdl/ Title File Name FTP Mode ----------------------------------------------------------------------- Consult/Request Technical Manual constm.pdf Binary Consult/Request Technical Manual constm.doc Binary Consult/Request Tracking User Manual consum.pdf Binary Consult/Request Tracking User Manual consum.docx Binary Patch Installation: ***************************************** DO NOT QUEUE the install of this patch. ***************************************** Pre/Post Installation Overview ------------------------------ Please see Pre-Installation Instructions and Post-Installation Instructions below. 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 creates a new index on file #123 (REQUEST/CONSULTATION) on the complete file. The index is called "ASTATUS". During a post-install process, it is necessary to add to the index all existing consult records in file #123. In a production environment this could go into the millions. The job of doing this is transferred into the background using TaskMan, and the TaskMan job number will be displayed in the install log. The job starts with the most recent consults and works its way backwards. In order not to consume system resources exhaustively, this background job will pause every 10,000 records, and will hang for 10 seconds. Please note that if any consults were to be created during the time that the background job is running, the index will be updated for those new consults since the data dictionary has already been changed at this point. PLEASE NOTE: Since the background job is processing the whole consult file, depending upon the number of consults at any site, it could take up to 8 hours to finish. Also, for system administrators, the background job can be stopped as follows: VISTAS2:VISTA>D ^XUP Setting up programmer environment This is a TEST account. Terminal Type set to: C-VT320 You have 19 new messages. Select OPTION NAME: TASKMAN USER XUTM USER TaskMan User TaskMan User Select TASK: 270120 Create entries in file #123 for new index ASTATUS Taskman User Option Display status. Stop task. Edit task. Print task. List own tasks. Select another task. Select Action (Task # 270120): ST Stop task. This task has already started running, but it has been asked to stop. If the job is stopped a MailMan message will be sent to the installer. At the end of the job, a MailMan message will be sent to the installer. In the event where the job is stopped, it can be run again by typing D QUEUE^GMRC113P at the programmer prompt. The job will then pick up where it left off. Installation Instructions ------------------------- 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 patch GMRC*3.0*113: 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 DD's 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, DD's, 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//Respond NO 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO// Respond NO 7. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// Respond NO 8. If prompted "Delay Install (Minutes): (0 - 60): 0// respond 0. Post-Installation Instructions ------------------------------ The patch includes a multi-valued parameter called CSLT CANCELLED TO DISCONTINUED. There are three fields in the parameter as follows: 1. Is the overnight cancelled to discontinued job active? Value is either "Y" or "N" and is defaulted to "N" in the patch. 2. How many days back to start with? Value is a number and can be 0 (zero) and is defaulted to 31 days in the post-install routine in this patch. 3. How many days back to end with? Value is a number and can be 0 (zero) and is defaulted to 365 days in the post-install routine in this patch. An overnight job called GMRC CHANGE STATUS X TO DC is scheduled by the post-install routine to use the index referred to in the Pre-Installation Instructions above, find consults that were cancelled in the date range indicated by values 2. and 3. above (by default 31 days back to 365 days back), and discontinue them. The overnight job is scheduled to run at 11 PM. This setting can be changed by appropriate persons by editing the GMRC CHANGE STATUS X TO DC schedule in file #19.2 (OPTION SCHEDULING). In order to change any values in the CSLT CANCELLED TO DISCONTINUED parameter, the patch installs a new option for this purpose. It is called GMRC CX TO DC PARAMETER EDIT. After installation, or when the overnight job is set to run, the "How many days back to start with" parameter should be set to 91. Back-Out Plan: -------------- Backout Routines: This patch contains two GMRC routines, one being the post-install. 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. Prior to installing an updated KIDS package, the site/region should have saved a backup of the routine in a mail message using the Backup a Transport Global [XPD BACKUP] menu option (this is done at time of install). The message containing the backed-up routine 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. Go to the Backup of Patch_GMRC*3.0*113 message in Mailman. At the Enter message action prompt, enter "X" to "Xtract PackMan" At the Select PackMan Function prompt enter the number 6 to Install/Check Message. At the end of this process the pre-patch routines are restored. Validation of Roll Back Procedure: ---------------------------------- The Roll Back Procedure can be verified by the fact that the two routines will have disappeared since they are both new. Back-out/Rollback Strategy: --------------------------- In the event of a catastrophic failure, the Facility CIO may make the decision to back-out the patch. It is imperative that you have performed a backup of the routines included in this patch prior to installation. The back-out plan is to restore the routines from the backup created. No data was modified by this patch installation and, therefore, no rollback strategy is required. To verify the back-out completed successfully, ensure the checksum matches the pre-patch checksum from the patch descriptions. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;CONSULT/REQUEST TRACKING;**[Patch List]**;DEC 27, 1997;Build 50 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: GMRC113P Before: n/a After: B19866183 **113** Routine Name: GMRCCXDC Before: n/a After: B45633898 **113** ============================================================================= User Information: Entered By : Date Entered : AUG 15, 2018 Completed By: Date Completed: FEB 14, 2019 Released By : Date Released : FEB 15, 2019 ============================================================================= Packman Mail Message: ===================== $END TXT