XWB*1.1*9 (2685)    BUILD (9.6)

Name Value
NAME XWB*1.1*9
DATE DISTRIBUTED 2000-01-07 00:00:00
PACKAGE FILE LINK RPC BROKER
REQUIRED BUILD
  • XU*8.0*118
    ACTION:   Don't install, leave global
  • XWB*1.1*6
    ACTION:   Don't install, leave global
  • XWB*1.1*7
    ACTION:   Don't install, leave global
TYPE SINGLE PACKAGE
DESCRIPTION OF ENHANCEMENTS
This patch fixes the following: 
for starting Broker listeners.
                 Checksum
Routine         Old       New      2nd Line
XWBTCP        9081629  10677300    **1,9**
XWBTCPC       7635440   7568523    **2,5,4,6,9**
XWBTCPL       8850625   8934371    **1,7,9**
 
List of preceding patches: 6, 7
Sites should use CHECK^XTSUMBLD to verify checksums.
 
=========================================================================
 
 
Installation:
 
   1.  Do not run any RPC-Broker-based Client/Server software (e.g., CPRS,
       PCMM) during the installation.  No Broker-based client/server 
       software should be running while installing this patch on the 
       server.  To identify these jobs, check the system status and verify
       if any XWBTCPC routines are running (i.e., Broker Handler).  Once 
       identified, notify users to logoff or forcex the jobs.  Active 
       users may get NOSOURCE or CLOBBER errors.  
These changes fulfill the functionality requested in the following E3Rs:
 
   2.  Stop the Broker Listener on the server.  Check the system status 
       and verify if the XWBTCPL routine is running (i.e., Broker 
       Listener).  If it is running stop it.  To stop the Listener, do the
       following: 
 
           a.  Log into your M server.                   
           b.  Enter the following at the M prompt: 
 
               >D STOP^XWBTCP(Listener port) 
    11934, RPC BROKER FILE SHOWS RUNNING ON OPENM FAILOVER
               (Typically, the Listener port is 9200) 
 
   3.  Broker routines are not usually mapped on systems that allow it, so
       you will probably not have to disable mapping.
 
   4.  Use the 'INSTALL/CHECK MESSAGE' option on the PackMan menu. This
       option will load the KIDS package onto your system.
 
   5.  The patch has now been loaded into a Transport global on your
       system. You now need to use KIDS to install the Transport global.
    10705, LISTENERS NOT STOPPED WILL NOT START UP
       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
 
   6.  On the KIDS menu, under the 'Installation' menu, use the following
       option:
     8789, CREATE MENU STARTUP AND SHUTDOWN OPTIONS
         Install Package(s)  'XWB*1.1*9'
                              =========
       No Options or Protocols need to be placed out-of-order.
       Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO
                                                                       ==
 
   7.  If the routines were unmapped as part of step 3, the mapped set
       should be rebuilt once the installation has run to completion. 
 
   8.  Restart the Broker Listener on the Server:
 
         a.  Log into your M server
         b.  Enter the following at the M prompt:
 
             >D STRT^XWBTCP(Listener port)
             (Typically, the Listener port is 9200)
The changes also resolve the problems reported in the following NOIS
calls:
    DAY-0796-40646, Startup Queue of Listener
 
    FRE-0299-60491, Broker Not Starting Automatically
 
Here are the definitions of the options:
 
NAME: XWB LISTENER STARTER      MENU TEXT: Start All RPC Broker Listeners
  TYPE: run routine                     CREATOR: 
  PACKAGE: RPC BROKER                   DELEGABLE: YES
 DESCRIPTION:   This option will Start/Restart all the RPC Broker
listeners under the control of the RPC BROKER SITE PARAMETERS file.  It is
normally setup as a STARTUP type option in the taskman option scheduling
1.  Intersystems License.    This is the patch that works with patch
file. This option will first STOP ALL listeners and then START ALL the
listeners through Taskman.  (VMS sites need to be running Taskman in DCL
context).  The XWB LISTENER STARTER cannot be used to start one particular
listener.  To do this, in programmer mode, use STRT^XWBTCP(portnumber) on
the node the listener needs to run on. Or use the XWB LISTENER EDIT option
to change the status of the one listener.
  ROUTINE: RESTART^XWBTCP               SCHEDULING RECOMMENDED: STARTUP
  UPPERCASE MENU TEXT: START ALL RPC BROKER LISTENERS
 
NAME: XWB LISTENER STOP ALL       MENU TEXT: Stop All RPC Broker Listeners
XU*8*118. The code to share licenses when GUI and Telnet users from the
  TYPE: run routine                     CREATOR: 
  PACKAGE: RPC BROKER                   DELEGABLE: YES
 DESCRIPTION:   This option will Stop all the RPC Broker listeners under
the control of the RPC BROKER SITE PARAMETERS file.
  ROUTINE: STOPALL^XWBTCP
  UPPERCASE MENU TEXT: STOP ALL RPC BROKER LISTENERS
 
3.  The code called by the XWB LISTENER STARTER option had a bug that
caused it to start the listeners on the default port of 9000.  This
problem is fixed.  The following NOIS calls reported the bug.
same workstation are connected is in place and ZU now calls it.  This
              
    BEC-0999-21188   XWB  LISTENER STARTER 
    STX-0999-71581   BROKER STARTING 9000 IGNORING PARAME 
 
4.  A new menu option, XWB MAIN MENU, is included in this patch.  Another
option, XWB LISTENER EDIT, is also included.  Here are the option
definitions:
 
NAME: XWB MENU                     MENU TEXT: RPC Broker Management Menu
  TYPE: menu                            CREATOR: 
patch adds a similar call from XWBTCPC.  
  PACKAGE: RPC BROKER                   DELEGABLE: NO
 DESCRIPTION:   This is the main menu for RPC Broker.  
ITEM: XWB LISTENER STOP ALL             DISPLAY ORDER: 3
ITEM: XWB LISTENER EDIT                 DISPLAY ORDER: 1
ITEM: XWB LISTENER STARTER              DISPLAY ORDER: 2
  TIMESTAMP: 58079,48431
  UPPERCASE MENU TEXT: RPC BROKER MANAGEMENT MENU
 
NAME: XWB LISTENER EDIT                 MENU TEXT: RPC Listener Edit
  TYPE: edit                            CREATOR:
              
  PACKAGE: RPC BROKER                   DELEGABLE: NO
 DESCRIPTION:   This option allows for editing the RPC BROKER SITE
PARAMETERS file (#8994.1).
  DIC {DIC}: XWB(8994.1,                DIC(0): AEMQ
  DIE: XWB(8994.1,                      DR {DIE}: [XWB LISTENER EDIT]
  TIMESTAMP OF PRIMARY MENU: 58078,56469
  UPPERCASE MENU TEXT: RPC LISTENER EDIT
 
             <<<<<<THIS IS A SERVER SIDE ONLY PATCH>>>>>>
 
2.  This patch brings a new XWB LISTENER STOP ALL option for shutting down
The updated Broker Systems Manual and the Broker Technical Manual may be
retrieved at the following CIO Field Offices' ANONYMOUS.SOFTWARE
directories:
 
        Hines           152.129.1.110  (isc-chicago.domain.ext)
        Albany          152.127.1.5    (isc-albany.domain.ext)
        Salt Lake City  152.131.2.1    (isc-slc.domain.ext)
 
Use Binary mode for these .PDF files:
 
multiple listeners.  It also brings a modified option XWB LISTENER STARTER
XWB1_1P9SM.PDF          Broker Systems Manual           See patch desc.
XWB1_1P9TM.PDF          Broker Technical Manual         See patch desc.
 
Routine Summary:
================
 
The following routines are included in this patch.  The second line of each
of these routines now looks like:
 ;;1.1;RPC BROKER;<patchlist>;Mar 28, 1997
 
TRACK PACKAGE NATIONALLY YES
FILE
  • UPDATE THE DATA DICTIONARY:   YES
    SEND SECURITY CODE:   YES
    SEND FULL OR PARTIAL DD:   FULL
    DATA COMES WITH FILE:   NO
BUILD COMPONENTS
  • ENTRIES:
  • ENTRIES:
    • XWB LISTENER STARTER
      ACTION:   SEND TO SITE
    • XWB LISTENER STOP ALL
      ACTION:   SEND TO SITE
    • XUSITEMGR
      ACTION:   USE AS LINK FOR MENU/ITEM/SUBSCRIBERS
    • XWB LISTENER EDIT
      ACTION:   SEND TO SITE
    • XWB MENU
      ACTION:   SEND TO SITE
  • ENTRIES:
    • XWBTCPC
      ACTION:   SEND TO SITE
      CHECKSUM:   B35015117
    • XWBTCP
      ACTION:   SEND TO SITE
      CHECKSUM:   B51021435
    • XWBTCPL
      ACTION:   SEND TO SITE
      CHECKSUM:   B30173303