Delphi 7

Release Notes

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

This file contains important supplementary and late-

breaking information that may not appear in the main
product documentation. We recommend that you read this
file in its entirety.

For information on new features in this release, choose

"What's New" in the online Help contents.

=======================================================
CONTENTS

* OTHER RELEASE NOTES INCLUDED WITH THIS PRODUCT

* NOTES AND ISSUES:
* ABOUT EDITING THE REGISTRY
* PRODUCT INFORMATION ON THE WEB

=======================================================
OTHER RELEASE NOTES INCLUDED WITH THIS PRODUCT

* INSTALL contains system requirements and product

installation information.

* DEPLOY contains information about redistributing your

applications.

* LICENSE contains information on licensing allowances

and limitations for this product and other Borland
software that is bundled with it.

The three files listed above, along with this file,

are installed in your main product directory
(default: C:\Program Files\Borland\Delphi7).

=======================================================
NOTES AND ISSUES

Deprecated Components

Borland is deprecating the use of TSQLClientDataSet

and TBDEClientDataSet. Borland recommends that you
use TSimpleDataSet for simple, two-tier
applications. TSQLClientDataSet and
TBDEClientDataSet are no longer displayed on the
Component palette. If you require backward
compatibility, you can still access
TSQLClientDataSet and TBDEClientDataSet in the
Demos directory (by default, C:\Program
Files\Borland\Delphi7\Demos).
 Borland is deprecating the use of the TServerSocket
and TClientSocket from the unit ScktComp. It is
recommended that you use the Indy components for
socket operations. The TServerSocket and
TClientSocket will no longer be installed on the
component palette by default. If you require the
use of these components then you can install
the design time package named dclsockets70.bpl,
found in your bin directory. For deployment with
runtime packages, you will need to deploy rtl70.bpl
and any other required packages.

Changes in StrUtils
-------------------

The StrUtils unit contains three sets of changes, all

relating to
multi-byte character set (MBCS) support.

* Previously, LeftStr, RightStr, and MidStr each

took and returned AnsiString values, and did not
support MBCS strings. Each of these functions has
been replaced by a pair of overloaded functions,
one that takes and returns AnsiString, and one
that takes and returns WideString. The new
functions correctly handle MBCS strings. This
change breaks code that uses these functions to
store and retrieve byte values in AnsiStrings.
Such code should use the new byte-level functions
described below.

* New functions LeftBStr, RightBStr, and MidBStr

provide the byte-level manipulation previously
provided by LeftStr, RightStr, and MidStr.

* New functions AnsiLeftStr, AnsiRightStr, and

AnsiMidStr are the same as the new AnsiStr
LeftStr, RightStr, and MidStr functions, except
that they are not overloaded with equivalent
WideString functions.

XP Themes
---------

This build does not include a manifest for your

projects. To tell your applications to use version 6.0
of comctl32.dll you need to create and edit the
manifest yourself.

There are two ways to do this:

1. With a stand-alone manifest file added to the same

directory of the executable.
2. With a manifest included in the executable as a
resource.

For the stand-alone manifest follow these steps:

I) Using Notepad create a file called

"Project1.exe.manifest" and add the following lines:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<assembly xmlns="urn:schemas-microsoft-com:asm.v1"
manifestVersion="1.0">
<assemblyIdentity
processorArchitecture="*"
version="1.0.0.0"
type="win32"
name="Project1"/>
<description>Project1 Description</description>
<dependency>
<dependentAssembly>
<assemblyIdentity
type="win32"
name="Microsoft.Windows.Common-Controls"
version="6.0.0.0"
publicKeyToken="6595b64144ccf1df"
language="*"
processorArchitecture="*" />
</dependentAssembly>
</dependency>
</assembly>

II) Save the file and place it in the same directory as

the application executable.

If you don't like the idea of having the manifest as a

separated file you can include it into your executable
as a resource.

I) Create a resource file (again using Notepad)

containing the following line:

1 24 "Project1.exe.Manifest"

II) Compile the resource file with brcc32.exe with the

following command:

C:\Project1> brcc32 WindowsXP.RC

III) Now add the following line to your project's main

form:

{$R WindowsXP.RES}

NOTE: To automatically configure XP Themes in your

project you can use the XP Application Wizard
demo. For more information see the readme file in
 Demos\ToolsAPI\XPAppWiz

.NET compiler warnings

----------------------

The Delphi 7 dcc32 compiler now supports three

additional compiler warnings: Unsafe_Type,
Unsafe_Code, and Unsafe_Cast. These warnings are
disabled by default, but can be enabled with source
code compiler directives {$WARN UNSAFE_CODE ON},
compiler command line switches (dcc32 -W+UNSAFE_CODE),
and in Project|Options.

NOTE: There is no space before or after the "+" in the

command line switch)

"Unsafe" in all three messages refers to types or

operations which static code analysis cannot prove to
not overwrite memory. For example, data types that
carry bounds information at runtime such as Delphi
Strings or dynamic arrays can be bounds-checked at
runtime, and tracked in static analysis, to ensure that
memory accesses are within the limits of the allocated
data. Data types that do not carry bounds information
at compile time or runtime (such as PChar) cannot be
proven safe. Unsafe doesn't necessarily mean the code
is broken or flawed, it simply means that it uses
programming techniques that cannot be verified as safe
by static code analysis. In a secured execution
environment such as .NET, such code is assumed to be
unsafe and a potential security risk.

Delphi 7 developers can use these new warnings to

identify data types, code or programming techniques
that may be difficult to port to a managed code
environment such as .NET. These messages are not
specific to the .NET platform. The warnings are
conservative - some things we warn about in D7 we might
actually be able to support in Delphi for .NET, but
we're not sure yet. The warnings are not complete -
there may be problematic types or code situations for
which the Delphi 7 compiler does not issue an unsafe
warning.

Unsafe_Type: Types such as PChar, untyped pointer,

untyped var and out parameters, file of <type>, 6 byte
reals (Real48), variant records (records containing
overlapping fields) and old-style objects

("TMyObject = object").

* "old" object type

c = object
i: Integer;
 procedure p;
end;

Unsafe_Code: absolute variables, Addr(), Ptr(), Hi(),

Lo(), Swap() standard procedures, BlockRead and
BlockWrite, the Fail() standard procedure, GetMem(),
FreeMem(), and ReallocMem()

* inline assembler blocks (asm end)

* @ operator
* modifying string index elements, e.g

s := 'Hoho';
s[2] := 'a'; // <-- "Unsafe code 'String index to
var param'"

Unsafe_Cast: Casting an object instance to a type that

is not an ancestor or descendent of the instance type,
casting a record type to anything else

Change to VCL SubComponents streaming

-------------------------------------

In Delphi 7, we corrected a problem where the csLoading

flag was never set for subcomponents, nor was the
subcomponent's Loaded method called. When a component that
has subcomponents is streamed, the subcomponents will have
their csLoading flag set and their Loaded method called.
This change creates a complication for any subcomponent
properties that are writable. If you allow your
subcomponent property to be assigned to an external
component reference then you cannot free your subcomponent
until it's owner's Loaded method is called otherwise the
streaming system will attempt to call the subcomponent's
Loaded method after the subcomponent has been freed.

Apache
------

Support for Apache 2 is for the 2.0.39 version. It will

work with later versions as long as they are binary
compatible.

NOTE: Due to a known bug with Apache 1.3.22, do not

develop CGI programs or shared objects for this
version.

See http://bugs.apache.org/index.cgi/full/8538

UDDI Registry entries

---------------------

Some UDDI Registry entries contain an Accesspoint URL with

a bookmark tag at the end. When accessed these services
often generate the error message 'Method not allowed
(405)'.

Workaround:

Remove the tag from url in the global function

that returns the Interface:

const
// defURL = 'http://someservice/somewhere#tag';
// is changed to

defURL = 'http://someservice/somewhere';

Japanese Input system on Windows XP

-----------------------------------

The MS IME2002 Japanese input system included with

Windows XP can cause the Debugger in the IDE to
stall.

Workaround:

Remove Microsoft IME Character Code Dictionary from

your system dictionaries list. Simply un-checking this
option from the dictionary list will not solve the
problem. To remove this dictionary:

1) Open the IME Toolbar.

2) Select Tools|Properties and click on the Dictionary
tab.
3) Select "Microsoft IME Character Code Dictionary"
from the System dictionaries listbox
4) Click Remove.

Database
--------
* The provided DB2 driver is certified for DB2 version
7 only. The client version and server version must
match. BDE also supports DB2 version 7 only.

* The Oracle driver provided for dbExpress components

is certified for Oracle 9i. BDE and ADO have been
certified with Oracle 8.1.7 and 8.1.6. In all cases,
the client version and server version must be the
same.

* Oracle 9i types - ORACLE 9i types TIMESTAMP

(introduced for JDK 1.3.1 compliance) and other types
like XMLType, Temp tables, etc. are not yet
supported. Use "DATE" instead.

* The Borland Database Engine CAB file (BDEINST.CAB) is

no longer digitally signed. This CAB file is provided
for backward compatibility. For new applications, we
recommend deploying BDE with the BDE merge modules.
InterBase version support, Dialect 3 features
---------------------------------------------

Delphi 7 supports InterBase 6.5. The client version and

server version must be the same.

Currently, the driver does not support the ARRAY type.

To use the new InterBase 6.5 Dialect 3 features in BDE,

add an entry to your Windows registry under

HKEY_LOCAL_MACHINE\SOFTWARE\Borland\Database Engine
\Settings\Drivers\Intrbase\Db Open\SQLDIALECT

and set the String Value to "3".

When an InterBase alias is created, the new entry will

be available in the .CFG file.

To use InterBase 5.6, SQLDIALECT can be set to "1"

(existing IB aliases which do not have the SQLDIALECT
entry default to SQLDIALECT=1 or to the registry
setting when the SQLDIALECT entry is added to the
registry).

InterBase 6.5 implementation note

---------------------------------

If you are using a WebSnap application with InterBase

6.5, a local database connection is not recommended.
Instead, use a client/server connection specified by a
protocol-specific prefix to the path to the database.

Examples:

Local connection (not recommended):

C:\PathTo\Database\DBName.gdb

TCP/IP connection on Windows:

saturn:C:\PathTo\Database\DBName.gdb

TCP/IP connection on UNIX:

jupiter:/usr/PathTo/Database/DBName.gdb

NetBEUI connection:
\\venus\C:\PathTo\Database\DBName.gdb

IPX/SPX connection:
mars@vol2:\PathTo\Database\DBName.gdb

If the WebSnap application is on the same machine as

the server, you can use localhost:

localhost:C:\PathTo\Database\DBName.gdb
INTERBASE driver behavioral difference:
---------------------------------------

NUMERIC data type mapping.

The dbExpress driver for INTERBASE now maps NUMERIC

data types to fldBCD instead of fldINT16, fldINT32,
fldFLOAT.

dbExpress
---------

TSQLDataSet now has DefaultRowsetSize = 20 (Oracle

only). To use a different RowSetSize, add the
RowSetSize property manually (e.g., "RowsetSize = 200")
into dbxconnections.ini, for existing connections, or
into dbxdrivers.ini to have the RowSetSize property
included in new connections. RowsetSize can also be
modified in code, as shown here:

"SQLConnection1.Params.Values['RowsetSize'] :=
'200'"

dbExpress now includes MySQL 3.23.49 support with a new

driver (dbexpmysql.dll). To use the new driver, specify

LibraryName = "dbexpmysql.dll"

in the Object Inspector or in dbxdrivers.ini.

dbExpress components and MySQL transactions

-------------------------------------------

MySQL doesn't support more than one active statement

per connection. To perform multiple SQL requests with a
single TSQLConnection the dbExpress components clone
connection. There is a bug in maintaining state
information on the no.of active statements with respect
to a TSQLConnection. This might cause serious failures
in transaction as the transaction might be started on
one connection and commit or rollback might be
happening on another connection.

Workaround:

Before you start a MySQL transaction make sure

TSQLConnection.ActiveStatements is 0. If it's not 0 then
close the TSQLConnection and reopen it and that should
clear it. All your transaction activity should then go
on a single connection.

DB2 notes for dbExpress

-----------------------

The provided DB2 driver is certified for DB2 version 7.

The client version and server version must be the
same. BDE also supports DB2 version 7.

Because of a known DB2 bug, the DB2 client returns only

one record at a time when a request for a block fetch
is made, even with RowsetSize option > 1.

Timestamp issues
----------------

The dbExpress DB2 driver rounds the TIMESTAMP

fractional value and there could be some precision lost
depending upon the data retrieved. When you apply back
changes the old value will not match the one on the
server and ApplyUpdates() will fail.

Workaround:

Make sure DB2 TIMESTAMP is not part of indexed columns

and set the DataSetProvider Update mode to WhereKey
instead of WhereAll.

Informix BLOB/CLOB fields (dbExpress)

-------------------------------------

A new global variable, InformixLob, is available to

allow you to work with Informix BLOB and CLOB fields.

The variable is required because Informix BLOB

(fldBLOB, fldstHBINARY) and CLOB (fldBLOB, fldstHMEMO)
fields are mapped as ftOraBlob and ftOraClob,
respectively, and the DataSnap resolver performs
special query generation when resolving Oracle
BLOB/CLOB fields, but not when resolving Informix
BLOB/CLOBs. To address this issue, set InformixLob
to True when using Informix BLOB/CLOBs, and switch it
back to False (the default) when using Oracle
BLOB/CLOBs.

NOTE: The new Informix driver (dbexpinf.dll) has been

tested with Informix version 9.2.1 client/server
and 9.2.1 client with SE server.

MSSQL driver - Known issues

---------------------------

1) Connection with a Blank Password/OS Authentication:

With the current MSSQL driver you can't connect using a

blank password or with OS Authentication = True.

A patch will be made available soon at Borland's support

 download site.

2) Master detail:

a) When trying to open a master-detail as a nested

dataset and if the detail link field is an INTEGER
type and defined NOT NULL you will get a SQL Error
"SQL State:HY000, SQL Error Code: 0, Invalid Input
parameter values. Check the status values for
details"

A patch will be made available soon at Borland's

support download site.

b) ApplyUpdates() on a master-detail with

"poFetchDetailsOnDemand" = True causes a SQL error
"Cannot create new connection because in manual or
distributed transaction mode". Workaround:

poFetchDetailsOnDemand = False (default)

dbExpress MSSQL driver BLOB access

-----------------------------------

dbExpress MSSQL uses ISequentialStream (OLEDB

interface) to access blobs from SQL Server. MS OLEDB
provider (SQLOLEDB) doesn't support accessing more than
one in a SELECT using ISequentialStream. So, if you are
projecting more than one blob column in your queries
the dbExpress driver will not use the ISequentialStream
to access blobs. Instead, it will bind huge buffers to
get the blob data. The buffer size is determined by the
BlobSize entry in dbxconnections.ini. Make sure to set
it to an appropriate size to improve performance when
more than one blob column is projected.

MySQL limitation (dbExpress)

----------------------------

MySQL can't filter with FLOAT fields in the WHERE

clause. Since this limitation prevents updates with
TClientDataset and TDataSetProvider, use DOUBLE
instead. For more information, see the MySQL
documentation.

Huge Text in MySQL (dbExpress)

------------------------------

MySQL Server has a startup parameter called max-

allowed-packet that, by default, is set to 1 megabyte
for most MySQL servers. Increase the value of max-
allowed-packet if you encounter difficulty writing
large amounts of data (such as large strings) to MySQL.

Oracle notes for dbExpress

--------------------------

When qualifying a table name with a user name, you must

use quotes around the table name when CommandType is
set to ctTable.

Oracle LONG and LONG RAW fields (dbExpress)

-------------------------------------------

When using Oracle, the size of LONG and LONG RAW fields
cannot be determined without fetching the whole field.
So if BLOB SIZE is set to -1, LONG and LONG RAW fields
are truncated to 64K. Recommendation: Set BLOB SIZE to
your best estimate of the blob size.

Configuring driver files (dbExpress)

-------------------------------------
The Oracle driver now supports Trim Char, Multiple
Transaction and OS Authentication. You need to add
these settings to your dbxdrivers for new aliases
and/or update dbxconnections in order to include these
settings for old aliases.

Please append the following at the end of dbxdrivers

file if you are using a driver file from an earlier
version of Delphi:

[Multiple Transaction]
False=0
True=1

[Trim Char]
False=0
True=1

[OS Authentication]
False=0
True=1

Add the following under the [Oracle] section in

dbxdrivers and under your existent Oracle alias.

OS Authentication=False
Multiple Transaction=False
Trim Char=False

Oracle OS authentication (dbExpress)

-------------------------------------

To get the correct list of tables and other schema

objects in the dbExpress components, set the User_Name
to OPS$XXX, where XXX is the OS Authenticated user.

=======================================================
ABOUT EDITING THE WINDOWS REGISTRY

Warning:
Registry edits are performed at your own risk.
Several items in this document and in other parts
of the documentation that accompany this product
describe how to edit your Windows registry. In most
cases, we recommend that you use the Microsoft
Regedit tool to perform your editing. Whatever tool
you use, however, you should, before making any
edits, make backups of your registry and thoroughly
familiarize yourself with the editing tool and the
registry editing process. The registry is a
critical component of your operating system, and
any mistakes made while editing it can cause your
machine to stop functioning.

=======================================================
PRODUCT INFORMATION ON THE WEB

In addition to numerous private sites that offer

information, instruction, and samples, the following
Borland Web-based resources provide a continuous stream
of news, product information, updates, code, and other
materials. You can connect to many of these resources
directly from the Help menu.

Delphi Direct [Help|Delphi Direct]

----------------------------------

This IDE add-in resource provides an automatically

updated list of links to the latest news, downloads,
and other information about Delphi and Borland.

Code Central
------------

The CodeCentral Repository is a free, searchable

database of code, tips, and other materials of interest
to developers. For details and registration
information, visit

http://codecentral.borland.com/

The Borland Web site

--------------------

Borland Software Corporation home page:

http://www.borland.com
[IDE: Help|Borland Home Page]
Delphi home page:
http://www.borland.com/delphi/
[IDE: Help|Delphi Home Page]

Delphi developer support:

http://www.borland.com/devsupport/delphi/
[IDE: Help|Delphi Developer Support]

Delphi updates and other downloads:

http://www.borland.com/devsupport/delphi/downloads/

Delphi documentation site:

http://www.borland.com/techpubs/delphi

Newsgroups:
http://www.borland.com/newsgroups/

Worldwide offices and distributors:

http://www.borland.com/bww/

FTP site (anonymous access):

ftp.borland.com

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