XU*8.0*173 (4200)    BUILD (9.6)

Name Value
NAME XU*8.0*173
DATE DISTRIBUTED 2002-04-09 00:00:00
PACKAGE FILE LINK KERNEL
TYPE SINGLE PACKAGE
DESCRIPTION OF ENHANCEMENTS
** WARNING ** WARNING ** WARNING ** WARNING ** WARNING ** WARNING **
--------------------------- End of Warning -------------------------
 XQALERT1       30893715       30919356    **20,65,114,123,125,164,173**
 XQALSET        14823261       15152866    **1,6,65,75,114,125,173**
 XQALSURO        7933100       12681484    **114,125,173**
 XQAL173P            N/A         304597    **173**
 
List of preceding patches: 125,164
 
 
Blood Bank Team Coordination:
=============================
 
Clearance - 04/05/2002
 
 
Installation Instructions:
 
     1.   Users ARE allowed to be on the system during the
     installation but if you have not recently run a scheduled purge of
     old alerts you may want to schedule the installation for off hours.
 
     2.   DSM sites - Some of these routines are usually mapped,
1. Surrogates for processing alerts may have an end date and time for the
     so you will need to disable mapping for the affected routines.
 
     3.   Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu.
     This option will load the KIDS (Kernel Installation and Distribution
     System) package onto your system.
 
     4.   You DO NOT need to stop TaskMan or the background filers.
 
     5.   The patch has now been loaded into a transport global on your
     system.  On the KIDS menu, select the 'Installation' menu and use
surrogate relationship.  The actual removal of the surrogate has been
     the following options:
           Verify Checksums in Transport Global
           Print Transport Global
           Compare Transport Global to Current System
           Backup a Transport Global
           Return to Programmers Prompt and use "D ^XPDKRN":
           Select KIDS OPTION: Install
                               =======
            Install Package(s)
            Select INSTALL NAME: XU*8.0*173
performed when the next alert was sent to an individual.  This resulted,
                                 ==========
 
            Checking Install for Package XU*8.0*173
 
            Install Questions for XU*8.0*173
 
            Incoming Files:
 
 
               8992      ALERT  (Partial Definition)
however, in the user still appearing to have a surrogate after the
            Note:  You already have the 'ALERT' File.
 
            Want KIDS to Rebuild Menu Trees Upon Completion of Install? 
YES// NO
      ==
            Want KIDS to INHIBIT LOGONs during the install? YES// NO
                                                                  ==
            Want to DISABLE Scheduled Options, Menu Options, and 
Protocols? YES// NO
                 ==
stated end time if another user tried to set them as their surrogate.
 
     6.  AXP Sites - Answer 'NO' to the question 'Want to MOVE
     routines to other CPUs?'.
 
     7.  If the routines were unmapped as part of step 2, they should be
     returned to the mapped set once the installation has run to
     completion.
This patch modifies the processing so that the removal of the specified
surrogate happens on any surrogate related look-up after the specified end
time.  This will correct the problem that had been reported (E3R #14940).
 
 
2. Code has been modified to correct problems identified with setting
surrogates (BRX-1000-10427, COS-0401-41366, WRJ-1201-11337).
 
3. The problem indicated as a mismatch in XQAID values (ISL-0200-52883) is
handled by a re-indexing of the "B" cross-reference in FILE: ALERT
TRACKING (#8992.1) in the post-installation routine.
 
4. A small change was made in XQALERT to clarify the way in which alerts
are referenced from the menu system (ISL-0898-51279) and to correct a
If your site does not purge old alerts the post install routine,
potential problem with matching the "B" cross-reference in FILE: ALERT
TRACKING (#8992.1).
 
5. A cross-reference was added to FIELD: SURROGATE (#.02) of FILE: ALERT
(#8992) to permit rapid lookup of users who have specified a selected user
as their surrogate (E3R #15158).  This is made available via the "XQAL
SURROGATE FOR WHICH USERS" (View Surrogate for Which Users) option on the
XQALERT MGR menu.  The supported reference API SUROFOR^XQALSURO has been
added for other applications to access this data.
 
which reindexes the "B" cross-reference of the FILE: ALERT TRACKING
    D SUROFOR^XQALSURO(.LIST,USERDUZ)
 
will return data in the variable LIST.  The value of LIST indicates the
number of entries returned.  The array list will return the users DUZ
value in file 200 and the NAME (.01) field from file 200 separated by an
'^'.
      LIST = 3
      LIST(1) = "54^LNAME1,FNAME1"
      LIST(2) = "75^LNAME2,FNAME2"
      LIST(3) = "247^LNAME3,FNAME3"
(# 8992.1), may take considerably longer than would be the case if you
 
The post-install routine, XQAL173P, also builds the cross-reference for
current surrogates.  This routine is set to be removed following the
installation.
 
6. In addition, it was noted that while interactive specification of a
surrogate checked for cyclic relationships among surrogates, the API for
non-interactive setting of a surrogated (SETSURO^XQALSURO) simply set the
specified surrogate.  While this API can continue to be used, a new API
(SETSURO1^XQALSURO) has been created which should be used to obtain a
regularly purge.  In that case, you will want to schedule the
return value (1 if successful, 0 if not successful) indicating whether the
surrogate could be set.
 
  S VAL=$$SETSURO1^XQALSURO(USERDUZ,SURODUZ,STRTDATE,ENDDATE)
 
 
Where USERDUZ and SURODUZ are the internal entry numbers in file 200 for
the user and selected surrogate, respectively.  STRTDATE and ENDDATE are
optional date/time values for when the surrogate relationship should
start and end.  If STRTDATE is not specified, the surrogate becomes active
installation so the post installation routine may run on a weekend or
immediately.  If ENDDATE is not specified, the surrogate remains active
until another surrogate is specified or the surrogate is removed.
 
 
List of Test Sites
==================
BATTLE CREEK, MI                                      
CHARLESTON, SC                                      
CHICAGO HCS                                      
LEXINGTON, KY                                      
overnight.
NORTHERN CALIFORNIA HCS                                      
SAN FRANCISCO, CA                                      
SPOKANE, WA                                      
WEST PALM BEACH, FL                                      
 
 
Routine Summary:
================
The following routines are included in this patch.  The second
line of each of these routines now looks like:
 
 
     <tab>;;8.0;KERNEL;**[patch list]**;Jul 10, 1995
 
Checksums:
==========
Checksums obtained using CHECK^XTSUMBLD
 
 Rtn Nm    Chksum Before   Chksum After    Patch List
 ------    -------------   ------------    ----------
 XQALERT         5402974        5560549    **1,65,125,173**
TRACK PACKAGE NATIONALLY YES
FILE
  • DD NUMBER:
    • ALERT (File-top level)
      FIELD NUMBER:
      • SURROGATE FOR ALERTS
    UPDATE THE DATA DICTIONARY:   YES
    SEND SECURITY CODE:   NO
    SEND FULL OR PARTIAL DD:   PARTIAL
    DATA COMES WITH FILE:   NO
BUILD COMPONENTS
  • ENTRIES:
    • XQAL SURROGATE FOR WHICH USERS
      ACTION:   SEND TO SITE
    • XQALERT MGR
      ACTION:   USE AS LINK FOR MENU/ITEM/SUBSCRIBERS
  • ENTRIES:
    • XQALERT
      ACTION:   SEND TO SITE
      CHECKSUM:   B10361228
    • XQALSURO
      ACTION:   SEND TO SITE
      CHECKSUM:   B37867317
    • XQALERT1
      ACTION:   SEND TO SITE
      CHECKSUM:   B75411856
    • XQALSET
      ACTION:   SEND TO SITE
      CHECKSUM:   B29655829
POST-INSTALL ROUTINE XQAL173P
DELETE POST-INIT ROUTINE Yes