Jun 29

Estimate DB space utilization with reorganization.

DB LOG, Kommands Comments Off on Estimate DB space utilization with reorganization.
How much space will be reclaimable in the TSM Server database if a DB reorganization is done?
After a reorganization of the TSM Server database, there was much more space reclaimed than the estimate command initial suggested.
The ESTIMATE DBREORGSTATS command only analyses the used pages. Any pages that are completely empty will not be included in the analysis. This means that heavily fragmented databases will be able to reduce their assigned capacity to much greater degree than the ESTIMATE DBREORGSTATS command suggests. From the example Q DB F=D below:
                    Available Space (MB): 115,000
                  Assigned Capacity (MB): 114,600
                  Maximum Extension (MB): 400
                  Maximum Reduction (MB): 20
                       Page Size (bytes): 4,096
                      Total Usable Pages: 29,337,600
                              Used Pages: 8,117,180
                                Pct Util: 27.7
                           Max. Pct Util: 27.7
                        Physical Volumes: 6
                       Buffer Pool Pages: 104,858
                   Total Buffer Requests: 24,711,191
                          Cache Hit Pct.: 99.11
                         Cache Wait Pct.: 0.00
                     Backup in Progress?: No
              Type of Backup In Progress:
            Incrementals Since Last Full: 0
          Changed Since Last Backup (MB): 414.17
                      Percentage Changed: 1.31
          Last Complete Backup Date/Time: 12/10/07 15:02:51
      Estimate of Recoverable Space (MB): 6,953
 Last Estimate of Recoverable Space (MB): 12/10/07 21:48:07
Currently the database can only be reduced by 20 MB, even though more space is technically free and empty. With an assigned capacity of 114,600 MB to the database, and a utilization of 27.7% we would expect that after a DB reorganization at least 82,800 MB of space would be recoverable – the amount between the actually utilized space in the database and the empty space up to the assigned capacity. However as seen the Estimate of Recoverable Space is only 6,953 MB.After the DB reorganization was completed, the assigned capacity was reduced by more than 82,800 MB.

The reason for this drastic difference, is that the estimate only covers the utilized data. Any portion of the database that is assigned, but not utilized, will not be included in the estimate. Therefore, the difference between the utilized data and the assigned capacity should be roughly included in the final estimate by the TSM Administrator when making a determination on if the reorganization is time and space effective.

written by Bosse

Jun 09

Managing the DB2 LOCKLIST Configuration Parameter with Tivoli Storage Manager

DB LOG, Info, Kommands Comments Off on Managing the DB2 LOCKLIST Configuration Parameter with Tivoli Storage Manager
How can the LockList configuration parameter be adjusted to minimize the potential for DB2 deadlocks in a Tivoli Storage Manager environment?
If the DB2 LOCKLIST parameter is managed incorrectly, it may cause deadlocks to be returned to the Tivoli Storage Manager application for insert, delete and update requests.
DB2 LOCKLIST PARAMETERThe DB2 LOCKLIST parameter indicates the amount of storage that is allocated within the Database Heap to store lock information. There is one LockList per database and it contains the locks held by all applications, or in this case Tivoli Storage Manager Server transactions, concurrently connected to the database. Locks are stored and manipulated by DB2 in the form of a request block which consumes 40 bytes of memory on 32-bit platforms or 64 bytes on 64-bit systems. By default, DB2 manages the LockList size automatically and increases or decreases the total LockList allocation based on current activity. To determine the current value, issue the following command:

db2 “get db cfg for <db name>”

The LockList is comprised of memory allocated as 4K pages. A LOCKLIST parameter value of 10000 (4KB pages) is equivalent to 40,960,000bytes (about 39MB) of memory allotted to the LockList from the Database Heap. A single lock request may require up to 128 bytes out of the LockList heap as one request block is used for the lock descriptor and the second block is used to associate the Tivoli Storage Manager server transaction with the resource being locked. If the lock resource has already been requested then only one request block is required for future transactions requesting that lock resource.


The proper management of the DB2 LockList is crucial to prevent deadlocks within the Tivoli Storage Manager server. When the server is under average workload and the amount of concurrent activity is not driving large spikes of lock requests, the DB2 automatic handling of the LockList works well for the Tivoli Storage Manager server. However, when the amount of concurrent data movement activity is high, the inherent spikes to the DB2 LockList can cause lock escalations which will ultimately result in deadlocks within the server.

The best case scenario is that the Tivoli Storage Manager server will re-drive the request and the subsequent operation will not fail due to the deadlock. Most Tivoli Storage Manager server operations effectively recover from this but in the case where a lot of data had been moved, deleted, or updated, the time required to process the data a second, or even third time can result in severe performance degradation on the Tivoli Storage Manager server. The worst case scenario is that the operation cannot be retried and the entire operation fails.

If the amount of concurrent data being moved exceeds 500GB at any given time, it is recommended that the DB2 LOCKLIST parameter be adjusted as explained below. If the Tivoli Storage Manager server is involved with deduplicating large files either from the client, or server, properly tuning the LockList manually is extremely critical as large file deduplication inherently drives the number of rows needing to be managed by DB2 very high. This is because a large file is managed in many small pieces which result in many row locks within the DB2 LockList.

The following Tivoli Storage Manager server messages are issued when a transaction is being rolled back due to a deadlock within DB2.
ANR0159E dbieval.c(863): Database deadlock detected on XX:X.
ANR0162W Supplemental database diagnostic information:
The current transaction has been rolled back because of a
deadlock or timeout. Reason code “2”. SQLSTATE=40001).    


To choose a LOCKLIST parameter value that will minimize the amount of deadlocks that may occur within a Tivoli Storage Manager server environment, the maximum amount of data that can be moved, or managed, within the Tivoli Storage Manager server at any given time must be known or at least approximated with a fair amount of precision. .

Tuning Best Practice: Increase the DB2 LOCKLIST value by twice the amount of anticipated workload so that there are no unexpected failures during daily and nightly operations.

It is important to note that increasing the DB2 LOCKLIST parameter value has a direct effect on the amount of memory that is required within the instance memory region. Increasing the parameter should be done with the understanding of what the potential memory implications will be on the system. The following information and examples can be used to tune the DB2 LOCKLIST parameter to an appropriate value based on the Tivoli Storage Manager server environment and workload:


500GB = 2,500,000 locks = 122000 LOCKLIST

1TB = 5,000,000 locks = 244000 LOCKLIST

5TB = 25,000,000 locks = 1220000 LOCKLIST


122000 LOCKLIST = 499MB (122000 X 4096)

244000 LOCKLIST = 1GB (244000 X 4096)

1220000 LOCKLIST = 4.9 GB (1220000 X 4096)

Example #1

100 Tivoli Storage Manager clients store 1TB of data in a 4 hour nightly window

Migration has the ability to move 1TB of data in the same 4 hour window

Total concurrent data movement – 2TB

DB2 LOCKLIST recommendation – 588000

Additional impact to system memory (potential) – 2.4 GB

Example #2

Migration has the ability to move up to 1TB of data in an 8 hour window

Reclamation can run in the same window and process up to 2TB of data

Expiration runs in the same window and can process up to 10 Million files which represent 500GB of data

Total concurrent data movement/management – 3.5 TB

DB2 LOCKLIST recommendation – 954000

Additional impact to system memory (potential) – 3.9GB

UPDATING THE DB2 LOCKLIST PARAMETERThe following command can be used to update the LOCKLIST parameter:

db2 “update db cfg for <db name> using LOCKLIST XXXXXXXX”


The new value can be verified by issuing the following command:

db2 “get db cfg for <db name>”

NOTE: As a result of updating the DB2 LOCKLIST parameter the MAXLOCKS parameter will be set to manual as well. The MAXLOCKS parameter controls what percentage of the LockList that a single transaction can own at any given time. Please ensure this value is set from 95-100. If it is not in this range, the parameter can be updated with the following command:

db2 “update db cfg for <db name> using maxlocks 97 “

written by Bosse

May 17
Tivoli Storage Manager V6.2 servers that were configured using the configuration wizard or upgrade wizard on Windows systems might have database backups that fail.When the database backup command is issued it might fail and display this message: “ANR2968E Database backup terminated. DB2 sqlcode: -2033. DB2 sqlerrmc: 406.”
If the upgrade wizard or configuration wizard is used to configure or set up a Tivoli Storage Manager V6.2 server on a Windows system, when the BACKUP DB command is issued, it might fail due to a problem with the setup of the DSMI_api environment variable.
The database backup does not occur, and the server issues this message: “ANR2968E Database backup terminated. DB2 sqlcode: -2033. DB2 sqlerrmc: 406”.
To resolve this problem you must set the DSMI_api environment variable configuration for the database instance.Note: These examples use server1 for the database instance and d:\tsmserver1 for the Tivoli Storage Manager server instance directory. Replace these values with your actual values when issuing the commands.Perform these steps to set the DSMI_ api environment-variable configuration for the database instance:

1. Navigate to the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed Tivoli Storage Manager in a different location, go to the db2\bin subdirectory in your main installation directory and issue this command to open a DB2 command window:

2. Issue this command:
db2set -i server1 DB2_VENDOR_INI=d:\tsmserver1\tsmdbmgr.env

Additional information can be found in the Tivoli Storage Manager, Version 6.2 Information Center at: http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2/index.jsp?topic=/com.ibm.itsm.srv.install.doc/t_srv_prep_dbmgr.html.

written by Bosse

May 12

Obtaining data from database tables on Windows Tivoli Storage Manager 6.x

Kommands Comments Off on Obtaining data from database tables on Windows Tivoli Storage Manager 6.x
Can information be obtained directly from the version 6.1 Tivoli Storage Manager database tables as it was in version 5?
Unlike version 5, where internal tables had to be mapped to temporary tables, information can be obtained directly from the DB2 database tables for TSM 6.1 by issuing select statements from the DB2 command line prompt.
Ensure that the DB2INSTANCE environment variable is pointing to the correct database instance. Using the default instance name as an example:
set DB2INSTANCE=server1

The db2ilist command can be used to list the instances when run from db2 command prompt.

Issue the following commands from a db2 command prompt to connect to the database, set the database schema and obtain information from a table in the database.

1) db2 connect to tsmdb1
2) db2 set schema tsmdb1
3) db2 select * from as_volume_status

The example above is for the as_volume_status table, data from any of the database tables can be obtained by specifying the desired table name.

Data can be redirected to a text file by using the redirect symbol (>). For instance:
db2 select * from activity_log > actlog.txt

written by Bosse