DUMPCODE 资源定义
DUMPCODE 资源定义作为 CICS® 转储表条目添加的事务转储代码或系统转储代码的属性。
- 生成事务转储
- 生成系统转储（ MVS SDUMP）
- 启动对相关 CICS 区域的 SDUMP 的请求
- 关闭 CICS
表条目还指示执行此操作集的次数 ( MAXIMUM 值)。 达到最大值后，将对请求进行计数，否则将忽略这些请求。
表更新记录在 CICS 全局目录中，并在 CICS 的执行期间保留，直到发生初始启动或冷启动 (临时表条目除外)。 当 CICS 接收到带有没有表条目的代码的转储请求时，它将创建临时条目; 这些条目以及对它们的任何更改仅在当前执行 CICS时才会发生。 如果要在重新启动后保留对临时条目的更改，那么必须从表中除去转储代码，然后使用联机资源定义 (RDO) 为其定义并安装条目。
语法
属性
- DAEOPTION（ { 节点数 | 虚数 } ）
- 指定针对此转储代码生成的系统转储是否符合 z/OS® 转储分析和消除 (DAE) 组件禁止的条件。
可能的值包括：
- DAE
- 系统转储符合 DAE 禁止条件。
- NODAE
- 系统转储不适合 DAE 禁止。 如果 CICS 确定应该执行转储，那么 z/OS 不会禁止该转储。注: 请注意 ADYSETXx parmlib 成员中的 禁止 和 SUPPRESSALL 选项，这些选项由 SDWA 中的 VRADAE 和 VRANODAE 密钥控制。 即使 NODAE 生效，这些选项也可能导致转储禁止。 有关这些选项的信息，请参阅 z/OS MVS 诊断工具和服务辅助工具。
- DESCRIPTION(文本)
- 您可以提供在此字段中定义的资源的描述。 描述文本的长度最多可以为 58 个字符。 您可以使用的字符没有任何限制。 但是，如果使用括号，请确保对于每个左括号都有一个匹配的右括号。 如果使用 CREATE 命令，那么对于文本中的每个单撇号，将编码两个撇号。
- DSPLIST（ 数据值 ）
- 指定要转储的数据空间的列表。 此字段最多包含 255 个字符。 数据空间名称以逗号分隔。 也支持通配符。
要指定数据空间，必须提供其拥有的地址空间名称，后跟句点和数据空间名称。
以下示例显示如何请求转储 SMSVSAM 和耦合设施的数据空间:DSPLIST(SMSVSAM.*,XCFAS.*) - DUMPACTION（ { TRANDUMP | SYSDUMP | BOTH | NONE } ）
- 指定要对 DUMPCODE 执行的操作。
可能的值包括：
- NONE
- 既不执行事务转储，也不执行系统转储。
- SYSDUMP
- 执行系统转储。 这是系统 DUMPCODE 的缺省值。
- TRANDUMP
- 执行事务转储。 这是事务 DUMPCODE 的缺省值。
此选项不适用于系统 DUMPCODE。
- BOTH
- 同时执行事务转储和系统转储。 此选项不适用于系统 DUMPCODE。
- DUMPCODE(名称)
- 指定 DUMPCODE 资源的名称。
对于事务 DUMPCODE ，名称的长度可以是 1 到 4 个字符。 对于系统 DUMPCODE ，名称的长度可以是 1 到 8 个字符。
可接受的字符：A-Z a-z 0-9 $ @ #./ - _ % &?!:| " = ¬,; < >
有效字符在代码页 IBM® -037 显示时列出。 如果使用不同的 EBCDIC 代码页，请注意 变体角色 中记录的变体字符。
- DUMPSCOPE（ { 本地 | 相关 } ）
- 指定具有此转储代码的转储请求是否导致 CICS 对相关 CICS 区域的 SDUMP (系统转储) 发起请求。
相关 CICS 区域 是同一综合系统中的一个区域，由 MRO/XCF 连接并代表 CICS 区域执行工作-具体而言，该区域具有一个或多个任务，这些任务在与区域中的任务相同的 APPC 令牌下执行工作。
仅当此代码的表条目还指定了 DUMPACTION 值 SYSDUMP 或 BOTH，并且仅在综合系统环境中，才会发生 SDUMP 请求的这种传播。
如果在其他系统中指定 RELATED ，那么会导致异常情况。
可能的值包括：- LOCAL
- 不发送 SDUMP 请求。
- 相关
- 将发送 SDUMP 请求。注: 设置 DUMPSCOPE(RELATED) 会导致对每个受影响的 z/OS 映像执行单个转储。 该转储包含映像中所有受影响的 CICS 区域的输出。 有关更多信息，请参阅 来自相关 CICS 区域的自动转储数据捕获。
- GROUP（ 组名 ）
- 每个资源定义都必须具有 GROUP 名称。 资源定义成为组的成员，并在安装组时安装在 CICS 系统中。可接受的字符：
A-Z 0-9 $ @ #
当代码页为 IBM-037时，有效字符将按其呈现方式列出。 如果使用不同的 EBCDIC 代码页，请注意 变体角色 中记录的变体字符。
输入的任何小写字符都将转换为大写。
GROUP 名称的长度最多可以为 8 个字符。 小写字符被视为大写字符。
- JOBLIST（ 数据值 ）
- 指定要转储的地址空间的列表。 此字段最多包含 134 个字符。 地址空间名称以逗号分隔。 还支持通配符。
最多可以输入 15 个地址空间名称。 但是，如果匹配结果超过 15 个地址空间，那么仅转储前 15 个空间。
以下示例显示如何请求转储 SMSVSAM 和耦合设施地址空间:JOBLIST(SMSVSAM,XCFAS) - MAXIMUM（ 数据值 ）
- 指定具有此转储代码的 CICS 可请求的最大转储数。 使用 0 到 999 范围内的全字二进制值。值为 999 表示没有限制。 缺省值确定如下:
- 对于事务 DUMPCODE ，缺省值取自 TRDUMAX 系统初始化参数。
- 对于系统 DUMPCODE ，缺省值取自 SYDUMAX 系统初始化参数。
达到最大值后， CICS 会计数但忽略具有此转储代码的转储请求。
- SHUTOPTION（ { 不关闭 | 关闭 } ）
- 指定是否关闭系统以响应使用此转储代码进行转储的请求。
可能的值包括：
- NOSHUTDOWN
- 请勿关闭系统。
- SHUTDOWN
- 关闭系统。注: 当您指定 SHUTDOWN 选项时，不会将日结束统计信息 (关闭统计信息) 写入 SMF ，因此这些统计信息会丢失。
- TYPE（ { 交易 | 系统 } ）
- 指定 DUMPCODE 资源的类型。
可能的值包括：
- SYSTEM
- 指示系统 DUMPCODE。
- TRAN
- 指示事务 DUMPCODE。