Delphi 7
Visibroker 4.5 Update
Release Notes


=======================================================

This file contains important supplementary and late-
breaking information that may not appear in the main
product documentation, and supersedes information
contained in other documents, including previously
installed release notes, that accompany this product.
We recommend that you read this file in its entirety.

Important:

 Delphi must be closed before installing this Update
 Pack.


=======================================================
CONTENTS
* ABOUT VISIBROKER 4.5
* ISSUES ADDRESSED IN THIS UPDATE PACK
* INSTALLATION INSTRUCTIONS
* FILES INCLUDED WITH THIS UPDATE

=======================================================
ABOUT VISIBROKER 4.5

VisiBroker 4.5, CORBA, and IDL-TO-PAS
-------------------------------------

VisiBroker 4.5 lets you create CORBA clients and
servers that can interoperate with other CORBA
applications written in C++ and Java. The product
includes an IDL-to-Pascal compiler capable of compiling
CORBA IDL into Delphi Pascal stub and skeleton code,
and the associated runtime library required to
interface between this code and the VisiBroker 4.5 C++
ORB. This implementation supports simple and complex
data types in IDL, along with callbacks, the COSNaming
Service and the COSEvent Service.

Many examples are provided to illustrate the different
features of the VisiBroker 4.5 for Delphi
implementation. These examples are located in your
Delphi7/Demos/Corba/IDL2PAS directory.

IDL-to-Delphi Pascal Language Mapping is specified in
the VisiBroker 4.5 for Delphi manual (installed
on your Companion CD). The manual is in PDF format; a
viewer is also provided.

CORBA compatibility notes
-------------------------

The TypeLib interface Export option, TCorbaConnection,
CorbaDataModule, and CorbaObject components have been
removed from Delphi. They were based on VisiBroker 3.3
Orb, which is no longer shipped with Delphi. 

To convert a VisiBroker 3.3 tlb file to a CORBA IDL file, 
use the tlibimp utility from the command line, for example:

C:\ *SomePath* >tlibimp -Ic+ MyTLBFile.tlb

Tlibimp generates the following files: 

 * MyTLBFile_TLB.dcr
 * MyTLBFile_TLB.pas
 * MyTLBFile.idl  

Next, choose File | New | Other and click the Corba tab 
to access either the CORBA Client or Server wizard. 
Specify the newly created IDL file in the wizard to generate
the stubs and skeletons. Now transfer the function code from the 
VisiBroker 3.3 application to the new VisiBroker 4.5 application.

The CORBA wizards are compatible with VisiBroker 4.1 
and VisiBroker 4.5.

All of the functionality to recreate the removed components
is still available in Delphi 7, however, you will need to 
create your own wrappers. For a code example that uses CORBA 
and Midas WITHOUT using the removed components, see Midas XML in the 
following directory: 

C:\Program Files\Borland\Delphi7\Demos\Corba\IDL2PAS 

=======================================================
ISSUES ADDRESSED IN THIS UPDATE PACK

This update resolves the following VisiBroker issues:

 * Memory leak in marshaling Corba calls.
 * IsMultiThreaded is defaulted to True.
 * Deadlock situation in Orbpas45.dll.
 * Memory leak in Variant to ANY conversion.

=======================================================
INSTALLATION INSTRUCTIONS

There are two ways to install these files.  The most
common method replaces files for all Delphi 7 Corba
projects. The other method replaces files for an
individual project. Directions for both methods are 
provided below.

The patch files need to be extracted into a temporary
directory. Open the Zip file using WinZip, UnZip or another Zip file
extraction utility. Next, extract the files to a newly created
or existing temporary directory.

To patch all Delphi 7 Corba projects:
    
  1. Replace the .Pas files in the following directory 
     with .Pas files from the temporary directory.

     C:\Program Files\Borland\Delphi7\Source\Rtl\Corba45

  2. Replace the .Dcu files in the following directories 
     with the .Dcu files from the temporary directory.

     C:\Program Files\Borland\Delphi7\Lib\Debug
     C:\Program Files\Borland\Delphi7\Lib\IDL45 

  3. Replace the OrbPas45.dll file in the following directory
     with the file from the temporary directory.

     C:\Program Files\Borland\Delphi7\Bin

To patch an individual Delphi 7 Corba project:

  1. Copy the .Pas files from the temporary directory to
     the project directory.

  2. Perform a Build All Projects from the Delphi menu.
     
  3. Replace the OrbPas45.dll file in the following directory
     with the file from the temporary directory.

     C:\Program Files\Borland\Delphi7\Bin
 
======================================================
FILES INCLUDED IN THIS UPDATE

 * OrbPas45.dll
 * Corba.pas
 * OrbPas45.pas
 * CosEvent.pas
 * CosNaming.pas
 * Corba.dcu
 * OrbPas45.dcu
 * CosEvent.dcu
 * CosNaming.dcu

=======================================================
Copyright (c) 2002 Borland Software Corporation.
All rights reserved.










