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