TRACE_PUT 调用

TRACE_PUT 将跟踪条目写入活动跟踪目标。

仅当 UEPTRON 指示跟踪对于包含出口程序的函数处于活动状态时，才进行 TRACE_PUT 调用 (请参阅 DFHUEPAR 中的 UEPTRON)。如果发生严重错误，您可能希望在不测试 UEPTRON 的情况下生成异常跟踪条目。

如果使用 TRACE_PUT 来编写异常跟踪条目，请标识这些条目，以便通过跟踪格式化实用程序将其突出显示为异常跟踪条目。要标识异常跟踪条目，请在 DFHTRPTX 调用的 DATA1 块描述符字段中输入文字串 "USEREXC"。

TRACE_PUT

DFHTRPTX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(TRACE_PUT),
      POINT_ID(literalconst | name2 | (Rn)),
      [DATA1(block-descriptor),]
      [DATA2(block-descriptor),]
      [DATA3(block-descriptor),]
      [DATA4(block-descriptor),]
      [DATA5(block-descriptor),]
      [DATA6(block-descriptor),]
      [DATA7(block-descriptor),]
      [RETURN_ADDR(expression | name4 | (Ra)),]]
      [OUT,
      RESPONSE(name1 | *)]

此命令是线程安全的。

DATAn(块描述符)

指定要包含在跟踪条目的数据部分中的最多七个区域。有关有效块描述符的描述，请参阅 XPI 语法。如果指定任何给定的 DATAn，那么必须在 DATAn之前编码 DATA1 到 DATA (n-1)。指定的 DATA 项按指定的顺序打印在跟踪输出中，即按 DATA1 到 DATAn的顺序打印。在数据字段本身之前打印 2 字节长度字段。可以在一次调用中跟踪的数据的最大总长度为 4000 字节。所有数据字段及其所有 2 字节长度字段的总长度必须在此限制内。

POINT_ID (literalconst|name2|(Rn))

指定作为此请求的结果而进行的跟踪条目。调用域中的每个 TRACE_PUT 调用都应指定唯一的 POINT_ID。这使您能够在检查格式化跟踪时找到跟踪调用的源。 POINT_ID 必须在十进制 256 到 511 (X'100 '到 X'1FF') 的范围内。此范围未在 CICS® 模块中使用，而是保留用于用户出口。

文学: 字面值格式的数字，包含标识
name2: 包含标识的 2 字节字段的名称
(Rn): 包含标识的两个低阶字节的寄存器。

RETURN_ADDR (expression|name4|(Ra))

指定显示在跟踪条目的返回地址字段中的值。

表达式: 生成地址的有效汇编语言表达式
name4: 包含地址的全字的名称
(Ra): 包含地址的寄存器。