Hata üreten DB2 CLI işlevinin (API) adı, SQLGetDiagRec() ya da SQLError() kullanarak alınabilen hata iletisinin sonuna eklenir. İşlev adı, kaşlı ayraç { } içinde gösterilir.
Örneğin,
[IBM][CLI Driver]" CLIxxxx: < text > SQLSTATE=XXXXX {SQLGetData}"
Bu anahtar sözcük yalnızca hata ayıklama için yararlıdır.
Bu seçenek, sorguların zamanuyumsuz olarak yürütülmesi yeteneğini etkinleştirir ya da devre dışı bırakır. Bu özellik yalnızca, bu özellikten yararlanacak şekilde yazılmış uygulamalar için yararlıdır. Bu özellik etkinleştirildiğinde uygulamanız doğru çalışmıyorsa, özelliği devre dışı bırakabilirsiniz. db2cli.ini kütüğünün veri kaynaklarına özgü kısmına yerleştirilir.
Not: | CLI/ODBC sürücüsü, zamanuyumsuz ODBC işlemlerini desteklemeyen önceki DB2 sürümleriyle aynı biçimde çalışır. |
Bu seçenek, ODBC ikili veri tiplerinin (SQL_BINARY, SQL_VARBINARY, SQL_LONGVARBINARY ve SQL_BLOB) ikili tip veri olarak bildirilip bildirilmeyeceğini belirtmenize olanak tanır. IBM veritabanı yönetim sistemleri, CHAR, VARCHAR ve LONG VARCHAR kolonlarını FOR BIT DATA özniteliğiyle tanımlayarak ikili tip veri içeren kolonları destekler. DB2 Universal Database, BLOB veri tipi aracığıyla da ikili verileri destekler (bu durumda, bu veri tipi CLOB veri tipine eşlenir).
(LONG) (VAR)CHAR verilerini SQL_C_CHAR arabelleğine alan DB2 Sürüm 1 uygulaması kullananların da bu seçeneği belirtmeleri gerekebilir. DB2 Sürüm 1'de, veriler değiştirilmeden SQL_C_CHAR arabelleğine taşınır; DB2 Sürüm 2 ve sonrası sürümlerde veriler her bir onaltılı parçacığın ASCII gösterimine dönüştürülür.
BITDATA = 0 tanımını, yalnızca FOR BIT DATA ya da BLOB olarak tanımlanan tüm kolonların yalnızca karakter verisi içerdiğinden ve uygulamanın ikili veri kolonlarını görüntüleme yeteneği olmadığından eminseniz yapın.
Değer 3 ile 30 arasında bir tamsayı DEĞİLSE, hata ya da uyarı üretilmeden varsayılan değer kullanılır.
Bu anahtar sözcük, CLI/ODBC uygulamalarında SQL deyimlerine ilişkin kısımların sayısını artırmak için kullanılır. Kullanılırsa, denetimci CLIPKG bağ tanımlama seçeneğini kullanarak, gerekli CLI bağ tanımlama kütükleri için belirtik olarak bağ tanımlamalıdır. Ayrıca, sunucudaki (UNIX ya da Intel altyapılarında DB2 UDB Sürüm 6.1 ya da üstü) db2cli.ini kütüğünün aynı CLIPKG değeriyle güncellenmesi gerekir.
Bu ayar yalnızca büyük (364 kısım içeren) paketler için geçerlidir. Küçük (64 kısım içeren) paketlerin sayısı 3'tür ve bu sayı değiştirilemez.
Paketler veritabanında yer kaplayacağı için, kısım sayısını uygulamanızı çalıştırmaya yeterli olacak kadar artırmanız önerilir.
DB2 ODBC kataloğu, DB2 Connect aracılığıyla anasistem veritabanı yönetim sistemlerine (DBMS'ler) bağlanan ODBC uygulamalarındaki çizelge listelerine ilişkin şema çağrılarının başarımını iyileştirmek üzere tasarımlanmıştır.
Anasistem DBMS'lerinde yaratılan ve tutulan DB2 ODBC kataloğu, gerçek DB2 kataloğunda tanımlı olan nesneleri gösteren satırlar içerir; ancak, bu satırlarda yalnızca ODBC işlemlerini desteklemek için gereken kolonları bulunur. DB2 ODBC kataloğundaki çizelgeler, ODBC uygulamaları için hızlı katalog erişimini desteklemek üzere önceden birleştirilmiş ve özel olarak dizinlenmiştir.
Sistem denetimcileri, her biri yalnızca belirli bir kullanıcı grubu için gereken satırları içeren birden çok DB2 ODBC kataloğu görünümü yaratabilir. Böylece, her son kullanıcı (bu anahtar sözcüğü ayarlayarak) kullanmak istediği DB2 ODBC kataloğu görünümünü seçebilir.
CLISCHEMA ayarının kullanımı ODBC uygulaması için tam olarak saydamdır; bu seçeneği her ODBC uygulamasıyla kullanabilirsiniz.
Bu anahtar sözcüğün bazı sonuçları SYSSCHEMA anahtar sözcüğünün sonuçlarına benzer; ancak, onun yerine CLISCHEMA kullanılmalıdır (geçerli olduğu yerlerde).
CLISCHEMA veri erişimi verimliliğini artırır: SYSSCHEMA ile kullanılan kullanıcı tanımlı çizelgeler DB2 kataloğu çizelgelerinin ikiz görüntüleridir ve ODBC sürücüsü, ODBC kullanıcısının istediği bilgileri üretmek için birden çok çizelgedeki satırları birleştirmek zorundadır. Ayrıca, CLISCHEMA kullanılması, katalog çizelgelerine ilişkin olarak daha az çekişme durumuna neden olur.
Bağlanmak istediğiniz DB2 Extended Enterprise Edition veritabanı bölümü sunucusunun hedef mantıksal düğümünü belirtmek için kullanılır. Bu anahtar sözcük (ya da öznitelik ayarı) DB2NODE ortam değişkeninin değerini geçersiz kılar. Belirlenebilecek değerler:
Bu değişken belirlenmezse, hedef mantıksal düğümün varsayılan değeri, makinede 0 kapısıyla tanımlanan mantıksal düğümdür.
Bu seçenek, varsayılan bağlantı tipini belirtmenize olanak tanır.
Bu anahtar sözcük, devingen SQL deyimlerinde işlev ve veri tipi göndermelerini çözmek için kullanılan yolu tanımlar. Çift tırnak imleri arasına yazılan ve virgülle birbirlerinden ayrılan bir ya da bir ya da birden çok şema adından oluşan bir liste içerir.
Varsayılan değer "SYSIBM","SYSFUN",X değeridir; X, çift tırnak içine alınan USER özel kaydının değeridir. SYSIBM şemasının belirtilmesi gerekmez. İşlev yolunda belirtilmezse, örtük olarak ilk şemanın bu olduğu varsayılır.
Bu anahtar sözcük, yürürlükteki kullanıcının şemasından başka bir şema adında tanımlanmış olabilecek nitelendirilmemiş işlev göndermelerini çözme işleminde kullanılır. İşlev adlarının çözülme sırasını şema adlarının sırası belirler. İşlevlerin çözülmesiyle ilgili ek bilgi için bkz: SQL Reference.
Bu seçenek, veritabanlarına her bağlantıdan sonra "SET CURRENT PACKAGESET şema" komutunu verir. Varsayılan ayar, bu yantümcenin eklenmemesidir.
Bu deyim, sonraki SQL deyimleri için kullanılacak paketin seçilmesini sağlayan şema adını (toplama tanıtıcısı) belirler.
CLI/ODBC uygulamaları devingen SQL deyimleri yayınlar. Bu seçeneği kullanarak, bu deyimlerin çalıştırılmasında kullanılan ayrıcalıkları denetleyebilirsiniz:
CLI/ODBC uygulamalarının SQL deyimleri, belirtilen şema altında çalışmaya ve burada tanımlanan ayrıcalıkları kullanmaya başlar.
SET CURRENT PACKAGESET komutuna ilişkin ek bilgi için bkz: SQL Reference.
Özet çizelgelere ve SET CURRENT REFRESH AGE deyimine ilişkin ek bilgi için SQL Reference kitabına bakın.
Bu anahtar sözcük için aşağıdaki değerlerden biri belirlenebilir:
Bu seçenek belirlendiyse, başarılı bir bağlantıdan sonra veritabanı yönetim sistemine (DBMS) bir SET CURRENT SCHEMA deyimi gönderilir. Böylece, son kullanıcı ya da uygulama SQL nesnelerini şema adıyla nitelemek zorunda kalmadan adlandırabilir.
SET CURRENT SCHEMA deyimine ilişkin ek bilgi için bkz: SQL Reference.
Bu seçenek belirlendiyse, bağlantı başarıyla kurulduktan sonra veritabanı yönetim sistemine bir SET CURRENT SQLID deyimi gönderilir. Böylece, son kullanıcı ya da uygulama SQL nesnelerini şema adıyla nitelemek zorunda kalmadan adlandırabilir.
Bu seçenek, hareketin tamamlanmasının açık geçici çizelgeleri nasıl etkilediğini denetler.
Not: | Hareketlerin her geriye işlenmesinde geçici çizelgeler yok edilir. |
Bu seçenek, SQL_CURSOR_COMMIT_BEHAVIOR ya da SQL_CURSOR_ROLLBACK_BEHAVIOR ile çağrıldığında SQLGetInfo() çağrısının davranışını etkiler. Geçici çizelge tutmanın desteklenmediği VSE ve VM için DB2 sistemleriyle kurulan bağlantılarda CURSORHOLD değeri yoksayılır.
Bu seçeneği, başarımı ayarlamak için kullanabilirsiniz. Uygulamanız için aşağıdaki noktalardan eminseniz, değeri geçici çizelgeyi tutma (0) olarak tanımlayabilirsiniz:
Hareket sonunda kaynakların korunması gerekmeyeceği için, veritabanı yönetim sistemi daha etkin çalışır.
Kütük DSN kullanırken, sunucuda bulunan, bağlantı kurulacak veritabanını belirtmek için bu seçeneği kullanmanız gerekir. Bu değerin, istemcide belirtilen herhangi bir veritabanı diğer adıyla bir ilgisi yoktur; sunucudaki veritabanı adı olarak belirlenmesi gerekir.
Bu ayar ancak PROTOCOL seçeneği TCPIP olarak belirlendiyse dikkate alınır.
Bu seçenek, DB2 CLI sürücüsüne DB2 Connect ya da DB2 DDCS ağ geçidinin hangi sürümünün kullanıldığını belirtmek için kullanılır. CLI sürücüsü bu bilgileri kullanarak, (örneğin, birden çok sonuç kümesi döndüren saklanmış yordamları destekleyerek) veri kaynağıyla etkileşimini eniyileyebilir.
5 = Sürüm 5 DB2 Connect ağ geçidi kullanıldığını belirtir (varsayılan).
2 = Sürüm 2 DB2 DDCS ağ geçidi kullanıldığını belirtir.
Bu seçenek yalnızca DB2 Sürüm 5.2 ya da daha yeni sunucular için geçerlidir. Varsayılan değer olan 0 dışında bir değer belirtilirse, başarılı bağlantılardan sonra DB2 CLI aşağıdaki SQL deyimini yayınlar:
SET CURRENT DEGREE değer
Bu, SQL deyimlerinin yürütülmesine ilişkin koşutluk derecesini belirler. ANY belirlendiğinde, koşutluk derecesini veritabanı yöneticisi belirler.
Ek bilgi için, belirtilen kitapta SET CURRENT DEGREE deyimine ilişkin açıklamalara bakın: SQL Reference
Bu seçenek, SQL sorgusu deyimiyle ilgili hazırlıkların sonunda DB2 CLI tarafından DB2 eniyileyicisinin döndürdüğü tahminleri bildiren bir iletişim kutusu görüntülenip görüntülenmeyeceğini belirler.
Grafik pencere eniyileme tahminlerini ve kullanıcıya bu sorguyu yürütmeye devam etme ya da sorguyu iptal etme olanağı sağlayan düğmeleri görüntüler.
DB2ESTIMATE için önerilen değer 60000'dir.
Bu seçenek yalnızca DB2 sürüm 2 ya da üstü veritabanlarıyla bağlantı kurulurken kullanılabilir. Pencere yalnızca grafik arabirimli uygulamalarda görüntülenebilir.
Bu seçenek kullanılırsa, DB2 CLI/ODBC DEFERREDPREPARE seçeneğinin kapalı olduğu varsayılır.
Bu anahtar sözcük, sunucunun anlık açıklama görünümü ve/ya da açıklama çizelgesi bilgileri yaratıp yaratmayacağını belirler.
Hem anlık açıklama görünümü, hem de açıklama çizelgesi bilgi yakalama olanaklarının geçersiz kılınması için sunucuya 'SET CURRENT EXPLAIN SNAPSHOT=NO' ve 'SET CURRENT EXPLAIN MODE=NO' deyimleri gönderilir.
Anlık açıklama görünümü olanağının etkinleştirilmesi ve açıklama çizelgesi bilgi yakalama olanağının geçersiz kılınması için sunucuya 'SET CURRENT EXPLAIN SNAPSHOT=YES' ve 'SET CURRENT EXPLAIN MODE=NO' deyimleri gönderilir.
Açıklama çizelgesi bilgi yakalama olanağının etkinleştirilmesi ve anlık açıklama görünümü olanağının geçersiz kılınması için sunucuya 'SET CURRENT EXPLAIN MODE=YES' ve 'SET CURRENT EXPLAIN SNAPSHOT=NO' deyimleri gönderilir.
Hem anlık açıklama görünümü, hem de açıklama çizelgesi bilgi yakalama olanaklarının etkinleştirilmesi için sunucuya 'SET CURRENT EXPLAIN MODE=YES' ve 'SET CURRENT EXPLAIN SNAPSHOT=YES' deyimleri gönderilir.
Açıklama bilgileri, bu bilgilerin üretilmesinden önce yaratılması gereken açıklama çizelgelerine yerleştirilir. Bu çizelgelere ilişkin ek bilgi için bkz: SQL Reference.
Yürürlükteki yetki kimliğinin, açıklama çizelgeleri için INSERT ayrıcalığı olması gerekir.
1. seçenek yalnızca sürüm 2.1.0 ya da üstü DB2 ortak sunucusu veritabanlarıyla bağlantı kurulurken, 2. ve 3. seçenek ise sürüm 2.1.1 ya da üstü DB2 ortak sunucusu veritabanlarıyla bağlantı kurulurken geçerlidir.
Bu seçenek belirtilirse, başarılı bağlantılardan sonra DB2 CLI aşağıdaki SQL deyimini yayınlar:
SET CURRENT QUERY OPTIMIZATION artı sayı
Bu, eniyileyicinin SQL sorgularını işlerken kullanacağı sorgu eniyileme düzeyini belirtir. Kullanılabilen eniyileme düzeylerine ilişkin bilgi için bkz: SQL Reference.
Bu anahtar sözcük, 8 tek byte karakterden uzun veri kaynağı adları kullanılmasına olanak tanır. Köşeli parantez içinde yazılan veri kaynağı adı, db2cli.ini kütüğündeki (ASCII biçiminde olduğu altyapılarda) ilgili bölümün başlığını oluşturur. Olağan koşullarda, bu bölüm başlığı, uzunluğu en çok 8 byte olabilen veritabanı diğer adıdır. Veri kaynağı için daha uzun ve daha anlamlı bir ad kullanılmak istendiğinde, bu ad bölüm başlığı olarak yazılıp CATALOG komutunda kullanılan veritabanı diğer adı için de bu anahtar değer tanımlanabilir. Aşağıda bir örnek gösterilmektedir:
; Uzun ad, 8 tek byte karakterli veritabanı diğer adına eşlenir [Anlamlıad] DBALIAS=DB2DBT10
Veritabanının gerçek diğer adının DB2DBT10 olmasına karşın, son kullanıcı bağlantı kurulurken veri kaynağı için [Anlamlıad] adını belirtebilir.
16 bit Windows ODBC ortamında, ODBC.INI kütüğünün [ODBC DATA SOURCES] girişinin altındaki, aşağıda belirtilen satır da, uzun diğer ad (veritabanıadı) kullanılarak güncellenmelidir.
< diğerad >=IBM DB2 ODBC DRIVER
Bu seçenek yalnızca MVS/ESA için DB2 ile bağlantı kurulurken ve yalnızca uygulama (temel) çizelge kataloğu bilgilerini istediğinde kullanılır. MVS/ESA için DB2 altsisteminde çok sayıda çizelge varsa, uygulamanın çizelge bilgilerini sorgulama süresini ve listelediği çizelge sayısını azaltmak için veritabanıadı belirtilebilir.
Bu değer belirtilirse, CREATE DATABASE gibi çeşitli deyimlerin sonuna IN DATABASE veritabanıadı deyimi eklenir.
Bu değer, MVS/ESA için DB2 sisteminin katalog çizelgelerindeki DBNAME kolonuyla eşlenir. Değer belirtilmezse ya da TABLETYPE ile görünümler, eşanlamlılar, sistem çizelgeleri ya da diğer adlar da belirtilirse, yalnızca çizelge bilgileri sınırlandırılır; görünümler, diğer adlar ve eşanlamlılar DBNAME ile sınırlandırılmaz. Hakkında bilgi döndürülecek çizelgelerin sayısını daha da sınırlandırmak için, bu seçenek SCHEMALIST ve TABLETYPE ile birlikte kullanılabilir.
Bu seçenek yalnızca geçici olarak kullanılmalı; genel olarak saklanmış yordam kataloğu çizelgesi kullanılmalıdır. Ek bilgi için bkz: SQL Reference.
Bu seçenekte gösterilen kitaplık, açık olarak bir kitaplık belirtilmeyen tüm saklanmış yordam çağrılarında kullanılır. Sunucu makinede bir yer belirttiğiniz için, yol biçimi istemcinin işletim sistemine göre değil, sunucunun işletim sistemine göre yazılmalıdır. Ek bilgi için, belirtilen kitapta CALL deyimine ilişkin açıklamalara bakın: SQL Reference
Örneğin, saklanmış yordamlar sunucudaki d:\terry\proclib\comstor kitaplık kütüğünde bulunuyorsa, DEFAULTPROCLIBRARY için d:\terry\proclib\comstor değerini tanımladıktan sonra, func adlı saklanmış yordamı kitaplık belirtmeden çağırabilirsiniz. Bu durumda oluşan SQL deyimi şöyledir:
CALL d:\terry\proclib\comstor!func
İlgili yürütme isteği yayınlanıncaya kadar PREPARE isteğinin gönderilmesini erteler. Sonra, ağdaki veri trafiğini en alt düzeye indirmek ve başarımı artırmak için, iki istek tek bir komut/yanıt akışına dönüştürülür.
Varsayılan davranış DB2 sürüm 2'den değişiktir. Artık varsayılan değer hazırlığın ertelenmesidir ve gereken durumlarda belirtik olarak bunun geçersiz kılınması gerekir.
Hedef DB2 ortak sunucusu veritabanı ya da DDCS ağ geçidi hazırlık ertelemeyi desteklemiyorsa, istemci bu bağlantı için hazırlık ertelemeyi geçersiz kılar.
Not: | Hazırlık erteleme etkinleştirildiğinde, PREPARE deyiminin SQLCA'sının SQLERRD(3) ve SQLERRD(4) alanlarında döndürdüğü satır ve maliyet tahminleri sıfır olabilir. Bu, SQL deyiminin işlenmesini sürdürüp sürdürmemeye karar vermek için bu değerleri kullanmak isteyen kullanıcılar açısından uygun olmayabilir. |
CLI/ODBC DB2ESTIMATE seçeneği için sıfırdan farklı bir değer tanımlanırsa bu seçenek geçersiz kılınır.
CLI/ODBC sürücüsü koşutzamanlı birden çok iş parçacığını destekleyebilir.
Bu seçenek, birden çok iş parçacığı desteğini etkinleştirmek ya da geçersiz kılmak için kullanılır.
Birden çok iş parçacığı kullanımı geçersiz kılınırsa, tüm iş parçacığı çağrıları işlem düzeyinde diziselleştirilir. Bu ayarı, DB2 Sürüm 2 ürünün diziselleştirilmiş davranışına gerek duyan çok iş parçacıklı uygulamalar için kullanın.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Bu seçenek, istemciye son kayıt gönderildikten sonra istemcideki geçici çizelge kapatılmadan sunucudaki geçici çizelgenin otomatik olarak kapatılıp kapatılmayacağını belirler.
CLI/ODBC sürücüsü geçici çizelgenin zaten kapatılmış olduğunu bildiği için, geçici çizelgenin kapatılması için belirtik bir deyim yayınlaması gerekmez ve böylece ek bir ağ isteğinde bulunmamış olur.
Bu seçeneğin etkinleştirilmesiyle, birçok küçük sonuç kümesi kullanan uygulamalara hız kazandırılabilir.
EARLYCLOSE özelliği aşağıdaki koşullarda kullanılmaz:
Not: | Bu seçenek istenen herhangi bir zamanda tanımlananabilir, ancak kullanılan seçenek değeri deyim yürütülürken (geçici çizelge açıldığında) geçerli olan değerdir. |
Bu seçenek, uygulama bir çizelge ya da kolon ayrıcalıkları listesi alırken döndürülen veri miktarını azaltmak için kullanılabilir. Belirtilen yetki kimlikleri süzgeç olarak kullanılır; yalnızca bu kimliklere TANINAN ayrıcalıklara sahip olan çizelgeler ya da kolonlar döndürülür.
Bu seçenek için ayrıcalık tanınmış bir ya da birden çok yetki kimliğini belirtirken, kimlikleri tek tırnak imleri arasına yazın ve girişleri virgül imleriyle birbirlerinden ayırın. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
GRANTEELIST=" 'KLNC1', 'KLNC2', 'KLNC8' "
Yukarıdaki örnekte, uygulama belirli bir çizelgeye ilişkin bir ayrıcalıklar listesi alırken, yalnızca KLNC1, KLNC2 ya da KLNC8'e TANINAN ayrıcalıkları olan kolonlar döndürülür.
Bu seçenek, uygulama bir çizelge ya da kolon ayrıcalıkları listesi alırken döndürülen veri miktarını azaltmak için kullanılabilir. Belirtilen yetki kimlikleri süzgeç olarak kullanılır; yalnızca bu kimliklerin TANIDIĞI ayrıcalıklara sahip olan çizelgeler ya da kolonlar döndürülür.
Bu seçenek için ayrıcalık tanımış bir ya da birden çok yetki kimliğini belirtirken, kimlikleri tek tırnak imleri arasına yazın ve girişleri virgül imleriyle birbirlerinden ayırın. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
GRANTORLIST=" 'KLNC1', 'KLNC2', 'KLNC8' "
Yukarıdaki örnekte, uygulama belirli bir çizelgeye ilişkin bir ayrıcalıklar listesi alırken, yalnızca KLNC1, KLNC2 ya da KLNC8'in TANIDIĞI ayrıcalıkları olan kolonlar döndürülür.
Bu seçenek uygulamanın birbiriyle ilişkili iki bilgi parçasını nasıl döndüreceğini denetler:
Kullanıma hazır gelen birçok uygulama bu veri tipini tanımadığı ve doğru biçimde işleyemediği için, varsayılan ayar GRAPHIC tipinin döndürülmemesidir.
Bu seçeneği, bu istemci makinenin DB2 çalıştıran bir sunucuyla TCP/IP bağlantısı kurması için gereken öznitelikleri belirtmek üzere, SERVICENAME seçeneğiyle birlikte kullanın. Bu iki değer ancak PROTOCOL seçeneği TCPIP olarak belirlendiyse dikkate alınır.
Sunucu sistemin anasistem adını ya da IP adresini belirtin.
Çok seyrek görülmekle birlikte, uygulamalar zaman zaman uyarı iletilerini doğru işleyemeyebilir. Bu seçenek, veritabanı yöneticisinden gelen uyarıların uygulamaya aktarılmayacağını belirtmek için kullanılabilir.
Bu seçenek kendi başına kullanılabildiği gibi, CLI/ODBC yapılanışına ilişkin WARNINGLIST anahtar sözcüğüyle birlikte de kullanılabilir.
Bir uygulamanın bazı uyarı iletilerini doğru işleyemeyebileceği, ancak tüm ileti uyarılarının yoksayılmasının istenmediği, çok sık rastlanmayan durumlarda. Bu anahtar sözcük, hangi uyarıların uygulamaya aktarılmayacağını belirtmek için kullanılabilir. IGNOREWARNINGS anahtar sözcüğü, tüm veritabanı yöneticisi uyarıları yoksayılacaksa kullanılmalıdır.
Bir sqlstate hem IGNOREWARNLIST, hem de WARNINGLIST anahtar sözcüğünde yer alıyorsa, tümüyle yoksayılır.
Her sqlstate büyük harfle belirtilmeli, tek tırnak içine alınmalı ve virgülle ayrılmalıdır. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
IGNOREWARNLIST="'01000', '01004','01504'"
0 = Veritabanı bağlantıları önbelleğe alınmaz (varsayılan).
Bu seçenek için sıfırdan büyük bir değer tanımlanması, aynı veritabanıyla, aynı bağlantı bilgilerini kullanarak sürekli bağlantı kuran ve kesen uygulamaları hızlandırabilir.
Her seferinde bağlantıyı kapatmak ve sonra yeniden açmak yerine, CLI/ODBC sürücüsü bağlantıyı açık tutar ve bağlantı bilgilerini önbelleğe alır. İkinci kez aynı veritabanıyla bağlantı kurma isteği geldiğinde, varolan bağlantı kullanılır. Bu, ilk bağlantıyı kapatmanın ve ikinci bağlantıyı yeniden kurmanın gerektirdiği zamandan, kaynaklardan ve iletişim ağı trafiğinden tasarruf edilmesini sağlar.
Bu seçenek için tanımlanan değer, önbelleğe alınacak bağlantı sayısını gösterir. Tanımlanabilecek değerin sistem kaynakları dışında hiçbir etmenle sınırlı olmamasına karşın, bu olanaktan yarar sağlayacak uygulamalar için genellikle 1 ya da 2 değeri yeterli olur.
Varsayılan ayar olarak, 5 deyim tanıtıcısı önbelleğe alınır. Bir deyim tanıtıcısı kapatıldığında, bu tanıtıcı için kullanılan bellek başka bir işleve ayrılmaz ve bir sonraki deyim tanıtıcısı ayırmasında kullanılır.
Bu seçenek için tanımlanan değer, önbelleğe alınacak deyim tanıtıcısı sayısını gösterir. Deyim önbelleği için kullanılan bellek miktarını belirtik olarak azaltmak için 5'ten küçük bir değer tanımlanabilir. Büyük deyim kümeleri açan, kapatan ve sonra yeniden açan uygulamaların başarımını artırmak için 5'ten büyük değerler kullanılabilir.
Önbelleğe alınan deyim sayısının üst sınırı, sistem kaynakları tarafından belirlenir.
Bu seçenek, SQL_CLOB, SQL_BLOB ve SQL_DBCLOB SQL veri tipleri için COLUMN_SIZE kolonuna ilişkin olarak SQLGetTypeInfo() tarafından döndürülen 2 Gigabyte (DBCLOB için 1 GB) değerini geçersiz kılar. Bundan sonraki LOB kolonu içeren CREATE TABLE deyimleri, varsayılan değer yerine burada belirttiğiniz kolon büyüklüğü değerini kullanır.
DB2 CLI, büyük nesne (LOB) kolonları olan veritabanlarıyla çalışırken
uygulamanın hangi veri tipini beklediğini bu seçeneğe bakarak anlar.
Veritabanı veri tipi | Büyük nesneler (0--Varsayılan) | Uzun veri tipleri (1) |
---|---|---|
CLOB | SQL_CLOB | SQL_LONGVARCHAR |
BLOB | SQL_BLOB | SQL_LONGVARBINARY |
DBCLOB | SQL_DBCLOB | SQL_LONGVARGRAPHIC |
Bu seçenek, büyük nesne veri tiplerini işleyemeyen ODBC uygulamaları çalıştırılırken yararlıdır.
Veri için bildirilen varsayılan büyüklüğü azaltmak için, bu seçenekle birlikte DB2 CLI/ODBC LOBMAXCOLUMNSIZE seçeneği de kullanılabilir.
Bu seçenek, her bir CLI/ODBC uygulaması için izin verilen bağlantı sayısı üst sınırını belirtmek için kullanılır. Bu değer, denetimcilerin her bir uygulamanın kurabileceği bağlantı sayısını sınırlamalarını sağlayan bir denetim öğesi olarak kullanılabilir. Bağlantı sayısının sınırsız olduğunu belirtmek için 0 değeri kullanılabilir; bu koşulda uygulama sistem kaynaklarının elverdiği sayıda bağlantı açabilir.
OS/2 ve WIN32 altyapılarında (Windows NT ve Windows 95), NetBIOS protokolü kullanılıyorsa, bu değer uygulama tarafından koşutzamanlı olarak kurulacak bağlantıların (NetBIOS oturumları) sayısına karşılık gelir. OS/2 NetBIOS için geçerli değer aralığı 1 - 254 arasıdır. 0 belirtildiğinde (varsayılan) 5 ayrılmış bağlantı kurulabilir. Ayrılmış NetBIOS oturumları başka uygulamalar tarafından kullanılamaz. Bu değiştirgede belirtilen bağlantı sayısı, DB2 NetBIOS protokolünün uzak sunucuya bağlanmak için kullandığı tüm bağdaştırıcılar için geçerli olur (NetBIOS düğümlerinde bağdaştırıcı numarası düğüm dizininde belirtilir).
CONNECT kipini SHARE ya da EXCLUSIVE olarak tanımlar. Uygulama tarafından bağlantı sırasında bir kip belirtilirse, bu değer yoksayılır. Varsayılan tanım SHARE'dir.
Not: | DRDA bağlantılarında EXCLUSIVE değeri kullanılamaz. CONNECT deyimine ilişkin ek bilgi için bkz: SQL Reference. |
Bu seçenek, SQLConnect() isteklerinin fiziksel veritabanı bağlantılarıyla nasıl eşleneceğini belirtmek için kullanılır.
MULTICONNECT 0 değerine ayarlanırsa, DISABLEMULTITHREAD anahtar sözcüğü kullanılarak çoklu iş parçacığı kullanımı devre dışı bırakılmalıdır.
Not: | MULTICONNECT kapalı olarak tanımlanırsa, tüm deyimler aynı bağlantıda, dolayısıyla aynı hareket içinde yürütülür. Bu da, geriye işlemenin tüm bağlantılardaki TÜM deyimleri geriye işlemesi sonucunu doğurur. MULTICONNECT için kapalı değerini tanımlamadan önce, uygulamanın bu değerle çalışıp çalışamayacağını denetleyin. Tersi durumda, uygulama doğru çalışmayabilir. |
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Bu seçenek, her SELECT deyiminin sonuna "OPTIMIZE FOR n ROWS" yantümcesini ekler (n, 0'dan büyük tamsayıları belirtir). Değeri 0 olarak tanımlanırsa (varsayılan), bu yantümce eklenmez.
OPTIMIZE FOR n ROWS yantümcesinin sonuçlarına ilişkin ek bilgi için bkz: Administration Guide.
OPTIMIZESQLCOLUMNS açık olarak ayarlanırsa (1 değeri belirtilirse), belirtik (genel karakter değil) bir şema adı, belirtik bir çizelge adı ve kolon adı için % (tüm kolonlar) belirtilmesi durumunda, tüm SQLColumns() çağrıları eniyilenir. DB2 CLI/ODBC sürücüsü bu çağrıyı eniyilediğinde sistem çizelgeleri taranmaz. Çağrı eniyilenirse, kolonlara ilişkin varsayılan dizgiyi içeren COLUMN_DEF bilgileri döndürülmez. Bir AS/400 veritabanıyla bağlantı kurulurken, veri tipi NUMERIC olan kolonlar için SQLColumns() çağrısının döndürdüğü bilgiler yanlış olur. Uygulamanın bu bilgilere gereksinimi yoksa, başarımı artırmak için eniyileme açık olarak ayarlanabilir.
Uygulamanın COLUMN_DEF bilgilerine gereksinimi varsa, OPTIMIZESQLCOLUMNS 0 değerine ayarlanmalıdır. Varsayılan değer budur.
Bu anahtar sözcük, ODBC uygulamalarındaki bilinen sorunlar için bir geçici çözüm belirtilmesinde kullanılır. Hiç geçici çözüm kullanılmayacağını, bir tane kullanılacağını ya da birden çok kullanılacağını belirten değerler kullanabilirsiniz. Burada belirtilen yama değerleri, belirtilebilecek diğer PATCH2 değerleriyle birlikte kullanılır.
DB2 CLI/ODBC Ayarlar defterinden yararlanarak, kullanılacak bir ya da birden çok yama seçebilirsiniz. Değerleri db2cli.ini kütüğünün içinden tanımlıyor ve birden çok yama değeri kullanmak istiyorsanız, anahtar sözcüğün değerini oluşturmak için istediğiniz değerleri toplamanız yeterlidir. Örneğin, 1, 4 ve 8 yamalarını istiyorsanız, PATCH1=13 tanımını yapmanız gerekir.
DB2 CLI/ODBC Ayarları defterinde bir değer listesi vardır. Bu değer listesinin güncellenmesine ilişkin bilgi için, DB2 klasöründeki Hizmet klasörünü seçin. Bu bilgileri BENİ OKU kütüğünde de bulabilirsiniz (kullandığnız altyapı için yürürlükte herhangi bir yama değeri yoksa, BENİ OKU kütüğünde bununla ilgili bir bölüm bulunmaz).
Bu anahtar sözcük, CLI/ODBC uygulamalarındaki bilinen sorunlar için bir geçici çözüm belirtilmesinde kullanılır. Hiç geçici çözüm kullanılmayacağını, bir tane kullanılacağını ya da birden çok kullanılacağını belirten değerler kullanabilirsiniz. Burada belirtilen yama değerleri, belirtilebilecek diğer PATCH1 değerleriyle birlikte kullanılır.
Birden çok yama belirtirken, değerler virgülle birbirinden ayrılan dizgiler olarak girilir (PATCH1 seçeneğinde ise, değerler birbirine eklenerek toplamları kullanılır).
PATCH2 değeri olarak 3, 4 ve 8'i ayarlamak için şunu belirtmeniz gerekir:
PATCH2="3, 4, 8"
PATCH2 değerleri BENİ OKU kütüğündedir (bu altyapıya ilişkin yürürlükte hiçbir yama değeri yoksa BENİ OKU kütüğünde bununla ilgili bölüm bulunmaz).
DB2 CLI tarafından oluşturulan ve SQLGetDiagRec() ya da SQLError() çağrıları kullanılarak alınabilen her hatada bir ileti kutusu görüntüler. Kullanıcılara iletilerle bilgi vermeyen uygulamalardaki hataların ayıklanması için yararlıdır.
Kütük DSN kullanılırken desteklenen tek protokol TCP/IP'dir. Seçeneği TCPIP dizgisine (eğik çizgi kullanmadan) ayarlayın.
Bu seçenek belirlendiğinde aşağıdaki seçeneklerin de belirlenmesi gerekir:
Bu parola değeri, bağlantı sırasında uygulama tarafından bir parola verilmediğinde kullanılır.
Parola düz metin olarak saklandığı için güvenli değildir.
Bir uygulama SQL_ATTR_QUERY_TIMEOUT deyim özniteliğini tanımlamak için SQLSetStmtAttr() işlevini kullanabilir. Bu öznitelik, uygulamaya dönmeden önce SQL deyiminin yürütülmesi için kaç saniye bekleneceğini gösterir.
QUERYTIMEOUTINTERVAL yapılanış anahtar sözcüğü, CLI sürücüsünün sorgunun tamamlanıp tamamlanmadığını saptamaya yönelik denetimler arasında ne kadar bekleyeceğini belirtir.
Örneğin, SQL_ATTR_QUERY_TIMEOUT değerinin 25 saniye (25 saniye bekledikten sonra zamanaşımına uğrat), QUERYTIMEOUTINTERVAL değerinin 10 saniye (sorguyu 10 saniyede bir denetle) olarak ayarlandığını varsayalım. Sorgu 30 saniye sonra (25 saniye sınırından sonraki ilk denetimde) zamanaşımına uğratılır.
SQL_ATTR_QUERY_TIMEOUT için çok küçük bir değer belirlendiği ve sorgunun zamanaşımına UĞRATILMAMASI gerektiği durumlar olabilir. Uygulamada değişiklik yapılamıyorsa (örneğin, başka bir firmanın ODBC uygulamasıysa), QUERYTIMEOUTINTERVAL 0 değerine ayarlanabilir; böylece CLI sürücüsü SQL_ATTR_QUERY_TIMEOUT ayarını yoksayar.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
SCHEMALIST, veritabanı yönetim sistemindeki her çizelgeyi listeleyen uygulamalar için daha sınırlı bir varsayılan değer tanımlayarak başarımı iyileştirmek için kullanılır.
Veritabanında tanımlı çok sayıda çizelge varsa, uygulamanın çizelge bilgilerini sorgulama süresini ve listelediği çizelgelerin sayısını azaltmak için bir şema listesi belirtilebilir. Şema adları büyük/küçük harfe duyarlıdır ve tek tırnak imleri arasına yazılmaları gerekir. Girişler virgül imiyle ayrılmalıdır. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
SCHEMALIST="'KLNC1','KLNC2','KLNC3'"
MVS/ESA için DB2, bu listeye tırnak imi kullanılmadan CURRENT SQLID de eklenebilir, örneğin:
SCHEMALIST="'KLNC1',CURRENT SQLID,'KLNC3'"
Dizginin uzunluğu en çok 256 karakter olabilir.
Hakkında bilgi döndürülecek çizelgelerin sayısını daha da sınırlandırmak için bu seçenek DBNAME ve TABLETYPE ile birlikte de kullanılabilir.
Bu seçeneği, bu istemci makinenin DB2 çalıştıran bir sunucuyla TCP/IP bağlantısı kurması için gereken öznitelikleri belirtmek üzere, HOSTNAME seçeneğiyle birlikte kullanın. Bu iki değer ancak PROTOCOL seçeneği TCPIP olarak belirlendiyse dikkate alınır.
Sunucu sistemin hizmet adını ya da kapı numarasını belirtin.
POPUPMESSAGE seçeneğiyle birlikte kullanın. Bu, DB2 CLI tarafından tanımlanan durumlarla ilgili hata iletilerinin görüntülenmesini engeller.
Her bir SQLSTATE durumu büyük harflerle ve tek tırnak imleri arasına yazılmalıdır. Girişler virgüllerle ayrılmalıdır. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
SQLSTATEFILTER=" 'HY1090', '01504', '01508' "
Bu anahtar sözcük, yakalama kütüğü adını ve isteğe bağlı olarak, bu kütüğün saklanacağı dizini belirtmek için kullanılır.
CLI/ODBC uygulamalarının durağan SQL olarak çalıştırılması konusunda ek bilgi için STATICMODE anahtar sözcüğüne bakın.
Bu anahtar sözcük, durağan tanıtım günlüğü kütüğü adını ve isteğe bağlı olarak, bu kütüğün saklanacağı dizini belirtmek için kullanılır.
CLI/ODBC uygulamalarının durağan SQL olarak çalıştırılması konusunda ek bilgi için STATICMODE anahtar sözcüğüne bakın.
Bu seçenek, bu DSN için CLI/ODBC uygulaması tarafından yayınlanan SQL deyimlerinin nasıl işleneceğini belirtmenizi sağlar.
CLI/ODBC uygulamalarının durağan SQL olarak çalıştırılması konusunda ek bilgi için Yayın Notları'na (Release Notes) ve CLI Guide and Reference belgesine bakın. Internet üzerinde http://www.ibm.com/software/data/db2/udb/staticcli adresinde de ek bilgi bulunabilir.
Bu anahtar sözcük, uygulama eşleştirme (Match) kipinde çalışırken kullanılacak paketi belirtmek için kullanılır. Önce, yakalama kütüğünü yaratmak için yakalama (Capture) kipini kullanmanız gerekir.
Belirtilen paket adının yalnızca ilk 7 karakteri kullanılır. Her yalıtma düzeyini belirtmek için tek byte'lık bir sonek eklenir:
CLI/ODBC uygulamalarının durağan SQL olarak çalıştırılması konusunda ek bilgi için STATICMODE anahtar sözcüğüne bakın.
Çok veritabanlı (DUOW) bağlantılarda kesinleştirme ve geriye işleme işlemlerinin eşgüdümünün nasıl sağlanacağını belirtmek için bu seçeneği kullanın. Yalnızca bağlantı tipi eşgüdümlü bağlantı (CONNECTTYPE = 2) olarak tanımlandığında kullanılabilir.
İki aşamalı kesinleştirme için hareket yöneticisi kullanılmaz, ancak birden çok veritabanında gerçekleşen hareketlerde yapılan işleri kesinleştirmek için tek aşamalı kesinleştirme kullanılır.
Bu özelliği destekleyen veritabanları arasında iki aşamalı kesinleştirmelerin eşgüdümünü sağlamak için bir hareket yöneticisi kullanılması gerekir.
Bu seçenek, sistem kataloğu bilgilerini almak için DB2 CLI ve ODBC katalog işlevi çağrıları yayınlandığında SYSIBM (ya da SYSTEM, QSYS2) şemalarının yerine aranacak diğer bir şemayı belirtir.
Sistem denetimcisi bu şemayı kullanarak, aşağıdaki sistem kataloğu
çizelgelerinin her biri için, satır altkümelerinden oluşan bir görünüm kümesi
tanımlayabilir:
DB2 Universal Database | MVS/ESA için DB2 | VSE ve VM için DB2 | OS/400 | AS/400 için DB2 Universal Database |
---|---|---|---|---|
SYSTABLES | SYSTABLES | SYSCATALOG | SYSTABLES | SYSTABLES |
SYSCOLUMNS | SYSCOLUMNS | SYSCOLUMNS | SYSCOLUMNS | SYSCOLUMNS |
SYSINDEXES | SYSINDEXES | SYSINDEXES | SYSINDEXES | SYSINDEXES |
SYSTABAUTH | SYSTABAUTH | SYSTABAUTH |
| SYSCST |
SYSRELS | SYSRELS | SYSKEYCOLS |
| SYSKEYCST |
SYSDATATYPES | SYSSYNONYMS | SYSSYNONYMS |
| SYSCSTCOL |
SYSPROCEDURES | SYSKEYS | SYSKEYS |
| SYSKEYS |
SYSPROCPARMS | SYSCOLAUTH | SYSCOLAUTH |
| SYSREFCST |
| SYSFOREIGNKEYS |
|
|
|
| SYSPROCEDURES 1 |
|
|
|
| SYSDATABASE |
|
|
|
Örneğin, sistem kataloğu çizelgelerine ilişkin görünüm kümesi ACME adlı şemadaysa, SYSIBM.SYSTABLES ile ilgili görünüm ACME.SYSTABLES olur ve SYSSCHEMA için ACME değerinin tanımlanması gerekir.
Sistem kataloğu çizelgeleri için sınırlı görünümler tanımlanması ve kullanılması, uygulamanın listelediği çizelgelerin sayısını azaltır ve böylelikle çizelge bilgilerini sorgulama süresi de kısalır.
Değer belirtilmediğinde şu varsayılanlar kullanılır:
Hakkında bilgi döndürülecek çizelgelerin sayısını daha da sınırlandırmak için, bu anahtar sözcük SCHEMALIST ve TABLETYPE (ve MVS/ESA için DB2 üzerinde DBNAME) ile birlikte de kullanılabilir.
Veritabanında tanımlı çok sayıda çizelge varsa, uygulamanın çizelge bilgilerini sorgulama süresini ve listelediği çizelgelerin sayısını azaltmak için bir çizelge tipi dizgisi belirtilebilir.
İstenen sayıda değer belirtilebilir. Tipler büyük harfle, tek tırnak imleri arasına yazılmalı ve girişler virgüllerle ayrılmalıdır. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
TABLETYPE="'TABLE','VIEW'"
Hakkında bilgi döndürülecek çizelgelerin sayısını daha da sınırlandırmak için bu seçenek DBNAME ve SCHEMALIST ile birlikte de kullanılabilir.
TABLETYPE, veritabanındaki çizelge, görünüm, diğer ad ve eşanlamlıların listesini alan DB2 CLI işlevi için bir varsayılan liste tanımlanmasında kullanılabilir. Uygulamanın işlev çağrısında çizelge tipi belirtmemesi ve bu anahtar sözcüğün kullanılmaması durumunda, tüm çizelge tiplerine ilişkin bilgiler döndürülür. Uygulamanın işlev çağrısında çizelge tipi için bir değer belirtmesi durumunda, bu bağımsız değişken anahtar sözcük için tanımlanan değeri geçersiz kılar.
TABLETYPE anahtar sözcüğü TABLE dışında bir değer içerdiğinde, bilgileri belirli bir MVS/ESA için DB2 veritabanıyla sınırlandırmak için DBNAME anahtar sözcüğü ayarı kullanılamaz.
Büyük nesnelerle (CLOB, BLOB vb.) çalışılırken, genellikle istemci makinede bilgilerin saklanması için geçici bir dizin yaratılır. Bu seçeneği kullanarak bu geçici kütüklerin saklanacağı yeri belirtebilirsiniz. Hiçbir değer belirtilmezse sistemin geçici dizini kullanılır.
Anahtar sözcük, db2cli.ini kütüğünün veri kaynaklarına özgü bölümüne yerleştirilir. Sözdizimi şöyledir:
Bir büyük nesneye erişildiğinde, yol adı geçersizse ya da belirtilen dizinde geçici kütükler yaratılamazsa SQLSTATE HY507 döndürülür.
Bu seçenek için açık (1) değeri tanımlandığında, CLI/ODBC izleme kayıtları TRACEFILENAME yapılanış değiştirgesinde belirtilen kütüğe ya da TRACEPATHNAME yapılanış değiştirgesinde belirtilen altdizindeki kütüklere eklenir.
Örneğin, her bir izleme girişinden sonra diske yazılan bir CLI/ODBC izleme kütüğü oluşturmak için aşağıdaki tanımlar yapılabilir:
[COMMON] TRACE=1 TRACEFILENAME=E:\TRACES\CLI\MONDAY.CLI TRACEFLUSH=1
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
TRACECOMM açık olarak ayarlandığında (1 değeri), izleme kütüğüne her ağ isteğine ilişkin bilgiler eklenir.
Bu seçenek yalnızca CLI/ODBC TRACE seçeneği açık olduğunda kullanılır. See the TRACE for an example.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Belirtilen kütük yoksa yaratılır; tersi durumda yeni izleme bilgileri kütüğün sonuna eklenir.
Geçersiz bir kütük adı belirtilmesi, kütüğün yaratılamaması ya da kütüğe yazılamaması durumunda, izleme yapılmaz ve hiçbir hata iletisi döndürülmez.
Bu seçenek yalnızca TRACE seçeneği açık olduğunda kullanılır. CLI/ODBC yapılanış yardımcı programında bu seçeneği belirttiğinizde bu işlem otomatik olarak yapılır.
Çeşitli izleme ayarlarına ilişkin bir kullanım örneği için TRACE seçeneğine bakın. Bu seçenek belirtilirse, TRACEPATHNAME seçeneği yoksayılır.
DB2 CLI izlemesi yalnızca hata ayıklama için kullanılmalıdır. CLI/ODBC sürücüsünün yavaşlamasına neden olabilir ve uzun süreyle izleme yapılırsa izleme bilgileri oldukça fazla yer kaplayabilir.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Her bir izleme girişinin diske yazılmasını zorlamak için bu seçeneği açık olarak tanımlayın (TRACEFLUSH = 1). Bu, izleme işlemini yavaşlatır, ancak uygulamanın bir sonraki deyime geçmesinden önce her bir girişin diske yazılmasını güvence altına alır.
Bu seçenek yalnızca CLI/ODBC TRACE seçeneği açık olduğunda kullanılır. See the TRACE option for an example.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Aynı DLL kütüğünü ya da paylaşılan kitaplığı kullanan her bir iş parçacığı ya da işlem, belirtilen dizinde bir DB2 CLI/ODBC izleme kütüğü yaratır.
Geçersiz bir altdizin adı belirtilmesi ya da altdizine yazılamaması durumunda, izleme yapılmaz ve hiçbir hata iletisi döndürülmez.
Bu seçenek yalnızca TRACE seçeneği açık olduğunda kullanılır. CLI/ODBC yapılanış yardımcı programında bu seçeneği belirttiğinizde bu işlem otomatik olarak yapılır.
Çeşitli izleme ayarlarına ilişkin bir kullanım örneği için TRACE seçeneğine bakın. DB2 CLI/ODBC TRACEFILENAME seçeneği kullanılırsa, bu seçenek yoksayılır.
DB2 CLI izlemesi yalnızca hata ayıklama için kullanılmalıdır. CLI/ODBC sürücüsünün yavaşlamasına neden olabilir ve uzun süreyle izleme yapılırsa izleme bilgileri oldukça fazla yer kaplayabilir.
(Bu seçenek, kullanıma hazırlama kütüğünün Common (ortak) bölümünde yer alır ve bu nedenle tüm DB2 bağlantıları için geçerlidir.)
Yalıtma düzeyini aşağıdakilerden biri olarak tanımlar:
Parantez içindeki değerler, SQL92 yalıtma düzeyleri için IBM'in kullandığı eşdeğer terimleri belirtir. Kesinleştirme yok değerinin, SQL92 yalıtma düzeylerinden olmadığına ve yalnızca AS/400 için DB2 Universal Database üzerinde desteklendiğine dikkat edin. Yalıtma düzeylerine ilişkin ek bilgi için bkz: SQL Reference.
Bu anahtar sözcük yalnızca, varsayılan yalıtma düzeyi kullanıldığında geçerlidir. Uygulama yalıtma düzeyini özel olarak belirlediğinde bu anahtar sözcük etkisizdir.
Bu kullanıcıkimliği değeri, bağlantı sırasında uygulama tarafından bir kullanıcı kimliği verilmediğinde kullanılır.
Bu seçenek, altçizgi karakterinin ("_") genel arama karakteri olarak (kendi geçmediği dizgiler de içinde olmak üzere, dizgide yazıldığı yerde bulunan her karakterle eşleşecek biçimde) ya da kendi anlamında kullanılmasını belirler. Yalnızca arama örüntüsü dizgilerini kabul eden katalog işlevi çağrılarını etkiler.
Altçizgi, herhangi bir karakterle eşleşen ya da kendisinin geçmediği dizgileri de bulabilen bir genel arama karakteri olarak işlenir. Örneğin, aşağıdaki iki çizelge tanımlandığında:
CREATE TABLE "OWNER"."KEY_WORDS" (COL1 INT) CREATE TABLE "OWNER"."KEYWORDS" (COL1 INT)
Çizelge bilgilerini döndüren DB2 CLI katalog işlevi çağrısı (SQLTables()), çizelge adı arama örüntüsü bağımsız değişkeni olarak "KEY_WORDS" belirtildiğinde yukarıdaki çizelge girişlerinin ikisini de döndürür.
Altçizgi, altçizgi karakteri olarak işlenir. Yukarıdaki örnekte tanımlanan çizelgeler düşünüldüğünde, çizelge adı arama örüntüsü bağımsız değişkeni olarak "KEY_WORDS" belirtildiğinde, SQLTables() yalnızca "KEY_WORDS" girişini döndürür.
Veritabanındaki nesne adlarının (sahip, çizelge, kolon) altçizgi karakteri içerdiği durumlarda, bu anahtar sözcük için 0 değerinin tanımlanması başarımı iyileştirebilir.
Not: | Bu anahtar sözcük yalnızca 2.1 öncesi DB2 ortak sunucusu sürümlerini etkiler. Daha sonraki sürümler ve diğer tüm DB2 sunucuları için, LIKE karşılaştırma belirtimine ilişkin ESCAPE yantümcesi kullanılabilir. ESCAPE yantümcesine ilişkin ek bilgi için bkz: SQL Reference. |
Hata olarak döndürülen SQLSTATE durumlarından istediğiniz kadarını uyarılara indirgeyebilirsiniz. Bu girişlerin her biri büyük harfle, tek tırnak imleri arasına yazılmalı ve girişler virgüllerle ayrılmalıdır. Yazılan dizginin tamamı da çift tırnak imleri arasında olmalıdır. Örneğin:
WARNINGLIST=" '01S02', 'HY090' "
Bu seçenek, CLI/ODBC yapılanışına ilişkin IGNOREWARNINGS anahtar sözcüğüyle birlikte kullanılabilir. IGNOREWARNINGS anahtar sözcüğünü de belirtirseniz, uyarıya indirgediğiniz hatalar hiç bildirilmez.