RS16: RSE4015: Outbound enabler of backend server 'S0' in backend farm 'RSTEST02.F0' reports session error OEE_SESSION_ACCESS_FAILED(1051) with parameters 'RS_CLI_REQUEST_CONTINUE', 'disconnected at the middle of a request', '_unused_'

OE16: OEE1051: The Outbound Enabler was unable to access the session with ridx=0 sidx=0 snum=0000 sfp=01aa9daa on a RS_CLI_REQUEST_CONTINUE packet due to disconnected at the middle of a request

RS12: RSE4004: Outbound enabler of backend server 'S0' in backend farm 'MLVM-SARSX64.F0' reports session error OEE25100 with parameters '_unused_', '_unused_', '_unused_'

OE12: Session was disconnected at the middle of a packet sequence. Aborting sidx=0

The problematic sequence has been identified and a fix has been made so that the OE can handle the POST that falls into that sequence. If the traffic is RESTful, a user workaround is to turn off all affinity injection from the Relay Server using the active_cookie=no and active_header=no property in the backend_farm configuration section of the affected backend farm and clear HTTP cookies from the client after the Relay Server configuration has been updated.

A new backend_farm property called socket_level_affinity has been added for controlling the behavior in a per backend farm manner. The liberation described above is DISABLED by default (i.e. socket_level_affinity=yes is the default). Online configuration update of this property is supported.

External Requirements

Updating to this new Relay Server, with socket_level_affinity=no, doesn抰 require deploying a client to clear previous affinity cookie assigned by the Relay Server. Also, the Outbound Enabler doesn抰 need to be upgraded in order to enjoy the liberation. This is an internal behavior change which continues to require the backend servers to allow non-persistent HTTP traffic and/or broken up persistent HTTP traffic. This backend server requirement remains regardless of whether the liberation is used or not. If liberation is enabled, the backend server doesn抰 need to support or allow persistent HTTP connection.

Note that in order to apply this fix, existing version 16.0 database will need to be upgraded once the server containing the fix is deployed. New databases created with the fixed version of the server do not need to be upgraded.

-dt detect transactions only within the current database (for Microsoft SQL Server, Adaptive Server Enterprise and Oracle only)

When this option is used on the command line with Oracle, the MobiLink server will fetch the earliest starting time of the open transactions only that have modified any tables to the current database schema in the prepare_for_download phase, and then the MobiLink server will use this time that is named the next_last_download_timestamp to generate the download stream for the client in the next sync. With this option the MobiLink server may considerably reduce redundant download for any clients that use a timestamp-based download on a busy Oracle database server.

In order to use this new command line option, the user ID the MobiLink server uses to connect to the Oracle database must have a selection permission of the following global views on the Oracle database:

GV$TRANSACTION, GV$SESSION, GV$LOCKED_OBJECT

In order to repair the function in an existing database, run ALTER DATABASE UPGRADE PROCEDURE ON with an upgraded server.

For example, the following text could have been displayed:

SQLANYe_test12

As a workaround, the Details tab can be used to see the missing message for this event. This problem has now been fixed so that the Details tab will include the message, as in the following:

SQLANYe_test12: Starting service SQLANYe_test12

This has now been fixed.

As a workaround, the database files could be put in a directory containing only the database files for a single database.

IMPORTANT: These newer UltraLite clients may in rare cases cause older 16.0 MobiLink servers (prior to build 1584) to crash due to a previously undetected bug.

SQL Anywhere ADO.NET drivers without the 714707 fix may have requests fail with the error "Run time SQL error -- *** ERROR *** Assertion failed: 104909". The ADO.NET driver needs to be updated if this occurs.

- in rare, timing dependent cases, a mirror or copy node could have crashed, hung or failed assertion 102010

- when a mirror or copy node reconnected to the primary or parent, it was possible for it to not request, write or apply log pages.

- when a mirror was yielding to a preferred server, or the "ALTER DATABASE SET PARTNER FAILOVER" statement was executed on the primary, it was possible for the previous mirror to not take over as the primary (both partner servers could have had the mirror role)

These problems have been fixed.

A workaround is to re-open the profiling session after opening the Sample Range Properties window.

Note, this fix also applies to UltraLite and UltraLiteJ for Android.

The task which created this backup (BP-XXXX) could not be found.

This has been fixed.

This has been fixed so the dropped connections are less likely. Note that these errors can still correctly occur if there is a network issue or if either the client or server computers completely bog down (most likely due to limited resources).

Error in the search query "database:4" near "database:4".

Error code: -20090 (DBCLOUDERR_SEARCH_STRING)

This has been fixed.

Also, the software is now more tolerant of whitespace between keywords. For example, suppose the SQL Statements panel contained the following valid statement, spread across four lines:

CREATE

VARIABLE

retcode

INT

Clicking "Help on" in the context menu would have failed to open help because of the newlines that separate the tokens. Now, help for the CREATE VARIABLE statement will be opened.

Note, until SP4 becomes available, to enable current Clouds that have a proxy setting to take advantage of this fix, the new patch "dbcloud-fix-checkforupdates-proxy.patch" must be applied to the Cloud.

http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html

The Content-Encoding header is used by clients to indicate the encoding of the request body. The Accept-Encoding header is used by clients to indicate the preferred encoding of the response body.

A work-around is to execute a ...

SET OPTION PUBLIC.timestamp_with_time_zone_format = 'YYYY-MM-DD HH:NN:SS.SSSSSS+HH:NN'

statement which sets the default required for all .NET connections.

This problem has been fixed.

1. When a column cannot be fetched in its entirety, set status to DBSTATUS_S_TRUNCATED instead of DBSTATUS_S_OK and length to actual length, not amount fetched.

2. IRowsetUpdate methods InsertRow/Update should insert rows in manual commit mode (i.e., commit in batches) rather than autocommit each row.

3. Improved support for DBTYPE_DBTIMESTAMPOFFSET data types.

4. In order to identify columns that are DEFAULT AUTOINCREMENT, IColumnsInfo::GetColumnInfo now sets the DBCOLUMNFLAGS_ISROWVER bit for those columns. Microsoft defines a column with this attribute as a non-writable versioning column (such as the SQL Server TIMESTAMP) which suits SQL Server. Note, however, that SQL Anywhere supports versioning columns that are writable.

5. Corrected failure to describe money/smallmoney as DBTYPE_CY (currency type). Also corrected OLE DB schema queries DBSCHEMA_COLUMNS, DBSCHEMA_PROCEDURE_COLUMNS, and DBSCHEMA_PROCEDURE_PARAMETERS results for DBTYPE_CY.

6. Corrections to schema rowset information (DBSCHEMA_COLUMNS, DBSCHEMA_PROCEDURE_COLUMNS, and DBSCHEMA_PROCEDURE_PARAMETERS) for datetime/time precision and scale.

7. Corrections to 搑un-time� information for datetime/time precision and scale.

8. Add "DATETIME" to list of DBPARAMBINDINFO.pwszDataSourceType types for SetParameterInfo (SQL Server uses this undocumented type name). Type names are usually of the form 揇BTYPE_xxx� (for example, 揇BTYPE_I4�, 揇BTYPE_STR�, 揇BTYPE_DBTIMESTAMP�).

9. Adjust GetConversionSize values for TIME, DATETIME, DATETIMEOFFSET data types (only 6 fractional digits are supported by SQL Anywhere).

10. Fixed memory leak caused by failure to free rows whose refcount is 0 in Update().

11. Fixed possible memory corruption in calls to IRowsetChange::SetData, IRowsetChange::InsertRow, ISequentialStream::Write, and IRowChange::SetColumns.

12. Fixed performance problem when DataConvert is used when no conversion is required.

13. The LoadCommand, DeleteCommand, and SaveCommand methods of the ICommandPersist interface did not qualify system tables references with an owner name. This has been corrected.

14. The OLE DB provider accepts two cbBookmark values, 1 which is the 搒hort� DBBMK_FIRST/LAST value, and 4 or 8 depending on the bitness of the provider. The 64-bit provider flags �4� was an illegal value for cbBookmark. The 32-bit provider flags �8� was an illegal value for cbBookmark. The OLE DB provider should accept both 4 and 8 as the length of a bookmark value and fetch the appropriate 32-bit/64-bit bookmark value from memory. This problem has been corrected. The fix affects IRowsetLocate::GetRowsAt, IRowsetLocate::Compare, RowsetLocate::GetRowsByBookmark, IRowsetLocate::Hash, and IRowsetScroll::GetApproximatePosition, and IRowsetExactScroll::GetExactPosition. Both 32-bit and 64-bit providers now support 4-byte and 8-byte bookmark values, in addition to 1-byte values.

Also, when the stated precision of a decimal value parameter was much less than the actual precision of a decimal value, it is possible to corrupt the heap.

parm.Precision = 5;

parm.Value = (decimal) 123456789;

These problems have now been fixed.

If, while processing ALTER DATABASE SET PARTNER FAILOVER, connections between the primary and mirror servers timed out, or were dropped, before the failover operation completed, the primary server could have stopped accepting connections.

The sa_mirror_server_status log_written offset could have been incorrect about the time a log rename occurred.

file_path long nvarchar the path of the server accessible file or directory

file_type nvarchar(1) either F for file or D for directory

file_size unsigned bigint the size of the file or NULL for directories

In order to provide more information about the various files and directories, dbo.sp_list_directory() has now been enhanced to return five additional columns. These five additional columns are:

owner nvarchar(128) the owner of the file or directory

create_date_time* timestamp with time zone the date and time the file or directory was created

modified_date_time* timestamp with time zone the date and time the file or directory was last modified

access_date_time* timestamp with time zone the date and time the file or directory was last accessed

permissions varchar(10) the set of access permissions for the file or directory

All other aspects of dbo.sp_list_directory() � including the set of system privileges and secure feature privileges � remain unchanged.

A database either has to be upgraded or initialized in order for applications to obtain this new information from dbo.sp_list_directory(). In addition, if an upgraded or newly initialized database is subsequently moved to an older version of the server, then the new columns will continue to be returned but the values of the new columns will be NULL.

- HAVING SUM( column ) <= constant

- HAVING SUM( column ) < constant

- HAVING SUM( column ) > constant

- HAVING SUM( column ) >= constant

so that incorrect selectivity could be returned in the following cases:

- the column was a number but the constant was not (e.g., it was a date).

- the comparison relation was <> or = (these can not be estimated).

- the comparison was of the form SUM(column) LIKE string_constant.

This has now been corrected.

This has been fixed. Note that this failure (database is not compatible) can still validly occur in certain cases.

ST_GEOMETRY::ST_BUFFER( distance double, unit_name long varchar )

- distance: The distance the buffer should be from the geometry value. Must be greater than or equal to 0.

- unit_name: The units in which the distance parameter should be interpreted. Defaults to the unit of the spatial reference system. The unit name must match the UNIT_NAME column of a row in the ST_UNITS_OF_MEASURE view where UNIT_TYPE is 'LINEAR'.

- Returns the ST_Geometry value representing all points within the specified distance of the original geometry.

The ST_Buffer method generates a geometry that expands a geometry by the specified distance. This method can be used, for example, to find all points in geometry A that are within a specified distance of geometry B. The distance parameter must be a positive value. This method will return an error if distance is negative. If the distance parameter is equal to 0, the original geometry is returned. The ST_Buffer method is best used only when the actual buffer geometry is required. Determining whether two geometries are within a specified distance of each other should be done using ST_WithinDistance instead.

Syntax:

READ_SERVER_FILE( filename ) [, start [ , length] ]

Parameters:

- filename LONG VARCHAR value indicating the path and name of the file on the

server.

- start The start position of the file to read, in bytes. The first byte in

the file is at position 1. A negative starting position specifies

the number of bytes from the end of the file rather than from the

beginning.

* If start is not specified, a value of 0 is used.

* If start is zero and length is non-negative, a start value of 1

is used.

* If start is zero and length is negative, a start value of -1 is

used.

- length The length of the file to read, in bytes.

* If length is not specified, the function reads from the starting

position to the end of the file.

* If length is positive, the function read ends length bytes to the

right of the starting position.

* If length is negative, the function returns at most length bytes

up to, and including, the starting position, from the left of the

starting position.

Returns:

LONG BINARY

Remarks:

This function returns the full or partial (if start and/or length are specified)

contents of the named file as a LONG BINARY value. If the file does not exist or

cannot be read, NULL is returned.

filename is relative to the starting directory of the database server.

The READ_SERVER_FILE function supports reading files larger than 2GB. However,

the returned content is limited to 2GB. If the returned content exceeds this

limit, a SQL error is returned.

If the data file is in a different character set, you can use the CSCONVERT

function to convert it. You can also use the CSCONVERT function to address the

character set conversion requirements you may have when using the

READ_SERVER_FILE server function.

If disk sandboxing is enabled, the file referenced in filename must in an

accessible location.

Privileges:

When reading from a file on a client computer:

* You must have the READ FILE system privilege.

* You must have read permissions on the directory being read from.

Standards: SQL/2008 Vendor extension.

Example:

The following statement reads 20 bytes in a file, starting from byte 100 of the

file.

SELECT READ_SERVER_FILE( 'c:\\data.txt', 100, 20 )

See also

* xp_read_file system procedure

* CSCONVERT function [String]

* Disk sandboxing

DELETE

FROM [owner.]table_1 [ [ AS ] correlation-name ]

FROM [owner.]table_1 [ [ AS ] correlation-name ] ...

WHERE ...

and

UPDATE [owner.]table_1 [ [ AS ] correlation-name ]

SET columns_1 = ...

FROM [owner.]table_1 [ [ AS ] correlation-name ] ...

WHERE ...

If the DELETE or UPDATE clause and the additional FROM clause have a table reference that contains the same table name, in the above example "table_1", then the server can only decide whether both are identical table references if one of the following conditions is true:

- both table references are not qualified by specifying a user ID

- both table references are qualified by specifying a user ID

- both table references are specified with a correlation name

In cases where the server cannot decide whether the above table references are identical or not it will now return an SQL error to prevent the user from unintended semantics like deleting and updating to many rows.

A work-around is to use addBatch/executeBatch for all executions of the prepared statement once addBatch/executeBatch has been used.

A workaround is to use setup -nogui to avoid the use of the graphical installer. Alternatively, install to a smaller disk drive.

A workaround is to avoid specifying -nogui when doing a silent install.

A workaround is to disable the Utilization Graph pane, or to resize the Chart pane so that it has a scroll bar.

- ansinull=On

- conversion_error=On

- divide_by_zero_error=On

- sort_collation=Internal

- string_rtruncation=On

, and the specified value was then set as a temporary option for the connection creating a materialized view, recovery of the CREATE MATERIALIZED VIEW statement would have failed. This has been fixed.

Note that the fix applies only to the CREATE statement executed with the fixed version of the server.

"unsupported function included: CURRENT_TIMESTAMP is not supported by generated always"

when trying to run the MobiLink server setup script file, synchana.sql against a database running on a HANA server, if the HANA server revision was 1.00.64 or later. This problem has now been fixed.

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

Prior to this change, SQL Anywhere included a Certicom encryption module that provided strong encryption used throughout the software. Now, SQL Anywhere includes an OpenSSL encryption module for the strong encryption. The Certicom encryption module has been removed.

Read the following descriptions to determine how you may be impacted by this change.

FIPS encryption now requires the private key of an identity file to be encrypted using AES

- OpenSSL FIPS supports AES encryption for the private key of an identity file. New servers using the OpenSSL FIPS encryption module will not start when using an identity file that has its private key encrypted with 3DES. You must re-encrypt the identity file using AES. To do this, run a command similar to the following using an upgraded viewcert utility:

viewcert -p -o new-file-name -op new-password -ip old-password old-file-name

The new and old passwords can be the same.

- The sample server identity file (rsaserver.id) and client identity file (rsaclient.id) have been modified so that the private keys are encrypted using AES rather than 3DES.

- Versions of the server that use the Certicom encryption module will not start when using an identity file that has its private key encrypted using AES. Trusted root certificate files specified using trusted_certificates do not need to be modified.

Self-signed certificates must now have the Certificate Signing attribute set

Self-signed certificates must now have the Certificate Signing attribute set when using the identity encryption option (for example, the -x mlsrvXX and -xs dbsrvXX options). To determine if a certificate has the Certificate Signing attribute set, use the viewcert utility and look for the Certificate Signing attribute in the Key Usage portion of the output. If your self-signed certificates do not have the Certificate Signing attribute set, then you must regenerate the certificates.

Create Certificate utility (createcert) now uses AES encryption instead of 3DES

The Create Certificate utility (createcert) now uses AES rather than 3DES encryption for encrypting the private key in the server identity file.

A new option, -3des, has been added to the Create Certificate utility. Use this option when you want to create a 3DES-encrypted server identity file that can be used by both new and old servers. Note that new servers running in FIPS mode cannot start using 3DES-encrypted certificates; however, if you are not running in FIPS mode, then you can use 3DES-encrypted certificates.

View Certificate utility (viewcert) now uses AES encryption instead of 3DES

The View Certificate utility (viewcert) now uses AES rather than 3DES encryption when you specify the -p option to PEM-encode the output and when you specify the -ip and -op options to set the password.

A new option, -3des, has been added to the View Certificate utility to allow you encrypt output and passwords using 3DES instead of AES.

Database server now loads the FIPS driver file, dbfipsXX.dll, at startup

Previously, the 32-bit Windows database server loaded the FIPS driver file, dbfipsXX.dll, only when needed. Now, the 32-bit Windows database server always attempts to load dbfipsXX.dll at startup, and keeps it loaded for the life of the server. If loading dbfipsXX.dll fails, then an error is returned only when an attempt is made to use FIPS encryption.

Deploying FIPS

If you are deploying FIPS encryption, then there are new shared libraries to deploy; these files are included in your software. The former files, sbgse2.dll and libsbgse2.so, are no longer installed by the software. The new files to deploy are:

- Windows 64-bit: libeay32.dll, ssleay32.dll, and msvcr100.dll

- Windows 32-bit: libeay32.dll, ssleay32.dll, and msvcr90.dll

- Linux: libcrypto.so and libssl.so

Note: On Windows, although 32-bit and 64-bit FIPS-certified OpenSSL libraries for encryption are provided, you must use the 64-bit libraries on a 64-bit system.

MobiLink-related changes and information

Connecting to a MobiLink server using client-side certificates now requires the Digital Signature certificate attribute to be set

TLS/SSL connections to a MobiLink server using client-side certificates now require the client-side certificate to have the Digital Signature attribute set. If the attribute is not set, then the connection will fail.

To determine if a certificate has the Digital Signature attribute set, use the View Certificate utility (viewcert) and look for the Digital Signature attribute in the Key Usage portion of the output. If your client-side certificates do not have the Digital Signature attribute set, then you must regenerate the certificates.

FIPS-based end-to-end encryption now requires the private key to be encrypted using AES

If the private key file provided to a MobiLink server by the e2ee_private_key file option of the 杧 command-line option is encoded using 3DES and you are running in FIPS mode, then the private key file needs to be regenerated with the private key encrypted using AES.

How to update a MobiLink deployment that uses non-FIPS TLS/SSL (includes HTTPS) and client-side certificates

1. If your client-side identity certificates do not have the Digital Signature attribute set and the client connects directly to the MobiLink server, then you must regenerate and deploy client-side certificates with the Digital Signature attribute set.

2. Update the server-side binaries.

3. Update the client-side binaries.

How to update a MobiLink deployment that uses FIPS, TLS/SSL (includes HTTPS) and client-side certificates

These steps update the client identity certificates twice if the Digital Signature attribute is missing from client-side identity certificates. This procedure can make the update less disruptive because synchronizations can continue without having to coordinate the client-side and server-side updates to occur at the same time.

1. If your current client-side identity certificates do not have the Digital Signature attribute set and the client connects directly to the MobiLink server, then you must regenerate and deploy client-side certificates with the Digital Signature attribute set.

2. Update the server-side binaries (remembering to include the new FIPS driver files) and deploy server identity certificates with AES-encrypted private keys.

3. Update the client-side binaries (remembering to include the new FIPS driver files) and deploy client identity certificates with AES-encrypted private keys.

How to update a MobiLink deployment that uses FIPS and end-to-end encryption

1. Regenerate the primary key file referenced by the e2ee_private_key encryption option.

2. Shut down the MobiLink server.

3. Update the MobiLink server binaries, remembering to include the new required FIPS driver files.

4. Change the e2ee_private_key option to point to the new private key file (or replace the old file), updating the e2ee_private_key_password, if required.

5. Restart the MobiLink server.

Note, connecting to and creating a MobiLink server resource in the 32-bit Windows SA Monitor that will use FIPS encryption to connect to the MobiLink server, may fail with the error, 揊ailed to load library mlcrsafips12.dll�. To work around this, you can either not use FIPS encryption, or use 64-bit SA Monitor. Similarly, connecting to a database server from 32-bit DBISQL, DBConsole, or Sybase Central using FIPS encryption, may also fail with the error, 揊ailed to load library mlcrsafips12.dll�. To work around this problems, you can either not use FIPS encryption, or use 64-bit client software.

A work around to the issue is to restart the MobiLink Server.

Upgrading overwrites the JRE directory (%SQLANY16%\binXX\jre170) and its subdirectories. If you are using certificates, then your certificate store (%SQLANY16%\binXX\jre170\lib\security\cacerts) is overwritten, including your certificates. Similarly, fonts you added to the %SQLANY16%\binXX\jre170\lib\fonts\fallback directory to help display characters in the administration tools may be lost. To minimize upgrading steps with regards to the JRE change, create a backup copy of the JRE directory and all of its subdirectories before you upgrade so that you can refer to or restore files (such as cacerts) from the backup, as needed. To restore settings, use the java_vm_options option (SQL Anywhere), and/or the -sl java option (MobiLink) to optimize your Java VM startup settings.

- the mirror or copy node must have been fairly recently started and requesting log pages (in the case of the mirror, not yet synchronized)

- the mirror or copy node must have been writing pages from the primary's current log file

- the primary log file was renamed

- something (such as a virus scanner) must have accessed the renamed log on the primary (or parent), preventing the primary from opening the file when the mirror or copy node requested pages from it

This has been fixed so that the primary or parent will attempt to open the renamed log several times before failing. If the file open still fails after multiple attempts, the primary will display the message "Database "<database-name>" mirroring: failure when opening log file <file-name> for remote server <server-name>" and the mirror or copy node will display the message "Database "<database-name>" mirroring: database is not compatible with primary; files must be replaced" and shut down the database.

Note, the same sizing issue also occurred with the 揙ptions� window of the SQL Anywhere Console utility.

- The OData Version 2 specification is unclear in the case of the max constant for the MaxLength attribute of a property. Many clients will accept both 搈ax� and 揗ax� as valid cases, but the Microsoft clients only accept 揗ax�. In OData version 4+, the spec is clear that the correct case is 搈ax�. To avoid such issues two things have been done:

1. For SQLA and ASE, the MaxLength attribute will always specify the MaxLength attribute with a number in the range 1 to 2^31-1 (to avoid the use of 搈ax� altogether).

2. It is possible for an IQ column to have a value that is larger than 2^31-1 bytes/characters, in which case we must continue to use 搈ax�. The default case will continue to be 搈ax� but the OData server administrator can override the case using the __MaxLengthMaxString option in the config file.

- The DefaultValue attribute was being used incorrectly. The Microsoft OData clients expect the DefaultValue attribute of a given type to be a valid value (as would appear in a request URL) for that type. For example, the DefaultValue for an Edm.Int32 must be an 32-bit integer. This is somewhat unclear in the version 2 OData spec but is clearly the stated behaviour in OData version 4+.

The DefaultValue attribute was being used to represent the underlying default of the database (for example, an autoincrement column would have DefaultValue=攁utoincrement�). Since the DefaultValue attribute is not appropriate for all possible default values that an underlying column in the database can have, we will no longer expose default value information in the metadata document using the DefaultValue attribute.

- ASE Money data type columns were reporting a Precision and Scale of 0.

a) The setting for the ldap_failover_to_std property for a user authentication policy is extended to be 0, 1, or 2 [it originally accepts only 0 (FALSE) or 1 (TRUE)). The MobiLink server will authenticate users in the following ways, when ldap_failover_to_std is

0: The MobiLink server will authenticate the user against LDAP server only. If the user cannot be authenticated against a LDAP server, the MobiLink server will fail the sync request, regardless of the types of the errors;

1: The MobiLink server will authenticate the user using the standard script-based user authentication, if and only if the LDAP server(s) are not available. The authentication status, 6000 will be passed to the user authentication scripts, if the LDAP servers are not available;

2: The MobiLink server will authenticate the user against a LDAP server first and then authenticates the user with the standard script-based user authentication, no matter if the user is authenticated or not with the LDAP server. The MobiLink server will pass one of the following values as a user authentication status to the scripts:

1000: if the user is authenticated against the LDAP server;

4000: if the user is not authenticated against the LDAP server; or

6000: if the LDAP servers are not available.

b) User authentication using a default authentication policy:

The MobiLink server now supports user authentication against a LDAP server using a default user authentication policy. The default policy name can be specified from the new MobiLink server command option: -zup <name> "set default policy name for user authentication (implies -zu+, cannot be used with -zu-)"

When a policy name is specified on the MobiLink server command line with this new option, any new MobiLink users that aren抰 in the ml_user table will be first authenticated against the LDAP server using this default policy, and then optionally calls the user authentication scripts, if the ldap_failover_to_std property for the default policy is configured with a value of 1 or 2. If the user is fully authenticated, it will be added into the ml_user table and the same user authentication policy will then be used to authenticate this user later. This new command line option implies 杬u+ and it cannot be used with 杬u-. The MobiLink server will complain, if both 杬up and 杬u- are given on the command line.

Please note: the given default user authentication policy name must exist in the ml_user_auth_policy table , otherwise the MobiLink server will complain and refuses to start.

c) The MobiLink user password will be hashed and stored in the ml_user table in the consolidated database, if and only if the ldap_failover_to_std property is configured with a value of 1 or 2. The password will not be saved, if this property is set to 0.

- the -o option was not specified, AND

- if any of the environment variables $TMPDIR, $TMP, $TEMP was defined but the directory did not exist.

Depending on how rshost was started, it could have failed silently. This has been fixed.

In addition, transferring many log pages between mirror servers may have been slower than necessary. The default maximum packet size used for connections between mirror servers has been increased, which can improve performance in some cases. 16.0.0 mirror server connections now default to a maximum packet size of 64240 bytes, and 12.0.1 mirror server connections now default to a maximum packet size of 16000 bytes.

Note that UltraLite does not support the clause 揥ITH NULLS NOT DISTINCT� for the CREATE INDEX statement. Therefore, an index key should be considered unique if it contains NULL in at least one column.

Each bottom level directory in the following tree under the SQLA install root contains a WinRT-based component (UltraLite.winmd/UltraLite.dll) that implements the UltraLite API for the noted platform.

UltraLite

+-- WinRT

|-- WindowsPhone

| +-- 8.0

| +-- arm : Windows Phone 8 devices

| +-- x86 : Windows Phone 8 emulator

+-- Windows

+-- 8.0

+-- arm : Windows RT ARM-based devices

|-- x64 : Windows 8 store apps for x64 architecture

+-- x86 : Windows 8 store apps for x86 architecture

Developing UltraLite applications using this software requires SQL Anywhere 16 and Microsoft Visual Studio 2012 or later.

Developing Windows Phone applications requires the Windows Phone SDK 8.0, which is available from:

http://dev.windowsphone.com/en-us/downloadsdk

Windows Phone SDK 8.0 requires Windows 8. Microsoft lists the complete system requirements at:

http://www.microsoft.com/en-us/download/details.aspx?id=35471

Developing Windows store applications requires the Windows SDK for Windows 8, which is available from:

http://msdn.microsoft.com/en-us/library/windows/desktop/hh852363.aspx

The UltraLite.WinRT directory under the SQLA samples root contains a Visual Studio 2012 solution for the CustDb sample that appears in various forms for other UltraLite supported platforms.

[-10382] The MobiLink Server has failed to start

This problem has now been fixed.

- Interactive SQL 12 was being run and the "Help" button was clicked on the "Connect" window the first time it was opened, and the network used a proxy to connect to the internet.

- Sybase Central 12 or later, or Interactive SQL 12 or later, was being run and the fast launcher was turned on, and the network used a proxy to connect to the internet.

These problems have been fixed.

- The maximum size of the VARCHAR2, NVARCHAR2, and RAW data types has been increased from 4,000 to 32,767 bytes

- Implicit result sets can be returned from stored procedures. However the number of implicit result sets is limited to one per stored procedure. The implicit result set will be detected automatically by the ODBC driver regardless of the setting for the 揚rocedure returns results or uses VARRAY parameters� option in the DSN used by the ODBC application

When the database is running on an Oracle 12.1 server and the OCI library is from the Oracle 12.1 installation.

- If a database contained a dbspace with a relative pathname, and the server was not started in the same directory as that file, the CREATE ENCRYPTED/DECRYPTED DATABASE statements would not have been able to find the dbspace file

- In the above case, the error message would have said 揙utput file cannot be written� even though it was an input file causing the problem. The error message had no indication of which file caused the problem

- If the target filename for these statements was in a different directory, the encrypted or decrypted dbspace files would have remained in the original directory.

For example, if a database had a dbspace with the filename 揹bspace.dbs� and the following was executed:

create encrypted database 憂ew/sales.db� from 憇ales.db� key 憁yencryptionkey�

the server would have created the new dbspace.dbsE file in the same directory as dbspace.dbs, rather than in the 搉ew� subdirectory.

These problems have now been fixed.

The new MobiLink Server 杬up switch. This switch can be accessed from the Advanced tab of the property sheet for a MobiLink Server Command Line. An error is reported if 杬up is set and 杬u is set to false, as this is not allowed.

For user authentication policies we now support calling the standard MobiLink authentication scripts: Never, Always or only when an LDAP server could not be found. This change affects the LDAP Servers page of the New User Authentication Policy wizard. It also affects the property sheet for user authentication policies. The setting is also shown in the right hand pane when User Authentication Policies are shown.

- the database was backed up from the primary or root using dbbackup or the BACKUP statement

- while dbbackup was running, there must have been other connections to the primary or root that had modified the database

- between the backup and when the copy node was started on the backed up database, there was no commit done on the primary or root

If this problem was occurring, the sa_mirror_server_status row for the copy node would show the copy node was connected with a recent last_updated value, but the log_written and log_applied values would not change. If the copy node was restarted, it would start applying and writing changes. This has been fixed.

A workaround is to manually remove all but one row from ml_scripts_modified table before starting the MobiLink Server.

If an ALTER MIRROR SERVER statement was used to add an alternate parent to a running and connected copy node, the alternate parent would have been used until the copy node restarted. This has been fixed so the alternate parent can be used the next time the copy node loses its connection to its parent.

Also, when fetching a Date, Time, or Timestamp, or other types that are not native strings or numerics, from the database when the clients character set is different from the database character set, the data would have been returned in the database character set. This has been fixed so the data will returned to the client in the client's character set.

SQL statement failed: (-685) Resource governor for 'prepared statements' exceeded

when it was running in a continuous mode with the command line option 杧. This problem has now been fixed.

Also, if a server to server mirror connection failed due to a liveness timeout, no message was logged even if -z was enabled. In addition, other server to server connections contained little diagnostic information even if -z diagnostic logged was enabled. This has been fixed so that liveness timeout messages for mirror server connection are logged with or without -z. In addition, the messages "mirror server connection closed by other side" and "connection terminated abnormally; error code <number>" will be logged if -z is used and a mirror server connection is closed by the remote server or fails due to a network error.

set contains additional incorrect result rows.

For example, in the below query the predicate "v2.c = 0" can be pushed inside the derived table "v2" and derived table "v2" can be flatted. Predicate is not executed in this case.

select *

from ( select distinct *

from ( select a, sum(b) c from T1 group by a ) v1

) v2

where v2.c = 0

This has been fixed.

select (B.gencol1).id as gencol1 from (

select ROW(A.id) as gencol1

from Product A

group by A.id) B order by gencol1

B.gencol1 is a row with one column named id in it. (B.gencol1).id should have been able to reference to that column. In fact, it can reference it when 揼roup by A.id� is removed. However, when the GROUP BY was present, an error was returned: 揷olumn 慽d� not found in variable (B.gencol1)�. This has now been corrected.

Note, model files may still refer to Database names that are not valid OData identifiers, however they must be renamed using 揂S� clause.

The value for property "{columnname}" in a key predicate is formatted incorrectly.

If paging through descending order on a column with nulls, skiptoken may have missed results or restarted at top (thus creating an infinite dataset). This has been fixed.

"select replace( 'XAAAAAAAXBBBBXBBBB', 'XAAAAAAA', 'Z' )".

This has been fixed

new ST_Point( 2, 2.5 ).ST_Buffer( 1.1 )

Trying to use the resulting CurvePolygon in an operation may have caused unpredictable results. This has been fixed.

Note, this issue doesn抰 happen on the Apache Relay Server.

Note, older dbostop16 utilities will not be able to shutdown newer OData Server, and new dbostop16 utilities will not be able to shutdown older servers.

- The OData Producer now supports Optimistic Concurrency Control as defined by versions 2.0 of the OData Specification.

Using the OSDL model definition file (see Example 1), a developer may specify a set of properties on an Entity Type to define the concurrency token of the Entity.

- The OData Producer now supports Service Operations using HTTP GET and POST methods as specified by version 2.0 of the OData Specification.

Developers must declare explicitly what service operations to expose in an OSDL file.

- OData Producer uses less objects when caching metadata for users that have (from the OData Producer抯 perspective) identical access.

- OSDL files support added escape sequences in quoted strings

- Associations are now annotated as referential constraints in the metadata and association properties of referential constraints are now visible by default. Association may also have OnDelete attributes in the metadata which documents how the dependent entity instance is affected when the associated principal entity instances is delete.

- The log generated by OData Producers has been enhanced to identify the producer and request associated with each log event.

- OData server supports multiple producers

dbosrv16 can now host multiple producers, each connecting to a different database. All producers share the same options configuration file and are hosted on the same port. The producer configuration file syntax has been augmented for this feature.

- The OData producer now supports a greater subset of the OData Service Definition Language (OSDL).

The new supported syntax adds the ability to:

- Explicitly set the name of tables that are exposed through the producer

- Explicitly include/exclude columns

- Define entity sets with generated keys

- Define associations between entities, including complex associations that use an underlying association table

- Define navigation properties

SQLCODE -1325: Column subset for table '%1' in publication '%2' does not match that specified in publication '%3'

This has been fixed.

"Table '_^_^_22072007_^_^_759_^_^_22072007_^_^_' not found"

for an internal temporary table if an INSERT, UPDATE, or DELETE statement triggered the change of an immediate materialized view. The problem only happened when the very first INSERT, UPDATE, or DELETE of the table in a connection was executed in a nested block, for example a trigger or procedure. In this case subsequent DML operations on the

table may then have returned the above error. This has been fixed.

This issue was partially fixed by the changes for Engineering case 752610, but this change goes beyond it by fixing the following problems as well:

- On the Search panel, the "Search" button enabling logic and the button's clicking logic would stop working after the look-and-feel changed.

- Sybase Central could have crashed if any of the following panels/windows were open when the look and feel were closed:

1. "Results" on the "Search" pane

2. The list of plug-in in the "Sybase Central Plug-ins" window.

3. The connection profiles window

4. The About window

5. The Disconnect window

- The background color of items in details panels would have been painted gray (rather than white) after switching look-and-feel.

- Drop-down toolbar buttons (e.g. "Tools") did not draw their arrow, and did not open when clicked.

HTTP ERROR: 500

Problem accessing /odata/Filter03/T6. Reason: while trying to invoke the method

com.sybase.odata.producer.util.RequestWrapper.getParameterMap() of a null object

loaded from field com.sybase.odata.producer.handler.AbstractHandler.request of an

object loaded from local variable 'this'

This has been fixed. Clients will now get

HTTP ERROR: 400 Bad Request

<?xml version="1.0" encoding="utf-8"?>

<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">

<code>30175</code>

<message xml:lang="en-US">An error occured while parsing the request URI at offset 59.</message>

</error>

- when failover occurs and the mirror server takes over as the primary "Now running as primary server" is now logged. Previously, "Database <name> (<file>) started at <date/time>" was logged, which was incorrect because the database was already started and was not restarted.

- if the mirror server was behind applying operations and caused the primary to block for more than 10 seconds, "primary blocked for <number> seconds waiting for the mirror to catch up" is logged.

- transaction log start and current offsets are now displayed when starting up a database and at other transitions (such as when the transaction log is restarted).

- if there was an unexpected error that caused applying the transaction log to fail, a message is displayed and the database is not automatically restarted

For example: If a table has a primary key on columns (col1, col2) and there is another index on columns (col2, col3, col1) then this other index is unique as well.

The optimizer relies very much on this unique property of an index for cardinality estimation. So the server may have used an non-optimal plan if above conditions were true. This has now been fixed.

application/xml

application/atom+xml

application/json

*/*

For example, this statement would not have handled the \� sequences and would have generated an error:

call sp_parse_json( 憁yvar�, 慬{s:攖his is \攓uoted text\�.攠]� );

This has been fixed.

In the existing databases, LineStrings that cross equator from South to North and are stored in a Round Earth SRS (for example, 4326) should be reloaded in order to be stored in the correct representation.

In rare, timing dependent cases, if multiple connections were running the same procedure concurrently and a DDL operation occurred, the server could have hung. In order for the hang to have occurred, the procedure needed to have had multiple statements that referenced the same view. This has also been fixed.

"File or directory /opt/saondemand100/data/staging/SD-z6b9/Bin64/libeay32.dll not found"

This has been fixed.

Note that this change is most significant when querying the mv_known_stale_at column from SYS.SYSVIEW since 0000-01-00 represents a materialized view that is either fresh or in an unknown state. The value will now be returned as 0001-01-01 instead.

This has been fixed.

References to the Usage Server have been removed. The following hyperlinks have been removed from the Cloud's "Overview" page: "Activate the cloud", "Refresh activation state", "Send usage information", "Log in to Usage Server".

On the Cloud overview page, the "Licensing" properties are now displayed all the time. Previously, they appeared only after the cloud was activated. The "Licensing" section now includes two new links: "Add Licenses" and "Remove Licenses" for managing cloud licenses.

--CONNECT-1025-0000952657-failure-2014-03-18 09:36

indicating a possible connection failure. This has been fixed. These lines do not indicate a connection failure. They can be safely ignored and will not show up in transaction logs created with fixed servers.

successfully authenticate. This has been corrected.

These unneeded evaluations are now skipped. A change in behaviour is that side effects and errors are no longer observed in some cases. There may still be more executions than client fetches due to factors such as prefetching.

The same incorrect behaviour would also have occurred with the SetString method of ResultSet and Table, and with the SetParameterBytes method of PreparedStatement. These cases have also been fixed.

-- The dialog appeared to give the option of creating both 32 and 64-bit versions of a user data source. This option applies only to creating system DSNs, and is now disabled.

-- When trying to create both a 32 and 64 bit system DSN, but the 32-bit could not be created, the error message was irrelevant. This has been fixed; the error message now says why the data source could not be created.

-- Data sources could be created with non-canonical forms of the connection parameter names. This would have prevented the Data Source utility (dbdsn) from listing the data source completely. This has been fixed.

-- Creating a system data source could have caused up to three elevation prompts if a 32-bit data source was also created. Now, there is at most one prompt.

-- The dialog allowed creation of a user data source, even if there was already a system data source of the same name. Similarly, it allowed creation of a system data source with the same name as an existing user data source. This was very poor practice and could have lead to unexpected results if a user didn't realize that user data sources take precedence, and so the practice is now simply disallowed.

When quoted_identifier was 'off':

1. For a Sybase IQ DBMS, the driver would have reported [SQL Anywhere] in messages rather than [Sybase IQ].

2. For a Sybase IQ DBMS, the driver would have reported "SQL Anywhere" instead of "Sybase IQ" for SQLGetInfo(SQL_DBMS_NAME).

3. For a Sybase IQ DBMS, the driver would not have used the "SYS.SYSIQVINDEX" table for SQLStatistics, but would have used "SYS.SYSINDEX" instead.

4. For a Sybase IQ DBMS, the ODBC driver will report the wrong server version number (e.g., 12.0.1 rather than 15.4) for SQLGetInfo(SQL_DBMS_VER).

In addition, when quoted_identifier was 'off' or the server was version 9.0.2 or earlier:

5. The ODBC driver would not have known the correct CHARSET setting.

6. The ODBC driver may have had the wrong setting for the case sensitivity of the database and may have affected SQLGetTypeInfo and other schema query functions.

7. The ODBC driver may have had the wrong setting for the odbc_distinguish_char_and_varchar option.

8. The ODBC driver may have had the wrong setting for the odbc_describe_binary_as_varbinary option.

Other than these issues, there are no other known side-effects.

This problem has been fixed.

For OData Producers deployed using the OData Server utility (dbosrv16), paths are relative to the current directory when the server was launched.

When a single file gets too big, the server will now detect this situation, version 11 and 12 servers will display a failed assertion message and shut down. Version 16 and later servers will display a failed assertion message and shut down only the affected database.

Content-Type: multipart/mixed; boundary=batch_e30b82d3-3d8a-430d-b66f-9fec1df8ae19; charset=utf-8

would have resulted in a 404 error. This has been fixed.

As a work around, database administrators should directly grant execute permission on given stored procedures or functions to the affected users.

- SQL Anywhere Server when using TLS (Transport Layer Security) communications and/or HTTPS web services, though only to the networks that can access the server. Calling external web services over HTTPS from the database server were also affected.

- MobiLink Server when using TLS and/or HTTPS communications, though only to the networks that can access the MobiLink server.

- Relay Server Outbound Enabler

Affected Versions (note that all platforms were impacted by the vulnerability):

- SQL Anywhere 12.0.1 builds 3994-4098

- SQL Anywhere 16.0 builds 1690-1880

This vulnerability has been resolved by replacing the OpenSSL libraries with corrected versions. Once this SP has been applied, regenerate any certificates that were being used, and then change any passwords/keys associated with SQLA web service calls or TLS authentication.

This prolem also affects the Interactive SQL utility. It has been present since version 9.0.2, possibly earlier.

For example:

OEE1048: The communication between the Outbound Enabler and the backend server failed with [MLC24: ???] while performing secured write. sidx=0 socket=01028188 sfp=58f2ed03

A workaround to diagnose the communication error in the case where the RSOE didn抰 crash is to look at the Relay Server log as the detail is sent there and reported as an OEE1048 embedded in RSE4015 with details.

The crash has been fixed and the details in RSOE log have been restored. An example after the fix:

OEE1048: The communication between the Outbound Enabler and the backend server failed with [MLC24: Server certificate not trusted. The system-specific error code is 336134278 (hex 14090086).] while performing secured write. sidx=0 socket=01028188 sfp=58f2ed03

The RSOE may also have suffered false OEE1048(MLC8) SSL read errors when -cs https=1 was used. This has also been fixed.

Note that CREATE PROCEDURE/FUNCTION and ALTER PROCEDURE/FUNCTION statements were not affected.

A workaround for this problem is to start the MobiLink server with the hidden option,

-hwg-

POLYGON((-1 -1, -1 1, 0 0, 1 1, 1 -1, -1 -1))

would have resulted in an invalid polygon error. This has been fixed. There is no known workaround.

This problem could have also impacted the values returned by SQLError, SQLDataSources, and SQLGetDescRec if the driver manager called their "wide" equivalents. This problem is also corrected.

In addition, SQLGetDescRec could return a random field name for a descriptor when there was no field name (for example, a bookmark column has no field name). There was also the extremely rare possibility of a segment violation fault. These problems have been corrected.

[-10410] The client failed to send a complete sequence of commands

Ping request failed

Other than the error message, the ping operation would have behaved correctly. This has been fixed so that the warning is now prevented from being issued.

SAConnection local_conn = new SAConnection( SAServerSideConnection.Connection.ConnectionString );

Local_conn.Open()

then both the SQL Anywhere Server and the corresponding CLR External Environment would crash. This problem has now been fixed.

- Remote Data Access

- External Stored Procedures (note these are native dlls and shared objects that are loaded in process)

- External Environments (including JAVA, CLR, PERL, PHP, C_ODBC and C_ESQL external environments)

- LDAP UA

- Kerberos Authentication

Example:

SELECT 'string' AS "alias...name" FROM dummy

Similarily, if a SQL column expression contained more than 128 characters, a .NET client application could have crashed.

Example:

SELECT 1+2+3+...+1000 FROM dummy

These problems have been fixed. Alias and expression names are now restricted to at most 128 characters by the SQL Anywhere .NET data provider.

As a work-around for the first case, restrict the length of alias names to at most 128 characters.

Example:

SELECT 'string' AS expr FROM dummy

As a work-around for the second case, use an alias name and restrict the length of its name to at most 128 characters.

Example:

SELECT 1+2+3+...+1000 AS expr FROM dummy

Example:

SELECT SPACE(1147483643) FROM dummy

The possible buffer overrun has been corrected.

The database must be created or rebuilt to access the larger publication article size. Older databases will continue to work with a max publication article size of 256 bytes. Databases created or rebuild with this change will run on older runtimes provided publication articles are <= 256 bytes.

Details of the kernel bug can be found here:

http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/fs/nfs/direct.c?id=67fad106a219e083c91c79695bd1807dde1bf7b9

This has been fixed. Direct I/O will no longer be used for remote file systems on these Linux versions. Upgrading the Linux kernel to at least 3.8 is the only workaround.

- The Relay Server no longer creates new metrics until the rs_monitor.dll has been accessed. Most partners don抰 distribute rs_monitor.dll.

- If rs_monitor.dll has been accessed and the number of client types of a backend server has exceeded 1600, a new RSW107 warning is issued instead of the RSF13011 fatal error.

- In the RSW107 situation, the Relay Server will continue to relay the traffic, but no new metrics are created for the new client type.

Note, device I/O errors still require the database to be restarted. Corrupt databases can be detected with the Validate API or ulvalid utility.

EXEC SQL BEGIN DECLARE SECTION;

EXEC SQL END DECLARE SECTION;

would have resulted in the following error:

test.sqc(35): Error! E2636 near 'AREARE': Incorrect Embedded SQL syntax

This has been fixed. There is no known workaround for this.

The affected system procedures are:

- sa_server_option

- sa_db_option

- sp_create_secure_feature_key

- sp_alter_secure_feature_key

- sp_drop_secure_feature_key

Note, the original permission denied problem still exists if the database is initialized or upgraded with the legacy SQL SECURITY DEFINER model.

It should be noted that only one CLR External Environment can be launched per database. Hence applications need to decide prior to starting the CLR External Environment which version of .NET should be used. By default, the server will launch the CLR External Environment that will allow server side calls using either the .NET 2.0 or 3.5 Provider. If an application needs to make server side calls using .NET 4.0; then the following ALTER EXTERNAL ENVIRONMENT statement must be executed prior to starting the CLR External Environment:

ALTER EXTERNAL ENVIRONMENT CLR LOCATION 'dbextclr[VER_MAJOR]_v4.0 '

Similarly, if an application needs to make server side calls using .NET 4.5; then the following ALTER EXTERNAL ENVIRONMENT statement must be executed:

ALTER EXTERNAL ENVIRONMENT CLR LOCATION 'dbextclr[VER_MAJOR]_v4.5 '

If the application needs to go back to .NET 2.0 or 3.5; then the following ALTER EXTERNAL ENVIRONMENT statement must be executed:

ALTER EXTERNAL ENVIRONMENT CLR LOCATION 'dbextclr[VER_MAJOR] '

Note that in each of the above [VER_MAJOR] should NOT be replaced with one of 12 or 16. It is best to keep [VER_MAJOR] as is in order to ensure a smooth transition to a newer version of SQL Anywhere if needed.

Other side effects of this problem may also have been seen:

- If the sadiags.xml file was large then the merge-to-disk operation that automatically happens at midnight each day may have taken a long time and any other operation that caused a feature to be 慶ounted� would have blocked until the merge was complete. I.e. some operations at midnight may have been seen to 慼ang� or take longer than usual to complete.

- Mobilink servers could also suffer the slow shutdown (or midnight sync) problem if a database server was running on the same computer and that database server had generated a large sadiags.xml file.

This has been fixed. A work-around is to delete the sadiags.xml file prior to shutting down the server. This should only be expected to improve the shutdown time if the size of the file is large (e.g. over 100K bytes).

For example:

<?xml version="1.0" encoding="utf-8"?>

<configuration>

<configSections>

<section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />

</configSections>

<startup>

<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />

</startup>

<connectionStrings>

<add name="Entities" connectionString="metadata=res://*/Model1.csdl|res://*/Model1.ssdl|res://*/Model1.msl;provider=iAnywhere.Data.SQLAnywhere;provider connection string='datasourcename="SQL Anywhere 12 Demo"'" providerName="System.Data.EntityClient" />

</connectionStrings>

<system.data>

<DbProviderFactories>

<clear />

<add name="SQL Anywhere 12 Data Provider" invariant="iAnywhere.Data.SQLAnywhere" description=".Net Framework Data Provider for SQL Anywhere 12" type="iAnywhere.Data.SQLAnywhere.SAFactory, iAnywhere.Data.SQLAnywhere.EF6, Version=12.0.1.41474, Culture=neutral, PublicKeyToken=f222fc4333e0d400" />

</DbProviderFactories>

</system.data>

<entityFramework>

<providers>

<provider invariantName="iAnywhere.Data.SQLAnywhere" type="iAnywhere.Data.SQLAnywhere.SAProviderServices, iAnywhere.Data.SQLAnywhere.EF6, Version=12.0.1.41474, Culture=neutral, PublicKeyToken=f222fc4333e0d400" />

</providers>

</entityFramework>

</configuration>

create procedure sp_test( in @a integer, in @b integer )

begin

select @a + @b as c;

end

Binding two host variables and executing 揝ELECT * FROM sp_test(?, ?)" just after starting the database server, then the error "Not enough values for host variables" might have resulted. Subsequent execution attempts would have succeeded. A similar problem would have occurred when "SELECT * FROM sp_test(?, ?)" was executed immediately after (dropping and then) creating the stored procedure. This has now been fixed.

For UPDATE and DELETE statements the SQL reference correctly documents:

"You cannot use ordinal column numbers in the ORDER BY clause."

But for DELETE statements the syntax must be changed from

[ ORDER BY { expression | integer } [ ASC | DESC ], ... ]

to

[ ORDER BY expression [ ASC | DESC ] , ...]

This has been fixed

CREATE TABLE FarmEquipment.Products(...);

CREATE TABLE HighwayEquipment.Products(...);

the following statement would only have validated one of them at random:

SELECT * FROM sa_validate( 'Products' );

Even if the user execting the SELECT was the owner of a table called "Products", it may not have been the table that is validated. In other words, the statement above was not equivalent to:

VALIDATE TABLE Products;

The documentation states that all tables/materialized views matching the specified object name are validated. This problem has been fixed. The work-around is to specify the table/materialized view owner (the second argument).

Note, this change will apply to dbremote and dbmlsync logs as well.

The conditions for which this could happen must include:

(1) (subquery) was correlated with the main query block

(2) (subquery) has a very small size comparing to the table[s] referenced by the correlations

Note, this problem also affected Sybase Central and the Console utility, which are fixed as well.

The steps for generating Entity Framework 6 data models (Entity Framework 6 Tools for Visual Studio 2012 & 2013 should be installed):

- Run SetupVSPackage.exe with �/v 6� option to register the Entity Framework 6 Provider.

- Install Entity Framework NuGet Package for the Visual Studio project.

- Modify app.config file to add the Entity Framework 6 provider. Here抯 an example:

<providers>

<provider invariantName="iAnywhere.Data.SQLAnywhere" type="iAnywhere.Data.SQLAnywhere.SAProviderServices, iAnywhere.Data.SQLAnywhere.EF6, Version=16.0.0.20144, Culture=neutral, PublicKeyToken=f222fc4333e0d400" />

- Build the Visual Studio project.

- Run Entity Data Model Wizard.

<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">

<code>30000</code>

<message xml:lang="en-US">An unexpected error occurred in the producer. Contact the server administrator for more details.</message>

</error>

This has been fixed. Check constraints will now return either 30144, 30145 or 30146 errors, similar to unique constraint violations, depending on the type of request (INSERT, UPDATE or DELETE).

On Windows systems: Sybase Central could have become unresponsive for about a minute when viewing the generated documentation, and the directory was specified from the root of the drive but did not include the drive letter.

On non-Windows systems: Generating the documentation to a directory with a space in its name, and then attempting to open the documentation would have failed.

Note, affected procedures will need to be recreated with the fixed version of the server.

If a post login procedure did not return a result set, the Interactive SQL utility would have crashed.

Also, a race condition could have caused the window containing the post login messages to appear on-screen at the same time as the "Connecting to database" status window. When this occurred, neither window could have been closed.

Note, the problem does not happen in DDL and DML statements.

When executing a parallel query plan with a COUNT_BIG() over a table larger than representable in an INTEGER (approximately 2 billion rows), an error such as 揤alue SUM() out of range for destination� was returned. This is now corrected.

The SUM(x) aggregate function now returns BIGINT if x is of type BIGINT.

When using COUNT_BIG() in sliding window queries, the window was re-scanned for each row of the window instead of decrementing the count when rows were removed. This has been corrected.

The graphical plan for window operators now displays the PARTITION BY, ORDER BY, and window functions computed by the operator. It also shows whether rows are removed from the functions by inverting the aggregate (e.g., SUM, COUNT, COUNT_BIG) or by rescanning the window (e.g., MIN,MAX). Rescanning the buffer is slower and proportional to the square of the maximum buffer size.

The COUNT_BIG aggregate is now supported for incremental maintenance materialized views.

When printing COUNT_BIG with no argument, it is now printed as COUNT_BIG(*).

If COUNT_BIG() was used in a subquery that was flattened by semantic transformations, it was possible for the function to improperly return NULL instead of 0 (the classic count bug). This has now been corrected.

Also, the install package now includes a compiled library in the usual place. The script build.sh is no longer used to produce the library after installing.

For example:

--batch_5f3ccbef-11fe-4dcc-a546-02ba2e746d72

Content-Type: multipart/mixed; boundary=cs_025fc4e4-fd30-4372-8fa4-5b941ee66915

--cs_025fc4e4-fd30-4372-8fa4-5b941ee66915

Content-Type: application/http

Content-Transfer-Encoding: binary

HTTP/1.1 400 Bad Request

RepeatabilityResult: accepted

Content-Type: application/json;charset=utf-8

{

"error" : {

"code" : "30063", "message" : {

"lang" : "en-US", "value" : "An entity instance with this key already exists."

}

}

}

--cs_025fc4e4-fd30-4372-8fa4-5b941ee66915--

--batch_5f3ccbef-11fe-4dcc-a546-02ba2e746d72--

should be:

--batch_5f3ccbef-11fe-4dcc-a546-02ba2e746d72

Content-Type: application/http

Content-Transfer-Encoding: binary

HTTP/1.1 400 Bad Request

RepeatabilityResult: accepted

Content-Type: application/json;charset=utf-8

{

"error" : {

"code" : "30063", "message" : {

"lang" : "en-US", "value" : "An entity instance with this key already exists."

}

}

}

--batch_5f3ccbef-11fe-4dcc-a546-02ba2e746d72--

This has now been fixed.

- A valid connection string and a statement must have been specified on the command line,

- The database server had to be unreachable when dbisql started

- The database server must then have become available as dbisql completeed its startup sequence

This has been fixed. If the database server is unavailable when dbisql initially attempts to connect, it will now simply shut down, rather than attempting to execute the given statement.

Also, if the server was shut down while a backup was in progress, the backup could have reported a protocol error. This has been fixed so that a "Database server not found" error is now returned.

Option

[producer-name].ServiceOperationsColumnNames = { generate | database }

Description

Specifies whether the names of the columns in the metadata should be generated (rtn1, rtn2, �) or whether the names from the database should be used. The default setting is generate.

There are some issues with this implementation:

- The encrypted password could have been used to authenticate to the database by anyone from any computer who also had the corresponding user ID.

- The ODBC Configuration for SQL Anywhere dialog of the ODBC Data Source Administrator (Windows-only) could have been used to return the encrypted password in clear text.

- The encrypted password could have been decrypted with some effort.

Encrypted password support has been enhanced with the following goals in mind:

- Ability to restrict use to a particular computer or a particular computer/user.

- Inability to reverse-engineer an encrypted password using the ODBC Configuration for SQL Anywhere dialog.

- Better encryption algorithms to ensure that the encrypted password cannot be decrypted.

- These enhancements to be available across all supported client platforms.

A password can be encrypted on a computer such that it can only be decrypted on that computer. Anyone who can log on to the computer can use the encrypted password and corresponding user ID to authenticate to a database. It cannot be used on any other computer.

A password can be encrypted on a computer by a user such that it can only be decrypted on that computer for that user. It cannot be used on any other computer by the same or other user.

The Data Source utility (dbdsn) supports a new option -pet a|c|u, a specifying how the encrypted password may be used. If -pet a is specified, the password is encrypted for use on any computer. If -pet c is specified, the password is encrypted for use on this computer only. If -pet u is specified, the password is encrypted for use on this computer by this user only. The -pe option which provides simple obfuscation continues to be supported; however, its use is deprecated.

Note that encryption for options -pet c and -pet u must be performed on the computer or computer/user for which it is intended to be used (decrypted).

Note also that -pet u is not appropriate for client applications that are implemented as Windows services. Although -pet u can be used for a Windows System DSN, it may be more appropriate to use -pet c (since this form of encrypted password can be used by any user of the computer).

The ODBC Data Source Administrator dialog is changed as follows:

- The Encrypt password option is no longer a checkbox but is now used to select from different encryption options including none, for use on any computer, for use on this computer only, and for use on this computer and this user only.

- The dialog can no longer be used to change the level of password encryption for an existing password, unless it was previously unencrypted. If the level of encryption is to be changed, then the password must be reentered.

The ODBC Configuration for SQL Anywhere driver for Oracle dialog is also modified accordingly.

These features allow a database administrator to restrict database access to a user on a particular computer without revealing the actual plain text password to the user. It also prevents the current password from being decrypted to memory and consequently subject to inspection.

When successful decryption is restricted to a particular computer or computer/user, it no longer matters that the encrypted password is presented in plain text. For example, the encrypted password in the following connection string cannot be used by anyone other than the computer/user for whom it was created.

dbping -d -c "Host=server-pc; Server=DemoServer; UID=DBA; ENP=05a17731bca92f97002100c39d906b70f3272fe76ad19c0e8bd452ad4f9ea9"

The new encrypted password features are not supported by client libraries prior to this change.

The File Hiding utility (dbfhide) options -wm (computer-only) and -w (computer/user-only) are now supported on all platforms for which dbfhide is available. The dbfhide tool can be used to encrypt an entire connection string to a file for use by most of the database tools that accept connection strings (e.g., dbping -d -c @credentials.hidden).

Note that the encrypted password support described here is a client feature (storage of passwords on the client) and should not be confused with encryption of passwords over the wire during authentication, a default feature of SAP SQL Anywhere and optional in products like SAP Adaptive Server Enterprise (ASE).

Other backend farm and server configuration can co-exist with auto_config=yes in the configuration file. Backend farms with farm-wide tokens can also be specified in the new token property of the [backend_farm] section in the Relay Server configuration file, so as to reserve the farm name before the Relay Server starts up.

This feature is suitable for demos, integration testing, training and other administration free environments.

Configurations created by this auto config feature can be further updated in on-line manner by using local rshost or remote AdminChannel. The auto_config property can also be changed in on-line manner using those tools

"A resource manager with the same identifier is already registered with the specified transaction coordinator. (Exception from HRESULT: 0x8004D102)"

This problem has now been fixed so that instead of a constant GUID, a new one is generated each time enlistment occurs.

- If no connection parameters were given, but a statement was given.

- If a READ statement or the name of a SQL file was given on the command line, and the file exists, but the file could not be read for any reason.

- If an error was encountered while reading the results of a statement.

This has now been corrected.

"RSF11020: Missing required section �<section-name>� in configuration file �<config-file-name>�"

This has been fixed.

- To identify a sargable predicate that could use an index scan.

- To improve the estimation of selectivity in order to make a better choice of access plan

For some types of queries that involved an OR or an IN list predicate, the first goal was satisfied reasonably well but the OR / IN list could have been retained, affecting selectivity estimation. In some cases, this could lead to underestimating the number of rows returned from a table scan, potentially leading to execution plans with higher costs.

This has been improved so that when multiple search conditions on a column contain an OR and/or an IN-list predicate, the predicate is simplified further.

CREATE PROCEDURE upload_insert_proc (

IN p_pk INT,

IN p_geo BLOB,

IN p_srid INT )

LANGUAGE SQLSCRIPT AS

BEGIN

IF :p_geo IS NULL THEN

INSERT INTO test (pk, c1) VALUES( :p_pk, NULL );

ELSE

INSERT INTO test (pk, c1) VALUES( :p_pk, ST_GeomFromWKB(:p_geo, :p_srid) );

END IF;

END;

for the upload_insert event, and

CREATE PROCEDURE upload_update_proc (

IN p_pk INT,

IN p_geo BLOB,

IN p_srid INT )

LANGUAGE SQLSCRIPT AS

BEGIN

IF :p_geo IS NULL THEN

UPDATE test SET c1 = NULL WHERE pk = :p_pk;

ELSE

UPDATE test SET c1 = ST_GeomFromWKB(:p_geo, :p_srid) WHERE pk = :p_pk;

END IF;

END;

for the upload_update event.

rc = SQLGetDiagField( htype, hndl, rec, SQL_DIAG_ROW_NUMBER,

(SQLPOINTER)&diagRow, SQL_IS_POINTER, NULL );

Also, diagnostic records for each row in error may have been returned in the wrong order by SQLGetDiagRec, since the wrong row number(s) were recorded.

rc = SQLGetDiagRec( htype, hndl, rec, sqlstate, &native_error,

errmsg, sizeof( errmsg ), &errmsglen );

These problems have now been corrected in the SQL Anywhere ODBC driver.

The ODBC specification says:

When SQLExecute returns either SQL_ERROR or SQL_SUCCESS_WITH_INFO, an associated SQLSTATE value can be obtained by calling SQLGetDiagRec with a HandleType of SQL_HANDLE_STMT and a Handle of StatementHandle.

The SQL Anywhere ODBC driver violates this rule since it does not create any diagnostic records. WITH_INFO generally means that some things succeeded and some things failed and diagnostic records (the 搃nfo�) let you determine what failed. When there was only one parameter set, a parameterized update or delete statement may have returned SQL_NO_DATA. If there was more than one parameter set, and some sets affected no records, then the SQL Anywhere ODBC driver returned SQL_SUCCESS_WITH_INFO (but did not create any diagnostic records). This was incorrect behavior. The driver should have returned SQL_SUCCESS.

Also, when all parameter sets fail to update or delete any rows, the ODBC driver should still have returned SQL_SUCCESS. The SQL Anywhere ODBC driver woud have set all non-updating parameter status array elements to SQL_PARAM_SUCCESS_WITH_INFO (except that the driver incorrectly cascaded the WITH_INFO status into all subsequent array elements). The ODBC driver did create diagnostic records for the WITH_INFO parameters. This was also incorrect behavior.

These problems have been corrected. The SQL Anywhere ODBC driver now follows the ODBC specification in this regard.

A workaround is to ensure that all rows touched by an ALTER have been fully updated inline. This can be done by issuing a pair of statements like the following:

alter table T add delete_me integer default autoincrement;

alter table T delete delete_me;

Snapshot queries over table T will now work correctly after these statements are executed.

For example, the query:

select geom from st_geometry_dump( new ST_LineString(new ST_Point(1,1,4326), new ST_Point(2,2,4326)))

incorrectly returned the rows:

LineString (1 1, 2 2)

Point (180 -.000000000000006)

Point (180 -33.690067525979835)

This has been fixed.

For example, the following query executed in 25.6s with the incorrect estimate 0.52% on L.row_num >= 0 (actual is 100%):

select *

from sa_rowgenerator(1,1.1727e6) L join sa_rowgenerator(1,34680) R on L.row_num = R.row_num

where (L.row_num >= 0, 0.52 )

options(User_estimates='On')

This has been improved so that performance is better even in the presence of underestimates:

Before change: 25.6

After change: 5.3

The graphical plan for hash-based query operators now includes lines to indicate how many key values the optimizer estimates will be found and the number of hash buckets selected for execution:

Key Values 6098.04

Hash table buckets 1031

Note, this issue also affects creating INSTEAD OF triggers with encrypted definitions on views as well.

Note, if a procedure returns a ROW or ARRAY typed column in its result set, the procedure needs to have a RESULT column. Changing the procedure to use Watcom SQL syntax may be required. Calling a procedure that returns a ROW or ARRAY typed column in its result set without a RESULT clause may now result in the error, "Procedure '<name>' needs a RESULT clause for returned ROW or ARRAY."

Note, the problem can avoided by disabling parallel query execution (i.e. set option PUBLIC.max_query_tasks=1), and can be made less likely by increasing the amount of memory available to the server.

If dbisql runs out of memory when copying results, there are a couple of things that can be done:

1. When running the 32-bit version of dbisql, run the 64-bit version instead. It allows for a larger heap, and is less likely to run out of memory.

2. Export the data using an OUTPUT statement, or the "Export Wizard", rather than copying results to the clipboard.

Note, this only affected results from some service operations when the output format was XML.

... dbcloudagent_poller_http_error message=[Error making HTTPS connection] code=4 reason=[Cannot resolve hostname or bad IP address]

This was a non-fatal error since the agent could continue working by polling the primary instead. This problem has been fixed.

1. Server crash

2. Server assertion failure

3. Incorrect error message (for example, -946 "Result set not permitted in '%1'")

This has been fixed.

CREATE SYNCHRONIZATION PROFILE "sp" ''

The query used to obtain the profile string for a specified Synchronization Profile returned null. This would have resulted in the profile being skipped during the unload. This has been fixed.

Example:

CREATE FUNCTION func1( @a integer)

RETURNS INTEGER

BEGIN

DECLARE @ret INTEGER;

SET @ret = ( a + 10 ) / 100;

RETURN @ret;

END;

SELECT a, func1( b + c ) as ret

FROM tab;

Expected error is 慍olumn 揳� not found�.

All conditions must have been met (non-transactional, shared global temp table,

and LOCK TABLE WITH EXCLUSIVE) for the crash to have occurred. If any of these three can be relaxed, the crash will be avoided.

setZlibCompression( boolean )

setZlibDownloadWindowSize( int )

setZlibUploadWindowSize( int )

zlibCompressionEnabled()

With version 11.x, the server was not able to create a cache larger than 32MB. Attempting to do so would have caused the error "Not enough memory".

With version 12.x, the server would have automatically and erroneously restricted the cache size to a size smaller than 32MB.

The default maximum cache size was erroneously restricted to a value less than 32MB.

The "percentage" notation for cache sizes (eg, "-c 50p") erroneously based the percentage on a value that was less than 32MB, rather than the total system memory as documented.

These problems have been corrected.

When using the "SET MIRROR OPTION synchronization_mode = '<value>'" statement, where <value> was asynchronous or asyncfullpage, the server was incorrectly treating this as a synchronous synchronization. This has been fixed as well.

- precision and scale for NUMERIC values

- length for string values

- differences between string types (e.g., char/varchar/long varchar or binary/varbinary/long binary)

For example, the following statement would have incorrectly returned:

a a_string

1.0000 "1.0000"

select case when dummy_col=0 then 1 else cast(2 as numeric(10,4) ) end case a

, cast( a as varchar ) a_string

from sys.dummy

However, the following statement would have incorrectly returned:

a a_string

1 "1"

select case when 0=0 then 1 else cast(2 as numeric(10,4) ) end case a

, cast( a as varchar ) a_string

from sys.dummy

The incorrect behaviour affected expressions that were partly or fully evaluated at query open time or in procedural code, and affected IF, CASE, NULLIF, ARGN, COALESCE and some other related expression types. This problem has now been fixed.

For HTTP methods other than POST, the body may be retrieved using HTTP_VARIABLE('TEXT') or HTTP_VARIABLE('BODY') as dictated by the Content-Type. An HTTP POST method is assumed to have a Content-Type of application/x-www-form-urlencoded unless otherwise specified (as with any other HTTP method, alternate Content-Types may be accessed using HTTP_VARIABLE('TEXT') or HTTP_VARIABLE('BODY')).

Example: "READ file1.sql >& output.txt"

file1.sql:

read file2.sql

go

SELECT ...

file2.sql:

SELECT ...

The following describe the steps required to correct this whenever an unload of a database is performed:

1. log in to SQL Anywhere Monitor Web UI as the user 'administrator'.

2. click Administrator on the left pane to open an Administrator dialog

3. under Resource tab, select the resource that had been dbunloaded

4. click Stop button to stop monitoring the resource

5. click Repair... and enter DBA uid/pwd to repair the resource database

6. after done, click Start to start monitoring the DB

After the above steps, the resource should function correctly.

BY clauses were being changed in a table with an article. This has been fixed. This fix covers additional cases that were not covered by Engineering case 654952.

There are a few points of note:

1) this problem would only have occurred with stored procedures that were created using an older SA 12.0.1 server

2) this fix will only affect new procedures that are created

3) the existence of the "dynamic result sets" clause for non-external environment procedures is in fact a no-op and does not affect performance or behaviour of the non-external environment procedure.

java.io.InputStream getBlobInputStream( String name )

boolean getBoolean( String name )

byte[] getBytes( String name )

java.io.Reader getClobReader( String name )

java.util.Date getDate( String name )

DecimalNumber getDecimalNumber( String name )

double getDouble( String name )

float getFloat( String name )

long getLong( String name )

int getSize( String name )

String getString( String name )

UUIDValue getUUIDValue( String name )

boolean isNull( String name )

For example:

SetupVSPackage.exe /ua

1) The dbn= value can be "*", which means any database can use this server as an arbiter.

2) The auth= value can be:

a) omitted, which means no validation of the authentication string provided by a mirror server is done.

b) a single value, which means all databases must use the same authentication string.

c) a list of values with the same number of entries as specified by dbn= (i.e. previous behavior)

For example:

Entities db = new Entities();

var query = db.SalesOrders.Select( x => x ).Where( x => EntityFunctions.DiffDays( x.OrderDate, DateTime.Now ) > 100 );

string trace = ( ( ObjectQuery ) query ).ToTraceString();

This problem has been fixed.

String getAliasName( int column_no )

String getDomainName( int column_no )

String getCorrelationName( int column_no )

String getQualifiedName( int column_no )

String getTableColumnName( int column_no )

String getTableName( int column_no )

String getWrittenName( int column_no )

Previously, they returned the value "N.Y.I.". They now return values that closely approximate those returned by the UltraLiteJ runtime for Blackberry.

Also, a new command line option 'salocation' (or 'sal') has been added to SetupVSPackage to allow specifying the SQL Anywhere install location. If 'salocation' is specified, SetupVSPackage will use it to locate the necessary dlls. If 'salocation' is not specified, SetupVSPackage will use SQL Anywhere registry keys to locate the dlls.

Note, this problem occurred only on Linux systems.

Also, if a mirror server was in the middle of taking over as the primary when it was shutdown, the database shutdown could have hung until any remaining connections were disconnected. This has been fixed.

For example:

SATcpOptionsBuilder options = new SATcpOptionsBuilder( "localonly=yes;port=6873" );

string cport = options.ClientPort;

This problem has been fixed.

Note, this problem affected the .Net provider, the ODBC, JDBC and OLEDB drivers as well.

an assertion while updating values indexed by an immediate text index. This problem required high contention on the base table. This has been fixed.

� url : Specify the server name or IP address and optionally the port number of the HTTP server being used, separated by a semi-colon. If requests are being passed through the Relay Server, you can optionally add an URL suffix to indicate which server farm the request should be passed to. url=抯erver-name[:port-number][url_suffix]�

� https : Specify whether to use HTTPS (https=YES) or HTTP (https=NO).

� certificate : To make a secure (HTTPS) request, a client must have access to the certificate used by the HTTPS server. The necessary information is specified in a string of semicolon-separated key/value pairs. You can use the file key to specify the file name of the certificate, or you can use the certificate key to specify the server certificate in a string. You cannot specify a file and certificate key together. The following keys are available:

file : The file name of the certificate.

certificate : The certificate itself.

company : The company specified in the certificate.

unit : The company unit specified in the certificate.

name : The common name specified in the certificate.

Certificates are required only for requests that are either directed to an HTTPS server, or can be redirected from a non-secure to a secure server. Only PEM formatted certificates are supported.

certificate=択ey=value[:key=value]'

� user : The HTTP server user ID. Authenticates to third-party HTTP server and gateways using RFC 267 Basic Authentication. user=抲serid�

� password : The HTTP server password. Authenticates to third-party HTTP server and gateways using RFC 267 Basic Authentication. password=抪assword�

� debug : When set to YES, all HTTP commands and response are displayed in the output log. This information can be used for troubleshooting HTTP support problems. The default is NO.

� proxy : Specifies the URI of a proxy server. For use when SQL Remote must access the network through a proxy server. Indicates that SQL Remote is to connect to the proxy server and send the request to the message server through it. proxy=抙ttp://proxy-server[:port-number]�

� client_port : Identifies the port number on which SQL Remote communicates using HTTP. It is provided for and recommended only for connections through firewalls that filter "outgoing" TCP/IP connections. You can specify a single port number, ranges of port numbers, or a combination of both. Specifying a low number of client ports could result in SQL Remote being unable to send and receive messages if the operating system has not released the ports in a timely manner after SQL Remote closes the port on a previous run. client_port=抧nnn[-mmmm]�

Unlike the FTP or SMTP message type, which relies on a third-party FTP or E-mail server, the HTTP message type makes use of the web services functionality that exists in the SQL Anywhere database engine to act as

the HTTP server, which we refer to as a "message server". In order to setup the message server, you only need to run the sr_add_message_server on the consolidated database, and ensure that the database server has

been started with the -xs http[s] switch. If starting the HTTP[S] listener on a database server hosting the consolidated database is a performance or security concern, then you can use a separate database server, as long as the database you run sr_add_message_server on has identical SQL Remote definitions to your consolidated database. For more information on how to setup a consolidated database to be a message server, how to setup a separate message server, or how to use the Relay Server to forward HTTP requests from remote database to the message server, please read the tutorials and full documentation.

The SQL Remote documentation has been updated to include information about the new message type. In the SQL Anywhere installation directory, see:

documentation/en/pdf/sqlremote1201.pdf

This has been fixed so that these files are now correctly uninstalled.

Note that prior to this fix, UltraLiteJ for Android would have done the equivalent of DatabaseManager.release() when the UltraLiteJ application terminated. Now it is possible for the application to execute DatabaseManager.release() at a specific point in time.

"The library /opt/sqlanywhere11/lib32/libulhltool11_r.so could not be loaded. This may be because the provider is being re-loaded (in which case you need to restart the viewer) or because the library could not be found in the SQL Anywhere installation. Service management will not be available."

This has been corrected.

- the application was connected to a primary server that lost quorum (the server lost the connection to both the mirror and arbiter servers)

- the application stayed connected to this server (the old primary server) even though the network connection to other servers dropped

- the application was in the middle of committing a transaction between the time that the old primary server lost its connection to the mirror and arbiter server, and when the old primary server restarted as the new mirror server because it lost quorum

- the old mirror server took over as the new primary (the mirror server must have been able to connect to the arbiter server for this to occur)

This has been fixed so that the application may now receive the new error for this situation, "The transaction may not be committed because the primary server lost quorum."

Note that 12.0.1 EBFs can be now applied directly to 12.0.0 installations - effectively performing an upgrade. Therefore if a 12.0.0 installation has not yet been upgraded to 12.0.1, use of a 12.0.1 EBF with this fix will avoid this problem. If a 12.0.0 installation had been upgraded with a build without this fix, uninstalling the product will not remove all the sample files. Those files will need to be removed manually.

It should be noted that on 64-bit Windows, only the 64-bit SYSTEM DSNs are listed (after this correction). Any 32-bit SYSTEM DSNs are not displayed. In Visual Studio 2008's design environment (which is 32-bit on 64-bit platforms), the Test Connection button will attempt to establish a connection using the 32-bit equivalent of the 64-bit DSN. If the 32-bit DSN does not exist, the test will fail.

find: stat() error /opt/sybase/sqlanywhere12/sun/jre160/lib: no such file or directory

This has been fixed. It should be noted that despite the error, the uninstaller would have completed successfully.

Workaround:

1. Shut down any graphical administration tools (Sybase Central, Interactive SQL (dbisql), the MobiLink Monitor, SQL Anywhere Monitor, or SQL Anywhere Console utility (dbconsole) that are running.

2. Run the following commands:

mkdir $SQLANY12/sun/jre160_x86/lib/fonts/fallback

ln -s /usr/share/fonts/truetype/arphic/*.ttc $SQLANY12/sun/jre160_x86/lib/fonts/fallback

ln -s /usr/share/fonts/truetype/wqy/*.ttc $SQLANY12/sun/jre160_x86/lib/fonts/fallback

For example, on Fedora, run the following command:

yum install redhat-lsb redhat-lsb.i686

- the local server was running on a Windows based system

- the local server had a restricted (or small) number of CPUs or cores (either due to the limitations of the server machine or VM, or as a result of using the -gt or -gtc command line option)

- the remote server was not defined to utilize the new "driver=SQL Anywhere Native" feature

This problem has now been fixed.

svc_t_dbmlsync: No such file or directory

This was due to the file svc_t_dbmlsync not having been installed in the bin32/dbsvc_scripts directory. This has been corrected.

Also in rare timing dependent cases, partner servers starting for the first time could have fail to have chosen a primary after the changes for Engineering case 663964.

These problems have been fixed.

1) if no transaction-logs-directory was given on its command line; and

2) if the length of the transaction log name including its absolute path was greater than 128 bytes.

This problem is now fixed and the length of the transaction log name plus its absolute path has been extended to 1024 bytes.

A write failed with error code: (6), The handle is invalid.

Fatal error: disk full when writing to "???"

This has been fixed.

- the probe input of the hash join had already consumed a lot of memory for hash tables

- a child of the hash join returned an error

- a hash based parent query node of the hash join needed to allocate memory for the hash table and is restricted by the memory governor, so that it had to acquire memory from other hash based query nodes.

This problem has been fixed.

select isdate('1234+')

While the following query failed with a runtime error indicating the date string was not acceptable:

select date('1234+')

This problem has been fixed. The "isdate" query now returns 0. At a minimum, the timezone indicator (+) must be followed by hours. For example, '2011+5' is acceptable.

Also, if a date string contained a timezone offset of "+" or "-" and was followed by the Z (Zulu) timezone indicator (e.g., '1234-12-31+Z'), no error was diagnosed. This has been corrected.

Note, this change also affect the other SQL Anywhere client libraries as well, i.e. DBLib, OLEDB, ADO.NET, etc.

AddDays, AddHours, AddMicroseconds, AddMilliseconds, AddMinutes, AddMonths, AddSeconds, AddYears, DiffHours, DiffMicroseconds, DiffMilliseconds, DiffMinutes, DiffMonths, DiffSeconds, DiffYears.

For example:

Entities db = new Entities();

var query = db.SalesOrders.Select( x => x ).Where( x => EntityFunctions.DiffDays( x.OrderDate, DateTime.Now ) > 100 );

string trace = ( ( ObjectQuery ) query ).ToTraceString();

This problem has been corrected by adding new function handlers for mapping Entity Framework datetime functions to the SQL Anywhere functions 'DATEADD' and 'DATEDIFF'.

1) The UPDATE statement modifies a table that had a primary key, UNIQUE constraint, or unique index.

2) The UPDATE statement modified a column included in the primary key, UNIQUE constraint, or unique index, such that the new value matched a value already existing in the index.

3) The modified table had an AFTER ROW or AFTER STATEMENT trigger

This problem has been corrected.

- all group by expressions in the subquery were constants

- the subquery had a COUNT aggregate

- the subquery did not affect any table rows

- the outer join condition referenced a constant grouping column of the subquery

For example: If table T1 has no row with a1 < 44 then the query does not return rows in any circumstances.

select *

from T2 left outer join

( select 111 c1, count(*) c2 from T1 where a1 < 44 ) V on T2.a2 = V.c1

This has been fixed.

Note that this fix only applies to ODBC based Remote Data Access servers. The fractional seconds precision will still be truncated to 3 digits of precision for JDBC based Remote Data Access servers.

DBLogFileInfo function

Obtains the log file and mirror log file information of a non-running database.

Prototype

short DBLogFileInfo ( const a_log_file_info * );

Parameters

A pointer to a structure. See a_log_file_info structure

.

Return value

A return code, as listed in Software component exit codes

.

Remarks

The DBLogFileInfo function returns the log file and mirror log file paths of a non-running database file. Note that this entry point will only work for databases that have been created with SQL Anywhere 10.0.0 and up.

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

Here is the necessary information for the new a_log_file_info structure:

typedef struct a_log_file_info {

unsigned short version; // set this to DB_TOOLS_VERSION_NUMBER

MSG_CALLBACK errorrtn;

const char * dbname; // database file name spec

const char * encryption_key; // database file encryption key

char * logname; // buffer for returning log file name

size_t logname_size; // size of the logname buffer

char * mirrorname; // buffer for returning mirror log file name

size_t mirrorname_size; // size of the mirrorname buffer

void * reserved; // reserved for internal use, must set to NULL

} a_log_file_info;

Remote would have generated the warning message:

Deleting duplicate message from ...

and then deleted the duplicate pinging messages.

This problem is fixed so that all the duplicate pinging messages are now processed without complaint.

external name 'MyTest.DLL::MyNameSpace.MyTestClass.MyMethod() int'

would have failed to execute MyNameSpace.MyTestClass.MyMethod, but an external name clause like:

external name 'MyTest.dll::MyNameSpace.MyTestClass.MyMethod() int'

would successfully find and execute MyMethod. This problem has been fixed.

Note that a workaround is to simply lower case the ".dll" portion of the assembly name.

Note, the newdemo.bat file is referenced by the SQL Anywhere documentation whenever it is desirable to start with a newly initialised version of the demonstration database.

CASE expression-1 WHEN expression-2 THEN expression-3, ... [ ELSE expression-4 ] { END | END CASE }.

It was not possible to use a subquery as expression-1. This has now been fixed.

Also, the message "Number of tables that will always be uploaded:" was incorrect and misleading and the number displayed was invalid. This message has been changed to "Number of tables that are in publications:" and the output has been corrected.

For example:

Select *

from T1, T2

where 10 = (select e1 from R where p(R,T1, T2) ) and ..

This has now been fixed.

MIRROR - When the NodeType connection parameter is set to MIRROR, and you have connected to a copy node or the primary server, the connection is redirected to the mirror server.

READONLY - When the NodeType connection parameter is set to READONLY, and you have connected to a copy node or the primary server, the connection is redirected to the copy node in its branch with the lowest load. If there are no copy nodes, the connection is redirected to the mirror server. If you have connected to the mirror node the connection is accepted since the mirror server does not know the status of the copy nodes. READONLY is used to connect to any read-only server, either a copy node or the mirror.

2) If a High Availability or read-only scale-out server failed to connect to another server, there may not have been any indication of the failed connect. This has been fixed by logging a message to the console for each failed connection.

3) A High Availability or read-only scale-out server may have displayed the message "... recovery n% complete" where n was a number less than zero or much greater than 100. This has been fixed.

Also, the method DatabaseManager.connect() now returns SQLE_INVALID_PARAMETER if passed a NULL configuration.

There are two possible workarounds:

1) Turn off intra-query parallelism by setting the Max_query_tasks option to 1, or

2) Set the Log_deadlocks option to 'off'

This problem has been fixed.

Module C:\Program Files\SQL Anywhere 12\BIN64\ulodbc12.dll failed to register. HRESULT -2147024703. Contact your support personnel.

This has been fixed.

[-10002] Consolidated database server or ODBC error: ODBC: [Microsoft][SQL Server Native Client 10.0][SQL Server]

Cannot drop the table '#elbat_yraropmet_ymmud_a_si_siht', because it does not exist or you do not have permission.

(ODBC State = 42S02, Native error code = 3701)

This error would have occurred in one of the following situations:

1) a deadlock was detected during upload;

2) an error occurred in a trigger that was defined on an upload table; or

3) the 'XAXT_ABORT' option was set to 'ON' in one of the user-defined scripts.

This problem is fixed now.

Note that restarting the database server eliminates the problem

Note, this change also affects the ADO .NET provider, the OLE DB provider, MobiLink server, Relay Server Outbound Enabler, database server, all SA software requiring TCPIP running on Windows.

For example, if x is of type signed integer and there are rows in T where x is NULL, and there is an index on x with max hash size 4, then the following statement would have returned a result set that included rows where X is NULL:

SELECT * FROM T WHERE x >= -2147483648

This has now been fixed.

"Recursive column %1: conversion from '%2' to '%3' loses precision ".

2) If an ALTER MIRROR SERVER statement was executed to adjust a copy node's connection string, that copy node may have temporarily failed to connect properly to other servers. This has also been fixed.

The crash can be worked around by disabling intra-query parallelism by setting the database option MAX_QUERY_TASKS=1.

As part of this change, the message that is displayed when the Java Virtual Machine can't start has been improved to include the actual JVM error.

Also, when attempting to update a blob column that was NULL using a ULTable object, the column value would have remained NULL. This has also been fixed.

For example, if "Test Connection" was used when configuring a Datasource Name (DSN), using the ODBC Datasource Administrator on a system with Microsoft Firewall Client installed then a 20-second delay occurs after the OK button is clicked.

A work-around has been developed for this problem. If the Firewall Client DLL is present when the SQL Anywhere ODBC driver is unloaded, the Windows Socket libraries are not unloaded by the driver. This avoids the 20-second delay. In this case, the Windows Socket libraries are unloaded when the client application terminates.

these options during startup recovery, or when applying changes on a mirror server. This has been fixed.

Other changes have been made as well to reuse Java objects and reduce the creation of temporary objects during the download.

These changes were made to improve memory useage during synchronization.

A workaround to this issue would be to add any synchronization user or synchronization subscriptions to the database. For example, if a publication "p1" was defined for download only, execute "CREATE SYNCHRONIZATION SUBSCRIPTION TO p1 TYPE 'tcpip'". This would define TCP/IP as the default communication type when synchronizing the publication, which is the default that would be chosen anyway.

1. The UPDATE statement is using the syntax:

UPDATE [ row-limitation ] table-expression [, ...] ]

SET set-item[, ...]

[ WHERE search-condition ]

[ ORDER BY expression [ ASC | DESC ] , ...]

[ OPTION( query-hint, ... ) ]

2. The statement must have had at least two query blocks (e.g., a derived table, subselect, subqueries).

3. The 'table expression' contained a Left Outer Join at the root of the tree

4. The Left Outer Join was a redundant join. Removing the Left Outer Join from the original statement generates an equivalent statement.

This has been fixed.

For example:

update LP join PR on PR.PR1 = LP.LP1

join LS on LS.LS2 = PR.PR2

join SC on SC.SC1 = LS.LS2

left outer join PC on PC.PC1 = LS.LS1

set LP.LP2 = LS.LS1

where

PR.PR3 = 10 and

LS.LS3 = 20 and

SC.SC2 = 30

and SC.SC2 = (select max(id) from product )

[Sybase][ODBC Driver][Adaptive Server Anywhere]Server '<server-name>': [Microsoft][ODBC Driver Manager] Driver does not support this function (-660)

A call was being made to SQLPrimaryKeys() to determine which columns in the table belong to the primary key. Access does not support this function, so this error is now ignored for the 'MSACCESSODBC' server class.

Links:

http://www.kb.cert.org/vuls/id/680620

http://www.kb.cert.org/vuls/id/238678

CREATE MIRROR SERVER "scaleout_child" AS COPY connection_string = 'server=scaleout_child;host=winxp-2:6878';

CREATE MIRROR SERVER "TheArbiter" AS ARBITER connection_string = 'server=scaleout_child;host=winxp-2:6878';

Note that there is no database server in the HA system that is running with the server name "TheArbiter": it is just being used as a placeholder in the mirror server definitions to hold the connection string for the arbiter.

2. Copy nodes could have reported a log mismatch error in certain cases involving a failure of both the primary server and the arbiter. This problem has been fixed.

3. There was a race condition that could have allowed an arbiter server to create two separate internal states for the same mirroring system. This problem has been fixed.

For the error to occur in version 11, the first cursor would need to be explicitly declared FOR READ ONLY, because FOR UPDATE is the default (c.f. documentation for DECLARE CURSOR statement). In version 12.0.0 and later, cursor updatability depends upon cursor type (c.f. documentation for SELECT and PREPARE statements) but defaults to FOR READ ONLY for ESQL.

Note: existing corrupted blob indexes must be dropped and recreated after the fix is applied. This can be done using:

alter table <table> alter <column> no index

alter table <table> alter <column> index

Note, this problem also affected SQL Anywhere clients running on the Mac.

A write failed with error code: (6), The handle is invalid.

Fatal error: disk full when writing to "???"

This has been fixed.

For example, if a table was defined as:

CREATE TABLE t(

c1 INT PRIMARY KEY,

c2 LONG VARCHAR,

c3 LONG VARCHAR )

and the row[ 1, null, 'b' ] was downloaded, reading c3 would have failed. Rows [2, 'a', 'b'], [3, 'a', null ] and [4, null, null ] would have been okay.

This has been fixed.

As a work around, the "Create sequences" section could be manually moved to before the "Create tables" section in the reload.sql file.

Also, the ULSyncProgressData.FLAG_IS_BLOCKING flag could have been set erroneously when the state was ULSyncProgressData.STATE_CANCELLED. This too has been fixed.

A simple example of a query that demonstrates this error is:

select ST_Geometry::ST_GeomFromText( 'MultiPolygon( ( ( -10 -10, -11 -10, -11 -11, -10 -11, -10 -10 ) ), ( ( 2 2, 2.5 1, 1 1, 1 2, 0 2, 0 0, 3 0, 3 2, 2 2 ) ) )' ).ST_Union( ST_Geometry::ST_GeomFromText( 'Polygon( ( 1 1, 2.5 1, 2 2, 1 2, 1 1 ) )' ) )

The only work around is to break up the MultiPolygon and perform the unions in a different order.

This has been fixed.

"The address given is invalid. The address must be a directory name with no path separators."

and then aborted the message receiving thread when it was able to retrieve all the names of the message files in the given directory from a FTP server, but for some reasons (such as network problems) was not able to retrieve the contents of a file from the server. This problem is fixed so that the error message is now:

"Unable to retrieve message file 'xxxx' from the FTP server."

Another way to avoid the problem is to create and destroy the ODBC Environment only once in an application and connect/disconnect as often as desired.

SQLAllocHandle( SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv );

SQLSetEnvAttr( henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER)SQL_OV_ODBC3, 0 );

loop

connect/disconnect many times

endloop

SQLFreeHandle( SQL_HANDLE_ENV, henv );

Note, Microsoft has published http://support.microsoft.com/kb/2624911, which describes the problem with Windows Vista and Windows 7.

Note that a database upgrade is needed in order to get this fix.

A workaround is to ensure that the SELECT statement inside the inner procedure is not subject to simple query caching. If this slowdown is observed, the workaround can be implemented by adding a predicate that is not a tautology, but which is always known to be true for the data, to the inner select. For example, if a certain column is always greater than zero, adding the predicate col >= 0 is sufficient to avoid the problem. Note that simple predicates such as 1=1 will be detected as data-independent tautologies and removed.

Note that this problem would not be seen on Mac OS X systems.

The workaround is to manually drop the sequence before issuing the CREATE statement.

For example:

CREATE TABLE IF NOT EXISTS t ( c INT PRIMARY KEY )

This has been fixed. Now, statements are selected properly.

This same problem also affected the behavior of the "Single Step" menu item which also relies on being able to select the next statement.

Note, row limiting is required to make use of this improvement.

- the columns in a table created by the SELECT ... INTO [ LOCAL TEMPORARY TABLE ] table-name

- the columns in a view

- sa_describe_query and sa_describe_cursor domain_name_with_size and widths

- the EXPRTYPE returned data type length

These operations have been fixed to return the correct lengths.

After changing the synchronization_mode while the mirror server was connected, the mirror could have failed to take over as primary (including if the synchronization_mode was changed from 'async' or 'asyncfullpage' to 'synchronous'). This has been fixed. A side effect of this fix is the database on the mirror server automatically stops and restarts if the synchronization_mode is changed between an asynchronous mode and 'synchronous'.

If the mirror database stopped and immediately restarted, in rare timing dependent cases, it was possible that the mirror would fail to take over as the primary if the primary failed. This has been fixed.

This has been fixed so that servers that have less than about 20 committed transactions per second will no longer hang. There may also be slightly improved performance when using copy nodes.

For example:

$sth = $dbh->prepare("BEGIN SELECT * FROM Departments ORDER BY DepartmentID;SELECT TOP 10 * FROM SalesOrders ORDER BY ID;END");

$sth->execute();

do {

while (my $data = $sth->fetch) {

print "@$data\n";

}

print "---end of data---\n";

} while (defined $sth->more_results());

In a mirroring system, if an event was in use on a mirror or copynode, and DDL to alter or drop the event was applied on the primary server, the mirror or copynode using the event may have given an assertion and shut down. This has been fixed. Now, if the event is running on the mirror or copynode, the connection the event is running on will be dropped, causing the event to be cancelled, and the following message will be printed to the server console: "Dropping connections that are preventing the transaction log from being applied."

This problem could have made it appear as if the order of commands changed when a remote task was deployed, if the remote task was deployed shortly after adding a command. In fact, the ordering of the commands was incorrect immediately after the command was added. If Sybase Central was started and the task was viewed without deploying it, the added command would have been at the end of the command list.

For example:

create or replace PROCEDURE test1( )

BEGIN

ALTER TABLE ixddl6 ADD CONSTRAINT FK_primary

FOREIGN KEY (x)

REFERENCES ixddl5(pk)

match unique simple on delete set null

END

"database is not compatible with primary; files must be replaced" and

"Database server shutdown due to incompatible files for database mirroring."

This has been fixed.

Code First enables a different development workflow: defining data model objects by simply writing C# or VB.NET classes mapping to database objects without ever having to open a designer or define an XML mapping file. Optionally, additional configuration can be performed by using data annotations or the Fluent API. Model can be used to generate a database schema or map to an existing database.

Here's an example which creates new database objects using the model:

using System;

using System.Collections.Generic;

using System.ComponentModel.DataAnnotations;

using System.Data.Entity;

using System.Data.Entity.Infrastructure;

using System.Linq;

using iAnywhere.Data.SQLAnywhere;

namespace CodeFirstExample

{

[Table( "EdmCategories", Schema = "DBA" )]

public class Category

{

public string CategoryId { get; set; }

[MaxLength( 64 )]

public string Name { get; set; }

public virtual ICollection<Product> Products { get; set; }

}

[Table( "EdmProducts", Schema = "DBA" )]

public class Product

{

public int ProductId { get; set; }

[MaxLength( 64 )]

public string Name { get; set; }

public string CategoryId { get; set; }

public virtual Category Category { get; set; }

}

[Table( "EdmSuppliers", Schema = "DBA" )]

public class Supplier

{

[Key]

public string SupplierCode { get; set; }

[MaxLength( 64 )]

public string Name { get; set; }

}

public class Context : DbContext

{

public Context() : base() { }

public Context( string connStr ) : base( connStr ) { }

public DbSet<Category> Categories { get; set; }

public DbSet<Product> Products { get; set; }

public DbSet<Supplier> Suppliers { get; set; }

protected override void OnModelCreating( DbModelBuilder modelBuilder )

{

modelBuilder.Entity<Supplier>().Property( s => s.Name ).IsRequired();

}

}

class Program

{

static void Main( string[] args )

{

Database.DefaultConnectionFactory = new SAConnectionFactory();

Database.SetInitializer<Context>( new DropCreateDatabaseAlways<Context>() );

using ( var db = new Context( "DSN=SQL Anywhere 12 Demo" ) )

{

var query = db.Products.ToList();

}

}

}

}

Here's another example which maps to an existing database:

using System;

using System.Collections.Generic;

using System.ComponentModel.DataAnnotations;

using System.Data.Entity;

using System.Data.Entity.Infrastructure;

using System.Linq;

using iAnywhere.Data.SQLAnywhere;

namespace CodeFirstExample

{

[Table( "Customers", Schema = "GROUPO" )]

public class Customer

{

[Key()]

public int ID { get; set; }

public string SurName { get; set; }

public string GivenName { get; set; }

public string Street { get; set; }

public string City { get; set; }

public string State { get; set; }

public string Country { get; set; }

public string PostalCode { get; set; }

public string Phone { get; set; }

public string CompanyName { get; set; }

public virtual ICollection<Contact> Contacts { get; set; }

}

[Table( "Contacts", Schema = "GROUPO" )]

public class Contact

{

[Key()]

public int ID { get; set; }

public string SurName { get; set; }

public string GivenName { get; set; }

public string Title { get; set; }

public string Street { get; set; }

public string City { get; set; }

public string State { get; set; }

public string Country { get; set; }

public string PostalCode { get; set; }

public string Phone { get; set; }

public string Fax { get; set; }

[ForeignKey( "Customer" )]

public int CustomerId { get; set; }

public virtual Customer Customer { get; set; }

}

public class Context : DbContext

{

public Context() : base() { }

public Context( string connStr ) : base( connStr ) { }

public DbSet<Contact> Contacts { get; set; }

public DbSet<Customer> Customers { get; set; }

}

class Program

{

static void Main( string[] args )

{

Database.DefaultConnectionFactory = new SAConnectionFactory();

Database.SetInitializer<Context>( null );

using ( var db = new Context( "DSN=SQL Anywhere 12 Demo" ) )

{

foreach ( var customer in db.Customers.ToList() )

{

Console.WriteLine( "Customer - " + string.Format( "{0}, {1}, {2}, {3}, {4}, {5}, {6}, {7}, {8}, {9}",

customer.ID, customer.SurName, customer.GivenName, customer.Street, customer.City,

customer.State, customer.Country, customer.PostalCode, customer.Phone, customer.CompanyName ) );

foreach ( var contact in customer.Contacts )

{

Console.WriteLine( " Contact - " + string.Format( "{0}, {1}, {2}, {3}, {4}, {5}, {6}, {7}, {8}, {9}, {10}",

contact.ID, contact.SurName, contact.GivenName, contact.Title, contact.Street, contact.City,

contact.State, contact.Country, contact.PostalCode, contact.Phone, contact.Fax ) );

}

}

}

}

}

}

Additional assembly references need to be add to run these examples: EntityFramework, iAnywhere.Data.SQLAnywhere.v4.0, System.ComponentModel.DataAnnotations, System.Data.Entity.

In high availability or read-only scale-out, if the connection to the primary or parent server was dropped just after the mirror or copy node had determined its role, the mirror or copy node could have failed to start with the errors:

"database is not compatible with primary; files must be replaced" and

"Database server shutdown due to incompatible files for database mirroring."

This has been fixed. Note that attempting to restart the mirror or copy node after receiving this error should succeed in this case.

New and simplified configuration and logging conventions:

- Configuration file: <physical directory of the rs.dll>/rs.config

- Relay Server log file location: <physical directory of rs.dll>/Log/rs.log

The removal of the use of shared memory improves security and simplifies flow control signals, as there is one less resource to monitor. The new IIS Relay Server must be set up with a single application pool with web garden size = 1.

The workaround is to restart the rshost process. This has been fixed

Also, the method Connection.getDatabaseProperty() was exposed for UltraLiteJ Android; and the method DatabaseInfo.getRelease() was modified to return the full software release, including the build number.

Note, if a server that does not have this fix, and has many IP addresses, connects to a server with this fix, the fixed server will give a protocol error.

SQL error (-1474) -- SRID 0 is referenced by column ... of table ...

This has been fixed.

Documentation:

Connection::getNewUUID method

Returns a new UUID value.

Syntax

UUID getNewUUID()

example:

uuid = conn.getNewUUID();

SQLType.toString method

Returns the string name of the specified SQL column type constant or BAD_SQL_TYPE if not a recognized type.

Syntax

String toString(UInt16 code)

Parameters

code The SQL column type constant.

example:

uuid_str = conn.getNewUUID().toString();

1) When the consolidated database was running on a MySQL server, the MobiLink server could have immediately failed a status-check request when the server was not able to lock the remote ID;

2) When the consolidated database was running on a SQL Anywhere server, if the remote ID could not be locked in the upload transaction, the server would have shown the following warning message:

"Retrying the upload after deadlock in the consolidated database"

and then retried the upload transaction one more time.

If so, please document the prototype for Perl for db_register_a_callback function.

Note, SQL Anywhere version 12.0 does not attempt to generate a cache.dmp file.

"database is not compatible with primary; files must be replaced" and

"Database server shutdown due to incompatible files for database mirroring."

This has been fixed.

For example:

select {fn extract(month from '2011-05-07')}, {fn position('b' in 'abc')}

would have failed with syntax errors. If an uppercase keyword was used, the query would have succeeded:

select {fn extract(month FROM '2011-05-07')}, {fn position('b' IN 'abc')}

This problem has been fixed.

Note: In Interactive SQL, the braces { and } must be doubled-up (i.e. {{ and }} ).

A possible work-around for the problem is to use an insensitive or keyset-driven cursor type.

and an error handler within the stored procedure was invoked, an incorrect SQLCODE (0 or

the error code of a different error that occurred prior to the cancel) could have been reported. An incorrect error message could also have been reported by the ERRORMSG() function. This has been fixed.

- In certain cases when a copy node lost its connection to its parent and then encountered a log mismatch with the parent after it reconnected, a single CPU would remain at 100% utilization indefinitely.

- When cancelling a CREATE EVENT statement while processing a procedure profile (sa_procedure_profile, sa_procedure_profile_summary), a single CPU would have remained at 100% utilization until no connections were processing profile information

- While waiting for connections to drop when yielding to a mirroring partner, a CPU would have remained at 100% utilization until all connections were dropped.

The specified service is running. The service will be deleted when it is stopped.

Service "<svc name>" was deleted successfully.

This has been fixed. If the service is running, only the first message is displayed, otherwise only the second is displayed.

.A workaround is to specify a user when connecting to the UltraLite database to update the remote schema.

The error message displayed when a table in a table mapping can't be found in the corresponding schema has also been fixed. The message now correctly includes the table name that could not be found, instead of displaying '{0}' for the table name.

Another problem is also addressed with this change. Previously if you changed the remote table for a table mapping, some options could change to their defaults, such as the direction changing to bidirectional. Now the synchronization direction and other synchronization options are maintained.

- HTTP METHOD was not supported,

- request URL was malformed,

- the HTTP listener specifies that the DBN was required but the database name was not within the URL path.

This has been corrected. Now if a request has faulted due to any of the above reasons, the HTTP method (@M) and version (@V) will emit the string "???". The given request line is pre-pended with a ">>>" and emitted for the (@U) format place holder.

For example:

A request of the form:

BLAH /sample/test HTTP/1.0

will emit the following for LogFormat="@M @U @V"

"??? >>> BLAH /sample/test HTTP/1.0 ???"

- Service start time in UTC.

- Status capture time in UTC.

- Status refresh interval, or indication that manual refresh is expected.

1. If an end-time was specified (i.e., "BETWEEN start-time AND end-time"), then:

a. Seconds were being ignored. For example, an end-time of '23:59:59' was being interpreted as '23:59:00'.

b. The end-time was tested as an exclusive endpoint rather than an inclusive endpoint, contrary to the documentation of the BETWEEN ... AND clause. For example, the schedule "BETWEEN '9:00' AND '17:00' EVERY 60 MINUTES" would cause the event to fire last at 16:00, rather than 17:00.

2. If an end-time was not specified (i.e., "START TIME start-time"), the end-time for each day was implicitly being treated as '23:59:00' exclusive, instead of '23:59:59' inclusive.

The combined effect of these error were that no scheduled events would fire in the minute from 23:59:00 until midnight. This has been fixed.

Note, this extends the changes made by Engineering case 660851.

Note, this applies to addresses in connection strings (using the LINKS or HOST parameters), the -x and -xs switches on the server, and URLs in web service procedures.

Note, it is recommended that large binary parameters be set using PreparedStatement.appendBytesParameter().

1. An error was encountered while starting the database

2. Logs were being applied to a database at startup with -a, -ad or -ar but the -as switch was not used

3. The engine was requested to stop while the database was starting.

This has now been fixed.

User 'a_ml_user_name' has the row in 'ml_database' locked (ODBC State = 40001, Native error code = -210)

The new synchronization must also have contained an upload that included upload rows for multiple synchronization tables, and reused the database connection that was used for processing the redundant synchronization. This problem is fixed now.

Note, all connections used by a MobiLink server are shown in the MobiLink server logging file with a prefix SPID when a minimal verbosity is specified in the MobiLink command line.

FARM_CHANNEL_CONNECT_WITH_INVALID_SERVER_IDX 2006

SERVER_DISCONNECT_EARLY 3014

FARM_FAIL_ACCESS 12000

SERVER_FAIL_NEWING_CLIENT_STATISTIC 13011

This has been fixed.

1) The derived table contained a procedure call in its FROM clause and the procedure argument expression contained the outer reference.

2) The derived table contained a OPENSTRING clause in its FROM clause and its value expression contained the outer reference.

3) The derived table contained another derived table and the outer reference was inside this other derived table.

The below query shows an example of condition 3).

select ( select V0.e from (

select T3.e from T3 where T3.e = T2.c ) V0

) c1,

max(T1.b) as c2

from T1 join T2 on T1.a = T2.c

This problem has been fixed. The engine will now correctly return the error SQLE_INVALID_GROUP_SELECT, since the outer reference column has to be specified in the GROUP BY clause. Specifying the outer reference column in the GROUP BY clause (in the above example: group by T2.c) is also the work around to this problem.

Setup is automated but also interactive. It creates a demo application and a Quick Reference Guide to assist in subsequent Relay Server server maintenance. The Quick Reference is launched automatically as part of the setup.

Setup is comprised of the following major steps:

1. Introduction

2. Customization

3. Create a Backup

4. Deploy and Start the Relay Service

5. Generate and Launch the Quick Reference

6. Launch the Relay Server Status Page

7. Launch the SimpleTestApp Client

8. Shut down

To deploy the Relay Server components to Microsoft IIS 6.0 on Windows Server 2003, run rs-setup.bat from the SQLANY12%/RelayServer/IIS/quicksetup_iis6 directory

Interactive SQL could not be launched.

Please change the plug-in properties and

add the isql.jar file to its path.

was due to Sybase Central expecting ISQL.jar to be installed. This has been corrected by adding a dependency on ISQL.jar when an install of Sybace Central is created.

- the application was connected to a primary server that lost quorum (the server lost the connection to both the mirror and arbiter servers)

- the application stayed connected to this server (the old primary server) even though the network connection to other servers dropped

- the application was in the middle of committing a transaction between the time that the old primary server lost its connection to the mirror and arbiter server, and when the old primary server restarted as the new mirror server because it lost quorum

- the old mirror server took over as the new primary (the mirror server must have been able to connect to the arbiter server for this to occur)

This problem has now been fixed.

forward_x509_identity = yes

In the case were there is a chain of SAP intermediaries, the client identity headers may already present in the request. However not all clients may be granted a permission to act as such forwarder. So the default behavior is to replace the existing headers with the identity of the forwarder. To grant permission for a forwarder to forward its client identity without being overwritten by its identity, the following new pair of backend farm properties may be in the Relay Server configuration file:

forwarder_certificate_subject = <match-string>

forwarder_certificate_issuer = <match-string>

The <match-string> is used to check against a serialized form of the corresponding compound name field in the certificate. A '?' can be used to match any character and a '*' can be used to match any string. A '\' can be used as the leading escape character for '?', '*' or '\' of they need to be matched literally.

For example:

forwarder_certificate_subject = 'CN = mySapWD??.my.com, OU = Sybase, O = SAP, *'

forwarder_certificate_issuer = 'CN = quicksigner, OU = security department, O = my coop, L = my city, S = my state, C = my country'

To obtain the subject or issuer string of a forwarder, simply perform a forwarding without setting up the match requirement. The following error messages in the Relay Server log will reveal the full subject or issuer which fails the default empty match-string:

Forwarder certificate subject '<full-subject-string>' does not match pattern '' required in farm '<farm>'

Forwarder certificate issuer '<full-issuer-string>' does not match pattern '' required in farm '<farm>'

This problem can be worked-around by creating a symlink for gcc-4.2 -> gcc in the /Developer/Platforms/iPhoneOS.platform/Developer/usr/bin and similar Simulator directories, or by modifying the makefile or build.sh used by UltraLite.

Setup is automated but also interactive. It installs IIS7, turns on required IIS7 features, configures IIS7 for Relay Server, creates a demo application and a Quick Reference Guide to assist in subsequent Relay Server server maintenance. The Quick Reference is launched automatically as part of the setup.

Setup is comprised of the following major steps:

1. Introduction

2. Customization

3. Install IIS7 and Required Features

4. Create a Backup

5. Deploy and Start the Relay Service

6. Generate and Launch the Quick Reference

7. Launch the Relay Server Status Page

8. Launch the SimpleTestApp Client

9. Shut down

To deploy the Relay Server components to Microsoft IIS 7.0 or 7.5 on Windows Server 2008/Windows Server 2008 R2, run rs-setup.bat from the SQLANY12%/RelayServer/IIS/quicksetup_iis7 directory.

For example:

create variable mykey varchar(50);

set mykey='TheActualEncryptionKey';

select * from openstring(...) with (...) option (encrypted key mykey);

[dbisql]

lockedPreferences=fastLauncherEnabled

fastLauncherEnabled=false

As well, mlgenreplayapi will now create the directory specified by the -d option (the directory in which to put the generated code) when it does not exist.

In a related issue, the above error message should have been displayed, but was not, in a number of other cases. This has also been fixed.

W. 2011-10-28 21:23:36. <5608.2420.F5fcB0S456bR0> Server response NOT completed. Remaining 0 of 0 bytes.

Restarting the Outbound Enabler would have resolved the issue. This has now been fixed so that client requests will not be affected by the delay and restarting Outbound Enabler is no longer required.

Gtk-CRITICAL **:gtk_text_buffer_emit_insert:assertion 'g_utf8_validate (text, len, NULL)' faild

This problem has been fixed. As a consequence, the message output in the MobiLink server log when a synchronization request is received from a SA remote will change from:

Request from "Dbmlsync Version 16.0.0.3940" for: remote ID: ...

to:

Request from "Dbmlsync 16.0.0.3940" for: remote ID: ...

Also, if a transaction only modified temporary tables, it was possible that the transaction log would have been committed to disk although it didn't need to be.

These problems have been fixed.

LastCommitRedoPos: This property is available at both the connection-level and the database-level. The value returned is the redo log position after the last COMMIT operation was written to the transaction log by the connection or database.

LastWrittenRedoPos: This is a database-level property only. The value returned is the last redo position for which a write was issued to disk. The write is not necessarily synced to the physical medium as it may still be cached by the OS, disk controller or disk drive.

LastSyncedRedoPos: This is a database-level property only. The value returned is the last redo position for which a write was issued to disk and the data was synched to the physical medium. Data prior to this position is expected to be present on disk even in the event of a power failure.

Note, not all secured features add entries to the transaction log. For example, the READ_FILE secured feature blocks access to xp_read_file which would not get logged; however, the REMOTE_DATA_ACCESS secured feature blocks access to statements such as CREATE SERVER does get logged.

/**

* Enables or disables restartable HTTP. With restartable HTTP enabled,

* UltraLiteJ can tolerate network interruptions, so synchronizations will fail

* less often on unreliable networks.

* <p>

* To use restartable HTTP, both UltraLiteJ and the MobiLink server must have

* applied CR#690250.

*

* @param isRestartable Pass true to enable restartable HTTP, and false to

* disable. The default is false.

* @see #isRestartable()

*/

public void setRestartable( boolean isRestartable );

/**

* Returns true if restartable HTTP will be used, and false otherwise.

*

* @return Whether restartable HTTP will be used.

* @see #setRestartable(boolean)

*/

public boolean isRestartable();

To use this change, both remotes and servers must be upgraded. It is safe to upgrade only one of the remote or the server, as long as setRestartable is not called on the remote.

- Connection A opened a cursor that included fetching rows from a procedure

- Connection B dropped the procedure used by connection A

- Connection A then closed its cursor

This problem has been fixed.

Cannot convert timestamp with time zone to a numeric

or

Cannot convert xml to a numeric

Further, using an "numeric" before computing the aggregate. This has been fixed. The MIN and MAX aggregates no longer attempt to cast these types to "numeric".

Note, as expected no data is logged to the transaction log in this case.

Also, in a read-only scale out mirroring configuration, it is possible to drop the mirror server definition for a copy node. If that copy node was connected to the primary server at the time of the drop, the mirror server definition would not have been removed from the system tables. This to has been fixed.

2. ALTER TABLE ADD constraint would not have added existing table rows to the new index. SELECT with ORDER BY using the new constraint would have returned less rows, and it was possible to INSERT rows that violated the constraint.

3. ALTER TABLE ALTER column would not have properly modified the column definition.

4. ALTER TABLE ADD column, DROP column or ALTER column, would have corrupted the in-memory state when lazy loading, resulting in SQLE_ERROR in subsequent operations on a given table.

All the above issues have been corrected.

For example:

-gta 3,5-7

allows the database server to run on processors 3, 5, 6 and 7.

The lower endpoint of a range may be omitted in which case it is assumed to be zero. The upper endpoint of a range may be omitted in which case it is assumed to be the highest cpu known to the OS. The database server will only use logical processors specified by -gta but it may not use all of them if the license does not allow it, or if one or more of the specified logical processors does not exist or is offline. If the set of processors specified by -gta exceeds the license limits, the server will use the lowest-numbered logical processors specified by -gta up to but not exceeding the license limits. In particular, the server does not choose logical processors in the order listed by -gta and it does not attempt to maximize concurrency within the license limit and the specified

-gta option. If the set of processors specified by -gta does not match any online processors, the server acts as if -gta was not specified and uses up to the licensed number of processors starting at processor 0.

Note that -gta cannot be used at the same time as -gt or -gtc. A usage message will be

displayed when -gta is used with either -gt or -gtc.

Running multiple OEs still remains an option to further improve throughput over a single OE. In our test environment, it now takes about 12 OEs in order to become network bound. Previously, even with 64 OEs with network bounding client load (i.e. RS/OE slows down the traffic to the point that it is no longer network bound) it was not possible to max-out the link.

When the load is not sufficient to cause a network bounding situation, the Relay Server can now achieve close to 90% of the direct throughput where the clients are directly accessing the backend server.

Use the following method to initiate the Java runtime installation or confirm it is currently installed:

1.Go to Applications > Utilities > Java Preferences.

2.Open the Java Preferences.

3.If Java is not installed, you receive the following message:

揟o open 揓ava Preferences," you need a Java runtime. Would you like to install one now?�

4.Click Install and follow the prompts. The Java runtime is downloaded and installed.

connection's LastStatement property. This has been fixed.

The work-around is to not use the -zl command line option, or to turn off the

RememberLastStatement server option.

ARGN( 1, (select 1/max(v) from t1), (select 1/min(k) from t2), (select 1/0 from dummy) )

would have evaluated all of the subselects (and returned an error) before noting that only the first of the subselects needed to be evaluated, and no error returned. This has been fixed.

NOTE: The evaluation of subselects in procedural expressions now matches the evaluation in queries. For disjunctions and conjunctions, the order of evaluation of predicates is not guaranteed.

Also, the server's '-u' (use buffered IO) command line switch was ignored on Unix platforms that supported direct IO. This problem has also been fixed.

Also, the Certificate Viewer utility (viewcert) will now also correctly display the signature algorithm for certificates signed using SHA-2.

Example:

create or replace procedure foo ()

begin

create or replace variable @v int = 123;

end;

call foo();

select @v; -- should return 123 but would have returned NULL

This has been fixed. As a workaround set the default or initial value for the variable in a separate statement after the variable has been created.

A workaround is to disable intra-query parallelism by setting option MAX_QUERY_TASKS=1. (This only needs to be done for the statement or connection experiencing the problem, if it can be isolated.)

Error! The DBLIB library could not be loaded.

This can happen if your SQL Anywhere installation has been corrupted. You will not be able to search for database servers.

/opt/sqlanywhere12/lib32/libdblib12_r.so.1: /opt/sqlanywhere12/lib32/libdblib12_r.so.1: wrong ELF class: ELFCLASS32 (Possible cause: architecture word width mismatch)

Dismissing the dialog would allow the Monitor to continue, but the "Find" button would not have been available to search for SQL Anywhere database servers.

Workaround:

. /opt/sqlanywhere12/bin64/sa_config.sh

export LD_LIBRARY_PATH=/opt/sqlanywhere12/lib64:$LD_LIBRARY_PATH

/opt/sqlanywhere12/bin64/mlmon

The classes StreamHTTPParms/StreamHTTPSParms contain a number of methods to set MobiLink client network protocol options as properties, eg. setHost( String ). However, there were no methods to cover all possible MobiLink client network protocol options. This API can now be used to specify a semi-colon-delimted list of options that are appended to the options that are generated by the property settings for the class. The meaning of the option list for this API is as specified in the documentation of MobiLink client network protocol options.

1. Executing the ALTER TABLE statement incorrectly succeeded on a database that did not support encrypted tables (i.e. one that is not encrypted or fully encrypted).

2. If a database was created with version 10 to support encrypted databases, but was being executed on a version 11 or later server, the same ALTER TABLE statement would have fail with error -1047 "This database does not support encrypted tables".

These problems have now been fixed. In the first case, the ALTER statement will now

return error -1047, and in the second case, the ALTER statement will succeed.

encrypted system tables. This has been fixed.

This quick setup is divided into two main steps:

1- Configure the Apache web server for Relay Server

Run ap-setup.sh script, which consists of the following sections:

1. Introduction

2. Validation

3. Create Backup

4. Deploy the Relay Server

5. Deploy the SimpleTestApp page and Quick Reference

6. Introduction to test setup script (part two)

2- Create and start Relay Server test services

Run rs-test-setup.sh script, which consists of the following sections:

1. Introduction

2. Create and deploy Relay Server and Outbound Enabler test services

3. Start the Apache web server and the test services

4. Launch the SimpleTestApp

5. Launch the Relay Server status page

6. Generate and launch the Quick Reference guide

7. Shut down

1. Authorities for a user or group

2. Option name-value pairs for a login policy

3. Tables for a publication

4. Columns for an article

5. Option name-value pairs for a mirror server

In all of the above cases, the ordering was irrelevant; however, the tool could have reported differences because the comparison could have generated random orderings.

For example:

GRANT CONNECT,DBA,RESOURCE TO "DBA" IDENTIFIED BY ...

vs:

GRANT CONNECT,RESOURCE,DBA TO "DBA" IDENTIFIED BY ...

These have been fixed. The comparison now provides a consistent ordering as follows:

1. User and group authorities are ordered by authority name.

2. Login policy options are ordered by option name.

3. Publication tables are ordered first by user name, then by table name.

4. Article columns are ordered by column id.

5. Mirror server options are ordered by option name.

8192K of memory used for caching

Minimum cache size: 8192K, maximum cache size: 8192K

The Java-based administration tools may also report the following error:

Invalid maximum heap size: -Xmx0m

This has been fixed.

- dbh.convert_types = false did not return the String value properly.

- incorrect value of "precision" and "scale" of the column_info for integer data type.

- incorrect value of the number for the affected rows.

Also rakefile is changed to use rdoc/task instead of rake/rdoctask(deprecated).

New Ruby gem and source are posted under:

https://rubygems.org/gems/dbd-sqlanywhere

https://github.com/sqlanywhere

select a

, if a=1 then 1 else 0 end if as b

from openstring(value ',')

with( a int ) D

If an IF expression was used as an argument to a CASE expression where the predicate is known at open time, then the IF expression was incorrectly evaluated so that UNKNOWN was treated as FALSE, leading to the ELSE branch being returned instead of NULL. For example, the following statement incorrectly returned (NULL,0,0) instead of (NULL,NULL,NULL)

select a

, if a=1 then 1 else 0 end if as b

, case when 1=1 then b end case c

from openstring(value ',')

with( a int ) D

A similar problem could occur with an IF expression used as an argument to NULLIF.

This problem has been corrected.

[Sybase][ODBC Driver]Invalid string or buffer length

On the ARM hardware platform, a double-precision value consists of two 32-bit words and, when held in memory, the two words must appear consecutively and must both be word-aligned (i.e., a multiple of 4). The ODBC driver has now been corrected to check for an alignment that is a multiple of 4, not 8.

Note, an ALTER DATABASE UPGRADE will need to be performed on existing databases in order to get the new jConnect metadata procedures.

Note, the maximum number of parameters allowed is a function of the database page size. For example, for a page size of 4k, the limit is ~3620096 parameters.

[Sybase][ODBC Driver][SQL Anywhere]Authentication violation (ODBC State = 08001, Native error code = -98)

and then failed the request when all the following conditions were met:

1) The consolidated database was running on an OEM version of a SQL Anywhere server;

2) The consolidated database had been restarted since the MobiLink server was started; and

3) A client required a status-check because it did not get a full response in the last sync request that contained an upload.

These problem is fixed now. The immediate work around for this problem is to restart the MobiLink server.

be specified".

ias-rs-farm=<backend-farm-id>

ias-rs-server=<backend-server-id>

Use of ias-rs-server requires ias-rs-farm to be specified as well. The comparison of the value of these parameters are case sensitive but the name of these parameters are case insensitive. These new parameter can be applied to the status page url via all of the 4 existing extensions and they can co-exist with the ias-rs-refresh-sec parameter.

Example status page url:

http:\\my.com\rs\admin\rs_admin.dll?ias-rs-farm=myfarm&ias-rs-server=myserver

http:\\my.com\rs\client\rs_client.dll?ias-rs-farm=myfarm&ias-rs-status-refresh-sec=20

When addressing rs_client.dll or rs_server.dll while IAS-RS-SERVER is not specified, individual server status will still be reported but the server name are hidden by label of this format: "_#<enumeration>_". In the cases of farm or server not found. The status page will still response with basic RS server information together with an error reporting what was not found. In those cases, no status information of any kind are reported but the viewer can still verify if they have a successful access to the extension of their choice.

The pin-pointed status url shares the pre-existing refresh control and it can be used as a basic service monitor in a browser.

Note, the default liveness timeout for synchronization and file transfer connections is 100 seconds for BlackBerry, J2SE and J2ME platforms, and 240 seconds (the default for UltraLite/MobiLink) for Android platforms.

The class documentation for the Java class follows:

/**

* Contains information about the network streams for a synchronization.

* This is useful if you wish to authenticate against some other server in

* the enterprise using the client-side certificate and HTTP headers.

*

* To enable collection of network stream data, add collect_network_data=1 to

* your -x switches. This adds additional per sync memory overhead to store

* the data. If using TLS or HTTPS with client-side certificates, add

* trusted_certificates=<certificate file> to have the server ask the client to send

* a certificate during the TLS handshake, incurring a time and network cost.

*

* You can obtain a NetworkData object by invoking the getNetworkData method

* of the DBConnectionContext class. When using HTTP or HTTPS, it will contain

* the header data for the last HTTP request received by the server before the

* authenticate scripts are invoked.

*

* @see DBConnectionContext

*

* @examples

* The following example shows how to get a NetworkData object from the

* DBConnectionContext, and prints the data it contains to the log.

*

* <pre>

* public class OrderProcessor {

* DBConnectionContext _cc;

*

* public OrderProcessor( DBConnectionContext cc ) {

* _cc = cc;

* }

*

* // The method used for the authenticate_user event.

* public void AuthUser() {

* NetworkData nd = _cc.getNetworkData();

* if( nd != null ) {

* if( nd.isHTTP() ) {

* System.out.println( "http" );

* String user_agent = nd.getHTTPHeaderValue( "user-agent" );

* System.out.println( " user-agent: " + user_agent.substring( 0, user_agent.indexOf( '/' ) ) );

* } else {

* System.out.println( "no http" );

* }

* if( nd.isTLS() ) {

* System.out.println( "tls" );

* CertPath certs = nd.getCertificateChain();

* if( certs != null ) {

* System.out.println( " client-side cert:" );

* int n = 1;

* for( Certificate c : certs.getCertificates() ) {

* System.out.println( " cert " + n++ );

* X509Certificate c509 = (X509Certificate) c;

* System.out.println( " Subject: " + c509.getSubjectX500Principal().getName() );

* System.out.println( " Issuer: " + c509.getIssuerX500Principal().getName() );

* }

* } else {

* System.out.println( " no client cert" );

* }

* } else {

* System.out.println( "no tls" );

* }

* if( nd.isEndToEndEncrypted() ) {

* System.out.println( "e2ee" );

* } else {

* System.out.println( "no e2ee" );

* }

* } else {

* System.out.println( "NULL networkdata" );

* }

* }

* }

*

* </pre>

*/

public interface NetworkData

{

/**

* Returns true if this sync is using HTTP or HTTPS, and false otherwise.

*

* @return True if this sync is using HTTP or HTTPS, and false otherwise.

*/

public boolean isHTTP();

/**

* Returns the value of the last header received by the server with the supplied

* name.

*

* @param the header name to the return the value for

*

* @return the last header value associated with the supplied header-name

*

* @see NetworkData#getHTTPHeaderValues

* @see NetworkData#getHTTPHeaders

*/

public String getHTTPHeaderValue( String name );

/**

* Returns all the header values received by the server associated

* with the supplied name.

*

* @param the header name to the return the values for

*

* @return the header values associated with the supplied header-name

*

* @see NetworkData#getHTTPHeaderValue

* @see NetworkData#getHTTPHeaders

*/

public List<String> getHTTPHeaderValues( String name );

/**

* Returns a Map that maps header names to a List of header-values.

*

* @return a Map containing all the headers received by the server.

*

* @see NetworkData#getHTTPHeaderValue

* @see NetworkData#getHTTPHeaderValues

*/

public Map<String, List<String> > getHTTPHeaders();

/**

* Returns true if this sync is using TLS, and false otherwise.

*

* @return True if this sync is using TLS, and false otherwise.

*/

public boolean isTLS();

/**

* Returns a java.security.cert.CertPath containing any certificates

* sent by the client. The certificates are all

* java.security.cert.X509Certificate objects.

*

* This function will return a non-null value only if isTLS() is true,

* the client supplies a certificate using the "identity" stream

* parameter, and the trusted_certificates option is set on the server.

* A non-null CertPath will contain the certificates in order,

* from the self-signed certificate to the peer certificate.

*

* @return A CertPath containing the X509 certificates that identify the

* client, or null if no such certificates were provided.

*/

public java.security.cert.CertPath getCertificateChain();

/**

* Returns true if this sync is end-to-end encrypted, and false otherwise.

*

* @return True if this sync is end-to-end encrypted, and false otherwise.

*/

public boolean isEndToEndEncrypted();

}

This method was added to the Java DBConnectionContext class:

/**

* Returns information about the network streams for a synchronization.

* This is useful if you wish to authenticate against some other server in

* the enterprise using the client-side certificate and HTTP headers.

*

* To enable collection of network stream data, add collect_network_data=1 to

* your -x switches. This adds additional per sync memory overhead to store

* the data.

*

* @return information about the network streams used for the request, or

* null if collection has not been enabled.

* @see NetworkData

*/

NetworkData getNetworkData();

The .NET class documentation follows:

namespace iAnywhere.MobiLink.Script

{

/// <summary>

/// Contains information about the network streams for a synchronization.

/// </summary>

/// <remarks>

/// This is useful if you wish to authenticate against some other server in

/// the enterprise using the client-side certificate and HTTP headers.

///

/// To enable collection of network stream data, add collect_network_data=1 to

/// your -x switches. This adds additional per sync memory overhead to store

/// the data. If using TLS or HTTPS with client-side certificates, add

/// trusted_certificates=<certificate file> to have the server ask the client to send

/// a certificate during the TLS handshake, incurring a time and network cost.

/// You can obtain a NetworkData object by invoking the getNetworkData method

/// of the DBConnectionContext class. When using HTTP or HTTPS, it will contain

/// the header data for the last HTTP request received by the server before the

/// authenticate scripts are invoked.

///

/// </remarks>

/// <example>

/// The following example shows how to get a NetworkData object from the

/// DBConnectionContext, and prints the data it contains to the log.

/// <code>

/// using iAnywhere.MobiLink.Script;

/// using System.Collections.Generic;

/// using System.Security.Cryptography.X509Certificates;

///

/// public class OrderProcessor {

/// DBConnectionContext _cc;

///

/// public OrderProcessor( DBConnectionContext cc ) {

/// _cc = cc;

/// }

///

/// public void AuthUser() {

/// NetworkData nd = _cc.NetworkData;

/// if( nd != null ) {

/// if( nd.IsHTTP ) {

/// PrintLn( "http" );

/// string user_agent = nd.GetHTTPHeaderValue( "user-agent" );

/// PrintLn( " user-agent: " + user_agent.Substring( 0, user_agent.IndexOf( '/' ) ) );

/// } else {

/// PrintLn( "no http" );

/// }

/// if( nd.IsTLS ) {

/// PrintLn( "tls" );

/// X509Certificate2Collection certs = nd.ClientCertificates;

/// if( certs != null ) {

/// PrintLn( " client-side cert:" );

/// int n = 1;

/// foreach( X509Certificate2 x509 in certs ) {

/// PrintLn( " cert " + n++ );

/// PrintLn( " Subject: " + x509.SubjectName.Name );

/// PrintLn( " Issuer: " + x509.IssuerName.Name );

/// }

/// } else {

/// PrintLn( " no client cert" );

/// }

/// } else {

/// PrintLn( "no tls" );

/// }

/// if( nd.IsEndToEndEncrypted ) {

/// PrintLn( "e2ee" );

/// } else {

/// PrintLn( "no e2ee" );

/// }

/// } else {

/// PrintLn( "NULL networkdata" );

/// }

/// }

/// }

/// </code>

/// </example>

public interface NetworkData

{

/// <summary>

/// Returns true if this sync is using HTTP or HTTPS, and false otherwise.

/// </summary>

/// <returns>

/// True if this sync is using HTTP or HTTPS, and false otherwise.

/// </returns>

bool IsHTTP {

get;

}

/// <summary>

/// Returns true if this sync is using TLS or HTTPS, and false otherwise.

/// </summary>

/// <returns>

/// True if this sync is using TLS or HTTPS, and false otherwise.

/// </returns>

bool IsTLS {

get;

}

/// <summary>

/// Returns the existing connection to the MobiLink consolidated database.

/// </summary>

bool IsEndToEndEncrypted {

get;

}

/// <summary>

/// Returns the value of the last header received by the server with the supplied

/// name.

/// </summary>

/// <param name="name"> the header name to the return the value for </param>

/// <return>

/// The last header value associated with the supplied header-name.

/// </return>

///

/// <seealso cref="GetHTTPHeaderValues"/>

/// <seealso cref="HTTPHeaders"/>

///

string GetHTTPHeaderValue( string name );

/// <summary>

/// Returns all the header values received by the server associated with

/// the supplied name.

/// </summary>

/// <param name="name"> the header name to the return the values for </param>

/// <return>

/// The header values associated with the supplied header-name.

/// </return>

///

/// <seealso cref="GetHTTPHeaderValue"/>

/// <seealso cref="HTTPHeaders"/>

///

IList<string> GetHTTPHeaderValues( string name );

/// <summary>

/// Returns a dictionary that maps header names to a list of header-values.

/// </summary>

/// <return>

/// A dictionary of header name-value pairs.

/// </return>

///

/// <seealso cref="GetHTTPHeaderValue"/>

/// <seealso cref="GetHTTPHeaderValues"/>

///

IDictionary<string, IList<string> > HTTPHeaders {

get;

}

/// <summary>

/// Returns an X509Certificate2Collection containing any certificates

/// sent by the client.

/// </summary>

/// <remarks>

/// This function will return a non-null value only if isTLS() is true,

/// the client supplies a certificate using the "identity" stream

/// parameter, and the trusted_certificates option is set on the server.

/// A non-null CertPath will contain the certificates in order,

/// from the self-signed certificate to the peer certificate.

/// </remarks>

/// <return>

/// An X509Certificate2Collection containing the X509 certificates that identify

/// the client, or null if no such certificates were provided.

/// </return>

X509Certificate2Collection ClientCertificates {

get;

}

}

}

The following property was added to the .NET DBConnectionContext:

/// <summary>

/// Returns information about the network streams for a synchronization.

/// </summary>

/// <remarks>

/// This is useful if you wish to authenticate against some other server in

/// the enterprise using the client-side certificate and HTTP headers.

///

/// To enable collection of network stream data, add collect_network_data=1 to

/// your -x switches. This adds additional per sync memory overhead to store

/// the data.

/// </remarks>

///

/// <returns> information about the network streams used for the request, or

/// null if collection has not been enabled.

/// </returns>

///

/// <seealso cref="NetworkData"/>

NetworkData NetworkData {

get;

}

1) The transaction log was renamed (and a new one started) at the end of a backup of the primary

2) The mirror or copy node caught up and applies some operations from new transaction log

3) The mirror or copy node lost connection with its partner or parent

4) The mirror or copy node reestablished connection with its partner or parent

Note that if the mirror or copy node restarted prior to reconnecting, corruption would not have occurred. If corruption did occur, an 'invalid transaction log' assertion failure on the mirror or copy node was the most likely outcome. This problem has been fixed.

Also, if a copy node (call it CN) has a parent that was not the primary (call it NP), it was possible for CN to stop applying transactions altogether. CN would have remained running as a read-only node but it would not have applied transactions until the database was manually restarted. For CN to enter this state, the following sequence of events must have occurred:

1) CN and NP become disconnected or CN just wasn't running yet

2) NP renamed the transaction log and started a new one (which happens as a result of copying actions performed at the primary)

3) CN and NP reconnect (or CN was started)

In this case, CN will now display a "Recovery complete" message in the console log.

Note that the SQL client API is no longer supported by default. If the SQL client API is needed, the QAnywhere message store must be initialized using qaagent -si with the new option -sqlapi.

dbeng12 -n jcs -c nonsense

However, if the argument to -c started with the a character associated with memory units (k, m, g), no usage text was displayed. For example:

dbeng12 -n jcs -c garbage

dbeng12 -n jcs -c magic

dbeng12 -n jcs -c k

This has been corrected so that the usage text is now displayed.

Note: The farm name and server id in the URL remain case sensitive.

- agg_arg was a complex expression

- a complex sub-expression of the agg_arg was used in the WHERE (or in an ON condition)

- the optimizer selected an execution strategy involving "distinct-by-rowids" (for example, there was an EXISTS subquery)

This problem has been fixed.

For example, the following query could have caused the SELECT statement to fail with the assertion failure error:

create table T_DBR_1( x int );

create table T_DBR_2( x int );

insert into T_DBR_1 select row_num from sa_rowgenerator(1,10);

insert into T_DBR_2 select row_num from sa_rowgenerator(1,100);

commit;

select count(*), sum( complex_expr1+2 )

from (

select case R1.x*10 when 11 then R1.x end case complex_expr1

, 99+R2.x as complex_expr2

from T_DBR_1 R1 left join T_DBR_2 R2 on R1.x = R2.x

where exists ( select * from dbo.rowgenerator R3 where R3.row_num+1 = R1.x )

) D

where complex_expr1 <> 12

or complex_expr2+2 <> 11

A workaround has been implemented to avoid the problem with double values, but the above note still applies.

- TCP load balancer without stickiness was used in front of a Relay Server farm of size greater than 1; and

- an application session had more than one HTTP request; and

- the session had crossed over to a Relay Sever different from the one where the session started and an I/O error or timeout occurred with the client connection.

The problem was that the Outbound Enabler was misinforming the Relay Server for a change in upward packet destination, when a session was migrated from one Relay Server to another, on a clear request-response boundary. This has now been fixed so that the Outbound Enable is stopped from misinforming the Relay Server.

The usage is:

mlsrvXX ... -x tls(...;trusted_certificates=certificate_file) ...

mlsrvXX ... -x https(...;trusted_certificates=certificate_file) ...

Used in the simplest way, the trusted_certificates option provides validation of clients, but without other capabilities like certificate revocation lists. To implement a certificate revocation list and otherwise integrate with your enterprise certificate infrastructure, you'll need to make use of the NetworkData.ClientCertificates API, described in the email forwarded below.

The simplest example to illustrate this is:

client --> ML server --> Enterprise certificate infrastructure

Use the trusted_certificates option to ensure the client certificate is valid, then use the NetworkData.ClientCertificates API to further authenticate the certificate in the authenticate_user script (written in Java or .NET).

- TCP load balancer without stickiness was used in front of a Relay Server farm of size greater than 1; and

- an application session had more than one HTTP request; and

- the session had crossed over to a Relay Sever different from the one where the session started and an I/O error or timeout occurred with the client connection.

The problem was that the Outbound Enabler was misinforming the Relay Server for a change in upward packet destination, when a session was migrated from one Relay Server to another, on a clear request-response boundary. This has now been fixed so that the Relay Server is protected from being misinformed by Outbound Enablers older than 12.0.1.3574.

For more information on Windows processor groups, see the following:

http://blogs.msdn.com/b/saponsqlserver/archive/2010/09/28/windows-2008-r2-groups-processors-sockets-cores-threads-numa-nodes-what-is-all-this.aspx

http://msdn.microsoft.com/en-us/library/windows/desktop/dd405503

In addition to supporting more than 64 processors on Windows, SQL Anywhere now uses the hardware topology as reported by Windows for license enforcement on all supported versions of Windows except Windows 2003 and Windows XP 64-bit edition where the operating system is known to misrepresent the actual topology. Previously, SQL Anywhere relied solely on its own hardware detection on x86 and x64 Windows platforms. By relying on the topology reported by Windows, SQL Anywhere will have a more consistent view of the topology when running in a VM.

These processor topology changes include fixes on other platforms too. On Solaris prior to this change, if the standalone engine was run within a processor set it would bind itself to a single random processor in the set. Now if the standalone engine is run within a processor set, it binds to the lowest numbered processor in the set. Outside of a processor set, the behaviour has not changed: we bind to the lowest processor that is not bound to any set.

Also on Solaris, the database server considered processors that were online but non-interruptible as offline. SQL Anywhere would not bind to such a processor. This problem has also been fixed.

SQL Anywhere now properly avoids processors that are offline when the server starts; however, no attempt is made to adapt to processors that are taken offline or brought online during runtime.

SAConnection conn = new SAConnection( connectString );

conn.Open();

.

.

.

conn.Close();

Note that this was not a problem with the mechanism that pushes log pages to copy nodes and mirror, but with the way the offset was reported.

varying timezone offsets. This has been fixed.

Note that the server must be started with a secure feature key (-sk) to make use of this feature.

- searching for the zero or null value (or empty string/binary, etc) would have resulted in an incorrect result set

-) rows with zero or null values may have been intermixed order-wise when scanning the index (i.e. select * from mytable order by col_in_bad_index)

This has been fixed.

Note, primary keys, unique keys (constraints) and not null indexes are not affected by this problem.

Small XML documents with a length less than or equal to 32 KB can be uploaded into and downloaded from an Oracle database with Oracle PL/SQL statements. However, when the length of XML documents is great than 32 KB, the upload XML documents may need to be uploaded into a (global) temporary table by the upload_insert and upload_update scripts and the upload data can then be converted and stored into the actual sync table in the end_upload_rows or end_upload script.

The following section gives sample upload and download scripts to upload and download XMLTYPE objects between an Oracle consolidated and SQLAnywhere remote databases. Here we assume our upload table is defined as

create table test (pk int not null primary key, c1 XMLTYPE)

in the Oracle consolidated database and

create table test (pk int not null primary key, c1 XML)

in the SA remote database. Then the upload and download scripts for the test table could be defined below:

1) All XML documents are less than or equal to 32KB long:

The upload and download scripts can be written as

a) upload_insert:

declare v_pk integer; v_c1 clob; x_c1 xmltype;

begin

v_pk := {ml r.pk};

v_c1 := {ml r.c1};

x_c1 := XMLTYPE.createXML( v_c1 );

insert into test values( v_pk, x_c1 );

end;

b) download_cursor:

select pk, XMLSERIALIZE( content c1 ) from test

This upload_insert script works well, when the XML data length is less than or equal to 32 KB. However, if the XML data length is greater than 32 KB, the Oracle server could complain with the following error:

ORA-01460: unimplemented or unreasonable conversion requested

when the MobiLink server was trying to execute the upload_insert script with the upload data.

2) Some of the XML documents are greater than 32KB long:

If there are any XML documents greater than 32 KB long, we are not able to use Oracle PL/SQL to upload data into the Oracle XMLTYPE columns. To work-around this problem, the upload XML data needs to be uploaded in a global temporary table:

a) upload_insert:

The upload_insert script will upload the XML documents into a global temporary table in the Oracle consolidated database and the global temporary table is defined as

create global temporary table tmp_test (pk int, c1 CLOB)

then the upload_insert script can written as

insert into tmp_test values( {ml r.pk}, {ml r.c1} )

Please note, the c1 column in the temporary table must have the CLOB data type.

b) end_uoload_rows:

The end_upload_rows script first retrieves the XML documents from the global temporary table, converts it to XML documents, and then stores the XML data into the test table. Here is the end_upload_rows script:

insert into test (pk, c1) (select pk, XMLTYPE.createXML(c1) from tmp_test

***** SQL error: Syntax error near 'xxx' on line 1

Also, during reload, extra apostrophes would be displayed in progress messages containing table, index, view, procedure or trigger names. This problem has been fixed.

Also, a structure used to query the OS version on Windows Mobile / Windows CE devices was not initialized correctly; however, it is not believed ever to have caused a problem. This problem has also been fixed.