$TXT Created by MOORE,JIM at NXT.KERNEL.FO-OAKLAND.MED.VA.GOV (KIDS) on Wednesday, 09/21/05 at 09:46 ============================================================================= Run Date: OCT 06, 2005 Designation: HL*1.6*126 Package : HL - HEALTH LEVEL SEVEN Priority: Mandatory Version : 1.6 SEQ #101 Status: Released Compliance Date: NOV 06, 2005 ============================================================================= Associated patches: (v)HL*1.6*84 <<= must be installed BEFORE `HL*1.6*126' (v)HL*1.6*118 <<= must be installed BEFORE `HL*1.6*126' (v)XU*8*388 <<= must be installed BEFORE `HL*1.6*126' Subject: HL7 OPTIMIZED Category: - Data Dictionary - Routine - Enhancement (Mandatory) Description: ============ This patch provides a new HL7 messaging engine called HL7 Optimized (HLO). HLO is almost totally new and provides much greater performance. Although HLO is a patch to version 1.6 of the HL7 package, it will not replace the original HL7 engine. Instead, sites will continue to run the original HL7 engine so that existing applications may run without change. New HL7 messaging applications will be designed to utilize HLO, so sites must run HLO as well as the original HL7 engine. Where necessary to improve performance, application development teams may convert existing applications to utilize HLO, but conversion is not mandated. HLO includes: 1. A new messaging engine. It will utilize the existing links from the HL Logical Link file (#870), but will operate on a port 5001 for production systems and 5026 for test systems. 2. A new set of APIs for developers of messaging applications. 3. A new set of options for monitoring the state of the messaging system and for viewing messages. A complete description of the new HLO software is provided in several supplemental documents, see the 'Supplemental Documentation' Section below for directions on obtaining the documentation. No NOIS addressed. Test sites: =========== CMOP-NAT Pittsburgh West Palm Beach Supplemental Documentation ========================== Two supplemental documents are provided: TECHNICAL MANUAL (System Manager/Developer Guide)Patch HL*1.6*126 INSTALLATION MANUAL/RELEASE NOTES Patch HL*1.6*126 These documents can be obtained by using FTP from the appropriate Customer Service directory: OI FIELD OFFICE FTP ADDRESS DIRECTORY ====================================================== download.vista.med.va.gov Albany ftp.fo-albany.med.va.gov Hines ftp.fo-hines.med.va.gov Salt Lake City ftp.fo-slc.med.va.gov Host File Names: hl71_6_p126_ig.doc installation guide - Word format hl71_6_p126_ig.pdf installation guide - Acrobat format hl71_6_p126_tm.doc technical manual - Word format hl71_6_p126_tm.pdf technical manual - Acrobat format These documents can also be downloaded from the VISTA Documentation Library (VDL) on the HL7 Web page: http://www.va.gov/vdl/Infrastructure.asp?appID=8 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: ;;1.6;HEALTH LEVEL SEVEN;**[patch list]**;Oct 13, 1995 CHECK^XTSUMBLD results Routine name Before Patch After Patch Patch List ============ ============ =========== ========== HLMA3 N/A 5053869 126 HLOAPI N/A 9935117 126 HLOAPI1 N/A 7869305 126 HLOAPI2 N/A 8788183 126 HLOAPI3 N/A 8603274 126 HLOAPP N/A 1808457 126 HLOASUB N/A 5368638 126 HLOASUB1 N/A 9089024 126 HLOCLNT N/A 16771796 126 HLOCLNT1 N/A 7133917 126 HLOCLNT2 N/A 5582950 126 HLOCLNT3 N/A 2295109 126 HLOCNRT N/A 2243777 126 HLOCVU N/A 2593409 126 HLOF777 N/A 4754015 126 HLOF778 N/A 7463325 126 HLOF778A N/A 10581929 126 HLOFILER N/A 7170474 126 HLOMSG N/A 9820871 126 HLOMSG1 N/A 1946268 126 HLOPBLD N/A 3794679 126 HLOPBLD1 N/A 7763438 126 HLOPOST N/A 2282753 126 HLOPROC N/A 6533340 126 HLOPROC1 N/A 11957257 126 HLOPRS 8492281 8512943 118,126 HLOPURGE N/A 7353313 126 HLOQUE N/A 1899801 126 HLOSITE N/A 1968238 126 HLOSRVR N/A 17845812 126 HLOSRVR1 N/A 16949751 126 HLOT N/A 1038794 126 HLOTCP N/A 9157020 126 HLOTLNK N/A 3770582 126 HLOUSR N/A 18703118 126 HLOUSR1 N/A 11175583 126 HLOUSR2 N/A 11218586 126 HLOUSR3 N/A 6315298 126 Installation Instructions (takes fewer than 10 minutes): ========================= 1. Users are allowed to be on the system during the installation. 2. Create and map new globals. This patch defines five new globals as listed in the following table. These globals may need to be created and mapped prior to patch installation depending on storage requirements at the individual site. Using the appropriate global management utility (i.e. %GLOMAN or the GUI Cache Configuration Manager), create these globals and assign the following global access privileges: System = RWD (or RWP), World = RWD (or RWP), Group = RWD (or RWP) and UCI = RWD (or RWP). This may require assistance from a system manager. Global Description Storage Journaling ====== =========== ======= ========== ^HLA HLO MESSAGE BODY (File# 777) Potentially Yes Large ^HLB HLO MESSAGES (File# 778) Potentially Yes Large ^HLC System counters used by HLO Minimal Yes ^HLD Files: Minimal Yes HLO SYSTEM PARAMETERS (File# 779.1) HLO APPLICATION REGISTRY (File# 779.2) HLO PROCESS REGISTRY (File# 779.3) HLO SUBSCRIPTION REGISTRY (File# 779.4) ^HLTMP Temporary storage for HLO Minimal Yes 3. Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This option will load the KIDS package onto your system. 4. This patch is now loaded into a transport global on your system. The next step is to use KIDS to install the Transport global. To do this, use the 'Installation [XPD INSTALLATION MENU]' menu. You should use each of the following 'Installation' menu options in the order shown below: 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 asked, and the answers you should supply, are shown below. INSTALL NAME: Want KIDS to Rebuild Menu Trees Upon Completion of Install? YES// Want KIDS to INHIBIT LOGONS during the install? YES// Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// YES Enter options you wish to mark as 'Out Of Order': HL MAIN MENU HL7 Main Menu Enter options you wish to mark as 'Out Of Order': Enter protocols you wish to mark as 'Out Of Order': Delay Install (Minutes): (0-60): 0//: 5. Follow the instructions found in Section 5 of the Installation Manual for instructions on how to complete the setup of the new HL7 messaging engine. Setup includes additional steps for scheduling new options, for installing a new TCP/IP listener, and for starting the new messaging engine. Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD Routine Name: HLMA3 Before: n/a After: B26373063 Routine Name: HLOAP1 Routine Name: HLOAPI Before: n/a After: B35456611 Routine Name: HLOAPI1 Before: n/a After: B47488160 Routine Name: HLOAPI2 Before: n/a After: B27708015 Routine Name: HLOAPI3 Before: n/a After: B30983602 Routine Name: HLOAPP Before: n/a After: B4658819 Routine Name: HLOASUB Before: n/a After: B20309588 Routine Name: HLOASUB1 Before: n/a After: B53189937 Routine Name: HLOCLNT Before: n/a After: B65447935 Routine Name: HLOCLNT1 Before: n/a After: B25822354 Routine Name: HLOCLNT2 Before: n/a After: B12124771 Routine Name: HLOCLNT3 Before: n/a After: B3706254 Routine Name: HLOCNRT Before: n/a After: B4743338 Routine Name: HLOCVU Before: n/a After: B5066511 Routine Name: HLOF777 Before: n/a After: B12330869 Routine Name: HLOF778 Before: n/a After: B26674072 Routine Name: HLOF778A Before: n/a After: B35675106 Routine Name: HLOFILER Before: n/a After: B18562276 Routine Name: HLOMSG Before: n/a After: B44340349 Routine Name: HLOMSG1 Before: n/a After: B6084209 Routine Name: HLOPBLD Before: n/a After: B10420625 Routine Name: HLOPBLD1 Before: n/a After: B18903926 Routine Name: HLOPOST Before: n/a After: B3878072 Routine Name: HLOPROC Before: n/a After: B24878795 Routine Name: HLOPROC1 Before: n/a After: B37655107 Routine Name: HLOPRS Before: B30015761 After: B30060156 Routine Name: HLOPURGE Before: n/a After: B28987748 Routine Name: HLOQUE Before: n/a After: B5007132 Routine Name: HLOSITE Before: n/a After: B5183865 Routine Name: HLOSRVR Before: n/a After: B67857069 Routine Name: HLOSRVR1 Before: n/a After: B62638202 Routine Name: HLOT Before: n/a After: B2539193 Routine Name: HLOTCP Before: n/a After: B43009690 Routine Name: HLOTLNK Before: n/a After: B15931185 Routine Name: HLOUSR Before: n/a After: B88426707 Routine Name: HLOUSR1 Before: n/a After: B64766610 Routine Name: HLOUSR2 Before: n/a After: B44072105 Routine Name: HLOUSR3 Before: n/a After: B18658983 ============================================================================= User Information: Entered By : MOORE,CHARLES J Date Entered : JAN 21, 2005 Completed By: SINGH,GURBIR Date Completed: SEP 29, 2005 Released By : APOLONIO,AUGUSTO Date Released : OCT 06, 2005 ============================================================================= Packman Mail Message: ===================== $END TXT