CDC işlemini denetleme
Veri Hareketi ağ geçidi, CDC işleme sırasında oluşturulan ve R4Z CDC hizmetleri olarak adlandırılan ECSA bellek yapılarını kullanır. Her z/OS LPAR bu tür birkaç R4Z CDC hizmeti içerebilir. R4Z CDC hizmetlerini oluşturmak için özel bir yardımcı program olan R4ZCTL sağlanır.
Bu program, z/OS tarafında trafik düzeyini yönetmenin yanı sıra CDC işlemenin durumunu yönetmek için de kullanılabilir.
R4Z kontrol programı (R4ZCTL) şunlar için gereklidir: CDC'nin kontrol edilmesi ve CDC hizmetinin durumunun bildirilmesi, CDC işlemenin duraklatılması, duraklatılmış bir CDC'nin sürdürülmesi ve CDC işleminin normal olarak veya zorla sonlandırılması.
R4ZCTL programını çalıştırırken kullanılabilen komut parametreleri:
Komutu parametre olmadan çalıştırırsanız CDC hizmetinin geçerli durumunu döndürür.
- CHECKCONFIG - Yapılandırma parametrelerinin geçerli olduğunu doğrular
- PAUSE_TASK - Belirli bir CDC görevinin hizmetini durdurur
- PAUSE_CDC - CDC hizmetinin tüm etkinliğini durdurur
- RESUME_TASK - Duraklatılan görevin devam etmesine olanak tanır
- RESUME_CDC - Duraklatılan CDC hizmetinin devat etmesine olanak tanır
- TERMINATE - CDC hizmetini durdurur ve durdurduktan sonra kaynaklarını serbest bırakır
- FORCE - Kaynakları tutan görev “askıya alındığında”, TERMINATE ile aynıdır
R4ZCTL programları APF yetkilendirmesi gerektirdiğinden, STEPLIB'deki tüm kitaplıklar APF için yetkilendirilmelidir.
R4ZCTL'yi parametre olmadan çalıştırırken, tamamlanma kodu ortamın başlatılıp (CC=0) başlatılmadığına (CC=1) bağlı olarak ayarlanır.
Kontrol programı çağırma söz dizimi
R4ZCTL programı EXEC PGM=R4ZCTL gibi bir iş adımı olarak çağrılır ve iş adımının çağırma parametresi yoluyla yönergeleri kabul eder.
R4ZCTL çağırma parametresi, aşağıda gösterildiği gibi virgülle ayrılmış isteğe bağlı alt parametreler içerebilen bir dizedir:
[SERVICE=CDC-service-qualifier,][MSGLVL={0 | 1},][action]
Dizedeki alt parametrelerin sırası önemli değildir.
Burada:
SERVICE=CDC-service-qualifier, kontrol programının üzerinde işlem yapacağı Veri Hareketi ağ geçidi etkinliğinin mantıksal kapsamını belirler.
MSGLVL={0 | 1 | 2}, kontrol programının çalışması sırasında mesaj dosyasında görüntülenecek bildirimlerin düzeyini belirler.
- 0 = Bildirim yok
- 1 = Orta
- 2 = Maksimum
action-verb aşağıdakilerden biri olabilir:
-
PAUSE_TASK(*|ALL|task-qualifier)
Parantez içinde belirlenen görevlerin CDC'ye alınmasını askıya alır.
-
PAUSE_CDC
CDC hizmetinin tamamının CDC'ye alınmasını askıya alır. Belirli bir süreden fazla askıya alınan durdurulan çoğaltma görevleri için birden çok kez kurtarma girişiminde bulunulur. Yeni görevlere hizmet verilmez.
-
RESUME_TASK(*|ALL|task-qualifier)
task-qualifier tarafından belirlenen görev için CDC'ye alma işlemini sürdürür.
-
RESUME_CDC
session-limits niteleyicisiyle eşleşen tüm örnekler için CDC'ye alma işlemini sürdürür.
-
DUMP_TASK(*|ALL|task-qualifier)
Yerleşik bellek yapılarındaki kontrol bilgilerinin biçimlendirilmiş dökümünü ister. ALL tüm oturumları belirtir; SUMMARYONLY yalnızca bağlayıcıyı belirtir.
-
TERMINATE
Tüm R4Z kalıcı bellek yapılarını serbest bırakır, tüm etkin örnekleri sonlandırır ve ilişkili kaynakları siler. Bu noktadan sonra, CDC hizmeti CDC okuyucusu UDF'ye gelen bir arama tarafından otomatik olarak etkinleştirilene kadar tüm CDC istekleri etkinlik dışı durum bilgisi döndürür.
Söz dizimi öğesi referansı
Yukarıdaki söz dizimi açıklamalarında kullanılan öğeler şunlardır:
-
CDC-service-qualifier
CDC hizmetini belirten 4 karakterlik bir ad (ilk karakter alfabetik, kalan kısmı alfasayısal).
“CDC hizmeti”, bellek yapıları, DB2'de tanımlanan kullanıcı tanımlı bir tablo fonksiyonu (UDTF) ve WLM politikasında tanımlanan bir uygulama ortamından (APPLENV) oluşan bir grup kaynağa karşılık gelir. R4Z, her CDC hizmeti için özellikleri (bellek sınırları ve işleme eşikleri) belirtmenizi sağlar. Birkaç CDC hizmetinin; tek bir LPAR'de birden fazla Veri Hareketi ağ geçidi sürümünün, her sürüm diğerlerinden bağımsız olarak kendi bellek yapısını koruyarak kullanılmasına izin verilmesi gibi başka bir nedenle de yönetilmesi gerekebilir.
-
task-qualifier
Görev başlatıldığında atanan 4 basamaklı bir tanımlayıcı. Bu tanımlayıcı esas olarak belirli bir görevin CDC trafiğini denetleme ve izlemeye yöneliktir. CDC'ye hizmet veren DB2 iş parçacığının CORRID (Korelasyon Kimliği) değerini oluşturur ve orada 9-12 arası baytlarda yer alır.
Kontrol programı tamamlanma kodları
- 0 – Normal tamamlanma
- 1 – session-limits niteleyicisiyle ortamdan çıkılmaz (action belirtilmediğinde)
- 4 – Uyarı
- 8 – Hata
Örnek işler (INSTALL kitaplığında)
IV1CHECK – Tüm CDC hizmetlerinin yapılandırmasını denetler
XMDUMP – Tüm oturumların dökümünü alır
XMPAUSE – Oturumu duraklatır
XMRESUME – Oturumu sürdürür
XMTERMIN – Tüm oturumları sonlandırır
CDC işlemini etkinleştirme (otomatik etkinleştirme)
CDC okuyucusu UDTF fonksiyonunun çalışmasını sağlamak için, bu fonksiyonunun UDTF çağrıldığında ve z/OS sistemi başlatıldıktan sonra ECSA'da bellek yapılarını ayırabilmesi ve önceden yapılandırabilmesi gerekir; ayrıca UDTF'nin hizmet verdiği CDC hizmetinin yapılandırma kümesine (veya CDC hizmet düzeyinde belirtilmeyen değerler için “varsayılan” yapılandırmaya) erişebilmelidir.
Bunu ortaya koymak için yükleme işlemi şunları sağlar:
- CDC hizmetine hizmet vermek için özel bir UDTF oluşturulur. Oluşturulan UDTF'nin adında bir çift alt çizgi son eki (“__”), ardından CDC-service-qualifier bulunur ve şöyle bir ad oluşturulur: <schema>.R4Z_UDTF__<CDC-service-qualifier>.
- Yukarıdaki UDTF'nin çağrılarını yürütmek için bir WLM APPLENV oluşturulur. Oluşturulan APPLENV adının benzersiz olmasını sağlamak için APPLENV adında da son ek olarak CDC hizmet niteleyicisi bulunabilir (önerilir); bununla birlikte, birden fazla UDTF tek bir APPLENV kullanabilir.
- WLM APPLENV yürütmelerini “barındırmak” için bir JCL prosedürü oluşturulur. Bu JCL prosedürü, özel bir DDNAME (R4ZCNFG) belirtilmesi gerektiğinden ve DSN'sinin R4Z ürününün CONFIG kitaplığına başvurmasından dolayı normal WLM STC prosedürlerinden farklıdır. Bu kitaplığın, varsayılan CDC hizmet yapılandırmalarını belirten “CDCS” adlı bir üyesi mevcut OLMALIDIR. Ayrıca bu CDC hizmetine uygulamak istediğiniz yapılandırma değerlerini içeren “CDCS<CDC-service-qualifier>” adlı bir üyesi de OLABİLİR.
-
CONFIG kitaplığındaki CDCS* üyelerinden her birinin içeriği, her kartta bir tane olmak üzere “anahtar sözcük=değer” biçiminde atama deyimleri listesidir. Deyimin arkasında boşluklar olabilir ve boşlukla sonlandırılır; deyimin içinde boşluklara izin verilmez. Tire (‘-‘) ile başlayan kartlar açıklama kartı olarak işlenir ve sonlandırma boşluğunu izleyen içerik de açıklama olarak işlenir.
Anahtar sözcükler, en fazla değerler, en az değerler ve varsayılan değerler Anahtar sözcük Açıklama En az En fazla Varsayılan MAXSESSIONS
En fazla CDC oturumu sayısı.
1
128
32
SESSIONTIMEOUTSECS
Oturum zaman aşımına uğradıktan sonraki saniye sayısı.
300
7200
900
MAXIFIBUFKBYTES
IFI okumaları için izin verilen Kbayt cinsinden en fazla arabellek boyutu.
64
1024
256
MAXRESULTSETMBYTES
Toplanan sonuç kümesinin ulaşabileceği Mbayt cinsinden en fazla boyut; bu boyuta ulaşıldığında sonuç kümesi döndürülür.
1
2048
4
MAXRESULTSETSECS
Sonuç kümesini toplamak için saniye cinsinden en uzun zaman aralığı; bu zaman aralığına ulaşıldığında sonuç kümesi döndürülür.
1
120
30
R4Z CDC hizmetlerini oluşturma
CDC hizmetleriyle ilgili kararlar: Bağımsız çoğaltma işlemlerine duyulan gereksinimlerle ilgili tahminler temelinde (farklı sürümlere olanak tanımak, yeterli ECSA belleğinin olduğundan emin olmak, izin verilen farklı gecikme sürelerini hesaba katmak vb. için), her LPAR'de hangi R4Z CDC hizmetlerinin mevcut olması gerektiğini saptayın. Her hizmet için CDC hizmet niteleyicilerini (4 karakter) seçin. Ayrıca her CDC hizmetinin kendi WLM APPLENV (uygulama ortamı) öğesi mi olacağına yoksa tüm CDC hizmetlerinde tek bir APPLENV'nin mi kullanılacağına karar vermelisiniz.
DFSYMLST üyesinde DEFWLMAE (DEFine WLM Applic. Env.) değişkenini PER (ilk seçenek) veya ONE (ikinci seçenek) olarak ayarlamanız gerekir. Bu ayarlandıktan sonra yüklemeye devam edebilirsiniz:
Bilgi notu-
DEFWLMAE için ONE seçerseniz, DO2* ve DO3SRVTF işleri bir kez çalıştırılmalıdır; PER seçerseniz, JCL SET değişkeni CDCSRV CDC hizmetinin niteleyicisine ayarlandıktan sonra bu işlerin her CDC hizmeti için çalıştırılması gerekir.
-
DO3SRVDF işi bir CONFIG kitaplığı oluşturur ve kitaplığa varsayılan yapılandırma dosyası işlevi gören “CDCS” adlı bir üye yerleştirir. DO3SRVTF işi çalıştırıldıktan sonra kitaplık tüm CDC hizmetlerinin yapılandırmasını içerir. Kitaplıkları düzenlemek ve belirli bir CDC hizmetinin yapılandırmalarını değiştirmek mümkündür.
-
DEFWLMAE için ONE kullanılırsa, CONFIG kitaplığının üyeleri yerine ürün varsayılanları kullanılır.
-