IBM Dataservers backend support in Django application Framework.
--------------------------------------------------------
ibm_db_django enables access to IBM databases from Django applications
  http://www.djangoproject.com/

The adapter has been developed and is supported by IBM. 

Prerequisites
--------------
1. Python 2.5.x or Jython 2.5.x .
2. Django Framework 1.0.x or above.
3. IBM_DB driver and IBM_DB_DBI wrapper 1.0.1 or higher (ibm_db-1.0.1 is a minimum) for Python 
   and db2jcc.jar and db2jcc_license_cu.jar for Jython
4. For 1.0.2, you need to apply a patch in django in-order to remove Non-standard SQL generation issue. 
   The patch is located at http://code.djangoproject.com/ticket/9862.
   You can extract creation.py file from http://code.djangoproject.com/changeset/9703?format=zip&new=9703 
   and paste it to /django/db/backends/
5. For versions greater than 1.0.2 no patch is required.

DB2 Django adapter (ibm_db_django) Build and Installation
----------------------------------------------------------

Install Django as per instructions from the Django website (http://docs.djangoproject.com/en/dev/topics/install/#installing-an-official-release)

1. Linux
    $ easy_install ibm_db_django

2. Windows
    c:\> easy_install ibm_db_django

List of Operating Systems tested
--------------------------------
Ubuntu Linux 7.04 32/64 bit
Windows XP 32 bit

Supported Databases
-------------------
IBM DB2 Database for Linux, Unix, Windows and MAC OS X, version 8.2 or higher (9.5 FP2 or higher for MAC OS X).
Remote connections to z/OS (DB2 UDB for zOS)

Future Supported Databases
--------------------------
IBM Cloudscape
Apache Derby
Informix(IDS) Cheetah version 11.10 onwards
Remote connections to i5/OS (iSeries)


Testing
-------
Create a new Django project by executing "django-admin.py startproject myproj".
Now go to this newly create directory, and edit settings.py file to access DB2.

In case of *nix the steps will be like:
 $ django-admin.py startproject myproj
 $ cd myproj
 $ vi settings.py

The settings.py will be like (after adding DB2 properties):
   DATABASES = {
      'default': {
         'ENGINE'     : 'ibm_db_django'
         'NAME'       : 'mydb'
         'USER'       : 'db2inst1'
         'PASSWORD'   : 'ibmdb2'
         'HOST'       : 'localhost'
         'PORT'       : '50000'
      }
   }
   
To enable DB2 support you need to set value of DATABASE_ENGINE to 'ibm_db_django' in settings.py.

In the tuple INSTALLED_APPS in settings.py add the following lines:
'django.contrib.flatpages',
'django.contrib.redirects',
'django.contrib.comments',
'django.contrib.admin',


Next step is to run a simple test suite. To do this just execute following command in the 
project we created earlier:
 $ python manage.py test
 
For Windows, steps are same as above. In case of editing settings.py file, use notepad (or any other) editor.
 
Known Limitations in ibm_db_django adapter for DB2 databases
-------------------------------------------------------------

1. Non-standard SQL queries are not supported. e.g. "SELECT ? FROM TAB1"

2. dbshell will not work if server is remote and client is DB2 thin client.

3. For updations involving primary/foreign key references, the entries should be made in correct order. Integrity check is always on and thus the primary keys referenced by the foreign keys in the referencing tables should always exist in the parent table.

4. DB2 Timestamps do not support timezone aware information. Thus a Datetime field including tzinfo(timezone aware info) would fail.

Support for IBM_DB_DJANGO Adaptor
---------------------------------

Your feedback is very much appreciated and expected through project ibm-db:

ibm-db_django wiki: http://code.google.com/p/ibm-db/wiki/ibm_db_django_README
ibm-db issues reports: http://code.google.com/p/ibm-db/issues/list
ibm-db developers: opendev@us.ibm.com