SET SYSDUMPCODE
更改系统转储表中的条目。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: DUPREC ， INVREQ ， IOERR ， NOSPACE ， NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
描述
SET SYSDUMPCODE 命令允许您更改特定转储代码的系统转储表条目，向该表添加新的转储代码或删除一个转储代码。
表条目告诉 CICS® 发生具有此代码的系统转储请求时要执行的操作。 可能的操作包括执行系统转储 (SDUMP) ，启动相关 CICS 区域的 SDUMP 请求以及关闭 CICS。 表条目还指示要执行此操作集的次数 (MAXIMUM 值); 达到最大值后，将对请求进行计数，但将忽略这些请求。
表更新记录在 CICS 全局目录中，并通过执行 CICS 保留，直到初始启动或冷启动 (临时表条目除外) 为止。 CICS 在接收到带有代码的转储请求时使用缺省值创建临时条目，该代码没有表条目; 这些条目以及对这些条目所作的任何更改仅在当前执行 CICS时才会发生。 如果要在重新启动后保留对临时条目的更改，那么必须从表中除去转储代码，然后将其重新添加。 有关详细信息，请参阅 如果没有转储表项，转储请求会发生什么情况。
有关系统转储的信息，请参阅 如何工作: 转储， 系统转储表和 您可以指定的转储代码选项。
选项
- ACTION (cvda)
- 指定要对转储代码执行的操作。 CVDA 值包括：
- ADD
- 此代码的条目将添加到表中。
- 移除
- 将从表中除去此代码的条目。 不能在 SET SYSDUMPCODE REMOVE 命令上指定其他选项。
- RESET
- 此代码的当前转储请求数将设置为零。 请参阅 INQUIRE SYSDUMPCODE 命令的 CURRENT 选项。
- DAEOPTION (cvda)
- 指定针对此转储代码生成的转储是否符合 z/OS® 转储分析和消除 (DAE) 组件禁止的条件。 CVDA 值包括：
- DAE
- 转储符合 DAE 禁止条件。
- NODAE
- 转储不适合 DAE 禁止。 如果 CICS 认为应该写入转储， z/OS 不会抑制它。 但是， ADYSETxx parmlib 成员中的 禁止 和 SUPPRESSALL 选项由 SDWA 中的 VRADAE 和 VRANODAE 密钥控制。 即使在此处设置了 NODAE ，它们也可能导致转储禁止。 有关这些选项的信息，请参见。
如果指定了 SET SYSDUMPCODE ADD ，那么如果不同时指定 DAEOPTION，那么缺省情况下将使用 NODAE ，而不考虑 DAE 系统初始化参数的设置。
- DSPLIST (data-value)
- 指定要转储的数据空间的列表。 此字段最多包含 255 个字符。 数据空间名称以逗号分隔。 也支持通配符。 要指定数据空间，必须提供其拥有的地址空间名称，后跟句点和数据空间名称。 以下示例显示如何请求转储 SMSVSAM 和耦合设施的数据空间:
DSPLIST(SMSVSAM.*,XCFAS.*)注: 用户必须至少具有对 SET 命令的 CONTROL 访问权，才能在 SET SYSDUMPCODE上指定 DSPLIST 。有关更多信息，请参阅 z/OS MVS 编程：授权汇编服务参考（第 3 卷） 中的 SDUMPX 文档。
- DUMPSCOPE (cvda)
- 指定具有此转储代码的转储请求是否导致 CICS 对
相关
CICS 区域的 SDUMP (系统转储) 发起请求。相关的 CICS 区域是同一综合系统中的一个区域，由 MRO/XCF 连接并代表 CICS 区域执行工作-具体而言，这是一个区域，其中一个或多个任务在与区域中的任务相同的 APPC 令牌下执行工作。
仅当此代码的表条目还指定 SYSDUMP 值，并且仅在 SYSPLEX 环境中指定 SYSDUMP 时，才会发生 SDUMP 请求的这种传播。
如果在其他系统中指定 RELATED ，那么会导致异常情况。
CVDA 值包括：- LOCAL
- 不发送 SDUMP 请求。
- 相关
- 将发送 SDUMP 请求。注: 设置 DUMPSCOPE (RELATED) 会导致对每个受影响的 z/OS 映像执行单个转储。 该转储包含映像中所有受影响的 CICS 区域的输出。 有关更多信息，请参阅 来自相关 CICS 区域的自动转储数据捕获。
如果不指定 DUMPSCOPE 值，那么对于添加的条目，其缺省值为 LOCAL。
- JOBLIST (data-value)
- 指定要转储的地址空间的列表。 此字段最多包含 134 个字符。 地址空间名称以逗号分隔。 也支持通配符。 最多可以输入 15 个地址空间名称。 但是，如果匹配结果超过 15 个地址空间，那么仅转储前 15 个空间。 以下示例显示如何请求转储 SMSVSAM 和耦合设施地址空间:
JOBLIST(SMSVSAM,XCFAS)注: 用户必须至少具有对 SET 命令的 CONTROL 访问权，才能在 SET SYSDUMPCODE上指定 JOBLIST 。有关更多信息，请参阅 z/OS MVS 编程：授权汇编服务参考（第 3 卷） 中的 SDUMPX 文档。
- MAXIMUM (data-value)
- 指定一个全字二进制值，表示 CICS 应请求的具有该代码的转储的最大数目，有效值为：0-999。 达到最大值后， CICS 将进行计数，但忽略具有此代码的转储请求。 值 999 意味着无限制，在添加新条目时如果未指定 MAXIMUM 值，那么缺省值为 999。
- SHUTOPTION (cvda)
- 指定在请求具有这个转储代码的转储之后，是否关闭该系统。 CVDA 值包括：
- 未关闭
- 系统不会关闭。 如果从 SET SYSDUMPCODE ADD 命令中省略此值，那么将采用此值。
- SHUTDOWN
- 系统将关闭。
- SYSDUMPCODE (data-value)
- 为将要修改的系统转储表条目指定 8 个字符的系统转储代码。 有效的系统转储代码中不能包含前导空格或嵌入空格。
- SYS转储 (cvda)
- 指定具有该代码的系统转储请求是否会产生转储。 CVDA 值包括：
- 无系统转储
- 不执行转储。
- SYSDUMP
- 将执行转储。
即使指定了 SYSDUMP ，仅当针对此代码的请求数小于 MAXIMUM 并且未全局禁止系统转储时， CICS 才会执行转储 (请参阅 INQUIRE SYSTEM 命令的 DUMP 选项)。 根据 DAEOPTION 值，还可以允许 z/OS 在适当时禁止转储。
如果 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
- 找不到转储代码。