$TXT Created by THEROUX,JOHN at MNTVBB.FO-ALBANY.MED.VA.GOV  (KIDS) on Tuesday, 01/07/03 at 11:53
=============================================================================
Run Date: MAR 05, 2003                     Designation: RT*2*34
Package : RT - RECORD TRACKING                Priority: Mandatory
Version : 2        SEQ #32                      Status: Released
                  Compliance Date: APR 05, 2003
=============================================================================

Associated patches: (v)RT*2*30     <<= must be installed BEFORE `RT*2*34'

Subject: SYSTEM RESOURCES FOR RETIREMENT PULL LISTS 

Category: 
  - Routine

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

    This patch is intended to reduce the resources consumption when 
    using the option Generate Record Retirement Pull Lists [RT INACT-
    PULL-CREATE].
  
 Associated NOIS:
 ----------------
 1. LOM-1201-61059     RT TASK CONSUMING 100% OF NODE's CPU
    Duplicate:
        ATG-0502-32234     Inactive Pull List processes
  
 Associated E3Rs:
 ----------------
 N/A
  
 Participating test sites:
 -------------------------
 Atlanta, GA
 Salt Lake City, UT
  
 NOIS Overview
 -------------
 1. LOM-1201-61059     RT TASK CONSUMING 100% OF NODE's CPU
  
    Problem:
    --------
    It has been reported that the Generate Record Retirement Pull
    Lists [RT INACT-PULL-CREATE] option from the 'Inactivate Records
    Menu' is a heavy consumer of system resources, using up to 100%
    of the cpu.  
    
    It was noticed that some sites are answering "No" to the 'Use
    terminal digit scan prompt?', because the RECORD TRACKING SORT GLOBAL
    (#194.3) file has not been recompiled for several years.  This forces
    the Generate Record Retirement Pull Lists [RT INACT-PULL-CREATE] option
    to look at every record in the RECORDS (#190) file.
    
    The developer also discovered some glitches with the compile of the
    RECORD TRACKING SORT GLOBAL (#194.3) file launched from the prompt
    'Use terminal digit scan prompt?', if a user answers "YES" and the RECORD
    TRACKING SORT GLOBAL (#194.3) file had not been compiled yet in the
    current year.  These issues were 1) the background job would abort if
    broken pointers were encountered, and 2) the Generate Record Retirement
    Pull Lists [RT INACT-PULL-CREATE] option would not allow restarting the
    compile job if it failed to complete successfully.
    
    Resolution:
    -----------
    The software was modified to speed up the processing by using the "AC"
    cross-reference instead of the "C" crossreference of the REQUESTED
    RECORDS (#190.1) file when using the Generate Record Retirement Pull
    Lists [RT INACT-PULL-CREATE] option.  In addition, when responding to
    the prompt for a terminal digit entry, we have added a statement
    recommending that the range of digits be limited to 10.
    
    The software was also modified to fix the two issues related to the
    compile of the RECORD TRACKING SORT GLOBAL (#194.3) file.  Broken
    pointers will no longer cause the background job to abort, and if
    the compile fails to complete, the user may restart it using the
    Generate Record Retirement Pull Lists [RT INACT-PULL-CREATE] option.
    
    It is recommended for sites to follow these steps in the future when
    attempting to use the Generate Record Retirement Pull Lists
    [RT INACT-PULL-CREATE] option after installation of this patch:
  
      1) Schedule any recompiling of file 194.3 during off hours--
         for some sites this process, which is normally done once a year,
         will be the first recompile in many years and may run a long time. 
      2) Always respond 'Yes' to the "Use terminal digit scan?" prompt.
      3) Use a terminal digit range of no more than 10 digits,
         for example, 0-9, 10-19, etc.
  
 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>;;2.0;Record Tracking;**[patch list]**;10/22/91
  
                         CHECK^XTSUMBLD results
 Routine name      Before Patch        After Patch         Patch List
 ============      ============        ===========         ==========
  RTSM1              12475025            12815984          4,14,34
  RTSM8               9894181            10563857          4,14,30,34  
  
 INSTALLATION INSTRUCTIONS 
 =========================
 This patch can be loaded with users on the system.  Installation
 will take less than 2 minutes.
  
   1.   Choose the PackMan message containing this patch and invoke the 
        INSTALL/CHECK MESSAGE PackMan option.  
  
   2.   (DSM for Open VMS sites only) Disable routine mapping on all systems
        for the routines listed in the Routine Summary.
   
        NOTE:  If the routines included in this patch are not currently
        in your mapped routine set, please skip this step.
   
   3.   Start up the Kernel Installation and Distribution System Menu 
        [XPD MAIN]: 
    
             Edits and Distribution ...  
             Utilities ...  
             Installation ...  
    
     Select Kernel Installation & Distribution System Option: INStallation
                                                              ---
                                                                
             Load a Distribution 
             Print Transport Global 
             Compare Transport Global to Current System 
             Verify Checksums in Transport Global 
             Install Package(s) 
             Restart Install of Package(s) 
             Unload a Distribution 
             Backup a Transport Global 
   
   4.   From this menu, you may elect to use the following options
        (When prompted for the INSTALL NAME, enter RT*2.0*34):
       
        a.  Backup a Transport Global - This option will create a backup
            message of any routines exported with this patch. It will not
            backup any other changes such as DD's or templates.
        b.  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 components of this patch
            (routines, DD's, templates, etc.).
        c.  Verify Checksums in Transport Global - This option will allow
            you to ensure the integrity of the routines that are in the
            transport global.
      
   5.   Use the Install Package(s) option and select the package 
        RT*2.0*34.
    
        a.  When prompted 'Want KIDS to INHIBIT LOGONs during the install?
            YES//', answer NO (unless otherwise indicated).
        b.  When prompted 'Want to DISABLE Scheduled Options, Menu Options,
            and Protocols? YES//', answer YES.
        c.  When prompted 'Enter options you wish to mark as 'Out Of
            Order':', enter the following options:
   
            Generate Record Retirement Pull Lists  [RT INACT-PULL-CREATE]
            Compile Terminal Digit Sort Global  [RT SM-REC-COMPILE-TERM-DIGIT]
              
        d.  When prompted 'Enter protocols you wish to mark as 'Out Of 
            Order':', press <return>.
  
   6.   (DSM for Open VMS sites only) Optional - Include the routines
        distributed with this patch in the mapped routine set.
     
        NOTE: This step is only necessary if you performed step 2 or if
        you wish to include the routines in your mapped set.

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

Routine Name:
  - RTSM8


Routine Checksum:

Routine Name:
  - RTSM1


Routine Checksum:

=============================================================================
User Information:                               
Entered By  : THEROUX,JOHN                   Date Entered : DEC 17, 2002
Completed By: PHELPS,TY                     Date Completed: FEB 27, 2003
Released By : ALEXANDER,DIANNE              Date Released : MAR 05, 2003
=============================================================================


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

$END TXT