INQUIRE SYSDUMPCODE
检索有关系统转储表条目的信息。
语法
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: END ， ILLOGIC ， NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 CICS-值数据区 (CVDA)。
描述
您可以使用 INQUIRE SYSDUMPCODE 命令来查看系统转储代码表条目中的某些信息。
表条目告诉 CICS® 在发生具有此代码的系统转储请求时要执行的操作以及要执行这些操作的次数 ( MAXIMUM 选项)。 将对达到最大值后接收的请求进行计数 ( CURRENT 选项) ，否则将忽略这些请求。
CICS 提供了一个系统转储表，其中包含一些 CICS定义的系统转储代码的条目。 当 CICS 接收到具有其没有条目的代码的转储请求时，将使用缺省值来构建表条目。 您可以使用 SET SYSDUMPCODE 命令或 CEMT 事务来添加自己的条目。 您添加的条目将保留在 CICS 的执行范围内，直到发生初始启动或冷启动，但 CICS 构建的条目将被视为临时条目并在关闭时废弃。 因此，如果查询在转储请求中出现之前未显式定义的代码，那么您将获得not found响应。
浏览
您还可以在 INQUIRE SYSDUMPCODE 命令上使用浏览选项 (START， NEXT和 END) 来浏览系统转储代码表中的所有条目。 请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。
资源特征符
您可以使用此命令来检索资源签名字段。 您可以使用这些字段来管理资源，方法是捕获资源的定义，安装和上次更改时间的详细信息。 有关更多信息，请参阅 标识对资源的更改 (资源特征符)。 请参阅 资源签名字段值摘要 ，以获取有关资源签名字段内容的详细信息。
选项
- CHANGEAGENT (cvda)
- 返回用于标识上次对资源定义进行更改的代理程序的 CVDA 值。 可能的值如下所示：
- CREATESPI
- 上次由 EXEC CICS CREATE 命令更改资源定义。
- CSDAPI
- 上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。
- CSDBATCH
- DFHCSDUP 作业上次更改资源定义。
- DYNAMIC
- 上次由 SET SYSDUMPCODE 命令更改资源。
- OVERRIDE
- 资源定义上次由资源覆盖文件中的覆盖规则的应用程序更改。
- SYSTEM
- 资源定义上次由 CICS更改。
- CHANGEAGREL (data-area)
- 返回上次更改资源定义时运行的 CICS 版本的 4 位数字：例如， 0 760 是 CICS TS for z/OS®, Version 6. 3 的标识符。
- CHANGETIME (data-area)
- 返回表示上次更改资源定义时的时间戳记的 ABSTIME 值。 有关 ABSTIME 值的格式的更多信息，请参阅 FORMATTIME。
- CHANGEUSRID (data-area)
- 返回运行更改代理程序的 8 字符用户标识。
- 当前 (数据区)
- 返回一个全字二进制字段，该字段显示自上次重置计数以来具有此转储代码的转储请求数。
计数将在 CICS 关闭时自动重置，并且可以使用 SET SYSDUMPCODE 命令或其 CEMT 等效项显式重置。 该计数包括因 CICS 或 MVS 而未产生转储的请求。
- DAEOPTION (数据区)
- 返回一个 CVDA 值，显示为该转储代码生成的转储是否符合 MVS Dump Analysis and Elimination (DAE) 组件的后续抑制条件。 CVDA 值如下：
- DAE
- 转储符合 DAE 禁止条件。
- NODAE
- 转储不适合 DAE 禁止。 如果 CICS 认为应该写入转储， MVS 不会抑制它。注: 请注意 ADYSETXx parmlib 成员中的 禁止 和 SUPPRESSALL 选项，这些选项由 SDWA 中的 VRADAE 和 VRANODAE 密钥控制。 即使 NODAE 生效，这些选项也可能导致转储禁止。 有关这些选项的信息，请参阅 z/OS MVS 诊断工具和服务辅助工具。
- DEFINESOURCE (数据区域)
- 返回资源定义的 8 字符源。 DEFINESOURCE 值取决于 CHANGEAGENT 值。 有关更多信息，请参阅 资源签名字段值的摘要。
- DEFINETIME (数据区)
- 返回 ABSTIME 值，该值表示创建资源定义时的时间戳记。
- DSPLIST (数据区)
- 返回要转储的数据空间的列表。 数据空间名称以逗号分隔。 此字段最多包含 255 个字符。
- DUMPSCOPE (cvda)
- 返回 CVDA 值，该值显示具有此转储代码的转储请求是否应导致将 SDUMP (系统转储) 请求发送到相关 z/OS 映像。
相关 z/OS 映像包含代表 CICS 区域执行工作的 CICS 区域。 具体来说，它是一个区域，它有一个或多个任务在与您所在区域的任务相同的 APPC 令牌下执行工作。
只有当该代码的表项指定了转储（即 SYSDUMPING 值为 SYSDUMP）时，才会发送 SDUMP 请求，而且只有在 MVS /ESA 版本 5.1 或更高版本和 z/OS Workload Manager 下执行的多重环境中才会这样做。
CVDA 值如下：- LOCAL
- 不发送 SDUMP 请求。
- 相关
- 将发送 SDUMP 请求。注: 设置 DUMPSCOPE (RELATED) 会导致对每个受影响的 z/OS 映像执行单个转储。 该转储包含映像中所有受影响的 CICS 区域的输出。 有关更多信息，请参阅 来自相关 CICS 区域的自动转储数据捕获。
- INSTALLAGENT (cvda)
- 返回用于标识安装资源的代理程序的 CVDA 值。 可能的值如下所示：
- 自动安装
- 资源已自动安装。
- CREATESPI
- 资源是通过 EXEC CICS CREATE 命令安装的。
- CSDAPI
- 该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。
- DYNAMIC
- 资源是通过 SET SYSDUMPCODE ADD 命令安装的。
- GRPLIST
- 该资源已由 GRPLIST INSTALL安装。
- SYSTEM
- 该资源已由 CICS安装。
- INSTALLTIME (数据区)
- 返回表示安装资源时的时间戳记的 ABSTIME 值。
- INSTALLUSRID (数据区)
- 返回安装资源的 8 字符用户标识。
- JOBLIST (数据区)
- 返回要转储的地址空间的列表。 地址空间名称以逗号分隔。 此字段最多包含 134 个字符。
- MAXIMUM (数据区域)
- 返回一个全字二进制字段，该字段显示 CICS 将采用的具有此代码的最大转储数。 值 999 表示缺省值无限制。
- SHUTOPTION (cvda)
- 返回一个 CVDA 值，该值显示在请求使用此转储代码进行转储之后是否关闭 CICS 系统。 CVDA 值如下：
- 未关闭
- CICS 系统不会关闭。
- SHUTDOWN
- 将关闭 CICS 系统。
- SYSDUMPCODE (data-value)
- 指定要查询的 8 字符系统转储代码。 有效代码不包含前导空白或嵌入空白。
- SYS转储 (cvda)
- 返回 CVDA 值，该值显示具有此代码的转储请求是否应该生成转储。 即使指定了转储， CICS 也只会在 CURRENT 值不大于 MAXIMUM 且系统转储未被全局禁止的情况下产生转储（参见 INQUIRE SYSTEM 命令的 DUMPING 选项）。 MVS 如果合适，还可以抑制转储（ DAE 选项）。 CVDA 值如下：
- 无系统转储
- 不产生转储。
- SYSDUMP
- 将生成转储。
注: 来自 CICS 内核域的转储不受禁止，无论 SYSDUMPCODE 值如何，都将执行这些转储。
条件
- END
- RESP2 值：
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值：
- 1
- 当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- NOTFND
- RESP2 值：
- 1
- 找不到指定的转储代码。