SET TRACEDEST

描述

CICS®可以将跟踪条目写入三个可能的目的地：CICS内部跟踪表、辅助跟踪数据集和 MVS 通用跟踪设施 (GTF)。 可以使用 SET TRACEDEST 命令来指定哪些目标接收跟踪条目。 您还可以使用它来更改跟踪表的大小以及切换辅助跟踪数据集。

可以使用其他两个命令 (SET TRACEFLAG 和 SET TRACETYPE) 和 $TAG1 CICS $TAG2 提供的事务 CETR 来控制跟踪条目的数量和类型。

使用此命令进行的更改不会记录在 CICS 目录中。 因此，在 CICS 启动时，会始终将受影响的选项重置为相应的系统初始化值。 这些是 TRTABSZ (用于内部跟踪) ， AUXTR 和 AUXTRSW (辅助跟踪) 以及 GTFTR (GTF 跟踪)。

选项

AUXSTATUS (cvda)

指定是否执行辅助跟踪; 即，是否将跟踪条目写入活动的 CICS 辅助跟踪数据集。 (请参阅 SWITCHACTION 选项以获取有关辅助跟踪数据集的更多信息。) CVDA 值如下：

AUXPAUSE

CICS 停止写入条目，但使数据集在其当前位置保持打开状态。 后续的 AUXSTART 请求将在 AUXPAUSE 请求之前的条目之后立即恢复写入条目。 仅当辅助跟踪当前处于活动状态时，才能指定 AUXPAUSE。

AUXSTART

CICS 开始写入条目。 如果数据集当前已关闭，那么将首先打开该数据集。

AUXSTOP

CICS 停止写入条目。 如果数据集处于打开状态，那么将关闭该数据集。 后续的 AUXSTART 请求会导致 CICS 在数据集开始时写入新条目，从而覆盖先前的内容，除非有两个辅助跟踪数据集并且它们在 AUXPAUSE 和 AUXSTART 之间切换。

GTFSTATUS (cvda)

指定是否将跟踪条目发送到 MVS 通用跟踪设施 (GTF)。 CVDA 值如下：

GTFSTART

将发送条目。

GTFSTOP

未发送条目。

注: GTFSTART 值是必需的，但不足以在 GTF 上记录 CICS 跟踪条目。 此外，必须使用 GTF 支持 (GTFTR 系统初始化选项) 初始化 CICS ，并且必须使用 TRACE=USR 选项在 MVS 中启动 GTF。

INTSTATUS (cvda)

指定是否进行内部跟踪; 即，是否在内部跟踪表中记录非异常跟踪条目。 (将始终记录异常条目。) CVDA 值如下：

INTSTART

将记录条目。

新技术

未记录条目。

SWITCHACTION (cvda)

指定 CICS 必须切换辅助跟踪数据集。

如果系统支持辅助跟踪，那么它具有一个或两个辅助跟踪数据集。 一个是活动的，这意味着它在开启辅助跟踪时接收跟踪条目，另一个 (如果有两个) 是备用的。

当有两个角色时，可以通过指定 SWITCH 来反转它们的角色。 这将导致 CICS 关闭当前活动数据集，打开备用数据库，并撤销指定的活动数据集和备用数据集。

如果只有一个辅助跟踪数据集 (或无) ，那么 SWITCH 会导致异常情况，因为 CICS 会尝试打开未定义的数据集。

CVDA 值如下所示:

switch

CICS 执行交换机。

注: 如果在同一命令中请求 AUXSTATUS 和 SWITCHACTION ，那么将首先设置 AUXSTATUS。

SWITCHSTATUS (cvda)

指定当前活动辅助跟踪数据集填充时 CICS 执行的操作。 发生这种情况时，除非发生交换机或 AUXSTOP-AUXSTART 序列 (请参阅 SWITCHACTION 和 AUXSTATUS 选项) ，否则 CICS 无法继续辅助跟踪。 CVDA 值如下：

无开关

CICS 不执行任何操作。

SWITCHNEXT

当当前数据集已满时， CICS 会切换，但仅切换一次; 此后， NOSWITCH 将生效。

切换全部

每次活动数据集填满时， CICS 都会切换。

TABLESIZE (data-value)

以全字二进制值形式指定内部跟踪表的大小 (以千字节为单位)。 如果指定与当前跟踪表大小不同的值，那么 CICS 会在进行更改时暂挂内部跟踪，并删除旧表中的数据。

表以 4 KB 的倍数分配，最小大小为 16 KB。 如果指定的值不是页面大小 (4 KB) 的倍数，那么会向上舍入到 4 KB 的下一个倍数。 如果指定小于 16 KB ，那么该值将向上舍入为 16 KB。 最大大小为 1048576 KB (1 GB)。

CICS 将 64 位 (高于条形) 存储器用于内部跟踪表。 TABLESIZE 的值必须小于 z/OS® MEMLIMIT 参数的值，并且您还必须允许 CICS 区域中使用 64 位存储器的其他设施。 请参阅 估算，检查和设置 MEMLIMIT。

条件

INVREQ

RESP2 值：

1

INTSTATUS 具有无效的 CVDA 值。

2

指定的 TABLESIZE 值-1。

3

AUXSTATUS 具有无效的 CVDA 值。

4

SWITCHSTATUS 具有无效的 CVDA 值。

5

GTFSTATUS 具有无效的 CVDA 值。

6

指定了 AUXPAUSE ，但辅助跟踪未处于活动状态。

11

SWITCHACTION 具有无效的 CVDA 值。

IOERR

RESP2 值：

10

SWITCH 请求或 SET AUXSTART 请求导致跟踪数据集发生打开错误。

NOSPACE

RESP2 值：

7

没有足够的空间用于新的跟踪表。

NOSTG

RESP2 值：

8

没有足够的空间用于辅助跟踪缓冲区。

9

没有足够的空间用于 GTF 跟踪缓冲区。

NOTAUTH

RESP2 值：

100

未授权与发出任务关联的用户使用此命令。