TRANSACTION_DUMP 调用

TRANSACTION_DUMP 导致执行事务转储。如果您在输入时提供的事务转储代码在事务转储代码表中，那么可以禁止转储，并且可以选择执行系统转储。

有关转储表及其工作方式的信息，请参阅在问题确定中使用转储和 SET TRANDUMPCODE。

Valid characters include uppercase characters (A-Z), lowercase characters (a-z), digits (0-9), and the special characters $ @ # / % & ? ! : | ; , ¢ + * ¬ - and _. In some cases, the characters < > . = and " are also valid depending on where you set them. 输入的任何小写字符都将转换为大写。

重要事项

在初始化期间早期使用 XPI 存在限制。在 PLTPI 的第二阶段之前，请勿启动使用 XPI 函数 TRANSACTION_DUMP ， WRITE_JOURNAL_DATA ， MONITOR 和 INQUIRE_MONITOR_DATA 的出口程序。有关 PLTPI 的更多信息，请参阅编写初始化和关闭程序。

TRANSACTION_DUMP

DFHDUDUX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(TRANSACTION_DUMP),
      TRANSACTION_DUMPCODE(name4 | string | 'string')
      [CSA(NO|YES),]
      [PROGRAM(NO|YES),]
      [SEGMENT(block-descriptor),]
      [SEGMENT_LIST(block-descriptor),]
      [TCA(NO|YES),]
      [TERMINAL(NO|YES),]
      [TRANSACTION(NO|YES),]
      [TRT(NO|YES),]]
      [OUT,
      DUMPID(name9 | *),
      RESPONSE(name1 | *),
      REASON(name1 | *)]

注: 此命令是 NOT 线程安全的。

CSA (NO| YES)

指定是否将公共系统区域 (CSA) 包括在事务转储中。缺省值为 NO。

DUMPID (name9 | *)

返回转储标识。

name9: 用于接收分配的标识的 9 字节字段的名称。

程序 (NO| YES)

指定是否将与此任务关联的所有程序存储区域包括在事务转储中。缺省值为 NO。

SEGMENT (块描述符)

指定要转储的单个存储器块的地址和长度。请参阅 XPI 语法以获取有效块描述符的描述。 SEGMENT 和 SEGMENT_LIST 互斥。

SEGMENT_LIST (块描述符)

指定连续字对的集合的地址和长度。每个对中的第一个词指定要转储的存储段的长度 (以字节计); 第二个词包含存储段的地址。列表的结尾必须由包含 X'FFFFFFFF '的单词标记。 SEGMENT 和 SEGMENT_LIST 互斥。

TCA (NO| YES)

指定是否将任务控制区 (TCA) 包括在事务转储中。缺省值为 NO。

TERMINAL (NO| YES)

指定是否将与该任务关联的所有终端存储区域包括在事务转储中。缺省值为 NO。

TRANSACTION (NO| YES)

指定是否将与该任务关联的所有事务存储区域包括在事务转储中。缺省值为 NO。

TRANSACTION_DUMPCODE (name4 | string | "string")

指定与导致此事务转储调用的错误对应的代码。事务转储代码保存在转储表中。

name4: 包含 4 字节字符串的位置的名称。
字符串（string）: 不带空格的字符串。宏从字符串生成长度为 4 字节的字面值常量，并根据需要使用空格或截断。
"字符串": 用引号括起并可能包含空格的字符串。此值的处理方式与前面的 "string" 相同。

TRT (NO| YES)

指定是否将跟踪表 (TRT) 包括在事务转储中。缺省值为 NO。

TRANSACTION_DUMP 的 RESPONSE 和 REASON 值

RESPONSE	推理
确定	无
EXCEPTION	FESTAE_FAILED
	存储器不足
	IWMWQWRK_FAILED
	NOT_OPEN
	OPEN_ERROR
	PARTIAL_SYSTEM_DUMP
	PARTIAL_TRANSACTION_DUMP
	SDUMP_BUSY
	SDUMP_FAILED
	Sdump_not_authorized
	SUPpresSED_BY_DUMPOPTION
	SUPpresSED_BY_DUMPTABLE
	SUPPRESSED_BY_USEREXIT
DISASTER	无
INVALID	INVALID_DUMPCODE
	INVALID_PROBDESC
	INVALID_SVC_CALL
KERNERROR	无
PURGED	无

注：

有关更多详细信息，请参阅进行 XPI 调用中对 RESPONSE 和 REASON 的说明。
NOT_OPEN 表示 CICS® 转储数据集已关闭。
OPEN_ERROR 表示打开 CICS 转储数据集时发生错误。
PARTIAL 表示由此请求生成的事务转储不完整。