SET SYSDUMPCODE

描述

SET SYSDUMPCODE 命令允许您更改特定转储代码的系统转储表条目，向该表添加新的转储代码或删除一个转储代码。

表条目告诉 CICS® 发生具有此代码的系统转储请求时要执行的操作。 可能的操作包括执行系统转储 (MVS™ SDUMP) ，启动相关 CICS 区域的 SDUMP 请求以及关闭 CICS。 表条目还指示要执行此操作集的次数 (MAXIMUM 值); 达到最大值后，将对请求进行计数，但将忽略这些请求。

表更新记录在 CICS 全局目录中，并通过执行 CICS 保留，直到初始启动或冷启动 (临时表条目除外) 为止。 CICS 在接收带有代码的转储请求时创建临时条目，而这些代码没有表条目; 这些条目以及对它们所作的任何更改仅在当前执行 CICS时才存在。 如果要在重新启动后保留对临时条目的更改，那么必须从表中除去转储代码，然后将其重新添加。

有关系统转储的信息，请参阅 您可以指定的转储代码选项。

选项

ACTION (cvda)

指定要对转储代码执行的操作。 CVDA 值包括：

ADD

此代码的条目将添加到表中。

移除

将从表中除去此代码的条目。 不能在 SET SYSDUMPCODE REMOVE 命令上指定其他选项。

RESET

此代码的当前转储请求数将设置为零。 请参阅 INQUIRE SYSDUMPCODE 命令的 CURRENT 选项。

DAEOPTION (cvda)

指定 MVS 转储分析和消除（DAE）组件是否有权禁止针对该转储代码而产生的转储。 CVDA 值包括：

DAE

转储符合 DAE 禁止条件。

NODAE

转储不适合 DAE 禁止。 如果 CICS 确定应该写入转储，那么 MVS 不会禁止该转储。 但是， ADYSETxx parmlib 成员中的 禁止 和 SUPPRESSALL 选项由 SDWA 中的 VRADAE 和 VRANODAE 密钥控制。 即使在此处设置了 NODAE ，它们也可能导致转储禁止。 有关这些选项的信息，请参阅 z/OS MVS Diagnosis: Tools and Service Aids。

如果指定了 SET SYSDUMPCODE ADD ，那么如果不同时指定 DAEOPTION，那么缺省情况下将使用 NODAE ，而不考虑 DAE 系统初始化参数的设置。

DSPLIST (data-value)

指定要转储的数据空间的列表。 此字段最多包含 255 个字符。 数据空间名称以逗号分隔。 也支持通配符。 要指定数据空间，必须提供其拥有的地址空间名称，后跟句点和数据空间名称。 以下示例显示如何请求转储 SMSVSAM 和耦合设施的数据空间:

DSPLIST(SMSVSAM.*,XCFAS.*)

注: 用户必须至少具有对 SET 命令的 CONTROL 访问权，才能在 SET SYSDUMPCODE上指定 DSPLIST 。

有关更多信息，请参阅 z/OS® MVS Programming: authorized Assembler Services Reference (Volume 3)中的 SDUMPX 文档。

DUMPSCOPE (cvda)

指定具有此转储代码的转储请求是否导致 CICS 对 相关 CICS 区域的 SDUMP (系统转储) 发起请求。

相关的 CICS 区域是同一综合系统中的一个区域，由 MRO/XCF 连接并代表 CICS 区域执行工作-具体而言，这是一个区域，其中一个或多个任务在与区域中的任务相同的 APPC 令牌下执行工作。

仅当此代码的表条目还指定 SYSDUMP 值，并且仅在 SYSPLEX 环境中指定 SYSDUMP 时，才会发生 SDUMP 请求的这种传播。

如果在其他系统中指定 RELATED ，那么会导致异常情况。

CVDA 值包括：

LOCAL

不发送 SDUMP 请求。

相关

将发送 SDUMP 请求。

注: 设置 DUMPSCOPE (RELATED) 会导致对每个受影响的 MVS 映像执行单个转储。 该转储包含映像中所有受影响的 CICS 区域的输出。 有关更多信息，请参阅 来自相关 CICS 区域的自动转储数据捕获。

如果不指定 DUMPSCOPE 值，那么对于添加的条目，其缺省值为 LOCAL。

JOBLIST (data-value)

指定要转储的地址空间的列表。 此字段最多包含 134 个字符。 地址空间名称以逗号分隔。 也支持通配符。 最多可以输入 15 个地址空间名称。 但是，如果匹配结果超过 15 个地址空间，那么仅转储前 15 个空间。 以下示例显示如何请求转储 SMSVSAM 和耦合设施地址空间:

JOBLIST(SMSVSAM,XCFAS)

注: 用户必须至少具有对 SET 命令的 CONTROL 访问权，才能在 SET SYSDUMPCODE上指定 JOBLIST 。

有关更多信息，请参阅 z/OS MVS Programming: authorized Assembler Services Reference (Volume 3)中的 SDUMPX 文档。

MAXIMUM (data-value)

指定一个全字二进制值，表示 CICS 应请求的具有该代码的转储的最大数目，有效值为：0-999。 达到最大值后， CICS 将进行计数，但忽略具有此代码的转储请求。 值 999 意味着无限制，在添加新条目时如果未指定 MAXIMUM 值，那么缺省值为 999。

SHUTOPTION (cvda)

指定在请求具有这个转储代码的转储之后，是否关闭该系统。 CVDA 值包括：

未关闭

系统不会关闭。 如果从 SET SYSDUMPCODE ADD 命令中省略此值，那么将采用此值。

SHUTDOWN

系统将关闭。

当您指定 SHUTDOWN 选项时，不会将日终统计信息 (关闭统计信息) 写入 SMF ，因此这些统计信息将丢失。

SYSDUMPCODE (data-value)

为将要修改的系统转储表条目指定 8 个字符的系统转储代码。 有效的系统转储代码中不能包含前导空格或嵌入空格。

SYS转储 (cvda)

指定具有该代码的系统转储请求是否会产生转储。 CVDA 值包括：

无系统转储

不执行转储。

SYSDUMP

将执行转储。

即使指定了 SYSDUMP ，仅当针对此代码的请求数小于 MAXIMUM 并且未全局禁止系统转储时， CICS 才会执行转储 (请参阅 INQUIRE SYSTEM 命令的 DUMP 选项)。 根据 DAEOPTION 值，也可以允许 MVS 在适当情况下禁止转储。

如果 SET SYSDUMPCODE ADD 命令中省略了 系统转储 选项，那么将采用 SYSDUMP。

条件

DUPREC

RESP2 值：

10

为已在系统转储表中的转储代码指定了 ADD。

INVREQ

RESP2 值：

2

ACTION 具有无效的 CVDA 值。

4

SYS转储具有无效的 CVDA 值。

5

MAXIMUM 值超出范围。

6

SHUTOPTION 具有无效的 CVDA 值。

7

REMOVE 与其他选项一起指定。

9

转储代码无效。

13

DUMPSCOPE 具有无效的 CVDA 值。

15

DAEOPTION 具有无效的 CVDA 值。

16

JOBLIST 值无效。

17 日

DSPLIST 值无效。

IOERR

RESP2 值：

11

更新 CICS 目录时发生错误。 对于当前运行，该条目已更改，但不会记录为重新启动。

NOSPACE

RESP2 值：

12

CICS 目录已满。 对于当前运行，该条目已更改，但不会记录为重新启动。

NOTAUTH

RESP2 值：

100

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

NOTFND

RESP2 值：

1

找不到转储代码。