SAP Adaptive Server Enterprise 16.0

SAP Adaptive Server Enterprise 16.0 (Japanese)

SAP Adaptive Server Enterprise 16.0 (Simplified Chinese)

Adaptive Server Enterprise 15.7 SP121

Adaptive Server Enterprise 15.7 SP110

Adaptive Server Enterprise 15.7 SP100

Adaptive Server Enterprise 15.7 SP60

Adaptive Server Enterprise 15.7 SP50

Adaptive Server Enterprise 15.7 ESD #4

Adaptive Server Enterprise 15.7 ESD #3

Adaptive Server Enterprise 15.7 ESD #2

Adaptive Server Enterprise 15.7 ESD #2 (Japanese)

Adaptive Server Enterprise 15.7 ESD #2 (Simplified Chinese)

Adaptive Server Enterprise 15.7

Adaptive Server Enterprise 15.7 (Japanese)

Adaptive Server Enterprise 15.7 (Simplified Chinese)

Adaptive Server Enterprise 15.5

Adaptive Server Enterprise 15.5 - Simplified Chinese

Adaptive Server Enterprise 15.5 (Japanese)

Adaptive Server Enterprise 12.5.4

Adaptive Server Enterprise 12.5.4 (Simplified Chinese)

Adaptive Server Enterprise 12.5.4 (French)

Adaptive Server Enterprise 12.5.4 (Japanese)

Adaptive Server Enterprise 12.5.3

Adaptive Server Enterprise 12.5.2

Adaptive Server Enterprise 12.5.1

AppBuilder 1.0

Appeon 6.5.1 for PowerBuilder

Appeon 6.5 for PowerBuilder

Appeon 6.2 for PowerBuilder

Appeon 6.1 for PowerBuilder

Appeon 6.0 for PowerBuilder

Appeon 6.0 for PowerBuilder (Japanese)

Avaki EII 7.1

Avaki EII 7.0

Avaki EII 6.2

DataWindow .NET 2.5

DataWindow .NET 2.0.1

DataWindow .NET 2.0

EAServer 6.3.1

EAServer 6.3

EAServer 6.2

EAServer 6.1

EAServer 6.0.2

EAServer 6.0

EAServer 5.5

EAServer 5.3

EAServer 5.2.1

EAServer 5.2

EAServer 5.0.1

EDI Products 5.2.2

Enterprise Connect Data Access 15.7

Enterprise Connect Data Access 15.0.1

Enterprise Connect Data Access 15.0

Enterprise Connect Data Access 12.6.1

Enterprise Connect Data Access 12.6

Financial Fusion GlobalFIX 6.0

InfoMaker 12.5.2

InfoMaker 12.5

SAP jConnect for JDBC 16.0

jConnect for JDBC 7.07 SP110

jConnect for JDBC 7.07 SP100

jConnect for JDBC 7.07

jConnect for JDBC 7.0

jConnect for JDBC 6.05

jConnect for JDBC 5.5

M-Business Anywhere 7.0

M-Business Anywhere 6.7

Mainframe Connect 15.0

Mainframe Connect 12.6.1

Mainframe Connect 12.6

SAP Open Server 16.0

SAP Open Server 15.7 SP127

Open Server 15.7 SP121

Open Server 15.7 SP110

Open Server 15.7 SP100

Open Server 15.7

Open Server 15.5

Open Server 15.0, Open Client 15.0, and SDK 15.0

Open Server 12.5.1

Open Server 12.5.1 (Chinese-Simplified)

Open Server 12.5.1 (French)

OpenSwitch 15.1

SAP Sybase PowerAMC 16.5 SP03

SAP Sybase PowerAMC 16.5 SP02

PowerAMC 16.5

PowerAMC 16.1

PowerAMC 16.0

PowerBuilder 12.5.2

PowerBuilder 12.5.1

PowerBuilder 12.5

PowerBuilder Application Server Plug-in 1.1

PowerBuilder Application Server Plugin 1.0

SAP Sybase PowerDesigner 16.5 SP03

SAP Sybase PowerDesigner 16.5 SP02

PowerDesigner 16.5

PowerDesigner 16.1

PowerDesigner 16.0

Real-Time Data Services 4.5

Real Time Data Services 4.0

Real Time Data Services 3.5

Installation and Release Bulletin Sybase Real-Time Data Services 3.5  Accessing current bulletin information  Overview  Using RTDS with Adaptive Server Enterprise  Using RTDS with RepConnector  Product summary  EAServer EBF  Platforms  IBM WebSphere MQ family SupportPac files  Documentation  Installing RTDS using Adaptive Server  Adding an RTDS license for Adaptive Server Enterprise version 12.5.4  Adding an RTDS license for Adaptive Server Enterprise version 15.0 ESD #2  Pre-installation tasks for SySAM  Installing RTDS using InstallShield  Configuring RTDS  Error messages  Installing RTDS using RepConnector  Installing RepConnector for RTDS  Configuring RepConnector  Known problems  Executing messaging commands before installing license or enabling messaging services causes error  Using msgconsume with messaging can cause errors  Cannot install Replication Server 12.6 on top of Adaptive Server 15.0  Using for xml clause in Adaptive Server 15.0 can cause an overflow  Product compatibilities  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin RepConnector 15.0 for UNIX and Windows  Accessing current release bulletin information  Product summary  Installation prerequisites  Known problems  RepConnector Manager issues  Displaying the RepConnector connection state  Read-only fields not dimmed  Updating the Profile Status  RepConnector XML Generator  Replicating from a message system to an Oracle database  Processing large LOB datatypes  Processing Oracle datatime  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin Replication Server 15.0 for HP-UX  Accessing current release bulletin information  Product summary  Replication Server  Replication Manager  Replication Monitoring Services  IPv6 support  Master database replication  Optional features  Replication Agent and Enterprise Connect Data Access  Special installation instructions  Selecting an installation directory for Replication Server  Installing Replication Server in an existing directory  Installing Replication Server in a unique directory  Installing Replication Server on 64-bit machines  Co-existing with earlier versions of SySAM  Enabling asynchronous disk I/O  Other sources of installation information  Special upgrade and downgrade instructions  Preparing to upgrade  Upgrading route versions  Updating LTL version  New and changed functionality  Known problems  Problem report location  Highlighted problems with Replication Server  delete command for multiple rows may not replicate correctly  DSI shuts down  DSI shuts down if transaction owner and standby maintenance user have same name  Warm standby replication definition not recognized for non-database owner qualified table with more than 128 columns  Decimal with exponent incorrectly translated  Effects of alter replication definition not immediate  DSI error 5147 for replication definitions with several text columns if replication definitions do not allow NULL  Adaptive Server row-level locking may cause System Table Services cache problems  Replication Server does not preprocess table names qualified with database name  Memory leak occurs with constant login and logout activity  Dropping a subscription that has failed causes a stack trace  Turning on hibernation mode may cause a stack trace  Language modules not listed  Cannot start Replication Server without -S flag  Replication Manager problems  New active connection suspends when created  Plug-in must be unregistered after uninstallation  Configure Replication wizard may not work under certain circumstances  Cannot specify owner and password when creating subscriptions  Status not updated when monitoring is turned on  RM does not report a failure  RM does not report reason for a secondary RMS with SUSPECT state  RM may not accurately reflect status in a three-tier environment  Replication Monitoring Services problems  RMS cannot start RepAgent if sp_addserver is not run on Adaptive Server  RMS executes event triggers on start-up  Event triggers are not executed if RM is not connected to RMS  RMS is not updating client applications when its status changes  Sybase Central problems  Users must have write privileges to home directory  Sybase Central stops responding when command log fills up  Highlighted rs_init problems  rs_init does not update interfaces file automatically  Cannot use korean/eucksc character set to configure Replication Server with us_english/iso_1  rs_init does not support the mac character set  Default size for the RSSD log device is too small  Incompatible character set specification using rs_init  rs_init does not correct run files  Unsupported operations  Product compatibilities  Adaptive Server  Interoperability of Adaptive Server, Open Client/Server, and Replication Server  Documentation updates and clarifications  Replication Manager online help  Corrections to the Using the Interface book  Managing stored procedure replication  Stored Procedure Properties dialog box  Adding a function replication definition  Using the Function Replication Definition context menu  Adding a subscription  Using the Subscription context menu  Administration Guide  startup delay configuration parameter  Reference Manual  startup delay configuration parameter  recovery_foreground configuration parameter  Troubleshooting Guide  Error message changes  9202: Nested stored procedures not allowed (LTM 1033)  Language and globalization issues  Hankaku Katakana conversion  Using trace flag 2402  Changing default date format for a language  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin Replication Server 15.0 for IBM AIX  Accessing current release bulletin information  Product summary  Replication Server  Replication Manager  Replication Monitoring Services  IPv6 support  Master database replication  Optional features  Replication Agent and Enterprise Connect Data Access  Special installation instructions  Selecting an installation directory for Replication Server  Installing Replication Server in an existing directory  Installing Replication Server in a unique directory  Installing Replication Server on 64-bit machines  Co-existing with earlier versions of SySAM  Other sources of installation information  Special upgrade and downgrade instructions  Preparing to upgrade  Upgrading route versions  Updating LTL version  New and changed functionality  Known problems  Problem report location  Highlighted problems with Replication Server  delete command for multiple rows may not replicate correctly  DSI shuts down  DSI shuts down if transaction owner and standby maintenance user have same name  Warm standby replication definition not recognized for non-database owner qualified table with more than 128 columns  Decimal with exponent incorrectly translated  System Table Services cache corrupts when all RSSD tables are fully cached  Effects of alter replication definition not immediate  DSI error 5147 for replication definitions with several text columns if replication definitions do not allow NULL  Adaptive Server row-level locking may cause System Table Services cache problems  Replication Server does not preprocess table names qualified with database name  Memory leak occurs with constant login and logout activity  Dropping a subscription that has failed causes a stack trace  Turning on hibernation mode may cause a stack trace  Language modules not listed  Cannot start Replication Server without -S flag  Replication Manager problems  New active connection suspends when created  Plug-in must be unregistered after uninstallation  Configure Replication wizard may not work under certain circumstances  Cannot specify owner and password when creating subscriptions  Status not updated when monitoring is turned on  RM does not report a failure  RM does not report reason for a secondary RMS with SUSPECT state  RM may not accurately reflect status in a three-tier environment  Replication Monitoring Services problems  RMS cannot start RepAgent if sp_addserver is not run on Adaptive Server  RMS executes event triggers on start-up  Event triggers are not executed if RM is not connected to RMS  RMS is not updating client applications when its status changes  Sybase Central problems  Users must have write privileges to home directory  Sybase Central stops responding when command log fills up  Highlighted rs_init problems  rs_init does not update interfaces file automatically  Cannot use korean/eucksc character set to configure Replication Server with us_english/iso_1  rs_init does not support the mac character set  Default size for the RSSD log device is too small  Incompatible character set specification using rs_init  rs_init does not correct run files  Unsupported operations  Product compatibilities  Adaptive Server  Interoperability of Adaptive Server, Open Client/Server, and Replication Server  Documentation updates and clarifications  Replication Manager online help  Corrections to the Using the Interface book  Managing stored procedure replication  Stored Procedure Properties dialog box  Adding a function replication definition  Using the Function Replication Definition context menu  Adding a subscription  Using the Subscription context menu  Administration Guide  startup delay configuration parameter  Reference Manual  startup delay configuration parameter  recovery_foreground configuration parameter  Troubleshooting Guide  Error message changes  9202: Nested stored procedures not allowed (LTM 1033)  Language and globalization issues  Hankaku Katakana conversion  Using trace flag 2402  Changing default date format for a language  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin Replication Server 15.0 for Linux  Accessing current release bulletin information  Product summary  Replication Server  Replication Manager  Replication Monitoring Services  IPv6 support  Master database replication  Optional features  Replication Agent and Enterprise Connect Data Access  Special installation instructions  Selecting an installation directory for Replication Server  Installing Replication Server in an existing directory  Installing Replication Server in a unique directory  Co-existing with earlier versions of SySAM  Other sources of installation information  Special upgrade and downgrade instructions  Preparing to upgrade  Upgrading route versions  Updating LTL version  New and changed functionality  Known problems  Problem report location  Highlighted problems with Replication Server  delete command for multiple rows may not replicate correctly  DSI shuts down  DSI shuts down if transaction owner and standby maintenance user have same name  Warm standby replication definition not recognized for non-database owner qualified table with more than 128 columns  Decimal with exponent incorrectly translated  Effects of alter replication definition not immediate  DSI error 5147 for replication definitions with several text columns if replication definitions do not allow NULL  Adaptive Server row-level locking may cause System Table Services cache problems  Replication Server does not preprocess table names qualified with database name  Memory leak occurs with constant login and logout activity  Dropping a subscription that has failed causes a stack trace  Turning on hibernation mode may cause a stack trace  SMP on Linux is not supported  Language modules not listed  Cannot start Replication Server without -S flag  Replication Manager problems  New active connection suspends when created  Plug-in must be unregistered after uninstallation  Configure Replication wizard may not work under certain circumstances  Cannot specify owner and password when creating subscriptions  Status not updated when monitoring is turned on  RM does not report a failure  RM does not report reason for a secondary RMS with SUSPECT state  RM may not accurately reflect status in a three-tier environment  Replication Monitoring Services problems  RMS cannot start RepAgent if sp_addserver is not run on Adaptive Server  RMS executes event triggers on start-up  Event triggers are not executed if RM is not connected to RMS  RMS is not updating client applications when its status changes  Sybase Central problems  Users must have write privileges to home directory  Sybase Central stops responding when command log fills up  Highlighted rs_init problems  rs_init does not update interfaces file automatically  Cannot use korean/eucksc character set to configure Replication Server with us_english/iso_1  rs_init does not support the mac character set  Incompatible character set specification using rs_init  rs_init does not correct run files  Unsupported operations  Product compatibilities  Adaptive Server  Interoperability of Adaptive Server, Open Client/Server, and Replication Server  Documentation updates and clarifications  Replication Manager online help  Corrections to the Using the Interface book  Managing stored procedure replication  Stored Procedure Properties dialog box  Adding a function replication definition  Using the Function Replication Definition context menu  Adding a subscription  Using the Subscription context menu  Administration Guide  startup delay configuration parameter  Reference Manual  startup delay configuration parameter  recovery_foreground configuration parameter  Troubleshooting Guide  Error message changes  9202: Nested stored procedures not allowed (LTM 1033)  Language and globalization issues  Hankaku Katakana conversion  Using trace flag 2402  Changing default date format for a language  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin Replication Server 15.0 for Sun Solaris  Accessing current release bulletin information  Product summary  Replication Server  Replication Manager  Replication Monitoring Services  IPv6 support  Master database replication  Optional features  Replication Agent and Enterprise Connect Data Access  Special installation instructions  Selecting an installation directory for Replication Server  Installing Replication Server in an existing directory  Installing Replication Server in a unique directory  Installing Replication Server on 64-bit machines  Co-existing with earlier versions of SySAM  Other sources of installation information  Special upgrade and downgrade instructions  Preparing to upgrade  Upgrading route versions  Updating LTL version  New and changed functionality  Known problems  Problem report location  Highlighted problems with Replication Server  delete command for multiple rows may not replicate correctly  DSI shuts down  DSI shuts down if transaction owner and standby maintenance user have same name  Warm standby replication definition not recognized for non-database owner qualified table with more than 128 columns  Decimal with exponent incorrectly translated  Effects of alter replication definition not immediate  DSI error 5147 for replication definitions with several text columns if replication definitions do not allow NULL  Adaptive Server row-level locking may cause System Table Services cache problems  Replication Server does not preprocess table names qualified with database name  Dropping a subscription that has failed causes a stack trace  Turning on hibernation mode may cause a stack trace  Language modules not listed  Cannot start Replication Server without -S flag  Replication Manager problems  New active connection suspends when created  Plug-in must be unregistered after uninstallation  Configure Replication wizard may not work under certain circumstances  Cannot specify owner and password when creating subscriptions  Status not updated when monitoring is turned on  RM does not report a failure  RM does not report reason for a secondary RMS with SUSPECT state  RM may not accurately reflect status in a three-tier environment  Replication Monitoring Services problems  RMS cannot start RepAgent if sp_addserver is not run on Adaptive Server  Sybase Central problems  Users must have write privileges to home directory  scjview.sh file cannot reference RMPlugin.jar in CLASSPATH definition  Sybase Central stops responding when command log fills up  Highlighted rs_init problems  rs_init does not update interfaces file automatically  Cannot use korean/eucksc character set to configure Replication Server with us_english/iso_1  rs_init does not support the mac character set  Default size for the RSSD log device is too small  Incompatible character set specification using rs_init  rs_init does not correct run files  Unsupported operations  Product compatibilities  Adaptive Server  Interoperability of Adaptive Server, Open Client/Server, and Replication Server  Documentation updates and clarifications  Replication Manager online help  Corrections to the Using the Interface book  Managing stored procedure replication  Stored Procedure Properties dialog box  Adding a function replication definition  Using the Function Replication Definition context menu  Adding a subscription  Using the Subscription context menu  Administration Guide  startup delay configuration parameter  Reference Manual  startup delay configuration parameter  recovery_foreground configuration parameter  Language and globalization issues  Hankaku Katakana conversion  Using trace flag 2402  Changing default date format for a language  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin Replication Server 15.0 for Windows  Accessing current release bulletin information  Product summary  Replication Server  Replication Manager  Replication Monitoring Services  IPv6 support  Master database replication  Optional features  Replication Agent and Enterprise Connect Data Access  Special installation instructions  Selecting an installation directory for Replication Server  Installing Replication Server in an existing directory  Installing Replication Server in a unique directory  Co-existing with earlier versions of SySAM  Other sources of installation information  Special upgrade and downgrade instructions  Preparing to upgrade  Upgrading route versions  Updating LTL version  New and changed functionality  Known problems  Problem report location  Highlighted problems with Replication Server  delete command for multiple rows may not replicate correctly  Memory used by Open Client/Server not tracked by Replication Server  DSI shuts down  DSI shuts down if transaction owner and standby maintenance user have same name  Warm standby replication definition not recognized for non-database owner qualified table with more than 128 columns  Decimal with exponent incorrectly translated  Effects of alter replication definition not immediate  DSI error 5147 for replication definitions with several text columns if replication definitions do not allow NULL  Adaptive Server row-level locking may cause System Table Services cache problems  Replication Server does not preprocess table names qualified with database name  Memory leak occurs with constant login and logout activity  Dropping a subscription that has failed causes a stack trace  Turning on hibernation mode may cause a stack trace  Language modules not listed  Need to reinstall SySAM  Cannot start Replication Server without -S flag  Replication Manager problems  New active connection suspends when created  Plug-in must be unregistered after uninstallation  Configure Replication wizard may not work under certain circumstances  Cannot specify owner and password when creating subscriptions  Status not updated when monitoring is turned on  RM does not report a failure  RM does not report reason for a secondary RMS with SUSPECT state  RM may not accurately reflect status in a three-tier environment  Replication Monitoring Services problems  RMS cannot start RepAgent if sp_addserver is not run on Adaptive Server  RMS executes event triggers on start-up  Event triggers are not executed if RM is not connected to RMS  RMS is not updating client applications when its status changes  Sybase Central problems  Users must have write privileges to home directory  Sybase Central stops responding when command log fills up  Highlighted rs_init problems  Adding a warm standby connection  rs_init does not update sql.ini file automatically  rs_init radio buttons appear as text fields with mixed-language message  rs_init generates a run file with a backslash if it is longer than 256 characters  Cannot use korean/eucksc character set to configure Replication Server with us_english/iso_1  rs_init does not support the mac character set  Incompatible character set specification using rs_init  rs_init does not correct run files  Limitation reading entries from sql.ini file  Highlighted problems using Adaptive Server with Replication Server  RepAgent incorrectly distributes unsigned big integer datatypes to earlier versions of Replication Server  Unsupported operations  Product compatibilities  Adaptive Server  Interoperability of Adaptive Server, Open Client/Server, and Replication Server  Documentation updates and clarifications  Replication Manager online help  Corrections to the Using the Interface book  Managing stored procedure replication  Stored Procedure Properties dialog box  Adding a function replication definition  Using the Function Replication Definition context menu  Adding a subscription  Using the Subscription context menu  Administration Guide  startup delay configuration parameter  Reference Manual  startup delay configuration parameter  recovery_foreground configuration parameter  Troubleshooting Guide  Error message changes  9202: Nested stored procedures not allowed (LTM 1033)  Language and globalization issues  Hankaku Katakana conversion  Using trace flag 2402  Changing default date format for a language  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin EAServer 5.2 for IBM AIX  Accessing current release bulletin information  Product summary  System requirements  Supported AIX versions  Required system patches  Special installation instructions  Changed functionality in this version  Known problems  EAServer Manager issues  Plug-ins not migrated when upgrading  Profiles not migrated when upgrading  Apply buttons  Default in-server ORB classes  JDK supported JDBC-ODBC driver  Systems Management  SSL certificates after upgrading  Server may terminate abnormally with JIT compiler enabled  Web Services Toolkit issues  Expired VeriSign root certificate  Eclipse runs out of memory when handling large return values  Errors in Eclipse when importing the sample applications  Using the XML-Security package  UDDI Registry not supported  UDDI search and registration  Readme and sample updates  Fixed problems  Product compatibilities  PowerBuilder  Code set interoperability  Borland JBuilder  PowerDynamo  Application Integrator  Earlier EAServer (Jaguar CTS) versions  Documentation updates and clarifications  EAServer Programmer’s Guide  Chapter 2, Understanding Transactions and Component Lifecycles  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin EAServer 5.2 for Sun Solaris  Accessing current release bulletin information  Product summary  Special installation instructions  Changed functionality in this version  Known problems  EAServer Manager issues  Starting Sybase Central  Plug-ins not migrated when upgrading  Profiles not migrated when upgrading  Apply buttons  Systems Management  SSL certificates after upgrading  Web Services Toolkit issues  Expired VeriSign root certificate  Using the Eclipse plug-in on Solaris 2.9  Eclipse runs out of memory when handling large return values  Errors in Eclipse when importing the sample applications  Using the XML-Security package  Deleting UDDI registry entries  UDDI search and registration  Readme and sample updates  Fixed problems  Product compatibilities  PowerBuilder  Code set interoperability  Borland JBuilder  PowerDynamo  Application Integrator  Earlier EAServer (Jaguar CTS) versions  Documentation updates and clarifications  EAServer Programmer’s Guide  Chapter 2, Understanding Transactions and Component Lifecycles  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  Release Bulletin EAServer 5.2 for Windows  Accessing current release bulletin information  Product summary  Supported Windows versions  Special installation instructions  Silent installation and Eclipse  Installer problems with DirectDraw support  Changed functionality in this version  Known problems  IIS 6.0 Web server redirector plug-in  IPV6 not yet supported  EAServer Manager issues  Keyboard navigation in JavaHelp  Sybase Central and connect-on-startup  Plug-ins not migrated when upgrading  Profiles not migrated when upgrading  Apply buttons  SSL certificates after upgrading  Web Services Toolkit issues  Expired VeriSign root certificate  Eclipse runs out of memory when handling large return values  Errors in Eclipse when importing the sample applications  Using the XML-Security package  UDDI search and registration  Readme and sample updates  Fixed problems  Product compatibilities  PowerBuilder  Code set interoperability  Borland JBuilder  PowerDynamo  Application Integrator  Earlier EAServer (Jaguar CTS) versions  Documentation updates and clarifications  EAServer Installation Guide  Chapter 4, Installing and Configuring a Web Server Redirector Plug-In  EAServer Programmer’s Guide  Chapter 2, Understanding Transactions and Component Lifecycles  Technical support  Other sources of information  Sybase certifications on the Web  Sybase EBFs and software maintenance  Accessibility features  RepConnector 15.0 Installation Guide for Windows, Linux, and UNIX  About this book  Overview  Introduction  Installation workflow  Installing RepConnector  Reviewing system requirements  Required servers  System configuration  Other optional software  Before installing  Reviewing environment variables  Installing and deploying RepConnector  Installing RepConnector Manager  Verifying the installation  Post-Installation Tasks  Post-installation tasks for Windows  Post-installation tasks for UNIX  Upgrading from an existing RepConnector 2.0 installation  Before upgrading  Upgrading the existing installation  Verifying the upgrade  Downgrading to RepConnector 2.0 from RepConnector 2.5  Uninstalling RepConnector 15.0  Uninstalling the RepConnector runtime component  Before uninstalling the RepConnector runtime component  Accessing the uninstall feature  Using the uninstall feature to uninstall the RepConnector runtime component  Uninstalling RepConnector Manager  Replication Server Installation Guide for Linux  About this book  Before You Begin  Introduction  Replication Server components  Installation task overview  Sybase Software Asset Management  How SySAM works  Using an unserved license  Setting up an unserved configuration  Using a network license server  Setting up a network license server  Limitations  Using multiple network license servers  Setting up multiple network servers  Using three-server redundancy  Setting up three-server redundancy  Using alternative license file locations  Co-existing with earlier versions of SySAM  Managing licenses from multiple vendors  License usage and enforcement  License availability and grace periods  If a SySAM license cannot be acquired  Acquiring SySAM licenses during the grace period  Pre-installation tasks  Read the release bulletin  Plan your replication system  Review system requirements  Review operating system patch requirements  Understand the installation directory structure  Review the Sybase installation directory contents  Installation directory after installation from the CD  Set the required environment variable for dsedit utility  Remove unwanted entries from the RPM database  Perform administrative tasks  Creating the “sybase” user account  SySAM pre-installation tasks  Choosing the appropriate license server configuration  Installing a new license server  Installing Replication Server  Using InstallShield for installation  Installing Replication Server  Installing in command line mode  Installing with a response file  Installing in console mode with a response file  Installing in silent mode  Checking for a valid installation  Troubleshooting installation  Uninstalling Sybase products  Post-Installation Tasks  Review the log files  Start Adaptive Server for the RSSD  Start the sample Replication Server  Set environment variables  SySAM Administration  Managing licenses  Using the options file to manage licenses  Starting and stopping network license servers  Borrowing a license to work offline  Enabling the network license server REPORTLOG file  Using SAMreport  SAMreport system requirements  Installing the Java Runtime Environment  Installing SAMreport  Post-installation tasks for SAMreport  Starting and Stopping SAMreport  Managing and collecting logs  Using SySAM utilities  Replication Server Installation Guide for UNIX  About this book  Before You Begin  Introduction  Replication Server components  Installation task overview  Sybase Software Asset Management  How SySAM works  Using an unserved license  Setting up an unserved configuration  Using a network license server  Setting up a network license server  Limitations  Using multiple network license servers  Setting up multiple network servers  Using three-server redundancy  Setting up three-server redundancy  Using alternative license file locations  Co-existing with earlier versions of SySAM  Managing licenses from multiple vendors  License usage and enforcement  License availability and grace periods  If a SySAM license cannot be acquired  Acquiring SySAM licenses during the grace period  Pre-installation tasks  Read the release bulletin  Plan your replication system  Review system requirements  Review operating system patch requirements  Increase operating system threads  Configure the operating system for asynchronous I/O  Understand the installation directory structure  Review the Sybase installation directory contents  Installation directory after installation from the CD  Set the required environment variable for dsedit utility  Perform administrative tasks  Creating the “sybase” user account  SySAM pre-installation tasks  Choosing the appropriate license server configuration  Installing a new license server  Installing Replication Server  Using InstallShield for installation  Installing Replication Server  Installing in command line mode  Installing with a response file  Installing in console mode with a response file  Installing in silent mode  Checking for a valid installation  Troubleshooting installation  Uninstalling Sybase products  Post-Installation Tasks  Review the log files  Start Adaptive Server for the RSSD  Start the sample Replication Server  Set environment variables  SySAM Administration  Managing licenses  Using the options file to manage licenses  Starting and stopping network license servers  Borrowing a license to work offline  Enabling the network license server REPORTLOG file  Using SAMreport  SAMreport system requirements  Installing the Java Runtime Environment  Installing SAMreport  Post-installation tasks for SAMreport  Starting and Stopping SAMreport  Managing and collecting logs  Using SySAM utilities  Replication Server Installation Guide for Windows  About this book  Before You Begin  Introduction  Replication Server components  Installation task overview  Sybase Software Asset Management  How SySAM works  Using an unserved license  Setting up an unserved configuration  Using a network license server  Setting up a network license server  Limitations  Using multiple network license servers  Setting up multiple network servers  Using three-server redundancy  Setting up three-server redundancy  Using alternative license file locations  Co-existing with earlier versions of SySAM  Managing licenses from multiple vendors  License usage and enforcement  License availability and grace periods  If a SySAM license cannot be acquired  Acquiring SySAM licenses during the grace period  Pre-installation tasks  Read the release bulletin  Plan your replication system  Review system requirements  Review operating system patch requirements  Reset the LC_ALL environment variable  Understand the installation directory structure  Review the Sybase installation directory contents  Installation directory after installation from the CD  Perform administrative tasks  SySAM pre-installation tasks  Choosing the appropriate license server configuration  Installing a new license server  Installing Replication Server  Using InstallShield for installation  Installing Replication Server  Installing in command line mode  Installing with a response file  Installing in console mode with a response file  Installing in silent mode  Checking for a valid installation  Troubleshooting installation  Uninstalling Sybase products  Post-Installation Tasks  Review the log files  Start Adaptive Server for the RSSD  Start the sample Replication Server  Set environment variables  Start Replication Server  Create a .bat file for Replication Server start-up  Start Replication Server automatically  SySAM Administration  Managing licenses  Using the options file to manage licenses  Starting and stopping network license servers  Borrowing a license to work offline  Enabling the network license server REPORTLOG file  Using SAMreport  SAMreport system requirements  Installing the Java Runtime Environment  Installing SAMreport  Starting and Stopping SAMreport  Managing and collecting logs  Using SySAM utilities  EAServer Installation for IBM AIX  About this book  Before You Install EAServer  What EAServer contains  EAServer documentation  HTML documentation  The documentation CDs  Documentation on the Web  What to install  System requirements  JDK versions  Installing EAServer  Preinstallation tasks  Installing EAServer  Upgrading, reinstalling, or adding components  Upgrading the message service  Preserving JDK customizations  Settings preserved during upgrade  Systems Management options  Installing ASA  Starting EAServer, ASA, and EAServer Manager  Connecting to EAServer through a Web browser  Installing the CocoBase Enterprise O/R evaluation software  Uninstalling EAServer  Creating Embedded EAServer Installations  Configuring and running the silent installer  Configuration and run files  Install logging parameters  Install types  Install location  License agreement  Listener ports  JDK installation parameters  License input parameters  Sybase Central installation parameters  Feature selection parameters  Specifying parameters on the command line  Silent uninstaller files  SilentUninstall_Unix.txt  SilentUninstall_Unix.sh  Troubleshooting and cleanup of the silent installer  Checking for errors  Testing the install  Cleaning up the machine  Post-installation configuration  Installing and Configuring a Web Server Redirector Plug-In  Overview  How the plug-in works  Load balancing  Failover and detecting unavailable application servers  Binding to a specific application server  Debugging  Defining a custom error page  Configuring the data source for HTTPServletRequest methods  Installing and configuring an iPlanet or Sun Java System Web server plug-in  Edit the Web server configuration files  Adding location information  Defining context paths  Adding the EASProxy object  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Installing and configuring an Apache Web server plug-in  Edit the httpd.conf configuration file  Defining context paths  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Start the Apache Web server  Configuring EAServer to accept Web server requests  Set the EAServer HTTP listener properties  Configuring HTTPS support for Web server plug-ins  HTTPS installation instructions  Enable HTTPS connections  Testing your HTTPS connections  Manage certificates for HTTPS connections  Troubleshoot HTTPS connections  Adding FIPS and TLS support to the Web server redirector plug-in  Enabling FIPS and TLS for an iPlanet 6.0 plug-in  Managing FIPS for the redirector plug-ins  Configuring Open Client and ODBC for EAServer  Overview  Configuring ODBC  Configuring Open Client  EAServer Installation for Sun Solaris  About this book  Before You Install EAServer  What EAServer contains  EAServer documentation  HTML documentation  Documentation on the Web  System requirements  Patches to install  JDK versions  What to install  Installing EAServer  Preinstallation tasks  Installing EAServer  Reinstalling or adding components  Upgrading the message service  Preserving JDK customizations  Settings preserved during upgrade  Systems Management options  Installing ASA  Starting EAServer, ASA, and EAServer Manager  Connecting to EAServer through a Web browser  Installing the CocoBase Enterprise O/R evaluation software  Uninstalling EAServer  Creating Embedded EAServer Installations  Configuring and running the silent installer  Configuration and run files  Install logging parameters  Install types  Install location  License agreement  Listener ports  JDK installation parameters  License input parameters  Sybase Central installation parameters  Feature selection parameters  Specifying parameters on the command line  Silent uninstaller files  SilentUninstall_Unix.txt  SilentUninstall_Unix.sh  Troubleshooting and cleanup of the silent installer  Checking for errors  Testing the install  Cleaning up the machine  Post-installation configuration  Installing and Configuring a Web Server Redirector Plug-In  Overview  How the plug-in works  Load balancing  Failover and detecting unavailable application servers  Binding to a specific application server  Debugging  Defining a custom error page  Configuring the data source for HTTPServletRequest methods  Installing and configuring an iPlanet, Netscape, or Sun Java System Web server plug-in  Edit the Web server configuration files  Adding location information  Defining context paths  Adding the EASProxy object  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Preload library for Netscape Enterprise Server  Installing and configuring an Apache Web server plug-in  Edit the httpd.conf configuration file  Defining context paths  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Make an entry for the Web host in the /etc/hosts file  Start the Apache Web server  Configuring EAServer to accept Web server requests  Set the EAServer HTTP listener properties  Configuring HTTPS support for Web server plug-ins  HTTPS installation instructions  Enable HTTPS connections  Testing your HTTPS connections  Manage certificates for HTTPS connections  Troubleshoot HTTPS connections  Adding FIPS and TLS support to the Web server redirector plug-ins  Enabling FIPS and TLS for the Apache 2.x plug-in  Enabling FIPS and TLS for Netscape 6.1, Sun Java System 6.x, iPlanet 4.1 plug-ins  Managing FIPS for the redirector plug-ins  Configuring Open Client and ODBC for EAServer  Overview  Configuring ODBC  Configuring Open Client  EAServer Installation for Windows  About this book  Before You Install EAServer  What EAServer contains  EAServer documentation  HTML documentation  Documentation on the Web  System requirements  Disk space requirements  JDK versions  What to install  Multiple EAServer installations on a single machine  Installing EAServer  Pre-installation tasks  Installing EAServer  Reinstalling or adding components  Upgrading the message service  Preserving JDK customizations  Settings preserved during upgrade  Systems management options  Installing ASA  Starting EAServer, ASA, and EAServer Manager  Connecting to EAServer through a Web browser  Uninstalling EAServer  Uninstalling EAServer using juninstall.bat  Installing the CocoBase Enterprise O/R evaluation software  Creating Embedded EAServer Installations  Configuring and running the silent installer  Configuration and run files  Install logging parameters  Install types  Install location  License agreement  Server and service names  Listener ports  JDK installation parameters  License input parameters  Eclipse installation parameters  Feature selection parameters  Specifying parameters on the command line  Silent uninstaller files  SilentUninstall_Win.txt  SilentUninstall_Win.bat  Troubleshooting and cleanup of the silent installer  Checking for errors  Testing the install  Cleaning up the machine  Post-installation configuration  Installing and Configuring a Web Server Redirector Plug-In  Overview  How the plug-in works  Load balancing  Failover and detecting unavailable application servers  Binding to a specific application server  Debugging  Defining a custom error page  Configuring the data source for HTTPServletRequest methods  Installing and configuring an iPlanet, Netscape, or Sun Java System Web server plug-in  Edit the Web server configuration files  Adding location information  Defining context paths  Adding the EASProxy object  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Installing and configuring an Apache Web server plug-in  Edit the httpd.conf configuration file  Defining context paths  Edit the redirector configuration file  Mapping Web server requests to EAServer listeners  Setting the redirector logging level  Copy libraries from EAServer to your Web server  Start the Apache Web server  Installing and configuring a Microsoft IIS Web server plug-in  Set the WSPLUGIN_CONFIG_FILE environment variable  Install the IIS plug-in  Edit the redirector configuration file  Copy libraries from EAServer to your Web server  Tutorial: installing the IIS plug-in on Windows  Configuring EAServer to accept Web server requests  Set the EAServer HTTP listener properties  Configuring HTTPS support for the Web server plug-ins  HTTPS installation instructions  Enabling HTTPS connections  Testing your HTTPS connections  Managing certificates for HTTPS connections  Troubleshooting HTTPS connections  Adding FIPS and TLS support to the Web server redirector plug-ins  Enabling FIPS and TLS on the IIS plug-in  Enabling FIPS and TLS for the Apache 2.x plug-in  Enabling FIPS and TLS for Netscape 6.1, or iPlanet 4.0 and 6.0 plug-ins  Managing FIPS for the redirector plug-ins  Configuring Open Client and ODBC  Overview  Configuring Open Client and ODBC  RepConnector 15.0 Configuration and User's Guide  About this book  Overview  Introduction  RepConnector architecture  Connection management tools  RepConnector process flow  Routing database events from Replication Server to messaging systems  Routing events from messaging systems to database tables  Transaction rollback  Status and error reporting  Overview of RepConnector Configuration  Basic steps  Configuring Replication Server for RepConnector  Updating the interfaces file  Understanding the information required  Adding a RepConnector entry to the interfaces file  Verifying the interfaces file entry  Verifying that Replication Server is running  Creating the connection to RepConnector  Creating the replication definition  Creating and verifying the subscription  Resuming the connection to RepConnector  Configuring the Messaging System  JMS connections  Configuring connections with specific JMS providers  Before you configure the connection  JMS configurations  Routing with JMS messaging  JMS queue  Routing from replication system to JMS topic  TIBCO RV, RVCM, and AECM connections  Routing with TIBCO RV messaging  IBM WebSphere MQ connections  Getting Started with RepConnector Manager  Starting RepConnector Manager  Managing connection profiles  Using the Properties view  Using keyboard shortcuts (Windows only)  Configuring RepConnector  Before configuring connections  Configuring the RepConnector  Configuring RepConnector for JMS Messaging Systems  Configuring RepConnector for TIBCO  Configure RepConnector for IBM WebSphere MQ  Configuring RepConnector for your database  Configuring the environment for a custom sender or formatter  Creating RepConnector connections  Configuring replication information for REPLICATION inbound types  Configuring Replication Server inbound information  Configuring Replication Server System Database (RSSD) information  Configuring JMS information  Configuring TIBCO Information  Configuring IBM Websphere MQ Information  Configuring custom plug-in information  Configuring database connection information  Managing RepConnector Connections  Managing a connection  Using the ratool Utility  ratool utility  -copy  -delete  -getLogInfo  -getProperty  -import  -list  -ping  -refresh  -refreshAll  -rename  -start  -startAll  -status  -stop  -stopAll  Using Unwired Orchestrator with RepConnector  Building business processes that interface with RepConnector  Managing single events using a single message queue  Unwired Orchestrator considerations  A simple business process  Mapping example using RepConnector Schema  Customizing the Sender and Formatter Processors  Customizing the sender processor  RepraClient interface  Sample implementation of the RepraClient interface  Customizing the formatter processor  RepTransactionFormatter interface  Sample implementation of the RepTransactionFormatter interface  Creating new custom sender and custom formatter classes  Using the DBEventParserFactory  DBEventParser APIs  package com.sybase.connector.repra.util; setSource(Object obj) throws Exception  int size()  String getDSName() throws Exception  String setDBName() throws Exception  String getEventId() throws Exception  String getOperation(int elemAt)  String getSchemaName(int elemAt) throws Exception  String getStatement() throws Exception  String setStatement(int elemAt) throws Exception  String getOwner(int elemAt) throws Exception  Vector getData(int elemAt) throws Exception  Vector getKeys(int elemAt) throws Exception  String getFieldName(Hashtable field) throws Exception  int getFieldType(Hashtable field) throws Exception  Object getFieldValue(Hashtable field) throws Exception  String toXMLText(String dtdURL) throws Exception  Using the RaXMLBuilder utility  RaXMLBuilder()  createTranDocument() throws Exception  createEventDocument() throws Exception  addOperation() throws Exception  addValue() throws Exception  addInValue() throws Exception  addOutValue() throws Exception  addWhere() throws Exception  write() throws Exception  xmlDocByteArray() throws Exception  xmlDocString() throws Exception  cancelOperation() throws Exception  getErrorEventId() throws Exception  getErrorStatusCode() throws Exception  getErrorMessage() throws Exception  String getOwner(int elementAt) throws Exception  Configuring the RaXMLBuilder  Using RaXMLBuilder in your code  Running a sample implementation  Handling error messages  Compiling and running the sample  Handling ownership information  Customizing the Message Generator for TIBCO AECM  Configuring properties for RepConnector  Connection configuration  Property file containing the Active Enterprise Connection/Customization (ae.props)  Using the base class APIs  Default TIBCO AECM message generator  Customized TIBCO AECM message generator  APIs for a customized, wire-format message generator  MClassRegistry getClassRegistry()  setClassRegistry(MClassRegistry reg)  String getOwner(int elementAt) throws Exception  String getProperty(String key)  String getProperty(String key, String defValue)  setProperties(Properties props)  Properties getProperties()  MTree createMInstance(Object repmsg) throws Exception  APIs retrieving information from the source event  Configuring and using the default wire-formatted message generator  Configuring connections  SDK application configuration with d:\sybase\eas\repra\conf\ae.props  Configuring and using the customized wire-formatted message generator  SDK application configuration sample  Code sample  Building the runtime environment for the customized message generator  Example output for TIBRV Listener and Active Enterprise wire format  Configuration Worksheets  Troubleshooting  When the profile login or ratool fails  Verifying application server environment  Verifying that the application server is called  Configuring RepConnector for debugging  Verifying machine name and port number  Verifying user name and password  When a connection fails  Verifying connection information  Verifying Replication Server inbound information  Verifying Replication Server system database information  Verifying inbound/outbound messaging systems  Verifying database connection information  Troubleshooting the replication system  Sybase Adaptive Server Enterprise (primary data base)  Replication Server  Using admin who for your connection  Changing connection grouping mode  Restarting components and connections  Purging Replication Server queues  Freeing transaction log space  Verifying sent messages  Replication Server Configuration Guide for UNIX  About this book  Preparing to Install and Configure Replication Server  Before you begin  Planning the replication system  Using the Replication Server installation worksheet  Completing the worksheet  Completing the database setup worksheet  Configuring Replication Server and Adding Databases with rs_init  Using rs_init  Using rs_init interactively  rs_init with a resource file  Starting rs_init  Configuring a new Replication Server  Adding a database to the replication system  Upgrading or Downgrading an Existing Replication Server  Preparing to upgrade  Overview  Upgrading to Replication Server 15.0  If an upgrade fails  Upgrading a user database in a replication system  Committing a local site to a new version level  Setting the replication system version  Setting the Replication Server site version  Upgrading routes  Mixed-version replication systems  Upgrading Adaptive Server in replication system  Downgrading Replication Server to an earlier version  Downgrade restrictions  Using Password Encryption  Overview  Enabling password encryption for a Replication Server  Altering an encrypted password for a Replication Server  Secure Sockets Layer  Setting up SSL services  Adding the SSL driver to the driver configuration file  Adding trusted CA certificates to the trusted roots file  Obtaining a certificate for each SSL-enabled Replication Server  Creating an identity file  Adding an encrypted password to the configuration file  Creating SSL entries in the directory service  Enabling SSL on Replication Server  Starting or Stopping a Replication Server  Starting a Replication Server  Stopping a Replication Server using isql  Replication Monitoring Services  Introducing Replication Monitoring Services  Monitoring servers in the replication domain  Installation  Configuring RMS for three-tier management support  Starting and Stopping RMS  Connecting to RMS  Installing and Implementing Heterogeneous Datatype Support  Introduction  HDS components installed with Replication Server  HDS components installed separately  HDS installation overview  HDS installation and setup procedure  Installing Replication Server database support objects  Installing datatype definitions  Installing class-level translations  Installing function strings  Creating a replicate database connection  Creating replication definitions  Creating subscriptions  Marking primary tables  Worksheets  Replication Server installation worksheet  Database setup worksheet  Using rs_init with Resource Files  Using resource file templates  Using resource files for rs_init  Editing a resource file  Using rs_init command line options  Sample Replication Server resource file  Sample Replication System  Description of the sample replication system  Setting up the example  Testing and troubleshooting the replication system  Replication Server Configuration Guide for Windows  About this book  Preparing to Install and Configure Replication Server  Before you begin  Planning the replication system  Using the Replication Server installation worksheet  Completing the worksheet  Completing the database setup worksheet  Configuring Replication Server and Adding Databases with rs_init  Using rs_init  Using rs_init interactively  rs_init with a resource file  Starting rs_init  Configuring a new Replication Server  Adding a database to the replication system  Upgrading or Downgrading an Existing Replication Server  Preparing to upgrade  Overview  Upgrading to Replication Server 15.0  If an upgrade fails  Upgrading a user database in a replication system  Committing a local site to a new version level  Setting the replication system version  Setting the Replication Server site version  Upgrading routes  Mixed-version replication systems  Upgrading Adaptive Server in replication system  Downgrading Replication Server to an earlier version  Downgrade restrictions  Using Password Encryption  Overview  Enabling password encryption for a Replication Server  Altering an encrypted password for a Replication Server  Secure Sockets Layer  Setting up SSL services  Adding the SSL driver to the driver configuration file  Adding trusted CA certificates to the trusted roots file  Obtaining a certificate for each SSL-enabled Replication Server  Creating an identity file  Adding an encrypted password to the configuration file  Creating SSL entries in the directory service  Enabling SSL on Replication Server  Starting or Stopping a Replication Server  Using the Services Manager  Starting a Replication Server  Stopping a Replication Server using isql  Replication Monitoring Services  Introducing Replication Monitoring Services  Monitoring servers in the replication domain  Installation  Configuring RMS for three-tier management support  Starting and Stopping RMS  Connecting to RMS  Installing and Implementing Heterogeneous Datatype Support  Introduction  HDS components installed with Replication Server  HDS components installed separately  HDS installation overview  HDS installation and setup procedure  Installing Replication Server database support objects  Installing datatype definitions  Installing class-level translations  Installing function strings  Creating a replicate database connection  Creating replication definitions  Creating subscriptions  Marking primary tables  Worksheets  Replication Server installation worksheet  Database setup worksheet  Using rs_init with Resource Files  Using resource file templates  Using resource files for rs_init  Editing a resource file  Using rs_init command line options  Sample Replication Server resource file  Sample Replication System  Description of the sample replication system  Setting up the example  Testing and troubleshooting the replication system  Real-Time Data Services Messaging Services User's Guide for Adaptive Server Enterprise  About this book  Introduction  RTMS messaging concepts  Automatic decisions in real time  Messaging models  JMS  Publish-and-subscribe (topics)  Point-to-point (queues)  WebSphere MQ messaging models  Message format  JMS message properties  MQ message topics  Message selectors  Understanding Real-Time Messaging Services  Sending and receiving messages from a queue  Publishing and consuming messages from a JMS topic  Working with message properties  Previewing the messaging interface  MQ overview  MQ publish/subscribe  Syntax for topics  Subscriber and publisher identities  MQ publish/subscribe examples  Transactional message behavior  Transactional messaging set option  MQ security  Connecting to the MQ queue manager  Installing MQ client on Adaptive Server host machines  Installing MQ client libraries  MQ authorizations  Configuring Real-Time Messaging Services  Configuring RTMS  Configuring Adaptive Server for MQ  Using sp_configure to configure the Q engine  max online Q engines  number of Q engines at startup  Online engines and number of CPUs  SQL Reference  Message-related global variables  <msgheader> and <msgproperties> documents  Adaptive Server-specific message properties  Keywords  Stored procedures  Built-in functions  Syntax segments  sp_config 'enable real time messaging'  sp_engine  sp_msgadmin  msgconsume  msgpropcount  msgproplist  msgpropname  msgproptype  msgpropvalue  msgpublish  msgrecv  msgsend  msgsubscribe  msgunsubscribe  endpoint  option_string  sizespec  timespec  Samples  Sybase directories  Using code samples with Replication Server function strings  Using code samples with SQL  Using code samples with Java/JDBC  Glossary  What's New in Replication Server 15.0  About this book  New Features in RMS 15.0 EBF nos. 13416, 13417, 13418, 13419, 13425  Introduction  New triggers  Partition size triggers  Queue size triggers  Connection latency triggers  Queue latency triggers  add event trigger enhancement  drop event trigger enhancement  get triggers enhancement  Replication Agent connection consolidation  add server enhancement  Displaying dbltm connection name  get connections enhancements  filter connection enhancements  New Features in Replication Server Version 15.0  Support for longer identifiers  New datatype: bigint  New unsigned integer datatypes  New Unicode datatype: unitext  Replicating computed columns  Replicating encrypted columns  Replicating partitioned tables  Larger disk partitions  Larger text and image size  Embedded Replication Server System Database (ERSSD) enhancement  New password encryption algorithm  Mixed-version enhanced support  New interface for monitors and counters  Support for isolation levels  Bidirectional replication support for DDL in MSA  Batching of commands for non-ASE servers  SySAM license management  System Changes in Replication Server 15.0  Configuration parameters  Replication Server parameters  Database connection parameters  RCL commands  System tables  System stored procedures  Function strings  Datatypes  New Features in Replication Manager 15.0  New user interface features  Two-tier management solution  Three-tier management solution  Replication Manager plug-in replaces Replication Server plug-in  Online help  Visual monitoring of status  Using the Details list  Event Log pane  Background processing  Using the Background Processes dialog box  Replication Manager logging enhancement  Script editors  Replication Manager features supported  Support for new datatypes  Support for DirectConnect  Replication support  Routes  Upgrading routes  Troubleshooting tools  Accessing the exception log  Accessing queue data  Using the View Queue Data dialog box  Connection status hide options  Filtering connection status in warm standby environments  Using connection status hide options  Warm standby wizards  Using the Add Logical Connection wizard  Using the Add Active Database wizard  Using the Add Standby Database wizard  Thread management  Using thread context menus  Viewing the Details list and other thread information  Using thread information  Introducing Replication Monitoring Services  Introducing Replication Monitoring Services  Monitoring servers in the replication environment  Software requirements and compatibilities  Installation  Starting and stopping RMS  Connecting to RMS in Sybase Central  Monitoring a replication environment using RMS  Adding and dropping servers for monitoring in Sybase Central  Adding a server  Dropping a server  Viewing monitored objects in Sybase Central  Setting configuration parameters for monitored replication objects  Monitoring a logical group of servers  Suspending or resuming components in the replication environment  Shutting down monitored servers  Generating rollup status for servers  Generating latency and heartbeat information  Adding event triggers  New Features in Replication Server Version 12.6  Multi-Site availability (MSA)  Support for symmetric multiprocessors (SMP)  The embedded RSSD (ERSSD)  Performance enhancements  Better management of empty transactions  Internal commit control for parallel processing  New Replication Server configuration parameters  New database configuration parameters  Changed database configuration parameters  date and time datatypes  Support for sending encrypted passwords  New bulk materialization method  Chinese character set (GB18030) support  System Changes in Replication Server 12.6  Configuration parameters  Replication Server parameters  Database connection parameters  RCL commands  System stored procedures  Function strings  System tables  Keywords  Replication Server 15.0 Design Guide  About this book  Conventions  Style conventions  Syntax conventions  Datatype support  Icons  Introduction  Centralized and distributed database systems  Advantages of replicating data  Improved performance  Greater data availability  Data distribution with Replication Server  Publish-and-subscribe model  Replicated functions  Transaction management  Failed replicated transactions  Transactions that modify data in multiple data servers and databases  Replication system components  Replication system domain  Replication Server  Partitions and stable queues  ID Server  Replication environment  Replication Manager  Replication Monitoring Services  Data servers  Replication Agent  Client applications  Replication management solutions  Two-tier management solution  Three-tier management solution  Connecting replication system components  Interfaces file  Routes and connections  Direct and indirect routes  Heterogeneous data server support  Client/Server Interfaces (C/SI)  Replication Agents  Processing data server errors  Functions, function strings, and function-string classes  Replication Server security  Login names  Replication Server login names  Data server login names  Data server maintenance user login name  Permissions  Network-based security  Advanced Security option  Summary  Application Architecture for Replication Systems  Application types  Decision-support applications  Multiple copies at a single site  Multiple copies distributed over a network  Distributed OLTP applications  Remote OLTP using request functions  Local update applications  Standby applications  Effects of loose consistency on applications  Controlling risks in high-value transactions  Measuring lag time  Methods for updating primary data  Centralized primary maintenance  Primary maintenance via network connections  Primary maintenance via request functions  Managing update conflicts for multiple primaries  Designing conflicts out of an application  Version-controlled updates  Implementation Strategies  Overview of models and strategies  Basic primary copy model  Using table replication definitions  Marking the table for replication  Replication definition  Subscription  Using applied functions  Stored procedures  Function replication definition  Subscriptions  Using the no-materialization method  Using bulk materialization  Distributed primary fragments model  Replication definitions  Subscriptions  Corporate rollup  Replication definitions  Subscriptions  Redistributed corporate rollup  Warm standby applications  Setting up a warm standby application  Switching to the standby database  Switching clients to the new database  Model variations and strategies  Multiple replication definitions  Replication definitions  Subscriptions  Publications  Stored procedure  Function replication definition  Table replication definition  Publication  Articles  Validation  Subscription  Request functions  A basic example using request functions  Stored procedures  Function replication definition  An example using a local pending table  Pending table  Stored procedures  Function replication definitions  Subscription  Implementing master/detail relationships  Stored procedures with insert clauses  Stored procedures with delete clauses  Stored procedures with update clauses  Function replication definitions  Subscriptions  Planning for Backup and Recovery  Protecting against data loss  Preventive measures  Standby applications  Comparing methods  Warm standby  Hardware data mirroring  Save interval  Coordinated dumps  Recovery measures  Re-creating subscriptions  Subscription reconciliation utility (rs_subcmp)  Database recovery  Restoring coordinated dumps  Introduction to Replication Agents  Replication Agent overview  Transaction log  Native transaction logs  Replication Agent transaction logs  Replication Agent products  Replication Agent for DB2  DB2 transaction log  Sybase Replication Agent  Replication Agent communications  Java implementation  Replicating Data into Foreign Data Servers  Interfacing with foreign data servers  Sybase database gateway products  Open Server gateway application  Maintenance user  Function-string class  Creating function-string classes using inheritance  Creating distinct function-string classes  Error class  rs_lastcommit table  rs_get_lastcommit function  International Replication Design Considerations  Designing an international replication system  Message language  Character sets  Character-set conversion  Unicode UTF-8 and UTF-16 support  UTF-8  UTF-16  Requirements  Guidelines for using character sets  Sort order  Subscriptions  Subscription materialization  Subscription resolution  Subscription reconciliation  Dematerialization  Unicode sort order  Changing the character set and sort order  When changing the character set changes the character width  UNIX  Windows  Summary  Capacity Planning  Overview of requirements  Replication Server requirements  Replication Server requirements for primary databases  Replication Server requirements for replicate databases  Replication Server requirement for routes  Data volume (queue disk space requirements)  Overview of disk queue size calculation  Message sizes  Change rate (number of messages)  Change volume (number of bytes)  Calculating table volume  Table volume upper bound method  Table volume sum of values method  Transaction volume  Database volume  Inbound queue size  Outbound queue volume  Failure duration  Save interval  Outbound queue size  Overall queue disk usage  Additional considerations  Example queue usage calculations  Examples, calculation parameters  Message size example calculations  Table update calculations  Begin/commit pairs  Change rate  Table volume example calculations  RSSD and log size example calculations  Inbound database volume  Inbound queue size example calculation  Outbound queue volume example calculation  Outbound queue size  Total disk queue usage example calculation  Other disk space requirements  Stable queues  RSSD  ERSSD  Logs  Memory usage  Replication Server memory requirements  RepAgent memory requirements  Overhead  Schema cache  Transaction cache  text and image cache  Other memory  CPU usage  Network requirements  Log Transfer Language  Log Transfer Language overview  connect source  Keywords  Upgrade locator  Example of connect source  get maintenance user  get truncation  Format of the origin queue ID  distribute  Command tags  origin_time  origin_qid  tran_id  mode  standby_only  Transaction-control subcommands  begin transaction  commit transaction, rollback transaction, and rollback  applied subcommand  yielding clause  Modifications to text or image data  Truncate table or partition  execute subcommand  Processing the rs_marker function  sqlddl append subcommand  dump subcommand  purge subcommand  Sample RepAgent session  Replication Server Reference Manual  About this book  Conventions  Style conventions  Syntax conventions  RCL command formatting  Datatype support  Icons  Introduction to the Replication Command Language  Data replication commands  Table replication definition commands  Function replication definition commands  Publication commands  Subscription commands  Subscription materialization  Other subscription commands  Publication subscription commands  User commands  Database interface commands  Database connection commands  Error class commands  Function and function string commands  Function-string class commands  Function string commands  Function commands  Warm standby database commands  Route commands  System information commands  Partition commands  Configuration commands  System administration commands  Recovery commands  Topics  Datatypes  Exact numeric (integer) datatypes  Exact numeric (decimal) datatypes  Approximate numeric (floating point) datatypes  Character datatypes  Entry format for character data  Money datatypes  Entry format for money data  Date/time, and date and time datatypes  Entry format for date/time values  Binary datatypes  Entry format for binary data  Bit datatype  Unicode datatypes  Upgrade issues  Mixed-version issues  Java datatypes  Datatype definitions  Identifiers  Name space for identifiers  Reserved words  Support for Adaptive Server  Character set support  Specifying character sets  Character set conversion  Sort order support  Message language support  Extended page- and column-size support  Replication Server Commands  abort switch  activate subscription  add partition  admin disk_space  admin echo  admin get_generation  admin health  admin log_name  admin logical_status  admin pid  admin quiesce_check  admin quiesce_force_rsi  admin rssd_name  admin security_property  admin security_setting  admin set_log_name  admin show_connections  admin show_function_classes  admin show_route_versions  admin show_site_version  admin sqm_readers  admin stats  admin stats, backlog  admin stats, { md | mem | mem_in_use }  admin stats, status  admin stats, reset  admin stats, { tps | cps | bps }  admin time  admin translate  admin version  admin who  admin who_is_down  admin who_is_up  allow connections  alter connection  alter database replication definition  alter function  alter function replication definition  alter function string  alter function string class  alter logical connection  alter partition  alter queue  alter replication definition  alter route  alter user  assign action  check publication  check subscription  configure connection  configure logical connection  configure replication server  configure route  create article  create connection  create database replication definition  create error class  create function  create function replication definition  create function string  create function string class  create logical connection  create partition  create publication  create replication definition  create route  create subscription  create user  define subscription  drop article  drop connection  drop database replication definition  drop error class  drop function  drop function replication definition  drop function string  drop function string class  drop logical connection  drop partition  drop publication  drop replication definition  drop route  drop subscription  drop user  grant  ignore loss  move primary  rebuild queues  resume connection  resume distributor  resume log transfer  resume queue  resume route  revoke  set autocorrection  set log recovery  set proxy  shutdown  suspend connection  suspend distributor  suspend log transfer  suspend route  switch active  sysadmin apply_truncate_table  sysadmin dropdb  sysadmin dropldb  sysadmin drop_queue  sysadmin droprs  sysadmin dump_file  sysadmin dump_queue  sysadmin erssd  sysadmin fast_route_upgrade  sysadmin hibernate_off  sysadmin hibernate_on  sysadmin log_first_tran  sysadmin purge_all_open  sysadmin purge_first_open  sysadmin purge_route_at_replicate  sysadmin restore_dsi_saved_segments  sysadmin set_dsi_generation  sysadmin site_version  sysadmin sqm_purge_queue  sysadmin sqm_unzap_command  sysadmin sqm_zap_command  sysadmin sqt_dump_queue  sysadmin system_version  validate publication  validate subscription  wait for create standby  wait for delay  wait for switch  wait for time  Replication Server System Functions  rs_batch_end  rs_batch_start  rs_begin  rs_check_repl  rs_commit  rs_datarow_for_writetext  rs_delete  rs_dumpdb  rs_dumptran  rs_get_charset  rs_get_lastcommit  rs_get_sortorder  rs_get_textptr  rs_get_thread_seq  rs_get_thread_seq_noholdlock  rs_initialize_threads  rs_insert  rs_marker  rs_raw_object_serialization  rs_repl_off  rs_repl_on  rs_rollback  rs_select  rs_select_with_lock  rs_set_ciphertext  rs_set_dml_on_computed  rs_set_isolation_level  rs_setproxy  rs_textptr_init  rs_ticket_report  rs_triggers_reset  rs_truncate  rs_update  rs_update_threads  rs_usedb  rs_writetext  Adaptive Server Commands and System Procedures  dbcc dbrepair  dbcc gettrunc  dbcc settrunc  set replication  sp_configure 'enable rep agent threads'  sp_config_rep_agent  sp_help_rep_agent  sp_reptostandby  sp_start_rep_agent  sp_stop_rep_agent  sp_setrepcol  sp_setrepdefmode  sp_setreplicate  sp_setrepproc  sp_setreptable  Adaptive Server Stored Procedures  rs_capacity  rs_delexception  rs_dump_stats  rs_fillcaptable  rs_helpclass  rs_helpclassfstring  rs_helpcounter  rs_helpdb  rs_helpdbrep  rs_helpdbsub  rs_helperror  rs_helpexception  rs_helpfstring  rs_helpfunc  rs_helppartition  rs_helppub  rs_helppubsub  rs_helprep  rs_helprepdb  rs_helproute  rs_helpsub  rs_helpuser  rs_helpreptable  rs_init_erroractions  rs_ticket  rs_ticket_report  rs_zeroltm  Executable Programs  repserver  rs_subcmp  Replication Server System Tables  rs_articles  rs_classes  rs_columns  rs_config  rs_databases  rs_datatype  rs_dbreps  rs_dbsubsets  rs_diskaffinity  rs_diskpartitions  rs_erroractions  rs_exceptscmd  rs_exceptshdr  rs_exceptslast  rs_funcstrings  rs_functions  rs_idnames  rs_ids  rs_lastcommit  rs_locater  rs_maintusers  rs_msgs  rs_objects  rs_oqid  rs_publications  rs_queuemsg  rs_queuemsgtxt  rs_queues  rs_recovery  rs_repdbs  rs_repobjs  rs_routes  rs_routeversions  rs_rules  rs_segments  rs_sites  rs_statcounters  rs_statdetail  rs_statrun  rs_subscriptions  rs_systext  rs_threads  rs_translation  rs_users  rs_version  rs_whereclauses  Replication Monitoring Services API  add event trigger  add server  configure component  configure RMS  configure server  connect to server  create group  delete group  disconnect server  drop event trigger  drop server  filter connection  get component  get group  get heartbeat  get heartbeat tickets  get network spec  get rmiaddress  get servers  get status descriptions  get threads  get triggers  get version  log level  resume component  resume Replication Agent  shutdown server  start heartbeat  stop heartbeat  suspend component  suspend Replication Agent  trace  Acronyms and Abbreviations  Replication Server Design Limits  Replication Server limits  Platform-specific limits  Replication definition and subscription limits  Function string limits  Programming limits and parameters  RMS Server and Component States  Server states  Replication Server  Adaptive Server Enterprise  Adaptive Server Anywhere and IQ  DirectConnect  Open Server  Replication Agent  RMS  Component states  Connections  Logical Connections  Queues  Routes  Partitions  RepAgent threads  Replication Server Administration Guide - Volume 1  About this book  Conventions  Style conventions  Syntax conventions  Datatype support  Icons  Introduction  About Replication Server  Asynchronous transaction replication  Advantages of replicating local data  Improved performance  Greater data availability  Replication Server and distributed database systems  Replication Server’s basic primary copy model  Replication system processing  Setting up a primary copy model system  Other distributed data models  Distributed primary fragments  Corporate rollup  Redistributed corporate rollup  Replication Server and heterogeneous data servers  Warm standby applications  Mixed-version replication systems  Restrictions in mixed-version systems  Mixed versions of Adaptive Server  Replication system security  Replication Server security features  Network-based security features  Replication Server roles and responsibilities  Replication system administrator  Database administrator  Replication Server tasks and responsibilities  Replication Server Technical Overview  Replication system components  Replication Server  ID Server  Replication system domain  Adaptive Server or other data server  Replication Agent  Which Replication Agent for your system?  Replication Server System Database (RSSD)  System tables  RSSD and Replication Agent specifications  Client applications  Sybase Central  Replication Manager (RM) plug-in to Sybase Central  Replication Monitoring Services (RMS)  Specifying data for replication  Replication definitions and subscriptions for tables  Replication definitions for database objects  Replication definitions for stored procedures  Benefits of replicated functions over normal replication  Using replicated functions  Publications  Overview of replicating tables  Commands for managing replicated data  Establishing Replication Server connections  Interfaces file  LDAP server  Making Replication Server connections  Specifying database operations  Function strings  Function-string classes  Transaction handling with Replication Server  Stable queues  Queue management  DSI thread  RSI thread  Partitions for stable queues  Using disk files for stable queues  Distributed concurrency control  Transactions that modify data in multiple databases  Failed replicate table updates  Transaction processing by the Replication Agent  Coordinating Adaptive Server log truncation  Managing Replication Server with Sybase Central  Using Replication Manager from Sybase Central  Starting and stopping Sybase Central  Starting Sybase Central  Stopping Sybase Central  Getting started  Using online help  Topic help  Tooltips  Using the Replication Manager GUI  Selecting folder and object icons  Using the Details list  Moving through the Sybase Central object tree  Customizing the display  Using keyboard shortcuts  Using menus and toolbars  Context menu  Toolbar and status bar  Viewing events in the log pane  Background processing  Using script editors  Monitoring of status  Using Hide options for connection status  Filtering connection status different instances of Replication Manager  Filtering connection status in warm standby environments  Performing common tasks  Creating an object  Viewing an object’s properties  Deleting an object  Setting up a replication environment  Preparing for a two-tier solution  Creating an environment  Connecting to and disconnecting from a replication environment  Setting up a replication environment using Replication Manager  Managing Replication Server objects  Connections  Replication definitions  Subscriptions  Queues  Using the View Queue Data dialog box  Monitoring a replication environment using RMS  Preparing for a three-tier solution  Connecting to RMS  Adding and dropping servers through RMS  Viewing managed objects  Adding event triggers  Managing a Replication System  Setting up a replication system  Creating connections and routes  Setting permissions and security  Verifying the replication system  Creating replication definitions  Creating subscriptions  Performing Replication Server tasks  Using rs_init  Managing Replication Server with Sybase Central  Using isql  Using isql interactively  Using isql to execute scripts  Starting Replication Server  Replication Server executable program  Replication Server configuration file  Shutting down Replication Server  Adding a Replication Server  Adding a replication system domain  Guidelines for adding replication system domains  Setting Replication Server configuration parameters  About configuration parameters  Different types of configuration parameters  Changing Replication Server parameters  Managing the RSSD  Enabling Failover support for an RSSD connection  Managing Embedded Replication Server System Database (ERSSD)  Overview  Before you start  Configuring ERSSD  Configuration parameters and command  ERSSD routing  Moving ERSSD files  ERSSD users  Backup  Recovery instructions  Before you start recovery  Recovery procedures  ERSSD command and options  Quiescing Replication Server  Quiescing a replication system  Removing a Replication Server  Removing an active Replication Server  Removing an inactive Replication Server  Setting Up and Managing RepAgent  Setting up RepAgent  Defining the local Adaptive Server  Enabling RepAgent on Adaptive Server  Enabling RepAgent for the database  Enabling RepAgent  Turning on log transfer  Configuring RepAgent  Starting RepAgent  Stopping RepAgent  Disabling RepAgent  Checking log files for information and error messages  Configuring RepAgent for network security  Handling extended limits  Support for longer identifiers  Reviewing status and configuration information  Viewing RepAgent information  Viewing configuration parameter values  Viewing RepAgent thread information  Managing log transfer activity  Using the log transfer commands  Suspending log transfer  Resuming log transfer  Using alter connection and the set log transfer option  Using counters to monitor RepAgent performance  Invoking sp_sysmon  Fixed time intervals  Using begin_sample and end_sample  RepAgent counter activity  Sample output  Log scan summary  Log scan activity  Transaction activity  Log extension wait  Schema cache lookups  Forward schema  Backward schema  Truncation point movement  Connections to Replication Server  Network packet information  I/O wait from Replication Server  Managing Routes  Overview  Before you begin  Routing preparations  Routing schemes  Direct routes  Indirect routes  Unsupported routing schemes  Creating routes  Using the create route command  Examples of creating direct and indirect routes  An example of creating a route and configuring parameters  Configuring a Replication Server to manage primary tables  Suspending and resuming routes  Using the suspend route command  Using the resume route command  Changing routes  Changing route topology  Changing a direct route to an indirect route  Changing the next intermediate site for an indirect route  Changing an indirect route to a direct route  Changing the password for the RSI user for a direct route  Changing parameters affecting direct routes  Changing configuration parameters for all routes  Routing modification example  Dropping routes  Using the drop route command  Using the sysadmin purge_route_at_replicate command  Upgrading routes  Monitoring routes  Displaying RSI thread status using admin who  Using the rs_helproute stored procedure  Managing Database Connections  Preparing databases for replication  Steps in preparing databases for replication  Upgrading an existing Adaptive Server database  Managing maintenance user login names  Finding the current maintenance user  Granting permissions in the database  Granting permissions for a primary database  Creating database connections  Information for adding a database connection  Adding databases for logical connections  Adding a database that requires a RepAgent thread  Using the create connection command  Altering database connections  Suspending database connections  Setting and changing parameters affecting physical connections  Changing parameters affecting a single connection  An example of using alter connection  Configuration parameters affecting individual connections  Changing parameters affecting all connections  Changing Replication Server connection parameters to improve performance  Resuming database connections  Changing replicate databases to primary databases  Creating the rs_marker stored procedure  Changing primary databases to replicate databases  Dropping database connections  Dropping a database from the ID Server  Monitoring database connections  Viewing current database connections  Listing databases managed by a Replication Server  Displaying DSI thread status  Managing Replication Server Security  Overview  Managing Replication Server system security  RSSD login names and passwords  Replication Server login name and password for the RepAgent  ID Server login name and password  Replication Server login name and password for Replication Servers  Maintenance user Adaptive Server login name and password  Sending encrypted passwords for Replication Server client connections  Existing Encrypted Password Migration  Sybase Central dependencies  Replication Server object creation dependencies  Subscriptions  Replicated functions and stored procedures  Managing Replication Server user security  Managing Replication Server login names and passwords  Creating a Replication Server login name  Changing a Replication Server password  Dropping a Replication Server login name  Enabling and disabling password encryption in sysattributes  Disabling encryption on new and existing passwords  Changing encrypted passwords in the configuration files  Managing Replication Server permissions  Requirements for creating subscriptions  Permission summary  Granting permissions  Revoking permissions  Examining users, passwords, and permissions  Using the rs_helpuser stored procedure  Querying the rs_maintusers system table  Querying the rs_users system table  Managing network-based security  How security services work  Login authentication  Message protection  Requirements and restrictions  Setting up network-based security  Modifying configuration parameters and environment variables  Configuring libtcl.cfg  Configuring objectid.dat  Configuring the interfaces file  Setting environment variables (Kerberos)  Establishing the principal user  Identifying the principal user  Identifying the principal user to the security mechanism  Identifying principal users to Replication Server  Identifying the Replication Server principal user to the replication system  Activating network-based security  Starting server and clients  Configuring security services for Replication Server  Identifying Replication Server pathways  Configuration parameters  Planning for compatible settings  Configuring default values  Examples  Configuring security for the connection to the RSSD  Configuring security for database connections  Creating a secure connection  Modifying security for a connection  Examples  Configuring security for routes  Creating a secure route  Modifying security for a route  Examples  Configuring security to the ID Server  Examples  Configuring security for the RepAgent pathway  Examples  Logging in to Replication Server  Examples of connecting to Replication Server  Borrowing security settings to secure other pathways  Maintaining network security  Using set proxy to switch logins  Disabling network-based security  Changing the security mechanism  Resetting per-target values to default values  For connections  For routes  Viewing information about security services  What security mechanisms and services are available?  What are the current security settings?  Mapping a security system login to a Replication Server login  Using more than one security mechanism  Potential security issue  Managing SSL security  SSL overview  The SSL handshake  SSL on Replication Server  Requirements  Setting up SSL security  Enabling SSL security  Managing Replicated Tables  Introduction  Planning a replication system  Design considerations  Restrictions on data replication  Preparing a replication system  Summarizing the process  Replication procedure  Commands for managing table replication definitions  Creating replication definitions  Replication definition settings  Using the create replication definition command  Specifying the replication definition name and table names  When source and destination tables share the same name  When source and destination tables have different names  Specifying the name of the source or destination table owner  Specifying column names and datatypes  When source and destination columns have different names  Datatypes in multiple primary table replication definitions  Additional columns in the replicate table  Including text, unitext, image, and Java columns  Using Special Datatypes  Using user-defined datatypes  Specifying the primary key  Specifying searchable columns  Restrictions on searchable columns  Replicating the minimal set of columns  Changing minimal columns setting  Minimal columns and rs_update and rs_delete function strings  Minimal columns and Autocorrection  Using replication definitions with warm standby applications  Specifying text, unitext, and image column replication  Specifying computed column replication  Specifying rawobject and rawobject in row column replication  Specifying column-level datatype translations  Creating replication definitions using extended limits  Before you use extended limits  Using extended limits  Wide columns  More columns  Wide data  Wide messages  Creating multiple replication definitions per table  Restrictions  Replication definitions and function strings  Replication definition restrictions in mixed-version systems  Marking tables for replication  Using the sp_setreptable system procedure  Enabling replication  Checking replication status  Enabling replication with owner_on status  Disabling replication  Replicating Java columns  Restrictions  Upgrade considerations  Java datatypes in Replication Server  Creating replication definitions for Java columns  Function strings for Java columns  Using function strings to replicate Java columns to older Replication Servers  Replicating text, unitext, image, and rawobject columns  Creating a text, unitext, image, or rawobject replication definition  Specifying a null value for text, unitext, image, and rawobject columns  Marking tables with text, unitext, image, or rawobject columns  Changing column status for text, unitext, image, or rawobject columns  Enabling column replication  Disabling column replication  Enabling or disabling replication for all columns  Altering replication status for text, unitext, image, and rawobject columns  Changing from replicate_if_changed to always_replicate  Changing from always_replicate to replicate_if_changed  Resolving inconsistencies in replication status  Scenario 1  Setting replicate_if_changed  Setting always_replicate  Scenario 2  Setting do_not_replicate  Setting always_replicate or replicate_if_changed  Subscription issues for replicate_if_changed status  Function strings for replicating text, unitext, and image data  Replicating computed columns  Replicating encrypted columns  Working with special datatypes  Using the rs_address datatype  Replicating IDENTITY columns  Specifying an IDENTITY column in a replication definition  How Replication Server replicates IDENTITY columns  Modifying replication definitions  Maintaining table schema  Migration procedure  alter table support for replicate databases  Recovery procedures  Viewing existing replication definitions  Altering replication definitions  Providing a different replicate table name  Changing the specified columns  Adding a column  Dropping a searchable column  Adding or dropping primary keys  Altering column datatypes  Providing a different replicate column name  Changing text, unitext, image, and rawobject replication status  Adding a searchable column  Changing minimal column replication  Altering a replication definition for warm standby replication  Dropping replication definitions  Modifying replicated data  Adding a new table  Renaming replicated tables  Dropping a replicated table  Adding columns in source and destination tables  Deleting columns in a source or destination table  Changing searchable columns  Dropping a searchable column  Changing column datatypes in a source or destination table  Using publications  Using publications to replicate data at the command line  Commands for creating and managing publications  Creating publications and articles at the command line  Specifying a where clause with the create article command  Viewing publication information  Display publication dtatus and number of articles  Display publication and article information  Altering publication information  Adding articles to a publication  Dropping publications  Dropping associated replication definitions  Dropping articles  Dropping the associated replication definition  Translating datatypes using HDS  Overview  Getting started  Creating class-level translations  Adding class-level translations to an existing connection  System-defined variables  Creating column-level translations  How datatype definitions work  Column-level translations and multiple replication definitions  Using class-level and column-level translations together  Verifying translations  Managing Replicated Functions  Prerequisites and restrictions  Replicated function prerequisites  Replicated function restrictions  Commands for managing function replication definitions  Using replicated functions  Applied functions  Request functions  Implementing an applied function  Implementing a request function  Marking stored procedures for replication  Subscribing to replicated functions  Modifying or dropping replicated functions  Before modifying a function replication definition  Modifying a function replication definition  Dropping a function replication definition  Creating or modifying a function string for a replicated function  Using publications for stored procedures  Managing Subscriptions  Overview  Subscription materialization methods  Atomic materialization  Incremental atomic materialization  Nonatomic materialization  Using autocorrection  No materialization  Bulk materialization  Stop updates at the primary database and take a snapshot  Simulate atomic materialization  Simulate nonatomic materialization  Dematerialization processing  Dematerializing and purging rows  Dematerialization without purging rows  Monitoring materialization and dematerialization  Before you create subscriptions  Using subscription commands  Using the where clause  Enabling replication of truncate table  Using the create subscription command  Using create subscription for atomic materialization  Using create subscription for nonatomic materialization  Using create subscription for no materialization  Using the define subscription command  Using the activate subscription command  Using the validate subscription command  Using the check subscription command  Using the drop subscription command  Subscription example  Description of replication system  Procedures for replicating tables  Materializing text, unitext, image, and rawobject data  Nonatomic materialization  Row migration  Subscriptions for columns with heterogeneous datatypes  Bitmap subscriptions  Obtaining subscription information  Displaying subscription information  Verifying subscription consistency  Using rs_subcmp to locate and correct inconsistencies  Using publication subscriptions  Commands for creating and managing publication subscriptions  Enabling replication of the truncate table command  Creating publication subscriptions  Using the create subscription command  Specifying a materialization method  Refreshing publication subscriptions  Creating publication subscriptions with bulk materialization  Using the define subscription command  Using the activate subscription command  Using the validate subscription command  Refreshing publication subscriptions using bulk materialization  Dropping subscriptions for publications and articles  Viewing publication subscription information  Display status information  Managing Replicated Objects Using Multi-Site Availability  Overview  Setting up an MSA system  Replicating the database  Replicating tables and functions  Using replicate databases as warm standby databases  Switchover  Marking data for replication  Managing database replication definitions  Altering database replication definitions  Dropping database replication definitions  Using database replication filters  Viewing information about database replication definitions  Using database, table, and function replication definitions concurrently  Altering database replication definitions  Altering table and function replication definitions  Managing database subscriptions  Materialization  Subscription without materialization  Subscription with bulk materialization  Altering database subscriptions  Dropping database subscriptions  Viewing information about database subscriptions  Using database, table, and function subscriptions concurrently  Creating and dropping subscriptions  Replicating DDL and system procedures  Replicating user stored procedures  Customizing function strings  Replication Server Administration Guide - Volume 2  About this book  Verifying and Monitoring Replication Server  Checking replication system log files for errors  Verifying a replication system  Monitoring Replication Server  Verifying server status  Visual monitoring of status  Displaying replication system thread status  Using system information commands  Setting and using threshold levels  Monitoring partition percentages  Customizing Database Operations  Overview  Working with functions, function strings, and classes  Functions  System functions  User-defined functions  Function scope  Summary of system functions  System functions with function-string-class scope  System functions with replication-definition scope  Function strings  Input and output templates  Applications for customized function strings  System functions with multiple function strings  Function-string classes  System-provided classes  Function-string inheritance  Restrictions in mixed-version systems  Managing function-string classes  Creating a function-string class  Creating a derived class  Creating a base class  Primary site for a function-string class  Changing the primary site for a function-string class  Assigning a function-string class to a database  Dropping a function-string class  Managing function strings  Function strings and function-string classes  Function-string input and output templates  Requirements for using input and output templates  Using output templates  Language output templates  RPC output templates  Output templates for rs_writetext function strings  Using input templates  Class in which to create function strings  Using function-string variables  Function-string variable formatting  Creating function strings  Guidelines for creating function strings  Altering function strings  Dropping function strings  Restoring default function strings  Creating empty function strings with the output template  Remapping table and column names with function strings  Defining multiple commands in a function string  Using declare statements in language output templates  Displaying function-related information  Obtaining information using the admin command  Obtaining information using stored procedures  Using the default system variable  Extending default function strings  Using replicate minimal columns  Using function strings with text, unitext, image, and rawobject datatypes  Using output writetext for rs_writetext function strings  Using output none for rs_writetext function strings  Heterogeneous replication and text, unitext, image, and rawobject data  Managing Warm Standby Applications  Overview  How a warm standby works  Database connections in a warm standby application  Primary and replicate databases and warm standby applications  Comparison of database relationships  Warm standby requirements and restrictions  Function strings for maintaining standby databases  What information is replicated?  Comparing replication methods  Using sp_reptostandby to enable replication  Restrictions and requirements when using sp_reptostandby  Supported DDL commands and system procedures  Replicating alter table: limitations  Disabling replication  Using sp_setreptable to enable replication  Using sp_setrepproc to copy user stored procedures  Replicating tables with the same name but different owners  Replicating text, unitext, image, and rawobject data  When warm standby involves a replicate database  Changing replication for the current isql session  Forcing replication of DDL commands to the standby database  Turning off all replication to the standby database  Setting up warm standby databases  Before you begin  Client application issues  Task one: Creating the logical connection  Naming the logical connection  Procedure for creating the logical connection  Reconfiguring and restarting RepAgent  Task two: Adding the active database  Task three: Enabling replication for objects in the active database  Enabling replication for objects added later  Task four: Adding the standby database  Creating the standby database  Determining how to initialize the standby database  Adding the standby database maintenance user  Adding the standby database to the replication system  Enabling replication for objects in the standby database  Granting permissions to the maintenance user  Switching the active and standby databases  Determining if a switch is necessary  Before switching active and standby databases  Internal switching steps  After switching active and standby databases  Making the switch  Disconnect client applications from the active database  Procedure for switching the active and standby databases  Using a blocking command for switch active  Monitoring the switch  Aborting a switch  Restart client applications  Resolving paper-trail transactions  Manage the old active database  Bringing the old active database online as the new standby  Monitoring a warm standby application  Replication Server log file  Standby connection created  Standby connection resumed after initialization  Commands for monitoring warm standby applications  admin logical_status  admin who, dsi  admin who, sqm  admin sqm_readers  Setting up clients to work with the active data server  Two interfaces files  Symbolic data server name for client applications  Map client data server to currently active data server  Altering warm standby database connections  Altering logical connections  Changing parameters affecting logical connections  Disabling the Distributor thread  Replicating truncate table to standby databases  Altering physical connections  Configuring triggers in the standby database  Configuring replication in the standby database  Changing configuration parameters in the standby database  Dropping logical database connections  Dropping a logical database from the ID Server  Warm standby applications using replication  Warm standby application for a primary database  Warm standby application for a replicate database  Configuring logical connection save intervals  Using replication definitions and subscriptions  Creating replication definitions for warm standby databases  alter table support for warm standby  No replication definition  alter table add column with default  Warm standby with no send standby clause  Warm standby with send standby all columns clause  Warm standby with send standby replication definition columns clause  Using replication definitions to optimize performance  Using replication definitions for tables with more than 1024 columns  Using replication definitions to copy redundant updates  Using subscriptions with warm standby application  Restrictions on using subscriptions  Subscription materialization for logical primary database  Subscription materialization for logical replicate database  Checking subscriptions  Dropping subscriptions  Missing columns when you create the standby database  Loss detection and recovery  Performance Tuning  Replication Server internal processing  Threads, modules, and daemons  Processing in the primary Replication Server  Replication agent user thread  Stable Queue Manager thread  Stable Queue Transaction thread  Distributor thread and related modules  Subscription Resolution Engine  Transaction Delivery module  Message Delivery module  Data Server Interface threads  Replication Server Interface thread  Miscellaneous daemon threads  Processing in the replicate Replication Server  RSI user thread  Configuration parameters that affect performance  Replication Server parameters that affect performance  Stable devices: considerations  Connection parameters that affect performance  Route parameters that affect performance  Suggestions for using tuning parameters  Setting the amount of time SQM Writer waits  Caching system tables  Setting wake up intervals  Sizing the SQT cache  Controlling the number of network operations  Controlling the number of outstanding bytes  Controlling the number of commands the RepAgent executor can process  Specifying the number of stable queue segments allocated  Selecting disk partitions for stable queues  Making SMP more effective  Specifying the number of transactions in a group  Database configuration parameter : dsi_max_xacts_in_group  Database configuration parameters: dsi_xact_group_size and dsi_max_xacts_in_group  Setting transaction size  Using parallel DSI threads  Benefits and risks  Parallel DSI parameters  Components of parallel DSI  DSI scheduler thread  DSI executor threads  Processing transactions with parallel DSI threads  Small transactions  Large transactions  Selecting isolation levels  Transaction serialization methods  no_wait  wait_for_start  wait_for_commit  Partitioning rules: reducing contention and increasing parallelism  Using transaction-partitioning rules  Partitioning rule: origin  Partitioning rule: origin and process ID  Partitioning rule: none  Partitioning rule: user  Partitioning rule: origin time begin and commit times  Partitioning rule: name  Partitioning rule: ignore origin  Using multiple transaction rules  Grouping logic and transaction partitioning rules  Resolving conflicting updates  Resolving conflicts internally using the rs_dsi_check_thread_lock function string  Function strings for internal commit control  Using rs_threads to resolve conflicts externally  Handling deadlocks  Function strings for commit control using rs_threads  Configuring parallel DSI for optimal performance  Before you begin  Reducing contention  Using partitioning rules  The transaction name rule  The user name rule  The origin begin and commit times rule  Combining partition rules  Frequent conflicting updates  Infrequent conflicting updates  Using isolation levels  Setting the size for large transactions  Parallel DSI and the rs_origin_commit_time system variable  Using multiprocessor platforms  Enabling multiprocessor support  Monitoring thread status  Monitoring performance  Allocating queue segments  Choosing disk allocations  An example  Dropping hints and partitions  Using the heartbeat feature in RMS  Using Counters to Monitor Performance  Introduction  Modules and counters: an overview  Counters  Sampling  Collecting statistics for a specific time period  Specifying the counters to be sampled  Specifying the sample period  Specifying how statistics are to be reported  Displaying statistics on the computer screen  Saving statistics in the RSSD  Collecting statistics for an indefinite time period  Viewing statistics on screen  Viewing throughput rates  Viewing statistics about messages and memory use  Viewing the number of transactions in the stable queues  Viewing statistics saved in the RSSD  Using the rs_dump_stats procedure  Viewing information about the counters  Resetting counters  Handling Errors and Exceptions  General error handling  Error log files  Replication Server error log  Informational messages  Error and warning messages  Finding the name of the Replication Server error log  Changing to a new Replication Server log file  RepAgent error log messages  Sample error messages  Data server error handling  Creating an error class  Initializing a new error class  Dropping an error class  Changing the primary Replication Server for an error class  Displaying error class information  Assigning actions to data server errors  Displaying assigned actions for error numbers  Exceptions handling  Handling failed transactions  Suspend database connection  Analyze and resolve the problem  Resume the connection  Accessing the exceptions log  Displaying transactions in the exceptions log  Querying the exceptions log system tables  Deleting transactions from the exceptions log  DSI duplicate detection  Duplicate detection for system transactions  Replication System Recovery  How to use recovery procedures  Configuring the replication system to support Sybase Failover  Overview  Enabling Failover support in Replication Server  How Sybase Failover works with Replication Server  Requirements  Enabling Failover support for an RSSD connection  Enabling Failover support for non-RSSD database connections  Configuring the replication system to prevent data loss  Save interval for recovery  Routes between Replication Servers  Connections between Replication Servers and data servers  Setting the save interval for connections  Backing up the RSSDs  Creating coordinated dumps  Recovering from partition loss or failure  Procedure for recovering from partition loss or failure  Message recovery from off-line database logs  Message recovery from the online database log  Recovering from truncated primary database logs  Truncated message recovery from the database log  Recovering from primary database failures  Loading from coordinated dumps  Loading a primary database from dumps  Recovering from RSSD failure  Recovering an RSSD from dumps  Basic RSSD recovery procedure  Subscription comparison procedure  Using rs_subcmp on replicated RSSD system tables  Classes and system tables  Example  Reconciling with upstream RSSDs  Reconciling downstream RSSDs  Subscription re-creation procedure  Deintegration/reintegration procedure  Recovery support tasks  Rebuilding stable queues  Rebuilding queues online  Rebuilding queues from off-line database logs  Using standalone mode  Loss detection after rebuilding stable queues  SQM loss between two Replication Servers  DSI loss between a Replication Server and its databases  Handling losses  Setting log recovery for databases  Loss detection after setting log recovery  Determining which dumps to load  Adjusting database generation numbers  Determining database generation numbers  Dumps and database generation numbers  Asynchronous Procedures  Overview  Logging replicated stored procedures  Logging replicated stored restrictions  Mixed-mode transactions  Applied stored procedures  Request stored procedures  Asynchronous stored procedure prerequisites  Steps for implementing an applied stored procedure  Warning conditions  Steps for implementing a request stored procedure  Specifying stored procedures and tables for replication  Managing user-defined functions  Creating a user-defined function  Adding parameters to a user-defined function  Dropping a user-defined function  Mapping to a different stored procedure name  Specifying a nonunique name for a user-defined function  High Availability on Sun Cluster 2.2  Introduction  Terminology  Technology overview  Configuring Replication Server for high availability  Configuring Sun Cluster for HA  Installing Replication Server for HA  Installing Replication Server as a data service  Administering Replication Server as a data service  Data service start/shutdown  Logs  Glossary  Replication Server Heterogeneous Replication Guide  About this book  Sybase Replication System Overview  Basic replication concepts  Heterogeneous replication  Replication system components  Primary data server  Replication Agent  Replication Server  Database gateway  Replicate data server  Sybase Replication Components  Sybase replication technology  Replication Server  Replication Agent  ECDA database gateways  ECDA and DirectConnect names and packaging  Heterogeneous Replication Issues  Overview of heterogeneous replication issues  Heterogeneous replication limitations  Stored procedure replication  Owner-qualified object names  Large object replication  Setup for replicate databases  Replication Server support for encrypted columns  Subscription materialization  Replication Server rs_dump command  Replication Server rs_marker command  Replication Server rs_dumptran command  Replication Server rs_subcmp utility  Data Server Issues  Primary data servers  DB2 Universal Database primary data servers  DB2 Universal Database primary data servers on OS/390  DB2 Universal Database primary data servers on UNIX or Windows  Informix Dynamic Server primary data servers  Microsoft SQL Server primary data servers  Oracle primary data servers  Replicate data servers  DB2 Universal Database replicate data servers  DB2 Universal Database replicate data servers on OS/390  DB2 Universal Database replicate data servers on UNIX or Windows  Informix Dynamic Server replicate data servers  Microsoft SQL Server replicate data servers  Oracle replicate data servers  Component Integration Services  Replication Server Issues  Relationship with other system components  Relationship with Replication Agents  Database connections  Replication Agent User thread  DSI thread  Replication Agent connections  DirectConnect database gateways  Maintenance User  Replication Server heterogeneous datatype support  Datatype translation  HDS issues and limitations  Command batching for non-ASE servers  Using function strings  Using connection settings  Order of processing  DSI Configuration  Emulating rs_init activity for a non-Sybase database  Case sensitivity in publications and subscriptions  Replication System Configuration Examples  Non-Sybase primary to Adaptive Server replicate  Replication system components  Replication system issues  Adaptive Server primary to non-Sybase replicate  Replication system components  Replication system issues  Non-Sybase primary to non-Sybase replicate  Replication system components  Replication system issues  Bidirectional non-Sybase to non-Sybase replication  Replication system components  Replication system issues  Administering Heterogeneous Replication Systems  Replication system maintenance  Primary data servers and Replication Agents  Replication Server  Replicate data servers and DirectConnect gateways  Troubleshooting Heterogeneous Replication Systems  Troubleshooting overview  Inbound and outbound queue problems  Inbound queue problems  Outbound queue problems  Replication failure problems  Trigger-based logging failures  Replicate database is not updated  Troubleshooting specific errors  Date information does not include time values  Updates to rs_lastcommit fail  Expected datatype translations do not occur  Replication Agent triggers do not fire  Determining log scan position  LTL generation and tracing  Replication Agent for DB2 UDB for OS/390  Sybase Replication Agent  Datatype Translation and Mapping  DB2 datatypes  DB2 class-level translations  Replication Server datatype names for DB2  Informix datatypes  Informix class-level translations  Replication Server datatype names for Informix  Microsoft SQL Server datatypes  Microsoft SQL Server class-level translations  Replication Server datatype names for Microsoft SQL Server  Oracle datatypes  Oracle class-level translations  Replication Server datatype names for Oracle  Materialization Issues  Materialization overview  Unloading data from a primary database  Datatype translation issues  Loading data into replicate databases  Atomic bulk materialization  Preparing for materialization  Performing atomic bulk materialization  Nonatomic bulk materialization  Preparing for materialization  Performing nonatomic bulk materialization  Heterogeneous Database Reconciliation  Sybase rs_subcmp utility  Database comparison application  Replication with Adaptive Server Anywhere  ASA primary data servers  ASA replicate data servers  Glossary  Replication Server Troubleshooting Guide  About this book  Identifying the Problem  Overview  Tasks or events that can cause replication system problems  Reduced replication system performance  Poor performance and stable queue size increasing  Types of problems  Configuration problems  Subscription problems  Using incorrect variables in function strings  Replication problems  Manual recovery problems  Analyzing error logs  rs_init  Replication Server error log  Diagnostic tools  Troubleshooting configuration problems  Troubleshooting subscription failures  Materialization  Dematerialization  Troubleshooting replication failures  Identify the data that is failing to replicate  Verify that Replication Server threads are up  Replication Server is down  Verify that it is not a queue problem  Verify that all RepAgents are up  Whether only text, unitext, and image columns are not replicated  Check system tables  Activate traces and dump queues  Verify that no route problems exist  Troubleshooting manual recovery problems  Analyzing Error Messages  Overview  What is not covered  Replication Server errors  Error message format  Severity  Error numbers  Analyzing Replication Server error messages  Example  RepAgent error messages  RepAgent error message format  Example  Analyzing RepAgent error messages  Example  Common Errors  Finding the error description  Error description format  rs_init error message descriptions  Could not find entry for Adaptive Server  Unknown host machine name  Replication Server error message descriptions  21: Open Server call to routine srv_spawn failed.  1028: data server errors  DSI shuts down because of SQL error in transaction  Adaptive Server and DB2 table names do not match  Adaptive Server last-chance threshold passed  DSI shuts down because replicate database log is full  Accessing a database while in recovery  7035: Replication Server out of memory  11061: RSSD problems  RSSD deadlocks  RSSD log device full  13045: replication suspended because RSSD restarted  15020: replication definition could not be found  15040: no connection to replicate database  15052: primary and replicate database cannot be the same  28028: connect source not executed  29024: no matching function strings found  37022: primary subscribe permission required  37023: create object permission required  Replication Server informational and warning messages  A cached row for system table was swapped out  Detecting loss for database  DSI detected rs_update_lastcommit not marked as replicated  Stable storage use is above 75 percent  RepAgent error message descriptions  9202: nested stored procedures not allowed  9210: network problems  9215: log truncated (ASE 624)  Route Problems  Overview  Using the rs_helproute stored procedure  Problems with creating routes  Common problems  Messages in the error log at the source Replication Server  Output from rs_helproute at the source Replication Server  Output from rs_helproute at the destination server  Problems with altering routes  Problems with dropping routes  Dropping routes  Output from rs_helproute at the source Replication Server  Output from rs_helproute at the destination server  Dropping routes using the with nowait option  Output from rs_helproute at the source Replication Server  Subscription Problems  Overview  Using check subscription  Materialization problems  Common problems  Incorrect or missing login account and permissions  User requirements for creating subscriptions  Maintenance user permissions  Schema inconsistency  Conflicting table or view in the primary database  Conflicting table or view in the replicate database  Missing rs_select function string  Missing interfaces file entries  Atomic materialization  Nonatomic materialization  Bulk materialization  Defining the subscription  Activating the subscription  Validating the subscription  Dematerialization problems  with purge dematerialization  Bulk dematerialization  Replication Server Interface Problems  Overview  Connection errors  Incorrect RSI user login name or password  Incorrect user permissions at replicate Replication Server  Invalid RSI locater  RepAgent Problems  Overview  Problems when starting the RepAgent  Invalid login  Invalid permissions  Errors from the Replication Server  Normalization errors  Treating normalization errors as recoverable  Replication status inconsistency of text, unitext, or image columns  When replicate_if_changed conflicts with always_replicate  When do_not_replicate columns are included in the replication definition  Errors from the Adaptive Server  Dropping primary objects  Invalid truncation page  Data Server Interface Problems  Overview  Listing databases and using admin who and admin who, dsi  Listing databases controlled by a Replication Server  Checking the DSI status for a database connection  Troubleshooting procedure  DSI down or suspended  Connection failure to the database  Asynchronous transaction connection failures  Data server errors  Skipping transactions  Customized handling of data server errors  Replication Server errors  DSI active  Incorrect duplicate transaction resolution  Examining the exceptions log  Adaptive Server Log Problems  Overview  Truncating an Adaptive Server log  Verifying the state of the secondary truncation point  Turning off the secondary truncation point in a database  Setting the secondary truncation point  Resetting the locater  Log truncation problems  Orphaned transactions  Inbound queue requires more disk space  Adaptive Server log corruption  Replication Monitoring Services Problems  Overview  RMS tracing  Common Problems  Using the RMS with UAF version 2.0  Using multiple UAF servers on the same computer  Using RMS heartbeat with Replication Server 12.6  Monitoring the ASA Replication Agent  Dumping Stable Queues  Introduction  Using trace  Using sysadmin dump_queue  Confirming suspected problems  sysadmin dump_queue examples  Interpreting the output of a dump queue  Example 1: outbound queue after create subscription  Output  Explanation  Example 2: inbound queue  Output  Explanation  Example 3: inbound queue  Output  Explanation  Example 4: outbound queue after update  Output  Explanation  Using sysadmin sqt_dump_queue  Using sysadmin dump_file  sysadmin purge commands  Language, Sort Order, and Character Set Issues  Overview  Message language  Stored procedure messages  Other situations that produce mixed languages  Sort order  Sort order problems  Character sets  Replication Server System Tables Diagram  What's New in EAServer 5.2  New features in EAServer 5.2  Automatic performance tuning  EAServer Manager enhancements  In-memory mirror caching  FIPS and TLS support  New features in EAServer 5.1  EAServer Manager enhancements  Preferences dialog  New wizards  Log file viewer enhancements  Importing and exporting a single component  Web application synchronization enhancement  Instance pool monitoring  Running components externally  IPV6 support  Server performance monitoring  Custom class loader enhancements  Systems Management  The EASDefault Web application  Jagtool enhancements  Web application synchronization enhancement  New flushstaticpage command  Alternate Solaris Java threading model  Private UDDI registry security enhancements  New features in EAServer 5.0  EAServer Manager enhancements  New wizards  Undeployment of packages, Web applications, and applications  HTTP directory browsing  EAServer Transaction Manager  Java Connection Management enhancements  Enhanced systems management support  Enhanced Solaris C++ compiler support  Server logging enhancements  Logging APIs  Managing log profiles  Runtime monitoring enhancements  Admin role granularity  Web Services Toolkit  jagtool enhancements  PowerDynamo Web site conversion utility  Servlet response caching improvements  Partial page caching  New Features in EAServer Versions 4.2.3, 4.2.2, 4.2.1, and 4.2  New features in version 4.2.3  Server stack size  Sharing of JSP class files  Suppressing SSL error messages  Servlet authenticated session enhancement  Jagtool enhancements  Installing and removing service components  Retrieving runtime monitoring statistics  New jmsmanage_selectors command  New jmsmanage_listeners command  Web server redirector enhancements  Support for Netscape Enterprise Server 6.1  New Web application property  Custom error page for redirector  New features in version 4.2.2  Netegrity SiteMinder Integration  Custom security component API changes  Support for multiple JAAS configuration file sections  Retrieving additional user session details in a JAAS login module  Retrieving HTTP session information in a custom authentication service  Supporting external single sign-on providers  Changing the effective user ID for the server process  Multiple listener hosts  Standalone jagtool  Enhanced Windows service support  Adaptive Server Enterprise wide table support  Enhanced character set support  Apache Web server redirector supports EAPI  New EJB CMP component properties  CMP isolation level  Table-level timestamps  Soft locking  Generated entity bean subclasses  EJB session bean passivation  Message service enhancements  New features in version 4.2.1  Web application form login enhancements  EJB pass-by-reference support  Database set-proxy support for EJB CMP entity beans  SSL connection troubleshooting enhancement  New features in version 4.2  In-memory HTTP session replication  Pooled component destruction  New Features in EAServer Versions 4.1.3, 4.1.2, 4.1.1, and 4.1  New features in version 4.1.3  Performance tuning features  Lightweight EJB container  CMP JDBC wrapper drivers  Thread monitors  Entity instance caching with Oracle  New server properties  New connection cache properties  HTTPS support for Web server plug-ins  Jagtool merge_props command  Java connection manager API change  New features in version 4.1.2  JDK 1.4  New performance tuning features  Connection request pool size (Solaris only)  Flow control  Servlet buffer pool  Servlet Java cache  Direct-access pseudocomponents  JavaServer Pages compilation speed  jagtool enhancements  Client connection timeouts  Web server redirector plug-in configuration  Web application authentication  APPLET context parameter for EJB clients  Web application character set properties  HTTP session attribute API change  New features in version 4.1.1  Message Bridge for Java enhancements  Java Secure Sockets Extension support  Named instance pools  New features in version 4.1  EJB 2.0 container-managed persistence enhancements  Web services support  Message Bridge for Java™  Deployment enhancements  Web server redirector for Microsoft Internet Information Server  HTTP response caching enhancements  Connection caching enhancements  jagtool enhancements  Servlet and Web application interface changes  Maintaining authenticated sessions  EJB 2.0 component behavior in EAServer 4.0 versus 4.1  New Features in EAServer 4.0  J2EE 1.3 support  Performance enhancements  JDK 1.3 and Hotspot VM integration  Servlet response caching  Entity component instance and query caching  In-memory state replication for stateful session components  EJB 2.0 support  Message-driven beans  Home interface methods  Local interfaces  EJB 2.0 interoperability  CMP enhancements  Message service enhancements  Java Message Service API support  Message-driven bean support  EAServer Manager enhancements  Servlet, JSP, and Web application enhancements  Servlet filters and application lifecycle event handlers  JSP 1.2 support  Standard extensions  Web server redirector plug-in  Java XML parser integration  J2EE connectors  J2EE naming enhancements  J2EE security enhancements  Enhanced transaction support  HTTP 1.1 support  Enhanced C++ component support  Java deployment enhancements  New custom class loaders  Deployment and code generation performance  Systems management enhancements  Server and EAServer Manager start-up scripts  Globally available connection caches  Java class file consolidation  Automated installation and configuration tools  Repository versioning  EAServer Feature Guide  About this book  Introducing EAServer  Overview  EAServer execution engine  Component support  J2EE platform support  Network protocol support  Dynamic HTML support  PowerDynamo Web site conversion utility  Web server redirector plug-in  Administration and development tools  Client-session and component-lifecycle management  Naming services  Connection caching  Transaction management  Localization  Result-set support  Support for asynchronous messaging  Asynchronous processing support  Systems management support  Support for legacy Open Server applications  IPV6 support  Developing an EAServer Application  Introductory concepts  Developing an EAServer application  EAServer runtime environment  EAServer Components  Overview  Enterprise JavaBeans components  EJB component types  Stateful session beans  Stateless session beans  Entity beans  EJB transaction attribute values  EJB container services  Java components  CORBA-C++ components  PowerBuilder components  ActiveX components  C components  Web Applications  What is a Web application?  Contents of a Web application  Servlet files  JSP files and tag libraries  Static files  Java classes  Deployment descriptor  Using PowerDynamo with EAServer  EAServer and PowerDynamo architecture  Calling EAServer components from PowerDynamo scripts  Using MASP verses ActiveX and Java  Setting up PowerDynamo as a client  Using Message Bridge for Java with EAServer  Message Bridge overview  Using Message Bridge  Message Bridge and EAServer architecture  For more information  EAServer System Administration Guide  About this book  Getting Started  Starting the Jaguar server  Using EAServer Manager  Starting EAServer Manager  Disconnecting from EAServer  Administration password and OS authentication  Shutting down a server  Verifying your environment  Sybase Central Overview  Overview  Start-up options  EAServer Manager  Profile Manager  Certificates folder and the standalone Security Manager  Keyboard navigation  Creating and Configuring Servers  Creating or deleting a server  Configuring servers  General  Java VM  HTTP Config  Configuring redirection addresses when using a proxy server  HTTP logging and statistics  Transactions  Resources  Log/Trace  Handlers  Naming Service  Naming server options  Naming server strategy  Servlets  PowerDynamo  Hot Standby  JAXP Support  Java Classes  Java Debug  Static Page Caching  HTTP Custom Response Header  HTTP Directory Browsing  Components  Advanced  Configuring listeners  Preconfigured listeners  Listener failover  Creating and configuring listeners  Starting the server  Changing the effective user ID of the server process  Using the JagRepair server  Configuring log profiles  Configuring the server’s log profile  Configuring log profiles  Category names  Category properties  Handler properties  Formatter properties  Using log profiles in Java client applications  Configuring server stack size  IPV6 support  Server support for IPV6  Client support for IPV6  Using Admin mode  Putting servers into Admin mode  Switching to Ready mode  Creating clients that connect to Admin mode servers  Operating system configuration  Database Access  Connecting to databases  Sybase Adaptive Server Anywhere  Sybase Adaptive Server Enterprise and gateways  Oracle databases  Other databases  Configuring connection caches  General properties  About JDBC connection URLs  About ODBC data source names  Caching properties  Driver properties  XA properties  SQL tracing properties  Advanced tab  JDBC driver properties  Client-Library connection settings  Database type setting  Connection cache refresh  Connection cache ping  Using XA resources with Adaptive Server Enterprise  Modifying the Adaptive Server configuration files  Configuring connectors  Configuring Adaptive Server Enterprise connections  For Sun Solaris and SGI  Displaying current soft and hard limits  Increasing the soft limit  Increasing the hard limit  For Compaq Tru64  For HP-UX  Sample program  Naming Services  How does the EAServer naming service work?  EAServer initial context  Name binding example  Transient versus persistent storage  CORBA CosNaming API support  Binding names  Resolving EAServer objects  Resolving objects using the CosNaming interface  Interoperable naming  Network name service  JNDI support  JNDI J2EE features  Environment properties  EJB references  Resource factory references  UserTransaction references  Configuring the EAServer naming service  Name binding password security  Using an LDAP server with EAServer  LDAP object schema and EAServer objects  Storing EAServer object bindings on an LDAP server  Clusters and Synchronization  Cluster overview  Cluster servers  Configuring a cluster  Heartbeat detection  Cluster start-up options  Synchronization  Component synchronization  Package synchronization  Servlet synchronization  Application synchronization  Web application synchronization  Synchronization procedures  Load Balancing, Failover, and Component Availability  Understanding load balancing  Load metrics  Load distribution policies  Interoperable object references  Understanding high availability  Configuring load balancing  Deploying components to a cluster  Stateful components  Partitioned components  Automatic failover for components  Component implementation guidelines  Deploying Web applications to a cluster  Clustered Web application requirements  Configuring in-memory HTTP session replication  Configuring persistent session storage  Creating the database table  Implementing Sybase Failover for high availability systems  Java Connection Management  JDBC 1.0 and 2.0  JDBC 2.0 extension/JTA drivers  Troubleshooting the database connection  Open Client Client-Library  Modifying the client connection information  Selecting the high availability option  Using the connection APIs  Setting up the Message Service  Configuring the message service  Configuring the message service to use non-ASCII characters  Adding and configuring the message service parts  Permanent destinations  Connection factories  Message selectors  Listeners  Access roles  Thread pools  Dead queue  Viewing messages and statistics  Importing and Exporting Application Components  Deploying packages and components  Importing and exporting components in EAServer JAR format  Importing and exporting packages in EJB-JAR format  Exporting EJB-JAR files  Deploying Web applications  What is created during import  Deploying J2EE applications  What is created during import  Deploying application clients  Deploying connectors  Deploying other entity types  Using EAServer configuration files in J2EE archives  Merging property files in EAServer JAR archives  Creating merge files  Creating cleaner files  Deleting packages, Web applications, and applications  Using Repository Versioning  Introduction  Creating and restoring versions  Runtime Monitoring  Using the File Viewer  Using the Runtime Monitor  Monitoring component activity  Monitoring connection caches and managed connection factories  Monitoring network connections  HTTP and IIOP statistics  Connected users  HTTP history  Using the OTS Transaction Monitor  Using jagtool and jagant  Working with jagtool  jagtool syntax  Local versus connected mode  Using connected mode  Using local mode  Entity identifiers  jagtool and jagant  Setting up your environment  jagant scripts  jagant syntax  The Ant build file  Registering jagtool commands in the Ant build file  Using the jag_connect command  Using jagant in connected mode  Using jagant in local mode  Using multiple connections  XML configuration files  Format of the XML configuration file  sybase-easerver-config element  macro elements  configure elements  property elements  Special characters  Sample configuration file  jagtool commands  compilejsp  configure  copy  create  delete  deploy  ejbref  enventry  exists  export  exportconfig  flushstaticpage  gen_skels  gen_stubs  gen_stubsandskels  gen_tlbreg  getmonitorstats  getserverinfo  getservicestate  grantroleauth  install  jmscreate  jmsdelete  jmsflush  jmslist  jmslist_listeners  jmslist_messages  jmsmanage_listeners  jmsmanage_selectors  jmsprops  jmsset_props  list  list_ver  merge_props  ping  props  rebind  refresh  remove  removeroleauth  resref  restart  restore_ver  save_major_ver  save_minor_ver  set_admin  set_props  set_ready  setjagadminpasswd  shutdown  sync  Using Systems Management  Overview  Systems Management functionality  JMX agent  Service MBeans  Service proxy MBeans  Events  MIB manager MBeans  Adapters and connectors  JMS forwarding  EAServer proxy MBean  SNMP proxy MBean  SNMP functionality  SNMP master agent  SNMP management console  SNMP MIBs  NETWORK-SERVICES MIB  J2EE MIB  SNMP MIB implementation details  Running the JMX agent  Connecting to the JMX agent  Creating services  Creating service MBeans  Creating services  Running the samples  Compiling the samples  Using SSL  Setting up SSL  Using the Systems Management Console  Connecting to the Systems Management Console  The user interface controls  Navigating the tree view  The details view  Performing actions  Managing user roles  Managing access to services  Accessing MBeans  sybase.system:Name=Master  sybase.system.jms:Type=Forwarder  sybase.system.adaptor.security:Name=UserPassword  sybase.system.logger:Type=File  sybase.system.log4j:Type=Notifier  sybase.system.service:Name=Jaguar,Type=EAS  Using EJB 1.0 JAR Support  Importing and exporting EJB 1.0 JAR files  EJB 1.0 deployment descriptor properties  BeanName tab  Access Control tab  Control Descriptor tab  Environment tab  Repository Properties Reference  About these reference pages  User-defined properties  Encrypted properties  “See also” headings  Application properties  Application client properties  Cluster properties  Component properties  Connection cache properties  Connector properties  Database type properties  EJB local reference properties  EJB reference properties  Entity collection properties  Environment properties  Filter properties  Instance pool properties  JMS entity properties  Listener properties  Log profile properties  Log profile EAS subsystem properties  Log profile Java Logging subsystem properties  Log profile Log4j subsystem properties  Method properties  Package properties  Resource environment reference properties  Resource manager properties  Resource reference properties  Role properties  Security properties  Server properties  Servlet properties  Thread monitor properties  Web application properties  EAServer API Reference Manual  About this book  Java Classes and Interfaces  Package index  com.sybase.CORBA.jdbc102  com.sybase.CORBA.jdbc11  com.sybase.jaguar.jcm  com.sybase.jaguar.server  com.sybase.jaguar.sql  com.sybase.jaguar.util  com.sybase.jaguar.util.jdbc102  com.sybase.jaguar.util.jdbc11  com.sybase.CORBA.jdbc11.IDL class  com.sybase.CORBA.jdbc11.IdlResultSet  com.sybase.CORBA.jdbc11.SQL class  jaguar.jcm.JCM class  jaguar.jcm.JCMCache class  jaguar.jcm.JConnectionNotFoundException class  jaguar.server.Jaguar class  jaguar.server.JContext class  jaguar.sql.JServerResultSet interface  jaguar.sql.JServerResultSetMetaData interface  jaguar.util.JException class  jaguar.util.<object>Holder class  jaguar.util.jdbc102.<object>Holder class  jaguar.util.jdbc11.<object>Holder class  ActiveX C++ Interface Reference  Header files and link libraries  List of interfaces  GetObjectContext routine  IJagServer interface  IJagServerResults interface  IObjectContext interface  IObjectControl interface  ISharedProperty interface  ISharedPropertyGroup interface  ISharedPropertyGroupManager interface  ActiveX IDispatch Interface Reference  How to use these reference pages  IDispatch interface index  IJagServer interface  IJagServerResults interface  SharedProperty interface  SharedPropertyGroup interface  SharedPropertyGroupManager interface  ActiveX Client Interfaces  How to use these reference pages  Interface index  Field interface  Fields collection  JagORBClientErrNum enumeration  JagORBSrvErrNum enumeration  JCollection interface  Object interface  Orb interface  RecordSet interface  C Routines Reference  Alphabetical list of all routines  Routines for managing component instance data  Routines for managing transaction flow  Routines for sharing data between components  Routines for managing cached connections  Routines for sending result sets  Routines for handling errors in C or C++ components  Routines for managing memory in C or C++ components  Routines to obtain user login information  JagAlloc  JagBeginResults  JagBindCol  JagCmCacheProps  JagCmGetCachebyName  JagCmGetCachebyUser  JagCmGetConnection  JagCmGetCtx  JagCmGetProxyConnection  JagCmReleaseConnection  JagColAttributes  JagCompleteWork  JagContinueWork  JagDescribeCol  JagDisallowCommit  JagEndResults  JagFree  JagFreeCollectionHandle  JagFreeCollectionList  JagFreeSharedDataHandle  JagGetCollection  JagGetCollectionList  JagGetHostName  JagGetInstanceData  JagGetPassword  JagGetPeerAddress  JagGetSharedData  JagGetSharedDataByIndex  JagGetSharedValue  JagGetUserName  JagInTransaction  JagIsRollbackOnly  JagLockCollection  JagLockNoWaitCollection  JagLog  JagNewCollection  JagNewSharedData  JagNewSharedDataByIndex  JagResultsPassthrough  JagRollbackWork  JagSendData  JagSendMsg  JagSetInstanceData  JagSetSharedValue  JagSleep  JagUnlockCollection  Deprecated Java Classes and Interfaces  Package Index  com.sybase.jaguar.beans.enterprise  jaguar.beans.enterprise.EnterpriseBeanException class  jaguar.beans.enterprise.InstanceContext interface  jaguar.beans.enterprise.ServerBean interface  jaguar.beans.enterprise.SharedObjectException class  jaguar.beans.enterprise.SharedObjects interface  EAServer Programmer's Guide  About this book  Creating Component-Based Applications  Application architecture  Designing the EAServer application  Implementing components and clients  Deploying the application  Deploying components  Deploying clients  Understanding Transactions and Component Lifecycles  Component lifecycles  EAServer’s transaction processing model  How EAServer transactions work  Benefits of using EAServer transactions  Defining transactional semantics  Example  Dynamic enlistment in bean-managed transactions  Entity bean local diamonds  EAServer Transaction Manager  Resource recovery and transaction logging  Recovering XA resources registered by user components  Transaction interoperability  Resource manager  Enlisting XA resources with Transaction Manager  Managing Applications and Packages in EAServer Manager  Defining applications  Creating and installing applications  Deleting and removing applications  Configuring application properties  Application properties: General  Application properties: Role Mapping  Application properties: Java Classes  Application properties: Additional Files  Application properties: JAXP Support  Application properties: Security  Application properties: Advanced  Defining packages  Creating a new package  Installing packages to a server  Modifying packages  Configuring package properties  Package properties: General  Package properties: Java Classes  Package properties: Additional Files  Package properties: Role Mapping  Package properties: JAXP Support  Package Properties: Advanced  Defining Components  Defining components  Installing components  Configuring component properties  Component properties: General  Component properties: Transactions  Component properties: Instances  Component properties: Environment  Component properties: EJB Local Refs  Component properties: EJB Refs  Component properties: Resource Refs  Component properties: Resource Environment Refs  Component properties: Role Refs  Component properties: Resources  Component properties: Persistence  Component properties: Run-As Identity  Component properties: Run-As Mode  Component properties: Java Classes  Component properties: Additional Files  Component properties: JAXP Support  Component properties: Advanced  Running components externally  Configuring components to run externally  Configuring servers to host external components  Defining Component Interfaces  Defining interfaces graphically  Editing interfaces  Method properties  Parameter properties  Parameter and return value datatypes  Importing interfaces from compiled Java files  Coding classes, interfaces, and JavaBeans for import  Importing a Java class or interface in EAServer Manager  Importing interfaces from registered ActiveX components  Defining modules, interfaces, and types in IDL  Learning IDL  Creating and editing IDL modules, interfaces, and types  Using the IDL editor window  Creating and editing interfaces  Adding IDL documentation comments  Refreshing the HTML documentation  Viewing HTML documentation for IDL modules  Importing existing IDL modules  Enterprise JavaBeans Overview  About Enterprise JavaBeans components  EJB component types  Stateful session beans  Stateless session beans  Entity beans  EJB transaction attribute values  EJB container services  EAServer EJB support  Running EJB components in EAServer  EJB clients connecting to EAServer  For more information  EJB 2.0 differences from 1.1  Message-driven beans  Home interface methods  Local interfaces  CMP enhancements  EJB 2.0 interoperability  EJB 1.1 differences from EJB 1.0  Component differences  JNDI names in deployment descriptors  Environment properties  EJB and resource references  Security access-control changes  Transaction isolation level  Client model differences  Creating Enterprise JavaBeans Components  Defining an EJB component  Defining the primary key type  Defining home interface methods  Defining remote interface methods  Defining local interfaces  Configuring the component properties  Configuring EJB references  Configuring resource references  Configuring role references and method permissions  Configuring environment properties  Deploying the component classes  Creating Enterprise JavaBeans Clients  Developing an EJB client  Generating EJB stubs  Instantiating home interface proxies  Obtaining an initial naming context  Resolving JNDI names  Instantiating remote or local interface proxies  Calling remote interface methods  Calling local interface methods  Managing transactions  Serializing and deserializing bean proxies  Runtime requirements  EAServer EJB Interoperability  Intervendor EJB interoperability  Interoperable naming URLs  Interoperable naming URLs for EJB clients  Interoperable naming URLs for EJB references  Classes for RMI/IIOP connections from third-party containers  Invoking non-EJB components from EJB clients  Invoking EJB components from CORBA C++ clients  Invoking EJB components from PowerBuilder clients  Invoking EJB components from ActiveX clients  Supported datatypes  About overloaded methods and nested IDL  Using the home interface  Serializing and deserializing instance references  Invoking EJB components from CORBA Java clients  Invoking EJB components using the MASP interface  Creating Application Clients  Creating an application client  Configuring application client properties  General properties  EJB references  Resource references  Resource environment references  Environment properties  Java classes  JAXP properties  Application client files  Running application clients  Setting up a client’s workstation  Starting the runtime container  Creating CORBA Java Components  Requirements  Procedure for creating Java components  Define the component interface and properties  Choose implementation datatypes  Write the Java source file  Generate stub, skeleton, and implementation files  Add package import statements  Code the constructor  Implement control interface methods  Add error handling code  Advanced techniques  Issue intercomponent calls  Manage database connections  Return result sets  Access SSL client certificates  Set transactional state  Retrieve user-defined component properties  Deploy Java components  Debug Java components  Creating CORBA Java Clients  Overview  Procedure for creating CORBA-compatible Java clients  Generating Java stubs  Instantiating proxy instances  Executing component methods  Cleaning up client resources  Serializing component instance references  Handling exceptions  Deploying and running Java clients  Instantiating proxies with the CosNaming API  Using other CORBA ORB implementations  Connecting to EAServer with a third-party client ORB  Connecting to third-party ORBs using the EAServer client ORB  CORBA C++ Overview  Overview  Requirements  Supported datatypes  Mapping for predefined EAServer Manager datatypes  Using mapped IDL types  Overloaded methods  Creating CORBA C++ Components  Procedure for creating C++ components  Defining C++ components  Generating required C++ files  Writing the class implementation  Write methods  Returning result sets  Error handling  Managing explicit OTS transactions  Accessing SSL client certificates  Issuing intercomponent calls  Compiling source files  Compiling on UNIX platforms  Compiling on Windows  Visual C++  Debugging C++ components  Running C++ components externally  Limitations  Configuring a component to run externally  Building and deploying the external component executable  Creating C++ components for multiplatform clusters  Creating CORBA C++ Clients  Procedure for creating CORBA C++ clients  Generating stubs  Writing CORBA C++ clients  Adding required include and namespace declarations  Instantiating stub instances  Configure and initialize the ORB runtime  Creating a Manager instance  Creating sessions  Creating stub instances  Invoking methods  Processing result sets  Example of processing result sets  Retrieving the result set  Iterating through the rows and columns  Retrieving the column datatype and processing values  Handling exceptions  CORBA system exceptions  User-defined exceptions  Compiling C++ clients  Deploying C++ clients  Using the CosNaming interface  Configure and initialize the ORB for CosNaming use  Obtain an initial naming context  Obtaining the initial context  Introduction to CosNaming name resolution  Resolving component proxies  Using CORBA ORB implementations other than EAServer  Connecting to EAServer with a third-party client ORB  Generating compatible C++ stubs  Instantiating components using a third-party ORB  Connecting to third-party ORBs using the EAServer client ORB  Creating PowerBuilder Components  Creating PowerBuilder Clients  ActiveX Overview  Overview  Requirements  ActiveX component requirements  ActiveX client requirements  ActiveX datatype support  Structure support  Union support  About IDL unions  Supported discriminator and field types  ActiveX mapping for unions  Sequence support  IDL typedef support  IDL enumeration support  Result-set support  Algorithm to retrieve result sets  Creating ActiveX Components  Procedure for creating ActiveX components  Defining ActiveX components  Importing ActiveX components  Procedure  Defining methods  Defining return and parameter datatypes  Defining the transaction property  Defining instance properties  Writing ActiveX components  Implementing a constructor and destructor  Sharing data between components  Using shared data in C++  Using shared data IDispatch interfaces  Issuing intercomponent calls  Managing database connections  Sending result sets from an ActiveX component  Setting transactional state  Adding error-handling code  Deploying ActiveX components  Creating ActiveX Clients  Procedure for creating ActiveX clients  Generate .tlb and .reg files for components  Before you start  Check the ProgID for each interface  Generating TLB/REG files  Files generated  Develop and test the ActiveX client  Instantiating proxies using CORBA-style interfaces  Initializing the ORB  Creating a Manager instance  Creating sessions  Creating stub instances  Instantiating stub instances using the EAServer 1.1 interface  Declare proxy objects  Set connection properties  Instantiate server components  Invoke component methods  Code exception handling  Using an ActiveX error handler  Handling exceptions inline  Deploy the ActiveX client  Creating Web Applications  What is a Web application?  Contents of a Web application  Servlet files  JSP files and tag libraries  Static files  Java classes  Class and JAR file locations  Which classes are loaded by the custom loader?  Deployment descriptor  Creating Web applications  Configuring Web application properties  General properties  Context initialization properties  Welcome and error page specifications  Welcome files  Error pages  Tag library descriptor references  Naming references  EJB references  EJB local references  Resource references  Resource environment references  Environment properties  Request path mappings  MIME mappings  JAXP properties  Java Classes properties  Extensions properties  Additional files  Security properties  Page Caching properties  Listener properties  Filter Mapping properties  The EASDefault Web application  Using Java extensions  Installing extensions in EAServer  Defining required extensions for Web applications  Defining required extensions in EAServer Manager  EAServer Java extension properties  Defining required extensions in the WAR manifest file  Localizing Web applications  Enabling accept-language header parsing  Internationalization for servlets  Deploying localized static files  Language selection algorithm  Localizing JSP content  Creating Java Servlets  Introduction to Java servlets  Writing servlets for EAServer  Connection caching  Component invocations  Threading  Logging  Error pages  Request dispatching  URL interpretation  Implementation  Static content  Response buffering  Encoding responses and double-byte characters  Installing and configuring servlets  Installing servlets  Defining a new servlet  Installing existing servlets into a server  Uninstalling servlets from a server  Deleting servlet definitions  Configuring servlet properties  Deploying and refreshing servlet classes  Deploying servlet classes  Refreshing servlets  Starting and stopping servlets  Web application support  Adding servlets to a Web application  Server properties for servlets  Using Filters and Event Listeners  Servlet filters  Custom headers  Application lifecycle event listeners  Creating JavaServer Pages  About JavaServer Pages  How JavaServer Pages work  What a JSP contains  Why use JSPs?  Syntax summary  Directives  Scripting elements  Comments  Standard tags  Objects and scopes  Scopes  Implicit objects  Application logic in JSPs  Error handling  Using JSPs in EAServer  JSP and EAServer overview  JSP 1.2 highlights  Compiling JSPs  JSP file locations  Saving Java source code  Source and class file locations  Creating and configuring JSPs in EAServer  Internationalization  Mapping JSPs  Page caching  Filters  Sending Result Sets  Overview  Sending result sets with Java  Forwarding a ResultSet object  Sending results row-by-row  JServerResultSet sequence of calls  JServerResultSet example  Sending result sets from a PowerBuilder component  Sending result sets from an ActiveX component  Forwarding a result set with ResultsPassthrough  Sending results row-by-row  Result sets row-by-row: C++ example  Sending result sets from a C or C++ component  Forwarding a result set with JagResultsPassthrough  Sending results row-by-row  Using Connection Management  Overview of connection management  When to use Connection Manager  Connection caches and security  Defining connection caches  JDBC DataSource lookup  Application authentication  Using Java Connection Manager classes  Classes  Java Connection Manager example  Using Connection Manager routines in C, C++, and ActiveX components  ODBC connection caches  Header files  Data structures  ODBC example  Single-threading ODBC calls on UNIX  Client-Library connection caches  Header files  Data structures  Client-Library example  Client-Library error and message callbacks  Oracle connection caches  Oracle autocommit setting  Using OCI 7.x connection caches  Using OCI 8.x connection caches  Using OCI 9.x connection caches  Using cached connections in PowerBuilder components  Connection Manager guidelines  Avoiding results-pending errors  Connections and cache handles  Maintaining connection state  Creating Entity Components  Implementing entity components  Coding to support manual persistence  Understanding the automatic persistence architecture  Configuring automatic or EJB CMP persistence  Specifying the CMP version for EJB 2.0 entity beans  Setting Persistence/General subtab properties  Enabling automatic key generation  Creating database tables  Configuring concurrency control  Setting field-mapping properties  Specifying finder- and ejbSelect-method queries  Configuring table-mapping properties  Using relationship components  Configuring Persistence for Stateful Session Components  How it works  Supported component implementations  Using EJB activation and passivation  Configuring stateful session beans to support failover  Configuring passivation after timeout  Using automatic persistence  Defining the IDL state type  Accessing the state data in the implementation  Configuring Persistence Mechanisms  Storage components  Supported Java, IDL, and JDBC/SQL types  Table schema for binary storage  Requirements for in-memory stateful failover  Cluster configuration for in-memory failover  Mirror Cache tab component properties  Configuring Custom Java Class Lists  Understanding how the class loader works  Class loader versions  The class loader hierarchy and delegation policy  The system class loader  Deciding which classes to add to the custom list  Custom class lists for Java and EJB components  Class loading order for components  Custom class lists for Web applications  Class loading order for Web applications  Custom class lists for servlets installed directly in the server  Custom class lists for packages, applications, or servers  Configuring an entity’s custom class list  Troubleshooting class loader configuration issues  Commonly encountered problems  Custom class loader tracing  JAR file locking and copying  Using the Message Service  Overview  High availability and load balancing  Message security  Reliable delivery  Scalable notification  Transaction management  Developing JMS applications  Creating a JMS InitialContext object  Looking up a ConnectionFactory object  Creating permanent destinations  Creating connections  Creating sessions  Creating message producers  Creating message consumers  Filtering messages using selectors  Implementing and installing message listeners  Message-driven beans  Creating messages  Sending messages  Publishing messages  Receiving messages  Browsing messages  Enabling JMS tracing  Closing connections, sessions, consumers, and producers  JMS interfaces not supported  Developing EAServer messaging service applications  Obtaining CtsComponents::MessageService object references  Creating message consumers  Creating message selectors  Creating thread pools programmatically  Implementing and installing message listeners  Sending messages  Publishing messages  Receiving messages  Subscribing to scheduled messages  EAServer message service CORBA API  Using the Thread Manager  About the Thread Manager  The Thread Manager and service components  The Thread Manager and the message service  Thread Manager interface documentation  Using the Thread Manager  Before you start  Adapting components to be run by the Thread Manager  Understanding thread groups  Understanding the run interval  Understanding the thread count  Instantiating the Thread Manager  Obtaining authorized access  Instantiating a proxy  Starting threads  Suspending and resuming execution  Stopping threads  Creating Service Components  Introduction  Creating service components  Define the component interface and properties  Service component properties  Required client roles  Implement GenericService interface methods  Java example of GenericService methods  C++ example of GenericService methods  Implement other required methods  Install the component as an EAServer service  Determining service state  Refreshing service components  Creating and Using EAServer Pseudocomponents  Benefits of pseudocomponents  Creating pseudocomponents  Implementation restrictions  Defining a pseudocomponent  Properties for a Java pseudocomponent  Properties for a C++ pseudocomponent  Direct-access pseudocomponent stubs and skeletons  Instantiating pseudocomponents  Pseudocomponent object URLs  Identifying a C++ pseudocomponent  Identifying a Java pseudocomponent  Instantiating pseudocomponents from Java  Instantiating pseudocomponents from C++  Instantiating pseudocomponents from PowerBuilder  Debugging C++ pseudocomponents  Creating JavaMail  Introduction to JavaMail  Writing JavaMail for EAServer  Creating a JavaMail session  Constructing a message  Sending a message  Sample EAServer JavaMail program  JavaMail providers  Deploying JavaMail-enabled applications  Configuring Java XML Parser Support  About JAXP  Configuring JAXP properties in EAServer Manager  Exporting and importing application clients  Executing Methods As Stored Procedures  Creating invocation commands  Limitations  Using MASP from isql  Using MASP from application builder tools  PowerBuilder  PowerDynamo  Other tools  Configuring the return status  Migrating Open Server Applications to EAServer  Migration overview  Coding changes and examples  Modifying main  Open Server properties  Making your code thread-safe  DLLs, shared objects, and makefiles  Modified APIs and new event handlers  Modified APIs  Event handler prototypes  EAServer configuration  Installing event handlers  Specifying event handlers  Configuring an Open Server listener  Additional event handler information  Calling convention for event handlers  Initialization, run, start and exit events  Start handler template  Exit handler template  Connect and disconnect handlers  Connect handler  Disconnect handler  Build with the Visual C++ IDE  A sample module definition (.def) file  Creating C Components  C component lifecycle  Requirements  Procedure for creating C components  Define component interface and properties  Define the component’s interfaces  Transaction property  Instance properties  Generate C component files  Procedure for generating C component files  File naming conventions  Regenerate changed C component methods  Write C components  Define implementation functions  Implementation function return codes  Calling conventions  Parameter datatypes  Logical method return values  Implementing the method behavior  Components that require instance specific data  C components that are wrappers for C++ classes  Methods that interact with remote database servers  Methods that return row results  Share data between C or C++ components  Procedure for sharing data  Create shared variables and collections  Lock and unlock collections  Read and update shared variables  Release shared variable and collection references  List all collections  Methods that set transactional state  Customize the creation and destruction of components  create routine  destroy routine  Handle errors in your C component  Compile C components  Build on UNIX  Build on Windows  DLLs for C components  Build with the Visual C++ IDE  The module definition (.def) file  Debug C components  Using the Command Line IDL Compiler  com.sybase.CORBA.idl.Compiler  EAServer Cookbook  About this book  Getting Started with EAServer  Understanding EAServer  Starting the server  Starting servers on Windows platforms  Starting the server on UNIX platforms  Using EAServer Manager  Starting Sybase Central on Windows  Starting Sybase Central on UNIX platforms  Connecting to the EAServer Manager plug-in  Shutting down, restarting, or refreshing the server  Creating CORBA Java Components and Clients  Overview of the sample application  Tutorial requirements  Java compiler scripts  Creating the application  Start EAServer and EAServer Manager  Define a package, component, and method  Define a new package  Define and install a new component  Define the multiply method  Generate stubs and skeletons  Write the server-side code  Create the client program  Run the client program  Creating an applet client  Verify that your browser can run JDK 1.2 applets  Prepare your EAServer installation to run applets  Write the applet code  Create an HTML page to run the applet  Run the applet  Debugging  Creating C++ Components and Clients  Overview of the sample application  Tutorial requirements  Creating the application  Verify your environment  Start EAServer and EAServer Manager  Define a package, component, and method  Define a new package  Define and install a new component  Define the multiply method  Generate stubs, skeletons, and implementation templates  Write the server-side code  Write the client-side code  Compile the client executable  Run the client executable  Creating Enterprise JavaBeans Components and Clients  Overview of the sample components  Tutorial requirements  Creating the application  Start EAServer and EAServer Manager  Create the package and components  Define a new package  Define the Glossary entity bean  Define the Query stateless session bean  Generate stubs and skeletons  Create the glossary database and connection cache  Start the glossary database server  Create the connection cache and associate it with the components  Create the client application  Run the client application  Using the EAServer Samples  Samples in the EAServer installation  Java samples  Using JavaServer Pages and EJB components  Using EJB CMP entity beans  Using message-driven beans and JMS  Using SSL in Java clients  Using custom authentication  Using the Java Authentication and Authorization API  Using CORBA components and clients  Systems management  C++ samples  Using SSL in C++ clients  Using custom authentication services  Inspecting client SSL credentials  Java Pet Store  PowerBuilder samples  Web Services Toolkit samples  Samples on the Sybase Web site  EAServer Web Services Toolkit User's Guide  About this book  Overview of Web Services in EAServer  Web services background and standards  SOAP 1.1  WSDL 1.1  JAX-RPC 1.0  SAAJ 1.1  JAXP 1.1  UDDI 2.0  EAServer Web Services architecture  Installing Web services  Defining, deploying, and exposing Web services using WST  Service styles  Retrieving the Web service’s WSDL  Using Sybase Web Services Toolkit—an Eclipse plug-in  Starting and stopping Eclipse  Web services plug-in  Connecting to servers  Organization  Menu layout and navigation  Accessibility features  Components, Datatypes, and Type Mappings  Supported component types  Supported datatypes  Additional datatype support  Client-side generation of holder classes  Custom datatypes and mappings  Creating custom type mappings  Creating serializers and deserializers  Deployment  Exporting  Web Services Administration  Introduction  Web services server administration  Web services collection administration  Web service administration  Creating Web services from files  Web service projects  Web service management  Creating and managing Web service clients  Web service operation management  Type mappings  Handlers  Defining handlers  Security  Roles and security realms  Web services security tutorial  Managing security realms and roles  Managing roles  Establishing Web service access  XML-Security  Configuring EAServer and enabling XML-Security  Exposing and deploying components as Web services  Exposing Components as Web services  Using the quickly expose wizard  Deploying Components as Web services  Using the quickly deploy wizard  Generating WSDL  UDDI administration  Other components  Web Console—Web Services  Introduction  Logging in to the Web console versus logging into Sybase Central  Web console security and access  Adding an authentication service to EAServer  Disabling JavaScript  Browser support  Authentication time-out in EAServer  Session time-out in EAServer  Plug-in, domain, display, and server administration  Web service collection administration  Web service administration  Web service operation management  Web service parameter management  UDDI administration  Type mappings  Handlers  Managing security realms and roles  Roles  Runtime monitoring  Non-Web service components  Web Console—Registry Services  Introduction  Using the Web console  Navigating the console and managing resources  UDDI administration  UDDI registry profile administration  Searching and publishing to UDDI registries  Inquiries and searches  Searching UDDI registries  Publishing  Businesses  Services  tModels  Additional registry information for published businesses, tModels, and services  The Private UDDI Server  Introduction  Installing and starting the private UDDI server  Starting and connecting to the private UDDI registry  Starting the default UDDI registry  Configuring other private UDDI registries  Connecting to the private UDDI registry  Managing the private UDDI  Administering the private UDDI  Controlling access to resources  Using wstool, wstkeytool, wstant, and wstkeytoolant  Introduction  Working with wstool and wstkeytool  wstool and wstkeytool syntax  Entity identifiers  Working with wstant and wstkeytoolant  Setting up your environment  wstant and wstkeytoolant scripts  wstant and wstkeytoolant syntax  wstant sample files  wstool commands  UDDI administration commands  inquiry  publish  unpublish  Server management commands  list  refresh  restart  shutdown  Web service administration commands  activate  allowMethods  deactivate  delete (1)  delete (2)  deploy (1)  deploy (2)  deploy (3)  disallowMethods  export  exposeComponent  getTMjar  isActive  isAllowed  isStatsEnabled  refresh  resetStats  set_props  startStats  stopStats  upgrade  wsdl2Java  java2Wsdl  Security commands  add  remove  wstkeytool commands  changePin  deleteCert  export  genCertReq  GetCACerts  GetOtherCerts  GetUserCerts  import  printCert  Developing Web Service Clients  Introduction  Stub-based model client  stub-based example  Dynamic proxy client  Dynamic proxy client example  Dynamic invocation interface client  DII client example  Document style client  Document style example  Using the Web Services Toolkit Samples  Samples in WST  Samples on the Sybase Web site  Sample and tutorial location  Creating the sample projects and installing the samples  Using the WST development tool and features  Exposing a Java class as a Web service  Running the test client using HTTPS  Exposing a Web service that implements JAX-RPC defined interfaces  Exposing a stateless EJB as a Web service  Establishing Web service security, and generating a test client  Exposing a CORBA component as a Web service  Google search API demonstration  Developing client applications  Running a dynamic client  .NET sample  PowerBuilder 9 sample  Migrating 4.x Web Services  Introduction  Server-side migration  Client-side migration  EAServer Security Administration and Programming Guide  About this book  Security Concepts  Authentication and authorization  Public-key cryptography  Public-key certificates  SSL, HTTPS, and IIOPS  TLS and FIPS  Proxies and firewalls  Lines of defense  Types of attacks  Defense against attacks  Securing Component Access  Client authentication  Intercomponent authentication  Accessing SSL information  Non-EJB components  C++ components  Intercomponent authentication for EJBs and servlets  Intercomponent authentication for EJB 2.0 components  Caller propagation  Run-as support  Trusted identities  Authentication of component invocation from servlets  Caller propagation for servlets on remote servers  Run-as support  Quality of protection  Usage scenarios  Client authorization  Enterprise JavaBeans  EJB 2.0 authorization of methods with no defined permissions  Using Web Application Security  Introduction  Authentication  Form login requirements in a Web application when using HTTPS (SSL)  Web application direct form login  Authorization  Role mapping  Securing TDS Client Access  TDS and MASP listeners  MASP client security  Open Server client security  Using SSL in Java Clients  Using SSL in Java applets  Using SSL in Java applications  Requirements  Establishing a secure session  Using the SSLServiceProvider interface  SSL properties  Implementing an SSL callback  Retrieving session security information  Sample Java applications that use SSL  Creating HTTP and HTTPS connections in Java applications  HTTP connections  HTTPS connections  Installing the HTTPS protocol handler  EAServer’s HttpsURLConnection class  SSL properties  Using Java Secure Socket Extension classes  Possible solutions for JSEE issues  Using SSL in C++ Clients  Introduction  Initializing the SSL security service  ORB properties for secure sessions  Creating a manager instance  Retrieving session security information  Creating an SSL callback component  Using SSL in PowerBuilder Clients  Using SSL in ActiveX Clients  Requirements  Establishing a secure session  Using the SSLServiceProvider interface  SSL properties  Choosing a security characteristic  Secure server addresses  Other useful ORB properties  Implementing an SSL callback  Retrieving session security information  Example: inspecting SSL session properties  Example: inspecting X.509 certificate properties  Using TLS and FIPS in EAServer  Introduction  Compatibility with previous versions  Enabling TLS-secure listeners  Enabling FIPS  Enabling FIPS mode from EAServer Manager and Security Manager  Disabling TLS support  Upgrading the test CA and sample certificates  FIPS-related jagtool commands  FIPS mode for Java-side cryptography usage  Troubleshooting  Creating and Using Custom Security Components  Using a custom authentication service  Maintaining authenticated sessions  Retrieving HTTP session information  Using a custom role service  Creating a role service  Installing the role service  Using a custom authorization service  Deciding whether to use the authorization services and role service  Creating the authorization service  Installing the authorization service  Component URLs for the authorization service  Supporting external single sign-on providers  Netegrity SiteMinder Integration  Configuring your security scenario  Configuring the SiteMinder Policy Server  Configuring reverse-proxy access to EAServer  Enabling Policy Server logging  Configuring EAServer for SiteMinder security  Using the JAAS API  Introduction  Requirements  JAAS in EAServer  Enabling JAAS for a server  Retrieving additional user session details in a JAAS login module  JAAS on the client  JAAS for connectors  Samples and debugging  Deploying Applications Around Proxies and Firewalls  Connecting through proxy servers  Using Web proxies  Properties that affect Web proxy use  Using reverse proxies  Reverse-proxy configuration  Properties that affect reverse proxy use  Security Configuration Tasks  Configuring EAServer roles  Assigning users and groups to roles  Determining authorization  Predefined roles  Admin role in EAServer  Configuring OS authentication  Configuring OS user and group authorization  Configuring security profiles  Security characteristics  Defining security profiles  SSL session caching and reuse  Configuring listeners  Preconfigured listeners  Listener failover  Configuring listener properties  Configuring identities  Configuring identity properties  Identity properties/basic  Identity properties/SSL  Identity properties/Entrust  Managing Keys and Certificates  SSL overview  Managing keys and certificates on EAServer  EAServer Manager | Certificates folder management  Test CA management  Key management  Certificate management  Certificate file extensions and types  Using Netscape to manage certificates on the client  Installing Sybase PKCS #11 into Netscape 4.0x  Obtaining a key pair and certificate  SSL certificate information in servlets  Entrust PKI Integration  Overview  Scenarios  Both client and EAServer use non-Entrust certificates  Entrust client and non-Entrust server (and vice versa)  Both client and server use Entrust certificates  Tutorial: Using SSL  Overview of the security tutorial  Tutorial requirements  Setting up your browser  Start the server, EAServer Manager, and connect to the Certificates folder  Obtain and install a personal certificate  Setting up EAServer  Creating and assigning a security profile to a listener  Assign a security profile to a listener  Running the SSL sample applet  Debugging the SSL sample applet  EAServer Performance and Tuning Guide  About this book  Introduction  Determining factors  Response time  Scalability and throughput  Memory use  Threading  Measurement and diagnosis tools  Instrumented code  Profiling software  Load-testing tools  Memory and CPU usage monitors  EAServer monitoring and tracing tools  Runtime monitoring with EAServer Manager  Runtime monitoring APIs  Trace-logging options  The tuning process  Server Tuning  The performance tuning wizard  General server tuning  Thread settings  Number of threads  Thread stack size  Solaris Java thread model  Flow control  Debug and trace settings  Java virtual machine tuning  CLASSPATH and BOOTCLASSPATH settings  Custom class lists  Java VM type and version  Just-in-time compilation  JVM memory allocation parameters  Other Java VM settings and troubleshooting  Listener tuning  HTTP keep alive  HTTP maximum requests  Connection request pool size  SSL session caching  Operating system settings  UNIX file descriptors  Per-process memory limits  Factors that affect start-up and shutdown time  Start-up performance  Shutdown performance  Pooled component destruction  Servlet destruction  EAServer memory requirements  Component Tuning  Running the performance tuning wizard  Common component performance issues  Tracing and debugging settings  Thread-related issues  Bind thread  Concurrency  Sharing  Thread monitors  Stateful versus stateless components  Instance pooling  Configuring component instance pool properties  Named instance pools  Optimizing intercomponent calls  Java component performance  EJB component performance  Optimizing in-server EJB calls  Local interfaces  Lightweight container  Pass-by-reference semantics  Entity bean read-only methods  Entity bean database update frequency  Stateful session beans  C++ component performance  PowerBuilder component performance  Settings that affect system resource use  DataStore row height size  Web DataWindow settings  EJB CMP Tuning  Generated entity bean subclasses  Creating and tuning database tables  Automatic key generation settings  Concurrency control options  Enabling PCC  Enabling OCC  Configuring OCC options  Enabling automatic transaction retry  Configuring CMP isolation level  Using soft locking  Connection cache settings  Tuning the cache size and database type  Using CMP JDBC wrapper drivers  Entity instance and query caching  Cache architecture  Cache coherency and transaction consistency  Configuring object caching  Enabling query caching  Configuring transaction local cache settings  Enabling database change notification  Sample script for database stored procedures  Customizing the implementation  CMP runtime monitoring  Web Application Tuning  Using the performance tuning wizard  Tuning server and Web application settings  Tracing properties  Session timeouts  Class loader settings  Servlet buffer pools  Clustered deployments  HTTP and HTTPS listener configuration  SSL and performance  Tuning servlet and JSP settings and code  Use local interfaces for EJB calls  Threading  Preloading classes  JSP compilation options  Precompiling JSPs  JSP file timestamp checking  Runtime compilation settings  Understanding HTTP response caching options  Static page caching  Servlet response caching  Dynamic page caching  Configuring page caching for servlets and JSPs  Configuring Web application page caching properties  Caching an entire tree  Using page caching with filters that modify a response  Using the servlet Java cache  Using partial page caching  Using the caching tag library  The cache tag  The flushCacheByKey tag  The flushCacheByScope tag  Portability considerations  Using the caching API  Class CacheManager  Database Access Tuning  Component design and implementation  Keep transactions short  Minimize result set size  Use database server optimizations  Minimize use of two-phase commit  Clean up connections before releasing them to the cache  Avoid unnecessary database work  Server and component transaction settings  Transaction timeout  Transaction memory table size  Unexpected deadlock errors  Connection cache settings  Tuning the cache size  Monitoring cache activity  Disabling the cache size monitor thread  Tuning caches used by EJB CMP entity beans  Remove unused connection caches  Sanity checking  SQL tracing  Using the caching APIs  Dynamic prepare on jConnect caches  Database and driver specific settings  Cluster Tuning  When to use clusters  Cluster settings that affect performance  Heartbeat detection  Load balancing policy  IIOP client settings that affect load balancing  Web application settings  HTTP session replication mechanism  Lazy session validation  Component settings  Automatic failover  Component state replication  EJB CMP entity bean instance and query caching  Message Service Tuning  Best practices for coding  Global message service settings  Database and connection cache  Tracing  Other global settings  default.maximum  session.timeout  Queue and topic settings  REQUIRES_ACKNOWLEDGE  REQUIRES_TRANSACTION or SUPPORTS_TRANSACTION  Quality of protection  Tables for persistent messages  Queue size  Timeout settings  Thread pools  Shared listeners  The key log table  Using the Performance Monitor  How it works  Configuring memory thresholds  Configuring response rate thresholds  Component settings  Listener settings  Tuning response rate thresholds  Avoiding deadlock scenarios  Obtaining performance monitor statistics  EAServer Message Bridge for Java User's Guide  About this book  Introduction to Sybase Message Bridge for Java™  Why use Message Bridge  The problem  Java and XML capabilities  XML parser strengths and limitations  The solution  What is Message Bridge?  Message Bridge features  How does Message Bridge work?  Understanding the DataBean Framework  Binding framework  DataBean object graph  DataBean method summary  Names and identifiers  An example  Recipe DTD schema  Schema to class mappings  Using the generated DataBeans  Constructing instances of classes from an XML document  Getting the IngredientList from the Recipe  Using getAttribute to get the number of servings  Getting the ingredient elements from the IngredientList  Constructing a new instance of Recipe from scratch (a new Recipe XML document)  Setting the food and quantity of an Ingredient in a Recipe  Creating an XML document from instances of Recipe class  Using DataBeanOpaque to get DTD name prior to choosing binding classes  Using the Message Bridge GUI  Schema groups  Adding a new schema group  Changing the name of a schema group  Message definitions  Adding a message definition for a DTD  Adding a message definition for an XML Schema  Defining namespaces in message definitions that use DTDs  Modifying an element name  Creating views  Code generation  Using Views  The purpose of views  An example of using a view  Locating the Java documentation  Advanced Topics  DataBeanOpaque  Deserialization  Serialization  Validation  Directory structure of generated code  Runtime location of schemas for validation  Using Message Bridge Samples  Sample descriptions and locations  Sample directory content  Running a sample  Understanding the output  Supported Elements and Declarations for Schemas  EAServer Troubleshooting Guide  About this book  Monitoring Techniques  Overview  Gathering information  Logging  EAServer log  Integrating with other logging systems  Server diagnostics  HTTP logs  IIOP log  Installation log  Other useful data  Using stack traces  Obtaining stack traces  EAServer traces  Java exception traces  Tracing network problems  TCP/IP  IIOP  HTTP  TDS  Common Problem Areas  Installation issues  Server crashes, hangs, or disappears  Server crashes  Server crashes on start-up  Server fails at a specific point that is reproducible  Server crashes intermittently  Server hangs  Server disappears  Server slows or runs out of memory  Server starts in Admin mode  Connection problems  Application issues  Generic issues  Java component issues  C++ component issues  PowerBuilder component issues  Avoiding memory leaks  Other design issues  Web server redirector plug-in issues  All Web server redirectors  Microsoft IIS Web server redirector plug-in  Configuration issues  Verifying your configuration  Running EAServer as a service  System-level issues  Operating system issues  CPU sizing  Multiprocessors  UNIX file descriptors  Windows virtual bytes  Performance Issues  Resources  Exception Handling  Overview  Error handling in CORBA Java components  Handling exceptions in CORBA Java clients  CORBA system exceptions in Java  User-defined exceptions in Java  Error handling in CORBA C++ components  CORBA system exceptions in C++  User-defined exceptions in C++  Error handling in ActiveX components  Handling exceptions in ActiveX clients  Using an ActiveX error handler  Structure of an ActiveX exception  Using error pages  Server-level error pages  Error pages for Web applications  Adding an error page  Error pages for JavaServer Pages  Uncaught exceptions  Saving Java source code  JSPs as error pages  PowerBuilder error handling  Unhandled PowerBuilder exceptions  Common Error Messages  Introduction  Error messages  System exceptions  Advanced Topics  Operational management tools  Memory management tools  Evaluating Windows memory  PowerBuilder memory tuning  Runtime monitoring tools  EAServer Manager  EAServer monitoring APIs  jagtool  ListDLLs  Process Explorer  Profiling tools  ps, pstat, pmon, and PsList  SQL tracing  Debuggers  Java debugging tools  Windows debugging tools  UNIX debugging tools  Attaching a debugger to EAServer  Stack traces, dump files, and core files  Windows dump files  UNIX core files  Class loader configuration issues  Common problems with custom class lists  Custom class loader tracing  JAR file locking and copying  Troubleshooting Web services  Check logs and error messages  Verify WSDL files and SOAP addresses  Invoke operations and create a test client  View incoming and outgoing SOAP messages  PowerBuilder Web service considerations  Debugging C++ pseudocomponents  EAServer plug-in for JBuilder  JBuilder JSPs that use connection caches to retrieve ResultSets  WINS and server response time  Windows XP and Service Pack 2  Cisco VPN clients  Personal firewalls and router ACLs  Miscellaneous topics  Additional tools and utilities  Internet Explorer security patch  Drivers that use the DataSource interface  Systems Management Web console  Alert Management System and the message service  Duplicate server names in EAServer Manager

Replication Agent 15.0

Replication Agent for DB2 UDB 15.0

SAP Replication Server 15.7.1 SP203

SAP Replication Server 15.7.1 SP202

SAP Replication Server 15.7.1 SP201

SAP Replication Server 15.7.1 SP200

SAP Replication Server 15.7.1 SP200 (Japanese)

SAP Replication Server 15.7.1 SP200 (Simplified Chinese)

Replication Server 15.7.1 SP110

Replication Server 15.7.1 SP100

Replication Server 15.7.1

Replication Server 15.7.1 (Japanese)

Replication Server 15.7.1 (Simplified Chinese)

Replication Server 15.7

Replication Server 15.6

Replication Server 15.5

Replication Server 15.2

Replication Server 15.1

Replication Server 15.0.1

Replication Server 15.0

SAP Replication Server Data Assurance Option 15.7.1 SP202

SAP Replication Server Data Assurance Option 15.7.1 SP200

Replication Server Data Assurance Option 15.7.1 SP110

Replication Server Data Assurance Option 15.7.1 SP100

Replication Server Data Assurance Option 15.7.1

Replication Server - Data Assurance Option 15.7.1 (Japanese)

Replication Server - Data Assurance Option 15.7.1 (Simplified Chinese)

Replication Server Data Assurance Option 15.7

SAP Replication Server, heterogeneous edition 15.7.1 SP200

Replication Server Heterogeneous Edition 15.7.1 SP100

Replication Server Heterogenous Edition 15.7.1

Replication Server Heterogenous Edition 15.7.1 (Japanese)

Replication Server Heterogenous Edition 15.7.1 (Simplified Chinese)

Replication Server Heterogenous Edition 15.6

Replication Server Heterogeneous Edition 15.2

Replication Server Messaging Edition 15.7.1 [SP100]

Replication Server Messaging Edition 15.7.1

Replication Server Messaging Edition 15.2

Replication Server Option for Oracle 15.7.1 ESD #2

SAP Replication Server Options 15.7.1 SP201

SAP Replication Server Options 15.7.1 SP200

Replication Server Options 15.7.1 SP120

Replication Server Options 15.7.1 SP100

Replication Server Options 15.7.1

Replication Server Options 15.7.1 (Japanese)

Replication Server Options 15.7.1 (Simplified Chinese)

Replication Server Options 15.6

Replication Server Options 15.5

Replication Server Options 15.2

Replication Server Options 15.1

Replication Server Options 15.0

Replication Server Real-Time Loading Edition 15.7.1 ESD #2

SAP Mobile Platform SDK 3.0 SP02

SAP Mobile Platform Server 3.0 SP02

SAP Mobile Platform SDK 3.0 and SP01

SAP Mobile Platform 2.3 SP04

SAP Mobile Platform 2.3 SP03

SAP Mobile Platform 2.3 SP02

SAP Mobile Platform 2.3

SAP Sybase RAP 5.0

SDK for SAP ASE 16.0

Software Developers Kit 15.7 SP127

Software Developer's Kit 15.7 SP121

Software Developer's Kit 15.7 SP110

Software Developer's Kit 15.7 SP100

Software Developer's Kit 15.7

Software Developer's Kit 15.5

Software Developer Kit 15.0

Software Developer Kit 12.5.1

SQL Anywhere 12.0.1

SQL Anywhere 12.0.0

SQL Anywhere 11.0.1

SQL Anywhere 11.0.0

SQL Anywhere 10.0.1

SQL Anywhere 10.0

Sybase Aleri Streaming Platform 3.1

Sybase Aleri Streaming Platform 3.2

Sybase Brand Mobiliser 1.3

Sybase Brand Mobiliser 1.2

Sybase Brand Mobiliser 1.1

Sybase CEP Option R4

SAP Control Center 3.3

Sybase Control Center 3.2.8 ESD2

Sybase Control Center 3.2.8 ESD1

Sybase Control Center 3.2.8

Sybase Control Center 3.2.7

Sybase Control Center 3.2.6

Sybase Control Center 3.2.5

Sybase Control Center 3.2.4

Sybase Control Center 3.2.3

Sybase Control Center 3.2.1

Sybase Control Center 3.2

Sybase Control Center 3.1.1

Sybase Control Center 3.1

Sybase Control Center 3.0.1

Sybase Control Center 3.0

Sybase ETL 4.9

Sybase ETL 4.9 (Simplified Chinese)

Sybase ETL 4.9 (Japanese)

Sybase ETL 4.8

Sybase ETL 4.8 - Simplified Chinese

Sybase ETL 4.8 - Japanese

SAP Sybase Event Stream Processor 5.1 SP04

SAP Sybase Event Stream Processor 5.1 SP03

SAP Sybase Event Stream Processor 5.1 SP02

Sybase Event Stream Processor 5.1 SP01

Sybase Event Stream Processor 5.1

Sybase Event Stream Processor 5.0

Sybase Event Stream Processor 5.0 (Japanese)

SAP Sybase IQ 16.0 SP04

SAP Sybase IQ 16.0 SP03

SAP Sybase IQ 16.0 SP03 (Japanese)

SAP Sybase IQ 16.0 SP03 (Simplified Chinese)

SAP Sybase IQ 16.0 SP2

SAP Sybase IQ 16.0 SP01

SAP Sybase IQ 16.0

Sybase IQ 15.4

Sybase IQ 15.4 (Japanese)

Sybase IQ 15.4 (Simplified Chinese)

Sybase IQ 15.3

Sybase IQ InfoPrimer 15.3

Sybase IQ 15.3 (Japanese)

Sybase IQ 15.3 (Simplified Chinese)

Sybase IQ 15.2

Sybase IQ 15.2 - (Japanese)

Sybase IQ 15.2 (Simplified Chinese)

Sybase IQ 15.1

Sybase IQ 15.1 (Japanese)

Sybase IQ 15.1 - Simplified Chinese

Sybase IQ 15.0

Sybase mBanking 365 3.0

Sybase mBanking 365 2.1

Sybase mBanking 365 2.0

Sybase Mobile Sales for SAP CRM 1.2.1

Sybase Mobile Sales for SAP CRM 1.2

Sybase Mobile Sales for SAP CRM 1.1

Sybase Mobile Sales for SAP CRM 1.0

Sybase Mobile Workflow for SAP Business Suite 1.2.1

Sybase Mobile Workflow for SAP Business Suite 1.2

Sybase Mobile Workflow for SAP Business Suite 1.1

Sybase Mobiliser Platform 5.1 SP03

Sybase Mobiliser Platform 5.1

Sybase Mobiliser Platform 5.0

Sybase SAP DOE Connector 2.1

Sybase SAP DOE Connector 2.0

Sybase Search 3.1

Sybase Unwired Platform 2.2 SP05

Sybase Unwired Platform 2.2 SP04

Sybase Unwired Platform 2.2 SP03

Sybase Unwired Platform 2.2

Sybase Unwired Platform 2.1 ESD #3

Sybase Unwired Platform 2.1 ESD #2

Sybase Unwired Platform 2.1 ESD #1

Sybase Unwired Platform 2.1

Sybase Unwired Platform 2.0 ESD #1

Sybase Unwired Platform 2.0

Sybase Unwired Platform 1.5.5

Sybase Unwired Platform 1.5.3

Sybase Unwired Platform 1.5.2

Sybase Unwired Platform 1.2.4

Sybase Unwired Platform 1.2.2

Sybase Unwired Platform 1.2.1

Sybase Unwired Platform 1.2

Sybase WorkSpace 2.5

Sybase WorkSpace 2.1.2

Sybase WorkSpace 2.1

Sybase WorkSpace 2.0.2

SyBooks 3.4

SyBooks 3.0.1

SySAM Documentation

SySAM Documentation - Japanese

SySAM Documentation - Simplified Chinese

SyBooks Online Infocenter Help