$TXT Created by TRAN,TRINITY at DEMCUR.FO-SLC.MED.VA.GOV  (KIDS) on Monday, 03/28/05 at 13:29
=============================================================================
Run Date: APR 12, 2005                     Designation: TIU*1*180
Package : TIU - TEXT INTEGRATION UTILITIES    Priority: Mandatory
Version : 1       SEQ #178                      Status: Released
                  Compliance Date: MAY 13, 2005
=============================================================================

Associated patches: (v)TIU*1*175   <<= must be installed BEFORE `TIU*1*180'

Subject: TIU SIGNED/UNSIGNED PN

Category: 
  - Routine
  - Other

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

 This patch deals with concerns brought up in a recent patient safety 
 issue - 'Signed Progress Note Showing as Unsigned' and in a recent
 ClearQuest about a potential problem of '$D(arg)#2 usage. This patch
 currently contains the following functionality:
  
   1) Using the List Manager interface, users can search for and update TIU
      documents that have been signed but their statuses display as
      unsigned.
  
   2) A daily task to search for any documents that have been signed 
      but statuses stay unsigned.  If a document is found, then
      a bulletin with subject "TIU SIGNED/UNSIGNED DOCUMENTS" will be sent
      to a mail group named "TIU SIGNED/UNSIGNED DOC" with the document
      number.
  
   3) A minor change in routine TIUPNAPI to prevent a potential problem of 
      '$D(arg)#2 usage.  The change is mainly the line '$D(DUZ)#2.  It is 
      modified to '($D(DUZ)#2) to catch the potential error when DUZ is not
      defined but its descendant nodes are. 
  
 Details for invoking the routines associated with this patch can be found
 in the post-installation instructions below.
  
  OPTION:  
  ======
  There are two new options being exported with this patch. 
  
  1) Signed/unsigned PN report and update [TIU SIGNED/UNSIGNED PN] 
     This option is attached to the TIU MAIN MENU MGR menu.
  
  2) Signed/unsigned PN daily search [TIU SIGNED PN UNSIGNED 
     STATUS]. This option will be scheduled to run every night, see post
     installation instructions below.
  
  DOCUMENTATION:
  ==============
  
  The TIU User Manual and TIU Technical Manual have been updated to reflect
  the enhancements provided by this patch. The updated documentation is
  available in the form of (.PDF) files, as follows:
  
    TIUUM.PDF       TIU User Manual
    TIUTM.PDF       TIU Technical Manual
  
  The files can be retrieved in BINARY format by FTP. The preferred
  method is to FTP the files from:
  
     download.vista.med.va.gov    
  
  which will transmit the file from the first available FTP server.
  
  The file may also be downloaded directly from a particular FTP location
  at the following locations:
  
    CIO FIELD OFFICE   FTP ADDRESS                 DIRECTORY
    ----------------   -------------------------   --------------------
    Albany             ftp.fo-albany.med.va.gov    [anonymous.software]
    Hines              ftp.fo-hines.med.va.gov     [anonymous.software]
    Salt Lake City     ftp.fo-slc.med.va.gov       [anonymous.software]
  
  The documentation can also be found on the System Design and
  Development Web page: (http://vista.med.va.gov/vdl/).
  
  ROUTINE SUMMARY:
  ================
  The following is a list of the routine(s) included in this patch.  The
  second line of each of these routine(s) will look like:
  
      <tab>;;1.0;TEXT INTEGRATION UTILITIES;**[patch list]**;Jun 20,1997
  
                             CHECK^XTSUMBLD results
  Routine name        Before Patch       After Patch       Patch List
  ============        ============       ===========       ==========
  TIUPNAPI                 5598488           5881794       57,140,175,180
  TIUSUPN                      N/A           9727162            180
  TIUSUPN1                     N/A           2434166            180
  TIUSUPN2                     N/A           3384593            180
  
  Patient Safety Issue:
  ====================
  PSI-04-060  Signed PN showing as unsigned
  
  ClearQuest:
  ==========
  HDS00007045   '$D search - TIU
  
  Note:
  ====
  The following NOIS calls are related to the above PSI; however, this 
  patch does not provide a real fix to these calls, so they will need to be
  open until we find a solution for the problem.
  
  PUG-0499-53103     E-signed PN still shows as unsigned
  SUX-0103-42517     Signed notes status shows as Unsigned
  MIA-1101-32401     Signed notes still showing as unsigned
  CLL-0401-40173     SIGNED NOTES HAVE STATUS OF UNSIGNED
  UNY-1199-11189     TIU status not updated
  SYR-0699-12451     E/S NOT UPDATING STATUS TO COMPLETE
  
  Installation Instructions: 
  =========================
  This patch may be installed with users on the system; however, it should
  be installed at a non-peak time to minimize disruption to the users.
  Installation of this patch should take less than 1 minute.
      
     1. Use the INSTALL/CHECK MESSAGE option on the Packman Menu.  
       
     2. Review your mapped set.  If any of the routines listed in this 
        patch are mapped, they should be removed from the mapped set at 
        this time.  
      
     3. From the Kernel Installation and Distribution System (KIDS) Menu, 
        select the Installation menu.  
      
     4. From the Installation menu, you may elect to use the following 
        options (when prompted for INSTALL NAME, enter TIU*1.0*180): 
      
        a.  Backup a Transport Global 
        b.  Compare Transport Global to Current System 
        c.  Verify Checksums in Transport Global
     
     5. Use the Install Package(s) option and select the package TIU*1.0*180.
     
     6. When prompted 'Want KIDS to Rebuild Menu Trees Upon Completion of
        Install? YES//', respond YES
  
     7. When prompted 'Want KIDS to INHIBIT LOGONs during the install? 
        YES//', respond NO.
      
     8. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and
        Protocols? YES//', respond NO.
      
     9. When prompted 'Delay Install (Minutes):  (0-60): 0//', respond '0'.
      
     10. If routines were unmapped as part of step 2, they should be
         returned to the mapped set once the installation has run to
         completion.
  
  Post-Installation Instructions: 
  ==============================
  
 1. The report can be run using the new menu option, Signed/unsigned PN 
    report and update [TIU SIGNED/UNSIGNED PN].
  
    When running this option, the following recommendations are made:
  
   - Users may be on the system
  
   - The job should be run at a time that does not conflict with a system 
     backup
  
   - Processing times for this task will vary considerably, depending on
   the load on your system and the number of entries processed in the TIU
   DOCUMENT FILE (#8925). 
  
   The TIU signed/unsigned LM provides the following functions:
  
   BROWSE DOCUMENT  - If authorized, read only view of a selected document.
  
   DETAILED DISPLAY - If authorized, allows the user to view document 
                      details of a selected document.
  
   STATUS UPDATE    - Allows the user to update the status of a selected
                      TIU document. If the note does not require 
                      cosignature, the status will be updated to 
                      "completed". If the note requires cosignature 
                      and the cosigner has not signed it, the status will
                      be updated to "uncosigned".
  
 2. Run the daily search by scheduling the new option:"TIU SIGNED PN 
    UNSIGNED STATUS" to run every night at 23:59
  
   Instructions on setting up a mail group:
   ----------------------------------------
    
   The option to use is Mail Group Edit under the Manage Mailman menu.
   Only parameters that are being used are shown below.
  
   Select MAIL GROUP NAME: TIU SIGNED/UNSIGNED DOC
   Are you adding 'TIU SIGNED/UNSIGNED DOC' as a new MAIL GROUP? No// Y  
   (Yes)
   MAIL GROUP NAME: TIU SIGNED/UNSIGNED DOC// 
   Select MEMBER: TRAN,TRINITY       TT       
   Are you adding 'TRAN,TRINITY' as a new MEMBER (the 1ST for this MAIL 
   GROUP)? No// Y
   (Yes)
   TYPE: I  INFO
   Select MEMBER: 
   TYPE: PU   public
   ORGANIZER: TRAN,TRINITY// 
  
   Instructions on scheduling the daily search:
   --------------------------------------------
  
   The option to use is SCHEDULE/UNSCHEDULE OPTIONS under the TASKMAN 
   MANAGEMENT menu.  The only 2 parameters that we need to use are shown 
   below.
  
   Select OPTION NAME: XUTM MGR   Taskman Management     menu
          
   Select Taskman Management Option: SCHedule/Unschedule Options
  
   Select OPTION to schedule or reschedule:TIU SIGNED PN UNSIGNED STATUS
        Signed/unsigned PN daily search     run routine
          ...OK? Yes//   (Yes)
  
   QUEUED TO RUN AT WHAT TIME: DEC 2,2004@23:59  <== current date@23:59
  
   RESCHEDULING FREQUENCY: 1D                          

Routine Information:
====================

Routine Name:
  - TIUPNAPI


Routine Checksum:

Routine Name:
  - TIUSUPN


Routine Checksum:

Routine Name:
  - TIUSUPN1


Routine Checksum:

Routine Name:
  - TIUSUPN2


Routine Checksum:

=============================================================================
User Information:
Entered By  : HAWSEY,JASON                  Date Entered  : OCT 21, 2003
Completed By: GRAZIANI,ROBERT               Date Completed: APR 07, 2005
Released By : MONTGOMERY,ALAN               Date Released : APR 12, 2005
=============================================================================


Packman Mail Message:
=====================

$END TXT