-MODIFY DDF 命令 ( )Db2

MODIFY DDF命令用于修改 Db2 分布式数据设施（DDF）的状态和配置，以及由DDF控制的连接或线程的统计信息。

授权 -MODIFY DDF

要执行此命令，您必须使用包含以下权限或授权之一的进程特权集：
  • 系统管理员权限
  • SYSCTRL 权限
  • SYSADM 权限

Db2 登录 控制台或TSO 发出的命令可通过 授权进行查看，使用主授权ID和次授权ID。 z/OS® SDSF Db2 更改开始必须在 RACF 或类似的安全服务器中定义一个已登录的 z/OS 用户ID。更改结束

语法 -MODIFY DDF

阅读语法图跳过可视化语法图MODIFY DDF ACCTGACCTG(ALLCOMMIT)ALIAS( 别名)ADDDELETESTARTSTOPCANCELPORT( PORT-NAME)SECPORT( secport-name)NPORTNSECPORTIPV4( ipv4-address)IPV6( ipv6-address)NIPV4NIPV6PKGREL(BNDOPTBNDPOOLCOMMIT)SESSIDLE(会话空闲限制)

选项说明 -MODIFY DDF

更改开始ACCTG更改结束
更改开始指定 Db2 是否为分布式客户端应用程序使用的每笔交易生成会计跟踪记录。

对于现有的分布式线程，指定的ACCTG选项仅在线程在提交或回滚时生成无未用资源的记帐跟踪记录后生效。 在此之前，之前保存的线程ACCTG选项将继续控制何时生成会计跟踪记录。

（无选项价值）
指定默认行为。
当此选项恢复为默认设置，或者如果从未更改过设置，则当提交或回滚后不存在未使用的资源时， Db2 会生成一个会计跟踪记录。 如果以下资源中仍有未关闭和未处理的，则 Db2 不会生成会计跟踪记录：
  • 打开并按下光标键
  • 声明的未删除的全局临时表
  • 未发布的LOB定位器
  • 当使用两阶段提交规则运行时，由存储过程处理的提交
  • 分配的RELEASE DEALLOCATE包（由于-MODIFY DDF PKGREL(BNDOPT)选项）
  • 已分配 KEEPDYNAMIC YES 套餐
但是，如果在提交或回滚后只打开了前两种资源类型中的一种，而不是两种都打开， Db2 就会在提交或回滚后生成会计跟踪记录。
ALLCOMMIT
当启用此选项后， Db2 会在每次提交或回滚后生成会计跟踪记录。 然而， Db2 仍然保留着由 Db2 创建的WLM飞地，这是在最初请求的交易留下未用资源之前创建的。 此外， Db2 还维护着信息，以便在DBAT完成其客户连接的工作请求后终止时，删除该飞地并通知WLM已完成的事务。

要使用ACCTG（ALLCOMMIT）选项，您还必须将CMTSTAT子系统的参数值设置为INACTIVE。 否则， Db2 将返回以下信息，表明默认行为仍在使用中。

DSNL302I ACCTG IS SET TO COMMIT_WITH_NO_OPEN_RESOURCES
更改结束
ALIAS

指定创建、更改或删除指定位置别名。 您可以使用带有别名选项的修改DDF命令，动态定义和管理多达40个位置别名。 您可以在不停止DDF或 Db2 的情况下启动、停止、取消、更改和删除动态位置别名。

更改开始MODIFY DDF命令不能用于管理静态位置别名。 更多信息，请参阅会员特定位置别名。更改结束

别名

指定DDF位置的别名。 别名是可用于连接处理的地点名称的替代名称。

重要： 更改开始为获得最佳效果，请勿指定名称与 Db2 子系统当前位置名称完全匹配的特定成员位置别名。 否则，停止或取消别名可能会导致不可预知的结果。更改结束

别名必须符合以下所有要求：

  • 不超过16个字符。
  • 仅包含字母（不包括字母扩展）、数字或下划线。
ADD
使用指定的名称创建一个别名。
删除
删除指定的别名。
START
Db2 如果DDF启动，则开始接受指定别名的连接请求。 如果 DDF 未启动，则该别名将被标记为可启动，当 DDF 启动时， Db2 将自动开始接受对该别名的连接请求。

如果子系统属于数据共享组，则 Db2 向WLM注册别名， Db2 参与sysplex工作负载平衡，以连接到别名。

STOP
Db2 不再接受对指定别名的新的连接请求。 现有的数据库访问线程处理与别名的连接不受影响。 与别名相关的非活动连接已关闭。

停止的别名被标记为不符合启动条件，在DDF启动时不会自动启动。 如果子系统属于数据共享组， Db2 会向WLM取消该别名的注册， Db2 会停止参与sysplex工作负载平衡，以连接到该别名。

取消
Db2 不再接受对指定别名的新的连接请求。 所有处理别名连接的数据库访问线程将被取消，与别名相关的非活动连接将被关闭。

已取消的别名将被标记为不符合启动条件，在DDF启动时不会自动启动。 如果子系统属于数据共享组， Db2 会向WLM取消该别名的注册， Db2 会停止参与sysplex工作负载平衡，以连接到该别名。

端口 （端口名称 ）
添加或替换现有端口，供分布式文件系统（DDF）用于接受指定别名的分布式请求。 端口名称值必须为1-65535范围内的十进制数，包括65535，且必须与其他别名的端口值不同。 当您想确定分布式请求可以访问的数据共享成员子集时，请为别名指定一个端口值。
SECPORT （secport-name ）
添加或替换现有安全端口，DDF可通过为指定别名使用SSL来接受安全分布式请求。 为 secport-name 指定的值必须为1-65535之间的十进制数，包括65535，且必须与其他别名端口的值不同。 当您想确定安全分布式请求可以访问的数据共享成员子集时，请为别名指定一个SECPORT值。
NPORT
删除别名端口（如果存在）。
NSECPORT
删除别名安全端口（如果存在）。
IPV4 （IPv4地址 ）

为TCP/IP组访问的INADDR_ANY方法添加或替换现有的特定成员 IPv4 地址。 当客户使用以下功能之一连接动态位置别名时，会使用该地址：

  • Sysplex 工作负载均衡
  • XA协议用于协调分布式事务处理

该地址必须以小数点分隔的十进制形式指定。

更改开始如果使用 BINDSPECIFIC 方法访问 TCP/IP 组，请不要指定 IPV4(IPv4-address) 。更改结束

IPV6 （IPv6地址 ）

为TCP/IP组访问的INADDR_ANY方法添加或替换现有的特定成员 IPv6 地址。 当客户使用以下功能之一连接动态位置别名时，会使用该地址：

  • Sysplex 工作负载均衡
  • XA协议用于协调分布式事务处理

该地址必须以冒号-十六进制形式指定。

更改开始如果使用 BINDSPECIFIC 方法访问 TCP/IP 组，请不要指定 IPV6(IPv6-address) 。更改结束

.
NIPV4
删除别名 IPv4 地址（如果存在）。
NIPV6
删除别名 IPv6 地址（如果存在）。
PKGREL
指定 Db2 是否支持用于远程客户端处理的软件包的绑定选项。 Db2 在发出第一个带有PKGREL选项的MODIFY DDF命令之前，使用COMMIT选项的行为。

如果CMTSTAT子系统参数设置为ACTIVE，则带有PKGREL关键字的MODIFY DDF命令不起作用， Db2 始终使用COMMIT选项的行为。

BNDOPT
绑定包时指定的“发布绑定”选项规则适用于任何用于远程客户端处理的包。 终止客户端连接时，高性能数据库事务处理（DBAT）将被取消分配。

如果CMTSTAT子系统参数设置为“非活动”，则BINDOPT是PKGREL的默认选项。

BNDPOOL
绑定包时指定的“发布绑定”选项规则适用于任何用于远程客户端处理的包。 终止客户端连接时使用的DBAT高性能数据库被集中起来。
COMMIT
RELEASE(COMMIT)绑定选项的规则适用于任何用于远程客户端处理的程序包。

如果CMTSTAT子系统参数设置为“启用”，则 Db2 始终使用此选项的行为。

更改开始SESSIDLE （会话空闲限制）更改结束
更改开始指定在相关会话数据令牌因超时而失效之前，应用程序可以保持不活动的分钟数。

session-idle-limit 可以是0到999999之间的任何整数。 当未指定值时，默认值为1440。

更改结束

使用说明 -MODIFY DDF

何时使用PKGREL选项和高性能DBAT

更改开始在正常生产运行时间，可以指定 DDF 使用 PKGREL(BNDOPT) 或 PKGREL(BNDPOOL) 选项，以指定 Db2 使用高性能 DBAT 为远程连接提供服务。 高性能数据库访问线程（DBAT） 是一种数据库访问线程，在事务边界与远程连接保持关联，而不是被池化。 使用高性能数据库事务处理，分配和取消分配的处理量会减少，因为数据包的副本在数据库事务处理终止之前一直保持分配状态。 有关详细信息，请参阅启用高性能 DBAT。更改结束

对于客户配置控制使用与RELEASE（DEALLOCATE）绑定选项绑定在一起的包的环境，BNDOPT可能是PKGREL选项的首选值。 对于任何客户都可以使用绑定有RELEASE(DEALLOCATE)绑定选项的软件包的环境，BNDPOOL可能是PKGREL选项的首选值。 两种方案都能通过降低分配和取消分配数据包的CPU成本来提高性能。

然而，在RELEASE(DEALLOCATE)绑定选项规则下运行的程序包可能会保持分配状态，从而阻止维护活动，例如对象修改和绑定操作。 因此，您可以在日常维护和紧急维护期间指定PKGREL（COMMIT）选项。 更多信息，请参阅 《高性能DBAT的解除分配控制 》。

PKGREL（COMMIT）的延迟效应
当您发出MODIFY DDF命令并指定PKGREL(COMMIT)选项时，效果不会立即显现。 发出命令后，任何正在运行RELEASE(DEALLOCATE)包的数据库访问线程将在连接变为非活动状态时终止。 在客户端的下一个工作单元中，以发布（提交）模式创建一个新的数据库访问线程。 任何由于RELEASE（DEALLOCATE）规则而保持活动状态，等待客户发出新工作单元请求的DBAT，都会被每2分钟运行一次的DDF服务任务终止。 因此，在大约2分钟内，所有数据库访问线程都按照RELEASE(COMMIT)绑定选项的规则运行。
别名属性的更改
只有当别名停止时，才能修改现有别名的属性。 修改后的别名属性在别名启动时生效。 默认情况下，由 DSNJU003 实用程序创建的别名将启动，而由MODIFY DDF命令创建的别名将停止。 DSNJU004 不打印MODIFY DDF命令创建的别名的任何信息。 您可以使用DISPLAY DDF命令的输出结果来查看MODIFY DDF命令创建的别名状态。
Db2 如何使用 IPV4 和 IPV6 值

Db2 不会激活您通过 或 参数指定的IP地址。 IPV4 IPV6 客户仅将这些地址用于路由目的。 Db2 不要求地址是动态虚拟IP地址（DVIPAs）。 IP地址用于访问DVIPA网络，该网络为 Db2 数据共享组提供服务。 只有在运行 DSNJU003 时指定了 IPV4 或 IVP6 参数以指定特定成员的位置地址后，您才能在MODIFY DDF命令中指定IP地址。 当客户端连接到动态位置别名时，指定的IP地址将根据以下条件返回到WLM加权服务器列表中：

  • 如果客户连接使用的是 IPv6 地址，服务器列表中包含使用MODIFY DDF命令的 IPV4 和 IPV6 参数指定的别名IP地址。 如果在修改DDF命令中未指定 IPv4 地址，则返回由 DSNJU003 实用程序的 IPV4 关键字指定的位置IP地址。 同样，如果在MODIFY DDF命令中未指定 IPv6 地址，则返回由 DSNJU003 实用程序的 IPV6 关键字指定的位置IP地址。
  • 如果客户连接使用的是 IPv4 地址，服务器列表中包含使用MODIFY DDF命令的 IPV4 参数指定的别名IP地址。 如果在修改DDF命令中未指定 IPv4 地址，则返回由 DSNJU003 实用程序的 IPV4 关键字指定的位置IP地址。
更改开始将位置别名端口绑定到独立 Db2 子系统的不同 IP 地址上更改结束
更改开始

不属于 Db2 数据共享组的 Db2 子系统可以通过请求将套接字绑定到INADDR_ANY，为位置别名端口创建一个单一侦听套接字。 如果 PROFILE.TCPIP 端口声明还在别名端口的BIND参数中指定了IP地址，则TCP/IP会将侦听套接字绑定到指定的地址。

在大多数情况下，如果PORT语句的BIND参数为别名端口指定了IP地址，则该地址应与 Db2 在DISPLAY DDF命令输出中的 DSNL084I 消息中为TCPPORT或SECPORT显示的IP地址相同。

但是，如果别名端口的 PORT 语句 BIND 参数指定的 IP 地址与 Db2 显示的主 TCPPORT 或 SECPORT 的 IP 地址不同，则 TCP/IP 会将别名侦听套接字绑定到 PORT 语句 BIND 参数中指定的 IP 地址。 因此，只能通过指定该特定IP地址才能访问别名端口。 Db2 不会学习或显示别名端口的IP地址信息。

更改结束