Original message: "HL*1.6*132 TNOV2" [#23970]
=============================================================================
Run Date: JAN 17, 2007                     Designation: HL*1.6*132
Package : HL - HEALTH LEVEL SEVEN             Priority: Mandatory
Version : 1.6       SEQ #106                    Status: Released
                  Compliance Date: FEB 17, 2007
=============================================================================

Associated patches: (v)HL*1.6*133  <<= must be installed BEFORE `HL*1.6*132'

Subject: MISC HL7 & HLO ENHANCMENTS

Category: 
  - Routine
  - Data Dictionary

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

 This patch provides several minor enhancements and bug fixes to the HL7
 software.  A description of each change is listed below:
  
 1. The optional "EXCLUDE SUBSCRIBER" subscript has been added to the HLP
    array for application developers to use when calling the
    GENERATE^HLMA API.  Using "EXCLUDE SUBSCRIBER"  allows the application
    to specify subscriber protocols that should be skipped when
    sending an HL7 message.  In effect this allows the application to say
    "use this event protocol, except drop these particular subscribers from the
    event protocols subscriber list".
 
 2. The HLO Application Registry now allows the version of the message to
    be specified.  This allows applications to specify different processing
    routines for different versions of the same message and event type.
  
 3. The HLO Application Registry now provides an activate/inactivate flag so
    that a particular message type for a particular application can be turned
    on and off at will.
 
 4. The HLL input parameter has been EN^HLOCNRT API.  This allows existing
    applications that do not currently use HLO to more easily convert to using
    HLO. The HLL array is used by some applications to dynamically address
    messages by passing in a list of recipients.  Applications that currently
    pass HLL into the old GENERATE^HLMA API may wish to convert to using HLO,
    and this new feature may make conversion easier.  
 
 5. For HLO, the name of the Sending and Receiving Application is not currently
    checked for embedded HL7 delimiters when building messages. This patch fixes
    that deficiency.  If the application name does contain an HL7 delimiter,
    then it will be replaced by the appropriate escape sequence.  
  
 6. The HL7 package allows a READ TIMEOUT and ACK TIMEOUT parameter to
    be specified for each entry in the HL Logical Link file.  This patch
    contains an improvement in how the HL7 client and server software
    use those parameters.  
 
  
  Test Sites:
  ===========
  Bay Pines
  Washington D.C.
  Montana HCS
  
   
  REMEDY:  
  =====
  none
  
      
  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.6;HEALTH LEVEL SEVEN;**[patch list]**;Oct 13, 1995;Build 3
 
                           CHECK^XTSUMBLD results
  Routine name    Before Patch        After Patch         Patch List
  ============    ============        ===========         ==========
  HLCS                 6018627            6422007        2,9,14,19,43
                                                          57,109,132
  HLCSTCP1             6536198            6563468       19,43,57,64,71
                                                            133,132
  HLMA                10219277           10219277       19,43,58,63,66
                                                       82,91,109,115,133
                                                              132
  HLOAPI1              7869305            7888531           126,132
  HLOAPP               1808457            3264280           126,132
  HLOCNRT              2243777            2083217           126,132
  HLOCVU               2593409            2978737           126,132
  HLOPBLD              3794679            4323801           126,132
  HLOPBLD1             7763438            9383483           126,132
  HLOPRS               8645215            7857438       118,126,133,132
  HLOQUE               1899801            1716909           126,132
     
  Number of Routines = 11
 
    
 INSTALLATION INSTRUCTIONS
  =========================
  
   1.  Users are allowed to be on the system during the installation.
  
    2.  Disable the HL7 TCPIP services for the multi-listeners running on 
        all nodes in the cluster, for example:
          ISC6A1> TCPIP
          TCPIP> DISABLE SERVICE HLS5000CACHE  
  
  
    3.  Shutdown all Logical Links, incoming and outgoing filers using
        the Filer and Link Management options listed below:
  
          Stop All Messaging Background Processes [HL STOP ALL]
  
    4.  Use the STOP HLO action of the HLO System Monitor option to
        temporarily stop the transmission of HLO messages.  
   
    5.  Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This
        option will load the KIDS package onto your system.
  
    6.  This patch is now loaded into a transport global on your system.
        The next step is to use KIDS to install the Transport global.  On
        the KIDS menu, under the 'Installation' menu, use the following
        options:
  
           Verify Checksums in Transport Global
           Print Transport Global 
           Compare Transport Global to Current System 
           Backup a Transport Global
           Install Package(s) 
  
        When using the Install Package(s) menu option to install the 
        patch build, you will be asked several questions.  The questions,
        and the answers you should supply, are shown below.
  
        INSTALL NAME: <HL*1.6*132>
        Want KIDS to INHIBIT LOGONS during the install?  <NO>
        Want to DISABLE Scheduled Options, Menu Options,
          and Protocols?  <NO>
  
    7.  Start up all Logical Links and incoming and outgoing filers using
        the Filer and Link Management Option's 'Restart/Start All Links
        and Filers [HL TASK RESTART]' menu option.
  
        (Note those links that do not have "autostart" enabled will need
        to be restarted manually.)
  
    8. Enable the HL7 TCPIP services for the multi-listeners, for example:
          ISC6A1> TCPIP
          TCPIP> ENABLE SERVICE HLS5000CACHE 
  
    9. Use the START HLO action of the HLO System Monitor option to 
       resume transmission of HLO messages.
  
   10.  Please verify that the option HLO SYSTEM STARTUP is scheduled
         to run both daily and upon system startup.  If not, please:
 
       a. To ensure that HLO messaging does not get disrupted, the HL7
          developers now recommend that sites use Schedule/Unschedule
          Options for HLO SYSTEM STARTUP:
  
            - Run the HLO SYSTEM STARTUP option daily, the specific time of day
              does not matter.
  
           - Make sure it runs on startup (i.e., SPECIAL QUEUEING: STARTUP) 
 
    b.  To ensure that HLO is currently running please do the following:
 
         Using the HLO SYSTEM MONITOR option verify:
            SYSTEM STATUS:             RUNNING
            PROCESS MANAGER:           RUNNING
 
 
 
 

Routine Information:
====================
The checksums below are new checksums, and
 can be checked with CHECK1^XTSUMBLD.

Routine Name: HLCS
    Before: B29807650  After: B32818553  **2,9,14,19,43,57,109,132**
Routine Name: HLCSTCP1
    Before: B31809732  After: B37159862  **19,43,57,64,71,133,132**
Routine Name: HLMA
    Before: B41676692  After: B41973628  **19,43,58,63,66,82,91,109,115,
                                          133,132**
Routine Name: HLOAPI1
    Before: B47488160  After: B47955238  **126,132**
Routine Name: HLOAPP
    Before:  B4658819  After:  B9133319  **126,132**
Routine Name: HLOCNRT
    Before:  B4743338  After:  B4616658  **126,132**
Routine Name: HLOCVU
    Before:  B5066511  After:  B6948622  **126,132**
Routine Name: HLOPBLD
    Before: B10420625  After: B11482408  **126,132**
Routine Name: HLOPBLD1
    Before: B18903926  After: B22231914  **126,132**
Routine Name: HLOPRS
    Before: B30775930  After: B29583267  **118,126,133,132**
Routine Name: HLOQUE
    Before:  B5007132  After:  B5510606  **126,132**

=============================================================================
User Information:
Entered By  : MOORE,CHARLES J               Date Entered  : JUN 21, 2006
Completed By: SINGH,GURBIR                  Date Completed: JAN 16, 2007
Released By : GAYFIELD,LISA                 Date Released : JAN 17, 2007
=============================================================================


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

$END TXT