$TXT Created by EASH,WILLIAM at DNS                  (KIDS) on Friday, 08/04/17 at 16:03
=============================================================================
Run Date: AUG 31, 2017                     Designation: FH*5.5*43
Package : FH - DIETETICS                      Priority: Mandatory
Version : 5.5                                   Status: Under Development
=============================================================================


Subject: EPIP FH REMEDIATION 1.0

Category: 
  - Routine
  - Enhancement (Mandatory)

Description:
============

 FH*5.5*43 implements VistA Dietetics Report Queuing to automatically 
 queue Nutrition and Food Service (NFS) reports and labels to run daily, 
 or as often as necessary, without requiring Dietetics staff to manually 
 queue them each day. With many standard reports and labels currently 
 available to NFS staff, it is inefficient and time consuming for users to 
 manually set up and run reports daily.
  
 This enhancement enables an a Clinical Application Coordinator (CAC), 
 Automated Data Processing Application Coordinator (ADPAC), or Office of 
 Information & Technology (OI&T) staff member to set pre-defined options 
 for printing NFS reports and labels automatically, including the routine 
 name and the setup of variables required for the reports to run 
 unattended. Three new files are added with this enhancement to store the 
 pre-defined values for each configured report.
  
 Additionally, three new options enable this functionality. The option 
 FHQUE passes the configured reports and labels to TaskMan to be executed 
 and printed at the scheduled time. Typically, FHQUE is scheduled to run 
 once per day, soon after midnight. The second new option, FHQUE OPTION 
 EDIT, displays a list of available reports. From this list, a report can 
 be selected and configured to run at a specified frequency and to send 
 the job to a specified printer. The third new option, FHQUE TEST, is only 
 accessible to users with programmer access and is used to immediately run 
 a test report to validate selected options.
  
 The three new files that store information required for printing NFS 
 reports and labels automatically also store the values required for the 
 reports to run unattended. The FHQUE AVAILABLE OPTIONS (#117.0243) file 
 stores values such as the time the report is scheduled to run and the 
 printer to which it will be sent. The FHQUE QUEUED REPORTS/LABELS 
 (#117.024) file stores a meaningful description for each of the available 
 reports that displays when FHQUE OPTION EDIT is selected. The FHQUE 
 REPORT DAYS(#117.0241) file stores the days of the week to enable a user 
 to select the day to run the report.
  
 The patch also adds Diet Order to the Patient Supplemental Feeding List.
 Sometimes diet orders are changed in the computer after the supplemental
 feeding was prepared by the food service worker. This modification allows
 a quick double check supplemental feeding orders against most recent diet
 order prior to delivery of the feeding. This patch utilizes "up to date"
 data available in the computer system to prepare a list which includes the
 patient's current diet order next to the supplemental feeding order.
  
 The patch adds three new fields to the Nutrition Person file#115, 
 Breakdfast Flag, Noon Flag and Evening Flag and an option to create 
 and edit the flags.  The Flag on Bottom of Tray Ticket, prints the flag at
 the bottom of the tray ticket as a simple and consistent way to
 communicate between team members at each meal, with individualized
 instructions for the Veteran.  These flags are located specifically in an
 area best suited to communicate meal to meal instructions to the nurse,
 occupational/rehab therapist, etc.
  
 Patch Components: 
 -----------------
  
 Files & Fields Associated:
  
 File Name (Number)            Field Name (Number)  New/Modified/Deleted
 ------------------            ------------------   --------------------
 FHQUE AVAILABLE OPTIONS       OPTION NAME (.01)             NEW
           (117.0243)          TIME TO RUN (1)               NEW
                               PRINTER (2)                   NEW
                               ENTRY TAG (3)                 NEW
                               CALLED ROUTINE (4)            NEW
                               ACTIVE (5)                    NEW
                               VARIABLES (MULTIPLE) (10)     NEW
                               DAYS TO RUN (MULTIPLE) (20)   NEW
  
 FHQUE QUEUED REPORTS/LABELS   OPTION (.01)                  NEW
           (117.024)           ADDITIONAL DESCRIPTION (1)    NEW
                               VARIABLES (MULTIPLE) (2)      NEW
                               TAG (3)                       NEW
                               ROUTINE (4)                   NEW
           
 FHQUE REPORT DAYS             DAY OF WEEK (.01)             NEW
           (117.0241)          NUMBER (1)                    NEW
  
 NUTRITION PERSON              BREAKFAST FLAG (662910.01)    NEW
           (115)               NOON FLAG (662910.02)         NEW
                               EVENING FLAG (662910.03)      NEW
  
 Forms Associated:               
  
 Form Name                     File #           New/Modified/Deleted
 ---------                     ------           --------------------
      N/A                       N/A
  
 Mail Groups Associated:
  
 Mail Group Name        New/Modified/Deleted
 ---------------        --------------------
      N/A                       N/A
  
 Option Associated
  
 Option Name     Type                New/Modified/Deleted
 -----------     ----                -------------------- 
 FHQUE QUEUE DIET REPORTS   RUN ROUTINE         NEW
 FHQUE OPTION EDIT          RUN ROUTINE         NEW
 FHQUE TEST                 RUN ROUTINE         NEW
 FHMTK1D TRAY TICKET EDIT   RUN ROUTINE         NEW
 FHMTK1P TRAY TICKET PRINT  RUN ROUTINE         Modified
 FHMTKM Tray Tickets        MENU                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
  
  
 Additional Information:
  
         N/A 
  
 New Service Requests (NSRs):
 ----------------------------  
 NSR20141207 Dietetics Report for Queuing Software
 NSR20170510 Print Flag on Bottom of Tray Ticket
 NSR20170519 Add Diet Order to the Patient Supplemental Feeding List
  
 Patient Safety Issues (PSIs):
 -----------------------------
           N/A
  
 Defect Tracking System Ticket(s) & Overview:
 --------------------------------------------
  
 Problem:
 -------
    N/A
  
 Resolution:
 ----------
    N/A
  
 Test Sites:
 ---------- 
    TBD
  
 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.DNS      .DNS   .
 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:
  
 Albany: DNS      .URL       
 Hines:  DNS     .URL         
 Salt Lake City:       .URL       
  
 Documentation can also be found in the VA Software Documentation Library 
 (VDL) at: http://URL            /.
  
 Title                                    File Name             FTP Mode
 --------------------------------------------------------------------------
 Nutrition and Food Service               fh5_5p8ag.pdf         Binary
 Manager/ADPAC Guide (Tentative)
 Nutrition and Food Service               fh5_5p8ag.doc         Binary
 Manager/ADPAC Guide (Tentative
  
  
 Patch Installation:
 ------------------- 
  
 Pre/Post Installation Overview:
 -------------------------------
 Review the Pre-Installation Instructions provided before beginning 
 installation of the patch.
  
 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:
 --------------------------
 To install the patch:
  
 1.      Choose the PackMan message containing this patch.
  
 2.      Choose the INSTALL/CHECK MESSAGE PackMan option.
  
 3.      From the Kernel Installation and Distribution System (KIDS) menu, 
 select the Installation Menu. From this menu, you may elect to use the 
 following options. When prompted for the INSTALL NAME, enter the patch 
 number FH*5.5*43.
  
 a.      Verify Checksums in Transport Global - This option will help 
 ensure the integrity of the routines that are in the transport global.
  
 b.      Print Transport Global - This option will enable viewing the 
 components of the KIDS build.
  
 c.      Compare Transport Global to Current System - This option will 
 enable viewing all changes that will be made when this patch is 
 installed. It compares all components of this patch (routines, data 
 dictionaries, templates, etc.).
  
 d.      Back up a Transport Global - This option will create a backup 
 message of any routines exported with this patch. It will not back up any 
 other changes such as data dictionaries or templates.
  
 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//', press <Enter>.
                                  
 6.      When prompted 'Want KIDS to INHIBIT LOGONs during the install? 
 NO//', press <Enter>.
  
 7.      When prompted 'Want to DISABLE Scheduled Options, Menu Options, 
 and Protocols? NO//', press <Enter>.
  
 8.      If prompted 'Delay install (Minutes): (0-60): 0//', press <Enter>.
  
 9.      If prompted 'Enter the Device you want to print the Install 
 messages. You can queue the install by enter a 'Q' at the device prompt. 
 Enter a '^' to abort the install. DEVICE: HOME//   HOME  (CRT)', press 
 <Enter>.
  
 Post-Installation Instructions:
 -------------------------------
           N/A
  
 Backout Procedure:
 ------------------
 Backout of this patch will be performed only with the concurrence and 
 participation of the appropriate VA site/region personnel. The decision 
 to back out the patch will be a joint decision between VA site/region 
 personnel and other appropriate VA personnel.
  
 Prior to installing the updated KIDS package, the site/region should have 
 saved a backup of the routines in a mail message using the Backup a 
 Transport Global [XPD BACKUP] menu option. 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 routines onto the VistA system. 
  
 Validation of Backout Procedure:
 --------------------------------
 The Backout procedure can be verified by printing the first two lines of 
 the FH routines contained in this patch using the option First Line 
 Routine Print [XU FIRST LINE PRINT]. Once the FH routines have been 
 backed out, the first two lines of the routines will no longer contain 
 the designation of patch FH*5.5*43 on line 2 in the patch list section.

Routine Information:
====================
The second line of each of these routines now looks like:
 ;;5.5;DIETETICS;**[Patch List]**;Jan 28, 2005;Build 35

The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: FHMTK1C
    Before: B21105135   After: B20731472  **43**
Routine Name: FHMTK1D
    Before:       n/a   After: B11030258  **43**
Routine Name: FHNO21
    Before: B16043749   After: B21283615  **5,8,43**
Routine Name: FHQUE
    Before:       n/a   After: B25705361  **43**
 
Routine list of preceding patches: 8

=============================================================================
User Information:
Entered By  : WERTH,WARREN                  Date Entered  : OCT 17, 2016
Completed By:                               Date Completed: 
Released By :                               Date Released : 
=============================================================================
