# IBM DB2 for z/OS
本節解說如何在資料任務中設定 IBM DB2 for z/OS 來源。在您開始資料任務之前，請確定已滿足[必要條件](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/prerequisites-zos.htm)，並且熟悉[限制和考慮事項](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/zos-limitations.htm)。
資訊備註此連接器僅受 Qlik Talend Cloud 企業版 訂閱支援。
## 設定連線屬性
本節說明可用的連線屬性。除非另有指明，否則所有屬性皆為必要。
若要開啟連接器，進行下列事項：
1. 在連線中，按一下建立連線。
2. 選取 IBM DB2 for z/OS 來源連接器，然後提供下列設定：
### 資料來源
* 資料閘道
選取 資料移動閘道 以用於移動您的資料。
如需關於 資料移動閘道 的詳細資訊，請參閱 [Qlik Data Gateway - Data Movement](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm)。
* 伺服器：IBM DB2 for z/OS 伺服器的 IP 位址或主機名稱。
* 連接埠：存取 IBM DB2 for z/OS 伺服器經由的連接埠。
資訊備註如果伺服器為並行 SysPlex 和多個 LPAR 的資料分享會員，主機位址可以指定 DVIPA，即動態虛擬 IP 位址（為了在Data Movement gateway處理中利用系統冗於和載入平衡）。在此情況下，所有成員必須都能清楚辨識連接埠號碼。
### 帳戶屬性
* 使用者名稱：存取 IBM DB2 for z/OS 伺服器所需的使用者名稱。
* 密碼：存取 IBM DB2 for z/OS 伺服器所需的密碼。
### 資料庫屬性
* 位置應為安裝期間定義的 DB2 位置名稱。這應該為 z/OS 之下的關聯式資料庫管理系統，這可以是子系統或群組連線。這是服務應用程式作業的邏輯名稱，為了指定使用 SEL 連線說明或將其置為表格辨識符號、由此系統管理的資源。
若要檢視位置名稱，使用「-DIS DDF」DB2 指令（ISPF 中 DB2I 面板選項 7）或在 <ssid>MSTR 位址空間的任務記錄訊息 DSNL004I 中尋找。
### CDC 屬性
* 若要從 IBM DB2 for z/OS 啟用資料擷取，來源表格必須依照以下建立：
CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS];
您可以在 連接器 設定中選擇自動啟用資料擷取變更 (需要管理員權限) 以設定 Data Movement gateway 執行此操作，或者可以手動進行此。
* 檢查變更的間隔 (秒)：檢查來源資料庫變更的頻率。
* CDC 讀取器 UDTF 名稱： Qlik 提供的使用者定義的表格函數名稱，用於 CDC。使用您為結構描述名稱選擇的值指定兩部分名稱 &R4ZSCNM 和函數名稱 &R4ZIFITF。
* UDTF 結果集合大小 (MB)： 使用此 連接器，透過 CDC 登陸任務，依 Qlik 提供的使用者定義的表格函數所傳回的結果列，指定要累積的大小上限。較大的結果集合會減少建立 IFI 工作階段的額外時間，但將會增加 DB2 的記憶體取用量。具體而言，因為結果集合是 LOB，您可能需要在 DB2 設定 (DSNZPARM) 中增加 LOBVALA 限制，指定每個使用者允許的最大 LOB 大小。假設透過相同的 ODBC 使用者 ID 設定所有 CDC 任務，以因應目前執行中的所有任務，請將 LOBVALA 設定為 2 × 1024 × 下列大小：`SUM[(i=all endpoints) : resultset size in endpoint(i) × #_tasks using endpoint(i)]`(結果集合大小以 MB 為單位，因此需要乘以 1024，以反映以 KB 為單位的 LOBVALA 大小)。另一個 DSNZPARM 限制 LOBVALS 指定所有使用者 ID 的整體大小；因此，若有多個使用者 ID，您也需要監控此值。不過，請注意，LOBVALS 以 MB 指定，與 LOBVALA 不同。
### SSL 選項
* 啟用 SSL：選擇以便啟用 SSL
* 金鑰儲存區資料庫檔案：（非必要）在 Data Movement gateway 機器上的金鑰儲存區資料庫檔案（包含私人鑰匙）。檔案必須使用 CMS 格式 (<filename>.kdb)，這通常是預設。
* 隱藏檔：(選用) 搭配加密版的金鑰儲存區資料庫密碼的檔案。
* 金鑰儲存區資料庫密碼：（非必要）能使用此處設定或在 隱藏檔 欄位指定的隱藏檔存取 金鑰儲存區資料庫檔案 。
警告備註
需要使用與 Data Movement gateway 支援的 DB2 磁碟機相容的 GSKit 版本產生 KDB 和隱藏檔。
如需關於哪個 GSKit 版本隨特定磁碟機版本出貨的資訊，請參閱[隨 DB2 出貨的 GSKit 版本](https://www.ibm.com/support/pages/node/484539)
### 覆寫 CCSID 對應到代碼頁面
在 CCSID 至字元集對應欄位中，使用以下格式（使用逗號而不是空白格分隔）輸入 CCSID 和字碼頁：
CCSID1,codepage1,CCSID2,codepage2,...
字元集（字碼頁）必須指定使用適當格式（如：ibm-1148\_P100-1997）。有效格式清單，請參閱[ICU Converter Explorer](http://demo.icu-project.org/icu-bin/convexp)。
### 內部屬性
內部屬性用於特殊使用情況，因此不會在對話方塊中顯示。您只能在 Qlik 支援指示下使用。
根據需要使用欄位右側的 the 新建 icon 和 the 取消 icon 按鈕以新增或移除屬性。
#### 支援的內部屬性
下表提供可按需求使用的內部參數清單。
內部參數
| 參數名稱 | 值 | 預設；最大；最小。 |
| --- | --- | --- |
| ifi306MessageLevel | 0 – 無偵錯追蹤；
1 – 包含偵錯追蹤；
9 – 完整偵錯 | 0; 0; 9. |
| ifi306BufferSize | 用於 IFI 讀取的記錄資料緩衝的大小 (以位元組為單位) | 65536; 65536; 1048576. |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/IBM4DB2-zos-source.htm)additionalConnectionProperties | <keyword>=<value>;…
範例：
`cursorhold=1;patch2=15` | (空的字串) |
### 名稱
來源連線的顯示名稱。
## 主機上的 R4Z 設定相依性
此區段中的此表格提供 R4Z 設定值清單，這可以在安裝期間設定或作為 CDC 服務設定的一部分，或作為端點定義的一部分。
R4Z 設定值
| R4Z 主題 | 根據屬性 | 定義於/查詢者 | 解析度 |
| --- | --- | --- | --- |
| R4Z ECSA 結構的總大小 | 可用 ECSA 大小 | /DNET,CSM,…
OWNERID=ALL | 確認沒有超過 ECSA 大小。 |
| CDC 服務中的 MAXRESULTSETSECS 參數 | DB2 執行緒等待鎖定資源的最大時間 | SDSNSAMP(DSNTIJUZ) 中的 DSNZPARM IRLMRWT 參數 | 在 SSID 規格下設定至少兩秒。 |
| CDC 服務中的 MAXRESULSETSIZE 參數 | 每個使用者 ID 可用的最大 LOB 大小 | SDSNSAMP(DSNTIJUZ) 中的 DSNZPARM LOBVALA 參數 | 2 \* (結果集合大小 \* 最大工作階段) |
| [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/IBM4DB2-zos-source.htm)小數點：句號或逗號 | 指定小數點編輯分隔符號 | DSNHDECM DECIMAL= 參數在 DSNTIJUZ 中 | 若小數點分隔符號是逗號，請將 additionalConnectionProperties 內部屬性設定為 `patch2=15`。 |