DB2 Version 9.7 for Linux, UNIX, and Windows

Some registry and environment variables have changed

In Version 9.7, there are a number of changes to registry and environment variables.

New defaults

Table 1. Registry variables with new default values
Registry variable Version 9.5 default setting Version 9.7 default setting
DB2_LOGGER_NON_ BUFFERED_IO OFF Starting with Version 9.7, the default value for this variable is AUTOMATIC, which means that log files in the active log path might be accessed using non-buffered I/O. The database manager determines which log files benefit from using non-buffered I/O. In Version 9.5 Fix Pack 1 or later, the default was OFF and log files were accessed using only buffered I/O.
DB2_SMS_TRUNC_TMPTABLE_THRESH 0

Starting in Version 9.7 Fix Pack 2, the default for this variable is -2, which means that there will not be any unnecessary file system access for any spilled SMS temporary objects whose size is less than or equal to 1 extent * number of containers. Temporary objects that are larger than this are truncated to 0 extent

Table 2. Registry variables with new values
Registry variable New values
DB2AUTH

Starting in DB2® Version 9.7 Fix Pack 5, this variable has a new option, SQLADM_NO_RUNSTATS_REORG, which allows you to take away the ability of users with SQLADM authority from performing runstats or reorg operations.

DB2_EVMON_STMT_FILTER Starting in DB2 Version 9.5 Fix Pack 1, this variable has new options that allow you to determine which rules to apply to which event monitors. Each option represents an integer value mapping to a specific SQL operation. .
DB2_FCM_SETTINGS

Starting in DB2 Version 9.7 Fix Pack 3, this variable has a new setting, FCM_CFG_BASE_AS_FLOOR, which allows you to set a floor value for the fcm_num_buffers and fcm_num_channels database manager configuration parameters so that auto-configuration will not tune below their set value.

DB2_SQLROUTINE_PREPOPTS This variable has two new options:
  • APREUSE, which indicates whether the query compiler will attempt to reuse access plans.
  • CONCURRENTACCESSRESOLUTION, which specifies the concurrent access resolution to use for statements in the package
DB2_WORKLOAD This variable has new values: CM, COGNOS_CS, FILENET_CM, MAXIMO, MDM, WAS, WC and WP. These settings allow you to configure a set of registry variables in your database for applications provided by IBM® Content Manager, Cognos® Content Server, Filenet Content Manager, Maximo®, Master Data Management, WebSphere® Application Server, IBM WebSphere Commerce and WebSphere Portal.

The CM and WC values are also available starting in DB2 Version 9.5 Fix Pack 3 and Fix Pack 4, respectively. The COGNOS_CS, FILENET_CM, MAXIMO, MDM, WAS, and WP values are also available starting in DB2 Version 9.5 Fix Pack 5.

Changed behaviors

Table 3. Registry variables with changed behaviors
Registry variable Changed behavior
DB2_EVALUNCOMMITTED and DB2_SKIPDELETED

For statements operating under cursor stability isolation level with currently committed behavior enabled using the cur_commit database configuration parameter, these registry variables are in effect only when currently committed cannot be applied to a scan. Otherwise, the evaluation of predicates is performed on data retrieved by currently committed scans. If currently committed behavior was enabled using the BIND command or the PREPARE statement, these registry variables have no effect. For more information, see the cur_commit configuration parameter.

DB2_ITP_LEVEL

This registry variable was introduced in Version 9.7 Fix Pack 2 to enable the parallel reading of data during certain types of backup operations. Starting in Version 9.7 Fix Pack 3, the settings of this registry variable are ignored and have no effect during backup operations.

DB2_SERVER_ENCALG

The DB2_SERVER_ENCALG registry variable is deprecated. If the alternate_auth_enc database manager configuration parameter is set, its value has precedence over the DB2_SERVER_ENCALG value.

DB2_RESTORE_GRANT_ADMIN_AUTHORITIES

Starting in Version 9.7 Fix Pack 5, if DB2_RESTORE_GRANT_ADMIN_AUTHORITIES is set to ON and you are restoring to an existing database, then SECADM and DBADM authorities are granted to the user that issues the restore operation.

DB2_SKIPINSERTED

For statements operating under cursor stability isolation level with currently committed behavior enabled, this registry variable has no effect. For more information, see the cur_commit configuration parameter.

DB2_WORKLOAD

Starting in Version 9.7 Fix Pack 2, when this aggregate registry variable is set to SAP, the DB2_EXTENDED_OPTIMIZATION registry variable will be set to IXOR to improve performance for queries generated by SAP applications.

New variables

These environment and registry variables are new in Version 9.7:

Table 4. Environment and Registry variables added for Version 9.7
Registry variable Description
DB2_ATS_ENABLE

This registry variable enables or disables the administrative task scheduler.

DB2_BACKUP_USE_DIO

This registry variable allows you to have a backup image file directly written to disk, bypassing the file cache, potentially leading to better memory utilization on Linux platforms. This registry variable is available in Version 9.7 Fix Pack 6 and later fix packs.

DB2_DDL_SOFT_INVAL

This registry variable enables soft invalidation of applicable database objects when they are dropped or altered, meaning that active access to an object that is being invalidated can continue.

DB2_DEFERRED_PREPARE_SEMANTICS

This registry variable allows dynamic statements containing untyped parameter markers to use deferred prepare semantics in CLI and JDBC applications. When set to YES, any untyped parameter markers derive their data types and length attributes based on the input descriptor from subsequent OPEN or EXECUTE statements. In previous releases, or when set to NO (the default) compilation of such dynamic statements fails.

DB2_FCM_SETTINGS

On Linux operating systems, you can set this registry variable with the FCM_MAXIMIZE_SET_SIZE token to preallocate a default 4 GB of space for the fast communication manager (FCM) buffer. The token must have a value of either YES or TRUE to enable this feature.

DB2_FORCE_OFFLINE_ADD_PARTITION

This environment variable allows you to specify whether add partition operations are to be performed offline or online. The default setting of FALSE indicates that DB2 partitions can be added without taking the database offline.

DB2_HADR_ROS

This variable enables the HADR reads on standby feature. When DB2_HADR_ROS is enabled on the HADR standby database, the standby accepts client connections and allows read-only queries to run on it. This registry variable is available in Version 9.7 Fix Pack 1 and later fix packs.

DB2_HISTORY_FILTER

This variable specifies operations that are not to modify the history file, thereby reducing potential contention on the history file This registry variable is available in Version 9.7 Fix Pack 6 and later fix packs.

DB2_LIMIT_FENCED_GROUP

On Windows operating systems, if you enable extended security, this registry variable can limit the operating system permissions of the fenced routines that run under the fenced mode process (db2fmp).

DB2_MAX_GLOBAL_SNAPSHOT_SIZE

Starting in Version 9.7 Fix Pack 7, you can use this variable to specify the maximum size a snapshot or snapshot estimate can be, thereby preventing large global snapshots from causing memory usage spikes.

DB2_NCHAR_SUPPORT

This variable allows the use of NCHAR, NVARCHAR, and NCLOB data types in Unicode databases. When it is set to ON, various national character related functions such as NCHAR() and TO_NCHAR() are also supported.

DB2_PMAP_COMPATIBILITY

This variable allows users to continue using the sqlugtpi and sqlugrpn APIs to return, respectively, the distribution information for a table, and the distribution map offset and database partition for a row. When this variable is set to OFF, the distribution map size for new or upgraded databases is increased to 32 768 entries and you have to use the new db2GetDistMap and db2GetRowPartNum APIs.

DB2_PMODEL_SETTINGS

Starting in Version 9.7 Fix Pack 3, you can use this variable to modify the behavior of various aspects of the DB2 internal infrastructure. If you set this variable with the MLN_REMOTE_LISTENER option, applications can connect directly to each logical database partition instead of routing requests through the database partition server that is assigned to logical port 0. If you set this variable with the ENHANCED_ROLLBACK option, rollback requests for units of work are sent only to logical database partitions that participated in the transaction.

DB2RESILIENCE This environment variable controls whether DB2 data page read errors are tolerated, and activates extended trap recovery. It is set to ON by default. To revert to the behavior of previous releases and force the database manager to shutdown the instance, set the registry variable to OFF.
DB2_SAS_SETTINGS

Starting in Version 9.7 Fix Pack 6, this DB2 registry variable is the primary point of configuration for in-database analytics with the SAS embedded process.

DB2_SQLWORKSPACE_CACHE

This variable allows you to control the amount of caching of previously used sections in the SQL Workspace. You would adjust the setting for DB2_SQLWORKSPACE_CACHE based on how much of the SQL workspace you want to make available for reuse, which can result in some performance improvements for OLTP workloads.

DB2_STANDBY_ISO

This variable coerces the isolation level requested by applications and statements running on an active HADR standby database to Uncommitted Read (UR). When DB2_STANDBY_ISO is set to UR, isolation levels higher than UR are coerced to UR with no warning returned. This registry variable is available in Version 9.7 Fix Pack 1 and later fix packs.

DB2STMM

Starting in DB2 Version 9.7 Fix Pack 5, you can use this registry variable to modify the self tuning memory manager (STMM) shared memory segment in order to mitigate downlevel instance compatibility issues.

DB2_USE_FAST_PREALLOCATION

This variable allows the fast allocation file system feature to reserve table space, and speed up the process of creating or altering large table spaces and database restore operations. This variable is available with DB2 Version 9.7 Fix Pack 1.