| DESCRIPTION OF ENHANCEMENTS |
This patch:
during login.
Broker Installation Guide to install the server portion of this patch. The
instructions in the Installation Guide are for virgin server installations
and server version upgrades only.
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 routine is
running (i.e., Broker Handler). Once identified, notify users to logoff
or forcex the jobs. Active users may get NOSOURCE or CLOBBER errors.
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)
(Typically, the Listener port is 9200)
2. Updates the Broker's programmer client workstation software -- also
3. These 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 (Kernel Installation and Distribution System)
package onto your system.
5. The patch has now been loaded into a Transport global on your system.
On the KIDS menu, select the 'Installation' menu, use the following
options:
known as the Broker Development Kit (BDK) -- adding support for Delphi 4
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:
Install Package(s) 'XWB*1.1*4'
=========
development.
7. MSM Sites - Answer YES to the question 'Want to MOVE routines to
other CPUs?'. Enter the names of your Compute and Print server(s).
AXP Sites - Answer NO to this question.
8. If the routines were unmapped as part of step 3, the mapped set
should be rebuilt once the installation has run to completion.
9. 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)
Client Side:
============
Please follow the 'Programmer Client Workstation Installation
Instructions' in the RPC Broker Installation Guide (XWB1_1P4IG.PDF).
3. Fixes a bug in which the title bar of the Kernel login form was being
changed when a user started entering their access code.
IMPORTANT NOTES:
This patch consists of 2 parts:
- Packman message containing the XWB*1.1*4 KIDS build.
- An updated BDK (programmer client workstation software).
1. Packman message containing the XWB*1.1*4 KIDS build. It installs 2
modified XWB* routines used by the Broker server. This part of the patch
is mandatory.
1. Introduces a shorter timeout when logging in via any GUI application
ROUTINE SUMMARY:
================
The following is a list of the routines included in this patch. The
second line of each of these routines now looks like:
<tab>;;1.1;RPC BROKER;[patch list];date
CHECK^XTSUMBLD results:
Routine Name Before Patch After Patch Patch List
that is using the Broker. The server listener process will timeout after
XWBBRK 4562161 4567623 2,4
XWBTCPC 8239171 7518635 2,5,4
2. Updated BDK (programmer client workstation software). All sites
doing Broker development are encouraged to retrieve the patched BDK. Note
that this version of the BDK only supports Delphi 4 and Delphi 3.
DO NOT INSTALL THIS PROGRAMMER CLIENT WORKSTATION SOFTWARE AT
END-USER CLIENT WORKSTATIONS. If you are not using the BDK in any local
or national development, you do not need to retrieve the Broker's
90 seconds if the user has not passed in his/her access and verify codes.
programmer client workstation software. The software does not update the
Broker software that is running at end-user client workstations.
The software distribution includes:
FILE NAMES DESCRIPTION Blocks Bytes
XWB1_1P4PG.EXE BDK Self-Installing Executable 2944 1507118
XWB1_1P4IG.PDF Installation Guide 382 195583
XWB1_1RM.TXT Readme text file 15 7355
Users of existing GUI applications which were compiled under an older
Note: Use Binary mode for .PDF, and .EXE files
Use ASCII mode for .TXT file.
To access the updated BDK, use FTP to retrieve the software from one of
the following CIO Field Offices' ANONYMOUS.SOFTWARE directories:
CIO FIELD OFFICE FTP Address
Hines 152.129.1.110
Albany 152.127.1.5
Salt Lake City 152.131.2.1
version of the BDK will not see the shorter timeout unless the GUI
BROKER-DEPENDENT COMPONENTS:
Some components, such as the FileMan Delphi Components, reference the
TRPCBroker component. If you use such components for development, be
aware that installing a new version of the TRPCBroker component (i.e. a
new BDK) may cause incompatibilities in Delphi, resulting in a compile
failure of the unit containing the Broker-dependent component and the
following compilation error:
application is recompiled. It is highly recommended that applications be
Unit <unit1> was compiled with a different version of <unit2>.
Check with the creators of the Broker-dependent component to make sure
that, with regards to the version of the BDK you are about to install:
a) Your current component is compatible, or
b) You can obtain a new version of the component that is compatible.
For the FileMan Delphi Components (FMDC), patch FMDC*1.0*1 brings in a new
recompiled using the new BDK to take advantage of the shorter timeout
version of FMDC compatible with the updated BDK. Please refer to the
Patch Module for more information on this FMDC patch.
INSTALLATION:
Server Side:
============
Use the following instructions in installing this server-side RPC Broker
patch. Do NOT follow the M Server Installation Instructions in the RPC
|