命令参考

db2licm - 许可证管理工具命令参数说明

此文档更新适用于 db2licm 命令的 -p 参数。关键字 |MEASURED 不再有效，DB2 已忽略此关键字。

RESTORE DATABASE 命令的 TSM 示例

TSM 示例（示例 6）中的 TSM options 两边缺少单引号，应该是：

|
• 指定定界字符串：

db2 restore db sample use TSM options "'-fromnode bar
|-fromowner dmcinnis'"

db2demigdbd 用法示例

以下显示的 db2demigdbd 的使用示例按操作系统进行了组织。

要逆向迁移 UNIX 和 Linux 上的系统数据库目录文件：

 db2demigdbd $HOME/sqllib 1 

要逆向迁移 UNIX 和 Linux 上的本地系统数据库目录文件： |

 db2demigdbd  ~/user/NODE0000  1 

要逆向迁移 UNIX 和 Linux 上的实例中的系统和所有本地数据库目录文件:

 db2demigdbd  $HOME/sqllib  2 

要逆向迁移 Windows 上的系统数据库目录文件：

 db2demigdbd  d:\sqllib\db2  1 

其中，db2 是当前实例。

要逆向迁移 Windows 上的本地系统数据库目录文件： |

 db2demigdbd  d:\db2\NODE0000  1 

要逆向迁移 Windows 上的实例中的系统和所有本地数据库目录文件:

 db2demigdbd  d:\sqllib\db2 2 

使用说明：

一旦开始运行 db2updv8 命令以将系统目录更新为当前的版本 8 级别，就不再支持回退到 V8.1。

其他信息：

要获取在 DPF（数据库分区功能）环境中运行此命令的示例，请参阅 http://www.ibm.com/support/docview.wss?rs=71&uid=swg21217949 处的技术说明

更正 db2ckbkp 命令的使用说明

“-p”选项显示每个对象类型的页数。但是，如果对 DMS 表空间数据制作了备份，则带“-p”选项的 db2ckbkp 命令的输出并不显示所有不同对象类型的页数。在这种情况中，它只显示总页数 |SQLUDMSTABLESPACEDATA。 对 SQLUDMSLOBDATA 显示 0 值，对 DMS 表空间显示 SQLUDMSLONGDATA。

以下提供了对 DMS 表空间数据制作了备份时 db2ckbkp -p 的输出节样本：

      SQLUDMSTABLESPACEDATA (0c):  87 
|      SQLUDMSLOBDATA (0e):          0 
|      SQLUDMSLONGDATA (0f):         0                              

数据库对象和标识的命名约定

在命名 数据库管理器 对象（例如，数据库和表）时，以下约定适用。

|
• 表示 数据库管理器 对象的名称的字符串可以包含以下任何字符：a-z、A-Z、0-9、@、# 和 $。
|
• 除非另外注明，否则您可以使用小写字母输入名称；但 数据库管理器 进程会将它们作为大写字母来处理。 |

  此约定的例外是那些表示系统网络体系结构（SNA）下的名称的字符串。此时，许多值都是区分大小写的，例如，逻辑单元名称（partner_lu 和 local_lu）。输入的名称必须与出现在对应于那些项的 |SNA 定义中时一样。

|
• 数据库名称或数据库别名是一个唯一的的字符串，它包含了从 1 个到 8 个字母、数字或键盘字符（它们来自上述信息中描述的字符集）。 |

  数据库被编目在系统和本地数据库目录中，方法是数据库别名在一个字段中，原始名在另一字段中。对大多数函数来说，数据库管理器 会使用在数据库目录的别名字段中输入的名称。例外情况是 CHANGE DATABASE COMMENT 和 CREATE DATABASE，此时必须指定目录路径。

|
• 表或视图的名称或别名是一个 SQL 标识符，它是一个长度为 1 至 128 个字符的唯一的的字符串。列名的长度可以是 |1 到 30 个字符。 |

  标准表名的结构是 schema.tablename。模式是创建表时使用的唯一的用户标识。已声明临时表的模式名必须是 |SESSION。

|
• 要编目到节点目录中的远程节点的本地别名不能超过 8 个字符的长度。
|
• 字符串中的第一个字符必须是字母字符、@、# 或 $；它不能是数字或字母序列 SYS、DBM 或 IBM。

在命名用户标识和认证标识时，以下约定适用。

|
• 表示 数据库管理器 对象的名称的字符串可以包含以下任何字符：a-z、A-Z、0-9、@、# 和 $。
|
• 在安全性插件支持时，用户标识和组也可包含以下任何附加字符：_、!、%、(、)、{、}、-、. 和 ^。
|
• 在通过命令行处理器输入时，包含以下任何字符的用户标识和组都必须使用引号来定界：!、%、(、)、{、}、-、. 和 ^。
|
• 字符串中的第一个字符必须是字母字符、@、# 或 $；它不能是数字或字母序列 SYS、DBM 或 IBM。
|
• 认证标识在 Windows 32 位操作系统上不能超过 30 个字符，在所有其他操作系统上不能超过 8 个字符。
|
• 组标识的长度不能超过 30 个字符。

REORGCHK 命令

已修订 REORGCHK 命令中使用的索引统计信息公式。新公式及其解释如下：

• 公式 F5：

  100 * (KEYS * (ISIZE + LEAF_REC_OVERHEAD) + (CARD - KEYS) 
              * DUPKEYSIZE ) 
      / ((NLEAF - NUM EMPTY LEAFS - 1) * 
         (INDEXPAGESIZE - 96) > MIN(50, (100 - PCTFREE))

  其中 LEAF_REC_OVERHEAD = 9，而 DUPKEYSIZE = 5。

  如果索引中的可用空间大于 50%，或者当 PCTFREE 大于 50 时，索引中的可用空间大于 PCTFREE%，则建议进行重组。仅当 NLEAF - NUM EMPTY LEAFS - 的值大于 0 时，才检查此公式。（从 NLEAF 的值中减去 1 是因为通常未填充分配的最后一个叶子页。）

• 公式 F6：

  (100 - PCTFREE) * 
       [ Floor((100 - min(10, PCTFREE)) / 100 * (INDEXPAGESIZE - 96) 
               / (ISIZE + NONLEAF_REC_OVERHEAD)) ** (NLEVELS - 2)] 
       * (INDEXPAGESIZE - 96) / 
         (KEYS * (ISIZE + LEAF_REC_OVERHEAD) 
               + (CARD - KEYS) * DUPKEYSIZE) < 100

  其中 NONLEAF_REC_OVERHEAD = 12。

  确定重新创建索引是否将生成具有较少层次的树。此公式检查当索引树比当前树少一个层次时该索引树中的空间大小与需要的空间大小的比率。如果可以创建少一个层次的树并且仍保持 PCTFREE 可用，则建议进行重组。索引条目的实际数目应该大于 NLEVELS - 1 索引树可以处理条目数的 90%（或 100 - PCTFREE）（仅当 NLEVELS > 1 时才检查）。

REORG INDEXES/TABLE 命令

重组索引或表。

REORG INDEXES ALL FOR TABLE 表名选项通过将索引数据重建成非分段的物理连续页面来重组在表上定义的所有索引。如果指定索引选项的 CLEANUP ONLY 选项，则将执行清除，而不重建索引。如果尝试对已声明临时表上的索引使用此命令，则将返回 SQLSTATE 42995 错误。

REORG TABLE 表名选项通过重新构造行以除去分段数据并压缩信息来重组表。可通过两种方法中的一种来实现表重组：

传统

只允许在重组的前面阶段对数据进行有限的只读访问。

Inplace

在整个重组过程中都允许访问数据，但不能确保以最佳的顺序排列数据。Inplace 表重组方法只适用于具有 2 类索引和无扩展索引的表。

当选择任一种类型的重组方法时，在重组表之后，都会重建该表的索引。但是，使用 inplace 方法将不能以最佳方式重组索引，因此，以后可能会需要重组这些索引以减少索引分段并回收索引对象空间。

   db2 reorg table employee index empid allow no access indexscan 
      longlobdata

BACKUP DATABASE 命令

迁移数据库

db2inidb － 初始化镜像数据库命令

在发出 db2inidb database as mirror 命令之前，不要发出 db2 connect to database 命令。

在初始化分割镜像数据库之前尝试连接至该数据库将擦除前滚恢复所需的日志文件。

连接会将数据库设置回暂挂数据库时它所处于的状态。如果在暂挂时数据库被标记为处于一致状态，则 DB2 通用数据库^(TM)会认为不需要进行崩溃恢复并且会清空日志以供到将来使用。如果出现这种情况，则尝试前滚会产生 SQL4970 错误。

db2iupdt 命令的使用说明

从版本 8.2 开始，在使用 db2iupdt 命令更新 DB2 通用数据库实例时，必须先停止对该实例运行的所有 DB2^(R) 进程。

db2sqljcustomize 命令的新增参数

db2sqljcustomize 命令有了新参数。

sqlj 命令的新增参数

sqlj 命令有了新参数。

监视和故障诊断命令（db2pd）更新

监视和故障诊断 DB2 命令（db2pd）从 DB2 UDB 内存集合检索信息。db2pd 系统命令在以下方面做了改进：

新增 -hadr 参数

在版本 8.2（功能等同于版本 8.1 修订包 7）中引入，-hadr 参数报告高可用性灾难恢复信息。每个已报告元素的描述可在《系统监视器指南和参考》的『高可用性灾难恢复』一节中找到

新增 -utilities 参数

在版本 8.2（功能等同于版本 8.1 修订包 7）中引入，-utilities 参数报告实用程序信息。每个已报告元素的描述可在《系统监视器指南和参考》的『实用程序』一节中找到。

新增 -activestatements 参数

在版本 8.2.2（功能等同于版本 8.1 修订包 9）中引入，-activestatements 参数返回有关活动参数的信息。将返回下列信息：

AppHandl

使用活动语句的应用程序句柄，包括节点和索引。

UOW-ID

对于与 AppHandl 相关联的应用程序，这是其中的语句变为活动状态的工作单元标识。

StmtID

工作单元中的语句标识。

AnchID

程序包高速缓存动态 SQL 散列锚的标识。

StmtUID

在散列锚中唯一的程序包高速缓存动态 SQL 语句标识。

EffISO

语句的有效隔离级别。

EffLockTOut

语句的有效锁定超时值。

EffDegree

语句的有效并行度。

StartTime

启动语句的时间。

LastRefTime

应用程序上次引用该语句的时间。

新增用于 -locks 参数的 wait 选项

从版本 8.2.2（功能等同于版本 8.1 修订包 9）开始，可以对 -locks 参数指定 wait 选项以便仅返回处于等待状态的锁定和将要等待的锁定。

新增 -applications 参数的返回字段

从版本 8.2.2（功能等同于版本 8.1 修订包 9）开始，-applications 参数返回四个新字段：

C-AnchID

此新字段是当前语句的程序包高速缓存动态 SQL 散列锚的标识。如果当前没有任何语句，则此字段的值为 0。仅当应用程序要执行与该语句相关联的请求（如针对游标的 FETCH 请求）时，才会填充当前散列锚标识。完成请求处理后，该值将设置为 0。对于静态 SQL 语句，该值也会设置为 0。

C-StmtUID

此新字段是当前语句的散列锚中的程序包高速缓存动态 SQL 语句唯一标识。如果当前没有任何语句，则此字段的值为 0。仅当应用程序在执行与该语句相关联的请求时，才会填充当前语句唯一标识。执行请求后，该值将设置为 0。对于静态 SQL 语句，该值也会设置为 0。

L-AnchID

此新字段是应用程序上一次执行的语句的程序包高速缓存动态 SQL 散列锚标识。如果上一次没有执行任何语句（在执行任何动态 SQL 语句之前），则此字段的值为 0。对于静态 SQL 语句，该值也会设置为 0。每次执行完请求后，将填充上一个锚散列标识，并且该标识将保留至下一个相关联的请求完成为止。

L-StmtUID

此新字段是应用程序上一次执行的语句的散列锚中的程序包高速缓存动态 SQL 语句唯一标识。如果上一次没有执行任何语句或者上一次执行的语句为静态 SQL，则此字段的值为 0。在当前请求完成后将填充上一个语句标识，并且该标识将保留至下一个请求完成为止。

对 SET CLIENT 命令的更新

SET^(TM) CLIENT 命令指定后端进程的连接设置。

从版本 8 开始，将忽略此命令的命令参数 SYNCPOINT。为了保持向后兼容性，将继续包括 SYNCPOINT。

对 PRECOMPILE 命令的更新

PRECOMPILE 命令将处理包含嵌入式 SQL 语句的应用程序源文件。将生成经过修改的源文件，它包含对 SQL 的主语言调用，并且在缺省情况下将在数据库中创建程序包。

从版本 8 开始，将忽略此命令的命令参数 SYNCPOINT。为了保持向后兼容性，将继续包括 SYNCPOINT。

对 UPDATE HISTORY FILE 命令的更新

更新历史文件条目中的位置、设备类型或注释。

命令参数 STATUS 指定条目的新状态。

先前的文档不正确地指出：STATUS 命令的参数值可以是“I”，以将该条目标记为不活动。有效值包括：

A

将条目标记为活动的。

E

将条目标记为已到期。

对 EXPORT 和 IMPORT 命令的更新

EXPORT 和 IMPORT 命令的『必需的连接』子节的完整内容为如下所示：

对 LOAD 命令的更新

INDEXING MODE 参数的 AUTOSELECT 值的完整信息为如下所示：

LOAD 实用程序的文件类型修饰符

已经更新了对“generatedoverride”修饰符的描述中的 SET INTEGRITY 命令。

还更新了对“usedefaults”修饰符的描述。

更新为如下所示：

SET INTEGRITY FOR < table-name > GENERATED COLUMN 
  IMMEDIATE UNCHECKED

SET INTEGRITY FOR < table-name > IMMEDIATE CHECKED.

IMPORT 实用程序的文件类型修饰符

“usedefaults”和“codepage=x”修饰符的描述已更新为如下所示：

ATTACH 命令

ATTACH 命令的 USER 参数指定认证标识。在 Windows 操作系统上连接至 DB2 通用数据库实例时， 可采用与 Microsoft^(R) Windows NT^(R) Security Account Manager（SAM）兼容的格式来指定用户名。限定符必须为 NetBIOS 式名称，其最大长度为 15 个字符。例如，domainname\username。

RECOVER DATABASE 命令

在版本 8.2 文档的 RECOVER DATABASE 命令的『示例』一节中，时间戳记格式 yyyy:mm:dd:hh:mm:ss 是不正确的。

正确的格式为 yyyy-mm-dd-hh.mm.ss。

UPDATE HISTORY FILE 命令

>>-UPDATE HISTORY--+-FOR--object-part-+--WITH------------------->
                   '-EID--eid---------'
 
>--+-LOCATION--new-location--DEVICE TYPE--new-device-type-+----><
   +-COMMENT--new-comment---------------------------------+
   '-STATUS--new-status-----------------------------------'
 

db2updv8 － 将数据库更新至版本 8 当前级别命令

此命令使用下列方法更新数据库中的系统目录以支持当前级别：

|
• 引入随当前数据库管理器提供的新例程
|
• 将 ODBC/CLI/JDBC 模式过程编目为可信过程以改进性能和可伸缩性
|
• 修正 SYSPROC.SNAPSHOT_QUIESCERS 表函数的返回参数中的两个印刷错误： |
  |
  • OUIESCER_TBS_ID 已更正为 QUIESCER_TBS_ID
  |
  • OUIESCER_STATE 已更正为 QUIESCER_STATE
|
• 修正 LOB 列的列描述符以使记录位与目录表一致
|
• 创建 SYSIBM.SYSREVTYPEMAPPINGS 视图
|
• 更新 SYSSTAT.COLUMNS 和 SYSSTAT.TABLES 的视图定义
|
• 将 SYSCOLDIST.DISTCOUNT 列更新为可更新
|
• 更新 SYSINDEXES.TBSPACEID 列以便不设置列标志
|
• 修正 17 个表函数的参数长度。有关函数的完整列表，请参阅《版本 8.2 发行说明》的 |『文档更新 | SQL 管理例程』一节中的『快照 UDF 的列扩展』主题。
|
• 启用以下内置例程： |
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • HEALTH_TBS_INFO
  |
  • HEALTH_TBS_HI
  |
  • HEALTH_TBS_HI_HIS
  |
  • HEALTH_CONT_INFO
  |
  • HEALTH_CONT_HI
  |
  • HEALTH_CONT_HI_HIS
  |
  • GET_WRAP_CFG_C
  |
  • LIST_FILES_C
  |
  • ODBC_DISCOVERY
  |
  • HEALTH_HI_REC
  |
  • EXEC_DB2_SCRIPT
  |
  • HEALTH_HI_REC
  |
  • EXEC_DB2_SCRIPT
  |
  • ADMIN_LIST_HIST
  |
  • GET_DBM_CONFIG
|
• 将 33 个 SYSPROC 快照 UDF 改变为 THREADSAFE： |
  |
  • SNAPSHOT_DBM
  |
  • SNAPSHOT_FCM
  |
  • SNAPSHOT_FCMNODE
  |
  • SNAPSHOT_SWITCHES
  |
  • SNAPSHOT_APPL_INFO
  |
  • SNAPSHOT_APPL
  |
  • SNAPSHOT_STATEMENT
  |
  • SNAPSHOT_LOCKWAIT
  |
  • SNAPSHOT_AGENT
  |
  • SNAPSHOT_SUBSECT
  |
  • SNAPSHOT_DATABASE
  |
  • SNAPSHOT_BP
  |
  • SNAPSHOT_LOCK
  |
  • SNAPSHOT_TABLE
  |
  • SNAPSHOT_DYN_SQL
  |
  • SNAPSHOT_TBS
  |
  • SNAPSHOT_TBS_CFG
  |
  • SNAPSHOT_QUIESCERS
  |
  • SNAPSHOT_CONTAINER
  |
  • SNAPSHOT_RANGES
  |
  • SNAPSHOT_TBREORG
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • HEALTH_TBS_INFO
  |
  • HEALTH_TBS_HI
  |
  • HEALTH_TBS_HI_HIS
  |
  • HEALTH_CONT_INFO
  |
  • HEALTH_CONT_HI
  |
  • HEALTH_CONT_HI_HIS
|
• 更改以下函数的参数长度： |
  |
  • SQLCACHE_SNAPSHOT
  |
  • SNAPSHOT_APPL_INFO
  |
  • SNAPSHOT_STATEMENT
  |
  • SNAPSHOT_LOCKWAIT
  |
  • SNAPSHOT_DATABASE
  |
  • SNAPSHOT_BP
  |
  • SNAPSHOT_LOCK
  |
  • SNAPSHOT_TABLE
  |
  • SNAPSHOT_TBREORG
  |
  • SNAPSHOT_SUBSECT
  |
  • SNAPSHOT_DYN_SQL
  |
  • HEALTH_DBM_INFO
  |
  • HEALTH_DBM_HI
  |
  • HEALTH_DBM_HI_HIS
  |
  • HEALTH_DB_INFO
  |
  • HEALTH_DB_HI
  |
  • HEALTH_DB_HI_HIS
  |
  • DB_PARTITIONS
  |
  • GROUPS_FOR_USER
  |
  • DB_PARTITION
|
• 将以下函数更改为使用模式 db2schema 而不是废弃不用的 db2schem，并使它们能修改 SQL 数据： |
  |
  • SQLTABLES
  |
  • SQLTABLEPRIVILEGES
  |
  • SQLSTATISTICS
  |
  • SQLSPECIALCOLUMNS
  |
  • SQLPROCEDURES
  |
  • SQLPROCEDURECOLS
  |
  • SQLPRIMARYKEYS
  |
  • SQLFOREIGNKEYS
  |
  • SQLCOLUMNS
  |
  • SQLCOLPRIVILEGES
|
• 将以下函数更改为使用模式 db2schema 而不是已经废弃的模式 db2schem： |
  |
  • SQLUDTS
  |
  • SQLGETTYPEINFO

|>>-db2updv8-- -d--database-name--------------------------------->
| 
|>--+----------------------------+--+-----+---------------------><
|   '- -u--userid-- -p--password-'  '- -h-'
| 

db2updv8 -d sample

格式化陷阱文件（Windows）

现有新工具 db2xprt.exe 可供您格式化陷阱文件（*.TRP）。此工具会将 DB2 通用数据库的二进制陷阱文件格式化为可供人们阅读的 ASCII 码文件。陷阱文件在缺省情况下位于实例目录（DB2INSTPROF）中，在设置了 DIAGPATH 数据库管理器配置参数的情况下在诊断数据目录路径中。

>>-db2xprt--+----------+--+----+--+----+--infile--+---------+--><
            +-/p--path-+  '-/m-'  '-/n-'          '-outfile-'
            '-/v-------'