$TXT Created by at MNTVBB.DOMAIN.EXT (KIDS) on Friday, 01/10/25 at 17:07 ============================================================================= Run Date: AUG 12, 2025 Designation: RMPR*3*218 Package : RMPR - PROSTHETICS Priority: Mandatory Version : 3 SEQ #190 Status: Released Compliance Date: SEP 12, 2025 ============================================================================= Associated patches: (v)RMPR*3*125 <<= must be installed BEFORE `RMPR*3*218' (v)RMPR*3*173 <<= must be installed BEFORE `RMPR*3*218' (v)RMPR*3*216 <<= must be installed BEFORE `RMPR*3*218' Subject: DATA DICTIONARY, OPTION, ROUTINE, AND DOCUMENTATION UPDATES Category: - Data Dictionary - Routine - Other Description: ============ This patch addresses the following issues: 1. The data dictionary description in PROSTHETICS 1358 (#664) file should be modified to reflect current functionality. 2. Three fields - SUSPENSE PURGE (#19), CLOSE-OUT PURCHASING PURGE (#20), and CANCELLATION PURCHASING PURGE (#21) - in the PROSTHETICS SITE PARAMETERS (#669.9) file should be deprecated since the fields are obsolete after the release of RMPR*3.0*216. 3. Routine RMPRESI should be modified to not prompt the user for the deprecated fields when option Enter/Edit Station Site Parameters [RMPR SITE PARA] is invoked. 4. Entries in the deprecated fields should be deleted so that option Site Parameter Inquiry [RMPR SITE INQ] will no longer display the fields. 5. For routine RMPRCDP, a comment line should be corrected. 6. For option Purge Aged Purchasing Transactions [RMPR PURGE AGED], the LOCK field should be populated, and the description updated. 7. The Prosthetics Technical Guide should be updated and renamed "Prosthetics Version 3 Technical Manual/Security Guide". 8. The Prosthetics Security Guide should be archived on the VA software Document Library (VDL). EHRM Impact Statement: ---------------------- This patch can be installed at all sites, including EHRM converted sites. Patch Components: ----------------- Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ---------------------- -------------------- PROSTHETICS 1358 (#664) None - description only Modified PROSTHETICS SITE *SUSPENSE PURGE (#19) Modified PARAMETERS (#669.9) *CLOSE-OUT PURCHASING Modified PURGE (#20) *CANCELLATION PURCHASING Modified PURGE (#21) Forms Associated: Form Name File Number New/Modified/Deleted --------- ----------- -------------------- N/A Mail Groups Associated: Mail Group Name New/Modified/Deleted --------------- -------------------- N/A Option Name Type New/Modified/Deleted ----------------------------------- ----------- -------------------- RMPR PURGE AGED run routine Modified 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: ----------------------- N/A New Service Requests (NSRs): --------------------------- N/A Patient Safety Issues (PSIs): ---------------------------- N/A Defect Tracking System Ticket(s) & Overview: =========================================== 1. INC35782060: Data Dictionary and Routine Updates Issues: ------ (1) The data dictionary description of the PROSTHETICS 1358 (#664) file should be modified to reflect current functionality. (2) Three fields - SUSPENSE PURGE (#19), CLOSE-OUT PURCHASING PURGE (#20), and CANCELLATION PURCHASING PURGE (#21) - in the PROSTHETICS SITE PARAMETERS (#669.9) file should be deprecated since the fields are obsolete after the release of RMPR*3.0*216. (3) Routine RMPRESI should be modified to not prompt the user for the deprecated fields when option Enter/Edit Station Site Parameters [RMPR SITE PARA] is invoked. (4) Entries in the deprecated fields should be deleted so that option Site Parameter Inquiry [RMPR SITE INQ] will no longer display the fields. (5) For routine RMPRCDP, a comment line should be corrected. Resolutions: ----------- (1) The data dictionary description in PROSTHETICS 1358 (#664) file has been modified to reflect current functionality. The description has changed from: -------------------------------- This is a bridge file used to temporarily store purchasing information that links with the 1358 Daily Record File (424) prior to close out. Upon close out, transactions may be purged by using the Purge menu option. Normally, purging this file may be done for transactions over 180 days old. The purge retaining time is set in the site parameter file. To: -- This is a bridge file used to temporarily store purchasing information that links with the 1358 DAILY RECORD (#424) file prior to close out. Purging for this file occurs annually AFTER the Integrated Funds Control, Accounting, and Procurement (IFCAP) purge process occurs, using the same fiscal year. The Purge Aged Purchasing Transactions [RMPR PURGE AGED] option is used for the annual purge. (2) Three fields - SUSPENSE PURGE (#19), CLOSE-OUT PURCHASING PURGE (#20), and CANCELLATION PURCHASING PURGE (#21) - in the PROSTHETICS SITE PARAMETERS (#669.9) file have been deprecated. Data Dictionary before: ---------------------- 669.9,19 SUSPENSE PURGE 0;8 NUMBER (Required) NUMBER OF DAYS TO RETAIN CLOSED SUSPENSE INPUT TRANSFORM: K:+X'=X!(X>4000)!(X<90)!(X?.E1"."1.N) X LAST EDITED: FEB 18, 2021 HELP-PROMPT: Type a number between 90 and 4000, 0 Decimal digits. DESCRIPTION: This is the number of days for the Suspense records to remain in the file once they have been completed. 669.9,20 CLOSE-OUT PURCHASING PURGE 0;9 NUMBER (Required) NUMBER OF DAYS TO RETAIN CLOSED PURCHASING TRANSACTIONS INPUT TRANSFORM: K:+X'=X!(X>730)!(X<120)!(X?.E1"."1N.N) X LAST EDITED: SEP 11, 1995 HELP-PROMPT: Type a Number between 120 and 730, 0 Decimal Digits DESCRIPTION: This is the number of days to keep old transactions in the file. It is recommended that this be set to 120 days. 669.9,21 CANCELLATION PURCHASING PURGE 0;10 NUMBER (Required) NUMBER OF DAYS TO RETAIN CANCELLED TRANSACTIONS INPUT TRANSFORM: K:+X'=X!(X>730)!(X<120)!(X?.E1"."1N.N) X LAST EDITED: SEP 11, 1995 HELP-PROMPT: Type a Number between 120 and 730, 0 Decimal Digits DESCRIPTION: This is the number of days to keep Transactions that have been cancelled. It is recommended that this be set to 120 days. Data Dictionary after: --------------------- 669.9,19 *SUSPENSE PURGE 0;8 NUMBER NUMBER OF DAYS TO RETAIN CLOSED SUSPENSE INPUT TRANSFORM: K:+X'=X!(X>4000)!(X<90)!(X?.E1"."1.N) X LAST EDITED: NOV 06, 2024 HELP-PROMPT: This field has been deprecated and should No longer be used. DESCRIPTION: This field has been deprecated with RMPR*3.0*218 and should no longer be used. TECHNICAL DESCR: This field has been deprecated with RMPR*3.0*218 and should no longer be used. 669.9,20 *CLOSE-OUT PURCHASING PURGE 0;9 NUMBER NUMBER OF DAYS TO RETAIN CLOSED PURCHASING TRANSACTIONS INPUT TRANSFORM: K:+X'=X!(X>730)!(X<120)!(X?.E1"."1N.N) X LAST EDITED: NOV 06, 2024 HELP-PROMPT: This field has been deprecated and should No longer be used. DESCRIPTION: This field has been deprecated with RMPR*3.0*218 and should no longer be used. TECHNICAL DESCR: This field has been deprecated with RMPR*3.0*218 and should no longer be used. 669.9,21 *CANCELLATION PURCHASING PURGE 0;10 NUMBER NUMBER OF DAYS TO RETAIN CANCELLED TRANSACTIONS INPUT TRANSFORM: K:+X'=X!(X>730)!(X<120)!(X?.E1"."1N.N) X LAST EDITED: NOV 06, 2024 HELP-PROMPT: This field has been deprecated and should No longer be used. DESCRIPTION: This field has been deprecated by RMPR*3.0*218 and should no longer be used. TECHNICAL DESCR: This field has been deprecated by RMPR*3.0*218 and should no longer be used. (3) Routine RMPRESI has been modified to not prompt the user for the deprecated fields when option Enter/Edit Station Site Parameters [RMPR SITE PARA] is invoked. (4) Post-install routine RMPR218P deletes entries in the deprecated fields so that option Site Parameter Inquiry [RMPR SITE INQ] will no longer display the fields. A MailMan message is sent to holders of the RMPRMANAGER security key as well as the installer with information pertaining to the deletions. Example: Subj: RMPR*3.0*218 Post-Install [#561026] 01/10/25@15:49 14 lines From: RMPR*3.0*218 Post-Install In 'IN' basket. Page 1 ------------------------------------------------------------------- RMPR*3.0*218 post-install routine has completed. Entries in the following fields have been deleted: *SUSPENSE PURGE (#19) *CLOSE-OUT PURCHASING PURGE (#20) *CANCELLATION PURCHASING PURGE (#21) for sites in the PROSTHETIC SITE PARAMETERS (#669.9) file. The deleted field values are listed below. Site Field #19 Field #20 Field #21 ----------------------------- ----------- ----------- --------- CHEYENNE VA MEDICAL CENTER (4 730 120 120 Enter message action (in IN basket): Ignore// (5) In routine RMPRCDP, a comment line has been corrected to state that the purge of the PROSTHETICS 1358 (#664) file is performed after eight years instead of six years. Before: ------ ; than 6 years ago to be entered and should be run AFTER After: ----- ; than 8 years ago to be entered and should be run AFTER 2. INC35933610: Option RMPR PURGE AGED Security Key and Documentation Updates Issues: ------ (1) For option Purge Aged Purchasing Transactions [RMPR PURGE AGED], the LOCK field should be populated, and the description updated. (This option was moved to be under the Utilities [RMPR UTILITIES] menu from the Purge Obsolete Data [RMPR PURGE MENU] after the install of RMPR*3.0*216.) (2) The Prosthetics Technical guide should be updated and renamed "Prosthetics Version 3 Technical Manual/Security Guide". (3) The Prosthetics Security Guide should be archived on the VA Document Library (VDL). Resolutions: ----------- (1) For option Purge Aged Purchasing Transactions [RMPR PURGE AGED], the LOCK field has been populated and the description updated. VA FileMan Inquiry before install: --------------------------------- NAME: RMPR PURGE AGED MENU TEXT: Purge Aged Purchasing Transactions TYPE: run routine PACKAGE: PROSTHETICS DESCRIPTION: Purge file 664, PROSTHETICS ORDERS, of aged transactions based on same order purged from File 442. ROUTINE: EN20^RMPRCDP UPPERCASE MENU TEXT: PURGE AGED PURCHASING TRANSACT VA FileMan Inquiry after install: -------------------------------- NAME: RMPR PURGE AGED MENU TEXT: Purge Aged Purchasing Transactions TYPE: run routine LOCK: RMPRMANAGER PACKAGE: PROSTHETICS DESCRIPTION: This option is used to purge prosthetics orders in the PROSTHETICS 1358 (#664) file of aged transactions based on the same orders having been purged from the PROCUREMENT & ACCOUNTING TRANSACTIONS (#442) file. ROUTINE: EN20^RMPRCDP UPPERCASE MENU TEXT: PURGE AGED PURCHASING TRANSACT (2) The Prosthetics Technical guide has been updated to include the RMPR*3.0*218 changes and renamed "Prosthetics Version 3 Technical Manual/Security Guide". (3) The Prosthetics Security Guide has been archived on the VA Document Library (VDL). Test Sites: ----------- Ralph H. Johnson VA Medical Center (Charleston, SC) Fargo VA Health Care System (Fargo, ND) Chalmers P. Wylie Ambulatory Care Center (Columbus, OH) SNOW Change Order Number: ------------------------- CHA: CHG0614958 FAR: CHG0607792 COS: CHG0626729 Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is being released in a PackMan message. 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 --------------------------------------------------------------------- Prosthetics Version 3 Technical RMPR_3.0_P218_TM.DOCX Manual/Security Guide RMPR_3.0_P218_TM.PDF Prosthetics Version 3 User Manual RMPR_3.0_P218_UM.DOCX RMPR_3.0_P218_UM.PDF Patch Installation: ------------------- 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 five minutes to install. It is not necessary to disable any options. 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. 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. (ex. RMPR*3.0*218). 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 RMPR*3.0*218. iii. When prompted for the following, enter "B" for Build. Select one of the following: B Build (including Routines) R Routines Only Backup Type: B// iv. When prompted "Do you wish to secure your build? NO//", press and take the default response of "NO". v. When prompted with, "Send mail to: Last name, First Name", press to take default recipient. Add any additional recipients. vi. When prompted with "Select basket to send to: IN//", press and take the default IN mailbox or select a different mailbox. 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. Installation Verification: -------------------------- 1. Data Dictionary updates: In the VA FileMan menu (see example below), invoke option List File Attributes for the PROSTHETICS 1358 (#664) file and for the *SUSPENSE PURGE (#19), *CLOSE-OUT PURCHASING PURGE (#20), and *CANCELLATION PURCHASING PURGE (#21) fields in the PROSTHETICS SITE PARAMETERS (#669.9) file. Compare the output to the Resolution section of the RMPR*3.0*218 patch description. VA FileMan Version 22.2 Enter or Edit File Entries Print File Entries Search File Entries Modify File Attributes Inquire to File Entries Utility Functions ... Data Dictionary Utilities ... Transfer Entries Other Options ... Select VA FileMan Option: Data Dictionary Utilities List File Attributes Map Pointer Relations Check/Fix DD Structure Find Pointers into a File Update the META Data Dictionary Select Data Dictionary Utilities Option: List File Attributes 2. Option Purge Aged Purchasing Transactions [RMPR PURGE AGED] updates In the VA FileMan Inquiry option, verify that the LOCK field is populated with the RMPRMANAGER security key and that the description text has been updated as shown in the Resolution section of the RMPR*3.0*218 patch description. 3. PROSTHETICS SITE PARAMETERS (#669.9) file: Invoke FileMan option PRINT FILE ENTRIES to verify that the entries in the fields *SUSPENSE PURGE (#19), *CLOSE-OUT PURCHASING PURGE (#20), and *CANCELLATION PURCHASING PURGE (#21) have been deprecated. Example: VA FileMan 22.2 Select OPTION: 2 PRINT FILE ENTRIES Output from what File: PROSTHETICS SITE PARAMETERS// (1 entry) Sort by: SITE NAME// Start with SITE NAME: FIRST// First Print FIELD: .01 SITE NAME Then Print FIELD: 19 *SUSPENSE PURGE Then Print FIELD: 20 *CLOSE-OUT PURCHASING PURGE Then Print FIELD: 21 *CANCELLATION PURCHASING PURGE Then Print FIELD: Heading (S/C): PROSTHETICS SITE PARAMETERS List Replace DEVICE: ;;999 HOME (CRT) Right Margin: 80// PROSTHETICS SITE PARAMETERS List JAN 15, 2025@16:48 PAGE 1 *CLOSE-OUT *CANCELLATION *SUSPENSE PURCHASING PURCHASING PURGE PURGE PURGE --------------------------------------------------------------------- SITE NAME: CHEYENNE VA MEDICAL CENTER (44 4. Routines RMPRCDP and RMPRESI: Successful installation can be verified by reviewing the first two lines of the routines contained in the patch. The second line will contain the patch number (218) in the [PATCH LIST] section. The option Calculate and Show Checksum Values [XTSUMBLD-CHECK] can be run to compare the routine checksum to what is documented in the patch description. Back-Out/RollBack Strategy: =========================== 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. Prior to installing an updated KIDS package, the site/region should have saved a backup of the build 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 routines 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 routine onto the VistA System. If the patch was backed up for the build, from the Kernel Installation and Distribution System Menu, select the Installation Menu. Then select the Install Package(s) option and choose the patch (RMPR*3.0*218b) to install. The back-out plan is to: 1. Restore the routines, data dictionary, and option from the backup created. 2. At the programmer's prompt, invoke command BACKOUT^RMPR218P to restore the entries in the PROSTHETICS SITE PARAMETERS (#669.9) file which were deleted during install. A MailMan message will be sent to holders of the RMPRMANAGER security key as well as the installer with information pertaining to the fields which were repopulated. Example: Subj: RMPR*3.0*218 Patch Back out [#561027] 01/10/25@16:31 14 lines From: RMPR*3.0*218 Patch Backout In 'IN' basket. Page 1 -------------------------------------------------------------------------- RMPR*3.0*218 backout has completed. Entries in the following fields have been re-populated: SUSPENSE PURGE (#19) CLOSE-OUT PURCHASING PURGE (#20) CANCELLATION PURCHASING PURGE (#21) for sites in the PROSTHETIC SITE PARAMETERS (#669.9) file. The re-populated values are listed below. Site Field #19 Field #20 Field #21 ----------------------------- ----------- ------------ --------- CHEYENNE VA MEDICAL CENTER (4 730 120 120 Enter message action (in IN basket): Ignore// Validation of Back-out Procedure: --------------------------------- The Back-out Procedure can be verified by confirming the checksums have been returned to the pre-patch value using CHECK1^XTSUMBLD. It can also be verified by printing the first two lines of the routine(s) contained in this patch using the option First Line Routine Print [XU FIRST LINE PRINT]. After the routine(s) contained in this patch have been backed out, the second line of each routine will no longer contain the designation of patch [218]. VA FileMan inquiry and Data Dictionary list options may be used to verify that the data dictionary and option have been restored to the pre-install state. VA FileMan option PRINT FILE ENTRIES can be invoked to determine that the fields in the PROSTHETICS SITE PARAMETERS (#669.9) file have been repopulated. The backout will not remove the RMPRMANAGER security lock from the Purge Aged Purchasing Transactions [RMPR PURGE AGED] option. It is highly recommended that the lock remains. However, the VA FileMan Enter or Edit can be used to delete the LOCK field entry. Routine Information: ==================== The second line of each of these routines now looks like: ;;3.0;PROSTHETICS;**[Patch List]**;Feb 09, 1996;Build 12 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: RMPR218P Before: n/a After: B38220581 **218** Routine Name: RMPRCDP Before: B34194835 After: B34194835 **3,173,218** Routine Name: RMPRESI Before: B8263444 After: B7699058 **51,55,62,90,125,218** Routine list of preceding patches: 125, 173 ============================================================================= User Information: Entered By : Date Entered : OCT 18, 2024 Completed By: Date Completed: AUG 12, 2025 Released By : Date Released : AUG 12, 2025 ============================================================================= Packman Mail Message: ===================== $END TXT