PERFORM DUMP

描述

PERFORM DUMP 命令请求发出该命令的 CICS 区域的系统转储 (SDUMP)。

如果您指定的转储代码没有条目，那么 CICS 将使用缺省值创建临时转储代码。 有关此过程的更多信息，请参阅 如果没有转储表项，转储请求会怎样。

在执行 SDUMP 时，所有其他 CICS 活动都将停止。 直到转储完成之后，发出该命令的程序才会重新获得控制，并且仅当转储不会导致 CICS 关闭时才会重新获得控制。

选项

CALLER (data-value)

指定在转储顶部的转储域信息摘要中出现在 "CALLER" 之后的文本。 此文本最长可以为 8 个字符。 它旨在标识转储请求的源，但不限于此目的。

CALLERLENGTH (data-value)

以全字二进制值的形式指定 CALLER 文本中的字符数。

DUMPCODE (data-value)

指定此转储请求的 8 字符转储代码，这将确定在处理该转储请求时使用的系统转储表条目。

代码可以是 CICS定义的或用户定义的。 大多数 CICS 代码是除去了初始 "DFH" 的 CICS 消息标识，但还有一些其他代码。

用户定义的代码可以是不包含前导或嵌入空白的任何字符串。

CICS 为某些 CICS定义的代码提供系统转储表条目，并根据需要为其他代码构建这些条目。 安装可以为用户定义的代码提供条目，或者如先前所述， CICS 构建临时条目。

DUMPID (数据区)

返回为此特定转储生成的 6-to 9 字符转储标识。 标识的格式为 xxxx/yyyy，其中 xxxx 表示 转储运行号， yyyy 是 转储计数，斜杠 (/) 符号是分隔符。 将按如下所示生成转储标识:

转储运行号

1-9999 范围内的数字。 (此数字不使用前导零，这就是转储标识可以从 6 到 9 字符不等的原因。) 首次使用新初始化的本地目录启动 CICS 时，转储运行号从 1 开始，每次重新启动 CICS时，会按 1 递增。 执行正常关闭时，转储运行号将保存在本地目录中，但如果使用 START = INITIAL 或 START = COLD 系统初始化参数启动 CICS ，那么将重置该值。

转储计数

范围在 0001 到 9999 之间的数字。 (转储标识中需要前导零。) 这是在 CICS的此运行中分配给转储的编号，从第一个转储的 0001 开始，随着每个转储的执行，按 1 递增。

标题 (data-area)

在转储顶部的转储域信息摘要中打印为标题的文本。 可长达 80 个字符。

TITLENGTH (data-value)

以全字二进制值的形式指定 TITLE 文本中的字符数。

条件

INVREQ

RESP2 值：

6

TITLENGTH 大于 80 字节。

7

CALLERLENGTH 大于 8 字节。

13

DUMPCODE 包含前导空白或嵌入空白。

IOERR

RESP2 值：

9

CICS z/OS® 未授权其进行转储。

10

系统转储期间发生错误。

12

z/OS 无法处理转储，因为没有转储数据集或该数据集已满。

13

在发出 SDUMP 请求的 CICS 例程中发生错误。

NOSPACE

RESP2 值：

4

由于缺少转储数据集空间，因此转储不完整。

NOSTG

RESP2 值：

5

由于存储空间不足， CICS 无法完成转储。

NOTAUTH

RESP2 值：

100

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

SUPPRESSED

RESP2 值：

1

未执行转储，因为具有此转储代码的转储数超过了代码的最大值。

2

未执行转储，因为此代码的系统转储表条目指示没有系统转储。

3

未执行转储，因为用户出口程序已禁止该转储。

8

未执行转储，因为全局禁止系统转储。

SYSBUSY

RESP2 值：

11

z/OS 转储例程正忙。 重试该命令。