The current maintenance kits are Caché and Ensemble 2009.1.2. This document is only part of the available maintenance kit documentation. The full set of documents is available in the docs subdirectory of the product installation directory. Release notes and related material are available as follows:

• Late-breaking information about the release: <install-dir>\docs\cache\en-us\relnotes\cache\readme.1st or <install-dir>\docs\cache\en-us\relnotes\ensemble\readme.1st
• Release notes for 2009.1.2: <install-dir>\docs\cache\en-us\relnotes\cache\relnotes.htm or <install-dir>\docs\cache\en-us\relnotes\ensemble\relnotes.htm
• Release notes for the previous maintenance kits since 2009.1: <install-dir>\docs\cache\en-us\relnotes\cache\prenotes.htm or <install-dir>\docs\cache\en-us\relnotes\ensemble\prenotes.htm (this document)

This document is a historical archive of changes since the original 2009.1 release, but prior to the current maintenance kit. Changes unique to the current maintenance kit are described in relnotes.htm.

This document includes the following sections:

• General Announcements
• InterSystems News, Alerts, and Advisories
• Online Documentation
• Change Reports for the Previous Maintenance Kit

InterSystems advises all users to recompile their application classes as part of the upgrade process so as to take advantage of all the performance improvements as well as other changes that may affect them in this release.

Anyone upgrading from a Caché release at or before 5.0 will need a new license key.

From time to time, InterSystems publishes items of immediate importance to users of our software. These include alerts, mission critical issues, important updates, fixes, and release announcements.

The most current list can be obtained from the InterSystems Web site.

Users should check this list periodically to obtain the latest information on issues that may have an effect on the operation of their site.

As a convenience to our users, InterSystems provides online access to documentation for recent product versions at the InterSystems documentation Web site.

The first (and only) maintenance release for 2009.1 is 2009.1.1. Version 2009.1.1 of Caché includes the following changes:

This change ensures that escaped Unicode characters are properly extracted and passed to the function that un-escapes them and converts to UTF-8. Previously, this issue could prevent query strings with embedded Unicode characters from being decoded correctly.

These changes update the following tutorials:

• Web Applications Tutorial (TWEB) to show Web Form Wizard launched from Studio Templates Menu
• Screen Captures for 2009.1 in Caché QuickStart Tutorial (TQKS)
• CSP Tutorial to show launching Web Form Wizard from Studio Templates
• CSP tutorial example to add warning so users do not use code as a CSP login page

The datatype Ens.DataType.Class has a parameter EXTENDS that allows the user to require that the value of the type extend the indicated class. Before this change, however, if you tried to use the EXTENDS class as the value, then the validation would fail because a class isn't considered to be derived from itself (which isn't really proper polymorphic behavior).

When upgrading Ensemble, the upgrade process overwrote the CSP application definitions for each of the Ensemble-enabled namespaces. In case the user had modified settings such as resource required, matching roles, description, timeout, these modifications would be lost upon an upgrade.

This change corrects that situation. Now, if the CSP application for a namespace's Ensemble Portal already exists, the upgrade process opens its definition and only sets the following properties, keeping the previous values for all other properties: CookiePath, LockCSPName, NameSpace, Path, Recurse, ServeFiles, UseCookies, LoginPage.

This change corrects a problem that can occur on a Spanish system during an Ensemble upgrade. The collation for Ensemble globals with subscript level mapping from ENSLIB was not set correctly and could cause a collation mismatch error depending on the default collation for the database.

This would only happen on systems whose default collation is not Caché Standard, and in namespaces created during installation or post-installation such as ENSEMBLE (but not ENSDEMO which is created later in the process).

This correction adds new entries for all Ensemble globals mapped from ENSLIB with settings Collation = 5 (Caché Standard) and IsKeep = 1. It also properly handles existing local data that may exist in the local database for the globals that are mapped at the subscript level only.

This change fixes a bug that causes a stream storage for low-order byte data retrieved by the SQL Adapters into a Snapshot object to be killed improperly. The stream data in question is stored in the ^CacheStream global.

This change fixes a defect introduced with IPv6 parsing in the TCP Inbound Adapter and its subclasses. The bug results in an invalid IP address when a port is specified in both the Port setting and as part of the AllowedIPAddresses setting.

The correct behavior when port is doubly specified is for the Port setting value to be ignored and the AllowedIPAddresses value to take precedence. This change restores the correct behavior.

This change fixes errors in the method ImportFromResultSet() in class EnsLib.SQL.Snapshot that prevented it from working, in particular the use of an undefined variable tGblRef.

This change enhances the parser used to determine which Stored Procedure arguments are being used as parameters in an invocation of ExecuteProcedure() on the SQL Inbound or Outbound Adapter.

This change also improves disconnect detection around calls to DropStatement()

This change fixes the accessor methods used by X12 to get TypeValue and Identifier calculated property values in the case where the document is an X12 Group, that is, starts with a GS segment. Formerly these fields were extracted as if the document were a TransactionSet starting with an ST segment; this yielded the wrong field values.

This change makes the initialization methods return status code values and makes the methods that call them check those return values consistently. This improves behavior when an associated JavaGateway configuration item cannot be located for an SQL Operation or Service configured for JDBC.

Internet Explorer 8 has a bug that causes it to acquire a wrong size in frameset.rows for the first frame in a frameset.

IE8 bug report can be found at: http://connect.microsoft.com/IE/feedback/ViewFeedback.aspx?FeedbackID=432864

It affects the Ensemble Management Portal as most of the pages contain frames.

There were other changes to workaround this situation. This new version also introduces a new behavior regarding resizing of the title frame, regardless of browser version.

In case the title frame size is reduced we will keep the chosen size. In case it's enlarged, it will be set back to its original size of 100 pixels. There's nothing below so it's pointless to have it larger than 100 pixels. This makes the workaround easier and also it seems to be better than the previous behavior.

The behavior is also in effect for IE6 and IE7 in order to have all users see the same regardless of browser version.

Before this change, a previous correction modified the queries generated by the Message Browser page when there is only one simple equality SearchTable condition. This change fixes that modification to work when there is only one *enabled* SearchTable condition (and it is a simple equality condition). Disabled conditions no longer count.

This change fixes a case where the variable nActions is defined after it is used. This change also removes an obsolete property %ReplyActions.

This change now enables the Perl/Python bindings to be installed on MACX64

The regular expression used by the CSP gateway configuration in Apache's httpd.conf file has been modified to work around a bug in the Mac OS X 10.4 provided Apache.

This change alters the custom setup accelerator key in setup role dialog to "u" to avoid conflict with "Server" setup type key.

This change corrects an access violation error in the setup bootstrapper that was happening when instance name was longer than installation directory name.

This change updates the Microsoft VC2008 SP1 redistributable packages to include ATL security update.

If a breakpoint was set on the line immediately following a ;;comment, the breakpoint would be ignored. This is now corrected.

This change makes the MultiValue spooler more robust when it comes to handling printing with transactions, notably transaction rollbacks.

All MultiValue print job updates are now performed outside of a transaction. This means that any transaction rollbacks that occur in the application will not affect the print job in any way and the data in the print job will remain intact and uncorrupted.

The PICK emulation for KEYIN() was incorrect in that it was echoing according to the ECHO ON/OFF status. In this emulation, it should never echo. This change implements that behavior.

This changes corrects problems in the Management Portal page:
[Home] > [Configuration] > [Device Settings] > [Devices]
namely,

• When editing device, some of the property values may not be loaded when using IE8.
• The "SubType" drop-down list may not be populated, and the value not shown as selected.
• After deleting a device item, it returned to the Device Settings page. It should stay on the same page and just refresh the tables for devices, magnetic tapes, and subtypes.

This change corrects an error in the TQSL parser that interpreted a name beginning legally with "%" as an expression involving the "%" operator.

This corrects a typographic error in the IsString method of %SAML AttributeValue that negated a validity check.

This change fixes a problem where a javascript error may occur when the wizard tries to display a warning message and, (A) the user clicked the Finish button without first selecting a row, or (B) the user selected more than 10 rows.

Another change added support for a new d_decimal type for %Numeric and %Decimal types to be projected via the C++ binding.

Since the Objective-C binding uses the C++ binding for its underlying connection to Caché, it was necessary to make additional changes to the Objective-C binding to project d_decimal types as NSNumber (actually, a subclass NSDecimalNumber).

This changes corrects an error where an expected value from a method call was not returned.

This change corrects a Role element of SOAP 1.2 fault which was not properly terminated.

The nThreadsPerCore method of the $SYSTEM.CPU class was misspelled as nTheadsPerCore. This fixes the misspelling.

This change alters the %XML.Reader to return SAX parser validation errors. The SAX parser was reporting the error, but there was a mismatch between %XML.Reader and the Caché interface to the parser.

This change corrects an error introduced in 2009.1 where return value of executeUpdate was assigned to %ROWCOUNT. The error manifests itself as the absence of error messages for an unsuccessful operation.

An optimization was added identifying cases where fields in certain views mentioned in a query were not actually essential to processing the query, resulting in improved run-time performance for those queries.

A correction was made to the code-generation of certain queries that use a multi-index access strategy, for example queries that use the %INLIST comparison operator, or queries of the form:

    SELECT id FROM t WHERE x=:a OR (x IS NULL AND :a IS NULL)

where t.x has an index and t has a multi-field IDKEY.

A problem has been fixed where an <undefined> could occur during execution of query that had two or more WHERE clauses, each of which has an OR that is subject to an OR to UNION optimization.

For the problem to occur, one of these OR conditions must be present in subquery of the query/subquery containing the other OR.

It is also possible this problem could arise with only one OR to UNION candidate. In that case, the query with an OR would have to also contain a subquery against an irreducible FROM clause subquery that had outer references to the query containing the OR.

This change implements the following: when a user disables syntax checking (Options->Editor->Syntax Check and Assist->Enable Syntax Checking "unchecked"), all syntax check parser related actions, including studio assist, tooltips and context sensitive menu for particular syntax element will be disabled.

Turning syntax checking in this way avoids unnecesaary work by Studio when scrolling through a large document.

This change correctly identifies when HyperThreading Technology is activated on recent Intel x86 chips (Nehalem-based), and how many cores are present.

This change corrects the behavior of object export. The multidimensional flag is only set if the property size is greater than zero. This change allows the xDBC connections to optimize their handling of properties only when they actually change.

This change disables the feature that returns unused space from a database to the filesystem. An attempt to invoke this functionality will have no effect, that is, no space will be returned.

This will remain disabled until there is a correction for a condition where an attempt by different processes to truncate and to expand the same database at the same time results in a hung system.

This change corrects a situation, present only in 2009.1, that could cause Caché to halt with an access violation error when a process halts leaving an XDEV in an open state.

The use of inet_ntop() to translate IP addresses was introduced in the system code when IPV6 support was introduced in Caché 2009.1. Checks for a zero return value were not made everywhere, which could lead to an access violation if inet_ntop() could not translate the binary address to display format. This problem has been corrected.

This change now makes starting up Caché work with a threaded Callin application.

This change corrects a situation where an attempt to restore a journal involving an unjournaled database could result in an <UNDEFINED> error.

The problem was introduced in 2009.1.0.

This change fixes a problem where the delock (L -^A) command might skip its operation and leave the lock in lock table.

This changes addresses a defect that resulted in an error like the following:

<UNDEFINED>zSourceEventsExecute+29^SYS.Shadowing.Shadow.1 *req("4"))

when the user started a non-cluster shadow after specifying the name of the shadow to start, but before giving a list of Source Events to choose to start shadowing at.

The problem is believed to be present in Caché 5.1 and forward (all releases containing HYY1119).

These changes properly handle the conversion of mappings present in a 2008.2 (or earlier) configuration file to an equivalent set of mappings in 2009.1. The major features of this conversion are:

1. All mappings (globals, routines, subscript-levels) are subject to the same rules.
2. Any overlaps found are converted into an equivalent, order-independent sequence of non-overlapped mappings.

This change corrects an error in end-of-file checking when reading the CPF file that could result in an infinite loop.

© 2009, InterSystems Corporation. All rights reserved.