Beruflich Dokumente
Kultur Dokumente
®
Adaptive Server Enterprise Version 15.0
for HP Itanium
Document ID: DC00496-01-1500-01
Last revised: June 1, 2006
Topic Page
1. Accessing current release bulletin information 3
2. Product summary 3
2.1 Installation kit 4
2.2 Operating system requirements 4
3. Special installation instructions 4
3.1 Using SySAM 2.0 5
3.2 Monitoring and Diagnostic (MDA) tables 5
4. Special upgrade instructions 7
4.1 Disabling High Availability during upgrade 7
4.2 Upgrading High Availability and cluster support 8
5. Changes that affect existing applications 13
5.1 Directory changes 13
5.2 Changes to ODBC and OLE DB Driver support 13
5.3 Changes that affect application behavior 14
5.4 Changes that affect database administration operations 18
5.5 Open Client and Open Server changes 22
6. Known problems 22
6.1 Highlighted known installation issues 22
6.2 Highlighted known XML problems 23
6.3 Highlighted known Web Services problems 24
Copyright 1987-2006 by Sybase, Inc. All rights reserved. Sybase, SYBASE (logo), ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture, Adaptive Server, Adaptive Server Anywhere, Adaptive
Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server Enterprise Replication, Adaptive Server Everywhere, Advantage Database Server, Afaria, Answers Anywhere, Applied Meta, Applied Metacomputing, App-
Modeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-Translator, APT-Library, ASEP, Avaki, Avaki (Arrow Design), Avaki Data Grid, AvantGo, Backup Server, BayCam, Beyond Connected, Bit-Wise, BizTracker,
Certified PowerBuilder Developer, Certified SYBASE Professional, Certified SYBASE Professional Logo, ClearConnect, Client-Library, Client Services, CodeBank, Column Design, ComponentPack, Connection Manager, Con-
voy/DM, Copernicus, CSP, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress, DataServer, DataWindow, DataWindow .NET, DB-Library, dbQueue, Dejima, Dejima Direct, Developers Workbench, Di-
rectConnect Anywhere, DirectConnect, Distribution Director, Dynamic Mobility Model, e-ADK, E-Anywhere, e-Biz Integrator, E-Whatever, EC Gateway, ECMAP, ECRTP, eFulfillment Accelerator, EII Plus, Electronic Case
Management, Embedded SQL, EMS, Enterprise Application Studio, Enterprise Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager, Enterprise Portal (logo), Enterprise SQL Server Manager, Enterprise Work
Architecture, Enterprise Work Designer, Enterprise Work Modeler, eProcurement Accelerator, eremote, Everything Works Better When Everything Works Together, EWA, ExtendAssist, Extended Systems, ExtendView, Financial Fu-
sion, Financial Fusion (and design), Financial Fusion Server, Formula One, Fusion Powered e-Finance, Fusion Powered Financial Destinations, Fusion Powered STP, Gateway Manager, GeoPoint, GlobalFIX, iAnywhere, iAnywhere
Solutions, ImpactNow, Industry Warehouse Studio, InfoMaker, Information Anywhere, Information Everywhere, InformationConnect, InstaHelp, Intelligent Self-Care, InternetBuilder, iremote, irLite, iScript, Jaguar CTS, jConnect for
JDBC, KnowledgeBase, Legion, Logical Memory Manager, M2M Anywhere, Mach Desktop, Mail Anywhere Studio, Mainframe Connect, Maintenance Express, Manage Anywhere Studio, MAP, M-Business Anywhere, M-Business
Channel, M-Business Network, M-Business Suite, MDI Access Server, MDI Database Gateway, media.splash, Message Anywhere Server, MetaWorks, MethodSet, mFolio, Mirror Activator, ML Query, MobiCATS, MobileQ, MySup-
port, Net-Gateway, Net-Library, New Era of Networks, Next Generation Learning, Next Generation Learning Studio, O DEVICE, OASiS, OASiS logo, ObjectConnect, ObjectCycle, OmniConnect, OmniQ, OmniSQL Access Module,
OmniSQL Toolkit, OneBridge, Open Biz, Open Business Interchange, Open Client, Open ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open ServerConnect, Open Solutions, Opti-
ma++, Partnerships that Work, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, Pharma Anywhere, PhysicalArchitect, Pocket PowerBuilder, PocketBuilder, Power++, Power Through Knowledge, power.stop, PowerAMC,
PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner, PowerDimensions, PowerDynamo, Powering the New Economy, PowerScript, PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio, PowerTips, Pow-
ersoft Portfolio, Powersoft Professional, PowerWare Desktop, PowerWare Enterprise, ProcessAnalyst, Pylon, Pylon Anywhere, Pylon Application Server, Pylon Conduit, Pylon PIM Server, Pylon Pro, QAnywhere, Rapport, Relational
Beans, RemoteWare, RepConnector, Report Workbench, Report-Execute, Replication Agent, Replication Driver, Replication Server, Replication Server Manager, Replication Toolkit, Resource Manager, RFID Anywhere, RW-Display-
Lib, RW-Library, SAFE, SAFE/PRO, Sales Anywhere, Search Anywhere, SDF, Search Anywhere, Secure SQL Server, Secure SQL Toolset, Security Guardian, ShareSpool, ShareLink, SKILS, smart.partners, smart.parts, smart.script,
SOA Anywhere Trademark,SQL Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug, SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL Modeler, SQL Remote, SQL Server, SQL Server Manager,
SQL SMART, SQL Toolset, SQL Server/CFT, SQL Server/DBM, SQL Server SNMP SubAgent, SQL Station, SQLJ, Stage III Engineering, Startup.Com, STEP, SupportNow, S.W.I.F.T. Message Format Libraries, Sybase Central,
Sybase Client/Server Interfaces, Sybase Development Framework, Sybase Financial Server, Sybase Gateways, Sybase IQ, Sybase Learning Connection, Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Work-
group, Sybase Synergy Program, Sybase Virtual Server Architecture, Sybase User Workbench, SybaseWare, Syber Financial, SyberAssist, SybFlex, SybMD, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular
Data Stream, The Enterprise Client/Server Company, The Extensible Software Platform, The Future Is Wide Open, The Learning Connection, The Model For Client/Server Solutions, The Online Information Center, The Power of One,
TotalFix, TradeForce, Transact-SQL, Translation Toolkit, Turning Imagination Into Reality, UltraLite, UltraLite.NET, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viafone, Viewer, VisualWriter, VQL,
WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse WORKS, Watcom, Watcom SQL, Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup SQL Server, XA-
Library, XA-Server, XcelleNet, XP Server, XTNDAccess and XTNDConnect are trademarks of Sybase, Inc. or its subsidiaries. 01/06
Adaptive Server Enterprise version 15.0
Topic Page
6.4 Known alter table problems 24
6.5 Interactive SQL and Adaptive Server Enterprise plug-in 24
issues
6.6 Statistics in system tables 27
6.7 Running checkstorage on an upgraded master device may 28
report faults with the syscharsets catalog
6.8 Inserting into a table with identity column using select 28
distinct
6.9 SySAM licenses needed to upgrade Adaptive Server 28
Enterprise
6.10 Cross-platform dumps and loads 29
6.11 Running dbcc checktable or dbcc checkdb before bringing 29
a database online
6.12 allow backward scan does not work 29
6.13 Modifying dbccdb schema for large identifiers 29
6.14 Drop definition timetable corruption 30
6.15 Manual upgrade with named cache fails 30
6.16 Running diskrefit to recover a corrupt master device can 30
report errors
6.17 Using an equijoin clause between two different length 30
columns
6.18 set statistics io does not display I/O generated by worker 31
processes
6.19 Replication Server compatibility issues 31
6.20 cis connect timeout and enable SNMP are not implemented 32
6.21 Handling multibyte character sets during migration 32
6.22 bcp in or bcp out 32
6.23 Silent installation 32
6.24 Sybase Central 33
6.25 File names 33
6.26 table scan and index scan 33
6.27 Determining devices for a database 33
7. Product compatibilities 33
7.1 Adaptive Server interoperability 35
7.2 Adaptive Server Replicator 15.0 support of Adaptive Server 38
Enterprise 12.5 datatypes
7.3 Known compatibility issues 38
8. Documentation updates and clarifications 39
Topic Page
8.1 Reference Manual: Building Blocks 39
8.2 Reference Manual: Commands 41
8.3 Reference Manual: Procedures 42
8.4 Installation guide 48
9. Technical support 48
10. Other sources of information 48
10.1 Sybase certifications on the Web 49
10.2 Sybase EBFs and software maintenance 50
11. Accessibility features 50
2. Product summary
Enclosed is Sybase Adaptive Server® Enterprise version 15.0. Server and
client components are distributed on separate CDs.
For details on system requirements, including disk space and RAM, see the
installation guide for your platform.
Sybase strongly recommends that you install Adaptive Server version 15.0 into
its own directory. Where this is not practical, install Adaptive Server version
15.0 last.
Warning! Sybase recommends that you not install an older version of a Sybase
product in a $SYBASE directory that already includes a newer Sybase product
as this may not work. For example, attempting to install Replication Server
12.6 on top of Adaptive Server 15.0 may make either Adaptive Server
Enterprise or Replication Server inoperable depending on the choices taken
during install.
Sybase recommends you reinstall the MDA tables using the installmontables
script contained in this release.
Note Do not make any changes to the installmontables script if you do not plan
to use the MDA tables to monitor remote servers.
Warning! Do not use trace flag 2209 after the Adaptive Server Enterprise
companionship is reestablished.
14 Use the appropriate command for your cluster system to restart monitoring
resources associated with Adaptive Server Enterprise on each cluster
node.
15 Reestablish companionship by using isql to issue:
sp_companion <primary-server-name>, configure
go
If user databases exist on the secondary server, you may see one or more
warning messages. You can safely ignore these messages, which look
similar to:
Msg 18739, Level 16, State 1:
Server 'svr2', Procedure 'sp_hacmpcfgvrfy', Line 102:
Database 'svr2_db1': a user database exists. Drop this
database and retry the configuration again.
16 Use the appropriate cluster command to take offline, then bring back
online, each resource group associated with Adaptive Server Enterprise.
Use isql to connect to each Adaptive Server Enterprise and verify the
correct server companionship:
sp_companion
go
The output you see on the primary server is similar to the following:
Server 'svr1' is alive and cluster configured.
Server 'svr1' is configured for HA services.
Server 'svr1' is currently in 'Primary normal' mode.
(return status = 0)
The output you see on the secondary server is similar to the following:
Server 'svr2' is alive and cluster configured.
Server 'svr2' is configured for HA services.
Server 'svr2' is currently in 'Secondary normal'
mode.
(return status = 0)
• The identity column overflow message is now raised with message 587
instead of 4916.
• When you create a Java function that does not exist in the catalogs,
message 14216 is raised instead of syntax error message 195.
• When a non-owner executes sp_procxmode to change the transaction
mode associated with a stored procedure, error message 10354 is raised.
• Arithmetic overflow errors are now raised with message 3606 with
severity 16.
• Message 2579 has been replaced with message 12907 in dbcc checktable
output.
• monCachedObject
• monProcessObject
• partitiontype
• conditionid
• status3
• ioampg
• first
• root
• partitionid
• plldegree
• statmoddate
• There is a new type of object called a partition condition object, which has
a row in sysobjects. A partition condition object is the representation of a
tree for the partition table boundary conditions. The tree is stored in
sysprocedures.
• identburnmax
• spacestate
• erlchgts
• sysstatistics stores the data change counters with formatid=108. The space
required by sysstatistics increases due to the additional rows stored.
• Most system catalogs have been converted to the datarows-locking
scheme. However, DDLs continue to use the table-level locks. The row
locking of the system catalogs can require a increase in the configuration
parameter number of locks, depending on the DDLs in the application.
• alter table on a partitioned table with max parallel degree less than the
number of partitions may succeed without raising message 326.
• Creating a clustered index on an empty partitioned table returns a new
informational message, 1936.
• null column names are not allowed during view creation.
• sp_who returns “NULL” instead of blank in the hostname column for all
system tasks.
• sp_who results in SQL command (insert or select) in the output. In earlier
versions, sp_who returned select for the tasks that executed sp_who.
• sp_objectsegment now displays segment information for all partitions of
the table.
• sp_lock output has a new column called partitionid, that currently has a
value of 0, and is reserved for future use.
• sp_monitorconfig now accepts number of open partitions. When this
procedure is executed with the parameter all, additional output for
configuration parameter number of open partitions is displayed.
• The Metadata Cache Management section of sp_sysmon displays
additional information pertaining to open partitions.
• The space state message printed in the old dbcc listoam output is now
available as a new column spacestate in sysobjects.
• dbcc tablealloc output has changed.
• dbcc page output now displays the print partition ID instead of the object
ID.
• dbcc checktable output on a partitioned table has been changed to provide
partition-level information.
• dbcc checktable/tablealloc/indexalloc has new syntax for partition support.
6. Known problems
This section describes known problems and workarounds for Adaptive Server
Enterprise.
Note Sybase no longer includes System Problem Reports (SPR) and Closed
Problem Reports (CPR) with your copy of Adaptive Server Enterprise. Known
problems, which used to be in the SPR, are now described in this section of the
release bulletin. Closed issues that were documented in the CPR are now
searchable from Solved Cases at the Sybase Web site at http://www.sybase.com.
To access the Solved Cases seach form, click Support and Services | Solved
Cases.
Warning! If you have multiple Sybase products installed in the same $SYBASE
directory, uninstalling one of them may make the other products inoperable. If
this happens, you may need to reinstall those remaining products.
You can then use bcp or replicate the xmltext column from one platform to the
other.
6.5.6 Interactive SQL does not generate plans for SQL statements using go
[CR #400362] Interactive SQL cannot generate plans for SQL statements
separated with go.
Workaround: Eliminate go between SQL statements.
6.5.12 Adaptive Server Enterprise plug-in data panel for a table with a binary
null column
[CR #382837] When a binary column has a length of less than 256, the
Adaptive Server Enterprise plug-in data panel for a table with a binary null
column displays a value with trailing nulls.
Workaround: There is no workaround for this issue.
• sysindexes
• syscolumns
• systypes
• syslogins
• sysusers
6.8 Inserting into a table with identity column using select distinct
[CR #401753] If you have enabled parallel plan, and use select distinct into a
table with an identity column and one of the select distinct list items is an
expression or an implicit convert() expression, this query may cause a stack
trace. Here is an example query:
create table tt(id numeric(5) identity not null, c1 int,
c2 int)
go
insert into tt select distinct c1, c2+1 from t
go
Workaround: Disable parallel plan for the query. For the example query, use:
insert into tt select distinct c1, c2+1 from t (parallel 1)
go
create table t2 (sid char(16))
go
select char_length(a.sid)
from t1 a, t2 b
where a.sid=b.sid and styp = 'R1'
go
Workaround: Use convert() in char_length() to state explicitly which type you
need for the char_length.
For example, in the above query, use:
select char_length(convert(char(8), a.sid))
from t1 a, t2 b
where a.sid=b.sid and styp = 'R1'
The same is true for binary() and varbinary() with data_length(), and unichar()
and univarchar() with char_length().
6.20 cis connect timeout and enable SNMP are not implemented
[CR #323177] The cis connect timeout and enable SNMP configuration
parameters are not currently implemented.
Workaround: Do not use these configuration parameters.
7. Product compatibilities
This section lists the Sybase components that are compatible with Adaptive
Server Enterprise version 15.0. For information about operating system
requirements, see individual component documentation.
The following components have been tested for compatibility with Adaptive
Server Enterprise version 15.0:
• Sybase Character Sets 3.0
• Sybase Central viewer 4.3
• ECDA option for ODBC 12.6
• ECDA option for Informix 12.6
• MainframeConnect DirectConnect for z/OS 12.6
• ECDA option for Oracle 12.6
• ECDA option for Microsoft SQL Server 12.6
• ECDA option for DB2 Universal Database 12.6
• OpenSwitch 12.5, OpenSwitch 12.5.1, ESD #2
ADO.NET 1.1x
OC/OS 12.5X
OC/OS 15.0X
OC/OS 12.0x
jConnect 5.5
Platforms
AIX 32-bit X X X X X X X X X X + + X X
64-bit X X X X X X X X X X + + X X
HP-UX 32-bit X X X X X X X X X X + + X X
64-bit X X X X X X X X X X + + X X
IA 64-bit X X X X X X X X X X + + X X
Linux x86 32-bit X X X X X X X X X X + + X X
Pseries 64-bit X X X X X X X X X X + + X X
x64 64-bit X X X X X X X X X X + + X X
IA 64-bit X X X X X X X X X X + + X X
Solaris 32-bit X X X X X X X X X X + + X X
64-bit X X X X X X X X X X + + X X
Windows x86 32-bit X X X X X X X X X X + + X X
+ Available until November 2007. See “Changes to ODBC and OLE DB Driver support” on page 13 for details.
• 0 = SQL_PARAM_TYPE_UNKNOWN
• 1 = SQL_PARAM_TYPE_INPUT
• 2 = SQL_PARAM_TYPE_OUTPUT
• 3 = SQL_RESULT_COL
• 4 = SQL_PARAM_OUTPUT
• 5 = SQL_RETURN_VALUE
This information is erroneous and should be removed from the description.
8.3.2 sp_poolconfig
The reference pages for sp_poolconfig have been revised. Replace the pages for
sp_poolconfig with the following.
Description Creates, drops, resizes, and provides information about memory pools within
data caches.
Syntax To create a memory pool in an existing cache, or to change pool size:
sp_poolconfig cache_name [, "mem_size [P|K|M|G]", "config_poolK"
[, "affected_poolK"]]
To change a pool’s wash size:
sp_poolconfig cache_name, "affected_poolK ", "wash=size[P|K|M|G]"
To change a pool’s asynchronous prefetch percentage:
sp_poolconfig cache_name, "affected_poolK ",
"local async prefetch limit=percent "
Parameters • cache_name – is the name of an existing data cache.
• mem_size – is the size of the memory pool to be created or the new total
size for an existing pool with the specified I/O size. The minimum size of
a pool is 256 logical server pages. For a 2K logical page size server, the
minimum size is 256K. Specify size units with P for pages, K for kilobytes,
M for megabytes, or G for gigabytes. The default is kilobytes.
• config_pool – is the I/O size performed in the memory pool where the
memory is to be allocated or removed.
Valid I/O sizes are multiples of the logical page size, up to four times the
amount.
• affected_pool – is the size of I/O performed in the memory pool where the
memory is to be deallocated, or the pools attributes such as 'wash size' and
'prefetch limit' are to be modified. If affected_pool is not specified, the
memory is taken from the lowest logical page size memory pool.
• wash=size – changes the wash size (the point in the cache at which
Adaptive Server writes dirty pages to disk) for a memory pool.
• local async prefetch limit=percent – sets the percentage of buffers in the pool
that can be used to hold buffers that have been read into cache by
asynchronous prefetch, but that have not yet been used.
Examples Example 1 Creates a 16K pool in the data cache pub_cache with 10MB of
space. All space is taken from the default 2K memory pool:
sp_poolconfig pub_cache, "10M", "16K"
Example 2 Creates 16MB of space to the 32K pool from the 64K pool of
pub_cache:
• Figure 1 shows a data cache on a server that uses 2K logical pages with:
• The default data cache with a 2K pool and a 16K pool
• A user cache with a 2K pool and a 16K pool
• A log cache with a 2K pool and a 4K pool
Figure 1: Data cache with default and user-defined caches
2K pool
DataCache
16K pool
Default
C a c h e
User_table_Cache
2K pool
16K pool
D a t a
Log_Cache
2K pool
4K pool
• You can create pools with I/O sizes up to 16K in the default data cache for
a 2K page size server.
• The minimum size of a memory pool is 256 logical pages (for example, a
2K logical page size server, the minimum size is 512K). You cannot
reduce the size of any memory pool in any cache to less than 256 pages by
transferring memory to another pool.
• Two circumstances can create pool less than 512K:
• If you attempt to delete a pool by setting its size to zero, and some of
the pages are in use, sp_poolconfig reduces the pool size as much as
possible, and prints a warning message. The status for the pool is set
to “Unavailable/deleted”.
• Each memory pool contains a wash area at the least recently used (LRU)
end of the chain of buffers in that pool. Once dirty pages (pages that have
been changed while in cache) move into the wash area, Adaptive Server
initiates asynchronous writes on these pages. The wash area must be large
enough so that pages can be written to disk before they reach the LRU end
of the pool. Performance suffers when Adaptive Server needs to wait for
clean buffers.
The default percentage, placing 20 percent of the buffers in the wash area,
is sufficient for most applications. If you are using an extremely large
memory pool, and your applications have a very high data modification
rate, you may want to increase the size to 1 or 2 percent of the pool. Run
sp_sysmon to look for recommendations, or contact Sybase Technical
Support for more information about choosing an effective wash size.
Local asynchronous prefetch percentage
9. Technical support
Each Sybase installation that has purchased a support contract has one or more
designated people who are authorized to contact Sybase Technical Support. If
you have any questions about this installation or if you need assistance during
the installation process, ask the designated person to contact Sybase Technical
Support or the Sybase subsidiary in your area.
2 Either select the product family and product under Search by Base
Product; or select the platform and product under Search by Platform.
3 Select Search to display the availability and certification report for the
selection.
Note You might need to configure your accessibility tool for optimal use.
Some screen readers pronounce text based on its case; for example, they
pronounce ALL UPPERCASE TEXT as initials, and MixedCase Text as
words. You might find it helpful to configure your tool to announce syntax
conventions. Consult the documentation for your tool.