诊断部署错误

当您尝试运行 CICS Web Service 助手批处理作业或 CICS XML 助手批处理作业，在 CICS中安装 PIPELINE 资源或在 CICS中安装 WEBSERVICE 资源时，可能会发生部署错误。此处描述了最常见的部署错误，包括问题的症状，原因和解决方案。

关于此任务

如果发生部署错误，那么 PIPELINE 资源通常以 DISABLED 状态安装，而 WEBSERVICE 资源以不可用状态安装。

与 CICS Web Service 助手批处理作业和 CICS XML 助手批处理作业关联的信息和错误消息位于作业日志中。与安装资源相关联的错误消息位于系统日志中。

0 ， 4 ， 8 或 12 的代码由助手发出，其他代码通常由 BPXBATCH ， JVM 或 IEBGENER 发出。

BPXBATCH 发出的代码分为两大类: 小于 128 的代码表示命令失败，大于或等于 128 的代码表示进程被信号终止。有关 BPXBATCH 及其返回码的更多信息，请参阅 z/OS UNIX System Services 命令参考。

过程

运行 CICS Web Service 助手批处理作业或 CICS XML 助手批处理作业时，您会收到返回码 0 ， 4 ， 8 或 12。
返回码表示以下内容:
- 0 -作业已成功完成。
- 4 -警告。作业已成功完成，但已发出一条或多条警告消息。
- 8 -输入错误。该作业未成功完成。验证输入参数时发出了一条或多条错误消息。
- 12 -错误。该作业未成功完成。执行期间发出了一条或多条错误消息。
1. 检查作业记录以获取任何警告或错误消息。
  查找消息的详细说明。这些说明通常描述您可以执行的操作来解决问题。
2. 确保为作业中的每个参数输入了正确的值。
  应将 Web Service 描述中的文件名和元素之类的参数值视为区分大小写。
3. 确保指定了正确的参数组合。例如，如果在为服务请求者生成 Web Service 绑定文件时在 DFHWS2LS 中包含 PGMNAME 参数，那么将发生错误，并且作业未成功完成。
运行 CICS Web Service 助手批处理作业或 CICS XML 助手批处理作业时，您会收到返回码 1 ， 136 或 139。
这些返回码指示 JVM 已失败，通常是因为没有足够的可用存储器。 CICS 助手需要至少 300 MB 的 JCL 区域大小，尽管某些文档可能需要 400 MB。
1. 增大区域大小，或者考虑将区域大小设置为 0M。
2. 检查是否存在任何活动的 IEFUSI 出口，这可能会限制区域大小。
  
  注: 如果使用 64bit JVM ，请确保指定合适的 MEMLIMIT 值。
运行 CICS Web Service 助手批处理作业 DFHLS2WS或 CICS XML 助手批处理作业 DFHLS2SC时，您会收到返回码 137。此返回码表示作业已超时。
1. 通过将作业的 EXEC 语句上的 TIME 参数编码为 TIME=1440来增加时间，或者增加 SYS1.PARMLIB(BPXPRMxx) 成员。
尝试安装 WEBSERVICE 资源时，收到 DFHPI0914 错误消息。此消息包含有关安装失败原因的一些信息。
1. 检查是否已授权 CICS 读取 z/OS UNIX 中的网络服务绑定文件。
2. 请检查 Web Service 绑定文件是否未损坏。
  例如，如果使用 FTP 以文本模式而不是二进制模式将文件传输到 z/OS UNIX ，就会出现这种情况。
3. 检查具有相同名称的两个 Web Service 绑定文件是否不在不同的选取目录中。
4. 如果您尝试为 Web Service 请求者应用程序安装资源，请检查 SOAP 绑定的版本是否与管道中支持的级别匹配。
  不能将 SOAP 1.1 WEBSERVICE 安装到支持 SOAP 1.2的服务请求者管道中。
5. 检查您是否未将提供者方式 WEBSERVICE 资源安装到请求者方式管道中。
  提供者方式 Web Service 绑定文件指定 PROGRAM 值，而请求者方式绑定文件不指定。
6. 如果您正在使用 DFHWS2LS 或 DFHLS2WS，请检查在生成 Web Service 绑定文件时是否指定了正确的参数。
  某些参数 (例如 PGMNAME) 仅允许用于 Web Service 提供程序，如果要创建 Web Service 请求者，那么必须排除这些参数。
7. 如果您正在使用 DFHWS2LS 或 DFHLS2WS，请检查作业发出的消息，以了解在创建 WEBSERVICE 资源之前是否存在任何需要解决的问题。
PIPELINE 资源安装失败，您收到 DFHPI0700， DFHPI0712， DFHPI0714 或类似的错误消息。
1. 如果收到 DFHPI0700 错误信息，则需要在 CICS 地区启用 PL/I 语言支持。
  在安装任何 PIPELINE 资源之前，需要执行此操作。更多信息，请参阅 Language Environment 支持 PL/I。
2. 检查是否已授权 CICS 访问 z/OS UNIX 目录以读取管道配置文件。
3. 检查您在 WSDIR 参数中指定的目录是否有效。
  尤其要检查大小写，因为 z/OS UNIX 中的目录和文件名区分大小写。
4. 确保您在 CICS 区域中没有同名的 PIPELINE 资源处于 ENABLED 状态。
PIPELINE 资源安装处于 DISABLED 状态。您会收到 DFHPI0702 到 DFHPI0711范围内的错误消息。
1. 检查管道配置文件中是否没有错误。
  管道配置文件中的元素只能出现在某些位置。如果不正确地指定这些值，那么将收到 DFHPI0702 错误消息。此消息包含导致问题的元素的名称。请检查元素描述以确保您已将其编码在正确的位置。
2. 检查管道配置文件中是否没有任何不可打印的字符 (例如，制表符)。
3. 检查 XML 是否有效。
  如果 XML 无效，那么当您尝试安装 PIPELINE 资源时，这可能会导致解析错误。
4. 确保管道配置文件以 US EBCDIC 编码。
  如果尝试使用不同的 EBCDIC 编码，那么 CICS 无法处理该文件。
WEBSERVICE 资源处于 DISABLED 状态。
状态 DISABLED 和 DISABLED 仅可用于在 CICS 束中定义和安装的 WEBSERVICE 资源。
1. 如果已废弃与 WEBSERVICE 资源关联的 PIPELINE 资源，那么 WEBSERVICE 资源将进入 DISABLED 状态。请调查缺少 PIPELINE 资源的原因，并在适当时将其替换。
2. 如果已对定义了 WEBSERVICE 资源的 CICS 束执行了禁用操作，那么当不再使用 Web Service 时， WEBSERVICE 资源将进入 DISABLED 状态。调查 CICS 束的状态，并在适当时将其启用。