# IBM DB2 for z/OS

本节介绍如何在数据任务中设置 IBM DB2 for z/OS 源。在开始数据任务之前，请确保已完成 [先决条件](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/prerequisites-zos.htm)，并熟悉 [限制和考虑事项](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/SourcesConnections/IBM4DB2-zos/zos-limitations.htm)。

信息注释仅 Qlik Talend Cloud Enterprise 订阅支持此连接器。

## 设置连接属性

本节介绍可用的连接属性。除非另有说明，否则所有属性都是必需的。

要打开连接器，请执行以下操作：

1. 在连接中单击创建连接。

2. 选择 IBM DB2 for z/OS 源连接器，然后提供以下设置：

### 数据源

* 数据网关

  选择用于移动您的数据 数据移动网关。

  有关 数据移动网关 的信息，请参阅[Qlik Data Gateway - Data Movement](https://help.qlik.com/zh-CN/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 下的一个关系数据库管理系统，其可以是子系统，也可以是组连接。这是为应用程序服务的逻辑名称，用于指定由该系统管理的资源，可以使用 SQL CONNECT 指令，也可以将其作为表的限定符（在模式名称之前）。

  要查看位置名称，请使用“-DIS DDF”DB 2命令（ISPF 中 DB2I 面板下的选项 7），或查看 &lt;ssid&gt;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 大小。假设所有 CDC 任务都配置了相同的 ODBC 用户 ID，为了适应同时运行的所有任务，请将 LOBVALA 设置为 2 × 1024 × 以下大小：`SUM[(i=all endpoints) : resultset size in endpoint(i) × #_tasks using endpoint(i)]`（结果集大小以 Mb 为单位，因此需要乘以 1024 以反映 LOBVALA 大小，单位为 KB）。另一个 DSNZPARM 限制 LOBVALS 指定了所有用户 ID 的总大小；因此，如果有多个用户 ID，您也需要监视该值。但是，请注意，LOBVAL 是以 MB 为单位指定的，而不是 LOBVALA。

### SSL 选项

* 启用 SSL：选中以启用 SSL
* 密钥库数据库文件：（可选）Data Movement gateway 计算机上的密钥库数据库文件（包含私钥）。文件必须是 CMS 格式 (&lt;filename&gt;.kdb)，这通常是默认格式。
* Stash 文件：（可选）具有密钥库数据库密码加密版本的文件。
* 密钥库数据库密码：（可选）可以使用此处设置的密码或在 Stash 文件字段中指定的存储文件来访问密钥库数据库文件。

警告注释

KDB 和 stash 文件需要使用与 数据移动网关 支持的 DB2 驱动程序兼容的 GSKit 版本来生成。

有关特定驱动程序版本附带的 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 – 无 DEBUG 痕迹；<br><br>1 – 包括 DEBUG 痕迹；<br><br>9 – 完整 DEBUG | 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 | &lt;keyword&gt;=&lt;value&gt;;…<br><br>示例：<br><br>`cursorhold=1;patch2=15` | （空字符串） |

### 名称

安全连接的显示名称。

## 主机上的 R4Z 配置依赖项

本节中的此表提供了 R4Z 配置值的列表，这些值可以在安装过程中设置，也可以作为 CDC 服务设置的一部分或作为端点定义的一部分。

R4Z 配置值

| R4Z 主题 | 取决于属性 | 定义于/查询者 | 解析 |
| --- | --- | --- | --- |
| R4Z ECSA 结构的总大小 | 可用 ECSA 大小 | /DNET,CSM,…<br><br>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= param. In DSNTIJUZ | 如果十进制分隔符是逗号，请将 additionalConnectionProperties 内部属性设置为`patch2=15`.。 |