$TXT Created by at PATTRW.DOMAIN.EXT (KIDS) on Monday, 12/21/20 at 10:28 ============================================================================= Run Date: APR 20, 2021 Designation: XT*7.3*143 Package : XT - TOOLKIT Priority: Mandatory Version : 7.3 SEQ #116 Status: Released Compliance Date: MAY 21, 2021 ============================================================================= Subject: VISTA PACKAGE SIZE REPORT TOOLS Category: - Enhancement (Mandatory) - Routine - Other Description: ============ This patch is the initial release of the VistA Package Size Reporting Tool (VPSRT). This tool reports size information about VistA packages. The information reported is designed to give VistA analysts details about the number of components that comprise individual VistA packages. The software released with this installation will report the following data for selected VistA packages: . Package Name . Prefix . Number of Routines . Total Size of Routines . Number of Files . Number of Fields . Number of Options . Number of Protocols . Number of RPCs . Number of Templates There are three basic processes needed to generate VistA Package Size statistics: 1) Extract FORUM package data from the PACKAGE (#9.4) file for all packages that meet the following criteria. a) Have a Current Status of "ASSIGNED", "PENDING", or "TEMPORARY". b) Extracted packages have been assigned one of the class "I" types from the following list of possible package class types: I CLASS 1/EPMO II CLASS 2/FIELD III CLASS 3/FIELD Ia CLASS 1/C3->C1 Ib CLASS 1/NON-VA Ic CLASS 1/INNOVATIONS That is, extracted packages will be classified as one of the following: "CLASS 1/EPMO","CLASS 1/C3->C1", "CLASS 1/NON-VA", or "CLASS 1/INNOVATIONS". The data in the following fields are extracted from the FORUM PACKAGE (#9.4) file: . NAME [.01] . PREFIX [1] . *LOWEST FILE NUMBER [10.6] . *HIGHEST FILE NUMBER [11] . ADDITIONAL PREFIXES multiple [#14] . ADDITIONAL PREFIXES [.01] . EXCLUDED NAME SPACE multiple [919] . EXCLUDED NAME SPACE [.01] . FILE NUMBER multiple [15001] . FILE NUMBER [.01] . LOW-HIGH RANGE multiple [15001.1] . LOW FILE NUMBER [.01] . HIGH FILE NUMBER [.02] . PARENT PACKAGE [15003] 2) Update VistA Package Size Package Parameters data file. The VistA Package Size report tool includes a suite of tools for managing the package parameters used to generate the package size report. These tools include parameter file comparisons, package component add, change, and delete, package add and delete, parameter file creation and deletion, and VistA MailMan functions. 3) Report VistA Package Size statistics using the VistA Package Size Parameters data file and the configuration of the VistA instance where the report is created. [The report should be created on a fully-patched "Gold" instance of VistA.] The statistics can be reported in various forms. The statistic report formats include: - Single VistA Package (human readable) - All packages sorted by Package Name (human readable) - All packages sorted on Number of Routines (human readable) - All packages sorted on Total Routine Size (human readable) - All packages sorted on Package Name with caret-delimited data (computer readable) - All packages sorted on Package name with caret-delimited data, parent package is included (computer readable) These reports can be E-mailed or written to a text file. Patch Components ---------------- Options Associated: Option Name Type New/Modified/Deleted ----------- ---- -------------------- XTVS PKG EXTRACT SERVER Server New XTVS PKG MGR EXT PACKAGE MSG Run Routine New XTVS VISTA PACKAGE EXTRACT MGR Run Routine New Protocols Associated: Protocol Name Type New/Modified/Deleted ------------- ---- -------------------- XTVS BLANK 1 action new XTVS PACKAGE MANAGER MENU menu new XTVS PKG EXT CRT PARAM ACTION action new XTVS PKG EXT DISP CORRECTIONS ACTION action new XTVS PKG EXT DISP DEL ACTION action new XTVS PKG EXT EMAIL ACTION action new XTVS PKG EXT PARAM WRT ACTION action new XTVS PKG EXT QUERY REMOTE ACTION action new XTVS PKG EXT REDISP PARAM ACTION action new XTVS PKG EXTRACT CREATE ACTION action new XTVS PKG EXTRACT DEL ACTION action new XTVS PKG MGR DEL PACKAGE PARM ACTION action new XTVS PKG MGR EDIT PACKAGE PARM ACTION action new XTVS PKG MGR EMAIL OVRLAP RPT ACTION action new XTVS PKG MGR EXT DISP ACTION action new XTVS PKG MGR EXT DISP MENU menu new XTVS PKG MGR EXT MNGR ACTION action new XTVS PKG MGR EXTRACT MENU menu new XTVS PKG MGR FILE OVERLAP ACTION action new XTVS PKG MGR NEW PARAM MAIL ACTION action new XTVS PKG MGR NEW PARAM MENU menu new XTVS PKG MGR PARAM CMPR MENU menu new XTVS PKG MGR PARAM COMPARE ACTION action new XTVS PKG MGR PARAM COMPR MAIL ACTION action new XTVS PKG MGR PARAM DATA MAP HELP ACTION action new XTVS PKG MGR PARAM DISP CAPTION ACTION action new XTVS PKG MGR PARAM DISP CAPTN MENU menu new XTVS PKG MGR PARAM DISP MENU menu new XTVS PKG MGR PARAM DISP/EDIT ACTION action new XTVS PKG MGR PARAM ERR DISP ACTION action new XTVS PKG MGR PARAM ERROR MENU menu new XTVS PKG MGR PARAM FILE DELETE ACTION action new XTVS PKG MGR PARAM OVRLP REDISP ACTION action new XTVS PKG MGR PARAM UNLOCK ACTION action new XTVS PKG MGR PREFIX OVERLAP ACTION action new XTVS PKG MGR RPT MAIL ACTION action new XTVS PKG MGR RPT MENU menu new XTVS PKG MGR RPT QUERY REMOTE ACTION action new XTVS PKG MGR RPT WRT ACTION action new XTVS PKG MGR SAVE PACKAGE PARM ACTION action new XTVS PKG MGR VISTA SIZE RPT action new XTVS PKG QUERY REMOTE VISTA SIZE ACTION action new XTVS PKG RPT SWAP HEADER ACTION action new XTVS SITE PARAMETERS action new Security Keys Associated: Security Key Name New/Modified/Deleted ----------------- -------------------- XTVS EDITOR new Templates Associated: List Template Name New/Modified/Deleted ------------------ -------------------- XTVS PACKAGE MANAGER new XTVS PKG EXT CRT PARAM new XTVS PKG MGR EXT DISP new XTVS PKG MGR EXTRACT MNGR new XTVS PKG MGR PARAM CAPTN DISP new XTVS PKG MGR PARAM COMPARE new XTVS PKG MGR PARAM DISPLAY new XTVS PKG MGR PARAM ERROR DISP new XTVS PKG MGR VISTA SIZE RPT new Parameter Definitions Associated: Parameter Name New/Modified/Deleted -------------- -------------------- XTVS PACKAGE MGR DEFAULT DIR new Parameter Template New/Modified/Deleted ------------------ -------------------- XTVS PKG MGT PARAMETERS new Files & Fields Associated: File Name (Number) Field Name (Number) New/Modified/Deleted ------------------ ------------------- -------------------- N/A Forms Associated: Form Name Type New/Modified/Deleted --------- ---- -------------------- N/A Remote Procedure Calls Associated: RPC Name Type New/Modified/Deleted -------- ---- -------------------- N/A Additional Information: ----------------------- Blood Bank Team Coordination: EFFECT ON BLOOD BANK FUNCTIONAL REQUIREMENTS: Patch XT*7.3*143 contains changes to a package referenced in ProPath standard titled: BBM Team Review of VistA Patches. This patch does not alter or modify any VistA Blood Bank software design safeguards or safety critical elements functions. RISK ANALYSIS: Changes made by patch XT*7.3*143 have no adverse effect on Blood Bank software functionality; therefore, RISK is none. New Service Requests (NSRs): N/A Patient Safety Issues (PSIs): N/A Defect Tracking System Ticket(s) & Overview: N/A Test Sites: ---------- Pittsburg, PA Fargo, ND Software and Documentation Retrieval Instructions: -------------------------------------------------- The software for this patch is included in this VistA Patch Module patch 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 --------------------------------------------------------------------- VistA Package Size Reporting Tools (VPSRT) xtvs_vpsrt_dibrg.docx Deployment, Installation, Back-Out, and Rollback Guide (DIBRG) VistA Package Size Reporting Tools (VPSRT) xtvs_vpsrt_ug.docx User Guide VistA Package Size Reporting Tools (VPSRT) xtvs_vpsrt_tm.docx Technical Manual NOTE: VistA documentation is made available online in Microsoft Word format (.DOC) and Adobe Acrobat Portable Document Format (.PDF). Patch Installation: ------------------ Pre/Post Installation Overview: This patch installs all new software routines and entries in Kernel files. Pre-Installation Instructions: TaskMan does not have to be stopped, HL7 filers do not need to be stopped, and users may be on the system. There are no menu options or protocols that need to be disabled. Installation Instructions: This patch may be installed with users on the system. This patch should take less than 1 minute to install. It may be queued for installation. 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, 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 or build name. (e.g. XT*7.3*143) 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 XT*7.3*143 iii. When prompted for the following, enter "R" for Routines or "B" for Build. Select one of the following: B Build R Routines Enter response: Build 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. 4. From the Installation Menu, select the Install Package(s) option and choose the patch to install. 5. If prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of Install? NO//' answer "NO". 6. When prompted 'Want KIDS to INHIBIT LOGONs during the install? NO//' answer "NO". 7. If prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO//' answer "NO". 8. If prompted 'Delay Install (Minutes): (0 - 60): 0//' answer "0" to "60" or "Q" (to queue the output to a printer). Post-Installation Instructions: The PACKAGE (#9.4) file data defined in FORUM on November 13, 2020 has been bundled into a Packman message during post-installation processing. The message was sent to the installer. The message has the following subject: FORUM PACKAGE FILE EXTRACT with XT*7.3*143 (FOR ; Nov 13, 2020 1:55:06 pm ; $JOB#: 30998) The Kernel Installation and Distribution System installation log for this patch will indicate the message number. This message provides the installer with the current PACKAGE (#9.4) file extract data as of November 13, 2020. The data in the Packman message may be loaded into an ^XTMP global that can be used to create the first package parameter file by the VistA Package Size Report application installed with this patch. FORWARD THIS MESSAGE TO THE USER RESPONSIBLE FOR CREATING THE VISTA PACKAGE SIZE REPORTS. Refer to the "Configuration Quick Steps" section of the VistA Package Size Report User Guide (xtvs_vpsrt_ug.pdf) documentation to complete setup. Back-Out Plan/Roll Back Plan: ----------------------------- Contact VistA Infrastructure support for assistance. Because all software and VistA Kernel structures installed with this patch are new, the entire patch can be removed without affecting any existing VistA applications. Specifically, Kernel Toolkit functionality existing prior to installing this patch will not be affected by its removal. The MailMan message created during installation step 3-b may be used to backout this patch. Share the MailMan message with VistA Infrastructure Support. Routine Information: ==================== The second line of each of these routines now looks like: ;;7.3;TOOLKIT;**[Patch List]**;Apr 25, 1995;Build 116 The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: XT73P143 Before: n/a After: B18348614 **143** Routine Name: XTVSCP Before: n/a After:B148567464 **143** Routine Name: XTVSHELP Before: n/a After:B111861870 **143** Routine Name: XTVSHLP1 Before: n/a After:B139194745 **143** Routine Name: XTVSHLP2 Before: n/a After: B57199534 **143** Routine Name: XTVSLAPI Before: n/a After:B204930334 **143** Routine Name: XTVSLDE Before: n/a After: B17994668 **143** Routine Name: XTVSLM Before: n/a After: B66620269 **143** Routine Name: XTVSLN Before: n/a After:B119259487 **143** Routine Name: XTVSLNA1 Before: n/a After:B109371272 **143** Routine Name: XTVSLP Before: n/a After:B114592226 **143** Routine Name: XTVSLPC Before: n/a After:B176819816 **143** Routine Name: XTVSLPD1 Before: n/a After: B38271126 **143** Routine Name: XTVSLPD2 Before: n/a After:B129369709 **143** Routine Name: XTVSLPDC Before: n/a After:B161756780 **143** Routine Name: XTVSLPER Before: n/a After: B30702179 **143** Routine Name: XTVSLPR1 Before: n/a After:B129624425 **143** Routine Name: XTVSLR Before: n/a After: B72196927 **143** Routine Name: XTVSRFL Before: n/a After:B196846039 **143** Routine Name: XTVSRFL1 Before: n/a After:B188249960 **143** Routine Name: XTVSSVR Before: n/a After:B171722135 **143** ============================================================================= User Information: Entered By : Date Entered : OCT 05, 2018 Completed By: Date Completed: APR 20, 2021 Released By : Date Released : APR 20, 2021 ============================================================================= Packman Mail Message: ===================== $END TXT