DFHSTUP 程序的控制参数
您可以使用此处描述的参数来控制 DFHSTUP 程序的统计信息输出。
如果仅希望使用大写形式的统计信息输出，那么必须首先在参数列表中对 UPPERCASE=YES 参数进行编码。 如果不编码任何参数， DFHSTUP 程序会将所有 APPLID 的所有集合类型格式化为 60 行的页面大小。
有关用于运行 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 资源
- JVMPROGRAM 资源
- 终端
- ISC/IRC 系统和方式项
- ISC/IRC 连接时间安全性
- DBCTL
- FEPI 池
- FEPI CONNECTION
- FEPI TARGET
- 用户域
对于支持作为平台上部署的应用程序的专用资源的资源类型，将报告公共资源和专用资源的统计信息。 首先显示该类型的公共资源的统计信息，然后显示该类型的专用资源的统计信息。
参数
- 大写 = 是
指定统计信息输出仅为大写。 必须将参数编码为大写字符，并且单词之间没有空格。 参数必须是参数列表中编码的第一个参数。 如果要以混合大小写形式输出 (缺省值) ，请不要对此参数进行编码。 在 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
- OVERVIEW (由事务管理器全局统计信息，分派器全局统计信息，装入器全局统计信息和存储管理器 DSA 统计信息组成的摘要)
- PIPELINE
- 进展
- PROGRAM
- PROGRAMDEF
- 统计
- 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
对于作为平台上部署的应用程序的专用资源而受支持的资源类型，当您选择资源类型时，将报告公共资源和专用资源的统计信息。 该类型的公共资源的统计信息首先出现在报告中，其次是该类型的私有资源的统计信息。
使用 SELECT TYPE 时，如果要减小统计信息报告的大小，可以对摘要资源类型 DB2CONN， LOADER ， TRANMGR 和 TRANDATA 进行编码，而不是对完整的资源类型 $TAG3 DB2 $TAG4 ， PROGRAM ， TDQUEUE 和 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 之间的每条统计信息记录。
- 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 控制语句进行编码:
时间 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 控制语句进行编码:
时间 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 参数，那么可以显着减少输出。
如果未对此参数进行编码，那么不会生成摘要报告。