-DISPLAY STATS 命令 ( )Db2

-DISPLAY STATS 命令显示 Db2 对某些进程的资源使用情况。

缩写 :-DIS STATS

环境 -DISPLAY STATS

该命令可从 z/OS® 控制台、TSO 下的 DSN 会话、面板 ( DB2I 面板 ( DB2 COMMANDS)、 IMS 或 CICS® 终端,或使用仪器设施接口 (IFI) 的程序。

数据共享范围 :集团

授权 -DISPLAY STATS

要执行此命令,您必须使用包含以下权限或授权之一的进程特权集:

  • 显示特权
  • 系统 DBADM 权限
  • 系统管理员权限
  • SYSCTRL 权限
  • SYSADM 权限

语法 -DISPLAY STATS

阅读语法图跳过可视化语法图 DISPLAY STATS (INDEXMEMORYUSAGE)(INDEXTRAVERSECOUNT)索引-遍历-计数-规格(LOGREADERTASKS)SCOPE(GROUP)LIMIT(整数*)
索引-遍历-计数-规格
阅读语法图跳过可视化语法图 DBNAME(*, 数据库名称dbname1: dbname2dbname** dbname* dbname** dbstring1* dbstring2*) SPACENAM(*,空间名称spacename1: spacename2spaceName** spaceName* spaceName** spacestring1* spacsetsring2*) PART(,整数integer1: integer2)

选项说明 -DISPLAY STATS

索引 内存 使用
指定显示 Db2 用于快速遍历索引的当前内存使用量的统计信息。

缩写 :IDXMEMUSE或IMU

更改开始索引 反向 计数更改结束
更改开始更改开始指定特定指数或特定数量指数中FTB因子(按降序排列)的显示。更改结束 以下变体可以接受:

缩写 :IDXTRAVCNT或ITC

dbname
指定一个或多个数据库,显示其索引遍历计数。

缩写 :DBN

以下变体可以接受:

(数据库名称……)
识别一个或多个数据库名称,以逗号或空格分隔。
(*)
所有定义为 Db2 子系统的数据库,其进程的权限集具有所需的授权。
(dbname1 :dbname2 )
所有数据库的名称在UNICODE中的编码介于 dbname1dbname2 之间的数据库。
数据库名称 *)
所有名称以dbname 开头的数据库,包含1-7个字符。
*数据库名称
所有数据库名称以字符串 “dbname” 结尾,包含1-7个字符。
*数据库名 *)
所有名称包含字符串 dbname 的数据库,其中 dbname 包含1-6个字符。
(* 数据库字符串 1 * 数据库字符串 2 *)
所有名称中包含字符串 dbstring1dbstring2 且总共包含2-5个字符。
空间
指定一个或多个索引,显示索引遍历计数。

缩写 :SPACE或SP

以下变体可以接受:

(空间名称……)
一个或多个带逗号或空格的索引空间名称。
(*)
所有索引空间都定义为 Db2 子系统,且该进程的权限集具有所需的授权。
空间名称1 :空间名称2
所有索引空间,其名称在UNICODE中的范围在 spacename1spacename2 之间的索引空间。
空间名称 *)
所有索引空间,其名称以包含1-7个字符的字符串spacename 开头。
*地名
所有索引空间,其名称以包含1-7个字符的字符串spacename 结尾。
*地名
所有索引空间,其名称包含字符串spacename ,字符串包含1-6个字符。
*空格字符串1*空格字符串2 *)
所有名称中包含字符串 spacestring1spacestring2 且长度为2-5个字符的索引空间。
部分
指示要显示的一个或多个分区的分区号。

指定的整数 必须为对应空间名称和数据库名称指定一个有效的分区编号。 整数 可以写成以下值之一:

  • 一个或多个分区的列表
  • 所有大于或等于整数1 且小于或等于整数2的分区编号 integer2
  • 列表和范围组合
更改结束
更改开始日志阅读器任务更改结束
更改开始指定显示日志读取任务(SRB)的统计信息。

缩写 :LOGREADER或LRT

更改开始
范围(组)
指定LOGREADERTASKS时,指定命令的范围。 显示数据共享组中所有活跃成员正在运行的日志读取器任务的信息。 当指定了 INDEXMEMORYUSAGE 或 INDEXTRAVERSECOUNT 时,不能指定 SCOPE(GROUP)。 在非数据共享环境中,该选项将被忽略。
更改结束 更改结束
LIMIT
限制显示的消息数量。
整数
最多显示的消息数量。 该数值必须在1-9999之间。 可显示的最大消息数量受可用空间限制。
( * )
将显示限制在可用空间可容纳的消息数量内。

输出 -DISPLAY STATS

DISPLAY STATS 命令输出的信息因您在命令中指定的选项关键字而异。 有关更多信息,请参阅以下各节:

-DISPLAY STATS(INDEXMEMORYUSAGE) 的输出结果

DSNT783I 消息显示DISPLAY STATS(INDEXMEMORYUSAGE)命令的输出。 输出提供以下有关正在使用快速索引遍历(FTB)的索引的信息:

DBID  PSID  DBNAME   IX-SPACE LVL PART SIZE(KB)
----- ----- -------- -------- --- ---- --------
00279 00005 DB1      IX1      003 0001 00000816
******* DISPLAY OF STATS ENDED **************

输出行按降序排列,从使用最大内存量的快速索引遍历索引,到使用最小内存量的快速索引遍历索引。

DBID
包含索引的数据库的内部标识符。
PSID
索引空间的页面集描述符。
dbname
包含索引的数据库名称。
IX-SPACE
索引空间的名称。
LVL
更改开始使用快速索引遍历的索引中的索引级数。 用于快速索引遍历的 FTB(快速遍历块)包含根索引页和非叶子索引页的信息,但不包含叶子页的信息。更改结束
部分
索引分区号。
大小 (KB)
用于快速索引遍历的内存量(以千字节为单位)。

多个连续索引分区的输出,内存使用情况统计相同

索引的n个分区具有相同的内存使用统计信息时,输出中仅显示第一个分区的行,其余分区的行将被忽略。 这些行被替换为以下输出:

-THRU n

n是最后一个分区,其内存使用统计信息相同。

输出状态

输出继续或以下面的信息结束:

******* DISPLAY OF STATS status ***********************************
状态
可能的值包括:
表示将显示更多信息。
已终止
表示所有信息均已显示。

用于显示快速索引遍历(INDEXMEMORYUSAGE)内存使用情况的示例

  • 您可以使用DISPLAY STATS命令显示 Db2 正在使用快速索引遍历 (有时称为快速遍历块FTB )的所有索引的相关信息。假设您发出以下命令:

    -DISPLAY STATS(INDEXMEMORYUSAGE)

    假设在您发出命令的 Db2 子系统中,快速索引遍历所使用的唯一索引有五个索引页级别和一个分区,并使用 18339 KB 内存进行快速索引遍历。 结果与以下输出类似:

    更改开始
    
    DSNT783I -
    DBID  PSID   DBNAME   IX-SPACE LVL PART SIZE(KB)
    ----- ----- -------- -------- --- ---- --------
    00278 00005 DB1      IX1      005 0001 00018339
    ******* DISPLAY OF STATS ENDED **************
    DSN9022I - DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION
    
    更改结束
  • 现在假设您在 Db2 子系统上运行 -DISPLAY STATS(INDEXMEMORYUSAGE) 命令,该子系统正在对索引的五个分区进行快速索引遍历,并且索引页的级别数和用于快速索引遍历的内存量对所有分区都是相同的。 结果与以下输出类似:

    更改开始
    
    DSNT783I -
    DBID  PSID  DBNAME   IX-SPACE LVL PART SIZE(KB)
    ----- ----- -------- -------- --- ---- --------
    00017 00005 DB1      IX1      003 0006 00000061
        -THRU                       0010         
    ******* DISPLAY OF STATS ENDED **************
    DSN9022I - DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION
    
    更改结束

-DISPLAY STATS(INDEXTRAVERSECOUNT) 的输出结果

DSNT830I 消息显示DISPLAY STATS(INDEXTRAVERSECOUNT)命令的输出。

更改开始输出结果提供了有关一个或多个指定索引的索引遍历次数和 FTB 因子的以下信息。 如果包含多行,则按降序排列,从 FTB 系数最高的索引开始。更改结束

DBID
包含索引的数据库的内部标识符。
PSID
索引空间的页面集描述符。
dbname
包含索引的数据库名称。
IX-SPACE
索引空间的名称。
LVL
更改开始使用快速索引遍历的索引中的索引级数。 用于快速索引遍历的 FTB(快速遍历块)包含根索引页和非叶子索引页的信息,但不包含叶子页的信息。更改结束
部分
索引分区号。
TRAV。 计数
指数空间指数遍历次数的移动平均值。
更改开始外债系数更改结束
更改开始Db2 会根据索引遍历次数和其他因素(如索引页面拆分)计算 FTB 因子值,并在内部将其用作权重,以评估特定索引是否能从索引遍历中获益。更改结束
更改开始

显示索引遍历次数(INDEXTRAVERSECOUNT)的示例

  • 更改开始显示特定索引分区的遍历次数和 FTB 因子
    -DISPLAY STATS(INDEXTRAVERSECOUNT) DBNAME(DB1) SPACENAM(IX1) PART(1)

    示例命令返回类似以下内容的输出:

    DBID  PSID  DBNAME   IX-SPACE LVL PART TRAV. COUNT FTB FACTOR 
    ----- ----- -------- -------- --- ---- ----------- -----------  
    00017 00005 DB1      IX1      003 0001 00000000999 -0000000001 
    ******* DISPLAY OF STATS ENDED ***************************** 
    更改结束
  • 显示五个FTB系数最高的索引空间:

    -DISPLAY STATS(ITC) DBNAME(DB1) LIMIT(5)

    示例命令返回的输出类似于以下输出,其中索引从最高 FTB 因子开始按降序排列:

    更改开始
    Output (traverse counts are in descending order)
    DBID  PSID  DBNAME   IX-SPACE LVL PART TRAV. COUNT FTB FACTOR 
    ----- ----- -------- -------- --- ---- ----------- ----------- 
    00017 00005 DB1      IX2.     003 0008 00000030021 00000030021 
    00017 00005 DB1      IX2      003 0016 00000029999 00000029999 
    00017 00005 DB1      IX3      003 0001 00000000999 00000000999 
    00017 00005 DB1      IX1      003 0001 00000050099 00000000000 
    00017 00005 DB1      IX2      003 0010 00000050001 -0000000001 
    ******* DISPLAY OF STATS ENDED ***************************** 
    更改结束
更改结束

-DISPLAY STATS(LOGREADERTASKS)的输出结果

DSNT788I 消息是应DISPLAY STATS(LOGREADERTASKS)命令发出的。 它以以下格式提供当前所有日志读取任务会话的信息:
DSNT788I  -SSID 
SESSIONID        STATUS     CURR. POSITION       NUM RECS   AGE
  CORR-ID        LOCATION 
---------------- ---------- -------------------- ---------- ------
EE00982796560801 READING    0000000000018898F400 32071      89s
  014.LGRTSK01   SVLSSC0A
EE00DAC3E7842E02 SUSP EOS   00000000000188CA2280 30         6s
  014.LGRTSK02   DG653758
******* DISPLAY OF STATS ENDED     *********************************
DSN9022I  -SSID DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION          
sessionID
唯一会话ID,用于识别日志读取任务。
状态
日志读取任务的当前状态:
正在运行
日志读取任务正在读取日志记录。
读取
日志读取任务正在等待接收和合并日志记录。
暂停阅读
内部缓冲区已满,因为数据接收速度不够快。
SUSP EOS
日志已结束。 日志读取任务正在等待新的日志记录。
货币 位置
当前RBA或LRSN在日志记录中读取日志的任务位置。
数量
已收到的记录数量。
AGE
自开始日志读取任务以来已过去的时间。
CORR-ID
用于识别系统任务的关联ID。 CORR-ID以 014.LGRTSK 开头,后跟一个两位数字,以使其独一无二。
位置
启动异步日志读取器任务的 IBM® Db2 Analytics Accelerator for z/OSIBM Db2 for z/OS Data Gate 实例的名称。 如果因传输错误导致名称不可用,则 LOCATION 将显示远程请求者的 IP 地址。
更改开始

显示日志读取任务(LOGREADERTASKS)信息的示例

  • 在本地 Db2 子系统上显示日志读取任务的状态信息:

    -DISPLAY STATS(LRT)

    DISPLAY STATS(LOGREADERTASKS)命令的输出结果与以下输出类似:

    DSNT788I  -DB2A 
    SESSIONID        STATUS     CURR. POSITION       NUM RECS   AGE
      CORR-ID        LOCATION 
    ---------------- ---------- -------------------- ---------- ------
    EE00982796560801 READING    0000000000018898F400 32071      89s
      014.LGRTSK01   SVLSSC0A
    EE00DAC3E7842E02 SUSP EOS   00000000000188CA2280 30         6s
      014.LGRTSK02   DG653758
    ******* DISPLAY OF STATS ENDED     *********************************
    DSN9022I  -DB2A DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION          

    请参阅 DSNT788I 查看返回信息的描述。

  • 显示数据共享组中所有活跃成员正在运行的日志读取器任务的信息:

    -DISPLAY STATS(LRT) SCOPE(GROUP)

    DISPLAY STATS(LOGREADERTASKS)命令与SCOPE(GROUP)选项的输出结果与以下输出结果类似:

    DSNT788I  -DB2A 
    SESSIONID        STATUS     CURR. POSITION       NUM RECS   AGE
      CORR-ID        LOCATION 
    ---------------- ---------- -------------------- ---------- ------
    EE00982796560801 READING    00D9EE0DADE987256200 32071      89s
      014.LGRTSK01   SVLSSC0A
    EE00DAC3E7842E03 SUSP EOS   00D9EE0DADE9872CA200 30         6s
      014.LGRTSK03   DG653758
    ******* DISPLAY OF STATS ENDED     *********************************
    DSN9035I  -DB2A BEGIN OF DISPLAY FOR MEMBER: DB2B
    ---------------------------------------------------           
    DSNT791I  -DB2B NO LOG READER TASK STATISTICS AVAILABLE       
    --------END OF DISPLAY FOR MEMBER: DB2B    --------           
    DSN9035I  -DB2A BEGIN OF DISPLAY FOR MEMBER: DB2C
    ---------------------------------------------------           
    SESSIONID        STATUS     CURR. POSITION       NUM RECS   AGE
      CORR-ID        LOCATION 
    ---------------- ---------- -------------------- ---------- ------
    EE00DAC2F9812803 SUSP EOS   00D9EE0DADE9872CA200 30         6s
      014.LGRTSK03   DG658121
    ******* DISPLAY OF STATS ENDED     *********************************
    --------END OF DISPLAY FOR MEMBER: DB2C    --------                 
    DSN9022I  -DB2A DSNTDSTS 'DISPLAY STATS' NORMAL COMPLETION          
    

    请参阅 DSNT788I 查看返回信息的描述。

更改结束