============================================================================= Run Date: JUL 26, 2001 Designation: PXRM*1.5*5 Package : PXRM - CLINICAL REMINDERS Priority: Mandatory Version : 1.5 SEQ #5 Status: Released ============================================================================= Associated patches: (v)PXRM*1.5*4 <<= must be installed BEFORE `PXRM*1.5*5' (v)DI*22*72 <<= must be installed BEFORE `PXRM*1.5*5' Subject: Exchange Utility Category: - Routine - Enhancement (Mandatory) - Data Dictionary - Input Template - Print Template - Other Description: ============ General Overview: ================= This patch updates the Clinical Reminder Exchange Utility so it is compatible with version 1.5 of the Clinical Reminders package. Please refer to the documentation for a description of how the new Exchange Utility works. File #811.8 was previously used to store reminder types. Clinical Reminders version 1.5 made reminder type obsolete so this file has been changed to the Exchange File, which is central to the exchange process. A. To provide sites more control over their reminders, some new functionality has been added. 1. The new fields, CLASS and SPONSOR, have been added to the following Clinical Reminder files: 801.41, 811.2, 811.4, 811.5, and 811.9. CLASS is a set of codes: N - National V - VISN L - Local SPONSOR is a pointer to file 811.6, REMINDER SPONSOR, which previously was known as the REMINDER TERM SPONSOR file (it has been renamed with this patch). Sponsor also has a Class. The Class of the Sponsor must match the Class of the entry that points to the Sponsor. Once a Sponsor is in use, it cannot be edited. 2. The new field USAGE has been added to file 811.9, REMINDER DEFINITION. Its purpose is to allow the reminder creator to specify how the reminder can be used. This is a free text field that contains any of the following characters: C - CPRS (the reminder can be used in the CPRS GUI) R - Reminder Reports (the reminder can be used in reminder reports) X - Reminder Extracts (the reminder is used for data extraction) * - The reminder can be used for any of the above The USAGE field is not yet used by Clinical Reminders v1.5; however, it is available for future functionality. B. In addition to the Exchange Utility, this patch contains fixes for some problems reported by NOIS and discovered during testing. 1. The cross-reference on the URL field of the WEB multiple of the REMINDER DEFINITION file, data element 811.9002,.01, was only 30 characters long even though the field has a maximum length of 128. Whenever two or more entries matched through the first 30 characters, selecting the correct entry was very difficult. The cross-reference has been changed to have the full 128 character length. Now the user will see the full URL. NOIS: PUG-0201-50190 2. A new field CHECKBOX SEQUENCE is added to dialog prompts. Currently, comment fields are created by adding the prompt PXRM COMMENT to the dialog element. Each checkbox for the comment field must then be created as an individual prompt and added to the dialog element. This process generates a large number of dialog components. For dialog exchange, it is desirable to minimize the number of dialog components being transferred, so a new simpler method has been created. The PXRM COMMENT prompt is copied to a new prompt (e.g. INJECTION SITE) and multiple checkboxes can be added to the prompt using the new field's CHECKBOX SEQUENCE. e.g. CHECKBOX SEQUENCE TEXT 1 Right Deltoid 2 Left Deltoid The new prompt (e.g. INJECTION SITE) is then added to the dialog element. PXRM COMMENT is not required on the element. This does not affect dialogs created by the previous method. 3. The option 'Do you want to edit now' after copying a reminder dialog is removed. Instead the list of dialogs for the reminder is displayed. 4. Dialogs beginning with VA- or having a national class can no longer be edited. 5. When the patient's age did not fall in any of the age ranges specified in the definition, the incorrect error message "There is no reminder frequency" was displayed in the Clinical Maintenance output. Also IGNORE ON N/A set to "A" would not suppress the Clinical Maintenance output. This is corrected. NOIS: HUN-0401-22538. 6. If a cancelled lab result came after a completed result, the cancelled result was being used, making the finding false. Now lab results will be scanned and the most recent result that is not cancelled or pending will be used. NOIS: WAS-0501-20895, WRJ-0601-10037. 7. A bug was discovered that could possibly cause some inpatient medications for drug findings to be missed. This was fixed. A new field RXTYPE has been added to the finding multiple of file 811.5, REMINDER TERM, and file 811.9, REMINDER DEFINITION. This field applies only to drug findings and allows you to choose whether the medication is inpatient, outpatient, or both. The default is both, which is consistent with the current behavior. NOIS: MRN-0701-40393 8. If there was a hard error during reminder evaluation, the patient cache may have been left locked. Code was added to PXRMERRH to make sure that the patient cache gets unlocked. NOIS Messages: ============== ASH-0501-30504 HUN-0301-21547 HUN-0401-22538 IOW-0700-42482 MAC-0601-60456 MRN-0701-40393 PUG-0101-50058 PUG-0201-50190 UNY-0601-12655 WAS-0501-20895 WRJ-0601-10037 Documentation: ============== Updated documentation describing the new functionality introduced by this patch is available. The preferred method is to FTP the files from download.vista.med.va.gov. This transmits the files from the first available FTP server. Sites may also elect to retrieve software directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov This documentation will be in the form of Adobe Acrobat files. The complete Clinical Reminders Manager Manual is PXRMTM.PDF The documentation can also be found on the System Design and Development Web page: (http://vista.med.va.gov/vdl/). Build Components: ================= Data Dictionaries: ================ 801.41 REMINDER DIALOG 811.2 REMINDER TAXONOMY 811.4 REMINDER COMPUTED FINDINGS 811.5 REMINDER TERM 811.6 REMINDER SPONSOR 811.8 REMINDER EXCHANGE FILE 811.9 REMINDER DEFINITION Input Templates: ================ PXRM EDIT ELEMENT FILE #801.41 PXRM EDIT FORCED VALUE FILE #801.41 PXRM EDIT GROUP FILE #801.41 PXRM EDIT NATIONAL TERM FILE #811.5 PXRM EDIT PROMPT FILE #801.41 PXRM EDIT REMINDER DIALOG FILE #801.41 PXRM EDIT REMINDER TERM FILE #811.5 PXRM RESULT ELEMENT FILE #801.41 PXRM RESULT GROUP FILE #801.41 PXRM SPONSOR EDIT FILE #811.6 List Templates: =============== PXRM EX DEFINITION INQUIRY PXRM EX DIALOG HELP PXRM EX HOST FILE* PXRM EX INSTALL SUMMARY* PXRM EX INSTALLATION DETAIL PXRM EX INSTALLATION HISTORY PXRM EX LIST COMPONENTS PXRM EX LIST DIALOG PXRM EX MAILMAN MESSAGE* PXRM EX MAIN HELP PXRM EX REMINDER EXCHANGE PXRM EX REMINDER LIST PXRM REMINDER EXCHANGE* *deleted by installation Options: ======== GMTS COORDINATOR ATTACH TO MENU IBDF PRINT BLNK ENCOUNTER FORM ATTACH TO MENU ORCM QUICK ORDERS ATTACH TO MENU PX PCE COORDINATOR MENU ATTACH TO MENU PXRM (IN)/ACTIVATE REMINDERS ATTACH TO MENU PXRM CATEGORY EDIT/INQUIRE ATTACH TO MENU PXRM CF MANAGEMENT SEND TO SITE PXRM COMPUTED FINDING EDIT ATTACH TO MENU PXRM COMPUTED FINDING LIST ATTACH TO MENU PXRM CPRS CONFIGURATION SEND TO SITE PXRM CPRS COVER SHEET LIST ATTACH TO MENU PXRM CPRS LOOKUP CATEGORIES ATTACH TO MENU PXRM DEFAULT LOCATION ATTACH TO MENU PXRM DEFINITION COPY ATTACH TO MENU PXRM DEFINITION EDIT ATTACH TO MENU PXRM DEFINITION INQUIRY ATTACH TO MENU PXRM DEFINITION LIST ATTACH TO MENU PXRM DIALOG MANAGEMENT SEND TO SITE PXRM DIALOG PARAMETERS ATTACH TO MENU PXRM DIALOG/COMPONENT EDIT ATTACH TO MENU PXRM EXTRACT EPI FINDING LIST ATTACH TO MENU PXRM EXTRACT EPI TOTALS ATTACH TO MENU PXRM GUI REMINDERS ACTIVE ATTACH TO MENU PXRM INFO ONLY SEND TO SITE PXRM MANAGERS MENU SEND TO SITE PXRM MENTAL HEALTH ACTIVE ATTACH TO MENU PXRM NEW REMINDER PARAMETERS ATTACH TO MENU PXRM OTHER SUPPORTING MENUS SEND TO SITE PXRM PROGRESS NOTE HEADERS ATTACH TO MENU PXRM REMINDER EXCHANGE SEND TO SITE PXRM REMINDER MANAGEMENT SEND TO SITE PXRM REMINDER REPORTS SEND TO SITE PXRM REMINDER TEST ATTACH TO MENU PXRM REMINDERS DUE ATTACH TO MENU PXRM SPONSOR EDIT SEND TO SITE PXRM SPONSOR LIST SEND TO SITE PXRM SPONSOR MANAGEMENT SEND TO SITE PXRM TAXONOMY COPY ATTACH TO MENU PXRM TAXONOMY EDIT ATTACH TO MENU PXRM TAXONOMY INQUIRY ATTACH TO MENU PXRM TAXONOMY LIST ATTACH TO MENU PXRM TAXONOMY MANAGEMENT SEND TO SITE PXRM TERM COPY ATTACH TO MENU PXRM TERM EDIT ATTACH TO MENU PXRM TERM INQUIRY ATTACH TO MENU PXRM TERM LIST ATTACH TO MENU PXRM TERM MANAGEMENT SEND TO SITE PXRM TEXT AT CURSOR ATTACH TO MENU PXTT TABLE MAINTENANCE ATTACH TO MENU Print Templates: ================ PXRM CF LIST HEADER* FILE #811.4 PXRM COMPUTED FINDING LIST FILE #811.4 PXRM DEFINITION INQUIRY FILE #811.9 PXRM DEFINITION LIST FILE #811.9 PXRM DIALOG ELEMENT FILE #801.41 PXRM DIALOG FORCED VALUE FILE #801.41 PXRM DIALOG GROUP FILE #801.41 PXRM DIALOG PROMPT FILE #801.41 PXRM REMINDER DIALOG FILE #801.41 PXRM RESULT ELEMENT FILE #801.41 PXRM RESULT GROUP FILE #801.41 PXRM SPONSOR LIST FILE #811.6 PXRM TAXONOMY INQUIRY FILE #811.2 PXRM TERM INQUIRY FILE #811.5 PXRM TERM LIST FILE #811.5 *deleted by installation Protocols: ========== PXRM EXCH CREATE FILE ENTRY PXRM EXCH CREATE HOST FILE PXRM EXCH CREATE MAILMAN PXRM EXCH DEFINITION INQUIRY PXRM EXCH DELETE FILE ENTRY PXRM EXCH DELETE INSTALLATION HISTORY PXRM EXCH DIALOG DETAILS PXRM EXCH DIALOG EXIT PXRM EXCH DIALOG FINDINGS PXRM EXCH DIALOG MENU PXRM EXCH DIALOG SUMMARY PXRM EXCH DIALOG TEXT PXRM EXCH DIALOG USAGE PXRM EXCH INSTALL ALL COMPONENTS PXRM EXCH INSTALL DIALOG (ALL) PXRM EXCH INSTALL DIALOG (SELECTED) PXRM EXCH INSTALL FILE ENTRY PXRM EXCH INSTALL MENU PXRM EXCH INSTALL SELECTED COMPONENTS PXRM EXCH INSTALLATION DETAILS PXRM EXCH INSTALLATION HISTORY PXRM EXCH INSTALLATION HISTORY MENU PXRM EXCH LOAD HOST FILE PXRM EXCH LOAD MAILMAN PXRM EXCH MENU PXRM EXCH QUIT PXRM EXCH SELECT COMPONENT PXRM EXCH SELECT DIALOG PXRM EXCH SELECT ENTRY PXRM EXCH SELECT HISTORY PXRM HANDLE HOST FILE* PXRM HANDLE MAIL MESSAGE* PXRM INSTALL REMINDER COMPONENTS* PXRM INSTALLATION SUMMARY* PXRM LIST COMPONENTS* PXRM LIST REMINDERS PXRM MAIL REMINDER* PXRM REMINDER INQUIRY* PXRM SAVE REMINDER* PXRM SELECT HOST FILE* PXRM SELECT MESSAGE* *deleted by installation Routines: ========= The following is a list of the routines included in this patch. The second line of each routine looks like: ;;1.5;CLINICAL REMINDERS;**[Patch List]**;Jun 19, 2000 Routine Old Checksum New Checksum Patch List ======= ============ ============ ========== PXRMAGE 3397400 3400712 2,5 PXRMCFED 798554 781590 2,5 PXRMCOPY 3158512 3418817 5 PXRMDBL3 5125654 5565622 5 PXRMDCPY 6126482 5306308 2,5 PXRMDEDT 10300729 10403581 2,5 PXRMDGEN 4225676 4372515 2,5 PXRMDLG1 9632990 9748078 2,5 PXRMDLGZ 5872662 6243195 2,5 PXRMDLL 10147371 10486681 2,5 PXRMDLLA 10050318 10879374 2,5 PXRMDRCL 4371963 4523415 2,5 PXRMDRUG 8714771 9010746 2,5 PXRMERRH 3648519 3680236 2,5 PXRMEX 734095 N/A PXRMEXCF 3082347 2423294 5 PXRMEXCS 477784 1110371 5 PXRMEXDG NEW 6113137 5 PXRMEXDH NEW 3043454 5 PXRMEXFI 4584420 2114330 5 PXRMEXHF 3042537 9281833 5 PXRMEXIC NEW 6101702 5 PXRMEXID NEW 8214330 5 PXRMEXIR 6378468 N/A PXRMEXIS 2111120 N/A PXRMEXIU 6354998 10404722 5 PXRMEXIX NEW 6069406 5 PXRMEXLB NEW 6790377 5 PXRMEXLC 4455681 7438819 5 PXRMEXLD NEW 11661938 5 PXRMEXLI NEW 4658726 5 PXRMEXLM NEW 6756966 5 PXRMEXLR NEW 6707086 5 PXRMEXMH 5211309 3846832 5 PXRMEXMM 1803589 5979094 5 PXRMEXMR 3095822 N/A PXRMEXPR 4745120 5100533 5 PXRMEXPU 3534845 8194202 5 PXRMEXSI NEW 2487247 5 PXRMEXSR 4956164 N/A PXRMEXU1 NEW 14020476 5 PXRMEXU2 NEW 11156923 5 PXRMEXU3 NEW 1168351 5 PXRMEXU4 NEW 6545286 5 PXRMINQ 2902345 2977680 2,5 PXRMINTR 4535329 5770734 5 PXRMLAB 4273456 4275561 2,5 PXRMLIST 1950511 1701188 5 PXRMLOG 7572721 7581013 2,5 PXRMP5I NEW 8696496 5 PXRMP5IA NEW 5952081 5 PXRMPTDF 5394581 5861277 2,5 PXRMPTTR 2725320 3166937 2,5 PXRMREDF 2417599 2498694 2,5 PXRMREDT 3012335 3034676 5 PXRMRPCA 9804337 10208079 2,5 PXRMRPCD 2591704 3000061 4,5 PXRMSPED NEW 1529994 5 PXRMTEDT 812846 1028007 2,5 PXRMTMED 486844 616118 5 PXRMUTIL 4126777 5197529 2,5 Host File: ========== Due to its size this patch will be available only as a host file. The name of the file is PXRM_1_5_5.KID. Sites will retrieve VistA software from the following FTP addresses. The preferred method is to FTP the files from download.vista.med.va.gov. This transmits the files from the first available FTP server. Sites may also elect to retrieve software directly from a specific server as follows: Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov Installation: ============= This patch can be loaded with users on the system. It is recommended that the installation be done during non-peak hours so as to have the least impact on users. Installation will take less than 5 minutes. 1. Review your mapped set. If any of the routines are mapped, they should be removed from the mapped set at this time. 2. Use the 'Load a Distribution' option on the KIDS 'INSTALLATION' menu. 3. On the KIDS 'INSTALLATION' menu, use the following options as desired: Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Backup a Transport Global 4. On the KIDS 'INSTALLATION' menu, use the following option to install the patch: Install Package(s) (PXRM*1.5*5) 5. When prompted *BUT YOU ALREADY HAVE 'REMINDER TERM SPONSOR' AS FILE #811.6! Shall I write over your REMINDER TERM SPONSOR File? YES// respond 'YES'. 6. When prompted *BUT YOU ALREADY HAVE 'PCE REMINDER TYPE FILE' AS FILE #811.8! Shall I write over your PCE REMINDER TYPE FILE File? YES// respond 'YES'. 7. When prompted for the menu rebuild, respond 'NO'. 8. When prompted "Want KIDS to INHIBIT LOGONs during the install? YES//", respond 'NO'. 9. When prompted "Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//," respond 'YES'. When prompted to select the options you would like to place out of order, enter the following: GMTS* PXRM* IBDF PRINT* IBDF PRINT FORM OR CPRS GUI CHART ORS HEALTH SUMMARY When prompted to select the protocols you would like to place out of order, enter the following: ORS AD HOC HEALTH SUMMARY ORS HEALTH SUMMARY PXRM PATIENT DATA CHANGE 10. When prompted for the menu rebuild, respond 'NO'. 11. If any routines were unmapped as part of step 1, they should be returned to the mapped set once the installation has run to completion. 12. The init routines PXRMP5I and PXRMP5IA may be deleted once the installation has successfully completed. Routine Information: ==================== Routine Name: - PXRMAGE Routine Checksum: Routine Name: - PXRMCFED Routine Checksum: Routine Name: - PXRMCOPY Routine Checksum: Routine Name: - PXRMDBL3 Routine Checksum: Routine Name: - PXRMDCPY Routine Checksum: Routine Name: - PXRMDEDT Routine Checksum: Routine Name: - PXRMDLGZ Routine Checksum: Routine Name: - PXRMDLLA Routine Checksum: Routine Name: - PXRMEXCF Routine Checksum: Routine Name: - PXRMEXCS Routine Checksum: Routine Name: - PXRMEXDF Routine Checksum: Routine Name: - PXRMEXDH Routine Checksum: Routine Name: - PXRMEXFI Routine Checksum: Routine Name: - PXRMEXHF Routine Checksum: Routine Name: - PXRMEXIC Routine Checksum: Routine Name: - PXRMEXID Routine Checksum: Routine Name: - PXRMEXIU Routine Checksum: Routine Name: - PXRMEXIX Routine Checksum: Routine Name: - PXRMEXLB Routine Checksum: Routine Name: - PXRMEXLC Routine Checksum: Routine Name: - PXRMEXLD Routine Checksum: Routine Name: - PXRMEXLI Routine Checksum: Routine Name: - PXRMEXLM Routine Checksum: Routine Name: - PXRMEXLR Routine Checksum: Routine Name: - PXRMEXMH Routine Checksum: Routine Name: - PXRMEXMM Routine Checksum: Routine Name: - PXRMEXPR Routine Checksum: Routine Name: - PXRMEXPU Routine Checksum: Routine Name: - PXRMEXSI Routine Checksum: Routine Name: - PXRMEXU1 Routine Checksum: Routine Name: - PXRMEXU2 Routine Checksum: Routine Name: - PXRMEXU3 Routine Checksum: Routine Name: - PXRMEXU4 Routine Checksum: Routine Name: - PXRMINTR Routine Checksum: Routine Name: - PXRMLIST Routine Checksum: Routine Name: - PXRMLOG Routine Checksum: Routine Name: - PXRMP5I Routine Checksum: Routine Name: - PXRMPTTR Routine Checksum: Routine Name: - PXRMREDT Routine Checksum: Routine Name: - PXRMTEDT Routine Checksum: Routine Name: - PXRMTMED Routine Checksum: Routine Name: - PXRMUTIL Routine Checksum: Routine Name: - PXRMLAB Routine Checksum: Routine Name: - PXRMDGEN Routine Checksum: Routine Name: - PXRMDRCL Routine Checksum: Routine Name: - PXRMDRUG Routine Checksum: Routine Name: - PXRMERRH Routine Checksum: Routine Name: - PXRMREDF Routine Checksum: Routine Name: - PXRMSPED Routine Checksum: Routine Name: - PXRMDLL Routine Checksum: Routine Name: - PXRMPTDF Routine Checksum: Routine Name: - PXRMRPCA Routine Checksum: Routine Name: - PXRMRPCD Routine Checksum: Routine Name: - PXRMDLG1 Routine Checksum: Routine Name: - PXRMINQ Routine Checksum: Routine Name: - PXRMEXDG Routine Checksum: Routine Name: - PXRMEXIR Routine Checksum: Routine Name: - PXRMEXIS Routine Checksum: Routine Name: - PXRMEXMR Routine Checksum: Routine Name: - PXRMEXSR Routine Checksum: Routine Name: - PXRMP5IA Routine Checksum: ============================================================================= User Information: Entered By : REDINGTON,PATRICK Date Entered : MAR 22, 2001 Completed By: MERRILL,DAVID P Date Completed: JUL 20, 2001 Released By : SCOTT,JEAN M Date Released : JUL 26, 2001 ============================================================================= Packman Mail Message: ===================== No routines included