SET TRANDUMPCODE
更改事务转储表中的条目。
语法
通过指定 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 TRANDUMPCODE 命令来更改特定转储代码的事务转储表条目，向表添加新的转储代码或删除一个转储代码。
- 生成事务转储
- 生成系统转储 (SDUMP)
- 启动对相关 CICS 区域的 SDUMP 的请求
- 正在关闭 CICS。
表条目还指示执行此操作集的次数 (MAXIMUM 值)。 达到最大值后，将对请求进行计数，否则将忽略这些请求。
表更新记录在 CICS 全局目录中，并在 CICS 的执行期间保留，直到发生初始启动或冷启动 (临时表条目除外)。 当 CICS 接收到带有没有表条目的代码的转储请求时，它将使用缺省值创建临时条目; 这些条目以及对它们的任何更改仅在当前执行 CICS时才会发生。 如果要在重新启动后保留对临时条目的更改，那么必须从表中除去转储代码，然后将其重新添加。 有关详细信息，请参阅 如果没有转储表项，转储请求会发生什么情况。
有关事务转储的信息，请参阅 如何工作: 转储， 事务转储表 和 您可以指定的转储代码选项。
有效字符包括大写字符 (A-Z)、小写字符 (a-z)、数字 (0-9) 和特殊字符 $ @ # / % &?!:|;, ¢ + * ¬ - 和 _。在某些情况下，字符 < >. = 和 " 也是有效的，具体取决于设置的位置。 输入的任何小写字符都将转换为大写。
选项
- ACTION (cvda)
- 指定要对转储代码执行的操作。 CVDA 值如下：
- ADD
- 此代码的条目将添加到表中。
- 移除
- 将从表中除去此代码的条目。 不能在 REMOVE 请求上指定其他选项。
- RESET
- 此转储代码的当前转储请求数将设置为零。 (请参阅 INQUIRE TRANDUMPCODE 命令的 CURRENT 选项。)
- DUMPSCOPE (cvda)
- 指定具有此转储代码的转储请求是否应导致 CICS 启动对相关 CICS 区域的 SDUMP (系统转储) 的请求。
相关的 CICS 区域位于同一综合系统内，由 MRO/XCF 连接，专门代表发出转储请求的任务执行工作，在这个区域中，有一个任务的 APPC 令牌与该任务的令牌相同。
只有当该代码的表项也指定了 SYSDUMPING 值为 SYSDUMP 时，SDUMP 请求的传播才会发生，而且只有在 MVS /ESA 版本 5.1 或更高版本和 z/OS® 工作负载管理器下执行的系统环境中才会发生。 在其他系统中，指定 RELATED 会引起异常情况。
CVDA 值如下：- LOCAL
- 不发送 SDUMP 请求。
- 相关
- 将发送 SDUMP 请求。注: 设置 DUMPSCOPE (RELATED) 会导致对每个受影响的 z/OS 映像执行单个转储。 该转储包含映像中所有受影响的 CICS 区域的输出。 有关更多信息，请参阅 来自相关 CICS 区域的自动转储数据捕获。
如果不指定 DUMPSCOPE 值，那么对于添加的条目，其缺省值为 LOCAL。
- MAXIMUM (data-value)
- 指定一个全字二进制值，表示 CICS 应采用转储表条目中指定的一组操作的最大次数。 达到最大值之后，CICS 对具有该代码的转储请求计数，但会忽略这些请求。 有效范围：0-999。 值 999 意味着无限制，如果在 ADD 请求中忽略了这个选项，那么缺省值为 999。
- SHUTOPTION (cvda)
- 指定在请求具有这个转储代码的转储之后，是否关闭该 CICS 系统。 CVDA 值如下：
- 未关闭
- 系统不会关闭。
- SHUTDOWN
- 系统将关闭。
如果在 ADD 请求中省略了此选项，那么将采用 NOSHUTDOWN。
- SYS转储 (cvda)
- 指定在接收到具有此代码的事务转储请求时是否应执行系统转储 (SDUMP)。 CVDA 值如下：
- 无系统转储
- 不执行系统转储。
- SYSDUMP
- 将执行系统转储。
如果在 ADD 请求中省略了此选项，那么将采用 NOSYSDUMP。
- TRANDUMPCODE (data-value)
- 指定要更改事务转储表条目的 4 字符事务转储代码。 有效的事务转储代码中不能包含前导空格或嵌入空格。
有效字符包括大写字符 (A-Z)、小写字符 (a-z)、数字 (0-9) 和特殊字符 < > $ @ # / % &?!:| = ";., ¢ + * ¬ - 和 _。输入的任何小写字符都会转换为大写字符。
- TRAN转储 (cvda)
- 指定在收到具有这个代码的事务转储请求之后，是否进行事务转储。 CVDA 值如下：
- NOTRANDUMP
- 不执行事务转储。
- TRANDUMP
- 将执行事务转储。
即使指定了 TRANDUMP，仅当针对这个代码的请求计数不大于 MAXIMUM 时，CICS 才会进行转储。
如果在 ADD 请求中省略了这个选项，那么认为采用 TRANDUMP。
条件
- DUPREC
- RESP2 值：
- 10
- 为事务转储表中已存在的转储代码指定了 ADD。
- INVREQ
- RESP2 值：
- 2
- ACTION 具有无效的 CVDA 值。
- 3
- TRAN转储具有无效的 CVDA 值。
- 4
- SYS转储具有无效的 CVDA 值。
- 5
- MAXIMUM 值超出范围。
- 6
- SHUTOPTION 具有无效的 CVDA 值。
- 7
- REMOVE 与其他选项一起指定。
- 9
- 转储代码无效。
- 13
- DUMPSCOPE 具有无效的 CVDA 值。
- 14
- 相关要求 MVS /ESA 5.1。
- IOERR
- RESP2 值：
- 11
- 更新 CICS 目录时发生错误。 对于当前运行，该条目已更改，但不会记录为重新启动。
- NOSPACE
- RESP2 值：
- 12
- CICS 目录已满。 对于当前运行，该条目已更改，但不会记录为重新启动。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- NOTFND
- RESP2 值：
- 1
- 找不到转储代码。