DFHTU710 的跟踪选择参数
使用跟踪选择参数来定义要在页面上打印的行数,并定义要选择要打印的跟踪记录。 在 DFHAXPRM DD 语句或 PARM 参数中对跟踪选择参数进行编码。
//PRINT EXEC PGM=DFHTU710,PARM='selection_parameter,selection_parameter,...'- ABBREV | SHORT |FULL
- 指定要打印的每个跟踪条目的数量。 如果指定此语句,那么它必须始终是 PARM 参数或 DFHAXPRM 数据集中的第一个语句。
- ABBREV
- 指示您需要简写的,每条目一行的跟踪打印形式。
- Short
- 指示您需要每个条目中数据的短格式打印。 这由简写格式条目中的信息以及完全格式化条目的解释字符串中的以下元素组成:
- 已解释的参数列表
- 退货地址
- 时间
- 时间间隔
- 完全
- 指示您希望对每个条目中的所有数据进行完全格式化的打印。 这是缺省值。
- ALL
- 指定打印辅助跟踪数据集中的所有跟踪条目。 这是缺省值。
- ENTRY_NUM = ({nnnnn|nnnnn-nnnnnnn} [, {nnnnnnn|nnnnnnn} ,. ,.])
- 指定要打印的一个或多个跟踪条目的序号。 每个序号的长度最多可以为 7 位数字。 如果使用 xxxxxxx-yyyyyyy指定一系列序号,那么第二个序号 (yyyyyyy) 必须大于第一个序号 (xxxxxxx)。注: 如果存在多个 9999999 跟踪条目,并且需要打印第一个 9999999 以外的任何条目,请使用备用跟踪选择参数。 将仅打印数字从 000001 到 9999999 的第一组条目。
- EXCEPTION
- 指定仅打印辅助跟踪数据集中的异常跟踪条目。注: 此参数对于打印 GTF 跟踪条目无效。
- INTERVAL = {0.0128|number of seconds}
- 指定辅助跟踪条目之间的时间间隔,之后使用星号突出显示条目,如下所示:
- 在简写的跟踪格式中,星号显示在序号的左边。
- 在完整跟踪格式中,星号显示为打印时间间隔之后的下一个字符。
如果以等于或大于此限制的时间间隔写入连续辅助跟踪条目,那么将以相同的方式突出显示这些条目。
如果以小于此限制的时间间隔写入连续辅助跟踪条目,那么不会突出显示这些条目。 但是,它们是书面的,格式化的和印刷的。
如果未指定 INTERVAL 值,那么将应用缺省值 0.0128 秒。
您可以指定范围在 0 秒 (突出显示所有跟踪条目) 到 99.9999999999 秒之间的时间间隔值。
注: 时间间隔扩展到十个小数位。 从右边填充零。 - KE_NUM = (xxxx[,xxxx,. ,.])
- 指定仅打印具有指定十六进制内核任务号的任务的条目。
- LAST_BLOCKS=n
- 对于内部跟踪,指定仅打印跟踪表的最后一个 n 块,从内部跟踪表中最近使用的块计数。 您可以指定 1 到 262144 范围内的值。
如果未指定此参数,那么将格式化所有块。
您可以使用此参数来减少与在系统转储中格式化大型内部跟踪表相关联的存储和时间需求。 要确定要打印的块数以查看所需的跟踪条目,请允许每个块大约有 25 个条目。
此参数不适用于事务转储,辅助跟踪或 GTF 跟踪中的跟踪。
- PAGESIZE = (值)
- 指定页面上打印的行数。 您可以指定每页 20 到 9999 行范围内的值。 如果指定了不正确的值,那么 CICS 会发出错误消息并停止跟踪。 缺省值为 55。注: 此参数对于打印 GTF 跟踪条目无效。
- TASKID = ({id|id-id} [,, {id|id-id} ,. , ..])
- 指定要为其打印跟踪条目的一个或多个任务的任务标识。 标识值可以采用以下任何格式,以与格式化跟踪数据中的任务字段进行比较:
- 长度不超过五位小数的任何数字
- 任何字符串 JAS , J01 到 J99, III , TCP 或 DSTCB
- 连接域 (针对非 TCA) 任务的任何非数字双字符域标识。
可以使用连字符 (例如, TASKID=nnnnnn-nnnnnn) 来指定五位十进制数字格式的任务标识范围。
- TCB_ID = (aaaaa[,aaaaa,. ,.])
- 指定要打印其跟踪条目的一个或多个 TCB 的 TCB 标识。
- TCB_ADDR = (hhhhhhhhh[,hhhhhhh,. ,.])
- 指定要为其打印跟踪条目的一个或多个 TCB 的地址。
- TERMID = (tttt[,tttt,. ,. ,.])
- 指定要打印其跟踪项的一个或多个终端的终端标识。
如果使用 TERMID 参数指定要格式化的跟踪条目,那么 DFHTU710 程序将选择与它找到的包含您指定的终端标识的任何事务连接跟踪条目相关联的所有跟踪条目。 有关如何使任务的跟踪条目与事务连接跟踪条目相关联的更多信息,请参阅 从其事务连接条目标识跟踪条目。
- TIMERG = (hhmmss-hhmmss[,hhmmss-hhmmss,. ,.])
- 指定要打印跟踪条目的一个或多个时间段。 时间段由以小时数 (hh) ,分钟数 (mm) 和以连字符分隔的秒数 (ss) 表示的值对显示。 每个对的结束值必须晚于起始值。
DFHTU710 程序将跟踪条目中的存储时钟 (STCK) 值转换为整秒,然后再与您指定的时间范围进行比较。 将忽略一秒的分数; 即,将所有时间向下舍入为最接近的整秒,这意味着最小时间范围可以长达两秒。 例如,如果指定 TIMERG=153000-153001,那么 DFHTU710 程序将包含时间为 153000.00000000 到 153001.99999999 (含) 的所有跟踪条目。
注: 此参数对于打印 GTF 跟踪条目无效。 - TRANID = (tttt[,tttt,. ,. ,.])
- 指定要为其打印跟踪条目的一个或多个事务的事务标识。
如果使用 TRANID 参数指定要格式化的跟踪条目,那么 DFHTU710 程序将选择与它找到的包含您指定的事务标识的任何事务连接跟踪条目相关联的所有跟踪条目。 有关如何使任务的跟踪条目与事务连接跟踪条目相关联的更多信息,请参阅 从其事务连接条目标识跟踪条目。
- TYPETR = ({ddxxxx|ddxxxx-xxxx} [, {ddxxxx|ddxxxx-xxxx}])
- 指定特定域条目的跟踪条目标识,由域标识和域内的点标识指定。
- dd
- 表示域标识:
代码 组件名 AP 应用程序域 AS 异步服务 BA 业务应用程序管理器 BF* 内置函数 BM* 基本映射支持 BR* 3270 网桥 CP* 公共编程接口 DC* 转储兼容性层 DD 目录管理器域 (directory manager domain) DH 文档处理域 DI* 数据交换 DM 域管理器域 (domain manager domain) DP 调试概要文件域 DS 分派器域 (dispatcher domain) DU 转储域 (dump domain) EC* 事件捕获和发布 EI* EXEC 接口 EJ Enterprise Java™ 域 EM 事件管理器域 EP 事件处理域 FC* 文件控制 GC 全局目录域 (global catalog domain) IC* 时间间隔控制 IE 采用 TCP/IP 的 ECI 域 IS* ISC 或 IRC KC* 任务控制 KE 内核 LC 本地目录域 (local catalog domain) LD 装入程序域 (loader domain) LG 日志管理器域 LM 锁定域 ME 消息域 (message domain) ML 标记语言域 MN 监视域 MP 受管平台域 NQ 入队域 OT 对象事务域 PA 参数域 PC* 程序控制 PG 程序管理器域 (program manager domain) PI 管道域 PT 合作伙伴域 RA 资源管理器适配器 RI* 资源管理器接口(RMI) RL 资源生命周期域 RM 恢复管理器域 RS 区域状态域 RX RRS 协调的 EXCI 域 RZ 请求流域 SC* 存储器控制 SH 调度程序服务域 SJ JVM 域 SM 存储器管理器域(storage manager domain) SO 套接字域 ST 统计信息域(statistics domain) SZ* 前端编程接口 TC* 终端控制 TD* 瞬时数据 TI 计时器域 (timer domain) TR 跟踪域 (trace domain) TS 临时存储器域 UE* 用户出口接口 US 用户域 WB Web 域 胡胡 CICS® 管理客户机接口 (CMCI) 域 W2 Web 2.0 域 XM 事务管理器域 (transaction manager domain) XS 安全管理器域(security manager domain) 备注信息:- 标记为 * 的组件是 AP 域的子组件。 这些组件的跟踪条目是使用跟踪点标识 AP nnnn生成的。
- 对于 DS 域函数 CHANGE_MODE ,如果 DS 级别 2 或 3 跟踪处于活动状态,那么将生成跟踪条目。
- xxxx
- 以四字符十六进制值 (0000-FFFF) 的格式表示域中的点标识。 可以使用连字符来指定点标识范围。
- 大写
- 指定只需要大写的跟踪输出。 如果需要混合大小写的跟踪输出 (缺省值) ,请不要对此参数进行编码。