DFHSTUP 程序的控制参数

您可以使用此处描述的参数来控制 DFHSTUP 程序的统计信息输出。

如果仅希望使用大写形式的统计信息输出，那么必须首先在参数列表中对 UPPERCASE=YES 参数进行编码。如果不编码任何参数， DFHSTUP 程序会将所有 APPLID 的所有集合类型格式化为 60 行的页面大小。

有关用于运行 DFHSTUP 程序的作业的信息，请参阅运行 DFHSTUP 程序的作业。

DFHSTUP 报告按以下类型顺序列出统计信息记录:

统计信息域（statistics domain）
事务管理器
事务类
调度器
MVS TCB（不在简要报告中）
恢复管理器
入队管理器
监视
存储管理器 DSA
存储管理器任务子池
存储管理器域子池
装入程序
LIBRARY 资源 (不在摘要报告中)
临时存储器
瞬时数据
VTAM ® (现在为 z/OS® Communications Server)
终端自动安装
程序自动安装
系统转储
事务转储
表管理器
事务
程序定义
Program
文件
LSRPOOL
LSRpool 文件
瞬时数据队列
Journalname
记录器
日志流
IBM® MQ 连接
IBM MQ 监视器
Db2® 连接
Db2 条目
TCP/IP
TCP/IP 服务
ASYNCSERVICE
IPCONN 资源
BUNDLE 资源
URIMAP 资源
PIPELINE 资源
WEBSERVICE 资源
ATOMSERVICE 资源
XMTRANSFORM 资源
DOCTEMPLATE 资源
事件处理
EVENTBINDING 资源
CAPTURESPEC 资源
JVMSERVER 资源
NODEJSAPP 资源
JVMPROGRAM 资源
POLICY 资源
终端
ISC/IRC 系统和方式项
ISC/IRC 连接时间安全性
DBCTL
FEPI 池
FEPI 连接
FEPI 目标
用户域
安全域

对于支持作为平台上部署的应用程序的专用资源的资源类型，将报告公共资源和专用资源的统计信息。首先显示该类型的公共资源的统计信息，然后显示该类型的专用资源的统计信息。

参数

大写 = 是

指定统计信息输出仅为大写。必须将参数编码为大写字符，并且单词之间没有空格。参数必须是参数列表中编码的第一个参数。如果要以混合大小写形式输出 (缺省值) ，请不要对此参数进行编码。在 EXTRACT 报告中将忽略此参数。

SELECT APPLID={applid|(applid1[,applid2]..[,applidN])}

指定要格式化并打印其统计信息的 CICS® 区域的 APPLID。参数关键字必须按所示进行编码，两个词之间有一个空白。仅对一个 SELECT APPLID 参数或一个 IGNORE APPLID 参数进行编码，最多包含 2000 个 APPLID。如果指定两个或多个 APPLID ，那么必须将它们括在括号中，并以逗号分隔。如果指定超过 2000 个 APPLID ，那么结果不可预测。

如果使用通用 APPLID 和特定 APPLID 来定义 CICS 区域，那么它是必须在 SELECT APPLID 参数上指定的特定 APPLID。

如果不对此参数进行编码，那么 DFHSTUP 程序将报告在 DFHSTATS 数据集中找到的所有 APPLID 的统计信息，但在 IGNORE APPLID 参数上指定的那些 APPLID 除外。

IGNORE APPLID={applid|(applid1[,applid2]..[,applidN])}

指定要忽略其统计信息的 CICS 区域的 APPLID。参数关键字必须按所示进行编码，两个关键字之间有一个空白。仅对一个 SELECT APPLID 参数或一个 IGNORE APPLID 参数进行编码，最多包含 2000 个 APPLID。如果指定两个或多个 APPLID ，那么必须将它们括在括号中，并以逗号分隔。如果指定超过 2000 个 APPLID ，那么结果不可预测。

如果使用通用 APPLID 和特定 APPLID 来定义 CICS 区域，那么它是必须在 IGNORE APPLID 参数上指定的特定 APPLID。

如果不对此参数进行编码，那么 DFHSTUP 程序将根据 SELECT APPLID 参数报告 DFHSTATS 数据集中找到的所有 APPLID 的统计信息。

SELECT TYPE={type|(type1[,type2]...[,typeN])}

指定要格式化并打印其统计信息的资源类型。参数关键字必须按所示进行编码，两个词之间有一个空白。如果指定两个或更多资源类型，那么必须将它们括在括号中，并以逗号分隔。

对 SELECT TYPE 参数或 IGNORE TYPE 参数进行编码，但不能同时对两者进行编码。

如果不对此参数进行编码，那么 DFHSTUP 程序将报告在 DFHSTATS 数据集中找到的所有资源类型的统计信息，但在 IGNORE TYPE 参数上指定的资源类型除外。

可以在 SELECT TYPE 参数上编码的资源类型显示在以下列表中:

ASYNCSERVICE
ATOMSERVICE
自动安装
BUNDLE
CAPTURESPEC
CONNECTION
DBCTL
DB2
DB2CONN ( Db2的子集，包括 Db2 连接统计信息，但省略 Db2 条目统计信息)
DISPATCHER
DOCTEMPLATE
ENQUEUE
EPADAPTER
EVENTBINDING
EVENTPROCESS
FEPI
FILE
JOURNAL
JVMPROGRAM
JVMSERVER
LIBRARY
LOADER (PROGRAM 的子集，包括装入程序全局统计信息，但不包括程序统计信息)
LOGSTREAM
LSRPOOL
MONITOR
MQCONN
MQMONITOR
MVSTCB
NODEJSAPP
OVERVIEW (由事务管理器全局统计信息，分派器全局统计信息，装入器全局统计信息和存储管理器 DSA 统计信息组成的摘要)
PIPELINE
POLICY
进展
PROGRAM
PROGRAMDEF
SECURITY
统计
STORAGE
SYSDUMP
表 MGR
TCPIP
TCPIPSERV
TDQUEUE
TERMINAL
TRANCLASS 或 TCLASS
TRANDATA (TDQUEUE 的子集，包括瞬时数据全局统计信息，但不包括瞬时数据资源 (队列) 统计信息)
TRANDUMP
TRANMGR (TRANSACTION 的子集，包括事务管理器全局统计信息，但不包括事务管理器资源统计信息)
TRANSACTION
TSQUEUE
URIMAP
USER
VTAM (现在为 z/OS Communications Server)
WEBSERVICE
XMLTRANSFORM

对于作为平台上部署的应用程序的专用资源而受支持的资源类型，当您选择资源类型时，将报告公共资源和专用资源的统计信息。该类型的公共资源的统计信息首先出现在报告中，其次是该类型的私有资源的统计信息。

When you use SELECT TYPE, if you want to reduce the size of your statistics reports you can code the summary resource types DB2CONN, LOADER, TRANMGR, and TRANDATA instead of the complete resource types DB2, PROGRAM, TDQUEUE, and TRANSACTION. 要获取概述统计信息报告 (包括 "事务管理器全局统计信息" ， "分派器全局统计信息" ， "装入器全局统计信息" 和 "存储管理器统计信息") ，请对 OVERVIEW 资源类型进行编码。

IGNORE TYPE={type|(type1[,type2]...[,typeN])}

指定要忽略其统计信息的资源类型。参数关键字必须按所示进行编码，两个关键字之间有一个空白。如果指定两个或更多资源类型，那么必须将它们括在括号中，并以逗号分隔。

对 SELECT TYPE 参数或 IGNORE TYPE 参数进行编码，但不能同时对两者进行编码。当您使用 IGNORE TYPE 时，可以对 SELECT TYPE 参数的上面列出的大部分资源类型进行编码，对于 OVERVIEW 资源类型和摘要资源类型 ($TAG3 DB2CONN $TAG4 ， LOADER ， TRANMGR 和 TRANDATA) 的资源类型除外。 IGNORE TYPE 参数只能用于忽略完整资源类型; 它不会忽略作为子集或其他资源类型组合的资源类型。

如果不对此参数进行编码，那么 DFHSTUP 程序将根据 SELECT TYPE 参数报告 DFHSTATS 数据集中找到的资源类型的统计信息。

COLLECTION TYPE = {ALL| [， INT] [， EOD] [， REQ] [， RRT] [， USS]}

根据所选 APPLID 的收集类型，指定要包含在其格式化报告中的统计信息记录。参数关键字必须按所示进行编码，两个词之间有一个空白。操作数如下所示:

全部: 对所有指定 APPLID 的所有类型集合的统计信息进行格式化。这通常是缺省值。但是，如果指定了 EXTRACT 控制参数但未指定 COLLECTION TYPE ，那么仅会调用抽取出口，并且不会生成其他统计信息输出。
INT: 对所有选定 APPLID 按指定时间间隔收集的统计信息进行格式化。
EOD: 格式化所有所选 APPLID 的日终类型统计信息。结束日期收集类型是另一个时间间隔收集，是关闭或逻辑结束日期时最后一个时间间隔的统计信息的最终收集。由于收集时间间隔统计信息的指定时间间隔可能尚未过去，因此跨日终收集的实际时间间隔可以是较短的时间间隔。
REQ: 格式化所有选定 APPLID 的所请求统计信息。
RRT: 格式化所有选定 APPLID 的请求重置统计信息。这些是使用 CEMT 或 EXEC CICS PERFORM STATISTICS RESETNOW 命令所要求的统计信息，或者在更改统计信息记录状态时使用 CEMT 或 EXEC CICS SET STATISTICS ON|OFF RECORDNOW RESETNOW 命令所要求的统计信息。
USS: 格式化所有选定 APPLID 的自发统计信息。 CICS 针对动态分配和取消分配的资源收集主动统计信息。有关主动提供的统计信息记录类型的完整描述，请参阅 CICS 统计信息简介。

抽取用户程序 =progname

指定可以处理统计信息记录以创建统计数据报告的用户程序，允许您生成定制的统计信息报告。

ProgName: 要处理由 EXTRACT 命令检索的数据的用户编写的程序的名称。必须提供 PROGNAME 值。

指定 EXTRACT 出口命令将更改缺省 DFHSTUP 报告设置。如果仅指定 EXTRACT 出口，那么仅驱动抽取出口; 将禁止其他 DFHSTUP 报告。如果指定了 EXTRACT 控制语句，那么还必须指定其他统计信息报告控制语句 (例如 SUMMARY) ，以确保生成相应的报告。请参阅 DFHSTUP 抽取统计信息报告功能以获取指导信息。

TIME START =hh.mm.ss，STOP=hh.mm.ss，耗用| DAILY

指定 DFHSTUP 程序仅打印在指定时间段内收集的统计信息。该时间段由 START 时间到 STOP 时间，耗用 | DAILY 关键字和 DATE 参数的组合确定，如下所示:

耗用时间: 这是缺省值。如果对耗用进行了编码，那么 DFHSTUP 程序将处理 DATE START 和 TIME START 之间的每条统计信息记录，直到 DATE STOP 和 TIME STOP 为止。
每日: 如果对 DAILY 进行了编码，那么 DFHSTUP 程序将处理每天在指定的 DATE START 和 DATE STOP 之间的 TIME START 和 TIME STOP 之间的每条统计信息记录。

如果未对 DATE 参数进行编码，那么将打印在指定时间段内收集的统计信息，而不考虑收集这些统计信息的日期。参数关键字必须完全按照所示进行编码，在前两个词之间有一个空白，并且同时指定了 START 和 STOP 时间。必须将开始时间和停止时间指定为:

hh.mm.ss

其中：

hh = 小时数 (24 小时制表示法)
mm = 分钟数
ss = 秒数。

注：

如果指定的时间段 (START 时间到 STOP 时间) 跨越午夜，那么还必须对 DATE 参数进行编码。
如果在指定时间段 (START 时间到 STOP 时间) 内未收集时间间隔统计信息并将其写入 SMF 数据集，那么 DFHSTUP 报告可能不会显示您要查找的信息。要查看特定信息项，请确保指定的时间段涵盖包含所需项的统计信息收集。
例如，您可能希望查看与在 10:15 运行的事务相关的统计信息。如果记录时间间隔设置为缺省值 1 小时，那么时间间隔统计信息将在 10:00 写入 SMF 数据集，并在 11:00 再次写入 SMF 数据集。如果运行 DFHSTUP 程序并指定 START 时间 09:30 和 STOP 时间 10:30 ，那么 DFHSTUP 报告将不会显示与在 10:15 运行的事务相关的统计信息，因为该时间段内的 SMF 数据集仅包含在 10:00 收集的时间间隔统计信息。与在 10:15 运行的事务相关的统计信息将在下次统计信息收集时 (11:00) 写入 SMF 数据集。

统计信息收集的时间由 STATINT 和 STATEOD 系统初始化参数控制。您还可以随时使用 CEMT 或 EXEC CICS 命令 PERFORM STATISTICS RECORD来执行统计信息收集。例如，为了避免等到 11.00 查看与在 10:15 运行的事务相关的统计信息，您可以使用 PERFORM STATISTICS RECORD 命令立即记录统计信息，然后运行 DFHSTUP 程序，并指定包含您输入该命令的时间的时间段。

示例：

要处理在 10th 10:00 和 16th 20:00 之间写入的每条统计信息记录，您可以对以下 TIME 和 DATE 控制语句进行编码:
```
TIME START=10.00.00,STOP=20.00.00,ELAPSED
DATE START=09/10/2011,STOP=09/16/2011
```
要处理从 2011 年 9 月 10th 开始到 2011 年 9 月 16th 开始每天 10:00 小时到 20:00 小时之间写入的每条统计信息记录，您可以对以下 TIME 和 DATE 控制语句进行编码:
```
TIME START=10.00.00,STOP=20.00.00,DAILY
DATE START=09/10/2011,STOP=09/16/2011
```

DATE START =mm/dd/yy 或 mm/dd/yyyy， STOP=mm/dd/yy 或 mm/dd/yyyy

指定 DFHSTUP 程序仅打印在指定时间段 (START 日期到 STOP 日期) 内收集的统计信息。此参数应与 TIME 参数配合使用。如果未对 TIME 参数进行编码，那么将打印在指定时间段内的任何时间收集的统计信息。参数关键字必须完全按照所示进行编码，在前两个词之间有一个空白，并且同时指定了 START 和 STOP 日期。开始日期和停止日期必须指定为:

mm/dd/yy 或 mm/dd/yyyy

其中：

mm = 一年中的月份
dd = 月中的第几天
yy = 二十一世纪的年份
yyyy = 年

如果将 yy 编码为 21 世纪。例如，日期 12/20/16 表示 2016 年 12 月 20th ，日期 12/20/1996 表示 1996 年 12 月 20th 。

PAGE SIZE=number

指定每页要格式化的行数，范围在 20 到 99 之间。缺省页面大小为 60 行。

摘要

指定 DFHSTUP 程序将为所选的每个 APPLID 生成摘要报告。摘要报告是通过添加时间间隔中包含的统计信息，请求的重置，日终和非请求集合组成的。摘要报告统计信息以与时间间隔和日终报告几乎相同的顺序列出。唯一的区别是 DBCTL 统计信息出现在摘要的末尾。仅主动提供 DBCTL 统计信息，因此您不会在时间间隔，请求的重置或日终收集中获取这些统计信息。

注: 在 SELECT TYPE (LSRPOOL) 的摘要报告中生成的统计信息不包含各个 LSR 池的缓冲区信息。

如果 SMF 数据集 (或数据集) 包含来自多次运行具有相同 APPLID 的 CICS 的 CICS 统计信息，那么必须使用 TIME 参数以及 DATE 参数 (如果需要) 来生成一次运行 CICS的摘要报告。如果不使用 TIME 和 DATE 参数来指定 CICS的几次运行之一，那么结果不可预测。

如果对此参数进行编码并省略 COLLECTION TYPE 参数，那么可以显着减少输出。

如果未对此参数进行编码，那么不会生成摘要报告。