INSTALLATION NOTES FOR KERNEL 8.0 IHS Patch #1 3/20/97 ============================================================ PREFIX: XU CURRENT VERSION: 8.0 ============================================================ ************************************************************ READ ENTIRE NOTES FILE PRIOR TO ATTEMPTING ANY INSTALLATION ************************************************************ ** NOTE **** NOTE **** NOTE **** NOTE **** NOTE **** NOTE** IHS Patch to Kernel 8.0. The installation of Kernel 8.0 included patches from the VA through patch sequence 35 (XU*8*44). This patch contains: XU*8*14 SEQ #36 Category: Routine, Data Dictionary XU*8*47 SEQ #37 Category: Input Template, Routine XU*8*50 SEQ #38 Category: Input Template, Routine, Data Dictionary XU*8*51 SEQ #40 Category: Routine XU*8*36 SEQ #41 Category: Routine, Data Dictionary, Print Template XU*8*56 SEQ #43 Category: Routine Patch XU*8*48 SEQ #39 is for sites running Lab and Order Entry/RR. It will be released when Lab 5.2 is released. Patch XU*8*53 SEQ #42 is an INFORMATIONAL patch, and is NOT included in THIS patch (XU*8*1001). It will be implemented in conjunction with the loading of MSM 4.3 in the future. It concerns a P-MESSAGE terminal type and device which utilizes a "NULL" device which will be new to that version of M. Instructions for that patch will be issued along with the release notes for MSM 4.3. Line L1+3 of XQ82 was commented out to prevent the Kernel error trap from being killed. VA was notified of the bug. The ZIS4MSM (%ZIS4 in MGR UCI) and FINDFN (%FINDFN in MGR UCI) were patched to prevent endless looping of the browser (thanks to Floyd Dennis, ANMC, and Brett Hunt of Micronetics). INSTRUCTIONS FOR INSTALL: YOU MAY INSTALL THIS PATCH IN SINGLE-USER M (SUMSM), or IF YOU INSTALL IT WITH THE SYSTEM UP, SHUTDOWN TASKMAN FIRST AND LOCK OUT USERS. IT ONLY TAKES 10-15 MINUTES TO LOAD. 1. From the KIDS Main Menu (under Programmer Options off of the AKMOEVE menu), select Installation ... 2. From the Installation Menu, select 1. Load a Distribution 3. Enter a Host File: krn_0800.01p Answer YES to all prompts: OK to continue? NO// YES Want to Continue with Load? YES// (Accept default) Want to RUN the Environment Check Routine? YES// (Accept default) Then, when you are returned to the Installation Menu: 4. Select 6 Install Package(s) and type in XU*8.0*1001 Accept defaults to all prompts: 3.2 TERMINAL TYPE (including data) Note: You already have the 'TERMINAL TYPE' File. Want my data to overwrite yours? YES// (There is only ONE record - P-BROWSER - which will be added to your current Terminal Type file or which will over-write another P-BROWSER you may already have. Answer YES to this question. It will not affect your other terminal type entries.) 3.5 DEVICE (including data) Note: You already have the 'DEVICE' File. Want my data to overwrite yours? YES// (There is only ONE record BROWSER device - which will be added to your current Device File or which will over-write another BROWSER device you may already have. Answer YES to this question. It will not affect your other terminal type entries.) Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// Want to MOVE routines to other CPUs? NO// Enter options you wish to mark as 'Out of Order': (Press RETURN) Enter protocols you wish to mark as 'Out Of Order': (Press RETURN) Delay Install (Minutes): (0-60): 0// (Press RETURN) DEVICE: HOME// (Press RETURN) 5. As post-install do the following to copy selected routines from your Production account to the Manager account: D ^%RCOPY FINDFN ZIS4MSM ZISHMSM ZISHMSU ZISHMSMU ZISHMSMD ZISC ZISTCP ZOSVMSM ZTER ZTER1 ZTM ZTM0 ZTM5 ZTMGRSET ZTMON1 ZTMS ZTMS1 ZTMS2 ZTMS3 ZTEDIT ZTEDIT1 ZTEDIT2 ZTEDIT3 ZTEDIT4 Screen ROUTINES by date last edited? NO// Copy to UCI: MGR Selective copy (allows rename) : After the routines are copied to MGR, d ^%ZUCI to MGR account and DO RELOAD^ZTMGRSET Select the System: 2 for MSM Patch number to load: 36 ** DONE ** After RELOAD has completed, do the following (still in MGR UCI): ZL FINDFN ZS %FINDFN ZL ZIS4MSM ZS %ZIS4 If you are loading a UNIX site: ZL ZISHMSU ZS %ZISH If you are loading a DOS site: ZL ZISHMSM ZS %ZISH 6. Edit the device "BROWSER" which was installed with this patch. The VOLUME SET(CPU) field is blank. In order for the device to work, you must enter YOUR volume set. See example below: Select DEVICE NAME: BROWSER Kernel 8 Browser 51 SMA NAME: BROWSER// LOCATION OF TERMINAL: Kernel 8 Browser// Select MNEMONIC: LOCAL SYNONYM: $I: 51// VOLUME SET(CPU): SMA// <-------INSERT YOUR VOLUME SET (CPU)--------- SIGN-ON/SYSTEM DEVICE: NO// TYPE: HOST FILE SERVER// SUBTYPE: P-BROWSER// ASK DEVICE: YES// ASK PARAMETERS: NO// ASK HOST FILE: NO// ASK HFS I/O OPERATION: NO// QUEUING: NOT ALLOWED// ***************INSTALLATION COMPLETED********************* FOLLOWING ARE NOTES FROM ALL OF THE VA PATCH NOTES FILES EXPLAINING THE CHANGES MADE BY THESE PATCHES AND THE REASONS FOR MAKING THOSE CHANGES. PROBLEMS FIXED BY VA PATCH XU*8.0*14 SEQ #36 ------------------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: KERNEL DESCRIPTION: E-Sig Improvements New E-SIG functions so that other developers can follow the General Counsels guidelines on E-SIG. This comes from a meeting at Birmingham on 9/18-20/95. New routine XUSESIG1. Changes to the New Person file: Added a DEGREE field to hold MD, RN, LPN... Added a DATE E-SIG LAST CHANGED field. The seeding of this field will be done by taking the current date+random(60)+30 days to give a date when the user will need to select a new E-SIG code. The option XUSESIG BLOCK is included in this patch. KERNEL functions to help developers. $$CHKSUM^XUSESIG1($name_value,flag) This would take a root ($name_value) and build a checksum for all data in the root. (Not used now, flag would be used when there is more that one checksum algorithm.) $$ESBLOCK^XUSESIG1(ien) This extrinsic function would return the set of fields from the new person file that are needed as part of the hash for a acceptable E-Sig. If IEN is not passed in then DUZ is used. (E-Sig block, E-Sig title, Degree, Current Date/Time) $$EN^XUSESIG1(checksum,esblock) If the ESBLOCK is not passed then the function would get the ESBLOCK. In either case this extrinsic function would encode the ESBLOCK using the checksum as the KEY. Return an encoded string. $$CMP^XUSESIG1(checksum,$name_value) The extrinsic function would compare the checksum passed in to the calculated value from the $NAME_VALUE. Return 1 for match, 0 for no match. $$DE^XUSESIG1(checksum,encoded_string) This extrinsic function would decode the string using the checksum as the key. Return a decoded string. ************************************************************************* PROBLEMS FIXED BY VA PATCH XU*8.0*47 SEQ #37 --------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: KERNEL DESCRIPTION: This patch contains 7 routines, 1 option, and 1 input template. It replaces XU*8*4 which has been canceled. It fixes 3 problems in the Menu System: 1. Routines XQ72, XQ75, XQ83R, XQCHK, and XQT: If a parent option on the top of a menu tree was placed out-of-order or locked a user might be able to jump through it because of the way the compiled menus in ^XUTL were being built. [NOIS WBP-0895-22132] 2. Routines XQSMD1 and XQOO: Confusion resulted when a user encountered an option that contained a hyphen in the option name. The software could not easily distinguish between this type of option and two different options presented with a hyphen between them as a range of options to select. The software now looks first to see if a single option meets the selection criterion, and if so it ignores the possibility of a range of options. 3. The option XUEDITOPT and the input template [XUEDITOPT]: A piece of code was added to the template in Kernel 8 to start micro surgery to rebuild the compiled menus after an option was created or changed. This resulted in errors because the code called FileMan from within a template. The call was therefore moved to the Exit Action of the option to avoid that conflict. [NOIS ERI-1095-21763, FTM-1095-43520] ************************************************************************** PROBLEMS FIXED BY VA PATCH XU*8.0*50 SEQ #38 -------------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: DESCRIPTION: This patch contains a routine, an input template, and a change to the data dictionary of the Option File [^DIC(19)]. It corrects 3 problems with servers: 1. [CML-0296-N1840 and LIT-0496-71332 ] Server tasks were retained for 30 days in ^ZTSK, and several sites complained that this was too long and therefore a waste of disk space. The default task retention time was lowered to 14 days, and a field was added to the Option File (ZTSK RETENTION DAYS) to allow the site to set the retention time for each server on the system from 1 to 365 days. 2. [MCM-1096-51188] A site complained that the edit template XUEDITOPT did not allow them to edit the field SERVER DEVICE when working with a server-type option. This was corrected when the new field was added to the template. 3. [SLC-1096-50407] Under certain circumstances, servers that were designated as active in the SERVER ACTION field were not running at all but being queued because of a logic error. PROBLEMS FIXED BY VA PATCH XU*8.0*51 SEQ #40 -------------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: KERNEL DESCRIPTION: -This patch now allows you to transport a Global Package correctly. This bug was introduced with patch 44. -The input transform for the Name field in the Build file has been changed to allow sites to create local patches. It now allows 6 digit patch numbers, i.e., XU*8.0*662001 -Kernel 8 patches will now contain the sequence number in the Patch Application History multiple of the Package file. -HL LOGICAL LINK entries were not being cross-referenced. -The post-install routine XQP50 will update the Patch Application History multiple with the information about patch 50. The DATE APPLIED and APPLIED BY fields will be the same as this patch. ************************************************************************** PROBLEMS FIXED BY VA PATCH XU*8.0*36 SEQ #41i -------------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: KERNEL DESCRIPTION: MSG from Warren Wright about large numbers of DEVICE LOCK bulletins sent when someone leans on keyboard. NOIS MCM-1195-51490 That the DEVICE LOCK bulletins aren't much help. NOIS CLE-1095-43605 The check if a user needed to be deactivated was counting 'Keep at Terminate' keys even though they would never be removed. NOIS MAC-0696-61616 WBP-1195-20971 CTX-0896-71639 The check to close hung SPOOL documents had an incorrect test. NOIS SEP-0796-62056 The purge option was failing to get any site data from the Kernel System Parameter file. It was looking at the wrong node. NOIS NOL-0796-70230 If the data in the spool file was longer than 255 characters, it would cause an error in %ZIS4 on DSM systems. This has been fixed but the report may not print the way it would have if sent directly to the printer. NOIS WBP-0796-20862 When the number of spool documents is checked, only those with data are counted. This is changed to count all spool documents with or without data. E3R -- Request for a way to have the current date as part of a auto generated name (GENERATE SPL DOC NAME). Now if the device named includes "|DT|" that string will be replaced with the current date. E3R 8844 To include Person class in the User Inquiry. NOIS IVM-1095-32452 Sometimes taskman doesn't release devices when it should. NOIS NOL-0996-70063 At a dual-TaskMan site there is problem starting tasks on the working node. The TaskMan part of the patch was developed to address problems at dual-TaskMan sites after the install of patch 24. It is unclear exactly what the problem was, but with load-balancing, work would back up. There is a new algorithm to start new submanagers and when submanagers should exit. We try and keep the number of submanagers at a level equal to a: the number of devices in the IO list; b: The MIN SUBMANAGER CNT. All submanagers will remain if the JOB list has any tasks in it. ----- This patch adds two new fields to the TaskMan site parameter file (14.7): (1), MIN SUBMANAGER CNT, allows a site to set a lower limit on the number of submanagers to keep around. (2), TM MASTER, is only used when a volume set is mounted on another but shares the library account. This is a pointer back to file 14.7 and would point to the entry that is the control entry for TaskMan on that node. Local MSG #1082921 DIC error in Add a New User. Problem in the page numbering of the new FORM for Add a New User and SECONDARY MENUS. Sending out all three FORMs with unified page numbering. NOIS MAD-0895-40177 Some sites have some leftover nodes in the Institution file. Collect more data in the standard error trap. In patch 24 $X was set to zero before doing the close execute code. This was changed to check if $X>0 and to set it to 1 so that code (like P-MESSAGE) that test $X would still work. If some package was installed after Kernel 8, the "ID" nodes on the NEW PERSON file got changed back to an early version. Nodes are reset. NOIS IND-0996-41382 Changes to FTG^%ZISH made in XU*8*24 didn't work for input like S Y=$$FTG^%ZISH("","TEST.DAT",$NA(OUT(0)),1) it did work fine on S Y=$$FTG^%ZISH(""<"TEST>DAT",$NA(^TMP("XX",$J,0)),3). Fixed. Various requests to bring back ZTMGRSET. This new version will load all routines if called from the top, or only the routines with a given patch number if called at RELOAD^ZTMGRSET. NOIS BRK-1096-12512, CHW-0996-42161 While testing changes to %ZTER for use with the new error trap we got ECODE errors under some conditions. This has been fixed with a small change to $ZTER. Routine CheckSum 2nd Line XUINPCH 1467475 ;;8.0;;KERNEL;**20,36**;Feb. 9, 1996 XUSTERM 14380010 ;;8.0;KERNEL;**36**;Jul 10, 1995 XUSTZ 3010944 ;;8.0;KERNEL;**36**;Jul 10, 1995 XUTMUSE2 13026855 ;;8.0;KERNEL;**36**;Jul 10, 1995 ZIS3 6450084 ;;8.0;KERNEL;**18,36**;JUL 10, 1995 ZIS4MSM 6649854 ;;8.0;KERNEL;**23,36**;JUL 03, 1995 ZIS4VXD 8342152 ;;8.0;KERNEL;**23,36**;JUL 03, 1995 ZISC 8463272 ;;8.0;KERNEL;**24,36**;JUL 10, 1995 ZISHMSM 5354551 ;;8.0;KERNEL;**24,36**;JUL 10, 1995 ZISHVXD 7245146 ;;8.0;KERNEL;**24,36**;JUL 10, 1995 ZISPL1 8550686 ;;8.0;KERNEL;**23,36**;Jul 10, 1995 ZISPL2 4088281 ;;8.0;KERNEL;**23,36**;Jul 10, 1995 ZISTCP 1828160 ;;8.0;KERNEL;**36**;Jun 02, 1994 ZTER 18736553 ;;8.0;KERNEL;**8,18,32,24,36**;JUL 10, 1995 ZTER1 5603505 ;;8.0;KERNEL;**18,24,36**;JUL 10, 1995 ZTM 7805017 ;;8.0;KERNEL;**24,36**;JUL 10, 1995 ZTM0 5563711 ;;8.0;KERNEL;**42,36**;JUL 10, 1995 ZTM5 3748675 ;;8.0;KERNEL;**24,36**;JUL 10, 1995 ZTMGRSET 12724965 ;;8.0;KERNEL;**36**;Dec 30, 1993 ZTMON1 7519989 ;;8.0;KERNEL;**36**;Jul 10, 1995 ZTMS 5200197 ;;8.0;KERNEL;**2,18,24,36**;Jul 10, 1995 ZTMS1 6210144 ;;8.0;KERNEL;**36**;JUL 10, 1995 ZTMS2 5283853 ;;8.0;KERNEL;**2,18,23,36**;Jul 10, 1995 ZTMS3 9454395 ;;8.0;KERNEL;**1,18,36**;Jul 03, 1995 ***************************************************************************** PROBLEMS FIXED BY VA PATCH XU*8.0*56 SEQ #43 -------------------------------------------------------------------------- TYPE: SINGLE PACKAGE PROBLEMS FIXED BY VA PATCH XU*8.0*56 SEQ #43 -------------------------------------------------------------------------- TYPE: SINGLE PACKAGE NATIONAL PACKAGE: KERNEL DESCRIPTION: This patch adds changes and enhancements to the Unwinder (XQOR*) in support of the Text Integration Utilities (TIU) package. These changes include: 1) the ability to programmatically change the menu passed to XQOR 2) some modifications to the response time monitoring calls 3) the suppression of linefeeds when XQORM is called non-interactively 4) the ability to map numeric input to a protocol that should be run 5) the storage of HL7 messages in ^TMP to free up partition space *************END OF DESCRIPTION FOR PATCH XU*8.0*1001********************